Skip to content

stm32mp215f-dk

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

stm32mp215f-dk

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
media
media
 
 
README.md
README.md
 
 

README.md

STM32MP215F-DK QuickStart

Purchase STM32MP215F-DK

  1. Introduction
  2. Requirements
  3. Hardware Setup
  4. Device Setup
  5. Onboard Device
  6. Using the Demo
  7. Troubleshooting
  8. Resources

1. Introduction

This guide is designed to walk through the steps to connect the STM32MP215F-DK to the Avnet /IOTCONNECT platform and periodically send general telemetry data.

The STM32MP215F-DK Discovery Kit is designed as a complete demonstration and development platform for the STMicroelectronics STM32MP215F based on the Arm® Cortex®-A35 and Cortex®-M33. The product leverages the capabilities of STM32MP2 series microprocessors to allow users to develop applications using STM32 MPU OpenSTLinux Distribution software for the main processor (Arm® Cortex®-A35) and STM32CubeMP2 software for the coprocessor (Arm® Cortex®-M33).

2. Requirements

This guide has been written and tested to work on a Windows 10/11 PC. However, there is no reason this can't be replicated in other environments.

Hardware

  • STM32MP215F-DK Purchase | User Manual & Kit Contents | All Resources
  • MicroSD Card (minimum 8GB, not included in kit)
  • USB-C Power Cable (not included in kit)
  • Ethernet Cable (not included in kit)
  • USB to TTL Serial 3.3V Adapter Cable (must be purchased separately, click here to see the cable used by Avnet's engineer)

Note

The USB to TTL Serial 3.3V Adapter Cable may require you to install a specific driver onto your host machine. The example cable linked above requires a PL2303 driver.

Software

Note

The demos for this device have been tested with the Scarthgap version 6.0.0 Yocto image release from ST. Older or newer versions may have significant incompatibilities, so it is recommended to use the 6.0.0 release. Download that image by clicking here

3. Hardware Setup

See the reference image below for cable connections.

Reference Image with Connections

Using the above image as reference, make the following connections:

  1. Insert a microSD card (minimum 8GB, not included in kit) into the microSD card slot labeled #1 on the board.
  2. Connect a USB-C power cable (not included in kit) from your PC to the USB-C power connector on the board, labeled #2.
  3. Connect an Ethernet cable (not included in kit) from your LAN (router/switch) to the Ethernet connector on the board, labeled #3.
  4. Connect your USB to TTL Serial 3.3V Adapter Cable to the CN2 serial connector on the board, labeled #4.

Note

The pin order on the CN2 connector is TX-GND-RX, so the corresponding connections on the cable should be RX-GND-TX. If you have trouble connecting to the board via the serial terminal, try swapping the TX and RX connections, as it is easy to get confused with the labeling.

4. Device Setup

  1. Flash the downloaded v6.0.0 Scarthgap image to the device, referring to the "Populate the target and boot the image" page on the STM32MP257x-DK section of ST's wiki for guidance.

Note

It is recommended to use the provided version of the image and not download the newest version from ST as these demos have not been tested on newer releases and may have incompatibilities.

  1. Open a serial terminal emulator program such as TeraTerm.
  2. Ensure that your serial settings in your terminal emulator are set to:
  • Baud Rate: 115200
  • Data Bits: 8
  • Stop Bits: 1
  • Parity: None
  1. Noting the COM port value for "STMicroelectronics STLink Virtual COM Port" in the Device Manager list, attempt to connect to your board via the terminal emulator

Note

A successful connection may result in just a blank terminal box. If you see a blank terminal box, press the ENTER key to get a login prompt. An unsuccessful connection attempt will usually result in an error window popping up.

  1. If prompted for a login, type root followed by the ENTER key.
  2. Run these commands to update the core board packages and install necessary /IOTCONNECT packages:
su

apt-get update && apt-get install python3-pip -y && python3 -m pip install iotconnect-sdk-lite requests
  1. Run this command to create and move into a directory for your demo files:
mkdir -p /opt/demo && cd /opt/demo

Tip

To gain access to "copy" and "paste" functions inside of a PuTTY terminal window, you can CTRL+RIGHTCLICK within the window to utilize a dropdown menu with these commands. This is very helpful for copying/pasting between your browser and the terminal.

5. Onboard Device

The next step is to onboard your device into /IOTCONNECT. This will be done via the online /IOTCONNECT user interface.

Follow this guide to walk you through the process.

Tip

If you have obtained a solution key for your /IOTCONNECT account from Softweb Solutions, you can utilize the /IOTCONNECT REST API to automate the device onboarding process via shell scripts. For the STM32MP215F-DK, you will first need to run apt-get install python3-cffi -y and then you can check out this guide for more info on the rest of that process.

6. Using the Demo

Run the basic demo with this command:

python3 app.py

Note

Always make sure you are in the /opt/demo directory before running the demo. You can move to this directory with the command: cd /opt/demo

View the random-integer telemetry data under the "Live Data" tab for your device on /IOTCONNECT.

7. Troubleshooting

To return the board to an out-of-box state, you can re-flash a fresh Yocto image to the SD card. For instructions on this process, refer to ST's guide on populating the target and booting the image.

8. Resources