FILTER_MODE (ENUM) ¶ TYPE FILTER_MODE : Filter settings for the subcriber function block. Attributes: qualified_only InOut: Name Initial Comment FILTER_ON 0 Filters the telegrams by topics FILTER_OFF 1 Turns the filter off and receives ALL subscribed telegrams FILTER_NONE 2 Receives no telegrams. In this mode you can only subscribe or unsubscribe topics
MQTT_ERROR (ENUM) ¶ TYPE MQTT_ERROR : Attributes: qualified_only InOut: Name Initial Comment NO_ERROR 0 No error TCP_INIT_ERROR 1 Unable to initialize the TCP socket TCP_READ_ERROR 2 Error while reading response TCP_WRITE_ERROR 3 Error while sending the request MAX_RESPONSE_SIZE_EXCEEDED 4 Size of incoming packet exceeds the maximum packet size. See MQTTParam.g_udiMaxPacketSize DECODE_REMAINING_LENGTH_MALFORMED 5 Malformation during Decoding of Remaining Length of Packet RESPONSE_PACKET_EMPTY 6 The Response Packet is empty INVALID_PACKET_TYPE 7 Invalid Packet Type in first byte of Fixed Header INVALID_PACKET_BIT_FLAGS 8 Invalid Packet Bit Flags in first byte of Fixed Header INVALID_PACKET 9 Invalid Packet KEEP_ALIVE_TIME_EXCEEDED 10 Keep Alive Time is too much WRONG_SESSION_PRESENT_CONNACK 11 Wrong Session Present in CONNACK packet UNACCEPTABLE_PROTOCOL_VERION 12 Connection to Broker is Refused, because of Unacceptable Protocol Version IDENTIFIER_REJECTED 13 Connection to Broker is Refused, because of Rejection of Client Identifier SERVER_UNAVAILABLE 14 Connection to Broker is Refused, because the Server Broker is not available BAD_USER_NAME_PASSWORD 15 Connection to Broker is Refused, because of Bad User name or Bad Password NOT_AUTHORIZED 16 Connection to Broker is Refused, because of Not Authorized access TOPIC_FILTER_EMPTY 17 Topic Filter is empty “”, MUST be at least one character long TOPIC_NAME_NOT_ALLOWED_WILDCARD 18 Topic Name contains Wildcards, what is not allowed. Only Topic Filter can contain these TOPIC_INVALID_LENGTH 19 Topic Length out of valid range (valid range: 1 - 1024) TOPIC_IS_EMPTY 20 Topic name is empty SUBSCRIBE_FAILURE 21 Subscription Failure ADD_MQTT_PACKET_COLLECTION_ERROR 22 Collection Error while trying to add a mqtt packet to the stack ADD_SUBSCRIBER_COLLECTION_ERROR 23 Collection Error while trying to add a subscriber to the stack REMOVE_SUBSCRIBER_COLLECTION_ERROR 24 Collection Error while trying to remove a subscriber from the stack ACKNOWLEDGE_TIMEOUT 25 Client waits for ping response from Server, but Server does not response within a given time interval (2 * ping interval) ALLOCATED_PAYLOAD_SIZE_EXCEEDED 26 The Size of the received payload is more than given allocated memory MAX_NUMBER_OF_PACKETS_EXCEEDED 27 The maximum size of packets has been exceeded CAN_NOT_ADD_ELEMENT_TO_QUEUE 28 Can not add the element to queue (maybe the maximum size has been exceeded) QUERYINTERFACE_ERROR 29 Call of function __QUERYINTERFACE failed (internal error) TIME_OUT 30 Action returned with timeout error. INVALID_LICENSE 31 No valid license found or demo mode has expired. CLIENT_NOT_CONNECTED 32 The MQTT client is not connected to a broker. RESOLVE_HOSTNAME_FAILED 33 The hostname can not be resolved. MAX_REQUEST_SIZE_EXCEEDED 34 Size of publish packet packet exceeds the maximum packet size UNSUPPORTED_VERSION 35 Unsupported MQTT version OPERATION_NOT_SUCCESSFUL 36 The operation was not successful. See eReasonCode for more information. (MQTT V5 only) SEND_QUOTA_LIMIT_REACHED 37 The send quota limit has been reached. Try to publish the message later. INVALID_REASON_CODE 38 The reason code is not allowed in this context. MAX_RECEIVE_BUFFER_SIZE_EXCEEDED 39 Size of incoming packets exceeds the maximum size of the receive buffer. See MQTTParam.g_udiMaxReceiveBufferSize MAX_TOPIC_LEVEL_EXCEEDED 40 The maximum topic level has been exceeded. MAX_STRING_LENGTH_EXCEEDED 41 The maximum length of a STRING has been exceeded (Maximum length: 1024). MAX_CORRELATION_DATA_LENGTH_EXCEEDED 42 The maximum size of Correlation Data has been exceeded. See MQTTParam.g_udiMaxCorrelationDataSize MAX_NUMBER_OF_PUBLISHER_AND_SUBSCRIBER_EXCEEDED 43 The maximum number of publishers and subscribers has been exceeded. See MQTTParam.g_udiMaxPublishersAndSubscribers
MQTT_QOS (ENUM) ¶ TYPE MQTT_QOS : Attributes: qualified_only InOut: Name Initial Comment QoS0 0 Send Message 1x, if disconnect from server then send can fail. QoS1 1 Send Message Nx, until Receive is acknowledged. QoS2 2 Send Message 1x, if disconnect from server then send is always successfully.
MQTTV5 ¶ Properties MQTTAuthProperties (Struct) MQTTConnackProperties (Struct) MQTTConnectProperties (Struct) MQTTPublishProperties (Struct) MQTTStringPair (Struct) MQTTSubscribeProperties (Struct) MQTTWillProperties (Struct)
UTF-8 ¶ ConvertUTF16toUTF8 (Function) ConvertUTF8toUTF16 (Function)
ConvertUTF16toUTF8 (FUN) ¶ FUNCTION ConvertUTF16toUTF8 : UDINT Converts a WSTRING to STRING InOut: Scope Name Type Comment Return ConvertUTF16toUTF8 UDINT Input sourceStart POINTER TO WORD Pointer to WSTRING targetStart POINTER TO BYTE Pointer to STRING dwTargetBufferSize DWORD Size of STRING bStrictConversion BOOL
ConvertUTF8toUTF16 (FUN) ¶ FUNCTION ConvertUTF8toUTF16 : UDINT Converts a STRING to WSTRING. InOut: Scope Name Type Comment Return ConvertUTF8toUTF16 UDINT Input sourceStart POINTER TO BYTE Pointer to STRING targetStart POINTER TO WORD Pointer to WSTRING dwTargetBufferSize DWORD Size of the WSTRING bStrictConversion BOOL
File and Project Information ¶ Scope Name Type Content FileHeader creationDateTime date 06.05.2024, 08:26:30 companyName string 3S-Smart Software Solutions GmbH libraryFile MQTT Client SL.library primaryProject True productName CODESYS productProfile CODESYS V3.5 SP16 Patch 3 contentFile MQTT Client SL.clean.json version version 2.0.0.0 ProjectInformation ActivateDongleLicensing bool False AutoResolveUnbound True IsEndUserLibrary True OnlineHelp True Released True SourceLibrary False LastModificationDateTime date 06.05.2024, 08:26:27 FirmCode int 101597 ProductCode 8794 LibraryCategories library-category-list Application|Utils ActivationMail string ActivationUrl AlternativeFirmCodes 5000304 Author CODESYS Development GmbH Company CODESYS CompiledLibraryCompatibilityVersion CODESYS V3.5 SP15 Patch 2 DefaultNamespace MQTT Description See: Description DocFormat reStructuredText DocLanguages de,en LanguageModelAttribute qualified-access-only Placeholder MQTT_Client_SL Project MQTT Client SL Title MQTT Client SL Version version 1.10.0.0
Library Reference ¶ This is a dictionary of all referenced libraries and their name spaces. 3SLicense ¶ Library Identification ¶ Placeholder: 3SLicense Default Resolution: 3SLicense, * (3S - Smart Software Solutions GmbH) Namespace: _3S_LICENSE Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: 3SLicense CAA FB Factory ¶ Library Identification ¶ Placeholder: CAA FB Factory Default Resolution: CAA FB Factory, * (CAA Technical Workgroup) Namespace: FBF Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: True SystemLibrary: False Key: CAA FB Factory CAA Real Time Clock Extern ¶ Library Identification ¶ Placeholder: CAA RTCLK Default Resolution: CAA Real Time Clock Extern, * (CAA Technical Workgroup) Namespace: RTCLK Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: True SystemLibrary: False Key: CAA RTCLK CAA Types Extern ¶ Library Identification ¶ Placeholder: CAA Types Default Resolution: CAA Types Extern, * (CAA Technical Workgroup) Namespace: CAA Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: True SystemLibrary: False Key: CAA Types CmpCrypto ¶ Library Identification ¶ Placeholder: CmpCrypto Default Resolution: CmpCrypto, * (System) Namespace: CmpCrypto Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: CmpCrypto CmpErrors2 Interfaces ¶ Library Identification ¶ Name: CmpErrors2 Interfaces Version: newest Company: System Namespace: CmpErrors Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: CmpErrors2 Interfaces, * (System) CmpLog ¶ Library Identification ¶ Placeholder: CmpLog Default Resolution: CmpLog, * (System) Namespace: CmpLog Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: CmpLog CmpSchedule ¶ Library Identification ¶ Placeholder: CmpSchedule Default Resolution: CmpSchedule, * (System) Namespace: CmpSchedule Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: CmpSchedule CmpX509Cert ¶ Library Identification ¶ Placeholder: CmpX509Cert Default Resolution: CmpX509Cert, * (System) Namespace: CmpX509Cert Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: CmpX509Cert Common Behaviour Model ¶ Library Identification ¶ Placeholder: CBML Default Resolution: Common Behaviour Model, * (3S - Smart Software Solutions GmbH) Namespace: CBML Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: True SystemLibrary: False Key: CBML Component Manager ¶ Library Identification ¶ Placeholder: Component Manager Default Resolution: Component Manager, * (System) Namespace: Component_Manager Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: Component Manager Element Collections ¶ Library Identification ¶ Placeholder: ElementCollections Default Resolution: Element Collections, * (3S - Smart Software Solutions GmbH) Namespace: COL Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: True SystemLibrary: False Key: ElementCollections MemoryUtils ¶ Library Identification ¶ Placeholder: MemoryUtils Default Resolution: MemoryUtils, * (3S - Smart Software Solutions GmbH) Namespace: MEMUtils Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: True SystemLibrary: False Key: MemoryUtils Net Base Services ¶ Library Identification ¶ Placeholder: NetBaseSrv Default Resolution: Net Base Services, * (3S - Smart Software Solutions GmbH) Namespace: NBS Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: True SystemLibrary: False Key: NetBaseSrv Standard ¶ Library Identification ¶ Placeholder: Standard Default Resolution: Standard, * (System) Namespace: Standard Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: Standard StringUtils ¶ Library Identification ¶ Placeholder: StringUtils Default Resolution: StringUtils, * (System) Namespace: Stu Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: StringUtils SysMem ¶ Library Identification ¶ Placeholder: SysMem Default Resolution: SysMem, * (System) Namespace: SysMem Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: SysMem SysSocket2 ¶ Library Identification ¶ Placeholder: SysSocket2 Default Resolution: SysSocket2, * (System) Namespace: SysSocket2 Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: SysSocket2 SysSocket2 Implementation ¶ Library Identification ¶ Placeholder: SysSocket2 Implementation Default Resolution: SysSocket2 Implementation, * (System) Namespace: SysSocket2_Implementation Library Properties ¶ LinkAllContent: False Optional: False PublishSymbolsInContainer: True QualifiedOnly: False SystemLibrary: False Key: SysSocket2 Implementation SysTime ¶ Library Identification ¶ Name: SysTime Version: 3.5.9.0 Company: System Namespace: SysTime Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: SysTime, 3.5.9.0 (System) SysTypes2 Interfaces ¶ Library Identification ¶ Name: SysTypes2 Interfaces Version: newest Company: System Namespace: SysTypes Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: SysTypes2 Interfaces, * (System) Web Socket Client SL ¶ Library Identification ¶ Placeholder: Web_Socket_Client_SL Default Resolution: Web Socket Client SL, * (CODESYS) Namespace: WEB_SOCKET Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: True SystemLibrary: False Key: Web_Socket_Client_SL
MQTT_REASON_CODE (ENUM) ¶ TYPE MQTT_REASON_CODE : MQTT V5 reason codes Attributes: qualified_only InOut: Name Initial Success 0 Granted_QoS_1 1 Granted_QoS_2 2 Disconnect_with_Will_Message 4 No_matching_subscribers 16 No_subscription_existed 17 Continue_authentication 24 Re_authenticate 25 Unspecified_error 128 Malformed_Packet 129 Protocol_Error 130 Implementation_specific_error 131 Unsupported_Protocol_Version 132 Client_Identifier_not_valid 133 Bad_User_Name_or_Password 134 Not_authorized 135 Server_unavailable 136 Server_busy 137 Banned 138 Server_shutting_down 139 Bad_authentication_method 140 Keep_Alive_timeout 141 Session_taken_over 142 Topic_Filter_invalid 143 Topic_Name_invalid 144 Packet_Identifier_in_use 145 Packet_Identifier_not_found 146 Receive_Maximum_exceeded 147 Topic_Alias_invalid 148 Packet_too_large 149 Message_rate_too_high 150 Quota_exceeded 151 Administrative_action 152 Payload_format_invalid 153 Retain_not_supported 154 QoS_not_supported 155 Use_another_server 156 Server_moved 157 Shared_Subscriptions_not_supported 158 Connection_rate_exceeded 159 Maximum_connect_time 160 Subscription_Identifiers_not_supported 161 Wildcard_Subscriptions_not_supported 162