Getting Started with Atym: STM32 B-U585I-IOT02A

This guide will walk you through setting up Atym on your B-U585I-IOT02A board so that you can get up and running quickly with building container-based applications.

Prerequisites

Before setting up your B-U585I-IOT02A board with Atym, ensure you have all the necessary hardware components and software tools listed below. Having everything prepared beforehand will provide a smoother setup experience and help you avoid interruptions during the process.

Atym Free Trial

Sign up for a free trial account at atym.io to gain access to Atym to deploy containers on up to 3 devices at no cost. Your account provides access to the Atym Hub, container registry, developer resources, documentation, and more.

Hardware​

• B-U585I-IOT02A Board
• WIZnet W5500 Ethernet Shield
• Micro USB Cable
• Ethernet Cable with access to your network

Software​

• Atym CLI: Windows (x86_64) Mac (x86_64 | arm64 ) Linux (x86_64 | arm64)
• STM32CubeProgrammer
• Serial Terminal application (Windows: TeraTerm, Mac: CoolTerm, Linux: Picocom)

Board Setup ​

In this section, you'll connect the Ethernet shield to your board to enable network connectivity, which is required for communicating with the Atym Hub.

• Carefully connect the WIZnet W5500 Ethernet Shield to the Arduino headers on the underside of your B-U585I-IOT02A board.
• After that, connect the Ethernet cable to the WIZnet W5500 module.

Although the B-U585I-IOT02A has built-in Wi-Fi capabilities, the current Atym firmware only supports Ethernet connectivity via the WIZnet W5500 Ethernet Shield. This external module provides the network connectivity required for your device to communicate with the Atym Hub.

Flashing the Atym Firmware

This section will guide you through downloading the Atym firmware and flashing it to your B-U585I-IOT02A board using STM32CubeProgrammer.

Download the Atym Firmware​

First, download the latest firmware image specifically built for the B-U585I-IOT02A board here.

Prepare and Erase Your Device​

Before flashing new firmware, it's important to properly erase the device:

• Connect the Micro USB cable to the "ST-LINK" USB port (CN8) on your board
• Launch STM32CubeProgrammer on your computer
• In the top-right (blue) dropdown menu, select "ST-LINK"
• Click "Connect" to establish a connection with your board
• Navigate to the "Erasing & Programming" section in the left sidebar
• Click the "Full chip erase" button in the "Erase flash memory" section and confirm by clicking "Ok."

Flash the Atym Firmware​

Now that your device is prepared, let's flash the Atym firmware:

• In the same "Erasing & Programming" section, click the blue "Browse" button, and select the Atym firmware file you downloaded earlier
• Click "Start Programming" to begin the flashing process
• Wait for the programming to complete (you'll see a success message)
• Click the green "Disconnect" button to safely release the connection

Verify Your Installation​

Let's confirm that the firmware was installed correctly:

Open your preferred serial terminal application with these settings:

• Port: Select your device's port
• Baud Rate: 115200
• Data Bits: 8
• Parity: None
• Flow Control: None

Press the Reset Button on your board to restart the device. You should see a message similar to this in your console:

*** Booting Zephyr OS build v4.1.0-40-g34b526826adf ***
Copyright 2024 Atym, Inc. (build: 3151985)
Build info: dev-3151985+; 06-06-2025, 21:21Z; Kermit.local
Platform: b_u585i_iot02a

Connecting to the Atym Hub​

Setting up your device involves two main steps: first, creating a device identity in the Hub, then configuring your physical device to connect using this identity.

Log in to the Atym Hub

Before registering your device or performing most commands with the atym cli, you will need to authenticate like so:

atym login

You will then be prompted to sign in to Atym using the credentials you received earlier from when you signed up for the Atym Dev Zone.

Add the device to the Atym Hub​

This process creates a digital identity for your device in the Atym Hub. You'll perform these steps on your development computer, not on your board.1. Create a file named device.yaml on your computer with the following content:

---
deviceName: B_U585I_IOT02A       # Change this to your desired device's name
description: "B_U585I_IOT02A"    # Update with your device description
serialNumber: '1234567890'       # Replace with your actual serial number
target: armv8m.main
cpu: cortex-m33
enabled: true
aotEnabled: false 
targetAbi: eabihf
xip: false

2. Add your device to the Atym Hub

atym add device -f device.yaml

If successful, you'll receive a response containing your deviceUUID and pskSecret. It will look similar to this:

{  
    "deviceUUID": "67c1c350-cc1c-482d-bde9-875688ff9b23",
    "pskSecret": "IEAaeWHKhYs4fAScF5ApQ0C9eGcXu123"
}

3. Copy both values to a secure location. You'll need these credentials to configure your device in the next steps.

4. Retrieve your tenant ID by running:

atym show config

From the output, locate and copy the TenantID field for your tenant and copy it down:

Environment: production
Scope: tenant
Access Level: editor
Environment Endpoint: https://api.prod.atym.io
Tenant Name: demo
Tenant ID: a8721ef3-5cd9-46b2-9f31-7d45b2c9ae42
Account Name: Atym
Account ID: 3efc94bd-7512-4961-895c-a5832de71fb9
User ID: auth0|****************
Device ID: c5823914-476f-42ae-90dc-328bfd64ea7c
Device Name: B-U585I-IOT02A

Registering the device with the Atym Hub​

Now you'll configure your board with the credentials we copied down earlier, allowing it to securely connect to the Atym Hub.

The following steps must be performed ON YOUR DEVICE, not your host machine. You should see the command prompt atym:~$ if you're in the correct console

1. Set the device identity using your deviceUUID and tenantID:

atym config set device/id <deviceUUID>@<tenantID>

Replace <deviceUUID> and <tenantID> with the values you copied earlier. Make sure to include the @ symbol between them.

2. Configure the device's pre-shared key using the pskSecret:

atym config set device/psk <pskSecret>

3. Set the Atym Hub connection details:

atym config set server/endpoint coapgw.prod.atym.io
atym config set server/port 5684

4. Verify your configuration

atym config show

The output should display all four settings with their proper values:

Current configuration:
  device/id: a612baee-dd15-42cc-a0dc-a0783c186bb5@a60dbceb-270e-4b14-a93c-60809b34c123
  device/psk: ct6P/zFOHQbvrLyRFrnh22XnXQ1H8+at
  server/endpoint: coapgw.prod.atym.io
  server/port: 5684

5. Reset your device by pressing the Reset Button to apply the configuration.

6. After rebooting, your device should automatically connect to the Atym Hub. Look for the following message in your console:

Client connected successfully

It may take 5-10 seconds between the time the device reboots and when it connects to the Atym Hub.

Next Steps ​

Congratulations! You've successfully completed the setup process for your B-U585I-IOT02A Discovery Board with Atym. Your device is now properly configured and connected to the Atym Hub, ready for application deployment.

Ready to build your first app? Check out the Building and Deploying Your First App With Atym guide I made! lt will guide you through all of the necessary steps to build and deploy your first container-based application with Atym.