RadioLib
Universal wireless communication library for Arduino
Hal.h
1 #if !defined(_RADIOLIB_HAL_H)
2 #define _RADIOLIB_HAL_H
3 
4 #include <stdint.h>
5 #include <stddef.h>
6 
7 #include "BuildOpt.h"
8 
9 // list of persistent parameters
10 #define RADIOLIB_PERSISTENT_PARAM_LORAWAN_DEV_NONCE_ID (0)
11 #define RADIOLIB_PERSISTENT_PARAM_LORAWAN_DEV_ADDR_ID (1)
12 #define RADIOLIB_PERSISTENT_PARAM_LORAWAN_FCNT_UP_ID (2)
13 #define RADIOLIB_PERSISTENT_PARAM_LORAWAN_MAGIC_ID (3)
14 #define RADIOLIB_PERSISTENT_PARAM_LORAWAN_APP_S_KEY_ID (4)
15 #define RADIOLIB_PERSISTENT_PARAM_LORAWAN_FNWK_SINT_KEY_ID (5)
16 #define RADIOLIB_PERSISTENT_PARAM_LORAWAN_SNWK_SINT_KEY_ID (6)
17 #define RADIOLIB_PERSISTENT_PARAM_LORAWAN_NWK_SENC_KEY_ID (7)
18 
19 static const uint32_t RadioLibPersistentParamTable[] = {
20  0x00, // RADIOLIB_PERSISTENT_PARAM_LORAWAN_DEV_NONCE_ID
21  0x04, // RADIOLIB_PERSISTENT_PARAM_LORAWAN_DEV_ADDR_ID
22  0x08, // RADIOLIB_PERSISTENT_PARAM_LORAWAN_FCNT_UP_ID
23  0x0C, // RADIOLIB_PERSISTENT_PARAM_LORAWAN_MAGIC_ID
24  0x10, // RADIOLIB_PERSISTENT_PARAM_LORAWAN_APP_S_KEY_ID
25  0x20, // RADIOLIB_PERSISTENT_PARAM_LORAWAN_FNWK_SINT_KEY_ID
26  0x30, // RADIOLIB_PERSISTENT_PARAM_LORAWAN_SNWK_SINT_KEY_ID
27  0x40, // RADIOLIB_PERSISTENT_PARAM_LORAWAN_NWK_SENC_KEY_ID
28  0x50, // end
29 };
30 
35 class RadioLibHal {
36  public:
37 
38  // values for pin modes, levels and change directions
39  // these tell RadioLib how are different logic states represented on a given platform
40 
44  const uint32_t GpioModeInput;
45 
49  const uint32_t GpioModeOutput;
50 
54  const uint32_t GpioLevelLow;
55 
59  const uint32_t GpioLevelHigh;
60 
64  const uint32_t GpioInterruptRising;
65 
69  const uint32_t GpioInterruptFalling;
70 
80  RadioLibHal(const uint32_t input, const uint32_t output, const uint32_t low, const uint32_t high, const uint32_t rising, const uint32_t falling);
81 
82  // pure virtual methods - these must be implemented by the hardware abstraction for RadioLib to function
83 
90  virtual void pinMode(uint32_t pin, uint32_t mode) = 0;
91 
98  virtual void digitalWrite(uint32_t pin, uint32_t value) = 0;
99 
106  virtual uint32_t digitalRead(uint32_t pin) = 0;
107 
115  virtual void attachInterrupt(uint32_t interruptNum, void (*interruptCb)(void), uint32_t mode) = 0;
116 
122  virtual void detachInterrupt(uint32_t interruptNum) = 0;
123 
129  virtual void delay(unsigned long ms) = 0;
130 
136  virtual void delayMicroseconds(unsigned long us) = 0;
137 
143  virtual unsigned long millis() = 0;
144 
150  virtual unsigned long micros() = 0;
151 
160  virtual long pulseIn(uint32_t pin, uint32_t state, unsigned long timeout) = 0;
161 
165  virtual void spiBegin() = 0;
166 
170  virtual void spiBeginTransaction() = 0;
171 
178  virtual void spiTransfer(uint8_t* out, size_t len, uint8_t* in) = 0;
179 
183  virtual void spiEndTransaction() = 0;
184 
188  virtual void spiEnd() = 0;
189 
190  // virtual methods - these may or may not exists on a given platform
191  // they exist in this implementation, but do nothing
192 
198  virtual void init();
199 
205  virtual void term();
206 
213  virtual void tone(uint32_t pin, unsigned int frequency, unsigned long duration = 0);
214 
219  virtual void noTone(uint32_t pin);
220 
224  virtual void yield();
225 
231  virtual uint32_t pinToInterrupt(uint32_t pin);
232 
239  virtual void readPersistentStorage(uint32_t addr, uint8_t* buff, size_t len);
240 
247  virtual void writePersistentStorage(uint32_t addr, uint8_t* buff, size_t len);
248 
253  void wipePersistentStorage();
254 
260  uint32_t getPersistentAddr(uint32_t id);
261 
269  template<typename T>
270  void setPersistentParameter(uint32_t id, T val);
271 
279  template<typename T>
280  T getPersistentParameter(uint32_t id);
281 };
282 
283 #endif
Hardware abstraction library base interface.
Definition: Hal.h:35
const uint32_t GpioInterruptFalling
Value to be used as the "falling" GPIO level change direction.
Definition: Hal.h:69
virtual uint32_t digitalRead(uint32_t pin)=0
Digital read method. Must be implemented by the platform-specific hardware abstraction!
const uint32_t GpioModeOutput
Value to be used as the "output" GPIO direction.
Definition: Hal.h:49
virtual void yield()
Yield method, called from long loops in multi-threaded environment (to prevent blocking other threads...
Definition: Hal.cpp:29
T getPersistentParameter(uint32_t id)
Method to get arbitrary parameter from persistent storage. This method DOES NOT perform any endiannes...
Definition: Hal.cpp:73
virtual unsigned long millis()=0
Get number of milliseconds since start. Must be implemented by the platform-specific hardware abstrac...
const uint32_t GpioModeInput
Value to be used as the "input" GPIO direction.
Definition: Hal.h:44
virtual void detachInterrupt(uint32_t interruptNum)=0
Method to detach function from an external interrupt. Must be implemented by the platform-specific ha...
virtual uint32_t pinToInterrupt(uint32_t pin)
Function to convert from pin number to interrupt number.
Definition: Hal.cpp:33
void setPersistentParameter(uint32_t id, T val)
Method to set arbitrary parameter to persistent storage. This method DOES NOT perform any endianness ...
Definition: Hal.cpp:63
virtual long pulseIn(uint32_t pin, uint32_t state, unsigned long timeout)=0
Measure the length of incoming digital pulse in microseconds. Must be implemented by the platform-spe...
const uint32_t GpioLevelLow
Value to be used as the "low" GPIO level.
Definition: Hal.h:54
const uint32_t GpioLevelHigh
Value to be used as the "high" GPIO level.
Definition: Hal.h:59
virtual void spiEnd()=0
SPI termination method.
virtual void init()
Module initialization method. This will be called by all radio modules at the beginning of startup....
Definition: Hal.cpp:11
virtual void readPersistentStorage(uint32_t addr, uint8_t *buff, size_t len)
Method to read from persistent storage (e.g. EEPROM).
Definition: Hal.cpp:37
virtual void digitalWrite(uint32_t pin, uint32_t value)=0
Digital write method. Must be implemented by the platform-specific hardware abstraction!
virtual void spiEndTransaction()=0
Method to end SPI transaction.
virtual void noTone(uint32_t pin)
Method to stop producing a tone.
Definition: Hal.cpp:25
const uint32_t GpioInterruptRising
Value to be used as the "rising" GPIO level change direction.
Definition: Hal.h:64
virtual void delay(unsigned long ms)=0
Blocking wait function. Must be implemented by the platform-specific hardware abstraction!
virtual void writePersistentStorage(uint32_t addr, uint8_t *buff, size_t len)
Method to write to persistent storage (e.g. EEPROM).
Definition: Hal.cpp:44
virtual void spiBegin()=0
SPI initialization method.
virtual void term()
Module termination method. This will be called by all radio modules when the destructor is called....
Definition: Hal.cpp:15
virtual void tone(uint32_t pin, unsigned int frequency, unsigned long duration=0)
Method to produce a square-wave with 50% duty cycle ("tone") of a given frequency at some pin.
Definition: Hal.cpp:19
virtual void spiBeginTransaction()=0
Method to start SPI transaction.
void wipePersistentStorage()
Method to wipe the persistent storage by writing to 0. Will write at most RADIOLIB_HAL_PERSISTENT_STO...
Definition: Hal.cpp:51
virtual void delayMicroseconds(unsigned long us)=0
Blocking microsecond wait function. Must be implemented by the platform-specific hardware abstraction...
RadioLibHal(const uint32_t input, const uint32_t output, const uint32_t low, const uint32_t high, const uint32_t rising, const uint32_t falling)
Default constructor.
Definition: Hal.cpp:3
uint32_t getPersistentAddr(uint32_t id)
Method to convert from persistent parameter ID to its physical address.
Definition: Hal.cpp:58
virtual void spiTransfer(uint8_t *out, size_t len, uint8_t *in)=0
Method to transfer buffer over SPI.
virtual unsigned long micros()=0
Get number of microseconds since start. Must be implemented by the platform-specific hardware abstrac...
virtual void pinMode(uint32_t pin, uint32_t mode)=0
GPIO pin mode (input/output/...) configuration method. Must be implemented by the platform-specific h...
virtual void attachInterrupt(uint32_t interruptNum, void(*interruptCb)(void), uint32_t mode)=0
Method to attach function to an external interrupt. Must be implemented by the platform-specific hard...