STMicroelectronics P-NUCLEO-LRWAN2 User Manual

STMicroelectronics P-NUCLEO-LRWAN2 User Manual

Starter packs
Table of Contents

Advertisement

Quick Links

Getting started with the P-NUCLEO-LRWAN2 and P-NUCLEO-LRWAN3
Introduction
This user manual describes how to get started with the
Hardware and software setups are discussed in detail, together with the setup of supported network and application servers.
The
P-NUCLEO-LRWAN2
starter pack supports the higher frequency bands (868 MHz and 915 MHz). It includes:
A sensor node based on STMicroelectronics
expansion board with antenna
®
A LoRaWAN
gateway based on STMicroelectronics
expansion board with antenna
The
P-NUCLEO-LRWAN3
starter pack supports the lower frequency bands (433 MHz and 470 MHz). It includes:
A sensor node based on STMicroelectronics
expansion board
®
A LoRaWAN
gateway based on STMicroelectronics
expansion board
Antennas
This user manual also describes the
binary software.
Figure 1.
P-NUCLEO-LRWAN2 and P-NUCLEO-LRWAN3 - LoRaWAN
P-NUCLEO-LRWAN2
Sensor
Pictures are not contractual.
UM2587 - Rev 3 - December 2021
For further information contact your local STMicroelectronics sales office.
P-NUCLEO-LRWAN2
NUCLEO-L073RZ
NUCLEO-F746ZG
NUCLEO-L073RZ
NUCLEO-F746ZG
I-CUBE-LRWAN
STM32Cube Expansion Package for the sensor node, and the gateway
Gateway
and
P-NUCLEO-LRWAN3
®
Nucleo board and USI
I-NUCLEO-LRWAN1
Nucleo board and RisingHF LRWAN_GS_HF1
Nucleo board and RisingHF LRWAN_NS1 LoRa
Nucleo board and RisingHF LRWAN_GS_LF1
®
sensors and gateways
P-NUCLEO-LRWAN3
Gateway
UM2587
User manual
starter packs
starter packs.
®
LoRa
®
Sensor
www.st.com

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the P-NUCLEO-LRWAN2 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for STMicroelectronics P-NUCLEO-LRWAN2

  • Page 1: Figure 1. P-Nucleo-Lrwan2 And P-Nucleo-Lrwan3 - Lorawan ® Sensors And Gateways

    ® Figure 1. P-NUCLEO-LRWAN2 and P-NUCLEO-LRWAN3 - LoRaWAN sensors and gateways P-NUCLEO-LRWAN2 P-NUCLEO-LRWAN3 Gateway Gateway Sensor Sensor Pictures are not contractual. UM2587 - Rev 3 - December 2021 www.st.com For further information contact your local STMicroelectronics sales office.
  • Page 2: Nucleo-Lrwan2 Starter Pack Overview

    Figure 2. STM32 Nucleo LoRaWAN development kit (P-NUCLEO-LRWAN2 starter pack) The antennas in this product are assembled and locked with the boards, which was not the case in earlier versions. They do not have to be removed by users to comply with FCC regulations. The current product packaging is adapted to this configuration.
  • Page 3: Sensor Hardware Overview

    Sensor hardware overview ® P-NUCLEO-LRWAN2 LoRaWAN sensor device has the following key features: Main board • NUCLEO-L073RZ development board (from STMicroelectronics) ® ® – STM32L073RZT6 Cortex -M0+ ultra-low-power MCU at 32 MHz with 192-Kbyte Flash memory, 20-Kbyte SRAM and 6-Kbyte data EEPROM –...
  • Page 4: Figure 3. Stm32 Nucleo Lorawan ® Sensor Device (P-Nucleo-Lrwan2)

    UM2587 Sensor hardware overview ® Figure 3 shows the two boards in the P-NUCLEO-LRWAN2 LoRaWAN sensor device. ® Figure 3. STM32 Nucleo LoRaWAN sensor device (P-NUCLEO-LRWAN2) ST-LINK ® module USB VCOM STM32L073RZT6 microcontroller Sensors: LSM303AGR LPS22HB HTS221 NUCLEO-L073RZ I-NUCLEO-LRWAN1 main board...
  • Page 5: I-Nucleo-Lrwan1 Lora ® Hf Band And Sensor Expansion Board

    UM2587 Sensor hardware overview 1.1.1 ® I-NUCLEO-LRWAN1 LoRa HF band and sensor expansion board ® I-NUCLEO-LRWAN1 is supplied by a third party (USI ). For complete and latest information, refer to the third party GitHub page https://github.com/USILoRaModule/USI_I-NUCLEO-LRWAN1. Figure 4. I-NUCLEO-LRWAN1 block diagram and connectors ADC 1 –...
  • Page 6: Gateway Hardware Overview

    P-NUCLEO-LRWAN2 LoRaWAN gateway shown in Section 1.2 has the following key features: Gateway main board • NUCLEO-F746ZG development board (from STMicroelectronics) ® ® – STM32F746ZGT6 Cortex -M7 high-performance MCU at 216 MHz with 1-Mbyte Flash memory and 320-Kbyte SRAM –...
  • Page 7: Figure 5. Stm32 Nucleo Lorawan ® Gateway (P-Nucleo-Lrwan2)

    UM2587 Gateway hardware overview ® Figure 5. STM32 Nucleo LoRaWAN gateway (P-NUCLEO-LRWAN2) Gateway additional features • Programmable parallel demodulation paths ® • LoRa demodulators and 1 GFSK demodulator embedded • Single +5 V supply • AT command interface to re-configure the parameters of the gateway –...
  • Page 8: Gateway Expansion Board

    PF10 – GPIO3 PE12 – SCK PE14 – MOSI USB for external 5 V supply Table 1. P-NUCLEO-LRWAN2 gateway expansion board pins description Pin name Pin description Power supply to NUCLEO-F746ZG from external 5 V PF5/PD12/PC4/PB9 -GPIO4 GPIO4 from SX1301...
  • Page 9: Figure 7. Hardware Architectures Of The P-Nucleo-Lrwan2 Gateway Expansion Board

    Backup CSN of SPI for SX1301 PD14-CSN (optional) (no connection on board in default) Figure 7 presents the architecture of the LRWAN_GS_HF1 gateway expansion board. Figure 7. Hardware architectures of the P-NUCLEO-LRWAN2 gateway expansion board Balun LTCC LPF Transceiver SX1257 868 MHz...
  • Page 10: Nucleo-Lrwan3 Starter Pack Overview

    UM2587 P-NUCLEO-LRWAN3 starter pack overview P-NUCLEO-LRWAN3 starter pack overview ® Figure 8 shows an overview of the P-NUCLEO-LRWAN3 starter pack, which includes a LoRaWAN sensor device and gateway as well as the antennas. Instructions at the back of the insert card guide the users on how to power up and configure the sensor device and gateway and setup the network.
  • Page 11: Sensor Hardware Overview

    Sensor hardware overview ® P-NUCLEO-LRWAN3 LoRaWAN sensor device has the following key features: Main board • NUCLEO-L073RZ development board (from STMicroelectronics) ® ® – STM32L073RZT6 Cortex -M0+ ultra-low-power MCU at 32 MHz with 192-Kbyte Flash memory, 20-Kbyte SRAM and 6-Kbyte data EEPROM –...
  • Page 12: Figure 9. Stm32 Nucleo Lorawan ® Sensor Device (P-Nucleo-Lrwan3)

    UM2587 Sensor hardware overview ® Figure 9 shows the two boards in P-NUCLEO-LRWAN3 LoRaWAN sensor device. ® Figure 9. STM32 Nucleo LoRaWAN sensor device (P-NUCLEO-LRWAN3) Sensors: LSM6DS3 LPS22HB LIS3MDL HTS221 ST-LINK USB VCOM STM32L073RZT6 microcontroller RisingHF module NUCLEO-L073RZ LRWAN_NS1 main board expansion board UM2587 - Rev 3 page 12/55...
  • Page 13: Lrwan_Ns1 Lora ® Lf Band And Sensor Expansion Board

    UM2587 Sensor hardware overview 2.2.1 ® LRWAN_NS1 LoRa LF band and sensor expansion board The LRWAN_NS1 is supplied by a third party (RisingHF). For complete and latest information, refer to LRWAN_NS1 reference manual [2]. Figure 10. LRWAN_NS1 block diagram and connectors UM2587 - Rev 3 page 13/55...
  • Page 14: Gateway Hardware Overview

    P-NUCLEO-LRWAN3 LoRaWAN gateway shown in Figure 11 has the following key features: Gateway main board • NUCLEO-F746ZG development board (from STMicroelectronics) ® ® – STM32F746ZGT6 Cortex -M7 high-performance MCU at 216 MHz with 1-Mbyte Flash memory and 320-Kbyte SRAM –...
  • Page 15: Figure 11. Stm32 Nucleo Lorawan ® Gateway (P-Nucleo-Lrwan3)

    UM2587 Gateway hardware overview ® Figure 11. STM32 Nucleo LoRaWAN gateway (P-NUCLEO-LRWAN3) Gateway additional features • Programmable parallel demodulation paths ® • LoRa demodulators and 1 GFSK demodulator embedded • Single +5 V supply • AT command interface to re-configure the parameters of the gateway –...
  • Page 16: Gateway Expansion Board

    UM2587 Gateway hardware overview 2.3.1 Gateway expansion board The gateway expansion board shown in is designed by RisingHF (www.risinghf.com). It includes a Semtech ® SX1301 digital baseband circuit integrating the LoRa concentrator, Semtech SX1255 LF front-end transceiver module, and two SAW filters to achieve a wider bandwidth range (434 MHz to 470 MHz). The expansion board is controlled by the NUCLEO-F746ZG via the SPI interface.
  • Page 17: Figure 13. Hardware Architecture Of The P-Nucleo-Lrwan3 Gateway Expansion Board

    UM2587 Gateway hardware overview Pin name Pin description PE13-MISO MISO of SPI for SX1301 PE12-SCK SCK of SPI for SX1301 PE14-MOSI MOSI of SPI for SX1301 PE15-RST Reset for SX1301 PD15-Band Set1 ST Nucleo LoRa GW LF • PE9=0, PD15=1: band EU433 PE9-Band Set2 •...
  • Page 18: Nucleo-Lrwan2 / P-Nucleo-Lrwan3 Firmware Overview

    UM2587 P-NUCLEO-LRWAN2 / P-NUCLEO-LRWAN3 firmware overview P-NUCLEO-LRWAN2 / P-NUCLEO-LRWAN3 firmware overview P-NUCLEO-LRWAN2 P-NUCLEO-LRWAN3 starter packs include the following firmware: ® • I-CUBE-LRWAN LoRaWAN STM32Cube Expansion Package for the microcontrollers in the STM32L0 Series, STM32L1 Series, STM32L4 Series, and STM32L4+ Series ®...
  • Page 19: Table 3. At Command List

    AT command and logging UART interface baud rate. The gateway firmware binary is available upon request directly from STMicroelectronics. To reprogram the board, copy and paste, or drag and drop the binary file to the mbed storage device of the NUCLEO-F746ZG.
  • Page 20: Figure 15. Programming The Gateway Using A Binary File

    UM2587 STM32F7 Nucleo LoRaWAN® gateway firmware Figure 15. Programming the gateway using a binary file At startup, firmware checks for frequency band setting compatibility versus RF hardware. It displays a warning if the setting is not compatible with the hardware. UM2587 - Rev 3 page 20/55...
  • Page 21: Nucleo-Lrwan1 Sensor Device Setup And Reconfiguration

    UM2587 I-NUCLEO-LRWAN1 sensor device setup and reconfiguration I-NUCLEO-LRWAN1 sensor device setup and reconfiguration This section describes the steps to setup the I-NUCLEO-LRWAN1 sensor device and if necessary, reconfigure it to the desired frequency band. By default, the device is configured for the EU868 frequency band and in the OTAA mode.
  • Page 22: Extracting Deveui And Appeui From The Lora ® Module

    (OTAA/ABP), the pieces of information presented in Table 4 need to be extracted from the ® LoRa module (default) or changed. Table 4. Device activation and parameters (P-NUCLEO-LRWAN2) End-device Parameters Description activation 64-bit global unique ID that uniquely identifies the end-device (IEEE EUI64 DevEUI address).
  • Page 23: Figure 19. I-Nucleo-Lrwan1 Expansion Board Serial Port

    STM32 ST-LINK Utility (STSW-LINK004) or the STM32CubeProgrammer (STM32CubeProg). Follow these steps to extract DevEUI and AppEUI using the STM32 ST-LINK Utility: Download STM32 ST-LINK Utility (STSW-LINK004) from STMicroelectronics web site and install it Connect the NUCLEO-L073RZ Nucleo board with the personal computer by means of the USB ®...
  • Page 24: Reconfiguring The Sensor Device Using The At_Master Project

    UM2587 Reconfiguring the sensor device using the AT_Master project Reconfiguring the sensor device using the AT_Master project Edit firmware to change join mode, frequency band, device IDs, and keys. More parameters are reconfigurable. The following examples show functions used to set these parameters in user firmware. In file main.c: #define JOIN_MODE OTAA_JOIN_MODE /*ABP_JOIN_MODE*/ /*LoRaWan join method*/ In file lora_driver.c:...
  • Page 25: Lrwan_Ns1 Sensor Device Setup And Reconfiguration

    UM2587 LRWAN_NS1 sensor device setup and reconfiguration LRWAN_NS1 sensor device setup and reconfiguration This section describes the steps to setup the LRWAN_NS1 sensor device and if necessary, reconfigure it to the desired frequency band. By default, the device is configured for the CN470Prequel frequency band and in the OTAA mode.
  • Page 26: Extracting Deveui And Appeui From The Lora ® Module

    UM2587 Extracting DevEUI and AppEUI from the LoRa® module Allow the personal computer to enumerate and install the USB drivers. Take note of the Virtual COM port number assigned to the board. Note: the Nucleo board is also enumerated as an mbed removable storage device. Figure 22.
  • Page 27: Table 5. Device Activation And Parameters (P-Nucleo-Lrwan3)

    UM2587 Extracting DevEUI and AppEUI from the LoRa® module Table 5. Device activation and parameters (P-NUCLEO-LRWAN3) End-device Parameters Description activation 64-bit global unique ID that uniquely identifies the end-device (IEEE EUI64 DevEUI address). 64-bit application ID that uniquely identifies the application provider (owner) of AppEUI the end-device (IEEE EUI64 address).
  • Page 28: Reconfiguring The Sensor Device Using The At_Master Project

    STM32 ST-LINK Utility (STSW-LINK004) or the STM32CubeProgrammer (STM32CubeProg). Follow these steps to extract DevEUI and AppEUI using the STM32 ST-LINK Utility: Download STM32 ST-LINK Utility (STSW-LINK004) from STMicroelectronics web site and install it Connect the NUCLEO-L073RZ Nucleo board with the personal computer by means of the USB ®...
  • Page 29: Gateway Setup And Configuration

    UM2587 Gateway setup and configuration Gateway setup and configuration The gateway is a simple packet forwarder based on the Semtech packet forwarder protocol. It needs to be ® configured to the desired frequency band and LoRaWAN network server among other parameters that are reconfigurable.
  • Page 30: Configuring The Gateway To Use A Different Frequency Band

    Figure 25. Gateway parameter settings P-NUCLEO-LRWAN2 The default setting of the LRWAN_GS_HF1 gateway is set to the EU868 frequency band and Loriot EU1 server. P-NUCLEO-LRWAN3 The default setting of the LRWAN_GS_LF1 gateway is set to the CN470Prequel frequency band and Loriot CN1 server.
  • Page 31: Table 6. Predefined Frequency Channel Plans

    UM2587 Configuring the gateway to use a different frequency band • Format: AT+CH=0~7,freq,radio // Set multi SF LoRa channel AT+CH=8,freq,radio,sf,bw // Set standard LoRa channel AT+CH=9,freq,radio // Set FSK channel AT+CH=0~9,0 // Turn off a channel AT+CH=0~9,OFF // Turn off a channel AT+CH=band // Set to predefined channel plan •...
  • Page 32 Reset the board for the new setting to take effect or use the AT+RESET command. The new frequency channels are displayed after reset. Use AT+SYS to view the configuration again. Display for the P-NUCLEO-LRWAN2: VERSION: 2.1.7, Nov 6 2018 LOG: OFF...
  • Page 33: Changing The Lorawan ® Server, Mac Address, And Gateway Eui

    UM2587 Changing the LoRaWAN® server, MAC address, and gateway EUI Display for the P-NUCLEO-LRWAN3: VERSION: 2.1.7, Nov 6 2018 LOG: OFF AT ECHO: ON BAUDRATE: 115200bps MACADDR: xx:xx:xx:xx:xx:xx ETHERNET: DHCP DNS1: 114.114.114.114 DNS2: 8.8.8.8 NTP SERVER: 1.ubuntu.pool.ntp.org EUI PADDING: {3, FF}, {4, FF} GATEWAY ID: XXXXXXXXXXXXXXXX LORAWAN: Public LORAWAN SERVER: cn1.loriot.io...
  • Page 34: Network Server Setup

    Refer to the Loriot website for more details about their offer. The default network server setting for the P-NUCLEO-LRWAN2 gateway is: eu1.loriot.io. The corresponding Loriot network server that the user needs to create an account from must be EU1 – Frankfurt, Germany.
  • Page 35: Device Registration To Loriot Network Server

    Click [Register Packet Forwarder STM gateway] From the Loriot dashboard, select the added gateway to view its detailed information Edit the channel plan parameter and select the desired region frequency. The P-NUCLEO-LRWAN2 gateway default region frequency is EU868_Semtech. The P-NUCLEO-LRWAN3 gateway default region...
  • Page 36: Loriot Default Application Output

    UM2587 Loriot network server setup Go to the device details by clicking on the link corresponding to the recently-enrolled device. If the device has successfully joined the network, the Last data (10 latest records) sent by the device is visible. Note that the page may need to be refreshed to display the latest message entries.
  • Page 37: Setup The Cayenne Data Output In Loriot

    UM2587 The Things Network (TTN) v3 server setup Figure 30. WebSocket sample by LORIOT 7.1.4 Setup the Cayenne data output in Loriot The network server can also be configured to forward the data to a third-party application server like myDevices Cayenne: In [Loriot Dashboard]>[Application]>[SampleApp]>[Output], click on [Add new output] Select [myDevices Cayenne] from the list of supported data output types...
  • Page 38: Gateway Registration To The Things Network V3 Server

    UM2587 The Things Network (TTN) v3 server setup 7.2.1 Gateway registration to The Things Network v3 server Follow the procedure below to register the gateway to The Things Network server: Figure 32. The Things Network gateway registration UM2587 - Rev 3 page 38/55...
  • Page 39: Figure 33. The Things Network Registered Gateway Overview

    UM2587 The Things Network (TTN) v3 server setup Configure the gateway to send data to the closest router address. The list of routers is available from The Things Network website at www.thethingsnetwork.org/docs/gateways/packet-forwarder/semtech-udp.html. A gateway configuration example is: eu1.cloud.thethings.network. Use the following AT command to configure the gateway packet forwarder to connect to The Things Network on UDP port 1700: AT+PKTFWD=eu1.cloud.thethings.network,1700,1700 In [The Things Network Console Console], click on [Gateways]>[Add Gateway].
  • Page 40: Device Registration To The Things Network V3 Server

    • For the US region: nam1.cloud.thethings.network • For the AU region: au1.cloud.thethings.network For a US configuration with P-NUCLEO-LRWAN2 or P-NUCLEO-LRWAN3, the user can set the preferred frequency sub band (FSB) as described in Table Table 7. US FSB hybrid channels setting by AT commands...
  • Page 41: Figure 34. The Things Network Application Overview

    Click on [Add end device]. Select the end device type. For example, when using an STM32WL-based device such as the NUCLEO- WL55JC1, choose: – [Brand]: STMicroelectronics – [Model]: NUCLEO-WL55JC1 – [Profile (Region)]: EU_868_870 In the section Enter registration data, provide the necessary information: –...
  • Page 42: Figure 35. The Things Network End Device Registration

    UM2587 The Things Network (TTN) v3 server setup Click on [Register end device] to complete the registration. Figure 35. The Things Network end device registration UM2587 - Rev 3 page 42/55...
  • Page 43: Figure 36. The Things Network Registered Device Overview

    UM2587 The Things Network (TTN) v3 server setup The device overview shows the credentials and status of the last packets received from the device. Figure 36. The Things Network registered device overview UM2587 - Rev 3 page 43/55...
  • Page 44: Setup The Mydevices Cayenne Integration In The Things Network V3

    UM2587 The Things Network (TTN) v3 server setup Select the Live data tab to view the packets received. The data can also be viewed from the Applications overview panel where it displays the data received from all registered devices in the application. Figure 37.
  • Page 45: Figure 38. Cayenne Webhook Template Selection

    UM2587 The Things Network (TTN) v3 server setup Figure 38. Cayenne webhook template selection Figure 39. Cayenne webhook settings Refer to Section 8 to setup the myDevices Cayenne dashboard. UM2587 - Rev 3 page 45/55...
  • Page 46: Application Server Setup

    UM2587 Application server setup Application server setup ® This section describes how to register the sensor device to a LoRa application server. The following application server providers are supported: • myDevices Cayenne myDevices Cayenne application setup Go to myDevices web site at https://mydevices.com/ and create a free myDevices Cayenne account. The free ®...
  • Page 47: Figure 41. Selecting A Lora ® Device

    UM2587 myDevices Cayenne application setup ® Select STM32 P-NUCLEO-LRWAN2 from the list of supported LoRa devices ® Figure 41. Selecting a LoRa device Enter the device settings, then add the device For Loriot: Name DevEUI (refer to [Loriot Dashboard]>[Application]>[SampleApp]>[Devices]. Remove “-” or “:”) Loriot server (the server used at Loriot account creation: eu1.loriot.io)
  • Page 48: Cayenne Dashboard

    UM2587 myDevices Cayenne application setup 8.1.2 Cayenne dashboard The pockets sent by the device are using the Cayenne low-power payload (LPP) format by default in the firmware code. As soon as pockets are received in Cayenne, the widgets automatically appear in the dashboard depending on the data types used in the data payload.
  • Page 49: References

    Refer to STMicroelectronics web site at www.st.com. 1. This URL belongs to a third party. It is active at document publication, however STMicroelectronics shall not be liable for any change, move or inactivation of the URL or the referenced material.
  • Page 50: Revision History

    Changes 25-Sep-2019 Initial release. P-NUCLEO-LRWAN2 boards delivered with mounted antennas: updated Introduction, Section 1 P-NUCLEO-LRWAN2 starter pack overview, Section 21-Apr-2021 4.1 Sensor device setup, Section 5.1 Sensor device setup, and Section 6.1 Gateway setup. Updated the registration procedure and configuration parameters in Section 7.2 The Things Network (TTN) v3 server setup...
  • Page 51: Table Of Contents

    P-NUCLEO-LRWAN2 starter pack overview........
  • Page 52 UM2587 Contents 7.1.2 Device registration to Loriot network server ........35 7.1.3 Loriot default application output .
  • Page 53: List Of Tables

    P-NUCLEO-LRWAN2 gateway expansion board pins description ........
  • Page 54: List Of Figures

    STM32 Nucleo LoRaWAN gateway (P-NUCLEO-LRWAN2) ........7 Figure 6.
  • Page 55 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.

This manual is also suitable for:

P-nucleo-lrwan3

Table of Contents