Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web...

46
Version 1.0 (April 7, 2020) Quick Start Guide STM32Cube Function Pack for Asset Tracking with LTE connectivity, GNSS and MEMS sensors Version 1.1 (May 8, 2020)

Transcript of Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web...

Page 1: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

Version 1.0 (April 7, 2020)

Quick Start GuideSTM32Cube Function Pack for Asset Tracking with LTE connectivity, GNSS and MEMS sensors

Version 1.1 (May 8, 2020)

Page 2: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

Agenda

1 Hardware and Software overview

3 Documents & Related Resources

4 STM32 Open Development Environment: Overview

2

2 Setup & Demo Examples

Page 3: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

1- Hardware and Software overview

Page 4: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

P-L496G-CELL02 discovery kitHardware Overview

4

P-L496G-CELL02 Hardware Description

• The STM32 Discovery pack (P-L496G-CELL02) is a turnkey development platform for cellular and cloud technology based solutions.

• The pack contains an STM32L496AGI6-based low-power Discovery mother board and an STMod+ Cellular LTE IoT worldwide expansion

board with antenna.

• It features STM32L496AGI6 Arm®-based microcontroller featuring 1 Mbyte of Flash memory and 320 Kbytes of RAM in a UFBGA169

package

• Board expansion features Quectel BG96 worldwide cellular modem LTE Cat M1/Cat NB1/EGPRS module, 300 kbps downlink, 375 kbps

uplink.

Latest info available at www.st.com

P-L496G-CELL02

Page 5: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

Key products on boardLSM6DSO

MEMS 3D accelerometer (±2/±4/±8/±16 g) + 3D gyroscope

(±125/±250/±500/±1000/±2000 dps)

LIS2DW12

MEMS 3D accelerometer (±2/±4/±8/±16 g)

LIS2MDL

MEMS 3D magnetometer (±50 gauss)

LPS22HH

MEMS pressure sensor, 260-1260 hPa absolute digital output barometer

HTS221

Capacitive digital relative humidity and temperature

STTS751

Digital Temperature sensor

DIL 24-pin

Socket available for additional MEMS adapters and other sensors (UV index)

X-NUCLEO-IKS01A3 Hardware description

•The X-NUCLEO-IKS01A3 is a motion MEMS and environmental sensor evaluation board system.

•It is compatible with the Arduino UNO R3 connector layout, and is designed around ST’s latest sensors.

Motion MEMS and environmental sensors expansion boardHardware Overview

5Latest info available at www.st.com

X-NUCLEO-IKS01A3

DIL 24-pin

Arduino UNO R3 connector

ST morpho connector**HTS221

LPS22HH

LSM6DSO

LIS2DW12

LIS2MDL STTS751

** Connector for the STM32 Nucleo Board

Page 6: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

GNSS expansion boardHardware Overview

6

X-NUCLEO-GNSS1A1 Hardware Description

• The X-NUCLEO-GNSS1A1 expansion board is based on the Teseo-LIV3F tiny GNSS

module.

• It represents an affordable, easy-to-use, global navigation satellite system (GNSS) module,

embedding a Teseo III single die standalone positioning receiver IC, usable in different

configurations in your STM32 Nucleo project.

• The Teseo-LIV3F is a compact (9.7x10.1 mm) module that provides superior accuracy

thanks to the on-board 26 MHz temperature compensated crystal oscillator (TCXO) and a

reduced time-to-first fix (TTFF) with its dedicated 32 KHz real-time clock (RTC) oscillator.

• The Teseo-LIV3F module runs complete GNSS firmware (X-CUBE-GNSS1) to perform all

GNSS operations including acquisition, tracking, navigation and data output without

external memory support.

• The X-NUCLEO-GNSS1A1 expansion board is compatible with the Arduino™ UNO R3

connector and the ST morpho connector, so it can be plugged to the STM32 Nucleo

development board and stacked with additional STM32 Nucleo expansion boards.

Key Products on board

Teseo LIV-3F: Single die standalone positioning receiver IC working on multiple

constellations, 10x10mm compact size.

26MHz Temperature Compensated Crystal Oscillator (TCXO) and reduced Time To First Fix

(TTFF) relying to a 32KHz Real Time Clock (RTC) oscillator for superior accuracy.

Latest info available at www.st.com

X-NUCLEO-GNSS1A1

Tee

Teseo-LIV3F Battery holder

Antenna connector Arduino UNO R3 Connectors

Page 7: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

FP-ATR-LTE1 Software Description

FP-ATR-LTE1 is a STM32Cube Function Pack. That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using standard application layer protocols.

It fully supports security and protocol requirements to interface with AWS cloud thanks to the integrated Amazon AWS IoT SDK.

The DSH-ASSETRACKING dashboard for asset tracking is available to quickly evaluate the firmware package functions for an easy sensor data visualization.

Key features

• Complete firmware to connect a node with GNSS and MEMS sensors to a cellular network using LTE communication technology

• Middleware library with FreeRTOS, mbedTLS and Amazon Web Services SDK.

• Software interface to access GNSS sensor (Teseo-LIV3F), temperature and humidity sensor (HTS221), pressure sensor (LPS22H) and motion sensor (LSM6DSO)

• Example implementation available for X-NUCLEO-GNSS1A1 and X-NUCLEO-IKS01A3 s when connected to a P-L496G-CELL02 LTE cellular to cloud pack.

• Easy portability across different MCU families, thanks to STM32Cube

• Free, user-friendly license terms

FP-ATR-LTE1Software Overview

7

Overall Software Architecture

FP-ATR-LTE1

Latest info available at www.st.com

Page 8: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

2- Setup and demo examples

Page 9: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

9

• STM32 ST-Link Utility• Download and install STSW-LINK004 from www.st.com

• FP-ATR-LTE1• Download FP-ATR-LTE1 package from www.st.com, copy the .zip file content into a folder on your

PC. The package contains binaries and source code with project files (Keil, IAR, System Workbench) based on STM32L496G-DISCOVERY.

• Serial line monitor, e.g. TeraTerm (https://ttssh2.osdn.jp/)

• Chrome web browser (https://www.google.com/chrome/ ); tested with Chrome version

v56.0.2924.76

Software prerequisites

Page 10: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

Hardware prerequisites

10

• 1x P-L496G-CELL02 STM32 discovery pack for cellular to cloud, which contains:

• 1x expansion board with Quectel BG96 LTE modem (for CELL02), compatible with STMod+ connector

• 1x STM32 Discovery development board 32L496GDISCOVERY

• 2G/3G antenna

• 1x STM32 Nucleo expansion board with Teseo-LIV3F GNSS sensor (X-NUCLEO-GNSS1A1)

• 1x STM32 Nucleo expansion board with motion MEMS and environmental sensors (X-NUCLEO-IKS01A3)

• Laptop/PC with Windows 7, 8 or 10

• 1 x micro USB cable

X-NUCLEO-IKS01A3MicroUSB Cable

P-L496G-CELL02 discovery pack

X-NUCLEO-GNSS1A1

Page 11: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

2.1- Cellular pack setup

Page 12: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

Cellular pack set-up using the e-SIM (1/2)

12

• Get your P-L496G-CELL02 Discovery Pack • Open it and follow the getting started instructions from the Discovery Pack Insert Card inner pages

• Note: there is no need to check the position of the jumpers, the setup is fine with the kit delivered as is

• Get the digital ST Voucher from the Pack by using TeraTerm (STLINK serial port 9600, N , 8, 1)

Important Note: do not connect the IKS01A3 and GNSS boards before completing this cellular pack setup

Page 13: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

Cellular pack set-up Using the e-SIM (2/2)

• Go to the ST Concierge Portal (https://www.stm32-c2c.com) • Register & Create an account• Note : You will received and email and click to confirm your email address entered

before to continue…• Add a board using your ST Voucher number• Your pack P-L496G-CELL02 should show up and available services are displayed

13

Page 14: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

Activate Emnify Telecom service (1/3)

14

• From the ST Concierge Portal (https://stm32-c2c.com/)

• Activate the Emnify Telecom service on the Pack embedded SIM

1

2

Click

Click

3

Enter your email address

Enter a password that fulfills the requirement

Click on “Create my account”

Page 15: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

Activate Emnify Telecom service (2/3)

15

• From the ST Concierge Portal (https://stm32-c2c.com/)

• Activate the Emnify Telecom service on the Pack embedded SIM

4 Click

5

Click on

« Skip »

Click on

« SIMs »

6

Page 16: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

Activate Emnify Telecom service (3/3)

16

7 Click on SIM

8Confirmation that the SIM

is actually activated

Page 17: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

Cellular pack set-up using the external SIM

17

P-L496G-CELL02 Hardware Description

• If the Cell02 board you have does not support Emnify Telecom service you can use your local telecom service.

• Use your local telecom service SIM and Insert it to Micro SIM card socket

• The SW will detect it and connect it to your local telecom service provider.

Page 18: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

2.2- Step by step setup

Page 19: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

Connecting the boards

19

X-NUCLEO-IKS01A3

P-L496G-CELL02

+

(back side)

+

X-NUCLEO-GNSS1A1

Page 20: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

GNSS jumpers settings

• The following are the jumper settings on the X-NUCLEO-GNSS1A1 expansion board, as shown in the figure.

• Open jumpers: J1 to J10.

• Closed jumpers: J11 to J15.

20

Page 21: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

Get results in few minutes

21

Download & unpack

FP-ATR-LTE1

Go to www.st.com/stm32ode-fp1

Select FP-ATR-LTE12 3

56Open project examples for

different IDEs

Download and install

STSW-LINK004

Docs

BSP, HAL and DriversAWS IoT SDK, Cellular, FreeRTOS

Asset Tracker application

FP-ATR-LTE1 package structure

4

7

Release Notes

Read First 16 bytes of SIM Id from terminal

Build & Run the application

(or use pre-compiled binaries)

Page 22: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

22

Configure Serial Terminal (1/2)

• Open serial terminal then configure baud rate speed to 115200 (Setup → Serial port in TeraTerm).

Page 23: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

23

Configure Serial Terminal (2/2)

• Configure New-line (Rx:AUTO/Tx:CR+LF) and enable local echo in Terminal configuration (Setup → Terminal in TeraTerm).

Page 24: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

24

Retrieving the SIM ID

• Read First 16 bytes of SIM Id from terminal

Page 25: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

25

Register a new boardinto the asset tracking dashboard

• Visit the DSH-ASSETRACKING page (Link) then click on the Go To Site button at the bottom of the page. Select “Signup” to create a new account, or “Login” to log in an existing account

• Enroll the new device in Dashboard as “Device LTE” and provide the LTE SIM ID as “Device ID” and choose a Device Label of your preference.

• After registration, the file “device_id.cert” will be automatically downloaded.

Page 26: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

26

Copy certificate and key to device (1/3)

• In serial terminal, enter ‘n’ to confirm first default value of AWS IoT endpoint.

• In serial terminal, enter ‘n’ to confirm first default value SIM Id (First 16 bytes) as Device ID.

Page 27: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

27

Copy certificate and key to device (2/3)

• In the serial terminal, enter ‘n’ to confirm first default value of Root CA.

Page 28: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

28

Copy certificate and key to device (3/3)

• Open certificate file “device_id.cert” in a text editor, then copy/paste device certificate and key in serial terminal when requested.

Page 29: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

Data entry process complete

• Now data entry process is complete

• The device will connect to the network and publish data

• Go to the Asset Tracking dashboard to see the published data

29

Page 30: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

2.2- Using the Asset Tracker Web Dashboard (DSH-ASSETRACKING)

Page 31: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

31

• Visit the DSH-ASSETRACKING page (Link) then click on the Go To Site button at the bottom of the page. Select “Login” to log in an existing account

• and provide your username and password.

Login

Page 32: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

Dashboard menu

32

• Go to the “Dashboard” in the left menu to find the list of available devices.

Page 33: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

33

• Select the device you want to monitor. The dashboard will tell you if the device is connected (i.e. sending data to the cloud).

Device select

Page 34: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

34

• Choose the amount of data to display among 3 hours, 6 hours, 1 day, 2 days or 7 days.

Dashboard settings

Page 35: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

• Select desired telemetry data to display.

35

Telemetry

Page 36: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

36

Temperature data displayed

Page 37: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

37

Pressure data displayed

Page 38: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

38

Humidity data displayed

Page 39: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

39

Geo tracking data displayed

Page 40: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

40

• To delete a device from the dashboard click on the trash bin icon.

Device delete

Page 41: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

• To logout from the dashboard, click on “Logout” in the menu.

41

Logout

Page 42: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

3- Documents & Related Resources

Page 43: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

FP-ATR-LTE1:

• DB4191: STM32Cube function pack for asset tracking with LTE connectivity, GNSS and MEMS sensors – data brief

• UM2712: Getting started with the FP-ATR-LTE1 software package for asset tracking with LTE connectivity, GNSS and MEMS sensors – user manual

• Software setup file

DSH-ASSETRACKING:

• DB4207: Cloud Amazon-based web application for asset tracking – data brief

P-L496G-CELL02 :

• Gerber files, BOM, Schematic

• DB3530: STM32 discovery pack for LTE IoT cellular to cloud – data brief

• UM2365: STM32 Discovery pack for LTE IoT cellular to cloud – user manual

X-NUCLEO-IKS01A3:

• Gerber files, BOM, Schematic

• DB3851: Motion MEMS and environmental sensor expansion board for STM32 Nucleo – data brief

• UM2559: Getting started with motion MEMS and environmental sensor expansion board for STM32 Nucleo – user manual

X-NUCLEO-GNSS1A1:

• Gerber files, BOM, Schematic

• DB3458: GNSS expansion board based on Teseo-LIV3F module for STM32 Nucleo – data brief

• UM2327: Getting started with the X-NUCLEO-GNSS1A1 expansion board based on Teseo-LIV3F tiny GNSS module for STM32 Nucleo – user manual

43

All documents are available in the DESIGN tab of the related products webpage

Consult www.st.com for the complete list

Documents and related resources

Page 44: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

4- STM32 Open Development Environment: Overview

Page 45: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

STM32 Open Development EnvironmentFast, affordable Prototyping and Development

45

• The STM32 Open Development Environment (STM32 ODE) is an open, flexible, easy, and affordable way

to develop innovative devices and applications based on the STM32 32-bit microcontroller family combined

with other state-of-the-art ST components connected via expansion boards. It enables fast prototyping with

leading-edge components that can quickly be transformed into final designs

For further information, please visit www.st.com/stm32ode

Function Packs

(FP)

STM32Cube

development software

STM32 Nucleo

expansion boards

(X-NUCLEO)

STM32 Nucleo

development boards

STM32Cube

expansion software

(X-CUBE)

Page 46: Quick Start Guide - STMicroelectronics · That lets you connect your IoT node to Amazon Web Services using LTE cellular connectivity and expose the GNSS and MEMS sensors data using

© STMicroelectronics - All rights reserved.

The STMicroelectronics corporate logo is a registered trademark of the STMicroelectronics

group of companies. All other names are the property of their respective owners.

Thank you