JunMo Hong / stm-spirit1-rf-driver_for_cubebite2

180718 HJM : 8 Count sensing data RF send, certTest, temp(cold)Test

Fork of EV-COG-AD3029LZ by JunMo Hong

stm-spirit1-rf-driver/SimpleSpirit1.h@83:54b207156a91, 2018-03-21 (annotated)

Committer:
jmhong
Date:
Wed Mar 21 05:06:08 2018 +0000
Revision:
83:54b207156a91
Parent:
82:a18c22d2b83a
Child:
84:45b9ff78a066
HJM : EV COG AD3029LZ test;

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Wolfgang Betz 34:edda6a7238ec 1 /*** Mbed Includes ***/
Wolfgang Betz 34:edda6a7238ec 2 #include "mbed.h"
Wolfgang Betz 34:edda6a7238ec 3 #include "mbed_debug.h"
Wolfgang Betz 34:edda6a7238ec 4
Wolfgang Betz 34:edda6a7238ec 5
Wolfgang Betz 34:edda6a7238ec 6 /*** Cube Includes ***/
Wolfgang Betz 34:edda6a7238ec 7 #include "SPIRIT_Radio.h"
Wolfgang Betz 34:edda6a7238ec 8 #include "SPIRIT_Management.h"
Wolfgang Betz 34:edda6a7238ec 9 #include "SPIRIT_Commands.h"
Wolfgang Betz 34:edda6a7238ec 10 #include "MCU_Interface.h"
Wolfgang Betz 34:edda6a7238ec 11
Wolfgang Betz 34:edda6a7238ec 12
Wolfgang Betz 34:edda6a7238ec 13 /*** Contiki Lib Includes ***/
Wolfgang Betz 34:edda6a7238ec 14 #include "spirit1.h"
Wolfgang Betz 34:edda6a7238ec 15 #include "spirit1-config.h"
Wolfgang Betz 34:edda6a7238ec 16 #include "spirit1-const.h"
Wolfgang Betz 34:edda6a7238ec 17
Wolfgang Betz 34:edda6a7238ec 18
Wolfgang Betz 34:edda6a7238ec 19 // betzw: enable beyond macro if you want debug messages also from IRQ handler
Wolfgang Betz 51:d46b4cc970c5 20 // #define DEBUG_IRQ
Wolfgang Betz 34:edda6a7238ec 21
Wolfgang Betz 34:edda6a7238ec 22
Wolfgang Betz 34:edda6a7238ec 23 /*** Macros from Cube Implementation ***/
Wolfgang Betz 34:edda6a7238ec 24 #define CLEAR_TXBUF() (spirit_tx_len = 0)
Wolfgang Betz 34:edda6a7238ec 25 #define IS_RXBUF_EMPTY() (spirit_rx_len == 0)
Wolfgang Betz 34:edda6a7238ec 26 #define CLEAR_RXBUF() do { \
Wolfgang Betz 34:edda6a7238ec 27 spirit_rx_len = 0; \
Wolfgang Betz 34:edda6a7238ec 28 _spirit_rx_pos = 0; \
Wolfgang Betz 34:edda6a7238ec 29 } while(0)
Wolfgang Betz 34:edda6a7238ec 30
Wolfgang Betz 34:edda6a7238ec 31
Wolfgang Betz 34:edda6a7238ec 32 /*** Macros from Cube Implementation ***/
Wolfgang Betz 34:edda6a7238ec 33 /* transceiver state. */
Wolfgang Betz 34:edda6a7238ec 34 #define ON 0
Wolfgang Betz 34:edda6a7238ec 35 #define OFF 1
Wolfgang Betz 34:edda6a7238ec 36
Wolfgang Betz 34:edda6a7238ec 37
Wolfgang Betz 72:413cb97ac077 38 /*** Macros for Spirit1 API ***/
Wolfgang Betz 72:413cb97ac077 39 /* max payload */
Wolfgang Betz 72:413cb97ac077 40 #define SPIRIT1_MAX_PAYLOAD (MAX_PACKET_LEN)
Wolfgang Betz 72:413cb97ac077 41
Wolfgang Betz 72:413cb97ac077 42
Wolfgang Betz 34:edda6a7238ec 43 /*** Missing Cube External Declarations ***/
Wolfgang Betz 34:edda6a7238ec 44 extern "C" void SpiritManagementSetFrequencyBase(uint32_t);
Wolfgang Betz 34:edda6a7238ec 45
Wolfgang Betz 34:edda6a7238ec 46
Wolfgang Betz 57:8cc871dc6cac 47 /*** UnlockedSPI for Usage in IRQ context ***/
Wolfgang Betz 34:edda6a7238ec 48 class UnlockedSPI : public SPI {
Wolfgang Betz 34:edda6a7238ec 49 public:
Wolfgang Betz 34:edda6a7238ec 50 UnlockedSPI(PinName mosi, PinName miso, PinName sclk) :
Wolfgang Betz 34:edda6a7238ec 51 SPI(mosi, miso, sclk) { }
Wolfgang Betz 34:edda6a7238ec 52 virtual ~UnlockedSPI() {}
Wolfgang Betz 34:edda6a7238ec 53 virtual void lock() { }
Wolfgang Betz 34:edda6a7238ec 54 virtual void unlock() { }
Wolfgang Betz 34:edda6a7238ec 55 };
Wolfgang Betz 34:edda6a7238ec 56
Wolfgang Betz 34:edda6a7238ec 57
Wolfgang Betz 34:edda6a7238ec 58 /*** A Simple Spirit1 Class ***/
Wolfgang Betz 34:edda6a7238ec 59 // NOTE: must be a singleton (due to mix of MBED/CUBE code)!!!
Wolfgang Betz 34:edda6a7238ec 60 // NOTE: implementation is IRQ-save but (intentionally) NOT thread-safe!!!
Wolfgang Betz 73:a1342eb7974c 61 /** Simple Spirit1 Class
Wolfgang Betz 73:a1342eb7974c 62 *
Wolfgang Betz 73:a1342eb7974c 63 * @Note Synchronization level: implementation is IRQ-save but (intentionally) NOT thread-safe!!!
Wolfgang Betz 73:a1342eb7974c 64 *
Wolfgang Betz 73:a1342eb7974c 65 * Example:
Wolfgang Betz 73:a1342eb7974c 66 * @code
Wolfgang Betz 73:a1342eb7974c 67 * #include "mbed.h"
Wolfgang Betz 73:a1342eb7974c 68 * #include "SimpleSpirit1.h"
Wolfgang Betz 73:a1342eb7974c 69 *
Wolfgang Betz 74:7672516efa2a 70 * static char send_buf[] = "Hello World!";
Wolfgang Betz 73:a1342eb7974c 71 *
Wolfgang Betz 73:a1342eb7974c 72 * static SimpleSpirit1 &myspirit = SimpleSpirit1::CreateInstance(D11, D12, D3, D9, D10, D2);
Wolfgang Betz 73:a1342eb7974c 73 *
Wolfgang Betz 73:a1342eb7974c 74 * static volatile bool tx_done_flag = false;
Wolfgang Betz 73:a1342eb7974c 75 *
Wolfgang Betz 73:a1342eb7974c 76 * static void callback_func(int event)
Wolfgang Betz 73:a1342eb7974c 77 * {
Wolfgang Betz 73:a1342eb7974c 78 * if (event == SimpleSpirit1::TX_DONE) {
Wolfgang Betz 73:a1342eb7974c 79 * tx_done_flag = true;
Wolfgang Betz 73:a1342eb7974c 80 * }
Wolfgang Betz 73:a1342eb7974c 81 * }
Wolfgang Betz 73:a1342eb7974c 82 *
Wolfgang Betz 73:a1342eb7974c 83 * int main()
Wolfgang Betz 73:a1342eb7974c 84 * {
Wolfgang Betz 74:7672516efa2a 85 * myspirit.attach_irq_callback(callback_func);
Wolfgang Betz 73:a1342eb7974c 86 * myspirit.on();
Wolfgang Betz 73:a1342eb7974c 87 *
Wolfgang Betz 73:a1342eb7974c 88 * while(1)
Wolfgang Betz 73:a1342eb7974c 89 * {
Wolfgang Betz 73:a1342eb7974c 90 * size_t curr_len = strlen((const char*)send_buf);
Wolfgang Betz 73:a1342eb7974c 91 * myspirit.send(send_buf, curr_len);
Wolfgang Betz 73:a1342eb7974c 92 *
Wolfgang Betz 73:a1342eb7974c 93 * while(!tx_done_flag);
Wolfgang Betz 73:a1342eb7974c 94 * tx_done_flag = false;
Wolfgang Betz 73:a1342eb7974c 95 * }
Wolfgang Betz 73:a1342eb7974c 96 * }
Wolfgang Betz 73:a1342eb7974c 97 * @endcode
Wolfgang Betz 73:a1342eb7974c 98 */
Wolfgang Betz 34:edda6a7238ec 99 class SimpleSpirit1 {
Wolfgang Betz 34:edda6a7238ec 100 protected:
Wolfgang Betz 34:edda6a7238ec 101 static SimpleSpirit1 *_singleton;
Wolfgang Betz 34:edda6a7238ec 102
Wolfgang Betz 34:edda6a7238ec 103 /** Communication Interface Instance Variables **/
Wolfgang Betz 37:bc043030b55a 104 UnlockedSPI _spi; // betzw - NOTE: Morpho/Zio pins are valid only for NUCLEO-F401RE
Wolfgang Betz 34:edda6a7238ec 105 // mosi: PA_7 (D11)
Wolfgang Betz 34:edda6a7238ec 106 // miso: PA_6 (D12)
Wolfgang Betz 34:edda6a7238ec 107 // sclk: PB_3 (D3) or
Wolfgang Betz 34:edda6a7238ec 108 // PA_5 (D13) (only in case you unmount R4 & mount R7,
Wolfgang Betz 34:edda6a7238ec 109 // (note: in this case you may not use LED1 on some platforms)
Wolfgang Betz 34:edda6a7238ec 110 // bits: 8-bit
Wolfgang Betz 34:edda6a7238ec 111 // mode: 0
Wolfgang Betz 34:edda6a7238ec 112 // ordr: MSB
Wolfgang Betz 34:edda6a7238ec 113 // freq: max 10MHz
Wolfgang Betz 34:edda6a7238ec 114 InterruptIn _irq; // PC_7 (D9) (falling)
Wolfgang Betz 34:edda6a7238ec 115 DigitalOut _chip_select; // PB_6 (D10) ('1' == chip unselected)
Wolfgang Betz 34:edda6a7238ec 116 DigitalOut _shut_down; // PA_10 (D2) ('1' == shut_down)
Wolfgang Betz 34:edda6a7238ec 117 DigitalOut _led; // PB_4 (D5) (optional)
Wolfgang Betz 34:edda6a7238ec 118
Wolfgang Betz 34:edda6a7238ec 119 Callback<void(int)> _current_irq_callback;
Wolfgang Betz 34:edda6a7238ec 120 Timeout _rx_receiving_timeout;
Wolfgang Betz 34:edda6a7238ec 121
Wolfgang Betz 34:edda6a7238ec 122 void rx_timeout_handler(void) {
Wolfgang Betz 34:edda6a7238ec 123 set_ready_state();
Wolfgang Betz 34:edda6a7238ec 124 cmd_strobe(SPIRIT1_STROBE_RX);
Wolfgang Betz 34:edda6a7238ec 125 #ifdef DEBUG_IRQ
Wolfgang Betz 68:247fd6e0ab66 126 debug("\r\n%s (%d)\r\n", __func__, __LINE__);
Wolfgang Betz 34:edda6a7238ec 127 #endif
Wolfgang Betz 34:edda6a7238ec 128 }
Wolfgang Betz 34:edda6a7238ec 129
Wolfgang Betz 34:edda6a7238ec 130 void start_rx_timeout(void) {
Wolfgang Betz 37:bc043030b55a 131 _rx_receiving_timeout.attach_us(Callback<void()>(this, &SimpleSpirit1::rx_timeout_handler), 100 * 1000); // 100ms
Wolfgang Betz 34:edda6a7238ec 132 }
Wolfgang Betz 34:edda6a7238ec 133
Wolfgang Betz 34:edda6a7238ec 134 void stop_rx_timeout(void) {
Wolfgang Betz 34:edda6a7238ec 135 _rx_receiving_timeout.detach();
Wolfgang Betz 34:edda6a7238ec 136 }
Wolfgang Betz 34:edda6a7238ec 137
Wolfgang Betz 34:edda6a7238ec 138 /** Static Variables from Cube Implementation **/
Wolfgang Betz 34:edda6a7238ec 139 /*
Wolfgang Betz 34:edda6a7238ec 140 * The buffers which hold incoming data.
Wolfgang Betz 34:edda6a7238ec 141 * The +1 because of the first byte,
Wolfgang Betz 34:edda6a7238ec 142 * which will contain the length of the packet.
Wolfgang Betz 34:edda6a7238ec 143 */
Wolfgang Betz 34:edda6a7238ec 144 volatile uint16_t spirit_tx_len;
Wolfgang Betz 34:edda6a7238ec 145 volatile bool _spirit_tx_started;
Wolfgang Betz 34:edda6a7238ec 146 volatile uint16_t spirit_rx_len;
Wolfgang Betz 34:edda6a7238ec 147 volatile uint16_t _spirit_rx_pos;
Wolfgang Betz 34:edda6a7238ec 148 volatile bool _spirit_rx_err;
Wolfgang Betz 34:edda6a7238ec 149 uint8_t spirit_rx_buf[MAX_PACKET_LEN];
Wolfgang Betz 34:edda6a7238ec 150 volatile bool _is_receiving;
Wolfgang Betz 34:edda6a7238ec 151
Wolfgang Betz 34:edda6a7238ec 152 /** Status Variables from Cube Implementation **/
Wolfgang Betz 34:edda6a7238ec 153 unsigned int spirit_on;
Wolfgang Betz 34:edda6a7238ec 154 uint8_t last_rssi; //MGR
Wolfgang Betz 34:edda6a7238ec 155 uint8_t last_sqi; //MGR
Wolfgang Betz 34:edda6a7238ec 156
Wolfgang Betz 34:edda6a7238ec 157 /** Low Level Instance Variables **/
Wolfgang Betz 34:edda6a7238ec 158 unsigned int _nr_of_irq_disables;
Wolfgang Betz 34:edda6a7238ec 159
Wolfgang Betz 34:edda6a7238ec 160 /** Low Level Instance Methods **/
jmhong 83:54b207156a91 161 void disable_spirit_irq(void)
jmhong 83:54b207156a91 162 {
Wolfgang Betz 34:edda6a7238ec 163 _irq.disable_irq();
Wolfgang Betz 34:edda6a7238ec 164 _nr_of_irq_disables++;
Wolfgang Betz 34:edda6a7238ec 165 #ifndef NDEBUG
Wolfgang Betz 68:247fd6e0ab66 166 debug_if(_nr_of_irq_disables == 0, "\r\nassert failed in: %s (%d)\r\n", __func__, __LINE__);
Wolfgang Betz 34:edda6a7238ec 167 #endif
Wolfgang Betz 34:edda6a7238ec 168 }
Wolfgang Betz 34:edda6a7238ec 169
Wolfgang Betz 34:edda6a7238ec 170 void enable_spirit_irq(void) {
Wolfgang Betz 34:edda6a7238ec 171 #ifndef NDEBUG
Wolfgang Betz 68:247fd6e0ab66 172 debug_if(_nr_of_irq_disables == 0, "\r\nassert failed in: %s (%d)\r\n", __func__, __LINE__);
Wolfgang Betz 34:edda6a7238ec 173 #endif
Wolfgang Betz 34:edda6a7238ec 174 if(--_nr_of_irq_disables == 0)
Wolfgang Betz 34:edda6a7238ec 175 _irq.enable_irq();
Wolfgang Betz 34:edda6a7238ec 176 }
Wolfgang Betz 34:edda6a7238ec 177
Wolfgang Betz 34:edda6a7238ec 178 void chip_select() { _chip_select = 0; }
Wolfgang Betz 34:edda6a7238ec 179 void chip_unselect() { _chip_select = 1; }
Wolfgang Betz 34:edda6a7238ec 180
Wolfgang Betz 34:edda6a7238ec 181 void enter_shutdown() {
Wolfgang Betz 34:edda6a7238ec 182 _shut_down = 1;
Wolfgang Betz 34:edda6a7238ec 183 wait_ms(5); // wait 5 milliseconds (to allow Spirit1 to shut down)
Wolfgang Betz 34:edda6a7238ec 184 }
Wolfgang Betz 34:edda6a7238ec 185
Wolfgang Betz 34:edda6a7238ec 186 void exit_shutdown() {
Wolfgang Betz 34:edda6a7238ec 187 _shut_down = 0;
Wolfgang Betz 34:edda6a7238ec 188 wait_ms(10); // wait 10 milliseconds (to allow Spirit1 a proper boot-up sequence)
Wolfgang Betz 34:edda6a7238ec 189 }
Wolfgang Betz 34:edda6a7238ec 190
Wolfgang Betz 34:edda6a7238ec 191 void cs_to_sclk_delay(void) {
Wolfgang Betz 34:edda6a7238ec 192 wait_us(1); // heuristic value
Wolfgang Betz 34:edda6a7238ec 193 }
Wolfgang Betz 34:edda6a7238ec 194
Wolfgang Betz 34:edda6a7238ec 195 /**
Wolfgang Betz 34:edda6a7238ec 196 * @brief Write and read a buffer to/from the SPI peripheral device at the same time
Wolfgang Betz 34:edda6a7238ec 197 * in 8-bit data mode using synchronous SPI communication.
Wolfgang Betz 34:edda6a7238ec 198 * @param[in] pBufferToWrite pointer to the buffer of data to send.
Wolfgang Betz 34:edda6a7238ec 199 * @param[out] pBufferToRead pointer to the buffer to read data into.
Wolfgang Betz 34:edda6a7238ec 200 * @param[in] NumBytes number of bytes to read and write.
Wolfgang Betz 34:edda6a7238ec 201 * @retval 0 if ok.
Wolfgang Betz 34:edda6a7238ec 202 * @retval -1 if data format error.
Wolfgang Betz 34:edda6a7238ec 203 * @note When using the SPI in Interrupt-mode, remember to disable interrupts
Wolfgang Betz 34:edda6a7238ec 204 * before calling this function and to enable them again after.
Wolfgang Betz 34:edda6a7238ec 205 */
Wolfgang Betz 34:edda6a7238ec 206 void spi_write_read(uint8_t* pBufferToWrite, uint8_t* pBufferToRead, uint16_t NumBytes)
Wolfgang Betz 34:edda6a7238ec 207 {
Wolfgang Betz 34:edda6a7238ec 208 /* Read and write data at the same time. */
Wolfgang Betz 34:edda6a7238ec 209 for (int i = 0; i < NumBytes; i++) {
Wolfgang Betz 34:edda6a7238ec 210 pBufferToRead[i] = _spi.write(pBufferToWrite[i]);
Wolfgang Betz 34:edda6a7238ec 211 }
Wolfgang Betz 34:edda6a7238ec 212 }
Wolfgang Betz 34:edda6a7238ec 213
Wolfgang Betz 34:edda6a7238ec 214 /** Radio Instance Methods **/
Wolfgang Betz 34:edda6a7238ec 215 void radio_set_xtal_freq(uint32_t freq) {
Wolfgang Betz 34:edda6a7238ec 216 SpiritRadioSetXtalFrequency(freq);
Wolfgang Betz 34:edda6a7238ec 217 }
Wolfgang Betz 34:edda6a7238ec 218
Wolfgang Betz 34:edda6a7238ec 219 void radio_set_pa_level_dbm(uint8_t cIndex, float fPowerdBm) {
Wolfgang Betz 34:edda6a7238ec 220 SpiritRadioSetPALeveldBm(cIndex, fPowerdBm);
Wolfgang Betz 34:edda6a7238ec 221 }
Wolfgang Betz 34:edda6a7238ec 222
Wolfgang Betz 34:edda6a7238ec 223 void radio_set_pa_level_max_index(uint8_t cIndex) {
Wolfgang Betz 34:edda6a7238ec 224 SpiritRadioSetPALevelMaxIndex(cIndex);
Wolfgang Betz 34:edda6a7238ec 225 }
Wolfgang Betz 34:edda6a7238ec 226
Wolfgang Betz 34:edda6a7238ec 227 uint8_t radio_init(SRadioInit *init_struct) {
Wolfgang Betz 34:edda6a7238ec 228 return SpiritRadioInit(init_struct);
Wolfgang Betz 34:edda6a7238ec 229 }
Wolfgang Betz 34:edda6a7238ec 230
Wolfgang Betz 34:edda6a7238ec 231 void radio_persistent_rx(SpiritFunctionalState xNewState) {
Wolfgang Betz 34:edda6a7238ec 232 SpiritRadioPersistenRx(xNewState);
Wolfgang Betz 34:edda6a7238ec 233 }
Wolfgang Betz 34:edda6a7238ec 234
Wolfgang Betz 34:edda6a7238ec 235 void radio_afc_freeze_on_sync(SpiritFunctionalState xNewState) {
Wolfgang Betz 34:edda6a7238ec 236 SpiritRadioAFCFreezeOnSync(xNewState);
Wolfgang Betz 34:edda6a7238ec 237 }
Wolfgang Betz 34:edda6a7238ec 238
Wolfgang Betz 34:edda6a7238ec 239 /** Packet System Instance Methods **/
Wolfgang Betz 34:edda6a7238ec 240 void pkt_basic_init(PktBasicInit* pxPktBasicInit) {
Wolfgang Betz 34:edda6a7238ec 241 SpiritPktBasicInit(pxPktBasicInit);
Wolfgang Betz 34:edda6a7238ec 242 }
Wolfgang Betz 34:edda6a7238ec 243
Wolfgang Betz 34:edda6a7238ec 244 void pkt_basic_set_payload_length(uint16_t nPayloadLength) {
Wolfgang Betz 34:edda6a7238ec 245 SpiritPktBasicSetPayloadLength(nPayloadLength);
Wolfgang Betz 34:edda6a7238ec 246 }
Wolfgang Betz 34:edda6a7238ec 247
Wolfgang Betz 34:edda6a7238ec 248 uint16_t pkt_basic_get_received_pkt_length(void) {
Wolfgang Betz 34:edda6a7238ec 249 return SpiritPktBasicGetReceivedPktLength();
Wolfgang Betz 34:edda6a7238ec 250 }
Wolfgang Betz 34:edda6a7238ec 251
Wolfgang Betz 34:edda6a7238ec 252 /** IRQ Instance Methods **/
Wolfgang Betz 34:edda6a7238ec 253 void irq_de_init(SpiritIrqs* pxIrqInit) {
Wolfgang Betz 34:edda6a7238ec 254 SpiritIrqDeInit(pxIrqInit);
Wolfgang Betz 34:edda6a7238ec 255 }
Wolfgang Betz 34:edda6a7238ec 256
Wolfgang Betz 34:edda6a7238ec 257 void irq_clear_status(void) {
Wolfgang Betz 34:edda6a7238ec 258 SpiritIrqClearStatus();
Wolfgang Betz 34:edda6a7238ec 259 }
Wolfgang Betz 34:edda6a7238ec 260
Wolfgang Betz 34:edda6a7238ec 261 void irq_set_status(IrqList xIrq, SpiritFunctionalState xNewState) {
Wolfgang Betz 34:edda6a7238ec 262 SpiritIrq(xIrq, xNewState);
Wolfgang Betz 34:edda6a7238ec 263 }
Wolfgang Betz 34:edda6a7238ec 264
Wolfgang Betz 34:edda6a7238ec 265 void irq_get_status(SpiritIrqs* pxIrqStatus) {
Wolfgang Betz 34:edda6a7238ec 266 SpiritIrqGetStatus(pxIrqStatus);
Wolfgang Betz 34:edda6a7238ec 267 }
Wolfgang Betz 34:edda6a7238ec 268
Wolfgang Betz 34:edda6a7238ec 269 /** Management Instance Methods **/
Wolfgang Betz 34:edda6a7238ec 270 void mgmt_set_freq_base(uint32_t freq) {
Wolfgang Betz 34:edda6a7238ec 271 SpiritManagementSetFrequencyBase(freq);
Wolfgang Betz 34:edda6a7238ec 272 }
Wolfgang Betz 34:edda6a7238ec 273
Wolfgang Betz 34:edda6a7238ec 274 void mgmt_refresh_status(void) {
Wolfgang Betz 34:edda6a7238ec 275 SpiritRefreshStatus();
Wolfgang Betz 34:edda6a7238ec 276 }
Wolfgang Betz 34:edda6a7238ec 277
Wolfgang Betz 34:edda6a7238ec 278 /** Spirit GPIO Instance Methods **/
Wolfgang Betz 34:edda6a7238ec 279 void spirit_gpio_init(SGpioInit* pxGpioInitStruct) {
Wolfgang Betz 34:edda6a7238ec 280 SpiritGpioInit(pxGpioInitStruct);
Wolfgang Betz 34:edda6a7238ec 281 }
Wolfgang Betz 34:edda6a7238ec 282
Wolfgang Betz 34:edda6a7238ec 283 /** Qi Instance Methods **/
Wolfgang Betz 34:edda6a7238ec 284 void qi_set_sqi_threshold(SqiThreshold xSqiThr) {
Wolfgang Betz 34:edda6a7238ec 285 SpiritQiSetSqiThreshold(xSqiThr);
Wolfgang Betz 34:edda6a7238ec 286 }
Wolfgang Betz 34:edda6a7238ec 287
Wolfgang Betz 34:edda6a7238ec 288 void qi_sqi_check(SpiritFunctionalState xNewState) {
Wolfgang Betz 34:edda6a7238ec 289 SpiritQiSqiCheck(xNewState);
Wolfgang Betz 34:edda6a7238ec 290 }
Wolfgang Betz 34:edda6a7238ec 291
Wolfgang Betz 34:edda6a7238ec 292 void qi_set_rssi_threshold_dbm(int nDbmValue) {
Wolfgang Betz 34:edda6a7238ec 293 SpiritQiSetRssiThresholddBm(nDbmValue);
Wolfgang Betz 34:edda6a7238ec 294 }
Wolfgang Betz 34:edda6a7238ec 295
Wolfgang Betz 34:edda6a7238ec 296 float qi_get_rssi_dbm() {
Wolfgang Betz 34:edda6a7238ec 297 last_rssi = qi_get_rssi();
Wolfgang Betz 34:edda6a7238ec 298 return get_last_rssi_dbm();
Wolfgang Betz 34:edda6a7238ec 299 }
Wolfgang Betz 34:edda6a7238ec 300
Wolfgang Betz 34:edda6a7238ec 301 uint8_t qi_get_rssi() {
Wolfgang Betz 34:edda6a7238ec 302 return SpiritQiGetRssi();
Wolfgang Betz 34:edda6a7238ec 303 }
Wolfgang Betz 34:edda6a7238ec 304
Wolfgang Betz 34:edda6a7238ec 305 uint8_t qi_get_sqi() {
Wolfgang Betz 34:edda6a7238ec 306 return SpiritQiGetSqi();
Wolfgang Betz 34:edda6a7238ec 307 }
Wolfgang Betz 34:edda6a7238ec 308
Wolfgang Betz 34:edda6a7238ec 309 /** Timer Instance Methods **/
Wolfgang Betz 34:edda6a7238ec 310 void timer_set_rx_timeout_stop_condition(RxTimeoutStopCondition xStopCondition) {
Wolfgang Betz 34:edda6a7238ec 311 SpiritTimerSetRxTimeoutStopCondition(xStopCondition);
Wolfgang Betz 34:edda6a7238ec 312 }
Wolfgang Betz 34:edda6a7238ec 313
Wolfgang Betz 34:edda6a7238ec 314 void timer_set_rx_timeout_counter(uint8_t cCounter) {
Wolfgang Betz 34:edda6a7238ec 315 SpiritTimerSetRxTimeoutCounter(cCounter);
Wolfgang Betz 34:edda6a7238ec 316 }
Wolfgang Betz 34:edda6a7238ec 317
Wolfgang Betz 34:edda6a7238ec 318 void timer_set_infinite_rx_timeout(void) {
Wolfgang Betz 34:edda6a7238ec 319 timer_set_rx_timeout_counter(0);
Wolfgang Betz 34:edda6a7238ec 320 }
Wolfgang Betz 34:edda6a7238ec 321
Wolfgang Betz 34:edda6a7238ec 322 /** CSMA/CA Instance Methods **/
Wolfgang Betz 34:edda6a7238ec 323 void csma_ca_state(SpiritFunctionalState xNewState) {
Wolfgang Betz 34:edda6a7238ec 324 SpiritCsma(xNewState);
Wolfgang Betz 34:edda6a7238ec 325 }
Wolfgang Betz 34:edda6a7238ec 326
Wolfgang Betz 34:edda6a7238ec 327 void csma_ca_init(CsmaInit* pxCsmaInit) {
Wolfgang Betz 34:edda6a7238ec 328 csma_ca_state(S_DISABLE); // Disabled at init
Wolfgang Betz 34:edda6a7238ec 329 SpiritCsmaInit(pxCsmaInit);
Wolfgang Betz 34:edda6a7238ec 330 SpiritCsmaSeedReloadMode(S_DISABLE); // always disable seed reload
Wolfgang Betz 34:edda6a7238ec 331 }
Wolfgang Betz 34:edda6a7238ec 332
Wolfgang Betz 34:edda6a7238ec 333 /** Command Instance Methods**/
Wolfgang Betz 34:edda6a7238ec 334 void cmd_strobe(uint8_t cmd) {
Wolfgang Betz 34:edda6a7238ec 335 SpiritCmdStrobeCommand((SpiritCmd)cmd);
Wolfgang Betz 34:edda6a7238ec 336 }
Wolfgang Betz 34:edda6a7238ec 337
Wolfgang Betz 34:edda6a7238ec 338 void cmd_strobe_flush_rx_fifo() {
Wolfgang Betz 34:edda6a7238ec 339 SpiritCmdStrobeCommand(CMD_FLUSHRXFIFO);
Wolfgang Betz 34:edda6a7238ec 340 }
Wolfgang Betz 34:edda6a7238ec 341
Wolfgang Betz 34:edda6a7238ec 342 /** SPI Instance Methods **/
Wolfgang Betz 34:edda6a7238ec 343 StatusBytes spi_write_linear_fifo(uint8_t cNbBytes, uint8_t* pcBuffer) {
Wolfgang Betz 34:edda6a7238ec 344 return SdkEvalSpiWriteFifo(cNbBytes, pcBuffer);
Wolfgang Betz 34:edda6a7238ec 345 }
Wolfgang Betz 34:edda6a7238ec 346
Wolfgang Betz 34:edda6a7238ec 347 StatusBytes spi_read_linear_fifo(uint8_t cNbBytes, uint8_t* pcBuffer) {
Wolfgang Betz 34:edda6a7238ec 348 return SdkEvalSpiReadFifo(cNbBytes, pcBuffer);
Wolfgang Betz 34:edda6a7238ec 349 }
Wolfgang Betz 34:edda6a7238ec 350
Wolfgang Betz 34:edda6a7238ec 351 /** Linear FIFO Instance Methods **/
Wolfgang Betz 34:edda6a7238ec 352 uint8_t linear_fifo_read_num_elements_rx_fifo(void) {
Wolfgang Betz 34:edda6a7238ec 353 return SpiritLinearFifoReadNumElementsRxFifo();
Wolfgang Betz 34:edda6a7238ec 354 }
Wolfgang Betz 34:edda6a7238ec 355
Wolfgang Betz 34:edda6a7238ec 356 uint8_t linear_fifo_read_num_elements_tx_fifo(void) {
Wolfgang Betz 34:edda6a7238ec 357 return SpiritLinearFifoReadNumElementsTxFifo();
Wolfgang Betz 34:edda6a7238ec 358 }
Wolfgang Betz 34:edda6a7238ec 359
Wolfgang Betz 34:edda6a7238ec 360 void linear_fifo_set_almost_full_thr_rx(uint8_t cThrRxFifo) {
Wolfgang Betz 34:edda6a7238ec 361 SpiritLinearFifoSetAlmostFullThresholdRx(cThrRxFifo);
Wolfgang Betz 34:edda6a7238ec 362 }
Wolfgang Betz 34:edda6a7238ec 363
Wolfgang Betz 34:edda6a7238ec 364 /** Calibration Instance Methods **/
Wolfgang Betz 34:edda6a7238ec 365 void calibration_rco(SpiritFunctionalState xNewState) {
Wolfgang Betz 34:edda6a7238ec 366 SpiritCalibrationRco(xNewState);
Wolfgang Betz 34:edda6a7238ec 367 }
Wolfgang Betz 34:edda6a7238ec 368
Wolfgang Betz 34:edda6a7238ec 369 /** Internal Spirit Methods */
Wolfgang Betz 34:edda6a7238ec 370 void set_ready_state(void);
Wolfgang Betz 34:edda6a7238ec 371 uint8_t refresh_state(void);
Wolfgang Betz 34:edda6a7238ec 372
Wolfgang Betz 34:edda6a7238ec 373 /** Friend Functions **/
Wolfgang Betz 34:edda6a7238ec 374 friend StatusBytes SdkEvalSpiWriteRegisters(uint8_t cRegAddress, uint8_t cNbBytes, uint8_t* pcBuffer);
Wolfgang Betz 34:edda6a7238ec 375 friend StatusBytes SdkEvalSpiReadRegisters(uint8_t cRegAddress, uint8_t cNbBytes, uint8_t* pcBuffer);
Wolfgang Betz 34:edda6a7238ec 376 friend StatusBytes SdkEvalSpiCommandStrobes(uint8_t cCommandCode);
Wolfgang Betz 34:edda6a7238ec 377 friend StatusBytes SdkEvalSpiWriteFifo(uint8_t cNbBytes, uint8_t* pcBuffer);
Wolfgang Betz 34:edda6a7238ec 378 friend StatusBytes SdkEvalSpiReadFifo(uint8_t cNbBytes, uint8_t* pcBuffer);
Wolfgang Betz 34:edda6a7238ec 379
Wolfgang Betz 34:edda6a7238ec 380 /** Sdk Instance Methods **/
Wolfgang Betz 34:edda6a7238ec 381 StatusBytes SdkEvalSpiWriteRegisters(uint8_t cRegAddress, uint8_t cNbBytes, uint8_t* pcBuffer);
Wolfgang Betz 34:edda6a7238ec 382 StatusBytes SdkEvalSpiReadRegisters(uint8_t cRegAddress, uint8_t cNbBytes, uint8_t* pcBuffer);
Wolfgang Betz 34:edda6a7238ec 383 StatusBytes SdkEvalSpiCommandStrobes(uint8_t cCommandCode);
Wolfgang Betz 34:edda6a7238ec 384 StatusBytes SdkEvalSpiWriteFifo(uint8_t cNbBytes, uint8_t* pcBuffer);
Wolfgang Betz 34:edda6a7238ec 385 StatusBytes SdkEvalSpiReadFifo(uint8_t cNbBytes, uint8_t* pcBuffer);
Wolfgang Betz 34:edda6a7238ec 386
Wolfgang Betz 34:edda6a7238ec 387 /** Helper Instance Methods **/
Wolfgang Betz 34:edda6a7238ec 388 void chip_sync_select() {
Wolfgang Betz 34:edda6a7238ec 389 disable_spirit_irq();
Wolfgang Betz 34:edda6a7238ec 390 chip_select();
Wolfgang Betz 34:edda6a7238ec 391 cs_to_sclk_delay();
Wolfgang Betz 34:edda6a7238ec 392 }
Wolfgang Betz 34:edda6a7238ec 393
Wolfgang Betz 34:edda6a7238ec 394 void chip_sync_unselect() {
Wolfgang Betz 34:edda6a7238ec 395 chip_unselect();
Wolfgang Betz 34:edda6a7238ec 396 enable_spirit_irq();
Wolfgang Betz 34:edda6a7238ec 397 }
Wolfgang Betz 34:edda6a7238ec 398
Wolfgang Betz 34:edda6a7238ec 399 /** Init Instance Method **/
Wolfgang Betz 34:edda6a7238ec 400 void init();
Wolfgang Betz 34:edda6a7238ec 401
Wolfgang Betz 34:edda6a7238ec 402 /** Spirit Irq Callback */
Wolfgang Betz 34:edda6a7238ec 403 void IrqHandler();
Wolfgang Betz 34:edda6a7238ec 404
Wolfgang Betz 34:edda6a7238ec 405 /** Constructor **/
Wolfgang Betz 34:edda6a7238ec 406 SimpleSpirit1(PinName mosi, PinName miso, PinName sclk,
Wolfgang Betz 34:edda6a7238ec 407 PinName irq, PinName cs, PinName sdn,
Wolfgang Betz 34:edda6a7238ec 408 PinName led);
Wolfgang Betz 34:edda6a7238ec 409
Wolfgang Betz 34:edda6a7238ec 410 /** Destructor **/
Wolfgang Betz 34:edda6a7238ec 411 ~SimpleSpirit1(void); // should never be called!
Wolfgang Betz 34:edda6a7238ec 412
Wolfgang Betz 34:edda6a7238ec 413 public:
Wolfgang Betz 34:edda6a7238ec 414 enum {
Wolfgang Betz 34:edda6a7238ec 415 RX_DONE,
Wolfgang Betz 34:edda6a7238ec 416 TX_DONE,
Wolfgang Betz 34:edda6a7238ec 417 TX_ERR
Wolfgang Betz 34:edda6a7238ec 418 };
Wolfgang Betz 34:edda6a7238ec 419
Wolfgang Betz 72:413cb97ac077 420 /** Create singleton instance of 'SimpleSpirit1'
Wolfgang Betz 72:413cb97ac077 421 *
Wolfgang Betz 72:413cb97ac077 422 * @param mosi 'PinName' of mosi pin to use
Wolfgang Betz 72:413cb97ac077 423 * @param miso 'PinName' of miso pin to use
Wolfgang Betz 72:413cb97ac077 424 * @param sclk 'PinName' of clock pin to use
Wolfgang Betz 72:413cb97ac077 425 * @param irq 'PinName' of interrupt pin to use
Wolfgang Betz 72:413cb97ac077 426 * @param cs 'PinName' of chip-select pin pin to use
Wolfgang Betz 72:413cb97ac077 427 * @param sdn 'PinName' of pin to use for device shutdown
Wolfgang Betz 72:413cb97ac077 428 *
Wolfgang Betz 72:413cb97ac077 429 * @returns reference to singleton instance
Wolfgang Betz 72:413cb97ac077 430 */
Wolfgang Betz 34:edda6a7238ec 431 static SimpleSpirit1& CreateInstance(PinName mosi, PinName miso, PinName sclk,
Wolfgang Betz 34:edda6a7238ec 432 PinName irq, PinName cs, PinName sdn,
Wolfgang Betz 34:edda6a7238ec 433 PinName led = NC) {
Wolfgang Betz 34:edda6a7238ec 434
Wolfgang Betz 34:edda6a7238ec 435 if(_singleton == NULL) {
Wolfgang Betz 34:edda6a7238ec 436 _singleton = new SimpleSpirit1(mosi, miso, sclk,
Wolfgang Betz 34:edda6a7238ec 437 irq, cs, sdn, led);
Wolfgang Betz 34:edda6a7238ec 438 _singleton->init();
Wolfgang Betz 34:edda6a7238ec 439 } else {
Wolfgang Betz 34:edda6a7238ec 440 error("SimpleSpirit1 singleton already created!\n");
Wolfgang Betz 34:edda6a7238ec 441 }
Wolfgang Betz 34:edda6a7238ec 442
Wolfgang Betz 34:edda6a7238ec 443 return *_singleton;
Wolfgang Betz 34:edda6a7238ec 444 }
Wolfgang Betz 34:edda6a7238ec 445
Wolfgang Betz 82:a18c22d2b83a 446 /** Get singleton instance of 'SimpleSpirit1'
Wolfgang Betz 72:413cb97ac077 447 *
Wolfgang Betz 72:413cb97ac077 448 * @returns reference to singleton instance
Wolfgang Betz 72:413cb97ac077 449 */
Wolfgang Betz 34:edda6a7238ec 450 static SimpleSpirit1& Instance() {
Wolfgang Betz 34:edda6a7238ec 451 if(_singleton == NULL) {
Wolfgang Betz 34:edda6a7238ec 452 error("SimpleSpirit1 must be created before used!\n");
Wolfgang Betz 34:edda6a7238ec 453 }
Wolfgang Betz 34:edda6a7238ec 454
Wolfgang Betz 34:edda6a7238ec 455 return *_singleton;
Wolfgang Betz 34:edda6a7238ec 456 }
Wolfgang Betz 34:edda6a7238ec 457
Wolfgang Betz 72:413cb97ac077 458 /** Attach a function to be called by the Spirit Irq handler when an event has occurred
Wolfgang Betz 34:edda6a7238ec 459 *
Wolfgang Betz 72:413cb97ac077 460 * @param func A void(int) callback, or 0 to set as none
Wolfgang Betz 34:edda6a7238ec 461 *
Wolfgang Betz 34:edda6a7238ec 462 * @note Function 'func' will be executed in interrupt context!
Wolfgang Betz 72:413cb97ac077 463 * @note Function 'func' will be call with either 'RX_DONE', 'TX_DONE', or 'TX_ERR' as parameter
Wolfgang Betz 72:413cb97ac077 464 * to indicate which event has occurred.
Wolfgang Betz 34:edda6a7238ec 465 */
Wolfgang Betz 34:edda6a7238ec 466 void attach_irq_callback(Callback<void(int)> func) {
Wolfgang Betz 34:edda6a7238ec 467 _current_irq_callback = func;
Wolfgang Betz 34:edda6a7238ec 468 }
Wolfgang Betz 34:edda6a7238ec 469
Wolfgang Betz 72:413cb97ac077 470 /** Switch Radio On
Wolfgang Betz 72:413cb97ac077 471 */
Wolfgang Betz 34:edda6a7238ec 472 int on(void);
Wolfgang Betz 82:a18c22d2b83a 473
Wolfgang Betz 72:413cb97ac077 474 /** Switch Radio Off
Wolfgang Betz 72:413cb97ac077 475 */
Wolfgang Betz 34:edda6a7238ec 476 int off(void);
Wolfgang Betz 34:edda6a7238ec 477
Wolfgang Betz 72:413cb97ac077 478 /** Set Channel
Wolfgang Betz 72:413cb97ac077 479 */
Wolfgang Betz 34:edda6a7238ec 480 void set_channel(uint8_t channel) {
Wolfgang Betz 34:edda6a7238ec 481 SpiritRadioSetChannel(channel);
Wolfgang Betz 34:edda6a7238ec 482 }
Wolfgang Betz 34:edda6a7238ec 483
Wolfgang Betz 72:413cb97ac077 484 /** Send a Buffer
Wolfgang Betz 72:413cb97ac077 485 *
Wolfgang Betz 72:413cb97ac077 486 * @param payload pointer to buffer to be send
Wolfgang Betz 72:413cb97ac077 487 * @param payload_len length of payload buffer in bytes
Wolfgang Betz 72:413cb97ac077 488 * @param use_csma_ca should CSMA/CA be enabled for transmission
Wolfgang Betz 72:413cb97ac077 489 *
Wolfgang Betz 72:413cb97ac077 490 * @returns zero in case of success, non-zero error code otherwise
Wolfgang Betz 72:413cb97ac077 491 *
Wolfgang Betz 72:413cb97ac077 492 * @note the maximum payload size in bytes allowed is defined by macro 'SPIRIT1_MAX_PAYLOAD'
Wolfgang Betz 72:413cb97ac077 493 */
Wolfgang Betz 64:28ef790e4ef7 494 int send(const void *payload, unsigned int payload_len, bool use_csma_ca = true);
Wolfgang Betz 34:edda6a7238ec 495
Wolfgang Betz 72:413cb97ac077 496 /** Copy received data into buffer
Wolfgang Betz 72:413cb97ac077 497 *
Wolfgang Betz 72:413cb97ac077 498 * @param buf pointer to buffer to be filled
Wolfgang Betz 72:413cb97ac077 499 * @param bufsize size of buffer
Wolfgang Betz 72:413cb97ac077 500 *
Wolfgang Betz 72:413cb97ac077 501 * @returns number of bytes copied into the buffer
Wolfgang Betz 72:413cb97ac077 502 *
Wolfgang Betz 72:413cb97ac077 503 * @note the buffer should be (at least) of size 'SPIRIT1_MAX_PAYLOAD' (in bytes).
Wolfgang Betz 72:413cb97ac077 504 */
Wolfgang Betz 34:edda6a7238ec 505 int read(void *buf, unsigned int bufsize);
Wolfgang Betz 34:edda6a7238ec 506
Wolfgang Betz 82:a18c22d2b83a 507 /** Perform a Clear-Channel Assessment (CCA) to find out whether the medium is idle or not.
Wolfgang Betz 72:413cb97ac077 508 *
Wolfgang Betz 82:a18c22d2b83a 509 * @returns 1 if the medium is busy.
Wolfgang Betz 72:413cb97ac077 510 */
Wolfgang Betz 34:edda6a7238ec 511 int channel_clear(void);
Wolfgang Betz 34:edda6a7238ec 512
Wolfgang Betz 72:413cb97ac077 513 /** Check if the radio driver has just received a packet
Wolfgang Betz 72:413cb97ac077 514 */
Wolfgang Betz 34:edda6a7238ec 515 int get_pending_packet(void);
Wolfgang Betz 34:edda6a7238ec 516
Wolfgang Betz 72:413cb97ac077 517 /** Is radio currently receiving
Wolfgang Betz 72:413cb97ac077 518 */
Wolfgang Betz 34:edda6a7238ec 519 bool is_receiving(void) {
Wolfgang Betz 34:edda6a7238ec 520 return _is_receiving;
Wolfgang Betz 34:edda6a7238ec 521 }
Wolfgang Betz 34:edda6a7238ec 522
Wolfgang Betz 72:413cb97ac077 523 /** Get latest value of RSSI (in dBm)
Wolfgang Betz 72:413cb97ac077 524 */
Wolfgang Betz 34:edda6a7238ec 525 float get_last_rssi_dbm(void) {
Wolfgang Betz 34:edda6a7238ec 526 get_last_rssi_raw();
Wolfgang Betz 34:edda6a7238ec 527 return (-120.0+((float)(last_rssi-20))/2);
Wolfgang Betz 34:edda6a7238ec 528 }
Wolfgang Betz 34:edda6a7238ec 529
Wolfgang Betz 72:413cb97ac077 530 /** Get latest value of RSSI (as Spirit1 raw value)
Wolfgang Betz 72:413cb97ac077 531 */
Wolfgang Betz 34:edda6a7238ec 532 uint8_t get_last_rssi_raw(void) {
Wolfgang Betz 34:edda6a7238ec 533 if(last_rssi == 0) {
Wolfgang Betz 34:edda6a7238ec 534 last_rssi = qi_get_rssi();
Wolfgang Betz 34:edda6a7238ec 535 }
Wolfgang Betz 34:edda6a7238ec 536 return last_rssi;
Wolfgang Betz 34:edda6a7238ec 537 }
Wolfgang Betz 34:edda6a7238ec 538
Wolfgang Betz 72:413cb97ac077 539 /** Get latest value of LQI (scaled to 8-bit)
Wolfgang Betz 72:413cb97ac077 540 */
Wolfgang Betz 34:edda6a7238ec 541 uint8_t get_last_sqi(void) {
Wolfgang Betz 34:edda6a7238ec 542 const uint8_t max_sqi = 8 * ((SYNC_LENGTH>>1)+1);
Wolfgang Betz 34:edda6a7238ec 543 if(last_sqi == 0) {
Wolfgang Betz 34:edda6a7238ec 544 last_sqi = qi_get_sqi();
Wolfgang Betz 34:edda6a7238ec 545 }
Wolfgang Betz 34:edda6a7238ec 546 if(last_sqi > max_sqi) last_sqi = max_sqi;
Wolfgang Betz 34:edda6a7238ec 547
Wolfgang Betz 34:edda6a7238ec 548 return (last_sqi * 255 / max_sqi);
Wolfgang Betz 34:edda6a7238ec 549 }
Wolfgang Betz 34:edda6a7238ec 550
Wolfgang Betz 72:413cb97ac077 551 /** Reset Board
Wolfgang Betz 72:413cb97ac077 552 */
Wolfgang Betz 34:edda6a7238ec 553 void reset_board() {
Wolfgang Betz 34:edda6a7238ec 554 init();
Wolfgang Betz 34:edda6a7238ec 555 }
Wolfgang Betz 34:edda6a7238ec 556 };