> ## Documentation Index
> Fetch the complete documentation index at: https://docs.veecle.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Frameworks

> The OS and framework combinations Chiplab runs, and which boards have an example.

Chiplab runs the same firmware pattern across five OS/framework combinations:

* **`bare-metal`** — vendor-HAL / direct-register Rust firmware (no async runtime).
* **`embassy-rust`** — the same firmware on the [Embassy](https://embassy.dev) async runtime.
* **`zephyr-os`** — the same firmware on the [Zephyr RTOS](https://zephyrproject.org) (C, built with `west`).
* **`freertos`** — the same firmware on the [FreeRTOS](https://www.freertos.org) kernel (C, built with `make` + `arm-none-eabi-gcc`).
* **`threadx`** — the same firmware on the [Eclipse ThreadX](https://github.com/eclipse-threadx/threadx) kernel (C, built with `make` + `arm-none-eabi-gcc`).

## Board matrix

Every board Chiplab supports today and its **model** — the `model` field inside the `board` object your agent passes to `run`.
The board, the chip, and the UARTs that model can capture are on [Hardware](/hardware/boards).
A checkmark links to a ready-to-run example for that OS/framework (— = not available yet).
The canonical copy of this framework matrix lives in [supported-boards.md](https://github.com/veecle/chiplab/blob/main/supported-boards.md); if the two ever diverge, that file is authoritative for which examples exist.
The `model` values are what the simulator accepts; call `ask` if this page and the live platform ever disagree.

| Board | `model` | `bare-metal` | `embassy-rust` | `zephyr-os` | `freertos` | `threadx` |
| - | - | - | - | - | - | - |
| STM32F4 Discovery | `stm32f4_discovery` | [✓](https://github.com/veecle/chiplab/tree/main/examples/bare-metal/stm32f4-discovery) | [✓](https://github.com/veecle/chiplab/tree/main/examples/embassy-rust/stm32f4-discovery) | [✓](https://github.com/veecle/chiplab/tree/main/examples/zephyr-os/stm32f4-discovery) | [✓](https://github.com/veecle/chiplab/tree/main/examples/freertos/stm32f4-discovery) | [✓](https://github.com/veecle/chiplab/tree/main/examples/threadx/stm32f4-discovery) |
| STM32F7 Discovery | `stm32f7_discovery` | [✓](https://github.com/veecle/chiplab/tree/main/examples/bare-metal/stm32f7-discovery) | [✓](https://github.com/veecle/chiplab/tree/main/examples/embassy-rust/stm32f7-discovery) | [✓](https://github.com/veecle/chiplab/tree/main/examples/zephyr-os/stm32f7-discovery) | [✓](https://github.com/veecle/chiplab/tree/main/examples/freertos/stm32f7-discovery) | — |
| STM32F103 Blue Pill | `stm32f103_blue_pill` | [✓](https://github.com/veecle/chiplab/tree/main/examples/bare-metal/stm32f103-blue-pill) | [✓](https://github.com/veecle/chiplab/tree/main/examples/embassy-rust/stm32f103-blue-pill) | — | [✓](https://github.com/veecle/chiplab/tree/main/examples/freertos/stm32f103-blue-pill) | — |
| STM32WBA52 Nucleo | `stm32wba52_nucleo` | — | [✓](https://github.com/veecle/chiplab/tree/main/examples/embassy-rust/stm32wba52-nucleo) | — | — | — |
| STM32L073 Nucleo | `stm32l073_nucleo` | [✓](https://github.com/veecle/chiplab/tree/main/examples/bare-metal/stm32l073-nucleo) | [✓](https://github.com/veecle/chiplab/tree/main/examples/embassy-rust/stm32l073-nucleo) | [✓](https://github.com/veecle/chiplab/tree/main/examples/zephyr-os/stm32l073-nucleo) | [✓](https://github.com/veecle/chiplab/tree/main/examples/freertos/stm32l073-nucleo) | — |
| STM32H745 Nucleo | `stm32h745_nucleo` | [✓](https://github.com/veecle/chiplab/tree/main/examples/bare-metal/stm32h745-nucleo) | — | [✓](https://github.com/veecle/chiplab/tree/main/examples/zephyr-os/stm32h745-nucleo) | [✓](https://github.com/veecle/chiplab/tree/main/examples/freertos/stm32h745-nucleo) | — |
| nRF52840 DK | `nrf52840_dk` | [✓](https://github.com/veecle/chiplab/tree/main/examples/bare-metal/nrf52840-dk) | [✓](https://github.com/veecle/chiplab/tree/main/examples/embassy-rust/nrf52840-dk) | [✓](https://github.com/veecle/chiplab/tree/main/examples/zephyr-os/nrf52840-dk) | [✓](https://github.com/veecle/chiplab/tree/main/examples/freertos/nrf52840-dk) | — |

Call Chiplab's discovery/help tool (`ask`) to confirm the current, authoritative set of boards — it may be ahead of what's listed here.