Table of Contents
include_toc
| include_toc |
|---|
| true |
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.
This wiki is the authoritative manual. Edit these pages directly in Gitea or
in the fds-os.wiki checkout; see Editing the wiki.
Use the sidebar or all pages to find a guide.
| 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 SD and SYSTEM, reach the first console, calibrate bays and diagnose hardware |
| Flash disk images | Install SD and cartridges interactively or unattended with verification |
| 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 |
| Gitea wiki | Edit documentation directly in the wiki |
Implementation plans, dependency rationale, measurements, hardware procedures and historical test results are maintained separately in developer notes.
FDS/OS
Start here
Use the computer
- Use cartridges and run programs
- DATA and persistent files
- WindowMaker and FDS Control
- Dasung Paperlike display
Install and maintain
- Flash disk images
- Internal storage and machine settings
- Pi 5 EEPROM configuration
- Recovery and rollback
- Verify a release
- Reclaim build space
- Troubleshooting
Build and contribute
Home · All pages · Edit the wiki · Source repository
Maintained directly in the fds-os.wiki repository. Historical acceptance applies only to the source and artifacts identified in each record.