ST I-NUCLEO-LRWAN1 LoRa board

Caution

This page is automatically generated from RIOT doxygen documentation. If you find any issues or have suggestions for improvement, please report them on Github.

View Doxygen Documentation View this board's documentation as generated by Doxygen.

View on GitHub View this board's source code on GitHub.

Tip

When using this board with RIOT, set the BOARD variable to i-nucleo-lrwan1 in your Makefile. If you follow the standard RIOT project structure, your Makefile should look like this:

./Makefile

# name of your application
APPLICATION = hello-world

# Change this to your board if you want to build for a different board
BOARD ?= i-nucleo-lrwan1

# This has to be the absolute path to the RIOT base directory:
RIOTBASE ?= $(CURDIR)/RIOT

include $(RIOTBASE)/Makefile.include

Support for the ST I-NUCLEO-LRWAN1 LoRa board shield

Description

The I-NUCLEO-LRWAN1 board provides LoRa connectivity with an SX1272 radio connected via SPI to an ultra-low power STM32L052T8. microcontroller.

For details, the schematics are available on GitHub.

Note: to use the on-board I2C sensors, the R19 and R20 shorts must be closed (soldered).

Flashing the board

To flash, one needs to use an external ST-Link programmer connected to SWD pins of the JP6 connector.

By default, the flash on the microcontroller is write protected so before being able to flash it, one needs to unlock using the following:

• Apply the following patch to the openocd.sh script:

diff --git a/dist/tools/openocd/openocd.sh b/dist/tools/openocd/openocd.sh
index c59a1939a2..0c359e438c 100755
--- a/dist/tools/openocd/openocd.sh
+++ b/dist/tools/openocd/openocd.sh
@@ -248,6 +248,11 @@ do_flash() {
             -c 'init' \
             -c 'targets' \
             -c 'reset halt' \
+            -c 'stm32lx unlock 0' \
+            -c 'reset halt' \
+            -c 'init' \
+            -c 'targets' \
+            -c 'reset halt' \
             ${OPENOCD_PRE_FLASH_CMDS} \
             -c 'flash write_image erase \"${IMAGE_FILE}\" ${IMAGE_OFFSET} ${IMAGE_TYPE}' \
             ${OPENOCD_PRE_VERIFY_CMDS} \

• Run make flash:

make BOARD=i-nucleo-lrwan1 -C examples/basic/hello-world flash

The command will fail but after that the memory will be unlocked after a power cycle. The line added above in openocd.sh can also be removed.

• Unplug the board and replug-it: the board is now flashable normally.

Note that this unlock procedure only needs to be done once.

Accessing STDIO

STDIO is available on pin 0 and 1 on CN9 so one needs an USB to UART to connect to STDIO.

When flashing using an ST-Link, STDIO pins can be plugged directly to the RX/TX pins on the programmer, STDIO is then accessible like on any Nucleo boards.