Litmus Unify

7 min

The Litmus Unify connector connects Litmus Edge (LE) to Litmus Unify through the Litmus Unify MQTT broker. It publishes LE data to Litmus Unify, under the namespace hierarchy that Litmus Unify assigns to the edge. It can also subscribe to Litmus Unify topics and publish the data to a local topic.

The connector registers with Litmus Unify by using a token. When you save the connector, it exchanges the token for the broker address, credentials, and namespace hierarchy, and then publishes through that broker.

Supported communication

Outbound (publish data from LE to Litmus Unify): Yes

Inbound (subscribe to data from Litmus Unify and publish it to a local topic): Yes

Compatibility

The connector connects to Litmus Unify.

Registration

Registration runs when you save the connector:

The connector exchanges the Litmus Unify Token once with Litmus Unify.

Litmus Unify returns the broker address, credentials, CA certificate, client certificate, and namespace hierarchy for this edge.

The connector stores these values in its configuration, fills in Connection Type, Port, CA Certificate, Unify Client ID, and Unify Hierarchy, and clears the token.

Connector configuration

Field	Type	Description	Required	Default
Name	String	Name of this connector instance.	Yes	-
Litmus Unify Token	String (Secret)	Registration token from Litmus Unify. The connector exchanges it once, when you save the connector, and then clears it. Enter a new token to register again.	Yes, to register	-
Skip Certificate Verification	Boolean	Skip verification of the broker's certificate. Use it only for test brokers with a self-signed certificate.	No	Disabled
Connection Type	Dropdown	Broker transport. mqtt and ws are unencrypted. mqtts and wss use TLS. Registration sets this field to the transport that Litmus Unify reports. You can change it afterward.	No	mqtt
Port	Integer	Broker port for the selected transport. Registration sets this field. A value of 0 keeps the registered port. Change it only if the broker serves the selected transport on another port. Range is 0 to 65535.	No	0
WebSocket Path	String	URL path that the broker serves MQTT on, such as /mqtt. The path must start with /. Applies only when Connection Type is ws or wss.	Conditional	-
CA Certificate	String (Secret)	PEM CA certificate that the connector uses to verify the broker. Registration sets this field to the CA that Litmus Unify supplies. Replace it to verify against a different CA, or clear it to use the supplied CA or the system certificate store. Applies only when Connection Type is mqtts or wss.	No	-
Unify Client ID	String	Identifier that Litmus Unify assigned to this edge at registration. Filled in automatically.	No	-
Unify Hierarchy	String	Slash-separated namespace levels that this edge publishes under, such as site/area/line. Filled in automatically at registration. Read-only.	No	-
Parallel Publish Count	Integer	Number of messages the connector publishes at the same time. Higher values increase throughput and resource usage. Range is 1 to 4000.	No	100

Advanced parameters

These parameters appear in the advanced section of the connector form.

Field	Type	Description	Required	Default
Connection Timeout	Integer	Maximum time in seconds for one connection attempt. Over ws and wss, this also limits the WebSocket handshake. Range is 1 to 60.	No	30
Ping Timeout	Integer	Time in seconds to wait for the broker's keep-alive reply before the connector treats the connection as lost. The connector checks every five seconds, so it rounds the value up to the next multiple of 5. Range is 5 to 60.	No	10
Reconnect Interval	Integer	Time in seconds to wait after a lost or failed connection before the next attempt. Range is 1 to 60.	No	5
Publish Wait Timeout	Integer	Maximum time in seconds for a single publish before the connector gives up on it. Range is 1 to 60.	No	10

Additional attributes

Field	Type	Description	Required	Default
Throttling limit	Integer	Maximum outbound messages per second. A value of 0 disables throttling. Minimum is 0.	No	0
Persistent storage	Boolean	Store outbound queue messages on disk. If the connection drops or the system loses power, the messages are retained and sent once the connection is restored.	No	Enabled
Persistent storage size limit	Integer	Maximum disk space in GB used for persisted data. Applies only when Persistent storage is enabled. Minimum is 1.	Conditional	1
Queue Mode	Dropdown	Order in which the connector sends buffered messages. fifo sends the earliest message first. lifo sends the latest message first. Applies only when Persistent storage is enabled.	No	lifo
Enable Logging	Boolean	Write connection and publish error messages to the connector log. Logging can increase CPU usage, so enable it only for debugging.	No	Disabled

Topic parameters

Outbound and inbound topics have one extra parameter.

Field	Type	Description	Default
Qos	Dropdown	MQTT quality of service level for the topic: default, 0, 1, or 2.	default

Add a ConnectorAdd a Connector

Manage ConnectorsManage Connectors

Organize Device and Tag Data by Using MetadataOrganize Device and Tag Data by Using Metadata