Skip to main content
The firmware fails on the virtual board, and you need the run status, the captured UART, and the gotchas Chiplab already knows for that board.

​
What you’ll do

1

Run on the virtual board

Your agent uploads the ELF and runs it on the board model, with the UARTs to capture. Only those UARTs are written into the output.
2

Read the captured output and run status

run returns a run_id immediately. Your agent waits for the job and reads the status: running, succeeded, or failed. stdout is the captured UART output.
3

Ask about chip-specific gotchas

Ask Chiplab about the gotchas for that board. ask takes a natural-language question and returns chip-specific gotchas and validated fixes from real runs.
4

Fix and run again

Change the firmware, build the ELF again, and run it on the same board.

​
Ask your agent

​
What you get back

You get a status and stdout for the UARTs you captured. When the status is failed, the response includes an error string, and ask returns a plain-text answer with the gotchas for that board.

​
Next

run

Execute an ELF on a virtual board and read the UART.

ask

Look up boards, tools, and chip-specific gotchas.
Last modified on October 2, 2026