Commands

onmcu list-boards

List the boards available to your OnMCU account.

Run list-boards to see the board names you can pass to onmcu run:

onmcu list-boards

The command prints the canonical board part number, MCU part number, and manufacturer for each board available to the authenticated account. Column widths expand to fit the longest value returned by the controller.

Available Boards:
Board MPN      MCU MPN        Manufacturer
------------------------------------------------
NUCLEO-H743ZI  STM32H743ZIT6  STMicroelectronics

Pass the value from the Board MPN column to onmcu run --board. Matching is case-insensitive, so nucleo-h743zi resolves to the canonical NUCLEO-H743ZI entry.

Use an environment credential

export ONMCU_API_KEY='your-api-key'
onmcu list-boards --api-key-from-env

To query another controller, place the global --config option before the command:

onmcu --config ./onmcu.toml list-boards

The list depends on your account and can change. Run the command instead of copying the list from this page.

onmcu run

Upload firmware, run it on a matching board, and stream its logs.

onmcu login

Store an OnMCU API key in the operating system keyring.

On this page

Use an environment credential