Skip to content

Latest commit

 

History

History
58 lines (50 loc) · 2.91 KB

README.md

File metadata and controls

58 lines (50 loc) · 2.91 KB
Raw

#RF24Remote: remote driver for a nRF24l01 device using RF24 library interface

Goal:

  • provide interface for communication using nRF24L01 modules on devices that don't have SPI/GPIO - typically a PC, linux boxes/development boards
  • keep (almost) the same interface as RF24 library so applications can be reused
  • libraries utilizing RF24 (RF24Network, RF24Mesh) can use this library as well
  • primary developed and tested on Linux, but should be possible to adapt for other OSes

Supported communication interfaces:

Components:

  • RF24Remote - common library
  • RF24VUsb - library + examples for an arduino device connected via VUsb
  • RF24Serial - library + examples for an arduino device connected via serial port
  • RF24Frontend - library + examples for driving nRF24l01 device remotely via specified interface
  • RF24 - linked RF24 library. At the moment it's slightly adapted RF24 so it's needed to use exactly this version

Installation:

  1. Prepare a device that will drive nRF24l01 module, either via VUsb or Serial.
  • for Serial:
    • an Arduino board with nRF24l01 module attached, and connected via (usb-emulated) serial port to a frontend machine
  • for VUsb:
  1. Download and prepare Arduino libraries for the backend
  • clone this repository or download as a package
  • in RF24VUsb, edit Makefile.config and fill configuration parameters accordingly to your VUsb and nRF24l01 setup; execute make afterwards
  • in RF24Serial, edit Makefile.config and fill configuration parameters accordingly to your nRF24l01 connection; execute make afterwards
  • link or copy RF24Remote, RF24VUsb and RF24Serial into Arduino's library directory
  • link or copy RF24 library contained in RF24Remote. This is needed as there are some minor adaptations, not impacting library's core functionality
  • in Arduino GUI, load example for RF24Serial (SerialDevice) or RF24VUsb (VUsbDevice)
  • compile, upload to Adruino
  1. Compile frontend libraries
  • enter RF24Frontend directory
  • make
  • sudo make install
  1. compile & run examples
  • enter RF24Frontend/examples directory
  • make
  • run compiled examples

Usage of RF24Frontend libraries:

  • see example files:
  • instantiate one of RF24Frontend's communication drivers: RF24ComVUsb or RF24ComSerial
RF24ComVUsb rf24_vusbdev;
  • instantiate RF24Frontend, give the communication driver as constructor's param
RF24Frontend radio(rf24_vusbdev);
  • use the RF24Frontend instance in any code where RF24 library is expected (RF24Frontend is inherited from RF24)