mirror of
https://github.com/RIOT-OS/RIOT.git
synced 2024-12-29 04:50:03 +01:00
39 lines
1.4 KiB
Markdown
39 lines
1.4 KiB
Markdown
|
## About
|
||
|
|
This example application demonstrates the usage of the `Asymcute` MQTT-SN client
|
||
|
|
library. It provides a number of shell commands that can be used to trigger
|
||
|
|
selected procedures like connecting to a gateway, registration and subscription
|
||
|
|
of topics, and publishing of data.
|
||
|
|
|
||
|
|
## Setup
|
||
|
|
For this application to do anything useful, a running MQTT-SN gateway is needed.
|
||
|
|
If you don't have access to one, RIOT provides a simple way to start one locally
|
||
|
|
by providing a dedicated `rsmb` make target, type:
|
||
|
|
```
|
||
|
|
make rsmb
|
||
|
|
```
|
||
|
|
|
||
|
|
This will download, build, and run the Eclipse Mosquitto.rsmb 'Really Small
|
||
|
|
Message Broker' [(found here)](https://github.com/eclipse/mosquitto.rsmb).
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
Simply type
|
||
|
|
```
|
||
|
|
help
|
||
|
|
```
|
||
|
|
for a list of available commands.
|
||
|
|
|
||
|
|
## NOTE 1
|
||
|
|
The UDP socket handling for IPv6 based endpoints in the `Mosquitto.rsmb`
|
||
|
|
implementation is buggy when it comes to handling link local addresses,
|
||
|
|
as the implementation does not remember the interface on which data comes in,
|
||
|
|
hindering it from sending out any responses.
|
||
|
|
|
||
|
|
Quick workaround: simply use global addresses
|
||
|
|
|
||
|
|
## NOTE 2
|
||
|
|
It also seems that the `Mosquitto.rsmb` implementation has a bug when it comes
|
||
|
|
to subscribing to topics: if a topic name was formerly registered and the same
|
||
|
|
topic name is later used for issuing a subscription request, the gateway will
|
||
|
|
assign a new topic ID to the same topic name, so publish messages to the
|
||
|
|
initially assigned topic ID will not be seen by that subscription.
|