Files
fds-os/docs/README.md
T
2026-09-24 13:03:52 +08:00

2.0 KiB

FDS/OS user manual

FDS/OS runs a cartridge-based Linux computer. Start with the overview, then choose the guide for building software, trying the emulator, or operating the machine. Commands in workstation guides run on your Linux computer; commands in the operating guides run at the FDS console unless stated otherwise.

Guide What you will learn
Overview How the computer, internal storage and cartridges fit together
Run on a Raspberry Pi 5 Wire HDMI/USB/power, prepare NVMe and SYSTEM, reach the first console, calibrate bays and diagnose hardware
Build and start FDS Prepare the OS build workstation, create images and boot the emulator
Software and emulator walkthrough Build Void source packages, assemble cartridges, insert them and write USB media
Using cartridges Inspect bays, run applications, resolve command names and eject safely
DATA and files Use persistent storage and manage active DATA
Desktop and control panel Open WindowMaker, manage cartridges graphically and customize the theme
Software format Write source recipes and understand the installed-program image layout
Internal storage Install boot/recovery storage and manage machine settings
Recovery Inspect failed media and check or repair DATA
Release verification Verify downloaded images before use
Dasung display Inspect and control the built-in Paperlike daemon
Cleanup Reclaim obsolete build output without losing current images or personal data
Troubleshooting Diagnose build, cartridge, desktop and emulator problems

Implementation plans, dependency rationale, measurements, hardware procedures and historical test results are maintained separately in developer notes.