Getting Started

This guide takes you from unboxing your new PLT-106 to your first test run. Each step links to the detailed page for more information.

The example programs a Bento Board through a Test Agent and a Flashr. Neither the DUT nor the programmer are required: see Other targets and programmers.

Tip

If you use a coding agent, consider installing the PLT AI Kit first. The agent can then guide you through the rest of these steps and write your test plans.

Set up the hardware

  1. Assemble the PLT-106, connect its USB-C power input to a power supply, and connect its Ethernet port to a router or switch with DHCP and outbound Internet access.

  2. Connect the rest of the station as shown in Common Wiring. Power the Test Agent externally, not from the PLT’s USB port.

  3. Power on the PLT.

Details: PLT-106 Setup and PLT Connectivity.

Create a PLTcloud account

Sign up at https://pltcloud.com and create an organization. If you are joining an existing organization, use the email address your administrator invited.

Details: Create a PLTcloud Account.

Enroll the PLT

  1. On the PLT, select Menu → Enroll. The PLT shows an enrollment code.

  2. In the PLTs section of PLTcloud, select the Enroll PLT form and enter that code as the Activation code.

Details: Adding a PLT.

Create a project and deployment group

A project holds your files and releases. A deployment group is a set of PLTs that run the same release.

  1. Create a project.

  2. Create a deployment group and assign your PLT to it.

Create your first release

A release combines a test plan with the files it needs. For the Bento Board:

  1. Download bento_blinky.hex from the v1.0.1 firmware release.

  2. Download the test plan, bento-flashr-blinky.yaml. It waits for the Test Agent, sends it the firmware, and programs the board:

    title: "Bento Flashing Demo"
description: "Flash RP2350B via PER-101 Test Agent and Flashr"

suite:
  - title: "Defines"
    steps:
      - command: define FIRMWARE.filename "bento_blinky.hex"
      - command: define AGENT.vidpid "6666:8001"
      - command: define FIRMWARE.target "rp2350"
      - command: define DUT.vidpid "2fe3:0004"

  - title: "Setup Programming Session"
    steps:
      - command: usb detect
        id: "%AGENT.vidpid%"
        timeout: 30s
      - command: agentCfg PROGSBC UART2
        id: "%AGENT.vidpid%"
        retry: 3
        with:
          - "%FIRMWARE.filename%"
  - title: "Program RP2350B via Flashr"
    steps:
      - command: agentExec PROGSBC "flashr-flash %FIRMWARE.target% /run/pltagent/mnt/%FIRMWARE.filename%"
        timeout: 30s

  3. Create a release containing both files.

To write your own plan, start with the Test Plan Reference.

Other targets and programmers

The Bento Board and Flashr are only one option. You can program and test other hardware with other tools:

Run the test plan

  1. Deploy the release to your deployment group.

  2. On the PLT, select Menu → Check for Updates → Update.

  3. Run the test plan. The board is programmed and starts blinking.

  4. View the test report in PLTcloud. See Manage Reports.

Next steps

You can improve your interactions with the PLT hardware and PLT Cloud with: