Skip to content

OS content from TuKo1982's 68080 optimisation guide - #12

Merged
WDrijver merged 1 commit into
mainfrom
content-os
Nov 3, 2026
Merged

WDrijver merged 1 commit into
mainfrom
content-os

Conversation

@WDrijver

@WDrijver WDrijver commented Nov 3, 2026

Copy link
Copy Markdown
Contributor

Third content PR from TuKo1982's "68080 compilation and optimisation guide". It covers section 13 (AmigaOS notes), section 8.2 item 10 (ramlib) and section 15 (maggie.library usage). New files: owner: TuKo1982, origin: ai-assisted, status: draft.

New files

  • os/libraries/maggie-library.md:
    • linking (shared and static) and build flags;
    • frame setup, including the SAGA full-screen setup the samples use;
    • draw paths and draw modes;
    • textures (always DXT1) and profiling.
  • os/pitfalls/maggie-library-side-effects.md, what a call does to your task:
    • FPCR left at RZ;
    • D8–D31 destroyed;
    • the Apollo bit is never set;
    • hasMaggie hard-wired to 1;
    • about 470 BANK-prefixed FPU instructions that future cores won't support.
  • os/best-practices/detect-68080-and-fpu-at-run-time.md: AttnFlags bit 10, and the FPU flag checked at run time ($847f / $040f).
  • os/pitfalls/stack-patches-hide-small-stack-bugs.md
  • os/pitfalls/library-globals-shared-between-tasks.md
  • os/pitfalls/v4-rom-modules-and-reset.md:
    • LoadModule can't replace a module with priority 105 or higher (stub priority 104);
    • Ethernet RX DMA survives a soft reset;
    • avail flush with ROM audio.device 37.10.
  • os/pitfalls/ramlib-reuses-library-by-name.md

Updated files

  • os/apolloos-and-amigaos-on-v4.md: pointers to these files under "Detecting Apollo V4 hardware", "Using SAGA features" and a new "Known traps" section. WDrijver's own notes for this file are still to come.
  • core/saga-3d-maggie/index.md: links to the library file.

For the reviewers

  • applies_to.os is [amigaos-3.9] for the maggie.library files, because that's what was tested. Is the library also used on ApolloOS R10 or AmigaOS 3.2?
  • Left out: "Text files for the Amiga: ISO-8859-1, no UTF-8" (section 13). It fits better in conventions/, so I suggest a separate file there.
  • The full-screen SAGA setup ($DFF1F4 mode, $DFF1EC frame pointer, read back at $DFE1F4 / $DFE1EC, modes $0B02 / $0B05) is in the library file as "as the samples do". It belongs in core/saga-video-isabelle/registers.md once that file exists.

Knowledge base files relied on

  • core/saga-3d-maggie/registers.md, core/cpu-68080/bank-prefix.md, core/pitfalls/fpu-float-to-integer-conversion.md
  • CONTRIBUTING.md sections 2 and 4

🤖 Generated with Claude Code

Split section 13 (AmigaOS notes), 8.2 item 10 (ramlib) and section 15
(maggie.library usage) of the guide into os/: maggie.library reference,
its side effects on the calling task, run-time 68080/FPU detection, and
pitfalls for stack patches, shared library globals, V4 ROM modules and
soft resets, and ramlib. Point to them from the OS overview file.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@WDrijver
WDrijver requested a review from TuKo1982 as a code owner November 3, 2026 12:52
@WDrijver
WDrijver merged commit a7ab126 into main Nov 3, 2026
2 checks passed
@WDrijver
WDrijver deleted the content-os branch November 3, 2026 15:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant