Skip to content

Comments

Update APU and MMIO specifications#10

Merged
rafael84 merged 1 commit intomainfrom
codex/update-specs
Feb 4, 2026
Merged

Update APU and MMIO specifications#10
rafael84 merged 1 commit intomainfrom
codex/update-specs

Conversation

@rafael84
Copy link
Owner

@rafael84 rafael84 commented Feb 4, 2026

Motivation

  • Bring the documentation in-line with the current emulator/APU implementation by clarifying the APU register layout, waveform behavior, and data formats.
  • Replace outdated/ambiguous MMIO ranges and TODOs so integrators and toolchains can rely on a stable MMIO map and APU spec.

Description

  • Updated specs/tiny16-apu.txt to describe the unified 4-channel APU design, added the complete waveform list and precise waveform behavior, expanded the note table (C2-B6), and added SFX and music data formats.
  • Updated specs/tiny16-vm.txt to reflect the MMIO region size as 4 KB (0xBF00-0xBFFF) and to reference the APU register block at 0xBF40-0xBF9F while reserving 0xBFF0-0xBFFF for future system registers.
  • Added register-level details including per-channel register stride, music and SFX registers, example usage, and removed obsolete TODOs and legacy channel descriptions.

Testing

  • No automated tests were run because this is a documentation-only change (not applicable).

Codex Task

@rafael84 rafael84 merged commit 67cd1ec into main Feb 4, 2026
3 checks passed
@rafael84 rafael84 deleted the codex/update-specs branch February 4, 2026 09:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant