# benchlink

One USB-C cable to a Dabao (Baochip-1x). benchlink holds a Dabao and gives your computer its power, reset, PROG and console. A script or a coding agent can flash it and read its boot log from the first byte, with no hand on the board.

- Console: 1,000,000 baud
- Pins: 32 broken out
- Board: 95 x 66 mm
- Bridge: RP2350A

## One cable in, six lines out

Your computer sees two serial ports: one to control the board, one for the Dabao's console. The board's RP2350A turns them into the lines below. `RUN`, `PC13` and `ON` are only ever pulled low, so nothing on the board can short or back-feed the Dabao.

| Line | Dabao pin | What it does |
|---|---|---|
| `PB13`, `PB14` | 16, 15 | console at 1,000,000 baud, kept while no program reads it |
| `RUN` | 30 | reset |
| `PC13` | 1 | PROG, for `boot1` |
| `ON` | 37 | both regulators off and on |
| `VSYS` | 39 | current-limited 5 V feed, current and voltage monitored |
| `3V3` | 36 | read back as the Dabao's 3.3 V rail |

## What the board does

- **Holds the Dabao without solder.** Spring probes and a printed cradle for a bare Dabao, or low-insertion-force sockets for one with headers.
- **Console at 1,000,000 baud.** One serial port on the host that stays open across resets and power cycles. Output is kept until a program opens the port.
- **Reset, PROG and power.** `RUN`, `PC13` and `ON` are driven by the board, so getting into `boot1` or power cycling needs no buttons.
- **Flashing over the console.** Whole Xous images go through the UART, each block confirmed. Images already on the board are skipped.
- **A power feed with a monitor.** A current-limited 5 V feed into `VSYS`, with a current and voltage monitor on it.
- **Every pin broken out.** All 32 Dabao pins, labelled on both faces, an I2C connector on the Dabao's PB11 and PB12, and an 8-pin link port. The board's own RP2350 adds eight spare GPIO.
- **Safe for the Dabao.** Nothing on the board can short or back-feed the Dabao, even with faulty firmware.

## Two builds, one site

- **Probes.** For a bare Dabao: 32 spring probes, held down by the printed cradle.
- **Sockets.** For a Dabao with pin headers: two low-insertion-force socket strips.
- **In its case.** A printed case for either build, the cradle or a socket guide in its open bay.

## Made for scripts and agents

Every command answers with one line. A test loop, a CI job or a coding agent can drive a Dabao unattended.

The [agent skill](/wiki/agent-skills) teaches a coding agent to power, reset, flash and read a Dabao on the board.

```sh
benchlink flash --uart loader.uf2 xous.uf2 apps.uf2
benchlink reset
benchlink console --log boot.txt
benchlink status
```

## Sheets

- [The board](/wiki/hardware)
- [The case](/wiki/case)
- [The cradle](/wiki/cradle)
- [Getting started](/wiki/getting-started)
- [Commands](/wiki/commands)
- [Agent skills](/wiki/agent-skills)
- [Firmware](/wiki/firmware)

Advanced: [Printing the parts](/wiki/print-yourself), [Build your own](/wiki/diy-pico).

benchlink is an independent tool. The Dabao and the Baochip-1x are Baochip's. MIT or Apache-2.0.
