README.md
TinySensors' Hub

Several programs, sensorhub, mux, status, mqtt, lcd, to connect 
TinySensors to the Internet. Prototyped and run on a Raspberry Pi with 
an nrf24l01+ connected to its GPIO port, as described 
<![CDATA[]]>here<![CDATA[]]>.

sensorhub


must be run as root (for access to /dev/watchdog and /dev/spidev)
polls the RF24 device for messages from sensors
writes sensor readings into a MySQL database


By default it,
- listens on port 5555 for TCP connections on which it
  echoes sensor readings (disable with -s)
- runs as a daemon (disable with -v, also enables verbose mode)
- will reboot the Pi via the watchdog timer if no sensor readings
  received for 5 minutes, it seems the radio stops responding every
  few weeks or so (disable with -w)

See <![CDATA[]]>here<![CDATA[]]> for more information on the Pi's watchdog timer.

mux


connects to sensorhub's port 5555
listens for up to 20 clients on port 5678 and relays sensor readings to them
by default runs as a daemon (disable with -v, also enables verbose mode)


status


manages a pair of LEDs (red and green) connected to a single GPIO line
connects to mux and flashes the red LED when it detects sensor activity
green LED stays solid until inactivity timeout when it turns solid red


lcd


connects to mux and <![CDATA[]]>lcdproc server<![CDATA[]]>
displays several screens' worth of sensor information


mqtt


connects to mux and <![CDATA[]]>MQTT server<![CDATA[]]>
writes sensor information to several topics in either text or json format
also supports <![CDATA[]]>Domoticz<![CDATA[]]> and 
<![CDATA[]]>Opensensors<![CDATA[]]>


other clients


unmaintained
rrd writes readings to an <![CDATA[]]>RRD database<![CDATA[]]>
mysql writes readings to a MySQL database