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 #elif defined(ESP8266)
87 // ESP8266 boards
88 #define RADIOLIB_PLATFORM "ESP8266"
89
90 #elif defined(ESP32) || defined(ARDUINO_ARCH_ESP32)
91 #define RADIOLIB_ESP32
92
93 // ESP32 boards
94 #define RADIOLIB_PLATFORM "ESP32"
95
96 // ESP32 doesn't support tone(), but it can be emulated via LED control peripheral
97 #define RADIOLIB_TONE_UNSUPPORTED
98 #define RADIOLIB_TONE_ESP32_CHANNEL (1)
99
100 #elif defined(ARDUINO_ARCH_STM32)
101 // official STM32 Arduino core (https://github.com/stm32duino/Arduino_Core_STM32)
102 #define RADIOLIB_PLATFORM "Arduino STM32 (official)"
103
104 #elif defined(SAMD_SERIES)
105 // Adafruit SAMD boards (M0 and M4)
106 #define RADIOLIB_PLATFORM "Adafruit SAMD"
107 #define RADIOLIB_EEPROM_UNSUPPORTED
108
109 #elif defined(ARDUINO_ARCH_SAMD)
110 // Arduino SAMD (Zero, MKR, etc.)
111 #define RADIOLIB_PLATFORM "Arduino SAMD"
112 #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
113 #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
114 #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
115 #define RADIOLIB_EEPROM_UNSUPPORTED
116
117 #elif defined(__SAM3X8E__)
118 // Arduino Due
119 #define RADIOLIB_PLATFORM "Arduino Due"
120 #define RADIOLIB_TONE_UNSUPPORTED
121 #define RADIOLIB_EEPROM_UNSUPPORTED
122
123 #elif (defined(NRF52832_XXAA) || defined(NRF52840_XXAA)) && !defined(ARDUINO_ARDUINO_NANO33BLE)
124 // Adafruit nRF52 boards
125 #define RADIOLIB_PLATFORM "Adafruit nRF52"
126 #define RADIOLIB_EEPROM_UNSUPPORTED
127
128 #elif defined(ARDUINO_ARC32_TOOLS)
129 // Intel Curie
130 #define RADIOLIB_PLATFORM "Intel Curie"
131
132 #elif defined(ARDUINO_AVR_UNO_WIFI_REV2) || defined(ARDUINO_AVR_NANO_EVERY) || defined(PORTDUINO)
133 // Arduino megaAVR boards - Uno Wifi Rev.2, Nano Every
134 #define RADIOLIB_PLATFORM "Arduino megaAVR"
135
136 #elif defined(ARDUINO_ARCH_APOLLO3)
137 // Sparkfun Apollo3 boards
138 #define RADIOLIB_PLATFORM "Sparkfun Apollo3"
139 #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (Arduino_PinMode)
140 #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
141 #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
142
143 #elif defined(ARDUINO_ARDUINO_NANO33BLE)
144 // Arduino Nano 33 BLE
145 #define RADIOLIB_PLATFORM "Arduino Nano 33 BLE"
146 #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
147 #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
148 #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
149 #define RADIOLIB_EEPROM_UNSUPPORTED
150
151 // Arduino mbed OS boards have a really bad tone implementation which will crash after a couple seconds
152 #define RADIOLIB_TONE_UNSUPPORTED
153 #define RADIOLIB_MBED_TONE_OVERRIDE
154
155 #elif defined(ARDUINO_PORTENTA_H7_M7) || defined(ARDUINO_PORTENTA_H7_M4)
156 // Arduino Portenta H7
157 #define RADIOLIB_PLATFORM "Portenta H7"
158 #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
159 #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
160 #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
161 #define RADIOLIB_EEPROM_UNSUPPORTED
162
163 // Arduino mbed OS boards have a really bad tone implementation which will crash after a couple seconds
164 #define RADIOLIB_TONE_UNSUPPORTED
165 #define RADIOLIB_MBED_TONE_OVERRIDE
166
167 #elif defined(__STM32F4__) || defined(__STM32F1__)
168 // Arduino STM32 core by Roger Clark (https://github.com/rogerclarkmelbourne/Arduino_STM32)
169 #define RADIOLIB_PLATFORM "STM32duino (unofficial)"
170 #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (WiringPinMode)
171 #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (ExtIntTriggerMode)
172
173 #elif defined(ARDUINO_ARCH_MEGAAVR)
174 // MegaCoreX by MCUdude (https://github.com/MCUdude/MegaCoreX)
175 #define RADIOLIB_PLATFORM "MegaCoreX"
176
177 #elif defined(ARDUINO_ARCH_MBED_RP2040)
178 // Raspberry Pi Pico (official mbed core)
179 #define RADIOLIB_PLATFORM "Raspberry Pi Pico"
180 #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
181 #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
182 #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
183 #define RADIOLIB_EEPROM_UNSUPPORTED
184
185 // Arduino mbed OS boards have a really bad tone implementation which will crash after a couple seconds
186 #define RADIOLIB_TONE_UNSUPPORTED
187 #define RADIOLIB_MBED_TONE_OVERRIDE
188
189 #elif defined(ARDUINO_ARCH_RP2040)
190 // Raspberry Pi Pico (unofficial core)
191 #define RADIOLIB_PLATFORM "Raspberry Pi Pico (unofficial)"
192 #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
193 #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
194 #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
195
196 #elif defined(__ASR6501__) || defined(ARDUINO_ARCH_ASR650X) || defined(DARDUINO_ARCH_ASR6601)
197 // CubeCell
198 #define RADIOLIB_PLATFORM "CubeCell"
199 #define RADIOLIB_DEFAULT_SPI_SETTINGS SPISettings(1000000, MSBFIRST, SPI_MODE0) // see issue #709
200 #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PINMODE)
201 #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (IrqModes)
202
203 // provide an easy access to the on-board module
204 #include "board-config.h"
205 #define RADIOLIB_BUILTIN_MODULE RADIO_NSS, RADIO_DIO_1, RADIO_RESET, RADIO_BUSY
206
207 // CubeCell doesn't seem to define nullptr, let's do something like that now
208 #define nullptr NULL
209
210 // ... and also defines pinMode() as a macro, which is by far the stupidest thing I have seen on Arduino
211 #undef pinMode
212
213 // ... and uses an outdated GCC which does not support type aliases
214 #define RADIOLIB_TYPE_ALIAS(type, alias) typedef class type alias;
215
216 // ... and it also has no tone(). This platform was designed by an idiot.
217 #define RADIOLIB_TONE_UNSUPPORTED
218
219 // ... AND as the (hopefully) final nail in the coffin, IT F*CKING DEFINES YIELD() AS A MACRO THAT DOES NOTHING!!!
220 #define RADIOLIB_YIELD_UNSUPPORTED
221 #if defined(yield)
222 #undef yield
223 #endif
224
225 #elif defined(RASPI)
226 // RaspiDuino framework (https://github.com/me-no-dev/RasPiArduino)
227 #define RADIOLIB_PLATFORM "RasPiArduino"
228
229 // let's start off easy - no tone on this platform, that can happen
230 #define RADIOLIB_TONE_UNSUPPORTED
231
232 // hmm, no yield either - weird on something like Raspberry PI, but sure, we can handle it
233 #define RADIOLIB_YIELD_UNSUPPORTED
234
235 // aight, getting to the juicy stuff - PGM_P seems missing, that's the first time
236 #define PGM_P const char *
237
238 // ... and for the grand finale, we have millis() and micros() DEFINED AS MACROS!
239 #if defined(millis)
240 #undef millis
241 inline unsigned long millis() { return((unsigned long)(STCV / 1000)); };
242 #endif
243
244 #if defined(micros)
245 #undef micros
246 inline unsigned long micros() { return((unsigned long)(STCV)); };
247 #endif
248
249 #elif defined(TEENSYDUINO)
250 // Teensy
251 #define RADIOLIB_PLATFORM "Teensy"
252
253 #elif defined(ARDUINO_ARCH_RENESAS)
254 // Arduino Renesas (UNO R4)
255 #define RADIOLIB_PLATFORM "Arduino Renesas (UNO R4)"
256 #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
257 #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
258 #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
259
260 #else
261 // other Arduino platforms not covered by the above list - this may or may not work
262 #define RADIOLIB_PLATFORM "Unknown Arduino"
263 #define RADIOLIB_UNKNOWN_PLATFORM
264
265 #endif
266
267 // set the default values for all macros
268 // these will be applied if they were not defined above
269 #if !defined(RADIOLIB_NC)
270 #define RADIOLIB_NC (0xFFFFFFFF)
271 #endif
272
273 #if !defined(RADIOLIB_DEFAULT_SPI)
274 #define RADIOLIB_DEFAULT_SPI SPI
275 #endif
276
277 #if !defined(RADIOLIB_DEFAULT_SPI_SETTINGS)
278 #define RADIOLIB_DEFAULT_SPI_SETTINGS SPISettings(2000000, MSBFIRST, SPI_MODE0)
279 #endif
280
281 #if !defined(RADIOLIB_NONVOLATILE)
282 #define RADIOLIB_NONVOLATILE PROGMEM
283 #endif
284
285 #if !defined(RADIOLIB_NONVOLATILE_PTR)
286 #define RADIOLIB_NONVOLATILE_PTR PGM_P
287 #endif
288
289 #if !defined(RADIOLIB_NONVOLATILE_READ_BYTE)
290 #define RADIOLIB_NONVOLATILE_READ_BYTE(addr) pgm_read_byte(addr)
291 #endif
292
293 #if !defined(RADIOLIB_NONVOLATILE_READ_DWORD)
294 #define RADIOLIB_NONVOLATILE_READ_DWORD(addr) pgm_read_dword(addr)
295 #endif
296
297 #if !defined(RADIOLIB_TYPE_ALIAS)
298 #define RADIOLIB_TYPE_ALIAS(type, alias) using alias = type;
299 #endif
300
301 #if !defined(RADIOLIB_ARDUINOHAL_PIN_MODE_CAST)
302 #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST
303 #endif
304
305 #if !defined(RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST)
306 #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST
307 #endif
308
309 #if !defined(RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST)
310 #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST
311 #endif
312
313 #else
314 // generic non-Arduino platform
315 #define RADIOLIB_PLATFORM "Generic"
316
317 #define RADIOLIB_NC (0xFF)
318 #define RADIOLIB_NONVOLATILE
319 #define RADIOLIB_NONVOLATILE_READ_BYTE(addr) (*((uint8_t *)(void *)(addr)))
320 #define RADIOLIB_NONVOLATILE_READ_DWORD(addr) (*((uint32_t *)(void *)(addr)))
321 #define RADIOLIB_TYPE_ALIAS(type, alias) using alias = type;
322
323 #if !defined(RADIOLIB_DEBUG_PORT)
324 #define RADIOLIB_DEBUG_PORT stdout
325 #endif
326
327 #define DEC 10
328 #define HEX 16
329 #define OCT 8
330 #define BIN 2
331
332 #include <stdint.h>
333
334 #endif
335
336 /*
337 * Uncomment to enable debug output.
338 * Warning: Debug output will slow down the whole system significantly.
339 * Also, it will result in larger compiled binary.
340 * Levels: debug - only main info
341 * verbose - full transcript of all SPI communication
342 */
343 #if !defined(RADIOLIB_DEBUG)
344 //#define RADIOLIB_DEBUG
345 #endif
346 #if !defined(RADIOLIB_VERBOSE)
347 //#define RADIOLIB_VERBOSE
348 #endif
349
350 // set which output port should be used for debug output
351 // may be Serial port (on Arduino) or file like stdout or stderr (on generic platforms)
352 #if defined(RADIOLIB_BUILD_ARDUINO) && !defined(RADIOLIB_DEBUG_PORT)
353 #define RADIOLIB_DEBUG_PORT Serial
354 #endif
355
356 /*
357 * Uncomment to enable "paranoid" SPI mode
358 * Every write to an SPI register using SPI set function will be verified by a subsequent read operation.
359 * This improves reliability, but slightly slows down communication.
360 * Note: Enabled by default.
361 */
362 #if !defined(RADIOLIB_SPI_PARANOID)
363 #define RADIOLIB_SPI_PARANOID
364 #endif
365
366 /*
367 * Uncomment to enable parameter range checking
368 * RadioLib will check provided parameters (such as frequency) against limits determined by the device manufacturer.
369 * It is highly advised to keep this macro defined, removing it will allow invalid values to be set,
370 * possibly leading to bricked module and/or program crashing.
371 * Note: Enabled by default.
372 */
373 #if !defined(RADIOLIB_CHECK_PARAMS)
374 #define RADIOLIB_CHECK_PARAMS
375 #endif
376
377 /*
378 * Uncomment to enable SX127x errata fix
379 * Warning: SX127x errata fix has been reported to cause issues with LoRa bandwidths lower than 62.5 kHz.
380 * It should only be enabled if you really are observing some errata-related issue.
381 * Note: Disabled by default.
382 */
383 #if !defined(RADIOLIB_FIX_ERRATA_SX127X)
384 //#define RADIOLIB_FIX_ERRATA_SX127X
385 #endif
386
387 /*
388 * Uncomment to enable god mode - all methods and member variables in all classes will be made public, thus making them accessible from Arduino code.
389 * Warning: Come on, it's called GOD mode - obviously only use this if you know what you're doing.
390 * Failure to heed the above warning may result in bricked module.
391 */
392 #if !defined(RADIOLIB_GODMODE)
393 //#define RADIOLIB_GODMODE
394 #endif
395
396 /*
397 * Uncomment to enable low-level hardware access
398 * This will make some hardware methods like SPI get/set accessible from the user sketch - think of it as "god mode lite"
399 * Warning: RadioLib won't stop you from writing invalid stuff into your device, so it's quite easy to brick your module with this.
400 */
401 #if !defined(RADIOLIB_LOW_LEVEL)
402 //#define RADIOLIB_LOW_LEVEL
403 #endif
404
405 /*
406 * Uncomment to enable pre-defined modules when using RadioShield.
407 */
408 #if !defined(RADIOLIB_RADIOSHIELD)
409 //#define RADIOLIB_RADIOSHIELD
410 #endif
411
412 /*
413 * Uncomment to enable interrupt-based timing control
414 * For details, see https://github.com/jgromes/RadioLib/wiki/Interrupt-Based-Timing
415 */
416 #if !defined(RADIOLIB_INTERRUPT_TIMING)
417 //#define RADIOLIB_INTERRUPT_TIMING
418 #endif
419
420 /*
421 * Uncomment to enable static-only memory management: no dynamic allocation will be performed.
422 * Warning: Large static arrays will be created in some methods. It is not advised to send large packets in this mode.
423 */
424 #if !defined(RADIOLIB_STATIC_ONLY)
425 //#define RADIOLIB_STATIC_ONLY
426 #endif
427
428 // set the size of static arrays to use
429 #if !defined(RADIOLIB_STATIC_ARRAY_SIZE)
430 #define RADIOLIB_STATIC_ARRAY_SIZE (256)
431 #endif
432
433 // the base address for persistent storage
434 // some protocols (e.g. LoRaWAN) require a method
435 // to store some data persistently
436 // on Arduino, this will use EEPROM, on non-Arduino platform,
437 // it will use anything provided by the hardware abstraction layer
438 // RadioLib will place these starting at this address
439 #if !defined(RADIOLIB_HAL_PERSISTENT_STORAGE_BASE)
440 #define RADIOLIB_HAL_PERSISTENT_STORAGE_BASE (0)
441 #endif
442
443 // the amount of space allocated to the persistent storage
444 #if !defined(RADIOLIB_HAL_PERSISTENT_STORAGE_SIZE)
445 #define RADIOLIB_HAL_PERSISTENT_STORAGE_SIZE (0xD0)
446 #endif
447
448 // This only compiles on STM32 boards with SUBGHZ module, but also
449 // include when generating docs
450 #if (!defined(ARDUINO_ARCH_STM32) || !defined(SUBGHZSPI_BASE)) && !defined(DOXYGEN)
451 #define RADIOLIB_EXCLUDE_STM32WLX
452 #endif
453
454 #if defined(RADIOLIB_DEBUG)
455 #if defined(RADIOLIB_BUILD_ARDUINO)
456 #define RADIOLIB_DEBUG_PRINT(...) Module::serialPrintf(__VA_ARGS__)
457 #define RADIOLIB_DEBUG_PRINTLN(M, ...) Module::serialPrintf(M "\n", ##__VA_ARGS__)
458
459 // some platforms do not support printf("%f"), so it has to be done this way
460 #define RADIOLIB_DEBUG_PRINT_FLOAT(VAL, DECIMALS) RADIOLIB_DEBUG_PORT.print(VAL, DECIMALS)
461 #else
462 #if !defined(RADIOLIB_DEBUG_PRINT)
463 #define RADIOLIB_DEBUG_PRINT(...) fprintf(RADIOLIB_DEBUG_PORT, __VA_ARGS__)
464 #endif
465 #if !defined(RADIOLIB_DEBUG_PRINTLN)
466 #define RADIOLIB_DEBUG_PRINTLN(M, ...) fprintf(RADIOLIB_DEBUG_PORT, M "\n", ##__VA_ARGS__)
467 #endif
468 #define RADIOLIB_DEBUG_PRINT_FLOAT(VAL, DECIMALS) RADIOLIB_DEBUG_PRINT("%.3f", VAL)
469 #endif
470 #define RADIOLIB_DEBUG_HEXDUMP(...) Module::hexdump(__VA_ARGS__)
471 #else
472 #define RADIOLIB_DEBUG_PRINT(...) {}
473 #define RADIOLIB_DEBUG_PRINTLN(...) {}
474 #define RADIOLIB_DEBUG_PRINT_FLOAT(VAL, DECIMALS) {}
475 #define RADIOLIB_DEBUG_HEXDUMP(...) {}
476 #endif
477
478 #if defined(RADIOLIB_VERBOSE)
479 #define RADIOLIB_VERBOSE_PRINT(...) RADIOLIB_DEBUG_PRINT(__VA_ARGS__)
480 #define RADIOLIB_VERBOSE_PRINTLN(...) RADIOLIB_DEBUG_PRINTLN(__VA_ARGS__)
481 #else
482 #define RADIOLIB_VERBOSE_PRINT(...) {}
483 #define RADIOLIB_VERBOSE_PRINTLN(...) {}
484 #endif
485
489 #define RADIOLIB_ASSERT(STATEVAR) { if((STATEVAR) != RADIOLIB_ERR_NONE) { return(STATEVAR); } }
490
494 #if defined(RADIOLIB_CHECK_PARAMS)
495 #define RADIOLIB_CHECK_RANGE(VAR, MIN, MAX, ERR) { if(!(((VAR) >= (MIN)) && ((VAR) <= (MAX)))) { return(ERR); } }
496 #else
497 #define RADIOLIB_CHECK_RANGE(VAR, MIN, MAX, ERR) {}
498 #endif
499
500 #if defined(RADIOLIB_FIX_ERRATA_SX127X)
501 #define RADIOLIB_ERRATA_SX127X(...) { errataFix(__VA_ARGS__); }
502 #else
503 #define RADIOLIB_ERRATA_SX127X(...) {}
504 #endif
505
506 // these macros are usually defined by Arduino, but some platforms undef them, so its safer to use our own
507 #define RADIOLIB_MIN(a,b) ((a)<(b)?(a):(b))
508 #define RADIOLIB_MAX(a,b) ((a)>(b)?(a):(b))
509 #define RADIOLIB_ABS(x) ((x)>0?(x):-(x))
510
511 // version definitions
512 #define RADIOLIB_VERSION_MAJOR (0x06)
513 #define RADIOLIB_VERSION_MINOR (0x02)
514 #define RADIOLIB_VERSION_PATCH (0x00)
515 #define RADIOLIB_VERSION_EXTRA (0x00)
516
517 #define RADIOLIB_VERSION ((RADIOLIB_VERSION_MAJOR << 24) | (RADIOLIB_VERSION_MINOR << 16) | (RADIOLIB_VERSION_PATCH << 8) | (RADIOLIB_VERSION_EXTRA))
518
519 #endif