GitLab

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

* add printf support to ESP* and arduino-pico cores
* add ESP32/8266 boards to PlatformIO CI

   Arduino CLI seems to have trouble getting the esp* core that
   corresponds to the fqbn prefix

* make other pgm_read_* macros complaint with unified API

Corresponding to #864, this completes compliance with the unified ArduinoCore-API about 

- `pgm_read_word()`
- `pgm_read_byte()`

see https://github.com/arduino/ArduinoCore-API/blob/e26862e453c1234e1c23506d1839bfa68999d911/api/deprecated-avr-comp/avr/pgmspace.h#L102-L103

* add some boards to the Arduino & PIO CI

* run clang-format on changed files


fix param name

* install arduino-pico core in arduino CI

install cpp-linter from PyPI

keep installing AVR, megaAVR, MBED, SAM, & SAMD platforms in addition to arduino-pico

See https://github.com/nRF24/RF24Mesh/pull/210
To allow users to configure the PA level in higher layers of the stack, do not set PA level in radio.begin();.

Calling this macro caused the following error: 'const void*' is not a pointer-to-object type when defined by another library (in this instance ArduinoJSON)

see bblanchon/ArduinoJson/#1790

solves #867

Also amends an outdated comment in the definition.