mqtt_bridge

mqtt_bridge provides a functionality to bridge between ROS and MQTT in bidirectional.

mqtt_bridge is not actively maintained now. Feel free to check out mqtt_client, a high-performance C++ ROS nodelet with recent development!

Principle

mqtt_bridge uses ROS message as its protocol. Messages from ROS are serialized by json (or messagepack) for MQTT, and messages from MQTT are deserialized for ROS topic. So MQTT messages should be ROS message compatible. (We use rosbridge_library.internal.message_conversion for message conversion.)

This limitation can be overcome by defining custom bridge class, though.

Demo

Prerequisites

$ sudo apt install python3-pip
$ sudo apt install ros-noetic-rosbridge-library
$ sudo apt install mosquitto mosquitto-clients

Install python modules

$ pip3 install -r requirements.txt

launch node

$ roslaunch mqtt_bridge demo.launch

Publish to /ping,

$ rostopic pub /ping std_msgs/Bool "data: true"

and see response to /pong.

$ rostopic echo /pong
data: True
---

Publish “hello” to /echo,

$ rostopic pub /echo std_msgs/String "data: 'hello'"

and see response to /back.

$ rostopic echo /back
data: hello
---

You can also see MQTT messages using mosquitto_sub

$ mosquitto_sub -t '#'

Usage

parameter file (config.yaml):

mqtt:
  client:
    protocol: 4      # MQTTv311
  connection:
    host: localhost
    port: 1883
    keepalive: 60
bridge:
  # ping pong
  - factory: mqtt_bridge.bridge:RosToMqttBridge
    msg_type: std_msgs.msg:Bool
    topic_from: /ping
    topic_to: ping
  - factory: mqtt_bridge.bridge:MqttToRosBridge
    msg_type: std_msgs.msg:Bool
    topic_from: ping
    topic_to: /pong

you can use any msg types like sensor_msgs.msg:Imu.

launch file:

File truncated at 100 lines see the full file

Changelog for package mqtt_bridge

0.2.1 (2020-12-31)

• fix build dependency (#43)
• Contributors: Junya Hayashi

0.2.0 (2020-12-31)

• migrate to Python 3 (#25)
• Contributors: Christopher Mayershofer, Junya Hayashi, Yuma Mihira

0.1.8 (2020-12-31)

• configure rostest and run it on circleci (#41)
• split requirements.txt (#38)
• add unittests (#37)
• Fix 'install_requires' warning when building with --install (#32)
• Contributors: Jacob Seibert, Junya Hayashi

0.1.7 (2020-06-21)

• Fix mqtt subscribing to private path (#27)
• Fix frequency limit (#26)
• Add bson module in requirements.txt (#10)
• Fix Bridge not to fall when ros msg cannot be created (#4)
• Contributors: 5tan, Junya Hayashi, Tomas Cernik, Yuma Mihira, kapilPython

0.1.6 (2017-11-10)

• fix if frequency is none (#2)

0.1.5 (2016-12-07)

• Update configurations

0.1.0 (2016-12-04)

• Initial Release