Home

sidick/micropython wiki

Working notes and design log for the AmigaOS 3.x MicroPython port (branch amiga-port).

For an upstream-style introduction to the port, see ports/amiga/README.md in the source tree.

Main pages

• Amiga port design — index, architecture decisions, the phase-status table (each phase links to its own page), investigation items, and known limitations.
• Amiga port testing — full testing runbook (vamos, Amiberry, CI; install paths, exclude lists, suite snapshot, known-good failures, soft-float library bugs, on-device runner setup).
• Amiga port test status — at-a-glance scoreboard: every port-local smoke test, the upstream-suite snapshot, and the remaining real-hardware failures.
• Upstreaming — tracker for getting the port accepted into upstream MicroPython: generative-AI policy, acceptance blockers and suggestions, audit findings, and the progress log.

Per-phase pages

Each page is the design log and step plan for one phase. The small foundational phases are grouped onto two era pages; the substantial phases each have their own.

• Phases 0–11 — Foundation — toolchain, skeleton, file system, stdlib, amiga module, native emitter, imports, Ctrl+C, native-API migration, networking, argv, CI
• Phase 12 — 68k native emitter rework
• Phases 13–27 — Platform integration — REPL editing, dynamic heap, VFS, Workbench launch, env vars, volumes/assigns, pattern matching, timing, history, break signals, PROGDIR:, build variants
• Phase 17 — Native AmigaOS library access
• Phase 18 — ARexx integration
• Phase 28 — TLS/SSL via AmiSSL v5 (AmiSSL issue notes)
• Phase 29 — urequests frozen HTTP/HTTPS client
• Phase 30 — Intuition requester dialogs
• Phase 31 — ASL file requester
• Phase 32 — ARexx polish
• Phase 33 — platform.amiga_info()
• Phase 34 — Frozen os extensions + AmigaOS-aware os.path
• Phase 35 — amiga.icon
• Phase 36 — amiga.catalog
• Phase 37 — amiga.datatypes (planned)
• Phase 38 — ports/amiga/README.md
• Phase 39 — Additional extmod feature opt-ins (in progress)