Repository navigation
Core content from TuKo1982's 68080 optimisation guide - #10
Merged
Merged
Conversation
Split sections 0-7, 13 (ARNE) and 15.7 (Maggie registers) of the "68080 compilation and optimisation guide" into core/: measured references in cpu-68080/, best practices, pitfalls, and register files for Maggie and ARNE. Owner TuKo1982, ai-assisted, draft, with source tags (G)/(M)/(official)/(SRC) and core revisions. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
First content PR from TuKo1982's "68080 compilation and optimisation guide" (2026-10-30): the core pillar. Toolchain, os, hardware and guides follow in separate PRs.
All files:
owner: TuKo1982,origin: ai-assisted,status: draft. Facts carry their source tag ((G) Gunnar, (M) measured, (official) PRM, (SRC) source code),basis, and the core revision inapplies_to.core.Files (41 new, 3 updated)
core/cpu-68080/(11 references, measured):core-at-a-glancepipeline-15-stagessuperscalar-issuebranches-and-predictionmeasured-instruction-costsfpu-performance-modelcaches-and-memorybank-prefixisa-notes-measuredperformance-counterscore-bugs-by-revisioncore/best-practices/(11):interleave-dependency-chainsclose-loops-with-dbrapredicated-bcc-over-one-instructionuse-fusable-pairsfpu-schedule-by-completion-slotfpu-when-it-paysalign-copy-destinationcode-size-and-placementammx-where-it-winsmemory-access-patternsfixed-point-and-bitstreamscore/pitfalls/(20):alu-to-ea-bubblealternating-branch-mispredictedreturn-address-patchingfused-copy-overlapmultiply-and-bfffo-block-both-pipesfpu-47-bit-context-savefpu-float-to-integer-conversionfpu-precision-and-roundingfpu-broken-instructionsfpu-exceptions-never-trapself-modifying-code-and-cachestouch-misuseammx-pc-relative-sourceammx-upper-32-bitstex-does-not-match-prmbank-prefix-pitfallspc-relative-destinationmaggie-depth-test-colour-writemaggie-span-tailmaggie-span-usageChip folders:
core/saga-3d-maggie/registers.mdcore/saga-audio-arne/registers.md(partial)Updated: the indexes of
cpu-68080,saga-3d-maggieandsaga-audio-arne.Where these files differ from the PRM
The new conflict rule makes measured facts win. The differences:
touch (An)ismove16;These are useful for Tommo's next PRM edition.
For TuKo1982 to check
Workarounds I derived myself, marked "not tested" in the files:
They follow from the measured behaviour but aren't in the guide. Please confirm or replace.
I wrote new code examples for Wrong/Right sections where the guide has none. They are not assembled in CI: they are fragments without
kb:compile.applies_to.coreranges I chose from the guide's wording: mostlyCore 12841; FPU context save and conversionCore 12830-12841; bug listCore 12001-12847.Not in this PR:
Knowledge base files relied on
templates/files/reference.md,best-practice.md,pitfall.mdcore/cpu-68080/prm/(for cross-references)🤖 Generated with Claude Code