Flashing the EEPROM
flash works like OpenOS’s: it writes code to the computer’s EEPROM.
| command | does |
|---|---|
flash FILE [LABEL] |
checks FILE, asks for confirmation, writes it, and sets the label if given |
flash -y FILE [LABEL] |
the same without asking |
flash -r FILE |
saves the EEPROM’s current code to FILE |
flash -i |
shows the label, size, entry point and checksum |
flash /bios.wasm |
restores the stock BIOS from the shell floppy |
Reboot to run what you flashed. flash keeps the EEPROM’s data, where the
BIOS remembers which disk to boot, and reads the code back to check the write
took (a read-only EEPROM keeps its old code).
Before writing, flash checks that the file:
- is a WebAssembly module;
- exports
oc_mainor_start, so there is something to run; - fits: an EEPROM holds 4096 bytes.
What fits on an EEPROM
Section titled “What fits on an EEPROM”4096 bytes is small. An ordinary Rust program built for WASI is 60 KB or
more, so it won’t fit. EEPROM code has to be a tiny no_std program built for
wasm32-unknown-unknown that talks to the oc imports
directly, like the stock BIOS. See
Custom BIOS and init.
To run your own program instead of the shell, you don’t need to flash
anything: make it a disk’s /init.wasm. The stock BIOS boots that, and there
is no size limit.
A flashed EEPROM only runs on a WebAssembly CPU. A Lua computer accepts the EEPROM but won’t boot from it.