RQ

From Makers Local 256
Revision as of 23:02, 18 April 2016 by Tylercrumpton (Talk | contribs)

Jump to: navigation, search

Overview

Redqueen is a way to pass messages between all the iot devices we have at the shop in a way that is documented and expected.

Network Setup

We currently have two mqtt brokers setup, one that is local to the shop and is wide open for anything to send/receive. The other broker is located on our remote webserver and is exposed publicly with SSL and a username/password, meaning you will need to ask an Admin for access. All messages are mirrored between the brokers.

 Local only             Available from outside
--------------         --------------------------
| iot server |  <----> | remote.makerslocal.org |
--------------         --------------------------

Messages

Messages will be send in 1st person. As in "I (door) changed my status to open.". This is different than "Hey you, door....OPEN!".

MQTT Info

When connecting to mqtt be sure to set your clientid to something useful like 'rqirc'. This will help to determine who is causing problems if/when they do.

Local Host

  • dns: iot
  • ip: 10.56.0.18
  • port: default, 1883
  • user/pass: Not needed

Remote Host

  • host: 256.makerslocal.org
  • port: 35801
  • user/pass: Ask admin for access

Messages

IRC

rqirc will send out a message for thing like '!string'.

example: !alert I cut my finger off
ml256/irc/makerslocal/command/alert {"command":"alert", "channel":"#makerslocal", "user":"jimshoe", "message":"I cut my finger off"}

example: !shopstatus
ml256/irc/gen/command/shopstatus {"command":"shopstatus", "channel":"##gen", "user":"tylercrumpton", "message":""}

Temperature Sensors

Six Synapse RM-150 wireless temperature sensors are placed around the building that check in every five minutes. Current located in "kitchen", "office", "loft", "memberstorage", and "tool" (tool area). The RM-150 in "memberstorage" has an additional external k-type themocouple input connected on "ext0".

Ambient temperature in tool area:

ml256/tool/temp/ambient {"temperature":20.5, "units":"c"}

Ambient temperature in the fablab:

ml256/fablab/temp/ambient {"temperature":20.8, "units":"c"}

External thermocouple sensor temperature in member storage:

ml256/memberstorage/temp/ext0 {"temperature":19.8, "units":"c"}

Wiki Changes

 ml256/wiki/changes {"type":"edit","ns":"2","title":"User:Jimshoe","rcid":"20018","pageid":"1716","revid":"19945","old_revid":"19938","user":"Jimshoe","oldlen":"1147","newlen":"1146","timestamp":"2016-04-17T03:14:28Z","comment":"spaces","wikiid":"wikidb"}

History

This is the documentation for the current version of RedQueen. RedQueen is a documented way to pass messages between devices inside and outside the shop. We have gone through a few versions.

  • RQ/v1 - Initial ideas
  • RQ/v2 - Tyler's initial python bot, which is doing all the messages passing
  • RQ/v3 - Our attempt to use Couchdb to do all the message passing.
  • RQ/v4 - This page