MQTT Topics: Difference between revisions
mNo edit summary |
|||
| Line 130: | Line 130: | ||
* LLAP device details http://openmicros.org/index.php/articles/87-llap-devices-commands-and-instructions | * LLAP device details http://openmicros.org/index.php/articles/87-llap-devices-commands-and-instructions | ||
Payload for MQTT message is upto 9byte's, the message part of LLAP, padding is automatically added and striped.<br/> | |||
aNOHELLO----<br/> | |||
becomes<br/> | |||
nh/xrf/?x/NO HELLO | |||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
| Line 136: | Line 140: | ||
! Notes | ! Notes | ||
|- | |- | ||
| nh/xrf/tx || Send out a LLAP message || | | nh/xrf/tx/XX || Send out a LLAP message || XX is DEVID | ||
|- | |- | ||
| nh/xrf/rx || LLAP message received || | | nh/xrf/rx/XX || LLAP message received || XX is DEVID | ||
|} | |||
==[[Lighting Automation]]== | |||
{| class="wikitable" | |||
|- | |||
! Topic | |||
! Description | |||
! Notes | |||
|- | |||
| nh/li/ROOM || Toggle Lighting || ROOM is one of the pre defined rooms and payload is zone number | |||
|} | |} | ||
Revision as of 17:25, 28 April 2012
This is the list of MQTT Topics that are use by the various HackSpace Instrumentation projects.
All topics should be prefixed with "nh/"
STATUS
nh/status
All clients should subscribe to the topic and listen for the message "STATUS"
Clients should respond with there name and status.
Three states
- Restart:
- Running:
- Terminated:
ie. "Running: MatrixMQTT"
Include the : and a space before the clients name,
Current list of clients
- MatrixMQTT
- Gatekeeper (arduino)
- nh-irccat
- nh-irc
- nh-matrix
- GateKeeper (process)
- nh-gk-if
- nh-irc-misc
The status of all running clients is logged and reported here http://lspace.nottinghack.org.uk/addr_graphs/status.php
Gatekeeper
| Topic | Description | Notes |
|---|---|---|
| nh/gk/Unlock | ||
| nh/gk/DoorState | ||
| nh/gk/Keypad | ||
| nh/gk/DoorButton | ||
| nh/gk/RFID | ||
| nh/gk/LastManState | ||
| nh/gk/Status |
MatrixMQTT
| Topic | Description | Notes |
|---|---|---|
| nh/mb/tx | nh-matrix script transmits messages to be displayed | |
| nh/mb/rx | confirmation of displayed message is returned to nh-matrix | |
| nh/mb/Status | deprecated in MattrixMQTT 004 but still used via nh-matrix |
IRC Bot: nh-holly
Living in #nottinghack on freenode, nh-holly is our MQTT to IRC bridge
| Topic | Description | Notes |
|---|---|---|
| nh/irc/tx | Sends to the default #nottinghack channel | |
| nh/irc/tx/nottinghack | Sends to the #nottinghack channel | |
| nh/irc/tx/pm/<nick> | Sends a pm to <nick> | |
| nh/irc/rx/nottinghack/<nick> | Incoming message from irc #nottinghack channel | |
| nh/irc/rx/pm/<nick> | Incoming pm from irc user <nick> |
@Holly533MHz: nh-twitter
Twitter to MQTT bridge
| Topic | Description | Notes |
|---|---|---|
| nh/twitter/tx | ||
| nh/twitter/rx/dm/<screen_name | DM to @Holly533Mhz from <Screen_name> | |
| nh/twitter/rx/mention/<screen_name> | mention of @Holly533Mhz by <screen_name> | |
| nh/twitter/rx/hs | latest tweet from @HSNOTTS includes retweets | payload <screen_name>:<text> |
Temperature
Readings from DS18B20 1-Wire digital temperature sensors around the space are published every 2.5 minutes.
nh/temp
Message format as follows
address:temp
| address | Hex string 16 long |
| temp | Float 00.00 |
XRF & LLAP
LLAP message format
12 Char's
aXXDDDDDDDDD
- a start character
- XX Device ID
- DDDDDDDDD message
more detail can be found here:-
- LLAP http://openmicros.org/index.php/articles/85-llap-lightweight-local-automation-protocol/112-llap
- LLAP device details http://openmicros.org/index.php/articles/87-llap-devices-commands-and-instructions
Payload for MQTT message is upto 9byte's, the message part of LLAP, padding is automatically added and striped.
aNOHELLO----
becomes
nh/xrf/?x/NO HELLO
| Topic | Description | Notes |
|---|---|---|
| nh/xrf/tx/XX | Send out a LLAP message | XX is DEVID |
| nh/xrf/rx/XX | LLAP message received | XX is DEVID |
Lighting Automation
| Topic | Description | Notes |
|---|---|---|
| nh/li/ROOM | Toggle Lighting | ROOM is one of the pre defined rooms and payload is zone number |