RoboHub

This page was generated from the source of RoboHub. Edit the source, not this page.

Publishes to and follows an MQTT broker, as a provider of the bus interface.

robohub-provider-mqtt

The MQTT provider of the bus interface (robohub.bus). It publishes at QoS 1
and follows a filter in the background, keeping the newest message per topic,
through the RoboHub platform's mqtt port: a program that binds this provider
gets the port. The application calls the interface (bus.publish,
bus.follow …), never the provider (see robohub-bus/index); Mesh,
aquarium and energy bind it.

deps:
  robohub:
    robohub-bus: ">=0.2.0"
    robohub-provider-mqtt: ">=0.2.0"

bind:
  robohub.bus:
    providers: [robohub-provider-mqtt]
    config:
      robohub-provider-mqtt:
        broker: "mqtt://127.0.0.1:1884"   # optional

Settings

SettingDefaultMeaning
brokerROBOHUB_BUS_URLthe broker's URL
userROBOHUB_BUS_USERthe broker user
password_fileROBOHUB_BUS_PASSWORD_FILEthe file the password is in
enabledon"false" keeps it bound but not answering

The defaults are what the keeper starts the application with: it runs the broker
(the robohub-mqtt plugin) and makes a broker user for every application that
binds the bus, allowed the topics its manifest's bus: block names. The
password is read from its file by the port and never passes through a setting or
a command line.

Release history

[0.1.0] - 2026-11-13

The MQTT provider of the bus interface: publishes at QoS 1, follows a filter in the background with the newest message per topic, through the RoboHub platform's mqtt port, with the broker the keeper gave the application unless the binding names another.

[0.2.0] - 2026-11-13

Implements relay and follow_lines of robohub-bus 0.2.0 through the mqtt port's mqtt_relay and mqtt_follow_lines (rho-robohub 0.5.0).