Skip to content
aapPublic

About

free and reverse engineered implementation of the Playstation2 SDK

Resources

Stars

11 stars

Watchers

0 watching

Forks

Repository files navigation

freesce docs

This branch holds freesce's meta-information: reconstruction trackers, methodology notes, findings logs, and review writeups. None of it is specific to one SDK vintage, so it lives here once instead of being duplicated (and drifting) across sdk-1.0, sdk-2.0, sdk-2.4 and sdk-3.0.3.

The source itself lives on those four branches — see the top-level README.md there for build instructions. A convenient way to have both open at once is a second worktree:

git worktree add ../freesce-docs docs

Branches

branch libkernl libgraph/dma/pc/pad libcdvd libvu0
sdk-1.0 done not started (currently 3.0.3-shaped, needs backport) doesn't exist at 1.0 not started
sdk-2.0 done not started (ditto) deferred (2.0 ships a structurally different monolithic eecdvd.o) not started
sdk-2.4 Milestone 2 SOURCE-COMPLETE (2026-08-26) against the genuine 2.4.2 archive (DTL-S2324), 11 members fully byte-exact, relocaudit-clean libpc done, libgraph done except graph018 (a real ~400-ins member), libdma/libpad ERX-dropped, body diffs pending 3.0.3-shaped, verified 2.4-IOP-compatible (47/49 members byte-identical); honest pass = cdvd000/021 backport scoped: fresh build needed, no free ride from 2.0
sdk-3.0.3 Milestone 2+3 still owed done done not started

Current priority (2026-08-24): sdk-2.4. The goal is one branch that's a fairly complete, working SDK vintage against freesce's own compiler — meet in the middle by evolving libkernl forward from 2.0 and the other libraries backward from 3.0.3, both already-done starting points one hop away from 2.4. sdk-2.4 branches directly off sdk-3.0.3's tip rather than off sdk-2.0, since finishing sdk-2.0 first isn't on the critical path to it. sdk-1.0 and a standalone finished sdk-2.0 are real goals but lower priority — later work, not blocking. Dedicated worktree: ~/src/freesce_24.

Status 2026-08-26: libkernl's Milestone 2 is source-complete against the genuine 2.4.2 archive, and the librw demoreel's CD build boots end-to-end in pcsx2 against the 2.4.2 IOP pieces (IOPRP242 reboot, sio2man/padman 2.03).

See SDK24-PLAN.md for the full convergence plan (per-library status, work order, methodology gotcha found while scoping it) and LIBKERNL-PLAN.md's new "STATUS TABLE — SDK 2.4 / Milestone 2" section for libkernl's exact 22-member breakdown.

What's here

  • LIBKERNL-PLAN.md — the libkernl reconstruction tracker: per-member status, work order, detailed RESULTS writeups.
  • SDK24-PLAN.md — the sdk-2.4 convergence plan covering the other five libraries (libgraph/dma/pc/pad/cdvd/vu0): per-library status, work order.
  • issues.txt / SKY-ISSUES.md — findings logs (freesce-as-SDK bugs, and SKY-simulator-vs-hardware deviations), same S#/# numbering scheme.
  • REVERSING.md — the accumulated RE method: idioms, traps, the rules that came out of real mistakes.
  • MISSING.md — header completeness tracking vs the SDK originals.
  • REVIEW-NOTES.md, claude_review.txt, notes/ — session review and verification writeups.
  • old_ps2toolchain_bugs — scratch notes, upstream links.
  • .hermes/plans/ — planning docs for the project as a whole.

About

free and reverse engineered implementation of the Playstation2 SDK

Resources

Stars

11 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors