josephdpearson/lightwaverf

Arduino Libraries for LightwaveRF 433MHz rx and tx

Arduino, Spark and Raspberry libraries for Lightwave RX and TX at 433MHz

LxRx - a Arduino / Spark library for LightwaveRF receive Reception is interrupt driven Reception is buffered, Foreground should read an available messsge before next one is received lwrx_setup(int pin) - initialise reception, pin can be 2 or 3 lwrx_settranslate(boolean translate) translate true (default) formats message as 10 nibbles translate false messages as 10 raw bytes boolean lwrx_message() returns true if message available boolean lwrx_getmessage(byte* buf, byte* len) returns 10 byte message into buf

LxTx - a Arduino / Spark library for LightwaveRF transmit Transmission is interrupt driven Foreground sends a message which is buffered and sent in background lwtx_setup(int pin, byte repeatcount) - initialise transmission, pin can be any pin lwtx_settranslate(boolean translate) translate true (default) formats message as 10 nibbles translate false messages as 10 raw bytes boolean lwtx_free() returns true if message can be sent, false if one still in progress boolean lwtx_send(byte* buf) 10 byte message in buf void lwtx_setTickCounts( byte lowCount, byte highCount, byte trailCount, byte gapCount)

LxTxTest - simple Test sketch for LwTx lib, sends one messages repeatedly LxRxTest - simple Test sketch for LwRx lib, monitors and prints messages on serial port LxTxTestEx - extended Test sketch for LwTx lib, responds to serial coomands to send message and adjust protocol values

lwrf.py - An experimental library for rx and tx on Raspberry Currently only the rx side is functional

Notes: As these libraries use interrupt service routines they may have issues with other services using interrupts like Serial. The time spent in the isrs is kept very small to minimise risks. The LxTx library also uses Timer2 and assumes 16MHz clock rates.

Updates 9 Nov 2013 LxRx library window for 0 detection widened

LxTx rework to allow better control of pulse widths. Interrupt tick is now a default of 140uSec A 1 is encoded as 2 ticks high followed by 2 ticks low (280uSec high + 280uSec low) A 0 is encoded as 7 ticks low (980uSec low) A 1 followed by 0 therefore is 280uSec high followed by 1260uSec low Added the function lwtx_setCounts to allow tuning of the tick counts for experimentation

Added new sketch LwTxTestEx for experimentation

Update 11 Nov 2013 Added stats gathering onto RX library and test sketch so that timings can be measured.

Update 19 Nov 2013 Added pairing and filtering to rx library Added set address to tx library and short cmd method after address set Reworked LwTxTestEx and LwRxTest sketches to respond to serial port commands Sketches can save pairing and address details to EEPROM NOTE interface to getmessage in RX library has changed, len is passed as a value rather than a pointer.

Updated 20 Nov 2013 EEPROM functions moved to library Pairing functions enhanced Auto pairing mode where a pair can be created from a received message

Updated 21 Nov 2013 Pairing now uses On commands. Off commands try to remove an existing pair. Extra pairing controls to enforce pairing even when no pairs are present and to control whether room/device are included

Updated 1 Jun 2014 The libraries have been restructured slightly to make it easier to port to different environments. #defines on the RX library control whether EEPROM support is used and the pin mapping onto interrupts. The TX library now splits out the timer interrupt specific code into 3 simple functions which may be adjusted to suit the environment. THree variants are included for AVR 8 bit, Due and Spark core. Onlt the first has been compiled and tested so far.

Updated 3 Jun 2014 EEPROM_EN in the headers now takes 3 values. 0 is no EEPROM support, 1 is use EEPROM with external EEPROM library, 2 is use EEPROM with native EEPROM functions if supported. The base address for EEEPROM storage defaults as before but may now also be set with an extra library call.

Updated 9 Jun 2014 Path to SparkIntervalTimer.h changed to reflect the import in Spark IDE readme.txt renamed to README.md

Updated 17 Jan 2015 First version of an experimental rx / tx python library for Raspberry Pi using the pigpio library for fast IO access Only RX side functional at present. TX side being debugged

Updated 18 Jan 2015 Both RX and TX sides of Raspberry python library now functional

Updated 20 Jan 2015 Although Raspberry python works it is consuming all the CPU. This is because the PIGPIO python i/f adds a lot of overhead and the RX receiver has background noise transitions all the time. Working on optimisation strategies.

Updated 21 Jan 2015 There is now a c++ version which runs on Raspberry directly linked to PIGPIO. This is much more efficient than using th epigpio python interface and CPU usage is now very low (< 7%). A simple test c program is included but it should also be possible to make a version which runs in the background and makes the Lightwave messages available via FIFO pipes.

Updated 6 Feb 2015 There is now a Raspberry Pi version using the recently introduced custom extension method to pigpio. This makes it easy to access from languages via the pigpiod daemon while maintaining low processor usage. A python example is given. This is now the preferred Raspberry pi method and I won't be doing a separate pipe access method.