Repository navigation
ApolloLib in toolchain/apollolib/, with its known bugs - #19
Merged
Merged
Conversation
Describe ApolloLib (ApolloCrossDev Projects/ApolloLib, commit ce1fcbf, after the merge of the two versions in ApolloCrossDev #16 and #17): how a project uses it, sound on Arne, pictures, PIP and the pointer, input, memory and blit routines, system and timing, and the serial debug output. toolchain/pitfalls/apollolib-known-bugs.md lists what reading the code found, among them the 320-pixel fall-through in ApolloShowPicture, the VBlank server of ApolloTimer that is never removed, and the takeover helpers without restore. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…Dev #18 ApolloCrossDev #18 fixed the bugs listed in apollolib-known-bugs.md and added ApolloTimerStop, ApolloRelease, ApolloPermit and ApolloEnable. Describe that version: the pitfall now lists what was fixed and the limits that remain; sound, picture, input, memory and system files follow the fixes, and the restore table names the new functions. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
WDrijver
added a commit
that referenced
this pull request
Nov 4, 2026
ApolloCrossDev #19 made ApolloShowPiP1/2 load the 8-bit palette and fixed the SAGAPiP example. The example page now calls ApolloShowPiP1 without its own palette loop, and its "full example" section lists what #19 changed. The PIP palette moves from the remaining limits to the fixed bugs. 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.
Describes ApolloLib in AKB. Stacked on #18: its links point to
core/saga-registers/and the library best practice. When #18 is merged, this PR moves tomainby itself.Source: ApolloCrossDev
Projects/ApolloLibat commit 639e195 (2026-11-04). That is after the merge of the two versions (ApolloCrossDev #16), the warning fixes (#17) and the bug fixes found while writing this PR (#18). The copy in ApolloClaudedocs/toolchain/_ApolloLibis stale and not used: AKB is the evolution of ApolloClaude.New files (
draft,ai-assisted, basis source-code, owner WDrijver)toolchain/apollolib/index.mdtoolchain/apollolib/sound.mdstruct ApolloSound, load/play/stop/volume/fade, the older channel APItoolchain/apollolib/picture.mdstruct ApolloPicture, BMP/DDS loading,ApolloShowPictureand its modes, PIP on/off, the 32x32 pointertoolchain/apollolib/input.mdtoolchain/apollolib/memory-and-blit.mdtoolchain/apollolib/system-and-timing.mdApolloWaitVBL,ApolloCPUTick/Delay,ApolloTimer, the takeover helpers and how to restore at exittoolchain/apollolib/debug.mdAD/ADXandDebug_*macro setstoolchain/pitfalls/apollolib-known-bugs.mdBugs found and fixed
Reading the code found bugs, and ApolloCrossDev #18 fixed them:
ApolloShowPicture: the 320-pixel modes fell through into the 480 case, and the 8-bit palette was converted twice.ApolloTimer: its VBlank server was never removed. New:ApolloTimerStop.ApolloRelease,ApolloPermit,ApolloEnable.ApolloCPUDelay: assumed 92 MHz, and its overflow check couldn't work.ApolloPlayFileapplied its offset twice.toolchain/pitfalls/apollolib-known-bugs.mdlists what was fixed in 639e195 and the limits that remain:- 32sample pairs inApolloPlay/ApolloPlayFile.None of the fixes is tested on V4 hardware yet.
Other changes
toolchain/index.md: lists ApolloLib.toolchain/project-makefile.md: links to the new folder.core/best-practices/prefer-library-calls-for-saga-chips.md: links to the new folder and its known bugs..github/CODEOWNERS: regenerated.Knowledge base files relied on
core/saga-registers/(SAGA register intake: SAGA-specific registers #18)core/cpu-68080/performance-counters.mdcore/cpu-68080/core-at-a-glance.md(clock)core/cpu-68080/measured-instruction-costs.md(move16)os/os-takeover.md🤖 Generated with Claude Code