Skip to content

Docs: research tooling lessons for ColdFire OS images - #685

Merged
repeat98 merged 1 commit into
repeat98:mainfrom
nrdsrfr:docs-coldfire-research-tooling
Oct 19, 2026
Merged

repeat98 merged 1 commit into
repeat98:mainfrom
nrdsrfr:docs-coldfire-research-tooling

Conversation

@nrdsrfr

@nrdsrfr nrdsrfr commented Oct 16, 2026

Copy link
Copy Markdown
Contributor

What was hard: researching the Syntakt OS (#684) hit several tool traps that any ColdFire machine research will hit again, and no guide mentioned them.

What this changes: a short "Research a ColdFire OS image" section in docs/ADD_A_MACHINE.md: REA cannot admit m68k targets (use Ghidra headless directly), Ghidra's Coldfire spec does not decode movec (read the reset windows with an MC68020 import), how to pin a headless image's load base, why "no static reference" is not "free", the BSS-clear trap for appended code, and that the repository's packer can narrow the in-place depack margin. Stock-free.

How checked: npm run check -- --base origin/main (documentation path) passed.

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Oct 16, 2026
@repeat98
repeat98 merged commit c0f513b into repeat98:main Oct 19, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants