docs(amiga): complete AmigaOS 3.1/3.2 developer reference — 172 files across 17 sections

Comprehensive technical documentation covering:
- Hardware: OCS/ECS/AGA custom chip registers, Copper & Blitter deep dives
- Boot sequence: cold boot through startup-sequence
- Binary format: HUNK executable spec, relocation, debug info
- Linking & ABI: .fd files, LVO tables, register calling conventions
- Exec kernel: tasks, interrupts, memory, signals, semaphores
- AmigaDOS: file I/O, FFS/OFS layout, CLI/Shell scripting
- Graphics: planar bitmaps, Copper programming, HAM/EHB modes
- Intuition: screens, windows, IDCMP, BOOPSI
- Devices: trackdisk, SCSI, serial, timer, audio, keyboard
- Libraries: utility, expansion, IFFParse, locale, ARexx
- Networking: bsdsocket API, SANA-II, TCP/IP stack comparison
- Toolchain: GCC, vasm/vlink, SAS/C, NDK, debugging
- Reverse engineering: IDA/Ghidra setup, compiler fingerprints, case studies
- CPU & MMU: 68040/060 emulation libs, PMMU, cache management
- Driver development: SANA-II, Picasso96/RTG, AHI audio

All files include breadcrumb navigation. No local paths or proprietary content.

10_devices/keyboard.md

@@ -0,0 +1,48 @@
+[← Home](../README.md) · [Devices](README.md)
+
+# keyboard.device — Keyboard Input
+
+## Overview
+
+`keyboard.device` provides raw keycode events from the keyboard controller (8520 CIA-A). Normally used indirectly via `input.device`, but can be accessed directly for keymap-independent scanning.
+
+---
+
+## Keycodes
+
+Amiga keycodes are 7-bit values (0–127). Bit 7 indicates key-up:
+
+| Code | Key | Code | Key |
+|---|---|---|---|
+| `$00` | \` (backtick) | `$40` | Space |
+| `$01`–`$0A` | 1–0 | `$41` | Backspace |
+| `$10`–`$19` | Q–P | `$42` | Tab |
+| `$20`–`$28` | A–L | `$43` | Enter (keypad) |
+| `$31`–`$39` | Z–/ | `$44` | Return |
+| `$45` | Escape | `$46` | Delete |
+| `$4C` | Cursor Up | `$4D` | Cursor Down |
+| `$4E` | Cursor Right | `$4F` | Cursor Left |
+| `$50`–`$59` | F1–F10 | `$5F` | Help |
+| `$60` | Left Shift | `$61` | Right Shift |
+| `$62` | Caps Lock | `$63` | Control |
+| `$64` | Left Alt | `$65` | Right Alt |
+| `$66` | Left Amiga | `$67` | Right Amiga |
+
+---
+
+## Commands
+
+| Code | Constant | Description |
+|---|---|---|
+| 2 | `CMD_READ` | Read raw keycodes |
+| 5 | `CMD_CLEAR` | Clear keyboard buffer |
+| 9 | `KBD_READMATRIX` | Read full key matrix state |
+| 10 | `KBD_ADDRESETHANDLER` | Add Ctrl-Amiga-Amiga handler |
+| 11 | `KBD_REMRESETHANDLER` | Remove reset handler |
+| 12 | `KBD_RESETHANDLERDONE` | Acknowledge reset handler completion |
+
+---
+
+## References
+
+- NDK39: `devices/keyboard.h`