Skip to main content
Tell your agent what the firmware should do. It writes the suite, runs it on the virtual board, and returns a pass or fail for each check. The same checks can fail a pull request. Setup is on Test in CI.

When to use it

Use a test when each check needs a result. A firmware that stops printing fails the test. When you want the printed output, use run.

Ask your agent

What you get back

You get a pass or fail for each test. succeeded means the suite ran, not that every test passed. Check result.summary.

What you can test

A suite advances virtual time, watches UART lines, and drives the board: it presses buttons, reads LEDs, and sends input over UART.

Not supported yet

A suite can use the buttons and LEDs the board already has. Extra buttons or LEDs wired to other pins, other pin-state or register and memory reads, and external sensors or I2C/SPI devices are not supported yet.To test a sensor reading such as a temperature, build a fixed value into the firmware, then expect the line it prints. The suite does not feed the value in.
Last modified on November 2, 2026