RadioHead Packet Radio Library

Anybody used the RadioHead Packet Radio Library with MSP430 or Tiva?

http://www.airspayce.com/mikem/arduino/RadioHead/

This is the RadioHead Packet Radio library for embedded microprocessors. It provides a complete object-oriented library for sending and receiving packetized messages via a variety of common data radios on a range of embedded microprocessors.

The version of the package that this documentation refers to can be downloaded from http://www.airspayce.com/mikem/arduino/RadioHead/RadioHead-1.25.zip You can find the latest version athttp://www.airspayce.com/mikem/arduino/RadioHead

You can also find online help and disussion at http://groups.google.com/group/radiohead-arduino Please use that group for all questions and discussions on this topic. Do not contact the author directly, unless it is to discuss commercial licensing. Before asking a question or reporting a bug, please read http://www.catb.org/esr/faqs/smart-questions.html

RadioHead consists of 2 main sets of classes: Drivers and Managers.

• Drivers provide low level access to a range of different packet radios and other packetized message transports.
• Managers provide high level message sending and receiving facilities for a range of different requirements.

Every RadioHead program will have an instance of a Driver to provide access to the data radio or transport, and a Manager that uses that driver to send and receive messages for the application. The programmer is required to instantiate a Driver and a Manager, and to initialise the Manager. Thereafter the facilities of the Manager can be used to send and receive messages.

It is also possible to use a Driver on its own, without a Manager, although this only allows unaddressed, unreliable transport via the Driver's facilities.

In some specialised cases, it is possible to instantiate more than one Driver and more than one Manager.

A range of different common embedded microprocessor platforms are supported, allowing your project to run on your choice of processor.

Example programs are included to show the main modes of use.

The following Drivers are provided:

• RH_RF22 Works with Hope-RF RF22B and RF23B based transceivers, and compatible chips and modules, including the RFM22B transceiver module such as this bare module: http://www.sparkfun.com/products/10153and this shield: http://www.sparkfun.com/products/11018 and this board: http://www.anarduino.com/miniwireless and RF23BP modules such as: http://www.anarduino.com/details.jsp?pid=130 Supports GFSK, FSK and OOK. Access to other chip features such as on-chip temperature measurement, analog-digital converter, transmitter power control etc is also provided.
• RH_RF69 Works with Hope-RF RF69B based radio modules, such as the RFM69 module, (as used on the excellent Moteino and Moteino-USB boards from LowPowerLab http://lowpowerlab.com/moteino/ ) and compatible chips and modules such as RFM69W, RFM69HW, RFM69CW, RFM69HCW (Semtech SX1231, SX1231H). Also works with Anarduino MiniWireless -CW and -HW boardshttp://www.anarduino.com/miniwireless/ including the marvellous high powered MinWireless-HW (with 20dBm output for excelent range). Supports GFSK, FSK.
• RH_NRF24 Works with Nordic nRF24 based 2.4GHz radio modules, such as nRF24L01 and others. Also works with Hope-RF RFM73 and compatible devices (such as BK2423). nRF24L01 and RFM73 can interoperate with each other.
• RH_NRF905 Works with Nordic nRF905 based 433/868/915 MHz radio modules.
• RH_RF95 Works with Semtech SX1276/77/78 and HopeRF RFM95/96/97/98 and other similar LoRa capable radios. Supports Long Range (LoRa) with spread spectrum frequency hopping, large payloads etc. FSK/GFSK/OOK modes are not (yet) supported.
• RH_ASK Works with a range of inexpensive ASK (amplitude shift keying) RF transceivers such as RX-B1 (also known as ST-RX04-ASK) receiver; TX-C1 transmitter and DR3100 transceiver; FS1000A/XY-MK-5V transceiver; HopeRF RFM83C / RFM85. Supports ASK (OOK).
• RH_Serial Works with RS232, RS422, RS485, RS488 and other point-to-point and multidropped serial connections, or with TTL serial UARTs such as those on Arduino and many other processors, or with data radios with a serial port interface. RH_Serial provides packetization and error detection over any hardware or virtual serial connection.
• RH_TCP For use with simulated sketches compiled and running on Linux. Works with tools/etherSimulator.pl to pass messages between simulated sketches, allowing testing of Manager classes on Linuix and without need for real radios or other transport hardware.

Drivers can be used on their own to provide unaddressed, unreliable datagrams. All drivers have the same identical API. Or you can use any Driver with any of the Managers described below.

We welcome contributions of well tested and well documented code to support other transports.

The following Mangers are provided:

• RHDatagram Addressed, unreliable variable length messages, with optional broadcast facilities.
• RHReliableDatagram Addressed, reliable, retransmitted, acknowledged variable length messages.
• RHRouter Multi-hop delivery from source node to destination node via 0 or more intermediate nodes.
• RHMesh Multi-hop delivery with automatic route discovery and rediscovery.

Any Manager may be used with any Driver.

A range of platforms is supported:

• Arduino and the Arduino IDE (version 1.0 to 1.5.5 and later) Including Diecimila, Uno, Mega, Leonardo, Yun etc. http://arduino.cc/, Also similar boards such as Moteino http://lowpowerlab.com/moteino/ , Anarduino Minihttp://www.anarduino.com/mini/ etc.
• ChipKit Uno32 board and the MPIDE development environment http://www.digilentinc.com/Products/Detail.cfm?Prod=CHIPKIT-UNO32
• Maple and Flymaple boards with libmaple and the Maple-IDE development environment http://leaflabs.com/devices/maple/ and http://www.open-drone.org/flymaple
• Teensy including Teensy 3.1 built using Arduino IDE 1.0.5 with teensyduino addon 1.18 and later. http://www.pjrc.com/teensy

Other platforms are partially supported, such as Generic AVR 8 bit processors, MSP430. We welcome contributions that will expand the range of supported platforms.

RadioHead was created in April 2014, substantially based on code from some of our other earlier libraries:

• RHMesh, RHRouter, RHReliableDatagram and RHDatagram are derived from the RF22 library version 1.39.
• RH_RF22 is derived from the RF22 library version 1.39.
• RH_RF69 is derived from the RF69 library version 1.2.
• RH_ASK is based on the VirtualWire library version 1.26, after significant conversion to C++.
• RH_Serial was new.
• RH_NRF24 is based on the NRF24 library version 1.12, with some significant changes.

During this combination and redevelopment, we have tried to retain all the processor dependencies and support from the libraries that were contributed by other people. However not all platforms can be tested by us, so if you find that support from some platform has not been successfully migrated, please feel free to fix it and send us a patch.