program - Program DUT

Erase and Program DUT MCU on-board flash.

General usage:

- command: program <target> [<uartPort>] [offset:]<img>[,[offset:]<img>[,...]] [noerase]
  [id: <usbDeviceID>]
  [path: <usbDevicePath>]
  [interface: <usbDeviceInterface>]
  [retry: <retryCount>]

Argument

Description

target

Target to program.

uartPort

UART port name. Only required for UART programming targets.

offset

Optional: Image Address Offset.

img

Firmware File.

Optional: Additional offsets, images

noerase

Optional: If set, DUT will not be erased prior to programming.

usbDeviceID

Optional: Programming adapter USB device identifiers: VID:PID.

usbDevicePath

Optional: Programming adapter USB device path: port. ... .port.

usbDeviceInterface

Optional: Programming adapter USB device interface: interface_number.

retryCount

Optional: Number of times to retry the test step.

On the PLT-300A, the programming adapter can be specified using usbDeviceID, usbDevicePath, and usbDeviceInterface. Specifying the programming adapter location allows multiple adapters of the same type to be used in a single test plan, or for an external adapter to be used in place of the built-in programming adapter. See USB Interaction for details on specifying USB devices.

Firmware images can be provided as Intel HEX (.hex), ELF (.elf / .axf) or binary files (requiring an offset).

Usage with CMSIS programming packs:

- command: program CMSIS [offset:]<img>
  pack: <cmsisPack>
  target: <cmsisTarget>
  [id: <usbDeviceID>]
  [path: <usbDevicePath>]
  [retry: <retryCount>]

Argument

Description

offset

Optional: Image Address Offset.

img

Firmware File.

cmsisPack

CMSIS Pack file.

cmsisTarget

Target name, as defined in CMSIS Pack file.

usbDeviceID

Optional: USB device identifiers: VID:PID.

usbDevicePath

Optional: USB device path: port. ... .port.

retryCount

Optional: Number of times to retry the test step.

Firmware images can be provided as Intel HEX (.hex), ELF (.elf / .axf) or binary files (requiring an offset).

Usage with USB-DFU targets:

- command: program USB-DFU [offset:]<img>
  target: <target>
  [id: <usbDeviceID>]
  [path: <usbDevicePath>]
  [retry: <retryCount>]

Argument

Description

offset

Optional: Image Address Offset.

img

Firmware File.

target

Target MCU to program.

usbDeviceID

Optional: USB device identifiers: VID:PID.

usbDevicePath

Optional: USB device path: port. ... .port.

retryCount

Optional: Number of times to retry the test step.

If neither usbDeviceID or usbDevicePath is set, the device connected to DUT USB-C Port (Port 1) is assumed.

For USB-DFU, firmware images must be in .dfu format. The dfuse-pack.py script from the dfu-util project <https://sourceforge.net/p/dfu-util/> can be used to generate .dfu files from hex or binary.

Supported target values:

target

Description

ATSAMD

Microchip (Atmel) SAM D1x/D2x, C2x, L2x, R2x or R3x (SWD)

ATSAMD_DAP

Microchip (Atmel) SAM D1x/D2x, C2x, L2x, R2x or R3x (USB, CMSIS-DAP)

ATSAME5

Microchip (Atmel) SAM D5x/E5x (SWD)

ATSAME5_DAP

Microchip (Atmel) SAM D5x/E5x (USB, CMSIS-DAP)

AVRATmega168P_ISP

Microchip (Atmel) AVR ATmega168P(A) (JTAG:ISP)

AVRATmega168P_XPm

Microchip (Atmel) AVR ATmega168P(A) (USB, XPmini)

AVRATmega168PB_ISP

Microchip (Atmel) AVR ATmega168PB (JTAG:ISP)

AVRATmega168PB_XPm

Microchip (Atmel) AVR ATmega168PB (USB, XPmini)

CC1352_DAP

TI CC1352P1, CC1352R1 RFSoC (USB, CMSIS-DAP)

CC1352P7_DAP

TI CC1352P7 RFSoC (USB, CMSIS-DAP)

CMSIS

CMSIS-DAP programmer, requires pack: and target: fields (USB)

EFM32

Silicon Labs EFM32 MCU (SWD)

EFR32

Silicon Labs EFR32 RFSoC (SWD)

ESP32_UART

Espressif ESP32 RFSoC (UART)

LPC11xx

NXP LPC11xx MCU (SWD)

nRF52

Nordic nRF52 RFSoC (SWD)

nRF52_DAP

Nordic nRF52 RFSoC (USB, CMSIS-DAP)

nRF52_JLink

Nordic nRF52 RFSoC (USB, JLink)

nRF91

Nordic nRF9160 RFSoC:Cortex-M33 (SWD)

nRF91_JLink

Nordic nRF9160 RFSoC:Cortex-M33 (USB, JLink)

PIC18F25K20

Microchip PIC18F25K20 (JTAG:ICSP)

PIC18F25K20_PK2

Microchip PIC18F25K20 (USB, PICkit2)

PN7360

NXP PN7360 (SWD)

PN7362

NXP PN7362 (SWD)

PN7460

NXP PN7460 (SWD)

PN7462

NXP PN7462 (SWD)

PSoC4

Infineon (Cypress) PSoC4 (SWD)

PSoC6

Infineon (Cypress) PSoC6 (SWD)

PSoC6_KP3

Infineon (Cypress) PSoC6 (USB, KitProg3)

STM32F1

ST STM32F1xx MCU (SWD)

STM32F1_STLink

ST STM32F1xx MCU (USB, ST-Link)

STM32F2

ST STM32F2xx MCU (SWD)

STM32F2_STLink

ST STM32F2xx MCU (USB, ST-Link)

STM32F4

ST STM32F4xx MCU (SWD)

STM32F4_STLink

ST STM32F4xx MCU (USB, ST-Link)

STM32G4

ST STM32G4xx MCU (SWD)

STM32G4_STLink

ST STM32G4xx MCU (USB, ST-Link)

STM32L4

ST STM32L4xx MCU (SWD)

STM32L4_STLink

ST STM32L4xx MCU (USB, ST-Link)

STM32L5

ST STM32L5xx MCU (SWD)

STM32L5_STLink

ST STM32L5xx MCU (USB, ST-Link)

STM32H7

ST STM32H7xx MCU (SWD)

STM32H7_STLink

ST STM32H7xx MCU (USB, ST-Link)

USB-DFU

USB Device Firmware Upgrade (DFU 1.0, 1.1) (USB)

Examples