Projects/MQTT

Project MQTT
Name	MQTT
Start	2016/09/16
End
Contact	User:Polyfloyd
Website
Information	Lijm voor space-events
Status	Production

MQTT is een netwerkprotocol om korte statusberichten heen en weer te schuiven.

Topics

Vanwege privacyredenen is niet alle informatie op het hele internet beschikbaar. Bitlair's MQTT infra bestaat daarom uit twee servers; een server toegankelijk vanaf het internet en een andere server die alleen binnen het spacenetwerk bereikbaar is waarop naast de normale events ook events worden gepubliceerd die we liever apart houden.

Openbaar: bitlair.nl

• bitlair/state {open,closed}
• bitlair/state/djo {open,closed}
• bitlair/music/<spelernaam>/state {playing,paused,stopped}
• bitlair/music/<spelernaam>/volume <volume percentage>
• bitlair/wifi/<netwerknaam>¹/online <aantal verbonden clients>
• bitlair/climate/#
• bitlair/photos <bestandsnaam van foto's gemaakt met de WIP-cam>
• bitlair/pos/product <naam van artikel verkocht via Revbank>
• bitlair/lasercutter/# <stats gerapporteerd door de lasercutter>

¹: "all" is een speciale netwerknaam die de gegevens van de andere netwerken combineert.

Intern: mqtt.bitlair.nl

• bitlair/alarm {armed,disarmed} <alarmcode>
• bitlair/lock/<slotnaam> {lock,unlock} <naam> (TODO)
• bitlair/music/<spelernaam>/track <artist> - <title>
• bitlair/wifi/<netwerknaam> {join,part} <mac> -|<signaalsterkte>
• bitlair/doorbell

Meekijken

• Installeer https://github.com/Juerd/Net-MQTT-Simple
  • # cpan Net::MQTT::Simple
• $ mqtt-simple -h mqtt.bitlair.nl --color -s 'bitlair/#'

Grafiekjes

De monitoring server op [1] heeft een catch-all die data van sensoren verzamelt. Laat een sensor data publiceren op bitlair/climate/{locatie}/{eenheid} met iets numerieks als waarde en het komt vanzelf in Prometheus.

Scripts

Voor scripts in gebruik en voorbeelden, zie: https://github.com/bitlair/mqtt-scripts

Het is ook mogelijk om via een EventStream de status bij te houden:

var s = new EventSource('https://bitlair.nl/mqtt?bitlair/%23=bitlair');
s.addEventListener('bitlair', function (e) {
	var json = JSON.parse(e.data);
	var topic  = json[0];
	var value  = json[1];
	var retain = json[2];
	console.log(topic, value, retain ? 'r' : '_');
});

Zie ook: https://github.com/Juerd/mqtt2web