update docs

This commit is contained in:
2026-09-24 13:03:52 +08:00
parent f5d9f96409
commit 0d42dc5acc
11 changed files with 570 additions and 10 deletions
+7 -2
View File
@@ -6,6 +6,9 @@ cartridges on another Linux distribution, use the [workstation guide](workstatio
A prepared set of kernel, initramfs and SYSTEM images can be run on a Linux
workstation without building the OS locally.
For the physical computer, follow [Run FDS on a Raspberry Pi 5](hardware-setup.md).
It covers HDMI-plus-USB monitor wiring, both disks, EEPROM, first boot and recovery.
## Prepare the workstation
Use a normal user account, a Git checkout with its submodule metadata, and a
@@ -63,7 +66,7 @@ inputs needed by the emulator:
builds a SYSTEM with compilers, Git, Vim, debuggers and display diagnostics.
Both profiles include WindowMaker and the Dasung daemon. The desktop starts on
request. `make all` also assembles recovery, boot and internal-storage images;
see [internal installation](internal-storage.md) when preparing a physical machine.
see [real-hardware setup](hardware-setup.md) when preparing a physical machine.
## Start the emulator
@@ -76,7 +79,9 @@ out/workstation/fds-emulator --session out/my-emulator console
```
If QEMU is installed directly on the workstation, omit `--qemu-runner`.
The session directory must be new. At the `FDS>` prompt:
Use a new session directory for the first run; after `stop`, you can `start` the
same session again. Logs and DATA overlays are retained, and bays start empty.
At the `FDS>` prompt:
```sh
fds info