incidental readme improvements

these got updated as the bao1x repo had some maintenance
done while fixing up the register ranges
This commit is contained in:
bunnie 2025-11-25 19:06:16 +08:00
parent e9d8ec8f1d
commit 9821ed7d93
2 changed files with 9 additions and 1 deletions

View file

@ -5,11 +5,19 @@ Baochip-based boards use the `bao1x` SoC. There are two boards supported out-of-
- `dabao` is a minimal SoM-style breakout board. Basically just the chip on a board.
- `baosec` is a hardware security token. It features a camera, display, external memory, buttons, and a supplemental hardware TRNG.
The build idiom is `cargo xtask <target>`, i.e. `cargo xtask dabao`. The build will generate a [`UF2`](https://makecode.com/blog/one-chip-to-flash-them-all) artifact, which can be found in `target/riscv32imac-unknown-[xous|none]-elf/release/`.
Holding down the `PROG` button while plugging the device into USB will cause it to enter a bootloader that enumerates a mass storage device. The build artifacts can then be copied onto the device. Pressing `PROG` again will cause the device to run the program. Targets also enumerate a serial port over USB, which will activate a debug console.
## Bootloaders
Regardless of the board, the `bao1x` chip comes from the factory programmed with `boot0` and `boot1` stages. The code for these can be found in `bao1x-boot/`.
- `boot0` is a permanent root of trust burned onto the chip. Its sole purpose is to validate `boot1`. See [security model](./README-baochip.md#security-model) for details on the trust chain
- `boot1` contains a USB driver, serial-over-USB driver, and serial driver capable of accepting code updates in the form of .u2f files or serial commands. It also contains a small command terminal for managing configurations, keys, and device lifecycle state.
### Applications
Three application targets are supported by Xous:
- `baremetal` is an unsecured, bare-iron environment. It is `no-std`, but comes with `alloc` pre-initialized and a USB serial console.

View file

@ -17,7 +17,7 @@ The [Xous Book](https://betrusted.io/xous-book/) covers the architecture and str
The [wiki](https://github.com/betrusted-io/betrusted-wiki/wiki) is a community resource that answers many FAQ.
The [Baochip README](./README-baochip.md) is the starting point for Baochip users.
The [Baochip README](./README-baochip.md) is the starting point for Baochip users. `vscode` users may wish to install the `baochip` extension to help manage build & test cycles.
The [Precursor README](./README-precursor.md) is the starting point for Precursor users.