GitLab

in preparation for #971

- affects CMake and configure scripts
- adds warnings to docs with reference to #971
- removes docs' note about pigpio needed for IRQ support
- fix cross-links in docs (probably a doxygen v1.10.0 difference)

* set doxygen favicon
* don't override user input about RF24_DRIVER in cmake
  when not using an env var to set RF24_DRIVER

* use async variants of BCM2835 lib's edge detection features
* use a private object that destructs cache entries on app exit.
* don't arbitrarily link example binaries to pigpio

I also removed MRAA exclusion from examples build. Previously, interruptConfigure.cpp was not built for MRAA driver.

* update example's IRQ_PIN value
* don't arbitrarily link example binaries to pigpio
* improve MRAA exception messages

- expose selected `RF24_DRIVER` in the python wrapper (for programmatically specifying the right pins)
- update for the python examples
   - interrupt_configure.py usees gpiod instead of RPi.GPIO
   - removed argparse from examples for simplicity
   - use the appropriate pin numbers for the selected `RF24_DRIVER`
- revised the python wrapper's install doc

resolves #965

- Recently added some changes to the RF24G lib to support nrf52x devices, and up to 7 devices in a 'true mesh' configuration where every device has a path to every other device.

in accordance with nRF24/pyRF24#48

This will prevent falling back to `/dev/gpiochip0` when `/dev/gpiochipX` was previously opened successfully.

This is designed to alert users when multiple processes are simultaneously using `/dev/gpiochipX`, but it should only happen if either
1. another process is spamming/hogging the gpiochipX.
2. the rare occurrence when RF24 needs to open gpiochipX while it is still used by another process.

* use pthread with Linux kernel's char-dev API
* [example] change IRQ_PIN number
* Add timeout to interrupt example
* read() kernel event buffer and track event sequence number
* code cleanup (in all Linux driver files)
* switch RPi driver to char-dev IRQ
* wrap wiringPiIsr() into attachInterrupt()
* adjust build systems to not rely on pigpio for IRQ support
* use IRQException instead of GPIOException
* make defined RF24_LINUX_GPIO_CHIP more agnostic of selected driver (applied to RPi and SPIDEV drivers)
* fix compiling wiringPi with examples using old makefile
* add C linkage instead of declaring extern functions
* reviewed wiringPi/spi wrapper
* move gpiochipX init out of cache c'tors
* add wiringPi pin number for CE_PIN to linux examples

---------
Co-authored-by: TMRh20 <tmrh20@gmail.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* update GPIO char dev ABI to v2
* show detailed exception msgs
* cache gpio pins in use
* allow user to select different /dev/gpiochipX
* close GPIO chip FD when not being used.

* adjust scanner examples as discussed in #852
* add new curses python scanner
* replace scanner.py w/ curses implementation
* update pico scanner example
* update arduino scanner

* introducing an Arduino scannerGraphic example
   - supports 2 types of displays (& optional Serial debugginng)

   1. SPI display (uses same bus as radio) is tested with an ST7789 (https://www.adafruit.com/product/4383)
   2. I2C display is tested with SSd1306 (https://www.adafruit.com/product/326)

   Use defines to toggle debugging and EITHER (not both) of the displays.
* [Arduino scanner] ensure radio is not stuck with CONT_WAVE flag asserted after MCU reset

---------
Co-authored-by: TMRh20 <tmrh20@gmail.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

- Point to new CMake installer by default
- Mark old installer deprecated

- per @2bndy5 in #950

#949
- Add delay to relax how often available() is called to let the radio internally do its thing
* Update examples/ManualAcknowledgements/ManualAcknowledgements.ino
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* Update MRAA timer functions
- Found MRAA timer functions not working properly
- Copy timing functions from SPIDEV
* Change / to % in micros function
* Corrects timing problems with SPIDEV and MRAA drivers

- Add link and info for nrf_to_nrf
- Modify datasheet link to just one link

* Update MRAA timer functions

- Found MRAA timer functions not working properly
- Copy timing functions from SPIDEV

* Docs: testRPD
- Update the example code and return info for testRPD()
#946
* Docs: Tweak info output for testRPD()
---------
Co-authored-by: Brendan <2bndy5@gmail.com>

* Update COMMON_ISSUES re: write() functions

- Update comment regarding troubleshooting and CE Pin
- Add info on the different write() functions

#816 #877

* Formatting & IRQ info

* Docs: Add info on byte alignment/packing mismatches

#847
---------
Co-authored-by: Brendan <2bndy5@gmail.com>

* Update utility/SPIDEV/gpio.cpp for RPi5 etc

* Add error handling for GPIO in SPIDEV

- Use gpiochip4 then 0 if that fails to support RPi5

- Remove old GPIO code

* Formatting

* remove unnecessary includes

* Resolve compiler warnings

* Make read() return value

* Revert renaming of gpio functions

* Move int fd to gpio::open() function

* ensure we are calling ::close() instead of GPIO::close()

https://github.com/nRF24/RF24/issues/932

---------
Co-authored-by: Brendan <2bndy5@gmail.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Bumps [actions/checkout](https://github.com/actions/checkout) from 3 to 4.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v3...v4)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-type: direct:production
  update-type: version-update:semver-major
...
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* satisfy nRF24/.github#9
* ran clang-format
* use a separate workflow to check code format
* disable ATTinyCore in Arduino CI
  currently too much headache from upstream problems (namely in Arduino CLI tool)
* reduce duplicate CI triggers
* add dependabot to update CI dependencies

* fix #913

Essentially, this reverts the algorithm used to satisfy #650 as it has proved erroneous on fast MCUs.

See https://github.com/TMRh20/nrf_to_nrf/issues/8

* typedef gpio pin numbers

* adjust docs for new datatype def

* reformat RF24.h; add missing semicolons

includes a follow up from
https://github.com/nRF24/RF24/commit/557d165c12e72329b7573b380eb1e7f132cfbfe6
in which a useless RF24::spi member was declared for RP2040 platform.

* add RF24_PIN_INVALID macro

This will fix RF24::isValid() and
prevents overflow from using the old 0xFFFF value in the RF24 overloaded c'tor that accepts no args.

It also helps to avoid "magic numbers" as was previously used.

* replace magic numbers to c'tor in examples

* avoid max pin val conflicting w/ RF24_PIN_INVALID

resolves #903

references to solutions in #892 and #899

a regression from #892 about
using the default instance of the SPI wrapping class for PicoSDK

* Removed 'static' keywords in SPI.h such that multiple SPI busses can be used to connect multiple Radios. Also added an example for this use-case
Co-authored-by: Brendan <2bndy5@gmail.com>

* minor docs tweaks
  - show Table of Contents in Doxygen's Main/Related Pages
  - update sphinx customized CSS and conf.py
* update doxygen config (requires v1.9.5+)
* move docs-related files into docs folder
* make all CI reusable workflow callers