1 #if !defined(_RADIOLIB_BUILD_OPTIONS_H)
2 #define _RADIOLIB_BUILD_OPTIONS_H
16 #if !defined(RADIOLIB_DEBUG_BASIC)
17 #define RADIOLIB_DEBUG_BASIC (0)
19 #if !defined(RADIOLIB_DEBUG_PROTOCOL)
20 #define RADIOLIB_DEBUG_PROTOCOL (0)
22 #if !defined(RADIOLIB_DEBUG_SPI)
23 #define RADIOLIB_DEBUG_SPI (0)
28 #if !defined(RADIOLIB_DEBUG_PORT)
29 #define RADIOLIB_DEBUG_PORT Serial
38 #if !defined(RADIOLIB_SPI_PARANOID)
39 #define RADIOLIB_SPI_PARANOID (1)
49 #if !defined(RADIOLIB_CHECK_PARAMS)
50 #define RADIOLIB_CHECK_PARAMS (1)
59 #if !defined(RADIOLIB_FIX_ERRATA_SX127X)
60 #define RADIOLIB_FIX_ERRATA_SX127X (0)
68 #if !defined(RADIOLIB_GODMODE)
69 #define RADIOLIB_GODMODE (0)
77 #if !defined(RADIOLIB_LOW_LEVEL)
78 #define RADIOLIB_LOW_LEVEL (0)
84 #if !defined(RADIOLIB_RADIOSHIELD)
85 #define RADIOLIB_RADIOSHIELD (0)
92 #if !defined(RADIOLIB_INTERRUPT_TIMING)
93 #define RADIOLIB_INTERRUPT_TIMING (0)
100 #if !defined(RADIOLIB_STATIC_ONLY)
101 #define RADIOLIB_STATIC_ONLY (0)
105 #if !defined(RADIOLIB_STATIC_ARRAY_SIZE)
106 #define RADIOLIB_STATIC_ARRAY_SIZE (256)
117 #if !defined(RADIOLIB_CLOCK_DRIFT_MS)
124 #define RADIOLIB_BUILD_ARDUINO
128 #define RADIOLIB_BUILD_GENERIC
131 #if defined(RADIOLIB_BUILD_ARDUINO)
154 #if defined(RADIOLIB_CUSTOM_ARDUINO)
156 #define RADIOLIB_PLATFORM "Custom"
163 #define RADIOLIB_NC (0xFFFFFFFF)
164 #define RADIOLIB_DEFAULT_SPI SPI
165 #define RADIOLIB_DEFAULT_SPI_SETTINGS SPISettings(2000000, MSBFIRST, SPI_MODE0)
166 #define RADIOLIB_NONVOLATILE PROGMEM
167 #define RADIOLIB_NONVOLATILE_READ_BYTE(addr) pgm_read_byte(addr)
168 #define RADIOLIB_NONVOLATILE_READ_DWORD(addr) pgm_read_dword(addr)
169 #define RADIOLIB_TYPE_ALIAS(type, alias) using alias = type;
172 #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST
173 #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST
174 #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST
199 #elif defined(__AVR__) && !(defined(ARDUINO_AVR_UNO_WIFI_REV2) || defined(ARDUINO_AVR_NANO_EVERY) || defined(ARDUINO_ARCH_MEGAAVR))
201 #define RADIOLIB_PLATFORM "Arduino AVR"
203 #if !(defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__) || defined(__AVR_ATmega1284__) || defined(__AVR_ATmega1284P__))
204 #define RADIOLIB_LOWEND_PLATFORM
207 #elif defined(ESP8266)
209 #define RADIOLIB_PLATFORM "ESP8266"
211 #elif defined(ESP32) || defined(ARDUINO_ARCH_ESP32)
212 #define RADIOLIB_ESP32
215 #define RADIOLIB_PLATFORM "ESP32"
218 #define RADIOLIB_TONE_UNSUPPORTED
219 #define RADIOLIB_TONE_ESP32_CHANNEL (1)
221 #elif defined(ARDUINO_ARCH_STM32)
223 #define RADIOLIB_PLATFORM "Arduino STM32 (official)"
225 #elif defined(SAMD_SERIES)
227 #define RADIOLIB_PLATFORM "Adafruit SAMD"
229 #elif defined(ARDUINO_ARCH_SAMD)
231 #define RADIOLIB_PLATFORM "Arduino SAMD"
232 #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
233 #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
234 #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
236 #elif defined(__SAM3X8E__)
238 #define RADIOLIB_PLATFORM "Arduino Due"
239 #define RADIOLIB_TONE_UNSUPPORTED
241 #elif (defined(NRF52832_XXAA) || defined(NRF52840_XXAA)) && !defined(ARDUINO_ARDUINO_NANO33BLE)
243 #define RADIOLIB_PLATFORM "Adafruit nRF52"
245 #elif defined(ARDUINO_ARC32_TOOLS)
247 #define RADIOLIB_PLATFORM "Intel Curie"
249 #elif defined(ARDUINO_AVR_UNO_WIFI_REV2) || defined(ARDUINO_AVR_NANO_EVERY) || defined(PORTDUINO)
251 #define RADIOLIB_PLATFORM "Arduino megaAVR"
253 #elif defined(ARDUINO_ARCH_APOLLO3)
255 #define RADIOLIB_PLATFORM "Sparkfun Apollo3"
256 #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (Arduino_PinMode)
257 #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
258 #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
260 #elif defined(ARDUINO_ARDUINO_NANO33BLE)
262 #define RADIOLIB_PLATFORM "Arduino Nano 33 BLE"
263 #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
264 #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
265 #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
268 #define RADIOLIB_TONE_UNSUPPORTED
269 #define RADIOLIB_MBED_TONE_OVERRIDE
271 #elif defined(ARDUINO_PORTENTA_H7_M7) || defined(ARDUINO_PORTENTA_H7_M4)
273 #define RADIOLIB_PLATFORM "Portenta H7"
274 #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
275 #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
276 #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
279 #define RADIOLIB_TONE_UNSUPPORTED
280 #define RADIOLIB_MBED_TONE_OVERRIDE
282 #elif defined(__STM32F4__) || defined(__STM32F1__)
284 #define RADIOLIB_PLATFORM "STM32duino (unofficial)"
285 #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (WiringPinMode)
286 #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (ExtIntTriggerMode)
288 #elif defined(ARDUINO_ARCH_MEGAAVR)
290 #define RADIOLIB_PLATFORM "MegaCoreX"
292 #elif defined(ARDUINO_ARCH_MBED_RP2040)
294 #define RADIOLIB_PLATFORM "Raspberry Pi Pico"
295 #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
296 #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
297 #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
300 #define RADIOLIB_TONE_UNSUPPORTED
301 #define RADIOLIB_MBED_TONE_OVERRIDE
303 #elif defined(ARDUINO_ARCH_RP2040)
305 #define RADIOLIB_PLATFORM "Raspberry Pi Pico (unofficial)"
306 #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
307 #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
308 #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
310 #elif defined(__ASR6501__) || defined(ARDUINO_ARCH_ASR650X) || defined(DARDUINO_ARCH_ASR6601)
312 #define RADIOLIB_PLATFORM "CubeCell"
313 #define RADIOLIB_DEFAULT_SPI_SETTINGS SPISettings(1000000, MSBFIRST, SPI_MODE0)
314 #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PINMODE)
315 #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (IrqModes)
318 #include "board-config.h"
319 #define RADIOLIB_BUILTIN_MODULE RADIO_NSS, RADIO_DIO_1, RADIO_RESET, RADIO_BUSY
328 #define RADIOLIB_TYPE_ALIAS(type, alias) typedef class type alias;
331 #define RADIOLIB_TONE_UNSUPPORTED
334 #define RADIOLIB_YIELD_UNSUPPORTED
341 #define RADIOLIB_PLATFORM "RasPiArduino"
344 #define RADIOLIB_TONE_UNSUPPORTED
347 #define RADIOLIB_YIELD_UNSUPPORTED
350 #define PGM_P const char *
363 #elif defined(TEENSYDUINO)
365 #define RADIOLIB_PLATFORM "Teensy"
367 #elif defined(ARDUINO_ARCH_RENESAS)
369 #define RADIOLIB_PLATFORM "Arduino Renesas (UNO R4)"
370 #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST (PinMode)
371 #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST (PinStatus)
372 #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST (PinStatus)
376 #define RADIOLIB_PLATFORM "Unknown Arduino"
377 #define RADIOLIB_UNKNOWN_PLATFORM
383 #if !defined(RADIOLIB_NC)
384 #define RADIOLIB_NC (0xFFFFFFFF)
387 #if !defined(RADIOLIB_DEFAULT_SPI)
388 #define RADIOLIB_DEFAULT_SPI SPI
391 #if !defined(RADIOLIB_DEFAULT_SPI_SETTINGS)
392 #define RADIOLIB_DEFAULT_SPI_SETTINGS SPISettings(2000000, MSBFIRST, SPI_MODE0)
395 #if !defined(RADIOLIB_NONVOLATILE)
396 #define RADIOLIB_NONVOLATILE PROGMEM
399 #if !defined(RADIOLIB_NONVOLATILE_PTR)
400 #define RADIOLIB_NONVOLATILE_PTR PGM_P
403 #if !defined(RADIOLIB_NONVOLATILE_READ_BYTE)
404 #define RADIOLIB_NONVOLATILE_READ_BYTE(addr) pgm_read_byte(addr)
407 #if !defined(RADIOLIB_NONVOLATILE_READ_DWORD)
408 #define RADIOLIB_NONVOLATILE_READ_DWORD(addr) pgm_read_dword(addr)
411 #if !defined(RADIOLIB_TYPE_ALIAS)
412 #define RADIOLIB_TYPE_ALIAS(type, alias) using alias = type;
415 #if !defined(RADIOLIB_ARDUINOHAL_PIN_MODE_CAST)
416 #define RADIOLIB_ARDUINOHAL_PIN_MODE_CAST
419 #if !defined(RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST)
420 #define RADIOLIB_ARDUINOHAL_PIN_STATUS_CAST
423 #if !defined(RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST)
424 #define RADIOLIB_ARDUINOHAL_INTERRUPT_MODE_CAST
429 #define RADIOLIB_PLATFORM "Generic"
431 #define RADIOLIB_NC (0xFF)
432 #define RADIOLIB_NONVOLATILE
433 #define RADIOLIB_NONVOLATILE_READ_BYTE(addr) (*((uint8_t *)(void *)(addr)))
434 #define RADIOLIB_NONVOLATILE_READ_DWORD(addr) (*((uint32_t *)(void *)(addr)))
435 #define RADIOLIB_TYPE_ALIAS(type, alias) using alias = type;
437 #if !defined(RADIOLIB_DEBUG_PORT)
438 #define RADIOLIB_DEBUG_PORT stdout
452 #if (!defined(ARDUINO_ARCH_STM32) || !defined(SUBGHZSPI_BASE)) && !defined(DOXYGEN)
453 #define RADIOLIB_EXCLUDE_STM32WLX (1)
457 #if RADIOLIB_DEBUG_BASIC || RADIOLIB_DEBUG_PROTOCOL || RADIOLIB_DEBUG_SPI
458 #define RADIOLIB_DEBUG (1)
460 #define RADIOLIB_DEBUG (0)
464 #if defined(RADIOLIB_BUILD_ARDUINO)
465 #define RADIOLIB_DEBUG_PRINT(...) Module::serialPrintf(__VA_ARGS__)
466 #define RADIOLIB_DEBUG_PRINTLN(M, ...) Module::serialPrintf(M "\n", ##__VA_ARGS__)
467 #define RADIOLIB_DEBUG_PRINT_LVL(LEVEL, M, ...) Module::serialPrintf(LEVEL "" M, ##__VA_ARGS__)
468 #define RADIOLIB_DEBUG_PRINTLN_LVL(LEVEL, M, ...) Module::serialPrintf(LEVEL "" M "\n", ##__VA_ARGS__)
471 #define RADIOLIB_DEBUG_PRINT_FLOAT(LEVEL, VAL, DECIMALS) RADIOLIB_DEBUG_PRINT(LEVEL); RADIOLIB_DEBUG_PORT.print(VAL, DECIMALS)
473 #if !defined(RADIOLIB_DEBUG_PRINT)
474 #define RADIOLIB_DEBUG_PRINT(...) fprintf(RADIOLIB_DEBUG_PORT, __VA_ARGS__)
475 #define RADIOLIB_DEBUG_PRINT_LVL(LEVEL, M, ...) fprintf(RADIOLIB_DEBUG_PORT, LEVEL "" M, ##__VA_ARGS__)
477 #if !defined(RADIOLIB_DEBUG_PRINTLN)
478 #define RADIOLIB_DEBUG_PRINTLN(M, ...) fprintf(RADIOLIB_DEBUG_PORT, M "\n", ##__VA_ARGS__)
479 #define RADIOLIB_DEBUG_PRINTLN_LVL(LEVEL, M, ...) fprintf(RADIOLIB_DEBUG_PORT, LEVEL "" M "\n", ##__VA_ARGS__)
481 #define RADIOLIB_DEBUG_PRINT_FLOAT(LEVEL, VAL, DECIMALS) RADIOLIB_DEBUG_PRINT(LEVEL "%.3f", VAL)
484 #define RADIOLIB_DEBUG_HEXDUMP(LEVEL, ...) Module::hexdump(LEVEL, __VA_ARGS__)
486 #define RADIOLIB_DEBUG_PRINT(...) {}
487 #define RADIOLIB_DEBUG_PRINTLN(...) {}
488 #define RADIOLIB_DEBUG_PRINT_FLOAT(VAL, DECIMALS) {}
489 #define RADIOLIB_DEBUG_HEXDUMP(...) {}
492 #if RADIOLIB_DEBUG_BASIC
493 #define RADIOLIB_DEBUG_BASIC_PRINT(...) RADIOLIB_DEBUG_PRINT_LVL("RLB_DBG: ", __VA_ARGS__)
494 #define RADIOLIB_DEBUG_BASIC_PRINT_NOTAG(...) RADIOLIB_DEBUG_PRINT_LVL("", __VA_ARGS__)
495 #define RADIOLIB_DEBUG_BASIC_PRINTLN(...) RADIOLIB_DEBUG_PRINTLN_LVL("RLB_DBG: ", __VA_ARGS__)
496 #define RADIOLIB_DEBUG_BASIC_PRINT_FLOAT(...) RADIOLIB_DEBUG_PRINT_FLOAT("RLB_DBG: ", __VA_ARGS__);
497 #define RADIOLIB_DEBUG_BASIC_HEXDUMP(...) RADIOLIB_DEBUG_HEXDUMP("RLB_DBG: ", __VA_ARGS__);
499 #define RADIOLIB_DEBUG_BASIC_PRINT(...) {}
500 #define RADIOLIB_DEBUG_BASIC_PRINT_NOTAG(...) {}
501 #define RADIOLIB_DEBUG_BASIC_PRINTLN(...) {}
502 #define RADIOLIB_DEBUG_BASIC_PRINT_FLOAT(...) {}
503 #define RADIOLIB_DEBUG_BASIC_HEXDUMP(...) {}
506 #if RADIOLIB_DEBUG_PROTOCOL
507 #define RADIOLIB_DEBUG_PROTOCOL_PRINT(...) RADIOLIB_DEBUG_PRINT_LVL("RLB_PRO: ", __VA_ARGS__)
508 #define RADIOLIB_DEBUG_PROTOCOL_PRINTLN(...) RADIOLIB_DEBUG_PRINTLN_LVL("RLB_PRO: ", __VA_ARGS__)
509 #define RADIOLIB_DEBUG_PROTOCOL_PRINT_FLOAT(...) RADIOLIB_DEBUG_PRINT_FLOAT("RLB_PRO: ", __VA_ARGS__);
510 #define RADIOLIB_DEBUG_PROTOCOL_HEXDUMP(...) RADIOLIB_DEBUG_HEXDUMP("RLB_PRO: ", __VA_ARGS__);
512 #define RADIOLIB_DEBUG_PROTOCOL_PRINT(...) {}
513 #define RADIOLIB_DEBUG_PROTOCOL_PRINTLN(...) {}
514 #define RADIOLIB_DEBUG_PROTOCOL_PRINT_FLOAT(...) {}
515 #define RADIOLIB_DEBUG_PROTOCOL_HEXDUMP(...) {}
518 #if RADIOLIB_DEBUG_SPI
519 #define RADIOLIB_DEBUG_SPI_PRINT(...) RADIOLIB_DEBUG_PRINT_LVL("RLB_SPI: ", __VA_ARGS__)
520 #define RADIOLIB_DEBUG_SPI_PRINT_NOTAG(...) RADIOLIB_DEBUG_PRINT_LVL("", __VA_ARGS__)
521 #define RADIOLIB_DEBUG_SPI_PRINTLN(...) RADIOLIB_DEBUG_PRINTLN_LVL("RLB_SPI: ", __VA_ARGS__)
522 #define RADIOLIB_DEBUG_SPI_PRINTLN_NOTAG(...) RADIOLIB_DEBUG_PRINTLN_LVL("", __VA_ARGS__)
523 #define RADIOLIB_DEBUG_SPI_PRINT_FLOAT(...) RADIOLIB_DEBUG_PRINT_FLOAT("RLB_SPI: ", __VA_ARGS__);
524 #define RADIOLIB_DEBUG_SPI_HEXDUMP(...) RADIOLIB_DEBUG_HEXDUMP("RLB_SPI: ", __VA_ARGS__);
526 #define RADIOLIB_DEBUG_SPI_PRINT(...) {}
527 #define RADIOLIB_DEBUG_SPI_PRINT_NOTAG(...) {}
528 #define RADIOLIB_DEBUG_SPI_PRINTLN(...) {}
529 #define RADIOLIB_DEBUG_SPI_PRINTLN_NOTAG(...) {}
530 #define RADIOLIB_DEBUG_SPI_PRINT_FLOAT(...) {}
531 #define RADIOLIB_DEBUG_SPI_HEXDUMP(...) {}
535 #define RADIOLIB_VALUE_TO_STRING(x) #x
536 #define RADIOLIB_VALUE(x) RADIOLIB_VALUE_TO_STRING(x)
538 #define RADIOLIB_INFO "\nRadioLib Info\nVersion: \"" \
539 RADIOLIB_VALUE(RADIOLIB_VERSION_MAJOR) "." \
540 RADIOLIB_VALUE(RADIOLIB_VERSION_MINOR) "." \
541 RADIOLIB_VALUE(RADIOLIB_VERSION_PATCH) "." \
542 RADIOLIB_VALUE(RADIOLIB_VERSION_EXTRA) "\"\n" \
543 "Platform: " RADIOLIB_VALUE(RADIOLIB_PLATFORM) "\n" \
544 "Compiled: " RADIOLIB_VALUE(__DATE__) " " RADIOLIB_VALUE(__TIME__)
549 #define RADIOLIB_ASSERT(STATEVAR) { if((STATEVAR) != RADIOLIB_ERR_NONE) { return(STATEVAR); } }
554 #if RADIOLIB_CHECK_PARAMS
555 #define RADIOLIB_CHECK_RANGE(VAR, MIN, MAX, ERR) { if(!(((VAR) >= (MIN)) && ((VAR) <= (MAX)))) { return(ERR); } }
557 #define RADIOLIB_CHECK_RANGE(VAR, MIN, MAX, ERR) {}
560 #if RADIOLIB_FIX_ERRATA_SX127X
561 #define RADIOLIB_ERRATA_SX127X(...) { errataFix(__VA_ARGS__); }
563 #define RADIOLIB_ERRATA_SX127X(...) {}
567 #define RADIOLIB_MIN(a,b) ((a)<(b)?(a):(b))
568 #define RADIOLIB_MAX(a,b) ((a)>(b)?(a):(b))
569 #define RADIOLIB_ABS(x) ((x)>0?(x):-(x))
572 #define RADIOLIB_VERSION_MAJOR 6
573 #define RADIOLIB_VERSION_MINOR 6
574 #define RADIOLIB_VERSION_PATCH 0
575 #define RADIOLIB_VERSION_EXTRA 0
577 #define RADIOLIB_VERSION (((RADIOLIB_VERSION_MAJOR) << 24) | ((RADIOLIB_VERSION_MINOR) << 16) | ((RADIOLIB_VERSION_PATCH) << 8) | (RADIOLIB_VERSION_EXTRA))
unsigned long RadioLibTime_t
Type used for durations in RadioLib.
Definition: TypeDef.h:616