diff --git a/_build_opt_8h_source.html b/_build_opt_8h_source.html index 97354a8d..ef4fc97d 100644 --- a/_build_opt_8h_source.html +++ b/_build_opt_8h_source.html @@ -221,449 +221,447 @@ $(document).ready(function(){initNavTree('_build_opt_8h_source.html',''); initRe
133  * RADIOLIB_DEFAULT_SPI - default SPIClass instance to use.
134  * RADIOLIB_NONVOLATILE - macro to place variable into program storage (usually Flash).
135  * RADIOLIB_NONVOLATILE_READ_BYTE - function/macro to read variables saved in program storage (usually Flash).
-
136  * RADIOLIB_TYPE_ALIAS - construct to create an alias for a type, usually vai the `using` keyword.
+
136  * RADIOLIB_TYPE_ALIAS - construct to create an alias for a type, usually via the `using` keyword.
137  * RADIOLIB_TONE_UNSUPPORTED - some platforms do not have tone()/noTone(), which is required for AFSK.
138  *
-
139  * In addition, some platforms may require RadioLib to disable specific drivers (such as ESP8266).
-
140  *
-
141  * Users may also specify their own configuration by uncommenting the RADIOLIB_CUSTOM_ARDUINO,
-
142  * and then specifying all platform parameters in the section below. This will override automatic
-
143  * platform detection.
-
144  */
-
145 
-
146  // uncomment to enable custom platform definition
-
147  //#define RADIOLIB_CUSTOM_ARDUINO
-
148 
-
149 #if defined(RADIOLIB_CUSTOM_ARDUINO)
-
150  // name for your platform
-
151  #define RADIOLIB_PLATFORM "Custom"
-
152 
-
153  // the following must be defined if the Arduino core does not support tone or yield function
-
154  //#define RADIOLIB_TONE_UNSUPPORTED
-
155  //#define RADIOLIB_YIELD_UNSUPPORTED
-
156 
-
157  // in addition, the following macros may be defined if the Arduino core differs from the defaults
-
158  #define RADIOLIB_NC (0xFFFFFFFF)
-
159  #define RADIOLIB_DEFAULT_SPI SPI
-
160  #define RADIOLIB_DEFAULT_SPI_SETTINGS SPISettings(2000000, MSBFIRST, SPI_MODE0)
-
161  #define RADIOLIB_NONVOLATILE PROGMEM
-
162  #define RADIOLIB_NONVOLATILE_READ_BYTE(addr) pgm_read_byte(addr)
-
163  #define RADIOLIB_NONVOLATILE_READ_DWORD(addr) pgm_read_dword(addr)
-
164  #define RADIOLIB_TYPE_ALIAS(type, alias) using alias = type;
-
165 
-
166  // you might also have to define these if the Arduino core has some uncommon pin mode/status types
-
167  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST
-
168  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST
-
169  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST
-
170 
-
171  // some of RadioLib drivers may be excluded, to prevent collisions with platforms (or to speed up build process)
-
172  // the following is a complete list of all possible exclusion macros, uncomment any of them to disable that driver
-
173  // NOTE: Some of the exclusion macros are dependent on each other. For example, it is not possible to exclude RF69
-
174  // while keeping SX1231 (because RF69 is the base class for SX1231). The dependency is always uni-directional,
-
175  // so excluding SX1231 and keeping RF69 is valid.
-
176  //#define RADIOLIB_EXCLUDE_CC1101 (1)
-
177  //#define RADIOLIB_EXCLUDE_NRF24 (1)
-
178  //#define RADIOLIB_EXCLUDE_RF69 (1)
-
179  //#define RADIOLIB_EXCLUDE_SX1231 (1) // dependent on RADIOLIB_EXCLUDE_RF69
-
180  //#define RADIOLIB_EXCLUDE_SI443X (1)
-
181  //#define RADIOLIB_EXCLUDE_RFM2X (1) // dependent on RADIOLIB_EXCLUDE_SI443X
-
182  //#define RADIOLIB_EXCLUDE_SX127X (1)
-
183  //#define RADIOLIB_EXCLUDE_SX126X (1)
-
184  //#define RADIOLIB_EXCLUDE_STM32WLX (1) // dependent on RADIOLIB_EXCLUDE_SX126X
-
185  //#define RADIOLIB_EXCLUDE_SX128X (1)
-
186  //#define RADIOLIB_EXCLUDE_AFSK (1)
-
187  //#define RADIOLIB_EXCLUDE_AX25 (1)
-
188  //#define RADIOLIB_EXCLUDE_HELLSCHREIBER (1)
-
189  //#define RADIOLIB_EXCLUDE_MORSE (1)
-
190  //#define RADIOLIB_EXCLUDE_RTTY (1)
-
191  //#define RADIOLIB_EXCLUDE_SSTV (1)
-
192  //#define RADIOLIB_EXCLUDE_DIRECT_RECEIVE (1)
-
193 
-
194 #elif defined(__AVR__) && !(defined(ARDUINO_AVR_UNO_WIFI_REV2) || defined(ARDUINO_AVR_NANO_EVERY) || defined(ARDUINO_ARCH_MEGAAVR))
-
195  // Arduino AVR boards (except for megaAVR) - Uno, Mega etc.
-
196  #define RADIOLIB_PLATFORM "Arduino AVR"
-
197 
-
198  #if !(defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__) || defined(__AVR_ATmega1284__) || defined(__AVR_ATmega1284P__))
-
199  #define RADIOLIB_LOWEND_PLATFORM
-
200  #endif
-
201 
-
202 #elif defined(ESP8266)
-
203  // ESP8266 boards
-
204  #define RADIOLIB_PLATFORM "ESP8266"
-
205 
-
206 #elif defined(ESP32) || defined(ARDUINO_ARCH_ESP32)
-
207  #define RADIOLIB_ESP32
-
208 
-
209  // ESP32 boards
-
210  #define RADIOLIB_PLATFORM "ESP32"
-
211 
-
212  // ESP32 doesn't support tone(), but it can be emulated via LED control peripheral
-
213  #define RADIOLIB_TONE_UNSUPPORTED
-
214  #define RADIOLIB_TONE_ESP32_CHANNEL (1)
-
215 
-
216 #elif defined(ARDUINO_ARCH_STM32)
-
217  // official STM32 Arduino core (https://github.com/stm32duino/Arduino_Core_STM32)
-
218  #define RADIOLIB_PLATFORM "Arduino STM32 (official)"
-
219 
-
220 #elif defined(SAMD_SERIES)
-
221  // Adafruit SAMD boards (M0 and M4)
-
222  #define RADIOLIB_PLATFORM "Adafruit SAMD"
-
223 
-
224 #elif defined(ARDUINO_ARCH_SAMD)
-
225  // Arduino SAMD (Zero, MKR, etc.)
-
226  #define RADIOLIB_PLATFORM "Arduino SAMD"
-
227  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
-
228  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
-
229  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
-
230 
-
231 #elif defined(__SAM3X8E__)
-
232  // Arduino Due
-
233  #define RADIOLIB_PLATFORM "Arduino Due"
-
234  #define RADIOLIB_TONE_UNSUPPORTED
-
235 
-
236 #elif (defined(NRF52832_XXAA) || defined(NRF52840_XXAA)) && !defined(ARDUINO_ARDUINO_NANO33BLE)
-
237  // Adafruit nRF52 boards
-
238  #define RADIOLIB_PLATFORM "Adafruit nRF52"
-
239 
-
240 #elif defined(ARDUINO_ARC32_TOOLS)
-
241  // Intel Curie
-
242  #define RADIOLIB_PLATFORM "Intel Curie"
-
243 
-
244 #elif defined(ARDUINO_AVR_UNO_WIFI_REV2) || defined(ARDUINO_AVR_NANO_EVERY) || defined(PORTDUINO)
-
245  // Arduino megaAVR boards - Uno Wifi Rev.2, Nano Every
-
246  #define RADIOLIB_PLATFORM "Arduino megaAVR"
-
247  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
-
248  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
-
249  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
-
250 
-
251 #elif defined(ARDUINO_ARCH_APOLLO3)
-
252  // Sparkfun Apollo3 boards
-
253  #define RADIOLIB_PLATFORM "Sparkfun Apollo3"
-
254  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (Arduino_PinMode)
-
255  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
-
256  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
-
257 
-
258 #elif defined(ARDUINO_ARDUINO_NANO33BLE)
-
259  // Arduino Nano 33 BLE
-
260  #define RADIOLIB_PLATFORM "Arduino Nano 33 BLE"
-
261  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
-
262  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
-
263  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
-
264 
-
265  // Arduino mbed OS boards have a really bad tone implementation which will crash after a couple seconds
-
266  #define RADIOLIB_TONE_UNSUPPORTED
-
267  #define RADIOLIB_MBED_TONE_OVERRIDE
-
268 
-
269 #elif defined(ARDUINO_PORTENTA_H7_M7) || defined(ARDUINO_PORTENTA_H7_M4)
-
270  // Arduino Portenta H7
-
271  #define RADIOLIB_PLATFORM "Portenta H7"
-
272  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
-
273  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
-
274  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
-
275 
-
276  // Arduino mbed OS boards have a really bad tone implementation which will crash after a couple seconds
-
277  #define RADIOLIB_TONE_UNSUPPORTED
-
278  #define RADIOLIB_MBED_TONE_OVERRIDE
-
279 
-
280 #elif defined(__STM32F4__) || defined(__STM32F1__)
-
281  // Arduino STM32 core by Roger Clark (https://github.com/rogerclarkmelbourne/Arduino_STM32)
-
282  #define RADIOLIB_PLATFORM "STM32duino (unofficial)"
-
283  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (WiringPinMode)
-
284  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (ExtIntTriggerMode)
-
285 
-
286 #elif defined(ARDUINO_ARCH_MEGAAVR)
-
287  // MegaCoreX by MCUdude (https://github.com/MCUdude/MegaCoreX)
-
288  #define RADIOLIB_PLATFORM "MegaCoreX"
-
289 
-
290 #elif defined(ARDUINO_ARCH_MBED_RP2040)
-
291  // Raspberry Pi Pico (official mbed core)
-
292  #define RADIOLIB_PLATFORM "Raspberry Pi Pico"
-
293  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
-
294  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
-
295  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
-
296 
-
297  // Arduino mbed OS boards have a really bad tone implementation which will crash after a couple seconds
-
298  #define RADIOLIB_TONE_UNSUPPORTED
-
299  #define RADIOLIB_MBED_TONE_OVERRIDE
-
300 
-
301 #elif defined(ARDUINO_ARCH_RP2040)
-
302  // Raspberry Pi Pico (unofficial core)
-
303  #define RADIOLIB_PLATFORM "Raspberry Pi Pico (unofficial)"
-
304  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
-
305  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
-
306  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
-
307 
-
308 #elif defined(__ASR6501__) || defined(ARDUINO_ARCH_ASR650X) || defined(DARDUINO_ARCH_ASR6601)
-
309  // CubeCell
-
310  #define RADIOLIB_PLATFORM "CubeCell"
-
311  #define RADIOLIB_DEFAULT_SPI_SETTINGS SPISettings(1000000, MSBFIRST, SPI_MODE0) // see issue #709
-
312  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PINMODE)
-
313  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (IrqModes)
-
314 
-
315  // CubeCell doesn't seem to define nullptr, let's do something like that now
-
316  #define nullptr NULL
-
317 
-
318  // ... and also defines pinMode() as a macro, which is by far the stupidest thing I have seen on Arduino
-
319  #undef pinMode
-
320 
-
321  // ... and uses an outdated GCC which does not support type aliases
-
322  #define RADIOLIB_TYPE_ALIAS(type, alias) typedef class type alias;
-
323 
-
324  // ... and it also has no tone(). This platform was designed by an idiot.
-
325  #define RADIOLIB_TONE_UNSUPPORTED
-
326 
-
327  // ... AND as the (hopefully) final nail in the coffin, IT F*CKING DEFINES YIELD() AS A MACRO THAT DOES NOTHING!!!
-
328  #define RADIOLIB_YIELD_UNSUPPORTED
-
329  #if defined(yield)
-
330  #undef yield
-
331  #endif
-
332 
-
333 #elif defined(RASPI)
-
334  // RaspiDuino framework (https://github.com/me-no-dev/RasPiArduino)
-
335  #define RADIOLIB_PLATFORM "RasPiArduino"
-
336 
-
337  // let's start off easy - no tone on this platform, that can happen
-
338  #define RADIOLIB_TONE_UNSUPPORTED
-
339 
-
340  // hmm, no yield either - weird on something like Raspberry PI, but sure, we can handle it
-
341  #define RADIOLIB_YIELD_UNSUPPORTED
-
342 
-
343  // aight, getting to the juicy stuff - PGM_P seems missing, that's the first time
-
344  #define PGM_P const char *
-
345 
-
346  // ... and for the grand finale, we have millis() and micros() DEFINED AS MACROS!
-
347  #if defined(millis)
-
348  #undef millis
-
349  inline RadioLibTime_t millis() { return((RadioLibTime_t)(STCV / 1000)); };
-
350  #endif
-
351 
-
352  #if defined(micros)
-
353  #undef micros
-
354  inline RadioLibTime_t micros() { return((RadioLibTime_t)(STCV)); };
-
355  #endif
-
356 
-
357 #elif defined(TEENSYDUINO)
-
358  // Teensy
-
359  #define RADIOLIB_PLATFORM "Teensy"
-
360 
-
361 #elif defined(ARDUINO_ARCH_RENESAS)
-
362  // Arduino Renesas (UNO R4)
-
363  #define RADIOLIB_PLATFORM "Arduino Renesas (UNO R4)"
-
364  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
-
365  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
-
366  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
-
367 
-
368 #else
-
369  // other Arduino platforms not covered by the above list - this may or may not work
-
370  #define RADIOLIB_PLATFORM "Unknown Arduino"
-
371  #define RADIOLIB_UNKNOWN_PLATFORM
+
139  * Users may also specify their own configuration by uncommenting the RADIOLIB_CUSTOM_ARDUINO,
+
140  * and then specifying all platform parameters in the section below. This will override automatic
+
141  * platform detection.
+
142  */
+
143 
+
144  // uncomment to enable custom platform definition
+
145  //#define RADIOLIB_CUSTOM_ARDUINO
+
146 
+
147 #if defined(RADIOLIB_CUSTOM_ARDUINO)
+
148  // name for your platform
+
149  #define RADIOLIB_PLATFORM "Custom"
+
150 
+
151  // the following must be defined if the Arduino core does not support tone or yield function
+
152  //#define RADIOLIB_TONE_UNSUPPORTED
+
153  //#define RADIOLIB_YIELD_UNSUPPORTED
+
154 
+
155  // in addition, the following macros may be defined if the Arduino core differs from the defaults
+
156  #define RADIOLIB_NC (0xFFFFFFFF)
+
157  #define RADIOLIB_DEFAULT_SPI SPI
+
158  #define RADIOLIB_DEFAULT_SPI_SETTINGS SPISettings(2000000, MSBFIRST, SPI_MODE0)
+
159  #define RADIOLIB_NONVOLATILE PROGMEM
+
160  #define RADIOLIB_NONVOLATILE_READ_BYTE(addr) pgm_read_byte(addr)
+
161  #define RADIOLIB_NONVOLATILE_READ_DWORD(addr) pgm_read_dword(addr)
+
162  #define RADIOLIB_TYPE_ALIAS(type, alias) using alias = type;
+
163 
+
164  // you might also have to define these if the Arduino core has some uncommon pin mode/status types
+
165  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST
+
166  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST
+
167  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST
+
168 
+
169  // some of RadioLib drivers may be excluded, to prevent collisions with platforms (or to speed up build process)
+
170  // the following is a complete list of all possible exclusion macros, uncomment any of them to disable that driver
+
171  // NOTE: Some of the exclusion macros are dependent on each other. For example, it is not possible to exclude RF69
+
172  // while keeping SX1231 (because RF69 is the base class for SX1231). The dependency is always uni-directional,
+
173  // so excluding SX1231 and keeping RF69 is valid.
+
174  //#define RADIOLIB_EXCLUDE_CC1101 (1)
+
175  //#define RADIOLIB_EXCLUDE_NRF24 (1)
+
176  //#define RADIOLIB_EXCLUDE_RF69 (1)
+
177  //#define RADIOLIB_EXCLUDE_SX1231 (1) // dependent on RADIOLIB_EXCLUDE_RF69
+
178  //#define RADIOLIB_EXCLUDE_SI443X (1)
+
179  //#define RADIOLIB_EXCLUDE_RFM2X (1) // dependent on RADIOLIB_EXCLUDE_SI443X
+
180  //#define RADIOLIB_EXCLUDE_SX127X (1)
+
181  //#define RADIOLIB_EXCLUDE_SX126X (1)
+
182  //#define RADIOLIB_EXCLUDE_STM32WLX (1) // dependent on RADIOLIB_EXCLUDE_SX126X
+
183  //#define RADIOLIB_EXCLUDE_SX128X (1)
+
184  //#define RADIOLIB_EXCLUDE_AFSK (1)
+
185  //#define RADIOLIB_EXCLUDE_AX25 (1)
+
186  //#define RADIOLIB_EXCLUDE_HELLSCHREIBER (1)
+
187  //#define RADIOLIB_EXCLUDE_MORSE (1)
+
188  //#define RADIOLIB_EXCLUDE_RTTY (1)
+
189  //#define RADIOLIB_EXCLUDE_SSTV (1)
+
190  //#define RADIOLIB_EXCLUDE_DIRECT_RECEIVE (1)
+
191 
+
192 #elif defined(__AVR__) && !(defined(ARDUINO_AVR_UNO_WIFI_REV2) || defined(ARDUINO_AVR_NANO_EVERY) || defined(ARDUINO_ARCH_MEGAAVR))
+
193  // Arduino AVR boards (except for megaAVR) - Uno, Mega etc.
+
194  #define RADIOLIB_PLATFORM "Arduino AVR"
+
195 
+
196  #if !(defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__) || defined(__AVR_ATmega1284__) || defined(__AVR_ATmega1284P__))
+
197  #define RADIOLIB_LOWEND_PLATFORM
+
198  #endif
+
199 
+
200 #elif defined(ESP8266)
+
201  // ESP8266 boards
+
202  #define RADIOLIB_PLATFORM "ESP8266"
+
203 
+
204 #elif defined(ESP32) || defined(ARDUINO_ARCH_ESP32)
+
205  #define RADIOLIB_ESP32
+
206 
+
207  // ESP32 boards
+
208  #define RADIOLIB_PLATFORM "ESP32"
+
209 
+
210  // ESP32 doesn't support tone(), but it can be emulated via LED control peripheral
+
211  #define RADIOLIB_TONE_UNSUPPORTED
+
212  #define RADIOLIB_TONE_ESP32_CHANNEL (1)
+
213 
+
214 #elif defined(ARDUINO_ARCH_STM32)
+
215  // official STM32 Arduino core (https://github.com/stm32duino/Arduino_Core_STM32)
+
216  #define RADIOLIB_PLATFORM "Arduino STM32 (official)"
+
217 
+
218 #elif defined(SAMD_SERIES)
+
219  // Adafruit SAMD boards (M0 and M4)
+
220  #define RADIOLIB_PLATFORM "Adafruit SAMD"
+
221 
+
222 #elif defined(ARDUINO_ARCH_SAMD)
+
223  // Arduino SAMD (Zero, MKR, etc.)
+
224  #define RADIOLIB_PLATFORM "Arduino SAMD"
+
225  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
+
226  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
+
227  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
+
228 
+
229 #elif defined(__SAM3X8E__)
+
230  // Arduino Due
+
231  #define RADIOLIB_PLATFORM "Arduino Due"
+
232  #define RADIOLIB_TONE_UNSUPPORTED
+
233 
+
234 #elif (defined(NRF52832_XXAA) || defined(NRF52840_XXAA)) && !defined(ARDUINO_ARDUINO_NANO33BLE)
+
235  // Adafruit nRF52 boards
+
236  #define RADIOLIB_PLATFORM "Adafruit nRF52"
+
237 
+
238 #elif defined(ARDUINO_ARC32_TOOLS)
+
239  // Intel Curie
+
240  #define RADIOLIB_PLATFORM "Intel Curie"
+
241 
+
242 #elif defined(ARDUINO_AVR_UNO_WIFI_REV2) || defined(ARDUINO_AVR_NANO_EVERY) || defined(PORTDUINO)
+
243  // Arduino megaAVR boards - Uno Wifi Rev.2, Nano Every
+
244  #define RADIOLIB_PLATFORM "Arduino megaAVR"
+
245  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
+
246  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
+
247  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
+
248 
+
249 #elif defined(ARDUINO_ARCH_APOLLO3)
+
250  // Sparkfun Apollo3 boards
+
251  #define RADIOLIB_PLATFORM "Sparkfun Apollo3"
+
252  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (Arduino_PinMode)
+
253  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
+
254  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
+
255 
+
256 #elif defined(ARDUINO_ARDUINO_NANO33BLE)
+
257  // Arduino Nano 33 BLE
+
258  #define RADIOLIB_PLATFORM "Arduino Nano 33 BLE"
+
259  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
+
260  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
+
261  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
+
262 
+
263  // Arduino mbed OS boards have a really bad tone implementation which will crash after a couple seconds
+
264  #define RADIOLIB_TONE_UNSUPPORTED
+
265  #define RADIOLIB_MBED_TONE_OVERRIDE
+
266 
+
267 #elif defined(ARDUINO_PORTENTA_H7_M7) || defined(ARDUINO_PORTENTA_H7_M4)
+
268  // Arduino Portenta H7
+
269  #define RADIOLIB_PLATFORM "Portenta H7"
+
270  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
+
271  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
+
272  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
+
273 
+
274  // Arduino mbed OS boards have a really bad tone implementation which will crash after a couple seconds
+
275  #define RADIOLIB_TONE_UNSUPPORTED
+
276  #define RADIOLIB_MBED_TONE_OVERRIDE
+
277 
+
278 #elif defined(__STM32F4__) || defined(__STM32F1__)
+
279  // Arduino STM32 core by Roger Clark (https://github.com/rogerclarkmelbourne/Arduino_STM32)
+
280  #define RADIOLIB_PLATFORM "STM32duino (unofficial)"
+
281  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (WiringPinMode)
+
282  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (ExtIntTriggerMode)
+
283 
+
284 #elif defined(ARDUINO_ARCH_MEGAAVR)
+
285  // MegaCoreX by MCUdude (https://github.com/MCUdude/MegaCoreX)
+
286  #define RADIOLIB_PLATFORM "MegaCoreX"
+
287 
+
288 #elif defined(ARDUINO_ARCH_MBED_RP2040)
+
289  // Raspberry Pi Pico (official mbed core)
+
290  #define RADIOLIB_PLATFORM "Raspberry Pi Pico"
+
291  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
+
292  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
+
293  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
+
294 
+
295  // Arduino mbed OS boards have a really bad tone implementation which will crash after a couple seconds
+
296  #define RADIOLIB_TONE_UNSUPPORTED
+
297  #define RADIOLIB_MBED_TONE_OVERRIDE
+
298 
+
299 #elif defined(ARDUINO_ARCH_RP2040)
+
300  // Raspberry Pi Pico (unofficial core)
+
301  #define RADIOLIB_PLATFORM "Raspberry Pi Pico (unofficial)"
+
302  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
+
303  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
+
304  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
+
305 
+
306 #elif defined(__ASR6501__) || defined(ARDUINO_ARCH_ASR650X) || defined(DARDUINO_ARCH_ASR6601)
+
307  // CubeCell
+
308  #define RADIOLIB_PLATFORM "CubeCell"
+
309  #define RADIOLIB_DEFAULT_SPI_SETTINGS SPISettings(1000000, MSBFIRST, SPI_MODE0) // see issue #709
+
310  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PINMODE)
+
311  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (IrqModes)
+
312 
+
313  // CubeCell doesn't seem to define nullptr, let's do something like that now
+
314  #define nullptr NULL
+
315 
+
316  // ... and also defines pinMode() as a macro, which is by far the stupidest thing I have seen on Arduino
+
317  #undef pinMode
+
318 
+
319  // ... and uses an outdated GCC which does not support type aliases
+
320  #define RADIOLIB_TYPE_ALIAS(type, alias) typedef class type alias;
+
321 
+
322  // ... and it also has no tone(). This platform was designed by an idiot.
+
323  #define RADIOLIB_TONE_UNSUPPORTED
+
324 
+
325  // ... AND as the (hopefully) final nail in the coffin, IT F*CKING DEFINES YIELD() AS A MACRO THAT DOES NOTHING!!!
+
326  #define RADIOLIB_YIELD_UNSUPPORTED
+
327  #if defined(yield)
+
328  #undef yield
+
329  #endif
+
330 
+
331 #elif defined(RASPI)
+
332  // RaspiDuino framework (https://github.com/me-no-dev/RasPiArduino)
+
333  #define RADIOLIB_PLATFORM "RasPiArduino"
+
334 
+
335  // let's start off easy - no tone on this platform, that can happen
+
336  #define RADIOLIB_TONE_UNSUPPORTED
+
337 
+
338  // hmm, no yield either - weird on something like Raspberry PI, but sure, we can handle it
+
339  #define RADIOLIB_YIELD_UNSUPPORTED
+
340 
+
341  // aight, getting to the juicy stuff - PGM_P seems missing, that's the first time
+
342  #define PGM_P const char *
+
343 
+
344  // ... and for the grand finale, we have millis() and micros() DEFINED AS MACROS!
+
345  #if defined(millis)
+
346  #undef millis
+
347  inline RadioLibTime_t millis() { return((RadioLibTime_t)(STCV / 1000)); };
+
348  #endif
+
349 
+
350  #if defined(micros)
+
351  #undef micros
+
352  inline RadioLibTime_t micros() { return((RadioLibTime_t)(STCV)); };
+
353  #endif
+
354 
+
355 #elif defined(TEENSYDUINO)
+
356  // Teensy
+
357  #define RADIOLIB_PLATFORM "Teensy"
+
358 
+
359 #elif defined(ARDUINO_ARCH_RENESAS)
+
360  // Arduino Renesas (UNO R4)
+
361  #define RADIOLIB_PLATFORM "Arduino Renesas (UNO R4)"
+
362  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
+
363  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
+
364  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
+
365 
+
366 #else
+
367  // other Arduino platforms not covered by the above list - this may or may not work
+
368  #define RADIOLIB_PLATFORM "Unknown Arduino"
+
369  #define RADIOLIB_UNKNOWN_PLATFORM
+
370 
+
371 #endif
372 
-
373 #endif
-
374 
-
375  // set the default values for all macros
-
376  // these will be applied if they were not defined above
-
377  #if !defined(RADIOLIB_NC)
-
378  #define RADIOLIB_NC (0xFFFFFFFF)
-
379  #endif
-
380 
-
381  #if !defined(RADIOLIB_DEFAULT_SPI)
-
382  #define RADIOLIB_DEFAULT_SPI SPI
-
383  #endif
-
384 
-
385  #if !defined(RADIOLIB_DEFAULT_SPI_SETTINGS)
-
386  #define RADIOLIB_DEFAULT_SPI_SETTINGS SPISettings(2000000, MSBFIRST, SPI_MODE0)
-
387  #endif
-
388 
-
389  #if !defined(RADIOLIB_NONVOLATILE)
-
390  #define RADIOLIB_NONVOLATILE PROGMEM
-
391  #endif
-
392 
-
393  #if !defined(RADIOLIB_NONVOLATILE_PTR)
-
394  #define RADIOLIB_NONVOLATILE_PTR PGM_P
-
395  #endif
-
396 
-
397  #if !defined(RADIOLIB_NONVOLATILE_READ_BYTE)
-
398  #define RADIOLIB_NONVOLATILE_READ_BYTE(addr) pgm_read_byte(addr)
-
399  #endif
-
400 
-
401  #if !defined(RADIOLIB_NONVOLATILE_READ_DWORD)
-
402  #define RADIOLIB_NONVOLATILE_READ_DWORD(addr) pgm_read_dword(addr)
-
403  #endif
-
404 
-
405  #if !defined(RADIOLIB_TYPE_ALIAS)
-
406  #define RADIOLIB_TYPE_ALIAS(type, alias) using alias = type;
-
407  #endif
-
408 
-
409  #if !defined(RADIOLIB_ARDUINOHAL_PIN_MODE_CAST)
-
410  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST
-
411  #endif
-
412 
-
413  #if !defined(RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST)
-
414  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST
-
415  #endif
-
416 
-
417  #if !defined(RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST)
-
418  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST
-
419  #endif
-
420 
-
421 #else
-
422  // generic non-Arduino platform
-
423  #define RADIOLIB_PLATFORM "Generic"
-
424 
-
425  #define RADIOLIB_NC (0xFFFFFFFF)
-
426  #define RADIOLIB_NONVOLATILE
-
427  #define RADIOLIB_NONVOLATILE_READ_BYTE(addr) (*((uint8_t *)(void *)(addr)))
-
428  #define RADIOLIB_NONVOLATILE_READ_DWORD(addr) (*((uint32_t *)(void *)(addr)))
-
429  #define RADIOLIB_TYPE_ALIAS(type, alias) using alias = type;
-
430 
-
431  #if !defined(RADIOLIB_DEBUG_PORT)
-
432  #define RADIOLIB_DEBUG_PORT stdout
-
433  #endif
-
434 
-
435  #define DEC 10
-
436  #define HEX 16
-
437  #define OCT 8
-
438  #define BIN 2
+
373  // set the default values for all macros
+
374  // these will be applied if they were not defined above
+
375  #if !defined(RADIOLIB_NC)
+
376  #define RADIOLIB_NC (0xFFFFFFFF)
+
377  #endif
+
378 
+
379  #if !defined(RADIOLIB_DEFAULT_SPI)
+
380  #define RADIOLIB_DEFAULT_SPI SPI
+
381  #endif
+
382 
+
383  #if !defined(RADIOLIB_DEFAULT_SPI_SETTINGS)
+
384  #define RADIOLIB_DEFAULT_SPI_SETTINGS SPISettings(2000000, MSBFIRST, SPI_MODE0)
+
385  #endif
+
386 
+
387  #if !defined(RADIOLIB_NONVOLATILE)
+
388  #define RADIOLIB_NONVOLATILE PROGMEM
+
389  #endif
+
390 
+
391  #if !defined(RADIOLIB_NONVOLATILE_PTR)
+
392  #define RADIOLIB_NONVOLATILE_PTR PGM_P
+
393  #endif
+
394 
+
395  #if !defined(RADIOLIB_NONVOLATILE_READ_BYTE)
+
396  #define RADIOLIB_NONVOLATILE_READ_BYTE(addr) pgm_read_byte(addr)
+
397  #endif
+
398 
+
399  #if !defined(RADIOLIB_NONVOLATILE_READ_DWORD)
+
400  #define RADIOLIB_NONVOLATILE_READ_DWORD(addr) pgm_read_dword(addr)
+
401  #endif
+
402 
+
403  #if !defined(RADIOLIB_TYPE_ALIAS)
+
404  #define RADIOLIB_TYPE_ALIAS(type, alias) using alias = type;
+
405  #endif
+
406 
+
407  #if !defined(RADIOLIB_ARDUINOHAL_PIN_MODE_CAST)
+
408  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST
+
409  #endif
+
410 
+
411  #if !defined(RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST)
+
412  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST
+
413  #endif
+
414 
+
415  #if !defined(RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST)
+
416  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST
+
417  #endif
+
418 
+
419 #else
+
420  // generic non-Arduino platform
+
421  #define RADIOLIB_PLATFORM "Generic"
+
422 
+
423  #define RADIOLIB_NC (0xFFFFFFFF)
+
424  #define RADIOLIB_NONVOLATILE
+
425  #define RADIOLIB_NONVOLATILE_READ_BYTE(addr) (*((uint8_t *)(void *)(addr)))
+
426  #define RADIOLIB_NONVOLATILE_READ_DWORD(addr) (*((uint32_t *)(void *)(addr)))
+
427  #define RADIOLIB_TYPE_ALIAS(type, alias) using alias = type;
+
428 
+
429  #if !defined(RADIOLIB_DEBUG_PORT)
+
430  #define RADIOLIB_DEBUG_PORT stdout
+
431  #endif
+
432 
+
433  #define DEC 10
+
434  #define HEX 16
+
435  #define OCT 8
+
436  #define BIN 2
+
437 
+
438  #include <stdint.h>
439 
-
440  #include <stdint.h>
+
440 #endif
441 
-
442 #endif
-
443 
-
444 // This only compiles on STM32 boards with SUBGHZ module, but also
-
445 // include when generating docs
-
446 #if (!defined(ARDUINO_ARCH_STM32) || !defined(SUBGHZSPI_BASE)) && !defined(DOXYGEN)
-
447  #define RADIOLIB_EXCLUDE_STM32WLX (1)
-
448 #endif
-
449 
-
450 // if verbose assert is enabled, enable basic debug too
-
451 #if RADIOLIB_VERBOSE_ASSERT
-
452  #define RADIOLIB_DEBUG (1)
-
453 #endif
-
454 
-
455 // set the global debug mode flag
-
456 #if RADIOLIB_DEBUG_BASIC || RADIOLIB_DEBUG_PROTOCOL || RADIOLIB_DEBUG_SPI
-
457  #define RADIOLIB_DEBUG (1)
-
458 #else
-
459  #define RADIOLIB_DEBUG (0)
-
460 #endif
-
461 
-
462 #if RADIOLIB_DEBUG
-
463  #if defined(RADIOLIB_BUILD_ARDUINO)
-
464  #define RADIOLIB_DEBUG_PRINT(...) rlb_printf(__VA_ARGS__)
-
465  #define RADIOLIB_DEBUG_PRINTLN(M, ...) rlb_printf(M "\n", ##__VA_ARGS__)
-
466  #define RADIOLIB_DEBUG_PRINT_LVL(LEVEL, M, ...) rlb_printf(LEVEL "" M, ##__VA_ARGS__)
-
467  #define RADIOLIB_DEBUG_PRINTLN_LVL(LEVEL, M, ...) rlb_printf(LEVEL "" M "\n", ##__VA_ARGS__)
-
468 
-
469  // some platforms do not support printf("%f"), so it has to be done this way
-
470  #define RADIOLIB_DEBUG_PRINT_FLOAT(LEVEL, VAL, DECIMALS) RADIOLIB_DEBUG_PRINT(LEVEL); RADIOLIB_DEBUG_PORT.print(VAL, DECIMALS)
-
471  #else
-
472  #if !defined(RADIOLIB_DEBUG_PRINT)
-
473  #define RADIOLIB_DEBUG_PRINT(...) fprintf(RADIOLIB_DEBUG_PORT, __VA_ARGS__)
-
474  #define RADIOLIB_DEBUG_PRINT_LVL(LEVEL, M, ...) fprintf(RADIOLIB_DEBUG_PORT, LEVEL "" M, ##__VA_ARGS__)
-
475  #endif
-
476  #if !defined(RADIOLIB_DEBUG_PRINTLN)
-
477  #define RADIOLIB_DEBUG_PRINTLN(M, ...) fprintf(RADIOLIB_DEBUG_PORT, M "\n", ##__VA_ARGS__)
-
478  #define RADIOLIB_DEBUG_PRINTLN_LVL(LEVEL, M, ...) fprintf(RADIOLIB_DEBUG_PORT, LEVEL "" M "\n", ##__VA_ARGS__)
-
479  #endif
-
480  #define RADIOLIB_DEBUG_PRINT_FLOAT(LEVEL, VAL, DECIMALS) RADIOLIB_DEBUG_PRINT(LEVEL "%.3f", VAL)
-
481  #endif
-
482 
-
483  #define RADIOLIB_DEBUG_HEXDUMP(LEVEL, ...) rlb_hexdump(LEVEL, __VA_ARGS__)
-
484 #else
-
485  #define RADIOLIB_DEBUG_PRINT(...) {}
-
486  #define RADIOLIB_DEBUG_PRINTLN(...) {}
-
487  #define RADIOLIB_DEBUG_PRINT_FLOAT(VAL, DECIMALS) {}
-
488  #define RADIOLIB_DEBUG_HEXDUMP(...) {}
-
489 #endif
-
490 
-
491 #if RADIOLIB_DEBUG_BASIC
-
492  #define RADIOLIB_DEBUG_BASIC_PRINT(...) RADIOLIB_DEBUG_PRINT_LVL("RLB_DBG: ", __VA_ARGS__)
-
493  #define RADIOLIB_DEBUG_BASIC_PRINT_NOTAG(...) RADIOLIB_DEBUG_PRINT_LVL("", __VA_ARGS__)
-
494  #define RADIOLIB_DEBUG_BASIC_PRINTLN(...) RADIOLIB_DEBUG_PRINTLN_LVL("RLB_DBG: ", __VA_ARGS__)
-
495  #define RADIOLIB_DEBUG_BASIC_PRINT_FLOAT(...) RADIOLIB_DEBUG_PRINT_FLOAT("RLB_DBG: ", __VA_ARGS__);
-
496  #define RADIOLIB_DEBUG_BASIC_HEXDUMP(...) RADIOLIB_DEBUG_HEXDUMP("RLB_DBG: ", __VA_ARGS__);
-
497 #else
-
498  #define RADIOLIB_DEBUG_BASIC_PRINT(...) {}
-
499  #define RADIOLIB_DEBUG_BASIC_PRINT_NOTAG(...) {}
-
500  #define RADIOLIB_DEBUG_BASIC_PRINTLN(...) {}
-
501  #define RADIOLIB_DEBUG_BASIC_PRINT_FLOAT(...) {}
-
502  #define RADIOLIB_DEBUG_BASIC_HEXDUMP(...) {}
-
503 #endif
-
504 
-
505 #if RADIOLIB_DEBUG_PROTOCOL
-
506  #define RADIOLIB_DEBUG_PROTOCOL_PRINT(...) RADIOLIB_DEBUG_PRINT_LVL("RLB_PRO: ", __VA_ARGS__)
-
507  #define RADIOLIB_DEBUG_PROTOCOL_PRINTLN(...) RADIOLIB_DEBUG_PRINTLN_LVL("RLB_PRO: ", __VA_ARGS__)
-
508  #define RADIOLIB_DEBUG_PROTOCOL_PRINT_FLOAT(...) RADIOLIB_DEBUG_PRINT_FLOAT("RLB_PRO: ", __VA_ARGS__);
-
509  #define RADIOLIB_DEBUG_PROTOCOL_HEXDUMP(...) RADIOLIB_DEBUG_HEXDUMP("RLB_PRO: ", __VA_ARGS__);
-
510 #else
-
511  #define RADIOLIB_DEBUG_PROTOCOL_PRINT(...) {}
-
512  #define RADIOLIB_DEBUG_PROTOCOL_PRINTLN(...) {}
-
513  #define RADIOLIB_DEBUG_PROTOCOL_PRINT_FLOAT(...) {}
-
514  #define RADIOLIB_DEBUG_PROTOCOL_HEXDUMP(...) {}
-
515 #endif
-
516 
-
517 #if RADIOLIB_DEBUG_SPI
-
518  #define RADIOLIB_DEBUG_SPI_PRINT(...) RADIOLIB_DEBUG_PRINT_LVL("RLB_SPI: ", __VA_ARGS__)
-
519  #define RADIOLIB_DEBUG_SPI_PRINT_NOTAG(...) RADIOLIB_DEBUG_PRINT_LVL("", __VA_ARGS__)
-
520  #define RADIOLIB_DEBUG_SPI_PRINTLN(...) RADIOLIB_DEBUG_PRINTLN_LVL("RLB_SPI: ", __VA_ARGS__)
-
521  #define RADIOLIB_DEBUG_SPI_PRINTLN_NOTAG(...) RADIOLIB_DEBUG_PRINTLN_LVL("", __VA_ARGS__)
-
522  #define RADIOLIB_DEBUG_SPI_PRINT_FLOAT(...) RADIOLIB_DEBUG_PRINT_FLOAT("RLB_SPI: ", __VA_ARGS__);
-
523  #define RADIOLIB_DEBUG_SPI_HEXDUMP(...) RADIOLIB_DEBUG_HEXDUMP("RLB_SPI: ", __VA_ARGS__);
-
524 #else
-
525  #define RADIOLIB_DEBUG_SPI_PRINT(...) {}
-
526  #define RADIOLIB_DEBUG_SPI_PRINT_NOTAG(...) {}
-
527  #define RADIOLIB_DEBUG_SPI_PRINTLN(...) {}
-
528  #define RADIOLIB_DEBUG_SPI_PRINTLN_NOTAG(...) {}
-
529  #define RADIOLIB_DEBUG_SPI_PRINT_FLOAT(...) {}
-
530  #define RADIOLIB_DEBUG_SPI_HEXDUMP(...) {}
-
531 #endif
-
532 
-
533 // debug info strings
-
534 #define RADIOLIB_VALUE_TO_STRING(x) #x
-
535 #define RADIOLIB_VALUE(x) RADIOLIB_VALUE_TO_STRING(x)
-
536 
-
537 #define RADIOLIB_INFO "\nRadioLib Info\nVersion: \"" \
-
538  RADIOLIB_VALUE(RADIOLIB_VERSION_MAJOR) "." \
-
539  RADIOLIB_VALUE(RADIOLIB_VERSION_MINOR) "." \
-
540  RADIOLIB_VALUE(RADIOLIB_VERSION_PATCH) "." \
-
541  RADIOLIB_VALUE(RADIOLIB_VERSION_EXTRA) "\"\n" \
-
542  "Platform: " RADIOLIB_VALUE(RADIOLIB_PLATFORM) "\n" \
-
543  "Compiled: " RADIOLIB_VALUE(__DATE__) " " RADIOLIB_VALUE(__TIME__)
-
544 
-
550 #if RADIOLIB_VERBOSE_ASSERT
-
551 #define RADIOLIB_ASSERT(STATEVAR) { if((STATEVAR) != RADIOLIB_ERR_NONE) { RADIOLIB_DEBUG_BASIC_PRINTLN("%d at %s:%d", STATEVAR, __FILE__, __LINE__); return(STATEVAR); } }
-
552 #define RADIOLIB_ASSERT_PTR(PTR) { if((PTR) == NULL) { RADIOLIB_DEBUG_BASIC_PRINTLN("NULL at %s:%d", __FILE__, __LINE__); return(RADIOLIB_ERR_MEMORY_ALLOCATION_FAILED); } }
-
553 #else
-
554 #define RADIOLIB_ASSERT(STATEVAR) { if((STATEVAR) != RADIOLIB_ERR_NONE) { return(STATEVAR); } }
-
555 #define RADIOLIB_ASSERT_PTR(PTR) { if((PTR) == NULL) { return(RADIOLIB_ERR_MEMORY_ALLOCATION_FAILED); } }
-
556 #endif
-
557 
-
561 #if RADIOLIB_CHECK_PARAMS
-
562  #define RADIOLIB_CHECK_RANGE(VAR, MIN, MAX, ERR) { if(!(((VAR) >= (MIN)) && ((VAR) <= (MAX)))) { return(ERR); } }
-
563 #else
-
564  #define RADIOLIB_CHECK_RANGE(VAR, MIN, MAX, ERR) {}
-
565 #endif
-
566 
-
567 #if RADIOLIB_FIX_ERRATA_SX127X
-
568  #define RADIOLIB_ERRATA_SX127X(...) { errataFix(__VA_ARGS__); }
-
569 #else
-
570  #define RADIOLIB_ERRATA_SX127X(...) {}
-
571 #endif
-
572 
-
573 // these macros are usually defined by Arduino, but some platforms undef them, so its safer to use our own
-
574 #define RADIOLIB_MIN(a,b) ((a)<(b)?(a):(b))
-
575 #define RADIOLIB_MAX(a,b) ((a)>(b)?(a):(b))
-
576 #define RADIOLIB_ABS(x) ((x)>0?(x):-(x))
-
577 
-
578 // version definitions
-
579 #define RADIOLIB_VERSION_MAJOR 7
-
580 #define RADIOLIB_VERSION_MINOR 1
-
581 #define RADIOLIB_VERSION_PATCH 0
-
582 #define RADIOLIB_VERSION_EXTRA 0
+
442 // This only compiles on STM32 boards with SUBGHZ module, but also
+
443 // include when generating docs
+
444 #if (!defined(ARDUINO_ARCH_STM32) || !defined(SUBGHZSPI_BASE)) && !defined(DOXYGEN)
+
445  #define RADIOLIB_EXCLUDE_STM32WLX (1)
+
446 #endif
+
447 
+
448 // if verbose assert is enabled, enable basic debug too
+
449 #if RADIOLIB_VERBOSE_ASSERT
+
450  #define RADIOLIB_DEBUG (1)
+
451 #endif
+
452 
+
453 // set the global debug mode flag
+
454 #if RADIOLIB_DEBUG_BASIC || RADIOLIB_DEBUG_PROTOCOL || RADIOLIB_DEBUG_SPI
+
455  #define RADIOLIB_DEBUG (1)
+
456 #else
+
457  #define RADIOLIB_DEBUG (0)
+
458 #endif
+
459 
+
460 #if RADIOLIB_DEBUG
+
461  #if defined(RADIOLIB_BUILD_ARDUINO)
+
462  #define RADIOLIB_DEBUG_PRINT(...) rlb_printf(__VA_ARGS__)
+
463  #define RADIOLIB_DEBUG_PRINTLN(M, ...) rlb_printf(M "\n", ##__VA_ARGS__)
+
464  #define RADIOLIB_DEBUG_PRINT_LVL(LEVEL, M, ...) rlb_printf(LEVEL "" M, ##__VA_ARGS__)
+
465  #define RADIOLIB_DEBUG_PRINTLN_LVL(LEVEL, M, ...) rlb_printf(LEVEL "" M "\n", ##__VA_ARGS__)
+
466 
+
467  // some platforms do not support printf("%f"), so it has to be done this way
+
468  #define RADIOLIB_DEBUG_PRINT_FLOAT(LEVEL, VAL, DECIMALS) RADIOLIB_DEBUG_PRINT(LEVEL); RADIOLIB_DEBUG_PORT.print(VAL, DECIMALS)
+
469  #else
+
470  #if !defined(RADIOLIB_DEBUG_PRINT)
+
471  #define RADIOLIB_DEBUG_PRINT(...) fprintf(RADIOLIB_DEBUG_PORT, __VA_ARGS__)
+
472  #define RADIOLIB_DEBUG_PRINT_LVL(LEVEL, M, ...) fprintf(RADIOLIB_DEBUG_PORT, LEVEL "" M, ##__VA_ARGS__)
+
473  #endif
+
474  #if !defined(RADIOLIB_DEBUG_PRINTLN)
+
475  #define RADIOLIB_DEBUG_PRINTLN(M, ...) fprintf(RADIOLIB_DEBUG_PORT, M "\n", ##__VA_ARGS__)
+
476  #define RADIOLIB_DEBUG_PRINTLN_LVL(LEVEL, M, ...) fprintf(RADIOLIB_DEBUG_PORT, LEVEL "" M "\n", ##__VA_ARGS__)
+
477  #endif
+
478  #define RADIOLIB_DEBUG_PRINT_FLOAT(LEVEL, VAL, DECIMALS) RADIOLIB_DEBUG_PRINT(LEVEL "%.3f", VAL)
+
479  #endif
+
480 
+
481  #define RADIOLIB_DEBUG_HEXDUMP(LEVEL, ...) rlb_hexdump(LEVEL, __VA_ARGS__)
+
482 #else
+
483  #define RADIOLIB_DEBUG_PRINT(...) {}
+
484  #define RADIOLIB_DEBUG_PRINTLN(...) {}
+
485  #define RADIOLIB_DEBUG_PRINT_FLOAT(VAL, DECIMALS) {}
+
486  #define RADIOLIB_DEBUG_HEXDUMP(...) {}
+
487 #endif
+
488 
+
489 #if RADIOLIB_DEBUG_BASIC
+
490  #define RADIOLIB_DEBUG_BASIC_PRINT(...) RADIOLIB_DEBUG_PRINT_LVL("RLB_DBG: ", __VA_ARGS__)
+
491  #define RADIOLIB_DEBUG_BASIC_PRINT_NOTAG(...) RADIOLIB_DEBUG_PRINT_LVL("", __VA_ARGS__)
+
492  #define RADIOLIB_DEBUG_BASIC_PRINTLN(...) RADIOLIB_DEBUG_PRINTLN_LVL("RLB_DBG: ", __VA_ARGS__)
+
493  #define RADIOLIB_DEBUG_BASIC_PRINT_FLOAT(...) RADIOLIB_DEBUG_PRINT_FLOAT("RLB_DBG: ", __VA_ARGS__);
+
494  #define RADIOLIB_DEBUG_BASIC_HEXDUMP(...) RADIOLIB_DEBUG_HEXDUMP("RLB_DBG: ", __VA_ARGS__);
+
495 #else
+
496  #define RADIOLIB_DEBUG_BASIC_PRINT(...) {}
+
497  #define RADIOLIB_DEBUG_BASIC_PRINT_NOTAG(...) {}
+
498  #define RADIOLIB_DEBUG_BASIC_PRINTLN(...) {}
+
499  #define RADIOLIB_DEBUG_BASIC_PRINT_FLOAT(...) {}
+
500  #define RADIOLIB_DEBUG_BASIC_HEXDUMP(...) {}
+
501 #endif
+
502 
+
503 #if RADIOLIB_DEBUG_PROTOCOL
+
504  #define RADIOLIB_DEBUG_PROTOCOL_PRINT(...) RADIOLIB_DEBUG_PRINT_LVL("RLB_PRO: ", __VA_ARGS__)
+
505  #define RADIOLIB_DEBUG_PROTOCOL_PRINTLN(...) RADIOLIB_DEBUG_PRINTLN_LVL("RLB_PRO: ", __VA_ARGS__)
+
506  #define RADIOLIB_DEBUG_PROTOCOL_PRINT_FLOAT(...) RADIOLIB_DEBUG_PRINT_FLOAT("RLB_PRO: ", __VA_ARGS__);
+
507  #define RADIOLIB_DEBUG_PROTOCOL_HEXDUMP(...) RADIOLIB_DEBUG_HEXDUMP("RLB_PRO: ", __VA_ARGS__);
+
508 #else
+
509  #define RADIOLIB_DEBUG_PROTOCOL_PRINT(...) {}
+
510  #define RADIOLIB_DEBUG_PROTOCOL_PRINTLN(...) {}
+
511  #define RADIOLIB_DEBUG_PROTOCOL_PRINT_FLOAT(...) {}
+
512  #define RADIOLIB_DEBUG_PROTOCOL_HEXDUMP(...) {}
+
513 #endif
+
514 
+
515 #if RADIOLIB_DEBUG_SPI
+
516  #define RADIOLIB_DEBUG_SPI_PRINT(...) RADIOLIB_DEBUG_PRINT_LVL("RLB_SPI: ", __VA_ARGS__)
+
517  #define RADIOLIB_DEBUG_SPI_PRINT_NOTAG(...) RADIOLIB_DEBUG_PRINT_LVL("", __VA_ARGS__)
+
518  #define RADIOLIB_DEBUG_SPI_PRINTLN(...) RADIOLIB_DEBUG_PRINTLN_LVL("RLB_SPI: ", __VA_ARGS__)
+
519  #define RADIOLIB_DEBUG_SPI_PRINTLN_NOTAG(...) RADIOLIB_DEBUG_PRINTLN_LVL("", __VA_ARGS__)
+
520  #define RADIOLIB_DEBUG_SPI_PRINT_FLOAT(...) RADIOLIB_DEBUG_PRINT_FLOAT("RLB_SPI: ", __VA_ARGS__);
+
521  #define RADIOLIB_DEBUG_SPI_HEXDUMP(...) RADIOLIB_DEBUG_HEXDUMP("RLB_SPI: ", __VA_ARGS__);
+
522 #else
+
523  #define RADIOLIB_DEBUG_SPI_PRINT(...) {}
+
524  #define RADIOLIB_DEBUG_SPI_PRINT_NOTAG(...) {}
+
525  #define RADIOLIB_DEBUG_SPI_PRINTLN(...) {}
+
526  #define RADIOLIB_DEBUG_SPI_PRINTLN_NOTAG(...) {}
+
527  #define RADIOLIB_DEBUG_SPI_PRINT_FLOAT(...) {}
+
528  #define RADIOLIB_DEBUG_SPI_HEXDUMP(...) {}
+
529 #endif
+
530 
+
531 // debug info strings
+
532 #define RADIOLIB_VALUE_TO_STRING(x) #x
+
533 #define RADIOLIB_VALUE(x) RADIOLIB_VALUE_TO_STRING(x)
+
534 
+
535 #define RADIOLIB_INFO "\nRadioLib Info\nVersion: \"" \
+
536  RADIOLIB_VALUE(RADIOLIB_VERSION_MAJOR) "." \
+
537  RADIOLIB_VALUE(RADIOLIB_VERSION_MINOR) "." \
+
538  RADIOLIB_VALUE(RADIOLIB_VERSION_PATCH) "." \
+
539  RADIOLIB_VALUE(RADIOLIB_VERSION_EXTRA) "\"\n" \
+
540  "Platform: " RADIOLIB_VALUE(RADIOLIB_PLATFORM) "\n" \
+
541  "Compiled: " RADIOLIB_VALUE(__DATE__) " " RADIOLIB_VALUE(__TIME__)
+
542 
+
548 #if RADIOLIB_VERBOSE_ASSERT
+
549 #define RADIOLIB_ASSERT(STATEVAR) { if((STATEVAR) != RADIOLIB_ERR_NONE) { RADIOLIB_DEBUG_BASIC_PRINTLN("%d at %s:%d", STATEVAR, __FILE__, __LINE__); return(STATEVAR); } }
+
550 #define RADIOLIB_ASSERT_PTR(PTR) { if((PTR) == NULL) { RADIOLIB_DEBUG_BASIC_PRINTLN("NULL at %s:%d", __FILE__, __LINE__); return(RADIOLIB_ERR_MEMORY_ALLOCATION_FAILED); } }
+
551 #else
+
552 #define RADIOLIB_ASSERT(STATEVAR) { if((STATEVAR) != RADIOLIB_ERR_NONE) { return(STATEVAR); } }
+
553 #define RADIOLIB_ASSERT_PTR(PTR) { if((PTR) == NULL) { return(RADIOLIB_ERR_MEMORY_ALLOCATION_FAILED); } }
+
554 #endif
+
555 
+
559 #if RADIOLIB_CHECK_PARAMS
+
560  #define RADIOLIB_CHECK_RANGE(VAR, MIN, MAX, ERR) { if(!(((VAR) >= (MIN)) && ((VAR) <= (MAX)))) { return(ERR); } }
+
561 #else
+
562  #define RADIOLIB_CHECK_RANGE(VAR, MIN, MAX, ERR) {}
+
563 #endif
+
564 
+
565 #if RADIOLIB_FIX_ERRATA_SX127X
+
566  #define RADIOLIB_ERRATA_SX127X(...) { errataFix(__VA_ARGS__); }
+
567 #else
+
568  #define RADIOLIB_ERRATA_SX127X(...) {}
+
569 #endif
+
570 
+
571 // these macros are usually defined by Arduino, but some platforms undef them, so its safer to use our own
+
572 #define RADIOLIB_MIN(a,b) ((a)<(b)?(a):(b))
+
573 #define RADIOLIB_MAX(a,b) ((a)>(b)?(a):(b))
+
574 #define RADIOLIB_ABS(x) ((x)>0?(x):-(x))
+
575 
+
576 // version definitions
+
577 #define RADIOLIB_VERSION_MAJOR 7
+
578 #define RADIOLIB_VERSION_MINOR 1
+
579 #define RADIOLIB_VERSION_PATCH 0
+
580 #define RADIOLIB_VERSION_EXTRA 0
+
581 
+
582 #define RADIOLIB_VERSION (((RADIOLIB_VERSION_MAJOR) << 24) | ((RADIOLIB_VERSION_MINOR) << 16) | ((RADIOLIB_VERSION_PATCH) << 8) | (RADIOLIB_VERSION_EXTRA))
583 
-
584 #define RADIOLIB_VERSION (((RADIOLIB_VERSION_MAJOR) << 24) | ((RADIOLIB_VERSION_MINOR) << 16) | ((RADIOLIB_VERSION_PATCH) << 8) | (RADIOLIB_VERSION_EXTRA))
-
585 
-
586 #endif
+
584 #endif
RadioLibTime_t
unsigned long RadioLibTime_t
Type used for durations in RadioLib.
Definition: TypeDef.h:642