PLTcloud User Manual¶
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.
Contents
Home¶
Use the Home page to navigate easily across the different sections of the PLTcloud website.
Home screen¶
PLTs¶
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.
PLTs, grouped in Deployment Groups¶
You can then fill out the name and the description of the group.
New Deployment Group¶
From the PLTs view, detailed information on a PLT can be seen by clicking on the dark-blue eye icon.
PLT Detail View¶
In the case of the “STM IoT SDK” project, we are deploying to PLTs that are part of the “DEV” group.
See also
Adding a PLT¶
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.
Enrollment Code on PLT-200A 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.
PLT Enrollment Form¶
You can then set the PLT to a specific deployment group by clicking on on SET DEPLOYMENT GROUP.
Setting Deployment Group for a PLT¶
For the “STM IoT SDK” project, we set to the “DEV” deployment group.
PLT Views¶
You can see a list of all PLTs by pressing LIST from the PLTs view:
PLT list view¶
Or in grouped by deployment group by clicking on on DEPLOYMENT GROUPS.
PLTs, grouped by Deployment Group¶
See also
Create Project¶
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:
Project Menu¶
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.
Project List¶
Project Files¶
You can add files to a project.
File List¶
Files that you might want to add to a project can, for example, be
firmware images (.hex, .elf, .bin), or test suite definition
files (.yaml).
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,
for example, STM32L4_IOT_HR.elf. The test plan is supplied as a YAML
file, for example, suite-stm32l4DK-IOT-BLE.yaml:
suite-stm32l4DK-IOT-BLE.yaml YAML test plan¶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
See also
Project Releases¶
You can create releases for your projects.
Release List (empty)¶
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 (STM32L4_IOT_HR.elf)
and of the YAML file (suite-stm32l4DK-IOT-BLE.yaml)
for the “IoTSDK Demo” project.
These two files are therefore checked when creating the release that
we named “STM32L4 IoT node BLE”.
New Release¶
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.
Release List¶
See also
Project Settings¶
The Edit view can be used to modify basic project settings:
Project Name and Description
Serial Number Allocation scheme (Monotonic / Webhook)
Serial Number Webhook API¶
To perform number allocation through an external Serial Number Webhook API endpoint, select the Webhook Serial Number Allocation scheme.
Specify the API endpoint:
Debug Keys¶
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
Note
After adding or modifying test plan YAML files, use the on-screen menu to select “Restart” to ensure the new plans are available.
See also
