Release Notes for FP-ATR-LORA1

Copyright © 2018 STMicroelectronics

  

FP-ATR-LORA1 is an STM32Cube function pack which lets you read data from environmental and motion sensors, retrieve geo-position from GNSS and send collected data via LoRaWAN connectivity.

The package implements low power profiles and related transitions to ensure long battery autonomy.

This software together with the suggested combination of STM32 and ST devices can be used, for example, to develop asset tracking, fleet management and pet/child tracking applications.

The software runs on the STM32 microcontroller and includes drivers for the LoRa radio, Teseo-LIV3F GNSS module, the motion and environmental sensors, and the power management.

The software is provided for STM32L072CZ MCUs and it is easily portable across different MCU families thanks to STM32Cube. It provides implementation examples for:
B-L072Z-LRWAN1 Discovery Kit equipped with the X-NUCLEO-GNSS1A1 expansion board, featuring a GNSS receiver based on Teseo-LIV3F module, and the X-NUCLEO-IKS01A2 motion MEMS and environmental sensor expansion board
or
STEVAL-STRKT01 evaluation board, embedding CMWX1ZZABZ-091 LoRa® module (by Murata) to transmit and receive data over a LoRaWAN™ network, a Teseo-LIV3F GNSS module, a LIS2DW12 accelerometer and HTS221 and LPS22HB environmental sensors.

The FP-ATR-LORA1 features:

•   Complete firmware to connect an IoT node to a LoRaWAN network, sending geo-position coming from GNSS and environmental and sensor data

•   Middleware library supporting LoRaWAN specification 1.0.2 class A

•   Teseo-LIV3F-based GNSS positioning

•   Sample implementation available for X-NUCLEO-GNSS1A1 and X-NUCLEO-IKS01A2 expansion boards connected to a B-L072Z-LRWAN1 development board

•   Easy portability across different MCU families, thanks to STM32Cube

•   Free, user-friendly license terms

Main Changes

•  Updated LoRa middleware.

•  Updated USB middleware.

•  Bug fixes

Content

º  Drivers

–  STM32L0xx HAL V1.10.2 (release notes).

–  BSP Component X-NUCLEO-GNSS1A1 V2.0.0 (release notes).

–  BSP Component X-NUCLEO-IKS01A2 V5.0.0 (release notes).

–  BSP Common V1.0.0 (release notes).

º  Middleware

–  LRWAN1 V1.3.1 (readme.txt) 

–  LibGNSS V2.0.0 (release notes)

–  NMEA library V1.1.0 (release notes).

º  Application

–  LORA asset tracker for B-L072Z-LRWAN1 (see the readme.txt) and STEVAL-STRKT01 (see the readme.txt).

Development Toolchains and Compilers

•  RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.27.1 + ST- Link

•  IAR Embedded Workbench for ARM (EWARM) toolchain V8.32.3 + ST-Link

•  System Workbench for STM32 (SW4STM32) toolchain V2.9.0 + ST-Link

Supported Devices and EVAL boards

•  STEVAL-STRKT01 evaluation board

•  B-L072Z-LRWAN1 discovery kit

•  X-NUCLEO-GNSS1A1 expansion board

•  X-NUCLEO-IKS01A2 expansion board

Main Changes

•  Power management optimizations

•  Bug fixes

Content

º  Drivers

–  STM32L0xx HAL V1.8.1 (release notes).

–  BSP Component X-NUCLEO-GNSS1A1 V2.0.0 (release notes).

–  BSP Component X-NUCLEO-IKS01A2 V5.0.0 (release notes).

–  BSP Common V1.0.0 (release notes).

º  Middleware

–  LRWAN1 V1.2.1 (readme.txt) 

–  LibGNSS V2.0.0 (release notes)

–  NMEA library V1.1.0 (release notes).

º  Application

–  LORA asset tracker for B-L072Z-LRWAN1 (see the readme.txt) and STEVAL-STRKT01 (see the readme.txt).

Development Toolchains and Compilers

•  RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.26.2 + ST- Link

•  IAR Embedded Workbench for ARM (EWARM) toolchain V8.20.2 + ST-Link

•  System Workbench for STM32 (SW4STM32) toolchain V2.7.0 + ST-Link

Supported Devices and EVAL boards

•  STEVAL-STRKT01 evaluation board

•  B-L072Z-LRWAN1 discovery kit

•  X-NUCLEO-GNSS1A1 expansion board

•  X-NUCLEO-IKS01A2 expansion board

Main Changes

•  Application state machine review

•  Datalog download over the air

•  Various bug fixes

Content

º  Drivers

–  STM32L0xx HAL V1.8.1 (release notes).

–  BSP Component X-NUCLEO-GNSS1A1 V2.0.0 (release notes).

–  BSP Component X-NUCLEO-IKS01A2 V5.0.0 (release notes).

–  BSP Common V1.0.0 (release notes).

º  Middleware

–  LRWAN1 V1.2.1 (readme.txt) 

–  LibGNSS V2.0.0 (release notes)

–  NMEA library V1.1.0 (release notes).

º  Application

–  LORA asset tracker for B-L072Z-LRWAN1 (see the readme.txt) and STEVAL-STRKT01 (see the readme.txt).

Development Toolchains and Compilers

•  RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.26.2 + ST- Link

•  IAR Embedded Workbench for ARM (EWARM) toolchain V8.20.2 + ST-Link

•  System Workbench for STM32 (SW4STM32) toolchain V2.7.0 + ST-Link

Supported Devices and EVAL boards

•  STEVAL-STRKT01 evaluation board

•  B-L072Z-LRWAN1 discovery kit

•  X-NUCLEO-GNSS1A1 expansion board

•  X-NUCLEO-IKS01A2 expansion board

Main Changes

•  Fixed compilation issue

Content

º  Drivers

–  STM32L0xx HAL V1.8.1 (release notes).

–  BSP Component X-NUCLEO-GNSS1A1 V2.0.0 (release notes).

–  BSP Component X-NUCLEO-IKS01A2 V5.0.0 (release notes).

–  BSP Common V1.0.0 (release notes).

º  Middleware

–  LRWAN1 V1.2.1 (readme.txt) 

–  LibGNSS V2.0.0 (release notes)

–  NMEA library V1.1.0 (release notes).

º  Application

–  LORA asset tracker for B-L072Z-LRWAN1 (see the readme.txt) and STEVAL-STRKT01 (see the readme.txt).

Development Toolchains and Compilers

•  RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.26.2 + ST- Link

•  IAR Embedded Workbench for ARM (EWARM) toolchain V8.20.2 + ST-Link

•  System Workbench for STM32 (SW4STM32) toolchain V2.7.0 + ST-Link

Supported Devices and EVAL boards

•  STEVAL-STRKT01 evaluation board

•  B-L072Z-LRWAN1 discovery kit

•  X-NUCLEO-GNSS1A1 expansion board

•  X-NUCLEO-IKS01A2 expansion board

Main Changes

•  Application updated

•  Geofence support

•  Datalogging in external EEPROM

•  LoRa keys provisioning via usb commands

Content

º  Drivers

–  STM32L0xx HAL V1.8.1 (release notes).

–  BSP Component X-NUCLEO-GNSS1A1 V2.0.0 (release notes).

–  BSP Component X-NUCLEO-IKS01A2 V5.0.0 (release notes).

–  BSP Common V1.0.0 (release notes).

º  Middleware

–  LRWAN1 V1.2.1 (readme.txt) 

–  LibGNSS V2.0.0 (release notes)

–  NMEA library V1.1.0 (release notes).

º  Application

–  LORA asset tracker for B-L072Z-LRWAN1 (see the readme.txt) and STEVAL-STRKT01 (see the readme.txt).

Development Toolchains and Compilers

•  RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.26.2 + ST- Link

•  IAR Embedded Workbench for ARM (EWARM) toolchain V8.20.2 + ST-Link

•  System Workbench for STM32 (SW4STM32) toolchain V2.7.0 + ST-Link

Supported Devices and EVAL boards

•  STEVAL-STRKT01 evaluation board

•  B-L072Z-LRWAN1 discovery kit

•  X-NUCLEO-GNSS1A1 expansion board

•  X-NUCLEO-IKS01A2 expansion board

Main Changes

•  Added STEVAL-STRKT01 support.

Content

º  Drivers

–  STM32L0xx HAL V1.8.1 (release notes).

–  BSP Component X-NUCLEO-GNSS1A1 V2.0.0 (release notes).

–  BSP Component X-NUCLEO-IKS01A2 V5.0.0 (release notes).

–  BSP Common V4.0.1 (release notes).

º  Middleware

–  LRWAN1 V1.2.0 (readme.txt) 

– LibGNSS V2.0.0 (release notes)

–  NMEA library V1.1.0 (release notes).

º  Application

–  LORA asset tracker for B-L072Z-LRWAN1 (see the readme.txt) and STEVAL-STRKT01 (see the readme.txt).

Development Toolchains and Compilers

•  RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.24.2 + ST- Link

•  IAR Embedded Workbench for ARM (EWARM) toolchain V8.20.1 + ST-Link

•  System Workbench for STM32 (SW4STM32) toolchain V2.4.0 + ST-Link

Supported Devices and EVAL boards

•  STEVAL-STRKT01 evaluation board

•  B-L072Z-LRWAN1 discovery kit

•  X-NUCLEO-GNSS1A1 expansion board

•  X-NUCLEO-IKS01A2 expansion board

Main Changes

•  Fixed GPIO initialization.

Content

º  Drivers

–  STM32L0xx HAL V1.8.1 (release notes).

–  BSP Component X-NUCLEO-GNSS1A1 V2.0.0 (release notes).

–  BSP Component X-NUCLEO-IKS01A2 V5.0.0 (release notes).

–  BSP Common V4.0.1 (release notes).

º  Middleware

–  LRWAN1 V1.2.0 (readme.txt) 

– LibGNSS V2.0.0 (release notes)

–  NMEA library V1.1.0 (release notes).

º  Application

–  LORA asset tracker.

  see the readme.txt.

Development Toolchains and Compilers

•  RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.24.2 + ST- Link

•  IAR Embedded Workbench for ARM (EWARM) toolchain V8.20.1 + ST-Link

•  System Workbench for STM32 (SW4STM32) toolchain V2.4.0 + ST-Link

Supported Devices and EVAL boards

•  B-L072Z-LRWAN1 discovery kit

•  X-NUCLEO-GNSS1A1 expansion board

•  X-NUCLEO-IKS01A2 expansion board

Main Changes

•  First release.

Content

º  Drivers

–  STM32L0xx HAL V1.8.1 (release notes).

–  BSP Component X-NUCLEO-GNSS1A1 V2.0.0 (release notes).

–  BSP Component X-NUCLEO-IKS01A2 V5.0.0 (release notes).

–  BSP Common V4.0.1 (release notes).

º  Middleware

–  LRWAN1 V1.2.0 (readme.txt) 

– LibGNSS V2.0.0 (release notes)

–  NMEA library V1.1.0 (release notes).

º  Application

–  LORA asset tracker.

  see the readme.txt.

Development Toolchains and Compilers

•  RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.24.2 + ST- Link

•  IAR Embedded Workbench for ARM (EWARM) toolchain V8.20.1 + ST-Link

•  System Workbench for STM32 (SW4STM32) toolchain V2.4.0 + ST-Link

Supported Devices and EVAL boards

•  B-L072Z-LRWAN1 discovery kit

•  X-NUCLEO-GNSS1A1 expansion board

•  X-NUCLEO-IKS01A2 expansion board

This software package is licensed under ST license SLA0055, (the "License"). You may not use this package except in compliance with the License. You may obtain a copy of the License at:

SLA0055: SOFTWARE LICENSE AGREEMENT

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

For complete documentation on STM32 Microcontrollers visit www.st.com/STM32