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