Skip to content

grimoire-amix

Documentation for Amiga Unix (Amix) — Commodore's port of AT&T System V Release 4 (SVR4) to 68030 Amigas. Written for both humans and LLM agents: every page is plain Markdown with stable headings, exact commands, and inline source-confidence tags (✅ verified · 🟡 community-reported · 🔴 unverified/disputed).

⚠️ AI-assisted — verify before trusting. This documentation was created with heavy use of LLM tools; much of it is machine-authored and not all of it has been proofread or tested on real hardware. Don't take everything here as fact — rely on the per-page confidence tags and the cited sources. Corrections welcome.

New here? Read What Amix Is, then jump to Running Amix in WinUAE to get a system booting.

An AI agent? Start from ../llms.txt or the whole-corpus ../llms-full.txt; the grounding facts live in ../sources/research-brief.md; the rules are in ../AGENTS.md.

Reading paths

I want to run Amix → Hardware → WinUAE / FS-UAE → Install walkthrough → First login.

I want Amix on my network → Putting Amix on your real LAN (Amiberry A2065 → TAP + proxy-ARP; static IP, DNS, internet, persistent).

I want to write a driver → Driver model → Kernel build → Char driver (par.c) or STREAMS driver (hydra) → Toolchain → the case studies, incl. the A4091 / 53C710 SCSI driver (booting Amix from a Zorro III card).

I want to ship drivers to users → Boot floppy anatomy → Reverse-engineering the boot floppy → Adding drivers to a custom boot disk → Tooling pipeline.

Sections

How Amix works

Overview · Hardware · Boot process · Kernel architecture · Filesystems & disks · Networking · X11 & desktop · Quirks · Glossary

Getting started (emulation-first)

WinUAE · FS-UAE · Amix on Amiberry · On your real LAN (Amiberry) · Install walkthrough · Real hardware · First login & tour

Driver & software development

Driver model · Kernel build · Char driver · STREAMS driver · Zorro AUTOCONFIG · X11 RTG drivers · Toolchain · Case studies: va2000 · xrtg · lszorro · hydra · A4091 / 53C710

Custom boot & install disks

Boot floppy · Root floppy · Patch floppy · Reverse-engineering the boot floppy · Adding drivers · Tooling pipeline

Reference

Versions · Device & card list · Command cheat sheet · Bibliography

Contributing

Style guide · Writing for LLMs

Sources