# brintOS SOM programming station

This machine programs an Emcraft STM32F7 SOM over JTAG, through a JTAG adapter
attached to this machine over WebUSB.

    som-program-f7            # write U-Boot into the SOM's eNVM, verify, read back
    som-program-f7 --help     # --adapter for another JTAG adapter, --speed, --dry-run

The full procedure — what connects where, the host set-up, the kernel half, and
what to do when it does not work:

    /usr/share/brintos-som-station/flashing-an-stm32f7-som-from-brintos.md

What the station carries:

| Path | What it is |
|---|---|
| `/usr/share/brintos-som/stm32f7/u-boot.bin` | the firmware `som-program-f7` writes |
| `/usr/share/brintos-som/stm32f7/PROVENANCE` | where that binary came from, and its sha256 |
| `/usr/share/openocd/scripts/mfg-jtag.cfg` | the one place the JTAG adapter is named |
| `/usr/share/openocd/scripts/board/emcraft-som-stm32f7.cfg` | the SOM's openocd board config |

To check the station itself, with no board attached:

    brintos-selftest 99-som-station.test