RF24 Versions Save

OSI Layer 2 driver for nRF24L01 on Arduino & Raspberry Pi/Linux Devices

v1.4.8

7 months ago

What's Changed

Full Changelog: https://github.com/nRF24/RF24/compare/v1.4.7...v1.4.8

v1.4.7

11 months ago

What's Changed

New Contributors

Full Changelog: https://github.com/nRF24/RF24/compare/v1.4.6...v1.4.7

v1.4.6

1 year ago

What's Changed

New Contributors

Full Changelog: https://github.com/nRF24/RF24/compare/v1.4.5...v1.4.6

v1.4.5

1 year ago
  • All single line loops and conditions use curly brackets
  • Moved preprocessor directives about sprintf() to respective arch_configs

Full Changelog: https://github.com/nRF24/RF24/compare/v1.4.4...v1.4.5

v1.4.4

1 year ago
  • Fix data corruption issues #854

EDIT: This did not fix the mentioned issue as intended. Please use v1.4.5 instead

v1.4.3

1 year ago

What's Changed

New Contributors

Full Changelog: https://github.com/nRF24/RF24/compare/v1.4.2...v1.4.3

v1.4.2

2 years ago
  • new Sphinx docs generation (currently hosted on https://rf24.rtfd.io)
  • Update documentation
  • RP2040 support
  • CMake support
  • Example touch-ups
  • add new toggleAllPipes() function (as opposed to individually opening/closing pipes)
  • add new function setRadiation() function (which combines setPALevel() and setDataRate() into 1 SPI transaction)
  • add toggleAllPipes() and setRadiation() to python wrapper
  • improved all CI workflows

Warning for installing from the packaged release assets (.deb or .rpm files below)

If you have previously installed the library from source code using the traditional ./configure; make; sudo make install, then you will need to uninstall it manually to avoid runtime conflicts.

sudo rm /usr/local/lib/librf24.*
sudo rm /usr/local/lib/librf24-bcm.so
sudo rm -r /usr/local/include/RF24

This is because the Linux package manager puts the newly installed library into a /usr/lib and /usr/include folders. Installing from source will put the lib in /usr/local/lib and /usr/local/include folders.

v1.4.1

2 years ago

This release reverts the changes made to SoftSPI implementation in v1.4.0. Also has a slight adjustment of a code snippet in the docs. Thank you @bifferos

v1.4.0

3 years ago

Overloaded begin()

  • new overloaded begin(_SPI*) function for Arduino based platforms (but not Due, ATTiny, LittleWire, or SPI_UART) that allows the user to specify a non-default SPI bus object
    1. /docs/arduino.md has example snippets for
      • NodeMCU (using pins' on-board labels via macros from the ESP8266 Arduino core)
      • ESP32 (generic)
      • Teensy (generic) - though I don't think teensy users need to use the overloaded begin(_SPI*) (as demonstrated in example snippet)
    2. The SPIClass::begin() function must be called before calling RF24::begin() as warned in /docs/arduino.md page and the RF24::begin(_SPI*) function's docs (which also defers to the Arduino support page).
    3. A new macro RF24_SPI_PTR which is only defined when _SPI is used as a datatype (as opposed to the actual SPI object for a platform).
  • new overloaded begin(_cepin, _cspin) to implement feature request from #539. This applies to all supported platforms. This implementation also provides an overloaded c'tor that accepts only the _spi_speed parameter (that still defaults to RF24_SPI_SPEED - so it could essentially be used as an empty c'tor). Note that begin() returns false if CE & CSN pins are never specified (either with c'tor or new overloaded begin(_cepin, _cspin)/begin(_SPI*, _cepin, _cspin) methods). This feature is extended to the python wrapper as well.
  • new additionally overloaded begin(_SPI*, _cepin, _cspin) on Arduino based platforms (but not Due, ATTiny, LittleWire, or SPI_UART) to allow also specifying a SPI bus from feature request #743 when combined with feature request from #539

Patch updates

  • fix releases for PlatformIO (a missing comma prevented v1.3.12 from showing in PlatformIO)
  • abstract docs (main page and all "Related Pages" now live in the docs folder)
  • added fix for mbed platform about printf.h from @TonioChingon in #739
  • added fix for #414 to RF24_config.h concerning ARDUINO_ARCH_SAMD about internally using printf(). This fix is only appicable to the adafruit fork of the ArduinoCore-samd. Original ArduinoCore-samd does not use avr/pgmspace.h and doesn't declare printf() as accessible method from the Serial object(s).
  • Removed useless /utility/Due/R24_arch_config.h file and fixed missing avr/pgmspace.h for Arduino Due (pgmspace was added back into the Due core in 2013).
  • added Arduino Due to the ArduinoCLI workflow. Also introduced a new workflow that uses PlatformIO to test the examples on the Teensy platform (thus the new badge in the README).
  • amended isValid() to check if private members ce_pin & csn_pin are 0xFFFF because it seems it wasn't updated when the c'tor parameters changed their datatype from uint8_t to uint16_t

v1.3.12

3 years ago
  • Fix millis() issues for Linux devices
  • fixed inaccuracies in the new printPrettyDetails() (concerning "Primary Role" and "Auto-ACK" outputs)
  • added C++ style functions to python wrapper instead of relying on python style attributes (concerns payloadSize and channel)
  • setRetries() now properly clamps input values to valid range (not just truncate unused bits)
  • addressed community concerns about backwards compatibility with begin() and enableAckPayload()
  • added STM32 as a supported platform for PlatformIO

Docs changes

  • fix link to littlewire website
  • fix links to datasheets (links' text/src was backwards in only v1.3.11)
  • main page now refers to this GitHub release page for list of changes
  • explicitly indicate that ATTiny2313 is unsupported due to insufficient memory capacity
  • added info about using PA/LNA modules to COMMON_ISSUES.md