SP1ML-868

## **SP1ML** 

## SPIRIT1 868 and 915 MHz low power RF modules with integrated microcontroller 

**Datasheet** - **production data** 

- Data acquisition equipment 

- Security systems 

- Mobile health and medical 

- Industrial monitor and control 

- Wireless metering, WMBUS 

- Internet of things (IoT) 

## **Description** 

## **Features** 

- Complete RF-ready SPIRIT1 module based on: 

   - SPIRIT1 low data rate, low power sub-GHz transceiver 

   - STM32L1 Ultra low power microcontroller at 32 MHz (16 kB RAM and 128 kB Flash) 

   - BALF-SPI-01D3 868/915 MHz balun with integrated harmonic filter 

   - Integrated antenna and crystal 

- Compact size: 14 mm x 13.4 mm x 2.5 mm 

- 863 to 870 MHz operation (SP1ML-868) 

- 902 to 928 MHz operation (SP1ML-915) 

- Operates from a single 1.8 V to 3.6 V supply 

- Output power up to +11.6 dBm 

- Data rates up to 500 kbps 

- Modulation schemes: 2-FSK, GFSK, GMSK, OOK, and ASK 

- Operating temperature: -40 °C to 85 °C 

- UART interface with AT command set 

- FCC and CE regulatory approvals 

## **Applications** 

The SP1ML-868 and SP1ML-915 are ultra-low power & fully integrated RF modules operating respectively in the 868 MHz SRD and 915 MHz ISM bands. 

The SP1ML module is a compact-size module, integrating an on-board antenna with easy-to-use interface, allowing users to easily add wireless connectivity in designs without requiring in-depth RF experience, and has all necessary FCC modular approvals and CE compliance, reducing time-to-market. 

These modules are based on the SPIRIT1 RF sub-GHz transceiver (with integrated SMPS), STM32L1 microcontroller, integrated filter/balun and chip antenna. The UART host interface allows simple connection to an external microcontroller with a standard firmware, allowing AT commands to facilitate RF configuration, data transmission and reception, using simple point-topoint communication. Selected STM32L1 GPIO and peripherals are available for interfacing to external devices in the user application. Advanced features of the SPIRIT1 radio are also accessible. The serial wire debug interface (SWD) is also available. The SP1ML can be used as an open platform, replacing the default firmware with its own application firmware. 

The modules are CE compliant and FCC certified (FCC ID S9NSP1ML). 

- Home & building automation 

- Wireless sensor network 

November 2016 

DocID026906 Rev 7 

1/30 

This is information on a product in full production. 

_www.st.com_ 

**Contents** 

**SP1ML** 

|**Contents**|**Contents**|||
|---|---|---|---|
|**1**|**Hardware specification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .**||**. . . 6**|
||1.1|Recommended operating conditions  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6||
||1.2|Absolute maximum ratings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6||
||1.3|I/O operating characteristics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6||
||1.4|Current consumption  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7||
||1.5|RF compliance limits  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7||
||1.6|Pin assignment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8||
||1.7|Pin placement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9||
||1.8|Internal hardware connection for open platform . . . . . . . . . . . . . . . . . . . . . 9||
||1.9|Hardware block diagram  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10||
|**2**|**Hardware design . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .**||**. . 11**|
||2.1|Pin usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11||
||2.2|Typical application circuit  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12||
|||Optional functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12||
||2.3|Layout guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12||
||2.4|Recommended footprint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14||
||2.5|Module reflow installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14||
|**3**|**Module operation  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .**||**. . 16**|
||3.1|Operating mode  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16||
||3.2|Command mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16||
||3.3|Command reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16||
||3.4|Configuration registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18||
||3.5|Information registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22||
||3.6|Example command sequence  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22||
|**4**|**ECOPACK®  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23**|||
|**5**|**Package mechanical data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .**||**. . 23**|
|**6**|**Regulatory compliance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .**||**. . 24**|
|2/30||DocID026906 Rev 7||



|**SP1ML**|**Contents**|
|---|---|
||6.1<br>CE certification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24|
||6.2<br>FCC certification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24|
||6.3<br>Labeling instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24|
||6.4<br>Product manual instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25|
|**7**|**Module traceability and marking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26**|
|**8**|**Ordering information  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28**|
|**9**|**Revision history  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29**|



DocID026906 Rev 7 

3/30 

**SP1ML** 

**List of tables** 

## **List of tables** 

|Table|1.|Recommended operating conditions  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6|
|---|---|---|
|Table|2.|Absolute maximum ratings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6|
|Table|3.|I/O operating characteristics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6|
|Table|4.|Current consumption  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7|
|Table|5.|RF compliance limits. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7|
|Table|6.|Pin assignment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8|
|Table|7.|Module pin usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11|
|Table|8.|Soldering profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14|
|Table|9.|Command reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17|
|Table|10.|Configuration registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19|
|Table|11.|Information registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22|
|Table|12.|Example configuration AT sequence  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22|
|Table|13.|Module Product ID  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27|
|Table|14.|Ordering information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28|
|Table|15.|Document revision history  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29|



4/30 

DocID026906 Rev 7 

**SP1ML** 

**List of figures** 

## **List of figures** 

|Figure|1.|Pin placement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9|
|---|---|---|
|Figure|2.|Internal hardware connection for open platform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9|
|Figure|3.|Hardware block diagram. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10|
|Figure|4.|Typical application circuit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12|
|Figure|5.|Layout guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13|
|Figure|6.|Recommended footprint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14|
|Figure|7.|Soldering profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15|
|Figure|8.|Package mechanical data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23|
|Figure|9.|SP1ML top side  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26|
|Figure|10.|SP1ML bottom side  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26|
|Figure|11.|SP1ML QR-code laser marking  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27|



DocID026906 Rev 7 

5/30 

**SP1ML** 

**Hardware specification** 

## **1 Hardware specification** 

General conditions (VIN = 3 V and TA = 25 °C). 

## **1.1 Recommended operating conditions** 

**Table 1. Recommended operating conditions** 

|**Symbol**|**Parameter**|**Min.**|**Typ.**|**Max.**|**Unit**|
|---|---|---|---|---|---|
|TA|Operating ambient temperature range|-40|-|85|˚C|
|VDD|Operating supply voltage|1.8|3|3.6|V|
|FREQ|RF frequency (SP1ML-868)|863|-|870|MHz|
|FREQ|RF frequency (SP1ML-915)|902|-|928|MHz|



## **1.2 Absolute maximum ratings** 

**Table 2. Absolute maximum ratings** 

|**Symbol**|**Parameter**|**Min.**|**Typ.**|**Max.**|**Unit**|
|---|---|---|---|---|---|
|TSTG|Storage temperature range|-40|-|85|˚C|
|VDD|Operating supply voltage|-0.3|-|3.9|V|
|VIO|I/O pin voltage|-0.3|-|5.5|V|



## **1.3 I/O operating characteristics** 

**Table 3. I/O operating characteristics** 

|**Symbol**|**Parameter**|**Min.**|**Typ.**|**Max.**|**Unit**|
|---|---|---|---|---|---|
|VIL<br>(1)|I/O input low level voltage|-0.3|-|0.3 VDD|V|
|VIH<br>(1)|I/O input high level voltage|0.7 VIN|-|VDD+0.3|V|



1. For more details see the STM32L151RB datasheet, I/O port characteristics. 

6/30 

DocID026906 Rev 7 

**SP1ML** 

**Hardware specification** 

## **1.4 Current consumption** 

**Table 4. Current consumption** 

|||**Table 4. Current consumption**|||
|---|---|---|---|---|
|**Symbol**|**Parameter**|**Test conditions**|**Typ.**|**Unit**|
|IDD|Supply current|Operating mode<br>Tx, +11 dBm, 2-FSK, 915 MHz|20|mA|
|||Operating mode<br>Tx, -7 dBm, 2-FSK, 915 MHz|8|mA|
|||Operating mode<br>Rx, 915 MHz|13.5|mA|
|||Command mode|2.2|mA|
|||Standby|1.4|µA|



## **1.5 RF compliance limits** 

The RF compliance limits are those tested for FCC and CE certification. These limits are enforced by the factory loaded firmware. Care must be taken with custom firmware to ensure these limits are not exceeded, voiding the FCC and CE certification. 

**Table 5. RF compliance limits** 

|**Modulation**|**Standards**|**Parameter**|**Max.**|**Unit**|
|---|---|---|---|---|
|2-FSK<br>GFSK<br>MSK|FCC Part 15.207(1)<br>FCC Part 15.247(1)<br>EN 300 220-2 V2.4.1(2)<br>EN 301 489-01 V1.9.2(2)<br>EN 301 489-03 V1.4.1(2)|Data rate|500|kbps|
|||Output power|+11.6|dBm|
|OOK<br>ASK|FCC Part 15.207(1)<br>FCC Part 15.249(1)<br>EN 300 220-2 V2.4.1(2)<br>EN 301 489-01 V1.9.2(2)<br>EN 301 489-03 V1.4.1(2)|Data rate|250|kbps|
|||Output power|+8.5|dBm|



1. FCC standards are only applicable to the SP1ML-915 module. 

2. EN standards are only applicable to the SP1ML-868 module. 

DocID026906 Rev 7 

7/30 

**SP1ML** 

**Hardware specification** 

## **1.6 Pin assignment** 

**Table 6. Pin assignment** 

||||**Table 6. Pin assignment**||
|---|---|---|---|---|
|**Pin**|**Name**|**Type**|**Description**|**STM32L pin(1)**|
|1|TXRXLED|O|Active low Tx/Rx LED drive(2)|PA2|
|2|SHDN|I|Shutdown|PA0|
|3|GPIO0|I/O|General purpose input/output 0(3)|PB15|
|4|GPIO1|I/O|General purpose input/output 1(3)|PB14|
|5|MODE0|I|Protocol mode selection 0(2)|PB13|
|6|MODE1|I|Protocol mode selection 1(2)|PB12|
|7|VDD|Power|Supply input voltage|-|
|8|GND|Power|Ground|-|
|9|SWDIO|I/O|Serial wire I/O|PA13|
|10|SWCLK|I|Serial wire clock|PA14|
|11|BOOTMODE|I|Boot mode selection|BOOT0|
|12|RESET|I|Reset input, active low|NRST|
|13|TXD|O|UART transmit data|PA9|
|14|RXD|I|UART receive data|PA10|
|15|GPIO2|I/O|General input/output 2(3)|PB6|
|16|GPIO3|I/O|General purpose input/output 3(3)|PB7|



1. For further details, see the STM32L151RB datasheet, Pin descriptions section. Alternate functions of any given pin are dependent on the user application firmware that is loaded into the module and is beyond the scope of this document. 

2. Refer to Hardware design section for details regarding TXRXLED and protocol mode selection. 

3. The GPIO signals are not used by the default firmware integrated in the module. They are accessible with user application firmware. See note _1._ 

8/30 

DocID026906 Rev 7 

**SP1ML** 

**Hardware specification** 

## **1.7 Pin placement** 

**==> picture [113 x 11] intentionally omitted <==**

**----- Start of picture text -----**<br>
Figure 1. Pin placement<br>**----- End of picture text -----**<br>


## **1.8 Internal hardware connection for open platform** 

**Figure 2. Internal hardware connection for open platform** 

DocID026906 Rev 7 

9/30 

**SP1ML** 

**Hardware specification** 

## **1.9 Hardware block diagram** 

**==> picture [296 x 142] intentionally omitted <==**

**----- Start of picture text -----**<br>
Figure 3. Hardware block diagram<br>XTAL<br>1.8V to 3.6V Supply<br>UART SPI SMPS<br>RXp<br>ee<br>STM32L  RXn<br>Spirit1 Filter/Balun<br>GPIO Microcontroller GPIO<br>TX<br>**----- End of picture text -----**<br>


GSPG1409141831SMD 

10/30 

DocID026906 Rev 7 

**SP1ML** 

**Hardware design** 

## **2 Hardware design** 

## **2.1 Pin usage** 

If used with the default firmware and interfaced to a host MCU, at a minimum the SP1ML module requires power, ground and UART transmit and receive signals to be connected. Other signals are optional and provide additional functionality. These signals are outlined in _Table 7_ below. Unused signals must not be connected. 

**Table 7. Module pin usage** 

|||**Table 7. Modulepin usage**||
|---|---|---|---|
|**Pin**|**Name**|**Description**|**Optional**|
|1|TXRXLED|An active-low open drain output that can drive an external LED for<br>TX/RX activity status indication. TXRXLED must be enabled by setting<br>the value to 1 in register S24.|Yes|
|2|SHDN|Drive this signal low to put the module into a low power shutdown<br>mode. Drive the signal high to wake the module.|Yes|
|3|GPIO0|Reserved for future use, do not connect.|Yes|
|4|GPIO1|Reserved for future use, do not connect.|Yes|
|5|MODE0|Drive this signal high to force the module into_operating mode_. Drive<br>this signal low to force the module into_command mode_. This enables<br>faster switching between modes and obviates the need for escape<br>sequences. After setting the MODE0 value, do a RESET to make the<br>new setting effective.|Yes|
|6|MODE1|Reserved for future use, do not connect.|Yes|
|7|VDD|Connect to power supply, 1.8V to 3.6V.|No|
|8|GND|Connect to system ground.|No|
|9|SWDIO|These signals are the serial wire debug (SWD) interface to the<br>STM32L microcontroller, supporting the development and loading of<br>custom firmware.|Yes|
|10|SWCLK||Yes|
|11|BOOTMODE|Drive this signal high at power up or reset to start the boot loader and<br>allow device firmware update over the UART interface.|Yes|
|12|RESET|Drive this signal low to hold the module in reset. Drive this signal high<br>to release the module from reset.|Yes|
|13|TXD|Connect to the host system UART RXD input.|No|
|14|RXD|Connect to the host system UART TXD output.|No|
|15|GPIO2|Reserved for future use.|Yes|
|16|GPIO3|Reserved for future use.|Yes|



DocID026906 Rev 7 

11/30 

**SP1ML** 

**Hardware design** 

## **2.2 Typical application circuit** 

In a typical application the SP1ML module is connected to a host MCU using a standard UART, with transmit and receive signals. This is illustrated in _Figure 4_ . 

**==> picture [168 x 11] intentionally omitted <==**

**----- Start of picture text -----**<br>
Figure 4. Typical application circuit<br>**----- End of picture text -----**<br>


**==> picture [398 x 310] intentionally omitted <==**

**----- Start of picture text -----**<br>
VDD 1 VDD<br>10uF<br>VDD<br>TXRXLED<br>HOST TXD TXD SP1ML<br>MCU RXD RXD MODULE<br>RTS<br>CTS VDD<br>SWCLK<br>GPIO MODE0<br>SWD<br>SWDIO<br>GPIO SHDN 2 HEADER<br>RESET<br>GPIO BOOTMODE<br>GPIO RESET 3 4<br>GND<br>**----- End of picture text -----**<br>


## **Optional functionality** 

1. When the TXRX_LED (S24) configuration register (see _Table 10_ ) is set to 1, the TXRXLED signal is an active-low open drain output that can be used to drive an external LED for status indication when data is sent or received. 

2. The MODE0 signal provides a hardware method for switching between command and operating modes. The SHDN signal allows the module to be placed into a low power shutdown mode and woken up again. 

3. The BOOTMODE AND RESET signals should be connected if module firmware will need to be updated over the UART interface. 

4. To support custom module firmware, the serial wire debug signals need to be accessible for programming and debugging. 

## **2.3 Layout guidelines** 

The application PCB requires a flooded ground plane. Care must be taken to ensure there are no traces or ground planes under the area surrounding the antenna, with the exception 

12/30 

DocID026906 Rev 7 

**SP1ML** 

**Hardware design** 

of minimal width traces from pins 1, 2, 3, 4, 13 and 14 of the module if these are used. It is appropriate to place the module toward the edge of the PCB with no traces or ground planes from the antenna to the board edge. 

**==> picture [213 x 328] intentionally omitted <==**

**----- Start of picture text -----**<br>
Figure 5. Layout guidelines<br>No copper on any layer surrounding antenna, except<br>minimal traces from pins 1,2,3,4,13 and14<br>6 mm “f : 6 mm<br>min . o R . % / ‘i i min .<br>M2 FCC ID:S9NSPIMLE<br>== \MODEL:SPIML<br>| ———————————————<br>i<br>F|<br>BJ | d<br>Flooded ground plane required<br>(signal traces allowed)<br>Application PCB<br>**----- End of picture text -----**<br>


DocID026906 Rev 7 

13/30 

**SP1ML** 

**Hardware design** 

## **2.4 Recommended footprint** 

## **Figure 6. Recommended footprint** 

**==> picture [405 x 347] intentionally omitted <==**

## **2.5 Module reflow installation** 

The SP1ML is a surface mount module supplied on a 16-pin, 4-layer PCB. The final assembly recommended reflow profile is indicated below, based on IPC/JEDEC JSTD020C, July 2004 recommendations. 

**Table 8. Soldering profile** 

|**Table 8. Soldering profile**||
|---|---|
|**Profile feature**|**Lead-free assembly**|
|Average ramp-up rate (TSMAX to TP)|3 °C/sec max|
|Preheat:<br>– Temperature min. (TS min.)<br>– Temperature max. (TS max.)<br>– Time (tsmin. to ts max.)(ts)|150 °C<br>200 °C<br>60-100 sec|



14/30 

DocID026906 Rev 7 

**SP1ML** 

**Hardware design** 

**Table 8. Soldering profile (continued)** 

|**Profile feature**|**Lead-free assembly**|
|---|---|
|Time maintained above:<br>– Temperature TL<br>– Temperature TL|217 °C<br>60-70 sec|
|Peak temperature (TP)|240 °C|
|Time within 5 °C of actual peak temperature (TP)|10-20 sec|
|Ramp-down rate|6 °C/sec|
|Time from 25 °C to peak temperature|8 minutes max.|



## **Figure 7. Soldering profile** 

**==> picture [65 x 6] intentionally omitted <==**

**----- Start of picture text -----**<br>
GSPG1409141835SMD<br>**----- End of picture text -----**<br>


DocID026906 Rev 7 

15/30 

**SP1ML** 

**Module operation** 

## **3 Module operation** 

The SP1ML module is provided with firmware that supports wireless serial cable replacement. There are two operational modes, _command mode_ and _operating mode_ . The command mode allows module configuration and status interrogation using an extended ‘AT’ style command set. In operating mode the module serves its primary purpose as a wireless transceiver. Following power-up or reset, the module starts in operating mode with the current configuration loaded from EEPROM. 

## **3.1 Operating mode** 

In operating mode, data received from the host on the UART interface will be wirelessly transmitted by the SPIRIT1 radio using the current configuration settings for frequency, data rate, modulation and output power. Conversely, any data received by the SPIRIT1 that meets the configured filtering criteria will be output to the UART interface. 

Care must be taken to ensure that the escape sequence to enter command mode does not occur in the data stream sent by the host to the UART interface. 

## **3.2 Command mode** 

In command mode, the module will accept commands to configure module settings and interrogate module status. To enter command mode, the ‘+++’ escape sequence is issued to the module from operating mode. The escape sequence should be preceded by minimum delay of 500 milliseconds where no other data is transmitted. The three ‘+’ characters of the sequence must be sent within 500 milliseconds of each other. The module issues the response ‘OK’ if command mode is entered successfully. 

Commands issued to the module are in ‘AT’ style format, and use ASCII characters, starting with ‘A’ and ‘T’, then one or more characters for the specific command, followed by any additional command specific data and terminated with a carriage return <CR>. 

The delay between each consecutive character of a command must be less than 8 seconds, else the module will time out and discard any characters already received. 

If the module receives an invalid command, it will send the ‘ERROR’ response. All responses issued by the module are terminated with a line feed and carriage return, <LF><CR>. 

## **3.3 Command reference** 

_Table 9: Command reference_ provides a summary of the AT commands available for module configuration. A detailed description of each command is provided following the list. 

16/30 

DocID026906 Rev 7 

**SP1ML** 

**Module operation** 

**Table 9. Command reference** 

||**Table 9. Command reference**|
|---|---|
|**Command**|**Description**|
|ATO|**_Enter operating mode_**<br>This command is issued to exit command mode and enter operating mode where the<br>module fulfills its primary purpose as a wireless transceiver using the current configuration.<br>_Response:_<br> **OK**|
|AT/V|**_Read module version information_**<br>Reports the module hardware and firmware version information.<br>_Response:_<br>**SP1ML-xxx HW:Vy FW:Vy.zz**<br>Where**xxx**is 868 or 915,**y**is a single digit major version number and**zz**is a double digit<br>minor version number.|
|ATIn|**_Read an information register_**<br>Reads the current value from an information register, where**n**is the information register<br>number.<br>See information registers table.<br>_Response:_<br>**<REGISTER NUMBER>:<REGISTER NAME>=<VALUE>**<br>**ERROR** **PARAM**if an invalid register is specified.|
|ATSnn?|**_Read a configuration register_**<br>Reads the current value from a configuration register, where**nn**is the configuration register<br>number.<br>See configuration registers section.<br>_Response:_<br>**<REGISTER NUMBER>:<REGISTER NAME>=<VALUE>**<br>**ERROR** **PARAM**if an invalid register number is specified.|
|ATSnn=x|**_Write a configuration register_**<br>Writes a new value to a configuration register, where**nn**is the configuration register number<br>and**x**is the value. The new configuration will be in effect until the next module reset.<br>See configuration registers section.<br>_Response:_<br> **OK**if the value is written successfully.<br>**ERROR** **PARAM**if an invalid register number is specified.<br>**ERROR** **VALUE**if an invalid value is specified.|
|AT/S|**_Read all configuration registers_**<br>Reads the current values of all configuration registers.<br>See the configuration registers section.<br>_Response:_<br> _(one line for each register)_<br>**<REGISTER NUMBER>:<REGISTER NAME>=<VALUE>**|
|AT/C|**_Store the current configuration_**<br>Stores the current module configuration registers. The stored configuration will be reloaded<br>anytime the module is reset.<br>_Response:_<br> **OK**if the configuration is stored successfully.<br>**ERROR**if storing the configuration failed.|



DocID026906 Rev 7 

17/30 

**SP1ML** 

**Module operation** 

**Table 9. Command reference (continued)** 

||**Table 9. Command reference(continued)**|
|---|---|
|**Command**|**Description**|
|ATR|**_Reset configuration to the default values_**<br>This command resets all module configuration registers to their factory default values.<br>_Response:_<br> **OK**<br>**ERROR**if resetting the configuration failed.|
|ATZ|**_Restart the module_**<br>Restarts the module and reloads the current configuration. This generates a soft reset of the<br>microcontroller and start execution of the firmware from the reset vector.<br>_Response:_<br> **OK**|
|AT/SRnn?|**_Read a SPIRIT1 radio register_**<br>Reads the current value from a SPIRIT1 radio register, where**nn**is the two digit<br>hexadecimal register address.<br>_Response:_<br>**<ADDRESS>=<VALUE>**<br>**ERROR PARAM**if an invalid register number is specified.<br>**ERROR**if reading the register failed.|
|AT/SRnn=xx|**_Write a SPIRIT1 radio register_**<br>Writes a new value to a SPIRIT1 radio register, where**nn**is the two digit hexadecimal<br>register address and**xx**is the two digit hexadecimal value to write.<br>_Response:_<br> **OK**<br>**ERROR PARAM**if an invalid register number is specified.<br>**ERROR**if writing the register failed.|
|AT/Tn|**_Set RF test mode_**<br>Set the RF test mode, where**n**is the test mode number from one of the following options:<br>0 = Disable RF test mode.<br>1 = Pseudorandom binary sequence RF test mode (PN9).<br>2 = Continuous wave RF test mode (CW).<br>_Response:_<br> **OK**if the test mode is set successfully<br>**ERROR PARAM**if an invalid test mode number is specified.|



## **3.4 Configuration registers** 

The configuration registers contain the radio, packet and general configuration settings for the module. They are read and written in command mode. _Table 10_ details each configuration register. 

18/30 

DocID026906 Rev 7 

**SP1ML** 

**Module operation** 

## **Table 10. Configuration registers** 

|**#**|**Name**|**Description**|
|---|---|---|
|S00|BAUD_RATE|**General:**Baud rate of the UART interface in_bps_. The baud rate is<br>stored when the configuration is stored.<br>_Values:_<br>Most standard baud rates from 9600 to 921600.<br>_Default:_<br> 115200|
|S01|FREQUENCY|**Radio:**Frequency in_Hz_.<br>Values:<br>Must be within the operating frequency range of the module.<br>Default:<br>868000000 (for SP1ML-868)<br>915000000 (for SP1ML-915)|
|S02|DATA_RATE|**Radio:**Data rate in_bps_. The data rate for OOK and ASK modulation<br>schemes is limited to 250000bps.<br>Values:<br>From 1000 to 500000<br>_Default:_<br> 38400|
|S03|MODULATION|**Radio:**Modulation scheme.<br>_Values:_<br>0 = 2-FSK<br>1 = GFSK05<br>2 = GFSK1<br>3 = GMSK<br>4 = OOK<br>5 = ASK<br>_Default:_<br> 0|
|S04|OUTPUT_POWER|**Radio:**Output power in_dBm_.<br>_Values:_<br> -34 to +11.6<br>_Default:_<br> +11.6|
|S05|FREQ_DEVIATION|**Radio:**Frequency deviation in_kHz_.<br>_Values:_<br> Up to 732<br>_Default:_<br> 20|
|S06|RX_FILTER|**Radio:**RX digital filter cutoff frequency in_kHz_.<br>_Values:_<br> Up to 769<br>_Default:_<br> 100|
|S07|CS_MODE|**Radio:**Carrier sense mode.<br>_Values:_<br>0 = Static sensing<br>1 = Dynamic sensing with 6 dB dynamic threshold<br>2 = Dynamic sensing with 12 dB dynamic threshold<br>3 = Dynamic sensing with 18 dB dynamic threshold<br>_Default:_<br> 0|



DocID026906 Rev 7 

19/30 

**SP1ML** 

**Module operation** 

**Table 10. Configuration registers (continued)** 

|**#**|**Name**|**Description**|
|---|---|---|
|S08|RSSI_THRESHOLD|**Radio:**Carrier sense RSSI threshold in_dBm_.<br>_Values:_<br> -130 to -3<br>_Default:_<br> -130|
|S09|PREAMBLE_LEN|**Packet:**Preamble length in_bytes_.<br>_Values:_<br> 1 to 32 bytes.<br>_Default:_<br> 8|
|S10|SYNC_LENGTH|**Packet:**Sync length in_bytes_.<br>_Values:_<br> 1 to 4<br>_Default:_<br> 4|
|S11|SYNC_VALUE|**Packet:**32-bit sync value.<br>_Values:_<br> Any 32-bit hexadecimal value.<br>_Default:_<br> 0x88888888|
|S12|CRC_MODE|**Packet:**CRC mode.<br>_Values:_<br>1 = POLY_0x07<br>2 = POLY_0x8005<br>3 = POLY_0x1021<br>4 = POLY_0x864CFB<br>_Default:_<br> 2|
|S13|WHITENING|**Packet:**Data whitening mode.<br>Values:<br>0 = Disabled<br>1 = Enabled<br>_Default:_<br> 1|
|S14|FEC|**Packet:**Forward error correction.<br>_Values:_<br>0 = Disabled<br>1 = Enabled<br>_Default:_<br> 0|
|S15|SOURCE_ADDR|**Address:**The 8-bit address for the module, used to indicate the<br>source of transmitted packets and for destination filtering of received<br>packets.<br>_Values:_<br> Any 8-bit hexadecimal value.<br>_Default:_<br> 0x00|
|S16|DESTINATION_ADDR|**Address:**The 8-bit destination address, used to indicate the<br>destination for transmitted packets and for source filtering of received<br>packets.<br>_Values:_<br> Any 8-bit hexadecimal value.<br>_Default:_<br> 0xff|
|S17|MULTICAST_ADDR|**Address:**The 8-bit multicast address, used for multicast filtering on<br>received packets.<br>_Values:_<br> Any 8-bit hexadecimal value.<br>_Default:_<br> 0xee|



20/30 

DocID026906 Rev 7 

**SP1ML** 

**Module operation** 

**Table 10. Configuration registers (continued)** 

|**#**|**Name**|**Description**|
|---|---|---|
|S18|BROADCAST_ADDR|**Address:**The 8-bit broadcast address, used for broadcast filtering on<br>received packets.<br>_Values:_<br> Any 8-bit hexadecimal value.<br>_Default:_<br> 0xff|
|S19|FILTER_CRC|**Address:**Filter packets that have an invalid CRC.<br>_Values:_<br>0 = Disabled, 1 = Enabled<br>_Default:_<br> 0|
|S20|FILTER_SOURCE|**Address:**Filter packets that do not have a source address that<br>matches the address specified in register S16.<br>_Values:_<br>0 = Disabled, 1 = Enabled<br>_Default:_<br> 0|
|S21|FILTER_DESTINATION|**Address:**Filter packets that do not have a destination address that<br>matches the modules source address specified in register S15.<br>_Values:_<br>0 = Disabled, 1 = Enabled<br>_Default:_<br> 0|
|S22|FILTER_MULTICAST|**Address:**Filter packets that do not have a destination address that<br>matches the multicast address in specified in register S17.<br>_Values:_<br>0 = Disabled, 1 = Enabled<br>_Default:_<br> 0|
|S23|FILTER_BROADCAST|**Address:**Filter packets that do not have a destination address that<br>matches the broadcast address in specified in register S18.<br>_Values:_<br>0 = Disabled, 1 = Enabled<br>_Default:_<br> 0|
|S24|TXRX_LED|**General:**Enable or disable the TX/RX LED output on module pin 1.<br>When enabled, the LED output will be flashed when data is sent or<br>received by the radio.<br>_Values:_<br>0 = Disabled, 1 = Active-Low Open Drain Output, 2 = Push Pull Output<br>_Default:_<br> 0|
|S26|ESCAPE_SEQ|**General:**Enable or disable the ‘+++’ escape sequence used to enter<br>command mode. This configuration is never stored and will be enabled<br>at module reset.<br>_Values:_<br>0 = Disabled, 1 = Enabled<br>_Default:_<br> 1|



DocID026906 Rev 7 

21/30 

**SP1ML** 

**Module operation** 

**Table 10. Configuration registers (continued)** 

|**#**|**Name**|**Description**|
|---|---|---|
|S27|Source_FILT_MASK|**Address:**An 8-bit source filter mask, used when source filtering is<br>enabled.<br>Values:<br> Any 8-bit hexadecimal value.<br>Default:<br> 0x00|
|S28|PAYLOAD_SIZE|**Packet:**Packet payload size in bytes.<br>Values<br>:1 to 96<br>Default<br>:32|



## **3.5 Information registers** 

**Table 11. Information registers** 

|**#**|**Name**|**Description**|
|---|---|---|
|I0|PER|Packet error rate (%).|
|I1|RSSI|Received signal strength indicator.|
|I2|LQI|Link quality indicator.|
|I3|PQI|Preamble quality indicator.|
|I4|SQI|Synchronization quality indicator.|
|I5|PACKET_COUNT|Count of packets received.|
|I6|PACKETS_LOST|Count of packets lost.|



## **3.6 Example command sequence** 

_Table 12_ shows a typical command sequence to enter command mode, issue AT commands to configure settings of the SPIRIT1 radio and then exit back to operating mode. 

**Table 12. Example configuration AT sequence** 

|**Host command**|**Module response**|**Description**|
|---|---|---|
|**+++**|**OK**<LF><CR>|Escape sequence to put module into command mode<br>from operating mode.|
|**ATS02=38400**|**OK**<LF><CR>|Set the radio data rate to 38400 bps.|
|**ATS03=2**|**OK**<LF><CR>|Set the modulation scheme to GFSK1.|
|**ATS04=+8**|**OK**<LF><CR>|Set the output power to +8 dBm.|
|**AT/C**|**OK**<LF><CR>|Write configuration to EEPROM.|
|**ATO**|**OK**<LF><CR>|Return to operating mode.|



22/30 

DocID026906 Rev 7 

**ECOPACK[®]** 

**SP1ML** 

**5** 

## **4 ECOPACK[®]** 

In order to meet environmental requirements, ST offers these devices in different grades of ECOPACK[®] packages, depending on their level of environmental compliance. ECOPACK[®] specifications, grade definitions and product status are available at: _www.st.com_ . ECOPACK[®] is an ST trademark. 

## **Package mechanical data** 

## **Figure 8. Package mechanical data** 

DocID026906 Rev 7 

23/30 

**SP1ML** 

**Regulatory compliance** 

## **6 Regulatory compliance** 

## **6.1 CE certification** 

The module has been certified in accordance with the following standards: 

EN 300 220-2 V2.4.1 

EN 301 489-01 V1.9.2 

EN 301 489-03 V1.4.1 

## **6.2 FCC certification** 

This module has been tested and found to comply with the FCC part 15 rules. These limits are designed to provide reasonable protection against harmful interference in approved installations. This equipment generates, uses, and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio communications. 

However, there is no guarantee that interference may not occur in a particular installation. 

This device complies with part 15 of the FCC rules. Operation is subject to the following two conditions: (1) This device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation. 

Modifications or changes to this equipment not expressly approved by STMicroelectronics may render void the user's authority to operate this equipment. 

## **Modular approval** 

FCC ID: S9NSP1ML 

In accordance with FCC part 15, the SP1ML-915 is listed as a modular transmitter device. 

This module is evaluated for stand-alone use only. Finished products incorporating multiple transmitters must comply with collocation and RF exposure requirements in accordance with FCC multi-transmitter product procedures. Collocated transmitters operating in portable RF exposure conditions (e.g. <20 cm from persons including but not limited to body-worn and hand-held devices) may require separate approval. 

## **6.3 Labeling instructions** 

When integrating the SP1ML-915 into the final product, the OEM must ensure that the FCC labeling requirements are satisfied. A statement must be included on the exterior of the final product which indicates the product includes a certified module. The label should state the following (or similar wording that conveys the same meaning): 

_Contains FCC ID: S9NSP1ML_ 

## **OR** 

_This product contains FCC ID: S9NSP1ML_ 

24/30 

DocID026906 Rev 7 

**SP1ML** 

**Regulatory compliance** 

The OEM must include the following statements on the exterior of the final product unless the product is too small (e.g. less than 4 x 4 inches): 

_This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) this device may not cause harmful interference, and (2) this device must accept any interference received, including any interference that may cause undesired operation._ 

## **6.4 Product manual instructions** 

This section applies to OEM final products containing the SP1ML-915 module, subject to FCC compliance. The final product manual must contain the following statement (or a similar statement that conveys the same meaning): 

_WARNING: Changes or modifications not expressly approved by the party responsible for compliance could void the user’s authority to operate the equipment_ 

In cases where an OEM seeks Class B (residential) limits for the final product, the following statement must be included in the final product manual: 

_NOTE: This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio communications. However, there is no guarantee that interference will not occur in a particular installation. If this equipment does cause harmful interference to radio or television reception, which can be determined by turning the equipment off and on, the user is encouraged to try to correct the interference by one or more of the following measures:_ 

- _Reorient or relocate the receiving antenna._ 

- _Increase the separation between the equipment and receiver._ 

- _Connect the equipment into an outlet on a circuit different from that to which the receiver is connected._ 

- _Consult the dealer or an experienced radio/TV technician for help._ 

In cases where an OEM seeks the lesser category of a Class A digital device for the final product, the following statement must be included in the final product manual: 

_NOTE: This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment. This equipment generates, uses, and can radiate radio frequency energy and, if not installed and used in accordance with the instruction manual, may cause harmful interference to radio communications. Operation of this equipment in a residential area is likely to cause harmful interference in which case the user will be required to correct the interference at his expense._ 

DocID026906 Rev 7 

25/30 

**SP1ML** 

**Module traceability and marking** 

## **7 Module traceability and marking** 

The standard top-side laser label contains the following information: 

- FCC ID: “S9NSP1ML”. FCC certification information, valid only for SP1ML-915 product family. 

- Model: “MODEL: SP1ML”. Product family identification, SP1ML-868 or SP1ML-915. 

**Figure 9. SP1ML top side** 

Each module is univocally identified by serial number stored in a 2D data matrix laser marked on the bottom side of the module itself. 

**Figure 10. SP1ML bottom side** 

26/30 DocID026906 Rev 7 ~~SEE~~ 

**SP1ML** 

**Module traceability and marking** 

The figure below shows the standard bottom-side QR-code laser marking. 

## **Figure 11. SP1ML QR-code laser marking** 

The serial number has the following format: WW YY K PP NNN 

where: 

- WW - Production week 

- YY - Production year 

- K - Product ID (refer to _Table 13_ below) 

- PP - internal ST use only 

- NNN - internal ST use only 

**Table 13. Module Product ID** 

|**K**|**Product family identification**|
|---|---|
|N|SPSGRF-868|
|O|SPSGRF-915|



Each module bulk package is identified by a bulk ID. 

The Bulk ID and module 2D data matrix are linked by a reciprocal traceability link. The module 2D data matrix traces the lot number of any raw material used. 

DocID026906 Rev 7 

27/30 

**Ordering information** 

**SP1ML** 

## **8 Ordering information** 

**Table 14. Ordering information** 

||**Table 14. Ordering information**|
|---|---|
|**Order code**|**Description**|
|SP1ML-868|868 MHz SPIRIT1 antenna module (Region 1, Europe)|
|SP1ML-915|915 MHz SPIRIT1 antenna module (Region 2, The Americas)|



28/30 

DocID026906 Rev 7 

**SP1ML** 

**Revision history** 

## **9 Revision history** 

**Table 15. Document revision history** 

|**Date**|**Revision**|**Changes**|
|---|---|---|
|24-Oct-2014|1|Initial release.|
|17-Dec-2014|2|– Document status promoted from preliminary to production data.<br>– Updated operating temperature range in_Features_and_Table 1_.|
|27-Apr-2015|3|Updated:_Features_and_Description_.|
|26-Jun-2015|4|Updated:_Features_.|
|29-Jun-2016|5|– Updated_Description_.<br>– Added_Section 1.8: Internal hardware connection for open_<br>_platform_and_Section 7: Module traceability and marking_.<br>– Updated_Figure 6: Recommended footprint_.|
|23-Sep-2016|6|– Updated_Figure 1: Pin placement_.|
|08-Nov-2016|7|– Updated:_Figure 1: Pin placement_and_Figure 2: Internal_<br>_hardware connection for open platform_.|



DocID026906 Rev 7 

29/30 

**SP1ML** 

## **IMPORTANT NOTICE – PLEASE READ CAREFULLY** 

STMicroelectronics NV and its subsidiaries (“ST”) reserve the right to make changes, corrections, enhancements, modifications, and improvements to ST products and/or to this document at any time without notice. Purchasers should obtain the latest relevant information on ST products before placing orders. ST products are sold pursuant to ST’s terms and conditions of sale in place at the time of order acknowledgement. 

Purchasers are solely responsible for the choice, selection, and use of ST products and ST assumes no liability for application assistance or the design of Purchasers’ products. 

No license, express or implied, to any intellectual property right is granted by ST herein. 

Resale of ST products with provisions different from the information set forth herein shall void any warranty granted by ST for such product. 

ST and the ST logo are trademarks of ST. All other product or service names are the property of their respective owners. 

Information in this document supersedes and replaces information previously supplied in any prior versions of this document. 

© 2016 STMicroelectronics – All rights reserved 

30/30 DocID026906 Rev 7