ST / stm-spirit1-rf-driver

Prototype RF driver for STM Sub-1 GHz RF expansion board based on the SPSGRF-868 module for STM32 Nucleo.

Prototype RF Driver for STM Sub-1 GHz RF Expansion Boards based on the SPSGRF-868 and SPSGRF-915 Modules for STM32 Nucleo

Currently supported boards:

Note, in order to use expansion board X-NUCLEO-IDS01A4 in mbed you need to perform the following HW modifications on the board:

  • Unmount resistor R4
  • Mount resistor R7

Furthermore, on some Nucleo development boards (e.g. the NUCLEO_F429ZI), in order to be able to use Ethernet together with these Sub-1 GHz RF expansion boards, you need to compile this driver with macro SPIRIT1_SPI_MOSI=PB_5 defined, while the development board typically requires some HW modification as e.g. described here!

This driver can be used together with the 6LoWPAN stack (a.k.a. Nanostack).

Diff: SimpleSpirit1.cpp

Revision:
0:4fb29d9ee571
Child:
2:45642c5198a2
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/SimpleSpirit1.cpp	Thu Oct 13 15:41:39 2016 +0200
@@ -0,0 +1,109 @@
+/*** Mbed Includes ***/
+#include "SimpleSpirit1.h"
+
+
+/*** Macros from Cube Implementation ***/
+#define CLEAR_TXBUF()           (spirit_txbuf[0] = 0)
+#define CLEAR_RXBUF()           (spirit_rxbuf[0] = 0)
+/* transceiver state. */
+#define ON     0
+#define OFF    1
+
+
+SimpleSpirit1 *SimpleSpirit1::_singleton = NULL;
+
+/*** Class Implementation ***/
+SimpleSpirit1::SimpleSpirit1(PinName mosi, PinName miso, PinName sclk,
+			     PinName irq, PinName cs, PinName sdn,
+			     PinName led) :
+    _spi(mosi, miso, sclk),
+    _irq(irq),
+    _chip_select(cs),
+    _shut_down(sdn),
+    _led(led),
+    _nr_of_irq_disables(0)
+{
+    /* reset irq disable counter & disable irq */
+    disable_irq();
+
+    /* unselect chip */
+    chip_unselect();
+
+    /* configure spi */
+    _spi.format(8, 0); /* 8-bit, mode = 0, [order = SPI_MSB] only available in mbed3 */
+    _spi.frequency(5000000); // 5MHz
+
+    /* set frequencies */
+    radio_set_xtal_freq(XTAL_FREQUENCY);
+    mgmt_set_freq_base(XTAL_FREQUENCY);
+
+    /* restart board */
+    enter_shutdown();
+    exit_shutdown();
+
+    /* soft core reset */
+    cmd_strobe_command(SPIRIT1_STROBE_SRES);
+
+    /* Configures the SPIRIT1 radio part */
+    SRadioInit x_radio_init = {
+      XTAL_OFFSET_PPM,
+      (uint32_t)BASE_FREQUENCY,
+	  (uint32_t)CHANNEL_SPACE,
+      CHANNEL_NUMBER,
+      MODULATION_SELECT,
+      DATARATE,
+      (uint32_t)FREQ_DEVIATION,
+      (uint32_t)BANDWIDTH
+    };
+    radio_init(&x_radio_init);
+    radio_set_pa_level_dbm(0,POWER_DBM);
+    radio_set_pa_level_max_index(0);
+
+    /* Configures the SPIRIT1 packet handler part*/
+    PktBasicInit x_basic_init = {
+      PREAMBLE_LENGTH,
+      SYNC_LENGTH,
+      SYNC_WORD,
+      LENGTH_TYPE,
+      LENGTH_WIDTH,
+      CRC_MODE,
+      CONTROL_LENGTH,
+      EN_ADDRESS,
+      EN_FEC,
+      EN_WHITENING
+    };
+    pkt_basic_init(&x_basic_init);
+
+    /* Enable the following interrupt sources, routed to GPIO */
+    irq_de_init(NULL);
+    irq_clear_status();
+    irq_set_status(TX_DATA_SENT, S_ENABLE);
+    irq_set_status(RX_DATA_READY,S_ENABLE);
+    irq_set_status(VALID_SYNC,S_ENABLE);
+    irq_set_status(RX_DATA_DISC, S_ENABLE);
+    irq_set_status(TX_FIFO_ERROR, S_ENABLE);
+    irq_set_status(RX_FIFO_ERROR, S_ENABLE);
+
+    /* Configure Spirit1 */
+    radio_persisten_rx(S_ENABLE);
+    qi_set_sqi_threshold(SQI_TH_0);
+    qi_sqi_check(S_ENABLE);
+    qi_set_rssi_threshold_dbm(CCA_THRESHOLD);
+    timer_set_rx_timeout_stop_condition(SQI_ABOVE_THRESHOLD);
+    timer_set_infinite_rx_timeout();
+    radio_afc_freeze_on_sync(S_ENABLE);
+
+    /* Puts the SPIRIT1 in STANDBY mode (125us -> rx/tx) */
+    cmd_strobe_command(SPIRIT1_STROBE_STANDBY);
+    spirit_on = OFF;
+    CLEAR_RXBUF();
+    CLEAR_TXBUF();
+
+    /* Configure the radio to route the IRQ signal to its GPIO 3 */
+    SGpioInit x_gpio_init = {
+	SPIRIT_GPIO_IRQ,
+	SPIRIT_GPIO_MODE_DIGITAL_OUTPUT_LP,
+	SPIRIT_GPIO_DIG_OUT_IRQ
+    };
+    spirit_gpio_init(&x_gpio_init);
+}