Skip to content
/ I-CUBE-ExpressLink Public

AWS ExpressLink driver and examples for STM32 devices

License

BSD-3-Clause license
6 stars 0 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

stm32-hotspot/I-CUBE-ExpressLink

BranchesTags

Repository files navigation

I-CUBE-ExpressLink

1- Overview

  • I-CUBE-ExpressLink is a CMSIS pack for the ExpressLink driver for STM32 devices. It allows you to create applications that connects to AWS IoT Core using ExpressLink modules and to issue Host Over-The-Air Updates, in addition of many other projects.

  • Connecting your board to AWS : Quick Connect
    Registers your board to AWS cloud service IoT Core automatically, and opens a serverless Dashboard that plots real time sensor data and controls LED using shadow messages.

  • Issue Host Over the Air updates (HOTA)
    AWS provides the option to deploy Host OTA firmware updates on previously connected devices in your fleet. The Host OTA process uses the ExpressLink Module as an intermediary to update the connected board, or "host". This approach optimizes the host's performance by allowing for larger payload transmission, as well as optimized memory resource utilization. Additionally, the heavy authenticity checks are transferred to the Express Link Module. The package comes with scripts that simplify the Host OTA process, reducing the number of steps required and eliminating the need for familiarity with the AWS console.

  • The driver is compatible with AWS IoT ExpressLink Technical Specification v1.1 or higher.

  • You will need to connect your board to a Wi-Fi that is at least 2.4 GHz.

  • The pack was tested with the following ExpresssLink Modules:

2- I-CUBE-ExpressLink Features

  • Very low code size
  • Compatible with all STM32 product family
  • No code/low code examples -> easy to port to any STM32 microcontroller
  • Multiple examples (FreeRTOS, HelloWorld, PubSub, Shadow, PassThrough, Arduino and MicroPython)
  • STM32CubeMX code configuration and project generation
  • Projects for 16 boards and 12 STM32 uC series
  • Same firmware/binary works with Cellular or Wi-Fi
  • Multiple helper scripts (HOTA, HOTA Cert, Sign, QuickConnect)
  • Tiny Secure Boot allowing secure boot and secure firmware update for all STM32s with multiple firmware signing options
  • Windows, MAC and Linux support

Projects Descriptions

Arduino:

MicroPython:

Passthrough:

Quick Connect:

Tiny Secure Boot:

  • Securley boot and update STM32 with HOTA updates and ECDSA signature verification
  • Required to do HOTA updates on single bank STM32s
  • Small footprint (32K down to 16K)
  • Examples provided for the following boards:
  • Can be easily ported to any STM32 with 128K+ of Flash memory

FreeRTOS:

HelloWorld:

  • Simple HelloWorld example

PubSub:

  • Publish and Subscribe example

Shadow:

  • Example showing how to use Shadow messages

3- Get started

3.1- Download and install tools

3.2- Download the CMSIS packs

3.3- Install the packs with STM32CubeMX

Install the 4 packs above one by one as follows. Installation order does not matter.

Select one pack and proceed to its installation as follows.

Then repeat for all the other packs.

3.4- Open the pack on your PC

Copy the following path :

NOTE: The pack installation path will differ depending on operating system.

Windows:

%HOMEPATH%\STM32Cube\Repository\Packs\STMicroelectronics\I-CUBE-ExpressLink\1.0.0\Projects\

Linux:

$HOME/STM32Cube/Repository/Packs/STMicroelectronics/I-CUBE-ExpressLink/1.0.0/Projects/

Mac:

$HOME/STM32Cube/Repository/Packs/STMicroelectronics/I-CUBE-ExpressLink/1.0.0/Projects/

Then paste it into the search bar and click enter to access the different projects :

4- Folders List

  • Arduino: Arduino projects. Offered for the B-U585I-IOT02A, B-L475E-IOT01A and NUCLEO-G071RB boards. Get started here

  • FreeRTOS: Projects based on FreeRTOS. The projects are compatible with the Quick Connect script. Offer HOTA capability

  • HelloWorld: Provides a very basic example.

  • MicroPython: MicroPython projects. Offered for the NUCLEO-WB55RG and B-L475E-IOT01A boards. Get started here for NUCLEO-WB55RG or here for B-L475E-IOT01A

  • PassThrough: PassThrough application enables serial terminal communication with the module, allowing you to retrieve the ExpressLink certificate and Thing name, and register your device with AWS.

  • PubSub: Example on how to receive MQTT messages and publish/subscribe to a topic.

  • Scripts : Contains the scripts that automate the processes of connecting the board to AWS and issuing Host Over The Air (HOTA) updates :

    • QuickConnect : registers and connects your board to AWS, then opens a dashboard for you to see real time data from your board's sensors.
    • host-ota-cert
      • generate_cert.ps1 : creates a certificate and registers it on AWS. This certificate will be used to sign the firmware updates uploaded on AWS for HOTA updates.
      • set_host_cert.ps1 : flashes the previous certificate into your board's memory. This allows to have the board verifiy any HOTA update being received from AWS before installing it.
    • host-ota : uploads the binary file of your firmware update to AWS, and then sends it to your board Over the Air. The board then verifies the update and, if validated, downloads, flashes, and restarts with the new firmware.
    • sign : sign the application binary to be used with Tiny Secure Boot

  • SecureBoot: Tiny Secure Boot.

  • Shadow: Example on how to use the AWS Shadow messages.

5- Set up your AWS account

5.1- Create an AWS account

5.2- Create an IAM user

  • Sign in to the AWS IAM Console
  • On the left pane, under Access Management choose Users then click on Add Users

  • Choose a name for your IAM User
  • Under Permissions options, select Add user to group
  • Under User groups, check the box of the group Administrators, then click Next

  • Choose Create user

WARNING : The examples in this document are intended only for dev environments. All users must have credentials with privileges that authorize only intended actions on specific resources. The specific permission policies can vary for your use case. Identify the permission policies that best meet your business and security requirements. For more information, see Example IAM identity-based policies and Security Best practices in the IAM Identity and Access Management User Guide..

5.3- Retreive your access keys

  • Back on the Users menu, click on the User you just created.
  • Choose Security Credentials, then under the section Access keys choose Create access key
  • Select the option Command Line Interface (CLI) and check the I understand box at the bottom. Click Next
  • Click Create access key
  • A public key "Access Key" and a private key "Secret Access Key" has been created and assigned to your user.

WARNING : It is important that you store these keys somewhere you can access them : you will need them for some AWS operation and you won't be able to retrieve them once this windows will be closed.

  • You can either choose Download .csv file to download a file containing both keys, or copy paste the two keys Access key AND Secret access key and paste them somewhere.

5.4- Create a profile

NOTE: AWS CLI is required for this step

  • Open a PowerShell console and paste the following command :
aws configure --profile default
  • Successively paste the requested information : the Access Key and the Private Access Key previously generated, your region (ex : us-west-1) and then json for output format.

6- Other Prerequisites

6.1- Install the ExpressLink module

Connect the ExpressLink module on your board's Arduino connector

6.2- Update the ExpressLink module

Please refer to Update the ExpressLink module

You can use the PassThrough project to update the ExpressLink module with otw. An example on how to call the otw script is provided at the following directory

Windows:

%HOMEPATH%\STM32Cube\Repository\Packs\STMicroelectronics\I-CUBE-ExpressLink\1.0.0\Projects\scripts\otw\

Linux:

$HOME/STM32Cube/Repository/Packs/STMicroelectronics/I-CUBE-ExpressLink/1.0.0/Projects/scripts/otw/

Mac:

$HOME/STM32Cube/Repository/Packs/STMicroelectronics/I-CUBE-ExpressLink/1.0.0/Projects/scripts/otw/

6.3- Install the python libraries

  • Copy the following path, then paste it into the windows search bar and click enter.

    Windows:

    %HOMEPATH%\STM32Cube\Repository\Packs\STMicroelectronics\I-CUBE-ExpressLink\1.0.0\Projects\scripts\

    Linux:

    $HOME/STM32Cube/Repository/Packs/STMicroelectronics/I-CUBE-ExpressLink/1.0.0/Projects/scripts/

    Mac:

    $HOME/STM32Cube/Repository/Packs/STMicroelectronics/I-CUBE-ExpressLink/1.0.0/Projects/scripts/

  • From this folder open a Command Prompt and paste the following command :

    Windows:

    pip install -r requirements_windows.txt

    Linux:

    pip install -r requirements_linux.txt

    Mac:

    pip install -r requirements_mac.txt

6.4- Configure PowerShell

  • Open PowerShell terminal as Administrator

  • Set execution policy

Run the following command to allow script execution

Set-ExecutionPolicy -ExecutionPolicy Unrestricted  -Scope CurrentUser

Enter y to accept the Execution Policy Change

7- Use Passthrough project to Register ExpressLink module to your AWS development account

7.1- Obtain your ExpressLink module Certificate and Thing Name

  1. Install the ExpressLink module on your board's Arduino connector

  2. Open the PassThrough project for your board

    Windows:

    %HOMEPATH%\STM32Cube\Repository\Packs\STMicroelectronics\I-CUBE-ExpressLink\1.0.0\Projects\PassThrough\

    Linux:

    $HOME/STM32Cube/Repository/Packs/STMicroelectronics/I-CUBE-ExpressLink/1.0.0/Projects/PassThrough/

    Mac:

    $HOME/STM32Cube/Repository/Packs/STMicroelectronics/I-CUBE-ExpressLink/1.0.0/Projects/PassThrough/
  • Select your board folder and double click on < Your_Board-Name >_PassThrough.ioc to open it with STM32CubeMX

  1. Generate code and open project

  1. Build the project

  1. Run the project

  • Accept the settings (Click OK)

  • Accept ST-Link Update. NOTE: ST-LINK update may not be required for all users.

  • Open ST-Link Update modes

  • Upgrade ST-Link

  • Close ST-LINK Upgrade

  • Start Debug a second time

  • Run the project

  1. Open Tera Term or the online serial emulator and connect to ST-Link (115200, 8-bits, 1 Stop, No parity)

  2. Get the thing name by typing the following command

AT+CONF? ThingName

Take note of the thing name. It is similar to this example: 4d384932-17b5-41d7-ab0f-a5b052d9437d

  1. Get the thing certificate by typing the following command
AT+CONF? Certificate pem
  • Copy the certificate from the -----BEGIN CERTIFICATE----- line till the -----END CERTIFICATE----- line
  • Save it to a file named ThingName.cert.pem

7.2- Register an AWS IoT ExpressLink module in your development account

  1. Open the AWS IoT Console. Select Manage then select Things. Choose Create things , select Create single thing , click Next.
  2. On the Specify thing properties page, paste the previously copied ThingName obtained in step above into the Thing name under Thing properties on the console. Leave other fields as default, then click Next.
  3. In the AWS IoT console, on the Configure device certificate page, select Use my certificate, then select CA is not registered with AWS IoT.
  4. Under Certificate , select Choose file. Double click on "ThingName.cert.pem" file obtained in step above, then choose Open.
  5. Under Certificate Status , select Active, then choose Next.
  6. Under Attach policies to certificate, choose Create policy.
  7. Enter a Policy name (for example, "IoTDevPolicy") , then under Policy document select JSON.
  8. Copy the the following into the console Policy document:
{ "Version": "2012-10-17", "Statement": [{ "Effect": "Allow", "Action": "*", "Resource": "*" }] }

NOTE – The examples in this document are intended only for dev environments. All devices in your fleet must have credentials with privileges that authorize only intended actions on specific resources. The specific permission policies can vary for your use case. Identify the permission policies that best meet your business and security requirements. For more information, Example IAM identity-based policies and Security Best practices in the IAM Identity and Access Management User Guide..

  1. Click Save to complete the Thing creation.

  2. In the AWS IoT console, in the navigation pane, choose Settings. Under Device data endpoint select the Endpoint to make a copy of the endpoint for your account. It is similar to this example: a3qEXAMPLEsffp-ats.iot.eu-west-1.amazonaws.com

7.3- Completion

Congratulations! You have completed the registration of the ExpressLink module as a thing in your AWS IoT account. You do not need to repeat these steps the next time you use the module unless you want to register it to a different region or account.

Stop the debugger

8- Run the HelloWorld project

8.1- Open the STM32CubeMX project

  • Copy the following path, then paste it into the search bar and click enter.

    Windows:

    %HOMEPATH%\STM32Cube\Repository\Packs\STMicroelectronics\I-CUBE-ExpressLink\1.0.0\Projects\HelloWorld\

    Linux:

    $HOME/STM32Cube/Repository/Packs/STMicroelectronics/I-CUBE-ExpressLink/1.0.0/Projects/HelloWorld/

    Mac:

    $HOME/STM32Cube/Repository/Packs/STMicroelectronics/I-CUBE-ExpressLink/1.0.0/Projects/HelloWorld/

  • Select your board folder and double click on <Your_Board-Name>_HelloWorld.ioc to open it with STM32CubeMX.

8.2- Configure and generate the project

  • Set your Wi-Fi SSID and password or APN if you are using cellular modem

  • Make sure to update your AWS endpoint. It is similar to this example: a3qEXAMPLEsffp-ats.iot.eu-west-1.amazonaws.com. You should have obtained it when you registred your device earlier.

8.3- Enable ExpressLink_EVENT pin

If you are using the Espressif ExpressLink module, it is recommended that you enable the ExpressLink_EVENT pin.

  • On the search bar present on the bottom right of STM32CubeMX, search for _ExpressLink_EVENT. The GPIO pin will be highlighted

  • Right click on the pin and select Enter User Label

  • Rename the pin to ExpressLink_EVENT. (Remove the _ prefix)

8.4- Generate the project

  • In STM32CubeMX
    • Click Generate Code
    • Click Open Project
    • The project should open in STM32CubeIDE

8.5- Build the project

8.6- Flash and run the project

Start the debugger

Accept ST-Link settings

Start debug

8.7- Check messages on AWS IoT Core MQTT test client

  • Under Topic filter use # to subscribe to all the topics
  • Click Subscribe

  • Observe the messages coming in

  • You can check the debug messages on the serial terminal

8.8- Completion

Congratulations! You are connected to AWS IoT core and sending MQTT messages.

Stop the debugger

9- Run the FreeRTOS project

9.1- Open the STM32CubeMX project

  • Copy the following path, then paste it into the search bar and click enter.

    Windows:

    %HOMEPATH%\STM32Cube\Repository\Packs\STMicroelectronics\I-CUBE-ExpressLink\1.0.0\Projects\FreeRTOS\

    Linux:

    $HOME/STM32Cube/Repository/Packs/STMicroelectronics/I-CUBE-ExpressLink/1.0.0/Projects/FreeRTOS/

    Mac:

    $HOME/STM32Cube/Repository/Packs/STMicroelectronics/I-CUBE-ExpressLink/1.0.0/Projects/FreeRTOS/

  • Select your board folder and double click on <Your_Board-Name>_FreeRTOS.ioc to open it with STM32CubeMX.

9.2- Configure and generate the project

  • Set your Wi-Fi SSID and password or APN if you are using cellular modem.

  • Make sure to update your AWS endpoint. It is similar to this example: a3qEXAMPLEsffp-ats.iot.eu-west-1.amazonaws.com. You should have obtained it when you registred your device earlier.

  • In STM32CubeMX
    • Click Generate Code
    • Click Open Project. The project should open in STM32CubeIDE

9.3- Build the project

For NUCLEO-H503RB amd NUCLEO-G071RB users : If you are planning on issuing a Host OTA, you need to enable the optimization level to -O3 or -Os. To do so, right click on the FreeRTOS project, choose properties, C/C++ Builds, Settings, MCU GCC Compiler, Optimization, and set Optmization level to Optimize Most (-O3) or Optimize for size (-Os), then Apply and Close.

  • Save and build the project

9.4- Flash and run the project

Start the debugger

Accept ST-Link settings

Start debug

9.5- Check messages on AWS IoT Core MQTT test client

  • Under Topic filter use # to subscribe to all the topics
  • Click Subscribe

  • Observe the messages coming in

  • You can check the debug messages on the serial terminal

9.6- Completion

Congratulations! You are connected to AWS IoT core with a FreeRTOS application sending MQTT messages.

Stop the debugger

10- Create a FW update for the FreeRTOS project

10.1- Memory map

The memory is split between the application, HOTA section and the Metadata section.

The Metadata sections contains the Wi-Fi SSID, Wi-Fi password, APN and AWS endpoint

It is important to know the maximum Application binary size and maximum HOTA binary size "MAX_HOTA_SIZE"

The MAX HOTA size = MAX App size = MAX_HOTA_SIZE.

MAX_HOTA_SIZE = (FLASH_SIZE/2) - METADATA_SIZE.

Example:

  • STM32U585AI = (2048/2) - 8K = 1016K
  • STM32G0B1RE = (512/2 ) - 2K = 254K
  • STM32G071RB = (128K/2) - 2k = 62K
  • STM32H503RB = (128K/2) - 8k = 56K

10.2- Create the HOTA update signing certificate and upload it into AWS

NOTE : This section is only mandatory the first time you are doing an HOTA update, as you will need to create a signing profile associated with a signing certificate. Once you have a signing profile created, and the board memory contains the associated signing certificate, you can use it for your following HOTAs.

This script creates a certificate and uploads it into AWS ACM. It will later on be associated with an AWS Signing profile, which will allow to sign the firmware update binaries being sent to AWS for HOTA updates. The generated certificate, its associated private key, and its ARN - a identifier issued by AWS upon the certificate registration - will be saved in the same folder of the script as following :

ecdsasigner.pem
ecdsasigner-priv-key.pem
CERT_ARN.txt

  • Paste the following on your Windows Search Bar to access the folder containing the script :

    Windows:

    %HOMEPATH%\STM32Cube\Repository\Packs\STMicroelectronics\I-CUBE-ExpressLink\1.0.0\Projects\scripts\host-ota-cert\

    Linux:

    $HOME/STM32Cube/Repository/Packs/STMicroelectronics/I-CUBE-ExpressLink/1.0.0/Projects/scripts/host-ota-cert/

    Mac:

    $HOME/STM32Cube/Repository/Packs/STMicroelectronics/I-CUBE-ExpressLink/1.0.0/Projects/scripts/host-ota-cert/

  • The default settings of your certificate will be as follows. You can edit them by opening the script file generate_cert.ps1 with any text editor. Note that Common Name must not be empty, but appart from that the content you are choosing won't affect the rest of the steps.

    • AWS CLI Profile : default
    • Country : France
    • State : Paris
    • Locality : Paris
    • Organization : STMicroelectronics
    • Common Name : stm32h501

  • Still from this same host-ota-cert folder, open a Command Prompt Terminal and paste the following command to run the script that will generate the HOTA signing certificate and upload it on AWS :

.\generate_cert.ps1

  • You can check that your certificate was uploaded by going into the AWS ACM Console and compare the ARN.

10.3- Upload the HOTA certificate into the ExpressLink module

This script uploads the previously generated HOTA certificate into the ExpressLink module. This will allow the module to check the signature of new HOTA binary being received from AWS before informing the Host processor of the new HOTA availability.

  • If you have any serial emulator opened (Tera Term, Putty, browser serial emulator...) close it or disconnect.

  • Still from this same host-ota-cert folder, open a Command Prompt Terminal and paste the following command to run the script that will uplaod the HOTA signing certificate into the board :

.\set_hota_cert.ps1

  • Press the Reset button of your board when asked by the script.
  • The script will continue after the board reboots

10.4- Update revision Number and generate binary file

  • Proceed with the FW changes for your new update, and update the app version in the file Inc\application_version.h :

  • For STM32CubeIDE setup :

    • Enable bin files post build output : right click on the FreeRTOS project, choose properties, C/C++ Builds, Settings, MCU Post build outputs and check the Convert to binary file (-O binary) box, then Apply and Close.
    • For NUCLEO-H503RB amd NUCLEO-G071RB users : for code size compatibility purposes, you also need to enable the optimization level to -O3 or -Os. To do so, right click on the FreeRTOS project, choose properties, C/C++ Builds, Settings, MCU GCC Compiler, Optimization, and set Optimization level to Optimize Most (-O3) or Optimize for size (-Os), then Apply and Close.

  • Save your project and build it :

10.5- Issue the Host OTA

We are now going to use a scripts to issue the Host OTA.

  • To access the script folder, copy the following path, then paste it into the search bar and click enter.

    Windows:

    %HOMEPATH%\STM32Cube\Repository\Packs\STMicroelectronics\I-CUBE-ExpressLink\1.0.0\Projects\scripts\host-ota\

    Linux:

    $HOME/STM32Cube/Repository/Packs/STMicroelectronics/I-CUBE-ExpressLink/1.0.0/Projects/scripts/host-ota/

    Mac:

    $HOME/STM32Cube/Repository/Packs/STMicroelectronics/I-CUBE-ExpressLink/1.0.0/Projects/scripts/host-ota/

  • Open the script file hota_update.ps1 with a text editor.

  • Fill in the different arguments for the script :

    • Make sure the name of the board you are using is the only one uncommented

    • For AWS CLI profile name , put "default" (or another name if you used a different one in step 5.4)

    • Enter your THING_NAME

    • To use existing cloud resources for ROLE, OTA_SIGNING_PROFILE, or S3BUCKET, simply specify their names. Otherwise, choose new names and the script will automatically create them in AWS.

    • For CERT_ARN - Copy and paste the following path into your search windows

      • Windows: 
        %HOMEPATH%\STM32Cube\Repository\Packs\STMicroelectronics\I-CUBE-ExpressLink\1.0.0\Projects\scripts\host-ota-cert\
      • Linux 
        $HOME/STM32Cube/Repository/Packs/STMicroelectronics/I-CUBE-ExpressLink/1.0.0/Projects/scripts/host-ota-cert/
      • Mac 
        $HOME/STM32Cube/Repository/Packs/STMicroelectronics/I-CUBE-ExpressLink/1.0.0/Projects/scripts/host-ota-cert/
    • Copy the content of the file CERT_ARN.txt. It should have the following format arn:aws:acm:YourLocation:.......:certificate........
    • Paste it into the hota_update script you were filling.
    • Save your document.

NOTE : If you create a new signing profile, it will be associated with the certificate of the ARN that was provided as one of the parameters.

NOTE : For your HOTA to be accepted, you must use the signing profile associated with the same HOTA certificate that is in your board memory.

  • Still from the hota-script folder, open a Command Prompt Terminal and paste the following command to run the script that will issue your HOTA :
.\hota_update.ps1

  • Your script should issue your HOTA. You can take note of the name of the HOTA, it will have the format ExpressLink-X with X being numbers

10.6- Check HOTA update success through AWS

You can monitor the status of the HOTA being issued using the AWS console. To do so go to the the AWS IoT Console, then in the Manage section on the left pane, select Remote Actions, Jobs and select your HOTA (you can use the its name or the created date if you are note sure which one it is).

In the Details section, you have your HOTA update information and status :

In the Job executions section, you can see you HOTA update execution status :

Here we can see that the HOTA update was successful.

NOTE : A HOTA update that was sent to the host but not implemented will be marked as "Complete" on the main and Job Detail section but "failed" under Job execution. It is recommended to check the Job execution page to ensure the HOTA update was successful.

10.7- Check through a serial terminal

After initiating the HOTA update process, you will see several steps. The firmware update is first detected and downloaded into the other bank of the board. The board then switches to this bank and restarts with the new firmware. Keep in mind that some steps may take time before displaying outputs.

By checking the printed version number after this restart you can ensure that the HOTA was successful.

10.8- Disable SWAP_BANK option bit

HOTA enables the SWAP_BANK option bit to swap bank 1 and bank 2 to boot the newly received firmware. However, STM32CubeIDE might have issues connecting to the device when the SWAP_BANK option bit is set. To resolve that we need to disable the SWAP_BANK option bit using STM32CubeProgrammer:

  • Open STM32CubeProgrammer
  • Connect to the device
  • Open the option bytes tab

  • Expand the User Configuration

  • Scroll down to find the SWAP_BANK option bit. Makse sure it is unchacked. Click Apply

  • Disconnect

11- Tiny Secure Boot

12- Enable ExpressLink_Event pin

Projects are configured in polling mode by default, which means that the application continuously checks for ExpressLink events without verifying the ExpressLink event GPIO pin. This is because the ExpressLink event pin is mapped to different GPIOs for different ExpressLink modules.

To enable the ExpressLink_Event pin for the Espressif Expresslink module for the FreeRTOS project

  • Check the serial terminal to verify mode

12.1- Find ExpressLink_EVENT pin

  • Select your board folder and double click on <Your_Board-Name>_FreeRTOS.ioc to open it with STM32CubeMX.

  • On the search bar present on the bottom right of STM32CubeMX, search for _ExpressLink_EVENT. The GPIO pin will be highlighted

  • Right click on the pin and select Enter User Label

  • Rename the pin to ExpressLink_EVENT. (Remove the _ prefix)

  • Under System Core select NVIC

  • Find the EXTI Line
  • Enable it
  • Set its priority to 7 (3 if it is the lowest possible)
  • Click generate code

12.2- Build the project

12.3- Flash and run the project

Start the debugger

Start debug

  • Check the serial terminal

  • Check main.c and look for #if defined(ExpressLink_EVENT_Pin)

13- QuickConnect script

WARNING : The quick connect script opens a dashboard with a link that contains your AWS keys. Do not to share the link or the QR code as it contains your AWS Access keys. You need to disable the keys and generate new ones if they are shared or leaked. ST cannot be responsible for shared or leaked keys.

  • Copy the following path, then paste it into the windows search bar and click enter.

    Windows:

    %HOMEPATH%\STM32Cube\Repository\Packs\STMicroelectronics\I-CUBE-ExpressLink\1.0.0\Projects\scripts\QuickConnect\

    Linux:

    $HOME/STM32Cube/Repository/Packs/STMicroelectronics/I-CUBE-ExpressLink/1.0.0/Projects/scripts/QuickConnect/

    Mac:

    $HOME/STM32Cube/Repository/Packs/STMicroelectronics/I-CUBE-ExpressLink/1.0.0/Projects/scripts/QuickConnect/

  • From this folder, open a Command Prompt and paste the following command to run the script that will register and connect your board into AWS :

python .\STM32_AWS_ExpressLink_QuickConnect.py -i

  • Enter your SSID and Password.

  • Then, a web browser window will open, displaying the dashboard. From there, you can view real-time sensor data, toggle the blue LED on your board, and scan the QR code to access the dashboard on your phone and control the LED from there too.
  • The quick connect binary is the same generated by the FreeRTOS projects

WARNING : Do not to share the link or the QR code generated by the QuickConnect script as it contains your AWS Access keys. You need to disable the keys and generate new ones if they are shared or leaked. ST cannot be responsible for shared or leaked keys.

WARNING : Do not to share the link or the QR code generated by the QuickConnect script as it contains your AWS Access keys. You need to disable the keys and generate new ones if they are shared or leaked. ST cannot be responsible for shared or leaked keys.

14- PubSub and Shadow examples

  • Follow same steps as the HelloWorld example.
  • If you are using the Espressif Expresslink module, it is recommended that you enable the ExpressLink_EVENT pin.

About

AWS ExpressLink driver and examples for STM32 devices

Topics

aws arduino micropython stm32 freertos aws-iot stm32cubemx freertos-iot expresslink

Resources

Readme

License

BSD-3-Clause license

Code of conduct

Code of conduct

Security policy

Security policy
Activity
Custom properties

Stars

6 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages