MQTT Broker: Difference between revisions

From Protospace Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 8: Line 8:
Messages are just strings of text like "hello world" or "12.3".
Messages are just strings of text like "hello world" or "12.3".


Messages are sent to arbitrary topics like <code>/pets/dogs/charlie</code>. By convention slashes separate levels of category that we all agree on.
Messages are sent to arbitrary topics like <code>pets/dogs/charlie</code>. By convention slashes separate levels of category that we all agree on.


When a message is sent to a topic, all devices that are subscribed to that topic receive the message.
When a message is sent to a topic, all devices that are subscribed to that topic receive the message.


Topics aren't really created, they just exist as soon as a message is sent to them.
Topics aren't really created, they just exist as soon as a message is sent to them.
Normally messages aren't stored anywhere. They just get sent out and received by whoever happens to be listening to the same topic. However, we automatically log messages to the <code>sensors/</code> topics using [https://github.com/influxdata/telegraf/tree/master/plugins/inputs/mqtt_consumer Telegraf] + [https://github.com/influxdata/influxdb#influxdb- InfluxDB].


===Access===
===Access===
Line 18: Line 20:


====Reading====
====Reading====
Anyone can read any topic. Don't send anything private over the broker.
Anyone can read any topic. Don't send anything private to the broker.


*username: reader
*username: reader
Line 32: Line 34:
The MQTT Broker is hosted on the [[Webhost VPS]] managed by Tanner. The same one that's running the main [[Website]] and the [[Wiki]].
The MQTT Broker is hosted on the [[Webhost VPS]] managed by Tanner. The same one that's running the main [[Website]] and the [[Wiki]].


=== References ===
===References===
<references />
<references />

Revision as of 19:22, 10 August 2021

The MQTT Broker is a server that allows publishing and subscribing to MQTT topics.

It's meant for sensors and devices at Protospace to communicate publicly and for fun.

Theory

MQTT is a lightweight, publish-subscribe network protocol that transports messages between devices[1]. It's low power and ideal for microcontrollers hooked up to sensors and devices.

Messages are just strings of text like "hello world" or "12.3".

Messages are sent to arbitrary topics like pets/dogs/charlie. By convention slashes separate levels of category that we all agree on.

When a message is sent to a topic, all devices that are subscribed to that topic receive the message.

Topics aren't really created, they just exist as soon as a message is sent to them.

Normally messages aren't stored anywhere. They just get sent out and received by whoever happens to be listening to the same topic. However, we automatically log messages to the sensors/ topics using Telegraf + InfluxDB.

Access

Server / host: webhost.protospace.ca

Reading

Anyone can read any topic. Don't send anything private to the broker.

  • username: reader
  • password: cf503b99ba8cb0103da8884f09694fcd60ba1f2d

Writing

Ask Tanner for write access to the broker. We want to make sure you don't accidentally screw up sensor data.

  • username: writer
  • password: [ask Tanner]

Technical Info

The MQTT Broker is hosted on the Webhost VPS managed by Tanner. The same one that's running the main Website and the Wiki.

References