This document describes the features of the PLTcloud web console.
As an example, it focuses on an “IoTSDK Demo” project, to program the STM32L4 Discovery kit IoT node board with a firmware image and test it.
PLTs are grouped in Deployment Groups. These are groups of PLTs that are meant to run the same set of tests. For example, you can have a group of PLTs that you will want to use for In-Circuit (ICT) testing and another group of PLTs that you will want to use for Final Assembly, Test & Pack-out (FATP) testing.
New Deployment Groups can be created in the PLTs view.
You can then fill out the name and the description of the group.
From the PLTs view, detailed information on a PLT can be seen by clicking on the dark-blue eye icon.
In the case of the “STM IoT SDK” project, we are deploying to PLTs that are part of the “DEV” group.
On the PLT UI panel, press the Menu button to enter the PLT Menu, and select Enroll.
The PLT will show an enrollment code on the OLED display.
You can enroll your PLT under the PLTs section of the PLTcloud website. On the PLTcloud website, use this code as the Activation code in the Enroll PLT form.
You can then set the PLT to a specific deployment group by clicking on on SET DEPLOYMENT GROUP.
For the “STM IoT SDK” project, we set to the “DEV” deployment group.
You can see a list of all PLTs by pressing LIST from the PLTs view:
Or in grouped by deployment group by clicking on on DEPLOYMENT GROUPS.
You can create a project or go through the list of projects already created by clicking on the 3 dots in the top app bar:
The list of projects allows you to switch between them and to select the project you want to work on in PLTcloud. In our case, we selected the “IoTSDK Demo” project.
You can add files to a project.
Files that you might want to add to a project can, for example, be
firmware images (
.bin), or test suite definition
To test and program the STM IoT demo board, we need to upload the firmware
and the test plan. The firmware can be uploaded as an ELF file,
STM32L4_IOT_HR.elf. The test plan is supplied as a YAML
file, for example,
title: "Erase, Program, Identify, Test" suite: - ident: ICT-T1 title: Erase stm32l4_DevKit with USB ST-Link steps: - command: erase stm32l4_STLink - ident: ICT-T2 title: Program STM32L4-IOT-BLE stm32l4_DevKit with USB ST-Link steps: - command: program stm32l4_STLink none,STM32L4_IOT_HR.elf,none - ident: ICT-T3 title: Identify DUT steps: - command: identify stm32l4_IoT_STLink - ident: ICT-T4 title: BLE discovery steps: - command: bledis %BLEMAC% 30 # Wait up to 30 seconds for BLE discovery to complete
You can create releases for your projects.
The files that you will be able to add to a new release are files that you will have previously added through the Files section. You can create multiple releases per project.
For example, to create a new release, you would fill the version and description of cases of your release, and select the files (firmware images and YAML files) you want to be part of your release.
In our case, we need to create a release of
the firmware image (
and of the YAML file (
for the “IoTSDK Demo” project.
These two files are therefore checked when creating the release that
we named “STM32L4 IoT node BLE”.
Back to the main release section, you can click on the deployment icon next to the release you want to deploy to be able to update the PLTs part of that deployment group with this release. Here, it has been deployed to the “DEV” deployment group.
The Edit view can be used to modify basic project settings:
Project Name and Description
Serial Number Allocation scheme (Monotonic / Webhook)
To perform number allocation through an external Serial Number Webhook API endpoint, select the Webhook Serial Number Allocation scheme.
Specify the API endpoint:
The Debug Keys view allow users with the Administrator role to manager public SSH keys to control local access to PLTs while in Debug Mode.
The SSH keys for which public keys are attached for a project can be used to upload test plan YAML files and other artifacts using SFTP.
Once a debug SSH (
.pub) key is set on a project that is
deployed to a PLT, the
Debug Mode can be activated by an Administrator from
the Reset section of the PLT view in PLTcloud:
Reset PLT in Debug Mode
Wait for PLT to restart in Debug Mode
While the PLT is in Debug Mode, an SFTP client (such as sftp or WinSCP) can be used to upload release files.
$ sftp debug@<PLT IP> debug@<PLT_IP>$ put myTestPlan.yaml debug@<PLT_IP>$ put firmware.hex debug@<PLT_IP>$ quit
After adding or modifying test plan YAML files, use the on-screen menu to select “Restart” to ensure the new plans are available.
When a test is executed on a PLT, the report will be automatically generated and be available under the Reports section.
Reports are listed in chronological order, and they will be bold-ed if they were generated less than 5 minutes ago.