Sending a message using Mosquitto
You can send the following types of messages:
- Send data from a device to a registry using the
$devices/<device_ID>/events
or$registries/<registry_ID>/events
topics. - Send data from a device to a registry using the permanent
$devices/<device_ID>/state
or$registries/<registry_ID>/state
topics. - Send registry commands to a device using the
$devices/<device_ID>/commands
or$registries/<registry_ID>/commands
topics. - Send registry commands to a device using the permanent
$devices/<device_ID>/config
or$registries/<registry_ID>/config
topics.
To receive messages, you need to subscribe to the sender. For information about how to do this, see Subscribing a device or registry to receive messages using Mosquitto.
To learn how to make sure a message has been sent and delivered, see Testing message delivery.
Warning
Registry and device topics are not interconnected. If a device sends data to the device topic for telemetry data, you can only receive it by subscribing to this topic. The same is true for registry topics.
Getting started
Prepare the following:
- Registry.
- A registry certificate.
- Device.
- A device certificate.
- Mosquitto
, an open source MQTT message broker. It is used in instructions for sending messages and subscribing to devices. Download and install it to work with commands given in instructions.
Connecting to an MQTT server
To connect to the MQTT server, use the following parameters:
- A certificate from the certificate authority
. - Server address:
mqtt.cloud.yandex.net
. - Server port:
8883
. - Protocol:
TLSv1.2
.
Sending a message with data
Send a message with data using the following parameters:
-h
: MQTT server address.-p
: MQTT server port.--cafile
: Path to the certificate from the certificate authority (CA).--cert
: Path to the public part of the device certificate.--key
: Path to the private part of the device certificate.-t
: Device topic.-m
: Message text.-q
: Quality of service (QoS).
Note
If you encounter an error while running the command, add the --debug
flag to the command and try again. This flag outputs the debug log when running the command, which helps you diagnose the problem.
-
Send data to the device topic:
mosquitto_pub -h mqtt.cloud.yandex.net \ -p 8883 \ --cafile rootCA.crt \ --cert device-cert.pem \ --key device-key.pem \ -t '$devices/<device_ID>/events' \ -m 'Test data' \ -q 1
-
Send data to the permanent device topic:
mosquitto_pub -h mqtt.cloud.yandex.net \ -p 8883 \ --cafile rootCA.crt \ --cert device-cert.pem \ --key device-key.pem \ -t '$devices/<device_ID>/state' \ -m 'Test data' \ -q 1
Registries subscribed to this topic will know which device sent the data, because the topic contains a unique device ID.
-
Send data to the registry topic:
mosquitto_pub -h mqtt.cloud.yandex.net \ -p 8883 \ --cafile rootCA.crt \ --cert device-cert.pem \ --key device-key.pem \ -t '$registries/<registry_ID>/events' \ -m 'Test data' \ -q 1
-
Send data to the permanent registry topic:
mosquitto_pub -h mqtt.cloud.yandex.net \ -p 8883 \ --cafile rootCA.crt \ --cert device-cert.pem \ --key device-key.pem \ -t '$registries/<registry_ID>/state' \ -m 'Test data' \ -q 1
The registry subscribed to this topic will not know which device sent the data, because the topic does not contain a unique device ID.
Sending messages with commands
A registry can send messages with commands to one, multiple, or all devices added to it. Let's look at all the options.
Send a message with a command using the following parameters:
-h
: MQTT server address.-p
: MQTT server port.--cafile
: Path to the certificate from the certificate authority (CA).--cert
: Path to the public part of the registry certificate.--key
: Path to the private part of the registry certificate.-t
: Device topic.-m
: Message text.-q
: Quality of service (QoS).
Note
If you encounter an error while running the command, add the --debug
flag to the command and try again. This flag outputs the debug log when running the command, which helps you diagnose the problem.
-
Send a command to a single device:
mosquitto_pub -h mqtt.cloud.yandex.net \ -p 8883 \ --cafile rootCA.crt \ --cert registry-cert.pem \ --key registry-key.pem \ -t '$devices/<device_ID>/commands' \ -m 'Test command for first device' \ -q 1
-
Send a command to a single device using the permanent topic:
mosquitto_pub -h mqtt.cloud.yandex.net \ -p 8883 \ --cafile rootCA.crt \ --cert registry-cert.pem \ --key registry-key.pem \ -t '$devices/<device_ID>/config' \ -m 'Test command for first device via permanent topic' \ -q 1
-
Send a command to two devices:
mosquitto_pub -h mqtt.cloud.yandex.net \ -p 8883 \ --cafile cert.pem \ --cert registry-cert.pem \ --key registry-key.pem \ -t '$devices/<first_device_ID>/commands' \ -t '$devices/<second_device_ID>/commands' \ -m 'Test command for first and second device' \ -q 1 # Quality of service level, QoS 1.
-
Send a command to two devices using the permanent topic:
mosquitto_pub -h mqtt.cloud.yandex.net \ -p 8883 \ --cafile cert.pem \ --cert registry-cert.pem \ --key registry-key.pem \ -t '$devices/<first_device_ID>/config' \ -t '$devices/<second_device_ID>/config' \ -m 'Test command for first and second devices via permanent topic' \ -q 1 # Quality of service level, QoS 1.
-
Send a command to all devices added to the registry:
mosquitto_pub -h mqtt.cloud.yandex.net \ -p 8883 \ --cafile cert.pem \ --cert registry-cert.pem \ --key registry-key.pem \ -t '$registries/<registry_ID>/commands' \ -m 'Test command for all devices' \ -q 1
-
Send a command to all devices added to the registry using the permanent topic:
mosquitto_pub -h mqtt.cloud.yandex.net \ -p 8883 \ --cafile cert.pem \ --cert registry-cert.pem \ --key registry-key.pem \ -t '$registries/<registry_ID>/config' \ -m 'Test command for all devices via permanent topic' \ -q 1