RadioLib
Universal wireless communication library for Arduino
BuildOpt.h
1 #if !defined(_RADIOLIB_BUILD_OPTIONS_H)
2 #define _RADIOLIB_BUILD_OPTIONS_H
3 
4 #if ARDUINO >= 100
5  // Arduino build
6  #include "Arduino.h"
7  #define RADIOLIB_BUILD_ARDUINO
8 #else
9  // generic build
10  #include <stdio.h>
11  #define RADIOLIB_BUILD_GENERIC
12 #endif
13 
14 #if defined(RADIOLIB_BUILD_ARDUINO)
15 /*
16  * Platform-specific configuration.
17  *
18  * RADIOLIB_PLATFORM - platform name, used in debugging to quickly check the correct platform is detected.
19  * RADIOLIB_NC - alias for unused pin, usually the largest possible value of uint8_t.
20  * RADIOLIB_DEFAULT_SPI - default SPIClass instance to use.
21  * RADIOLIB_NONVOLATILE - macro to place variable into program storage (usually Flash).
22  * RADIOLIB_NONVOLATILE_READ_BYTE - function/macro to read variables saved in program storage (usually Flash).
23  * RADIOLIB_TYPE_ALIAS - construct to create an alias for a type, usually vai the `using` keyword.
24  * RADIOLIB_TONE_UNSUPPORTED - some platforms do not have tone()/noTone(), which is required for AFSK.
25  * RADIOLIB_BUILTIN_MODULE - some platforms have a builtin radio module on fixed pins, this macro is used to specify that pinout.
26  *
27  * In addition, some platforms may require RadioLib to disable specific drivers (such as ESP8266).
28  *
29  * Users may also specify their own configuration by uncommenting the RADIOLIB_CUSTOM_ARDUINO,
30  * and then specifying all platform parameters in the section below. This will override automatic
31  * platform detection.
32  */
33 
34  // uncomment to enable custom platform definition
35  //#define RADIOLIB_CUSTOM_ARDUINO
36 
37 #if defined(RADIOLIB_CUSTOM_ARDUINO)
38  // name for your platform
39  #define RADIOLIB_PLATFORM "Custom"
40 
41  // the following must be defined if the Arduino core does not support tone or yield function
42  //#define RADIOLIB_TONE_UNSUPPORTED
43  //#define RADIOLIB_YIELD_UNSUPPORTED
44 
45  // in addition, the following macros may be defined if the Arduino core differs from the defaults
46  #define RADIOLIB_NC (0xFFFFFFFF)
47  #define RADIOLIB_DEFAULT_SPI SPI
48  #define RADIOLIB_DEFAULT_SPI_SETTINGS SPISettings(2000000, MSBFIRST, SPI_MODE0)
49  #define RADIOLIB_NONVOLATILE PROGMEM
50  #define RADIOLIB_NONVOLATILE_READ_BYTE(addr) pgm_read_byte(addr)
51  #define RADIOLIB_NONVOLATILE_READ_DWORD(addr) pgm_read_dword(addr)
52  #define RADIOLIB_TYPE_ALIAS(type, alias) using alias = type;
53 
54  // you might also have to define these if the Arduino core has some uncommon pin mode/status types
55  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST
56  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST
57  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST
58 
59  // some of RadioLib drivers may be excluded, to prevent collisions with platforms (or to speed up build process)
60  // the following is a complete list of all possible exclusion macros, uncomment any of them to disable that driver
61  // NOTE: Some of the exclusion macros are dependent on each other. For example, it is not possible to exclude RF69
62  // while keeping SX1231 (because RF69 is the base class for SX1231). The dependency is always uni-directional,
63  // so excluding SX1231 and keeping RF69 is valid.
64  //#define RADIOLIB_EXCLUDE_CC1101
65  //#define RADIOLIB_EXCLUDE_NRF24
66  //#define RADIOLIB_EXCLUDE_RF69
67  //#define RADIOLIB_EXCLUDE_SX1231 // dependent on RADIOLIB_EXCLUDE_RF69
68  //#define RADIOLIB_EXCLUDE_SI443X
69  //#define RADIOLIB_EXCLUDE_RFM2X // dependent on RADIOLIB_EXCLUDE_SI443X
70  //#define RADIOLIB_EXCLUDE_SX127X
71  //#define RADIOLIB_EXCLUDE_SX126X
72  //#define RADIOLIB_EXCLUDE_STM32WLX // dependent on RADIOLIB_EXCLUDE_SX126X
73  //#define RADIOLIB_EXCLUDE_SX128X
74  //#define RADIOLIB_EXCLUDE_AFSK
75  //#define RADIOLIB_EXCLUDE_AX25
76  //#define RADIOLIB_EXCLUDE_HELLSCHREIBER
77  //#define RADIOLIB_EXCLUDE_MORSE
78  //#define RADIOLIB_EXCLUDE_RTTY
79  //#define RADIOLIB_EXCLUDE_SSTV
80  //#define RADIOLIB_EXCLUDE_DIRECT_RECEIVE
81 
82 #elif defined(__AVR__) && !(defined(ARDUINO_AVR_UNO_WIFI_REV2) || defined(ARDUINO_AVR_NANO_EVERY) || defined(ARDUINO_ARCH_MEGAAVR))
83  // Arduino AVR boards (except for megaAVR) - Uno, Mega etc.
84  #define RADIOLIB_PLATFORM "Arduino AVR"
85 
86  #if !(defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__) || defined(__AVR_ATmega1284__) || defined(__AVR_ATmega1284P__))
87  #define RADIOLIB_LOWEND_PLATFORM
88  #endif
89 
90 #elif defined(ESP8266)
91  // ESP8266 boards
92  #define RADIOLIB_PLATFORM "ESP8266"
93 
94 #elif defined(ESP32) || defined(ARDUINO_ARCH_ESP32)
95  #define RADIOLIB_ESP32
96 
97  // ESP32 boards
98  #define RADIOLIB_PLATFORM "ESP32"
99 
100  // ESP32 doesn't support tone(), but it can be emulated via LED control peripheral
101  #define RADIOLIB_TONE_UNSUPPORTED
102  #define RADIOLIB_TONE_ESP32_CHANNEL (1)
103 
104 #elif defined(ARDUINO_ARCH_STM32)
105  // official STM32 Arduino core (https://github.com/stm32duino/Arduino_Core_STM32)
106  #define RADIOLIB_PLATFORM "Arduino STM32 (official)"
107 
108 #elif defined(SAMD_SERIES)
109  // Adafruit SAMD boards (M0 and M4)
110  #define RADIOLIB_PLATFORM "Adafruit SAMD"
111  #define RADIOLIB_EEPROM_UNSUPPORTED
112 
113 #elif defined(ARDUINO_ARCH_SAMD)
114  // Arduino SAMD (Zero, MKR, etc.)
115  #define RADIOLIB_PLATFORM "Arduino SAMD"
116  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
117  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
118  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
119  #define RADIOLIB_EEPROM_UNSUPPORTED
120 
121 #elif defined(__SAM3X8E__)
122  // Arduino Due
123  #define RADIOLIB_PLATFORM "Arduino Due"
124  #define RADIOLIB_TONE_UNSUPPORTED
125  #define RADIOLIB_EEPROM_UNSUPPORTED
126 
127 #elif (defined(NRF52832_XXAA) || defined(NRF52840_XXAA)) && !defined(ARDUINO_ARDUINO_NANO33BLE)
128  // Adafruit nRF52 boards
129  #define RADIOLIB_PLATFORM "Adafruit nRF52"
130  #define RADIOLIB_EEPROM_UNSUPPORTED
131 
132 #elif defined(ARDUINO_ARC32_TOOLS)
133  // Intel Curie
134  #define RADIOLIB_PLATFORM "Intel Curie"
135 
136 #elif defined(ARDUINO_AVR_UNO_WIFI_REV2) || defined(ARDUINO_AVR_NANO_EVERY) || defined(PORTDUINO)
137  // Arduino megaAVR boards - Uno Wifi Rev.2, Nano Every
138  #define RADIOLIB_PLATFORM "Arduino megaAVR"
139 
140 #elif defined(ARDUINO_ARCH_APOLLO3)
141  // Sparkfun Apollo3 boards
142  #define RADIOLIB_PLATFORM "Sparkfun Apollo3"
143  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (Arduino_PinMode)
144  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
145  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
146 
147 #elif defined(ARDUINO_ARDUINO_NANO33BLE)
148  // Arduino Nano 33 BLE
149  #define RADIOLIB_PLATFORM "Arduino Nano 33 BLE"
150  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
151  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
152  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
153  #define RADIOLIB_EEPROM_UNSUPPORTED
154 
155  // Arduino mbed OS boards have a really bad tone implementation which will crash after a couple seconds
156  #define RADIOLIB_TONE_UNSUPPORTED
157  #define RADIOLIB_MBED_TONE_OVERRIDE
158 
159 #elif defined(ARDUINO_PORTENTA_H7_M7) || defined(ARDUINO_PORTENTA_H7_M4)
160  // Arduino Portenta H7
161  #define RADIOLIB_PLATFORM "Portenta H7"
162  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
163  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
164  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
165  #define RADIOLIB_EEPROM_UNSUPPORTED
166 
167  // Arduino mbed OS boards have a really bad tone implementation which will crash after a couple seconds
168  #define RADIOLIB_TONE_UNSUPPORTED
169  #define RADIOLIB_MBED_TONE_OVERRIDE
170 
171 #elif defined(__STM32F4__) || defined(__STM32F1__)
172  // Arduino STM32 core by Roger Clark (https://github.com/rogerclarkmelbourne/Arduino_STM32)
173  #define RADIOLIB_PLATFORM "STM32duino (unofficial)"
174  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (WiringPinMode)
175  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (ExtIntTriggerMode)
176 
177 #elif defined(ARDUINO_ARCH_MEGAAVR)
178  // MegaCoreX by MCUdude (https://github.com/MCUdude/MegaCoreX)
179  #define RADIOLIB_PLATFORM "MegaCoreX"
180 
181 #elif defined(ARDUINO_ARCH_MBED_RP2040)
182  // Raspberry Pi Pico (official mbed core)
183  #define RADIOLIB_PLATFORM "Raspberry Pi Pico"
184  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
185  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
186  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
187  #define RADIOLIB_EEPROM_UNSUPPORTED
188 
189  // Arduino mbed OS boards have a really bad tone implementation which will crash after a couple seconds
190  #define RADIOLIB_TONE_UNSUPPORTED
191  #define RADIOLIB_MBED_TONE_OVERRIDE
192 
193 #elif defined(ARDUINO_ARCH_RP2040)
194  // Raspberry Pi Pico (unofficial core)
195  #define RADIOLIB_PLATFORM "Raspberry Pi Pico (unofficial)"
196  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
197  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
198  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
199 
200 #elif defined(__ASR6501__) || defined(ARDUINO_ARCH_ASR650X) || defined(DARDUINO_ARCH_ASR6601)
201  // CubeCell
202  #define RADIOLIB_PLATFORM "CubeCell"
203  #define RADIOLIB_DEFAULT_SPI_SETTINGS SPISettings(1000000, MSBFIRST, SPI_MODE0) // see issue #709
204  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PINMODE)
205  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (IrqModes)
206 
207  // provide an easy access to the on-board module
208  #include "board-config.h"
209  #define RADIOLIB_BUILTIN_MODULE RADIO_NSS, RADIO_DIO_1, RADIO_RESET, RADIO_BUSY
210 
211  // CubeCell doesn't seem to define nullptr, let's do something like that now
212  #define nullptr NULL
213 
214  // ... and also defines pinMode() as a macro, which is by far the stupidest thing I have seen on Arduino
215  #undef pinMode
216 
217  // ... and uses an outdated GCC which does not support type aliases
218  #define RADIOLIB_TYPE_ALIAS(type, alias) typedef class type alias;
219 
220  // ... and it also has no tone(). This platform was designed by an idiot.
221  #define RADIOLIB_TONE_UNSUPPORTED
222 
223  // ... AND as the (hopefully) final nail in the coffin, IT F*CKING DEFINES YIELD() AS A MACRO THAT DOES NOTHING!!!
224  #define RADIOLIB_YIELD_UNSUPPORTED
225  #if defined(yield)
226  #undef yield
227  #endif
228 
229 #elif defined(RASPI)
230  // RaspiDuino framework (https://github.com/me-no-dev/RasPiArduino)
231  #define RADIOLIB_PLATFORM "RasPiArduino"
232 
233  // let's start off easy - no tone on this platform, that can happen
234  #define RADIOLIB_TONE_UNSUPPORTED
235 
236  // hmm, no yield either - weird on something like Raspberry PI, but sure, we can handle it
237  #define RADIOLIB_YIELD_UNSUPPORTED
238 
239  // aight, getting to the juicy stuff - PGM_P seems missing, that's the first time
240  #define PGM_P const char *
241 
242  // ... and for the grand finale, we have millis() and micros() DEFINED AS MACROS!
243  #if defined(millis)
244  #undef millis
245  inline unsigned long millis() { return((unsigned long)(STCV / 1000)); };
246  #endif
247 
248  #if defined(micros)
249  #undef micros
250  inline unsigned long micros() { return((unsigned long)(STCV)); };
251  #endif
252 
253 #elif defined(TEENSYDUINO)
254  // Teensy
255  #define RADIOLIB_PLATFORM "Teensy"
256 
257 #elif defined(ARDUINO_ARCH_RENESAS)
258  // Arduino Renesas (UNO R4)
259  #define RADIOLIB_PLATFORM "Arduino Renesas (UNO R4)"
260  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
261  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
262  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
263 
264 #else
265  // other Arduino platforms not covered by the above list - this may or may not work
266  #define RADIOLIB_PLATFORM "Unknown Arduino"
267  #define RADIOLIB_UNKNOWN_PLATFORM
268 
269 #endif
270 
271  // set the default values for all macros
272  // these will be applied if they were not defined above
273  #if !defined(RADIOLIB_NC)
274  #define RADIOLIB_NC (0xFFFFFFFF)
275  #endif
276 
277  #if !defined(RADIOLIB_DEFAULT_SPI)
278  #define RADIOLIB_DEFAULT_SPI SPI
279  #endif
280 
281  #if !defined(RADIOLIB_DEFAULT_SPI_SETTINGS)
282  #define RADIOLIB_DEFAULT_SPI_SETTINGS SPISettings(2000000, MSBFIRST, SPI_MODE0)
283  #endif
284 
285  #if !defined(RADIOLIB_NONVOLATILE)
286  #define RADIOLIB_NONVOLATILE PROGMEM
287  #endif
288 
289  #if !defined(RADIOLIB_NONVOLATILE_PTR)
290  #define RADIOLIB_NONVOLATILE_PTR PGM_P
291  #endif
292 
293  #if !defined(RADIOLIB_NONVOLATILE_READ_BYTE)
294  #define RADIOLIB_NONVOLATILE_READ_BYTE(addr) pgm_read_byte(addr)
295  #endif
296 
297  #if !defined(RADIOLIB_NONVOLATILE_READ_DWORD)
298  #define RADIOLIB_NONVOLATILE_READ_DWORD(addr) pgm_read_dword(addr)
299  #endif
300 
301  #if !defined(RADIOLIB_TYPE_ALIAS)
302  #define RADIOLIB_TYPE_ALIAS(type, alias) using alias = type;
303  #endif
304 
305  #if !defined(RADIOLIB_ARDUINOHAL_PIN_MODE_CAST)
306  #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST
307  #endif
308 
309  #if !defined(RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST)
310  #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST
311  #endif
312 
313  #if !defined(RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST)
314  #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST
315  #endif
316 
317 #else
318  // generic non-Arduino platform
319  #define RADIOLIB_PLATFORM "Generic"
320 
321  #define RADIOLIB_NC (0xFF)
322  #define RADIOLIB_NONVOLATILE
323  #define RADIOLIB_NONVOLATILE_READ_BYTE(addr) (*((uint8_t *)(void *)(addr)))
324  #define RADIOLIB_NONVOLATILE_READ_DWORD(addr) (*((uint32_t *)(void *)(addr)))
325  #define RADIOLIB_TYPE_ALIAS(type, alias) using alias = type;
326 
327  #if !defined(RADIOLIB_DEBUG_PORT)
328  #define RADIOLIB_DEBUG_PORT stdout
329  #endif
330 
331  #define DEC 10
332  #define HEX 16
333  #define OCT 8
334  #define BIN 2
335 
336  #include <stdint.h>
337 
338 #endif
339 
340 /*
341  * Uncomment to enable debug output.
342  * Warning: Debug output will slow down the whole system significantly.
343  * Also, it will result in larger compiled binary.
344  * Levels: debug - only main info
345  * verbose - full transcript of all SPI communication
346  */
347 #if !defined(RADIOLIB_DEBUG)
348  //#define RADIOLIB_DEBUG
349 #endif
350 #if !defined(RADIOLIB_VERBOSE)
351  //#define RADIOLIB_VERBOSE
352 #endif
353 
354 // set which output port should be used for debug output
355 // may be Serial port (on Arduino) or file like stdout or stderr (on generic platforms)
356 #if defined(RADIOLIB_BUILD_ARDUINO) && !defined(RADIOLIB_DEBUG_PORT)
357  #define RADIOLIB_DEBUG_PORT Serial
358 #endif
359 
360 /*
361  * Uncomment to enable "paranoid" SPI mode
362  * Every write to an SPI register using SPI set function will be verified by a subsequent read operation.
363  * This improves reliability, but slightly slows down communication.
364  * Note: Enabled by default.
365  */
366 #if !defined(RADIOLIB_SPI_PARANOID)
367  #define RADIOLIB_SPI_PARANOID
368 #endif
369 
370 /*
371  * Uncomment to enable parameter range checking
372  * RadioLib will check provided parameters (such as frequency) against limits determined by the device manufacturer.
373  * It is highly advised to keep this macro defined, removing it will allow invalid values to be set,
374  * possibly leading to bricked module and/or program crashing.
375  * Note: Enabled by default.
376  */
377 #if !defined(RADIOLIB_CHECK_PARAMS)
378  #define RADIOLIB_CHECK_PARAMS
379 #endif
380 
381 /*
382  * Uncomment to enable SX127x errata fix
383  * Warning: SX127x errata fix has been reported to cause issues with LoRa bandwidths lower than 62.5 kHz.
384  * It should only be enabled if you really are observing some errata-related issue.
385  * Note: Disabled by default.
386  */
387 #if !defined(RADIOLIB_FIX_ERRATA_SX127X)
388  //#define RADIOLIB_FIX_ERRATA_SX127X
389 #endif
390 
391 /*
392  * Uncomment to enable god mode - all methods and member variables in all classes will be made public, thus making them accessible from Arduino code.
393  * Warning: Come on, it's called GOD mode - obviously only use this if you know what you're doing.
394  * Failure to heed the above warning may result in bricked module.
395  */
396 #if !defined(RADIOLIB_GODMODE)
397  //#define RADIOLIB_GODMODE
398 #endif
399 
400 /*
401  * Uncomment to enable low-level hardware access
402  * This will make some hardware methods like SPI get/set accessible from the user sketch - think of it as "god mode lite"
403  * Warning: RadioLib won't stop you from writing invalid stuff into your device, so it's quite easy to brick your module with this.
404  */
405 #if !defined(RADIOLIB_LOW_LEVEL)
406  //#define RADIOLIB_LOW_LEVEL
407 #endif
408 
409 /*
410  * Uncomment to enable pre-defined modules when using RadioShield.
411  */
412 #if !defined(RADIOLIB_RADIOSHIELD)
413  //#define RADIOLIB_RADIOSHIELD
414 #endif
415 
416 /*
417  * Uncomment to enable interrupt-based timing control
418  * For details, see https://github.com/jgromes/RadioLib/wiki/Interrupt-Based-Timing
419  */
420 #if !defined(RADIOLIB_INTERRUPT_TIMING)
421  //#define RADIOLIB_INTERRUPT_TIMING
422 #endif
423 
424 /*
425  * Uncomment to enable static-only memory management: no dynamic allocation will be performed.
426  * Warning: Large static arrays will be created in some methods. It is not advised to send large packets in this mode.
427  */
428 #if !defined(RADIOLIB_STATIC_ONLY)
429  //#define RADIOLIB_STATIC_ONLY
430 #endif
431 
432 // set the size of static arrays to use
433 #if !defined(RADIOLIB_STATIC_ARRAY_SIZE)
434  #define RADIOLIB_STATIC_ARRAY_SIZE (256)
435 #endif
436 
437 // the base address for persistent storage
438 // some protocols (e.g. LoRaWAN) require a method
439 // to store some data persistently
440 // on Arduino, this will use EEPROM, on non-Arduino platform,
441 // it will use anything provided by the hardware abstraction layer
442 // RadioLib will place these starting at this address
443 #if !defined(RADIOLIB_HAL_PERSISTENT_STORAGE_BASE)
444  #define RADIOLIB_HAL_PERSISTENT_STORAGE_BASE (0)
445 #endif
446 
447 // the amount of space allocated to the persistent storage
448 #if !defined(RADIOLIB_HAL_PERSISTENT_STORAGE_SIZE)
449  #define RADIOLIB_HAL_PERSISTENT_STORAGE_SIZE (0x0180)
450 #endif
451 
452 /*
453  * Uncomment on boards whose clock runs too slow or too fast
454  * Set the value according to the following scheme:
455  * Enable timestamps on your terminal
456  * Print something to terminal, wait 1000 milliseconds, print something again
457  * If the difference is e.g. 1014 milliseconds between the prints, set this value to 14
458  * Or, for more accuracy, wait for 100,000 milliseconds and divide the total drift by 100
459  */
460 #if !defined(RADIOLIB_CLOCK_DRIFT_MS)
461  //#define RADIOLIB_CLOCK_DRIFT_MS (0)
462 #endif
463 
464 // This only compiles on STM32 boards with SUBGHZ module, but also
465 // include when generating docs
466 #if (!defined(ARDUINO_ARCH_STM32) || !defined(SUBGHZSPI_BASE)) && !defined(DOXYGEN)
467  #define RADIOLIB_EXCLUDE_STM32WLX
468 #endif
469 
470 #if defined(RADIOLIB_DEBUG)
471  #if defined(RADIOLIB_BUILD_ARDUINO)
472  #define RADIOLIB_DEBUG_PRINT(...) Module::serialPrintf(__VA_ARGS__)
473  #define RADIOLIB_DEBUG_PRINTLN(M, ...) Module::serialPrintf(M "\n", ##__VA_ARGS__)
474 
475  // some platforms do not support printf("%f"), so it has to be done this way
476  #define RADIOLIB_DEBUG_PRINT_FLOAT(VAL, DECIMALS) RADIOLIB_DEBUG_PORT.print(VAL, DECIMALS)
477  #else
478  #if !defined(RADIOLIB_DEBUG_PRINT)
479  #define RADIOLIB_DEBUG_PRINT(...) fprintf(RADIOLIB_DEBUG_PORT, __VA_ARGS__)
480  #endif
481  #if !defined(RADIOLIB_DEBUG_PRINTLN)
482  #define RADIOLIB_DEBUG_PRINTLN(M, ...) fprintf(RADIOLIB_DEBUG_PORT, M "\n", ##__VA_ARGS__)
483  #endif
484  #define RADIOLIB_DEBUG_PRINT_FLOAT(VAL, DECIMALS) RADIOLIB_DEBUG_PRINT("%.3f", VAL)
485  #endif
486  #define RADIOLIB_DEBUG_HEXDUMP(...) Module::hexdump(__VA_ARGS__)
487 #else
488  #define RADIOLIB_DEBUG_PRINT(...) {}
489  #define RADIOLIB_DEBUG_PRINTLN(...) {}
490  #define RADIOLIB_DEBUG_PRINT_FLOAT(VAL, DECIMALS) {}
491  #define RADIOLIB_DEBUG_HEXDUMP(...) {}
492 #endif
493 
494 #if defined(RADIOLIB_VERBOSE)
495  #define RADIOLIB_VERBOSE_PRINT(...) RADIOLIB_DEBUG_PRINT(__VA_ARGS__)
496  #define RADIOLIB_VERBOSE_PRINTLN(...) RADIOLIB_DEBUG_PRINTLN(__VA_ARGS__)
497 #else
498  #define RADIOLIB_VERBOSE_PRINT(...) {}
499  #define RADIOLIB_VERBOSE_PRINTLN(...) {}
500 #endif
501 
505 #define RADIOLIB_ASSERT(STATEVAR) { if((STATEVAR) != RADIOLIB_ERR_NONE) { return(STATEVAR); } }
506 
510 #if defined(RADIOLIB_CHECK_PARAMS)
511  #define RADIOLIB_CHECK_RANGE(VAR, MIN, MAX, ERR) { if(!(((VAR) >= (MIN)) && ((VAR) <= (MAX)))) { return(ERR); } }
512 #else
513  #define RADIOLIB_CHECK_RANGE(VAR, MIN, MAX, ERR) {}
514 #endif
515 
516 #if defined(RADIOLIB_FIX_ERRATA_SX127X)
517  #define RADIOLIB_ERRATA_SX127X(...) { errataFix(__VA_ARGS__); }
518 #else
519  #define RADIOLIB_ERRATA_SX127X(...) {}
520 #endif
521 
522 // these macros are usually defined by Arduino, but some platforms undef them, so its safer to use our own
523 #define RADIOLIB_MIN(a,b) ((a)<(b)?(a):(b))
524 #define RADIOLIB_MAX(a,b) ((a)>(b)?(a):(b))
525 #define RADIOLIB_ABS(x) ((x)>0?(x):-(x))
526 
527 // version definitions
528 #define RADIOLIB_VERSION_MAJOR 6
529 #define RADIOLIB_VERSION_MINOR 2
530 #define RADIOLIB_VERSION_PATCH 0
531 #define RADIOLIB_VERSION_EXTRA 0
532 
533 #define RADIOLIB_VERSION (((RADIOLIB_VERSION_MAJOR) << 24) | ((RADIOLIB_VERSION_MINOR) << 16) | ((RADIOLIB_VERSION_PATCH) << 8) | (RADIOLIB_VERSION_EXTRA))
534 
535 #endif