Download FreeRTOS
 

Quality RTOS & Embedded Software

LIBRARIES
WHAT'S NEW
Simplifying Authenticated Cloud Connectivity for Any Device.
Designing an energy efficient and cloud-connected IoT solution with CoAP.
Introducing FreeRTOS Kernel version 11.0.0:
FreeRTOS Roadmap and Code Contribution process.
OPC-UA over TSN with FreeRTOS.

STM32L4+

by STMicroelectronics

The STM32L4+ has been configured to work with the AWS Quick Connect demo. This demo uses AWS services to take care of the AWS account creation and AWS IoT configuration required to connect your device to AWS IoT. Once connected, messages containing data collected from sensors are sent from the device, allowing you to simulate AWS IoT applications.

To begin the Quick Connect demo:

Step 1: Connect the STM32L4+ Discovery Kit to a computer using a USB 2.0 cable (Micro B). (Check the manufacturer's documentation that came with your board for the correct USB port to use.)

Step 2: Download the Quick Connect setup package for the computer you will use to set up the STM32L4+ board.
Download quickconnect-st-windows.x64.zip for Windows.
Download quickconnect-st-linux.x64.tar.gz for Linux.
Download quickconnect-st-macos.x64.tar.gz for Mac.

Note: Mac users may face issues while updating credentials on the device when using the DIS_L4S5VI (BL4S5IIO01A$CU2) version of the STM32L4+ Discovery Kit. If so, see the troubleshooting section below.

Step 3: For Windows users, download and install the ST-Link USB driver which can be found here.
For Linux users, the currently logged in user should have read and write access to the serial port over USB. On most Linux distributions, this is done by adding the user to dialout group with the following command:

sudo usermod -a -G dialout $USER
Make sure you re-login to enable read and write permissions for the serial port.

Step 4: Unzip the Quick Connect archive, and run the file Start_Quick_Connect.
Note: You may receive warnings while trying to run the application. If so, see the troubleshooting section below.

Step 5: Follow & complete all of the prompts in the command line interface.
Note: This board only supports 2.4 GHz wifi connections. The device will disconnect/reconnect several times during the provisioning process, which is normal.

Step 6: When Start_Quick_Connect is complete, a file called CLICK-ME.html will be created in the same directory. Double-click CLICK-ME.html to open a custom URL where you can visualize data from the sensors on your STM32L4+ board.


To update the Quick Connect demo:

Step 1 Set up the integrated development environment (IDE) - skip this step if already set up:
Go to ST.com.
Create an account, or sign in with an existing account.
Download and set up STM32CubeProgrammer.
Download and set up STM32Cube.
Download and unzip the source code.
Optional: You can see the source code for SECoreBin, STSAFE_Provisioning and SBSFU Projects by downloading X-CUBE-AWS.

Step 2 Load the quick connect project:
Open STM32CubeIDE, Select the STM32L4_AWS_QuickConnect as the workspace.
Select File > Import. Select 'Existing Project' from the import wizard options, then click 'Next'.
Select 'Browse'.
Navigate to STM32L4_AWS_QuickConnect > Projects > B-L4S5I-IOT1 > Applications and click 'Select this folder'.
Select the project, then click 'Finish'.

Step 3 Edit the project:
Select the aws_demo project.
Navigate to Middleware > amazon-freertos > demos > custom > aws_quick_connect_demo.c.
Inside aws_quick_connect_demo.c navigate to the function prvSensorReaderTask().
pSensorPayload contains the JSON we send to the visualizer. To add a new graph component, add a new field to the JSON of the format '[ { "label": <title>, "display_type" : "line_graph", "values": [ { "unit" : <unit>, "value" : <val>, "label" : "" } ] } ]'.
To see an example of this, please set customGraphEnabled to 1.

Step 4 Build the project:
Clean the project: Right-click on the project (aws_demos) and then select Clean Project.
Build the project: Right-click on the project (aws_demos) and then select Build Project.
The newly generated binary will be located in the following folder: /Projects/B-L4S5I-IOT01A/Applications/Cloud/aws_demos/STM32CubeIDE/PostBuild/SBSFU_B-L4S5I-IOT01_aws_demos.bin.
Move the new binary to the artifacts folder inside the Quick Connect setup folder that was downloaded and used to connect the board to AWS. If needed, download this package again for Linux/MacOS or Windows.

Step 5 Flash the board:
Run the file "Start_Quick_Connect" from the setup package that now contains the new binaries.
To keep using the same network, press enter when prompted for WiFi Network and Password. To change networks, enter the new network and password when prompted.
When the process completes, click on the new "CLICK-ME.html" located in the Quick Connect setup folder.

Specifications

Built on an STM32L4S5 with ARM® Cortex®-M4 core, the B-L4S5I-IOT01A Discovery Kit IoT Node enables development of wide range of connected applications by providing secure, low-power communication, integrated multiway sensing, and out-of-the box support for AWS IoT.


Hardware Architecture

ARM

Network Connectivity

Bluetooth LE (BLE), NFC, Sub-GHz, Wi-Fi 2.4 GHz only

Mounting / Form Factor

Embedded

Operating System

FreeRTOS

Security

Firewall, SSL/TLS

Power

USB Powered

Learn more

I/O Interfaces

ADC, Arduino, GPIO Isolated, I2C, I2S, JTAG / SWD, Pmod, PWM, SDIO, Sensor / MEMS, SPI, UART, USB

Environmental

Extended

Programming Language

C/C++

Storage

Flash/NVRAM

Availability

APAC, Australia, Canada, China, EMEA, EU, Japan, Korea, LATAM, New Zealand, UK, USA

Troubleshooting:

Permission issues while running the application:

Windows: After double-clicking the Start_Quick_Connect.exe to start the utility, depending on their security settings, Windows 10 users may see a pop up windows that says "Windows protected your PC". The workaround is to click on the "More info" link in the same window which will then present a "Run anyway" button. Click on the "Run anyway" button.

Mac: After double-clicking the Start_Quick_Connect.exe to start the utility, depending on their security settings, Mac users may see a pop up windows that says that "Start_Quick_Connect cannot be opened because it is from an unidentified developer". The workaround is to right click on the Start_Quick_connect file in finder app and select the "Open" option. Then click on the "Open" button in the popup that shows up.

Permission denied while building the projects:
"../../prebuild.sh" "../.." /bin/sh: ../../prebuild.sh: Permission denied make[1]: ** [makefile:96: pre-build] Error 126* *make:* * [makefile:64: all] Error 2 "make all" terminated with exit code 2. Build might be incomplete.

Solution:
cd /Projects/B-L4S5I-IOT01A/Applications/BootLoader_STSAFE/2_Images_SECoreBin chmod +x STM32CubeIDE/*

Build errors: Could not import modules:

Solutions:
1. Ensure you have the following modules installed: pycryptodomex, lief, ecdsa, numpy, argparse. If you are missing any, download them by running
pip install <module_name>

2. Ensure python points to version 3.7+ in your environment.
It it doesn't, replace cmd=python in Projects/B-L4S5I-IOT01A/Applications/BootLoader_STSAFE/2_Images_SECoreBin/STM32CubeIDE/prebuild.sh with cmd=python3 (or appropriate)

Errors with STM32CubeProgrammer:
Generating the global elf file (SBSFU and userApp) fix access path to STM32_Programmer_CLI ../../../../BootLoader_STSAFE/2_Images_SECoreBin/STM32CubeIDE/postbuild.sh: line 96: -ms: command not found

Solution:
Add STM32CubeProgrammer to your path by either:
1. adding the following line to postbuild.sh:
export PATH=$PATH:/Applications/STMicroelectronics/STM32Cube/STM32CubeProgrammer /STM32CubeProgrammer.app/Contents/MacOs/bin

2. permanently adding it to /etc/paths:
In a text editor, open /etc/paths. Append /Applications/STMicroelectronics/STM32Cube/STM32CubeProgrammer /STM32CubeProgrammer.app/Contents/MacOs/bin to the end of the file.

Unable connect to AWS or WiFi:

Solution:
1. Disconnect and reconnect the board to your computer.
2. Run Start_Quick_Connect again.

Error while provisioning the board with WiFi credentials:

Solution:
1. Disconnect/reconnect the board and try again.
2. Manually copy/paste the AWS_Config bin to the device folder and follow the prompts to enter your WiFi SSID and Password. Then run Start_Quick_Connect again.
Copyright (C) Amazon Web Services, Inc. or its affiliates. All rights reserved.