RadioLib
Universal wireless communication library for Arduino
Module.h
1 #ifndef _RADIOLIB_MODULE_H
2 #define _RADIOLIB_MODULE_H
3 
4 #include "TypeDef.h"
5 
6 #include <SPI.h>
7 #ifndef RADIOLIB_SOFTWARE_SERIAL_UNSUPPORTED
8 #include <SoftwareSerial.h>
9 #endif
10 
17 class Module {
18  public:
28  Module(RADIOLIB_PIN_TYPE cs, RADIOLIB_PIN_TYPE irq, RADIOLIB_PIN_TYPE rst);
29 
41  Module(RADIOLIB_PIN_TYPE cs, RADIOLIB_PIN_TYPE irq, RADIOLIB_PIN_TYPE rst, RADIOLIB_PIN_TYPE gpio);
42 
56  Module(RADIOLIB_PIN_TYPE cs, RADIOLIB_PIN_TYPE irq, RADIOLIB_PIN_TYPE rst, SPIClass& spi, SPISettings spiSettings);
57 
73  Module(RADIOLIB_PIN_TYPE cs, RADIOLIB_PIN_TYPE irq, RADIOLIB_PIN_TYPE rst, RADIOLIB_PIN_TYPE gpio, SPIClass& spi, SPISettings spiSettings = SPISettings(2000000, MSBFIRST, SPI_MODE0));
74 
94 #ifdef RADIOLIB_SOFTWARE_SERIAL_UNSUPPORTED
95  Module(RADIOLIB_PIN_TYPE cs, RADIOLIB_PIN_TYPE irq, RADIOLIB_PIN_TYPE rst, RADIOLIB_PIN_TYPE rx, RADIOLIB_PIN_TYPE tx, SPIClass& spi = RADIOLIB_DEFAULT_SPI, SPISettings spiSettings = SPISettings(2000000, MSBFIRST, SPI_MODE0), HardwareSerial* serial = &RADIOLIB_HARDWARE_SERIAL_PORT);
96 #else
97  Module(RADIOLIB_PIN_TYPE cs, RADIOLIB_PIN_TYPE irq, RADIOLIB_PIN_TYPE rst, RADIOLIB_PIN_TYPE rx, RADIOLIB_PIN_TYPE tx, SPIClass& spi = RADIOLIB_DEFAULT_SPI, SPISettings spiSettings = SPISettings(2000000, MSBFIRST, SPI_MODE0), HardwareSerial* serial = nullptr);
98 #endif
99 
105  Module(const Module& mod);
106 
112  Module& operator=(const Module& mod);
113 
114  // public member variables
115 
119 #ifdef RADIOLIB_SOFTWARE_SERIAL_UNSUPPORTED
120  HardwareSerial* ModuleSerial;
121 #else
122  SoftwareSerial* ModuleSerial;
123 #endif
124 
128  uint32_t baudrate = 9600;
129 
133  char AtLineFeed[3] = {'\r', '\n'};
134 
138  uint8_t SPIreadCommand = 0b00000000;
139 
143  uint8_t SPIwriteCommand = 0b10000000;
144 
145  // basic methods
146 
152  void init(uint8_t interface);
153 
159  void term(uint8_t interface);
160 
161  // AT methods
162 
166  void ATemptyBuffer();
167 
173  bool ATgetResponse();
174 
182  bool ATsendCommand(const char* cmd);
183 
193  bool ATsendData(uint8_t* data, uint32_t len);
194 
195  // SPI methods
196 
208  int16_t SPIgetRegValue(uint8_t reg, uint8_t msb = 7, uint8_t lsb = 0);
209 
227  int16_t SPIsetRegValue(uint8_t reg, uint8_t value, uint8_t msb = 7, uint8_t lsb = 0, uint8_t checkInterval = 2, uint8_t checkMask = 0xFF);
228 
238  void SPIreadRegisterBurst(uint8_t reg, uint8_t numBytes, uint8_t* inBytes);
239 
247  uint8_t SPIreadRegister(uint8_t reg);
248 
258  void SPIwriteRegisterBurst(uint8_t reg, uint8_t* data, uint8_t numBytes);
259 
267  void SPIwriteRegister(uint8_t reg, uint8_t data);
268 
282  void SPItransfer(uint8_t cmd, uint8_t reg, uint8_t* dataOut, uint8_t* dataIn, uint8_t numBytes);
283 
284  // pin number access methods
285 
291  RADIOLIB_PIN_TYPE getCs() const { return(_cs); }
292 
298  RADIOLIB_PIN_TYPE getIrq() const { return(_irq); }
299 
305  RADIOLIB_PIN_TYPE getRst() const { return(_rst); }
306 
312  RADIOLIB_PIN_TYPE getGpio() const { return(_rx); }
313 
319  RADIOLIB_PIN_TYPE getRx() const { return(_rx); }
320 
326  RADIOLIB_PIN_TYPE getTx() const { return(_tx); }
327 
333  SPIClass* getSpi() const { return(_spi); }
334 
340  SPISettings getSpiSettings() const { return(_spiSettings); }
341 
350  void setRfSwitchPins(RADIOLIB_PIN_TYPE rxEn, RADIOLIB_PIN_TYPE txEn);
351 
359  void setRfSwitchState(RADIOLIB_PIN_STATUS rxPinState, RADIOLIB_PIN_STATUS txPinState);
360 
361  // Arduino core overrides
362 
370  static void pinMode(RADIOLIB_PIN_TYPE pin, RADIOLIB_PIN_MODE mode);
371 
379  static void digitalWrite(RADIOLIB_PIN_TYPE pin, RADIOLIB_PIN_STATUS value);
380 
388  static RADIOLIB_PIN_STATUS digitalRead(RADIOLIB_PIN_TYPE pin);
389 
397  static void tone(RADIOLIB_PIN_TYPE pin, uint16_t value);
398 
404  static void noTone(RADIOLIB_PIN_TYPE pin);
405 
415  static void attachInterrupt(RADIOLIB_PIN_TYPE interruptNum, void (*userFunc)(void), RADIOLIB_INTERRUPT_STATUS mode);
416 
422  static void detachInterrupt(RADIOLIB_PIN_TYPE interruptNum);
423 
427  static void yield();
428 
434  static void delay(uint32_t ms);
435 
441  static void delayMicroseconds(uint32_t us);
442 
446  static uint32_t millis();
447 
451  static uint32_t micros();
452 
456  static uint8_t flipBits(uint8_t b);
457 
461  static uint16_t flipBits16(uint16_t i);
462 
463 #ifndef RADIOLIB_GODMODE
464  private:
465 #endif
466  // allow SerialModule class to access private members
467  friend class SerialModule;
468 
469  // whether RadioLib should automatically initalize selected SPI or UART interface
470  bool _initInterface = false;
471 
472  // pins
473  RADIOLIB_PIN_TYPE _cs = RADIOLIB_NC;
474  RADIOLIB_PIN_TYPE _irq = RADIOLIB_NC;
475  RADIOLIB_PIN_TYPE _rst = RADIOLIB_NC;
476  RADIOLIB_PIN_TYPE _rx = RADIOLIB_NC;
477  RADIOLIB_PIN_TYPE _tx = RADIOLIB_NC;
478 
479  // SPI settings
480  SPISettings _spiSettings = SPISettings(2000000, MSBFIRST, SPI_MODE0);
481  SPIClass* _spi = NULL;
482 
483  // RF switch presence and pins
484  bool _useRfSwitch = false;
485  RADIOLIB_PIN_TYPE _rxEn = RADIOLIB_NC;
486  RADIOLIB_PIN_TYPE _txEn = RADIOLIB_NC;
487 
488  // AT command timeout in milliseconds
489  uint32_t _ATtimeout = 15000;
490 };
491 
497 class SerialModule: public Module {
498  public:
510  #ifdef RADIOLIB_SOFTWARE_SERIAL_UNSUPPORTED
511  SerialModule(RADIOLIB_PIN_TYPE rx, RADIOLIB_PIN_TYPE tx, RADIOLIB_PIN_TYPE rst = RADIOLIB_NC, HardwareSerial* serial = &RADIOLIB_HARDWARE_SERIAL_PORT);
512  #else
513  SerialModule(RADIOLIB_PIN_TYPE rx, RADIOLIB_PIN_TYPE tx, RADIOLIB_PIN_TYPE rst = RADIOLIB_NC, HardwareSerial* serial = nullptr);
514  #endif
515 };
516 
517 #endif
Module::pinMode
static void pinMode(RADIOLIB_PIN_TYPE pin, RADIOLIB_PIN_MODE mode)
Arduino core pinMode override that checks RADIOLIB_NC as alias for unused pin.
Definition: Module.cpp:320
Module::getIrq
RADIOLIB_PIN_TYPE getIrq() const
Access method to get the pin number of interrupt/GPIO.
Definition: Module.h:298
Module::getRx
RADIOLIB_PIN_TYPE getRx() const
Access method to get the pin number of UART Rx.
Definition: Module.h:319
Module::digitalRead
static RADIOLIB_PIN_STATUS digitalRead(RADIOLIB_PIN_TYPE pin)
Arduino core digitalWrite override that checks RADIOLIB_NC as alias for unused pin.
Definition: Module.cpp:332
Module::SPItransfer
void SPItransfer(uint8_t cmd, uint8_t reg, uint8_t *dataOut, uint8_t *dataIn, uint8_t numBytes)
SPI single transfer method.
Definition: Module.cpp:273
Module::SPIgetRegValue
int16_t SPIgetRegValue(uint8_t reg, uint8_t msb=7, uint8_t lsb=0)
SPI read method that automatically masks unused bits. This method is the preferred SPI read mechanism...
Definition: Module.cpp:196
Module::getSpi
SPIClass * getSpi() const
Access method to get the SPI interface.
Definition: Module.h:333
Module::ModuleSerial
SoftwareSerial * ModuleSerial
Internal SoftwareSerial instance.
Definition: Module.h:122
Module::AtLineFeed
char AtLineFeed[3]
Line feed to be used when sending AT commands. Defaults to CR+LF.
Definition: Module.h:133
Module::ATgetResponse
bool ATgetResponse()
Get response after sending AT command.
Definition: Module.cpp:172
Module::getRst
RADIOLIB_PIN_TYPE getRst() const
Access method to get the pin number of hardware reset pin.
Definition: Module.h:305
Module::SPIwriteCommand
uint8_t SPIwriteCommand
Basic SPI write command. Defaults to 0x80.
Definition: Module.h:143
Module::ATsendData
bool ATsendData(uint8_t *data, uint32_t len)
Send raw AT data. Will also call ATgetResponse.
Definition: Module.cpp:162
Module::delay
static void delay(uint32_t ms)
Arduino core delay override.
Definition: Module.cpp:384
Module::yield
static void yield()
Arduino core yield override.
Definition: Module.cpp:378
Module::digitalWrite
static void digitalWrite(RADIOLIB_PIN_TYPE pin, RADIOLIB_PIN_STATUS value)
Arduino core digitalWrite override that checks RADIOLIB_NC as alias for unused pin.
Definition: Module.cpp:326
Module::micros
static uint32_t micros()
Arduino core micros override.
Definition: Module.cpp:396
Module::getCs
RADIOLIB_PIN_TYPE getCs() const
Access method to get the pin number of SPI chip select.
Definition: Module.h:291
Module::SPIsetRegValue
int16_t SPIsetRegValue(uint8_t reg, uint8_t value, uint8_t msb=7, uint8_t lsb=0, uint8_t checkInterval=2, uint8_t checkMask=0xFF)
Overwrite-safe SPI write method with verification. This method is the preferred SPI write mechanism.
Definition: Module.cpp:206
Module::ATemptyBuffer
void ATemptyBuffer()
Empty internal AT buffer.
Definition: Module.cpp:149
Module::SPIwriteRegister
void SPIwriteRegister(uint8_t reg, uint8_t data)
SPI basic write method. Use of this method is reserved for special cases, SPIsetRegValue should be us...
Definition: Module.cpp:269
Module::term
void term(uint8_t interface)
Terminate low-level module control.
Definition: Module.cpp:132
Module::noTone
static void noTone(RADIOLIB_PIN_TYPE pin)
Arduino core noTone override that checks RADIOLIB_NC as alias for unused pin and RADIOLIB_TONE_UNSUPP...
Definition: Module.cpp:355
Module::setRfSwitchPins
void setRfSwitchPins(RADIOLIB_PIN_TYPE rxEn, RADIOLIB_PIN_TYPE txEn)
Some modules contain external RF switch controlled by two pins. This function gives RadioLib control ...
Definition: Module.cpp:415
Module::getTx
RADIOLIB_PIN_TYPE getTx() const
Access method to get the pin number of UART Rx.
Definition: Module.h:326
Module::getGpio
RADIOLIB_PIN_TYPE getGpio() const
Access method to get the pin number of second interrupt/GPIO.
Definition: Module.h:312
Module::flipBits16
static uint16_t flipBits16(uint16_t i)
Function to reflect bits within an integer.
Definition: Module.cpp:407
Module::SPIreadRegister
uint8_t SPIreadRegister(uint8_t reg)
SPI basic read method. Use of this method is reserved for special cases, SPIgetRegValue should be use...
Definition: Module.cpp:259
Module
Implements all common low-level SPI/UART methods to control the wireless module. Every module class c...
Definition: Module.h:17
Module::Module
Module(RADIOLIB_PIN_TYPE cs, RADIOLIB_PIN_TYPE irq, RADIOLIB_PIN_TYPE rst)
SPI-based module constructor. Will use the default SPI interface automatically initialize it.
Definition: Module.cpp:16
Module::operator=
Module & operator=(const Module &mod)
Overload for assignment operator.
Definition: Module.cpp:91
Module::init
void init(uint8_t interface)
Initialize low-level module control.
Definition: Module.cpp:108
Module::SPIreadCommand
uint8_t SPIreadCommand
Basic SPI read command. Defaults to 0x00.
Definition: Module.h:138
Module::detachInterrupt
static void detachInterrupt(RADIOLIB_PIN_TYPE interruptNum)
Arduino core detachInterrupt override.
Definition: Module.cpp:374
Module::getSpiSettings
SPISettings getSpiSettings() const
Access method to get the SPI interface settings.
Definition: Module.h:340
Module::setRfSwitchState
void setRfSwitchState(RADIOLIB_PIN_STATUS rxPinState, RADIOLIB_PIN_STATUS txPinState)
Set RF switch state.
Definition: Module.cpp:423
Module::SPIreadRegisterBurst
void SPIreadRegisterBurst(uint8_t reg, uint8_t numBytes, uint8_t *inBytes)
SPI burst read method.
Definition: Module.cpp:255
Module::tone
static void tone(RADIOLIB_PIN_TYPE pin, uint16_t value)
Arduino core tone override that checks RADIOLIB_NC as alias for unused pin and RADIOLIB_TONE_UNSUPPOR...
Definition: Module.cpp:339
Module::flipBits
static uint8_t flipBits(uint8_t b)
Function to reflect bits within a byte.
Definition: Module.cpp:400
SerialModule
Extension of Module class for UART-based modules, only exists to distinguish the UART constructor.
Definition: Module.h:497
Module::baudrate
uint32_t baudrate
Baud rate of SoftwareSerial UART communication. Defaults to 9600 baud.
Definition: Module.h:128
Module::millis
static uint32_t millis()
Arduino core millis override.
Definition: Module.cpp:392
Module::ATsendCommand
bool ATsendCommand(const char *cmd)
Send AT command. Will also call ATgetResponse.
Definition: Module.cpp:155
Module::delayMicroseconds
static void delayMicroseconds(uint32_t us)
Arduino core delayMicroseconds override.
Definition: Module.cpp:388
Module::attachInterrupt
static void attachInterrupt(RADIOLIB_PIN_TYPE interruptNum, void(*userFunc)(void), RADIOLIB_INTERRUPT_STATUS mode)
Arduino core attachInterrupt override.
Definition: Module.cpp:370
Module::SPIwriteRegisterBurst
void SPIwriteRegisterBurst(uint8_t reg, uint8_t *data, uint8_t numBytes)
SPI burst write method.
Definition: Module.cpp:265