Expand documentation suite: 30+ articles enriched with diagrams, code examples, and hardware details

Graphics: text_fonts (bitmap layout, styles), sprites (DMA, multiplexing), gfx_base (chipset detection), rastport (draw modes, clipping), ham_ehb (mermaid fixes), display_modes (HAM palettes)

Devices: scsi (per-model interfaces, Gayle limits, CD-ROM, native vs vendor drivers), console (ANSI sequences, CON:/RAW:), parallel (CIA registers, pinout), timer (resource exhaustion), gameport (quadrature, XOR state)

Libraries: workbench (WBStartup, AppWindow/Icon/MenuItem), rexxsyslib (ARexx port hosting, command parsing), diskfont (font directory, colour fonts), keymap (rawkey codes, dead keys), locale (catalogue system, date formatting), layers (ClipRect, refresh types), utility (TagItem chains), icon (DiskObject, ToolTypes), iffparse (IFF structure, ByteRun1), expansion (Zorro AutoConfig)

Networking: tcp_ip_stacks (major rewrite - Amiga vs Unix architecture, SANA-II pipeline, PPP/SLIP dial-up, Ethernet cards, MiSTer), bsdsocket (pure API ref), sana2 (buffer hooks, driver requirements), protocols (all code examples). Deduplicated overlap between the three files.

Toolchain: debugging (Enforcer patterns, SnoopDOS, GDB remote, kprintf checklist), sasc (pragma encoding, __saveds idioms), stormc (NEW - StormC IDE, C++, PowerPC)

References: error_codes (DOS, Exec, trackdisk, Intuition error tables)
Driver development: rtg_driver (Native driver analysis, P96 tuning)

All 22 README indexes updated. Root README synced with stormc.md entry.
This commit is contained in:
Ilia Sharin 2026-04-23 21:37:26 -04:00
parent 0ded078134
commit f61c26b542
38 changed files with 6402 additions and 1065 deletions

View file

@ -2,11 +2,13 @@
# Driver Development — Overview
Technical reference for developing hardware drivers on AmigaOS. Covers the exec.device framework, RTG graphics card drivers (Picasso96/CyberGraphX), SANA-II network drivers, and AHI audio drivers.
## Section Index
| File | Description |
|---|---|
| [sana2_driver.md](sana2_driver.md) | Writing a SANA-II network device driver |
| [rtg_driver.md](rtg_driver.md) | Writing Picasso96/RTG display card drivers |
| [ahi_driver.md](ahi_driver.md) | Writing AHI audio drivers |
| [device_driver_basics.md](device_driver_basics.md) | exec.device framework — how Amiga devices work |
| [device_driver_basics.md](device_driver_basics.md) | exec.device framework — IORequest lifecycle, BeginIO/AbortIO, unit management |
| [rtg_driver.md](rtg_driver.md) | Picasso96/RTG driver architecture — SetFunction patching, BoardInfo hooks, VRAM/CRTC management, signal routing, Native driver, compatibility issues, system tuning |
| [sana2_driver.md](sana2_driver.md) | SANA-II network device driver specification |
| [ahi_driver.md](ahi_driver.md) | AHI retargetable audio driver interface |