April 2018 UM2347 Rev 2 1/60

UM2347

User manual

Getting started with X-CUBE-CLD-GEN IoT cloud generic

software expansion for STM32Cube

Introduction

This user manual describes the content and use of the X-CUBE-CLD-GEN IoT cloud

generic Expansion Package for STM32Cube.

The X-CUBE-CLD-GEN Expansion Package consists of a set of libraries and application

examples for STM32L4 Series, STM32F4 Series, and STM32F7 Series microcontrollers

acting as end devices.

These examples implement IoT cloud applications using the MQTT and HTTP protocols,

over Wi-Fi®, Ethernet, or cellular connections.

X-CUBE-CLD-GEN runs on five platforms:

•The B-L475E-IOT01A and 32F413HDISCOVERY boards support Wi-Fi®connectivity

with an on-board Inventek ISM43362 module

•The 32F769IDISCOVERY board provides a native Ethernet interface

•The P-L496G-CELL01 and P-L496G-CELL02 packs, with the 2G/3G Quectel UG96

and LTE Quectel BG96 cellular modem daughterboards respectively, support cellular

connectivity

For the five platforms, the sample applications configure the network connectivity

parameters, and illustrate the various ways for a device to interact with the cloud.

An application shows how an MQTT client can connect to an MQTT broker in order to

publish data and receive parameter updates or commands from the cloud.

Device authentication through MQTT login and password is supported. TLS encryption,

server authentication and device authentication are supported.

The MQTT broker can be a self-administrated server like Eclipse Mosquitto™, or the

Ubidots or Litmus Loop cloud platforms.

Other applications also demonstrate how a simple HTTP client can connect to either the

Exosite, Grovestreams or Ubidots cloud platforms using the HTTP or HTTPS protocol.

The B-L475E-IOT01A board reports telemetry data such as measurements of humidity,

temperature, 3-axis magnetic, acceleration, and gyroscope data, atmospheric pressure and

distance.

www.st.com

Contents UM2347

2/60 UM2347 Rev 2

Contents

1 General information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2 X-CUBE-CLD-GEN IoT ecosystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

3 Package description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

3.1 General description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

3.2 Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

3.3 Folder structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

3.4 B-L475E-IOT01A board sensors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

3.5 Wi-Fi components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

3.6 Cellular components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

3.7 Reset push-button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

3.8 User push-button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

3.9 User LED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

3.10 Real-time clock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

3.11 mbedTLS configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

4 Hardware and software environment setup . . . . . . . . . . . . . . . . . . . . . 15

5 Application build and flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

6 Interacting with the boards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

7 B-L475E-IOT01A board . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

7.1 Board capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

7.2 Inventek module hardware interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

7.3 Published data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

7.4 Running the application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

8 32F413HDISCOVERY board . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

9 32F769IDISCOVERY board . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

10 P-L496G-CELL01 and P-L496G-CELL02 packs . . . . . . . . . . . . . . . . . . 25