# 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

It can also open the SOM's serial console, once the carrier's USB-serial bridge
(P1) is granted to this machine too:

    som-console               # the SOM's console in picocom, 115200 8N1; C-a C-x leaves
    som-console --list        # every USB-serial port this machine has
    minicom -b 115200 -D $(som-console --find)

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 99-som-console.test 99-minicom.test

With P1's bridge granted, the last two also exchange a line with the board.