Document exact-release Linux hardware validation

[friidump.git] / README.md

diff --git a/README.md b/README.md
index 27c81d7e7d917182aac996ebbad43778f06f3ec2..9816d34aee42ed652275deb9e7609be2daeff641 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,19 +1,19 @@
 # FriiDump — Project Frankenstein Branch
 
 # FriiDump — Project Frankenstein Branch
 

-## Candidate21 Linux Xbox DMI boundary correction
+## FriiDump 0.5.3.16-pf1 Linux Xbox DMI boundary correction

 
 Candidate20 proved the complete Linux GDR-8050L Xbox command and data path:
 direct SG_IO challenge delivery, both game-view transitions, XDVDFS metadata,
 drive-captured game lead-in, partial GAME-XDVDFS output, controlled
 cancellation, hashes, native reporting, and STOP UNIT.
 
 
 Candidate20 proved the complete Linux GDR-8050L Xbox command and data path:
 direct SG_IO challenge delivery, both game-view transitions, XDVDFS metadata,
 drive-captured game lead-in, partial GAME-XDVDFS output, controlled
 cancellation, hashes, native reporting, and STOP UNIT.
 

-Candidate21 preserves that exact Windows-sequence control flow and SG_IO
-handshake. It corrects one remaining MMC boundary: standard READ DVD STRUCTURE
-uses CDB byte 7 for the Format field. Candidate20 incorrectly wrote the format
-to byte 11 (Control), so DMI format `0x04` was not captured and the media ID
-remained empty.
+FriiDump 0.5.3.16-pf1 preserves that exact Windows-sequence control flow and
+SG_IO handshake. It corrects one remaining MMC boundary: standard READ DVD
+STRUCTURE uses CDB byte 7 for the Format field. Candidate20 incorrectly wrote
+the format to byte 11 (Control), so DMI format `0x04` was not captured and the
+media ID remained empty.

 
 

-Candidate21 also adds persistent PFI/DMI capture diagnostics and a source
+The release also adds persistent PFI/DMI capture diagnostics and a source

 contract that compares the portable request against the proven copied Windows
 `GetMediaID()` request.
 
 contract that compares the portable request against the proven copied Windows
 `GetMediaID()` request.
 


@@ -26,8 +26,30 @@ the executable clears that capability.
 
 See [`docs/LINUX.md`](docs/LINUX.md) before Linux hardware use.
 
 
 See [`docs/LINUX.md`](docs/LINUX.md) before Linux hardware use.
 

-## Candidate11 Linux Xbox parity baseline
+## Exact-release Linux hardware validation
+
+The exact FriiDump 0.5.3.16-pf1 Linux executable was validated on two
+GameCube paths after release publication:
+
+- an `HL-DT-ST CDRW/DVD GCC4244 B101` completed profile selection, all 20 seed
+  blocks, a controlled partial read, cancellation, native reporting, profile
+  reporting, and STOP UNIT;
+- a physical GDR-8163B cross-flashed with modified GDR-8050L `0012` firmware
+  completed the modified `0xE7` path, all 20 seed blocks, a controlled partial
+  read, cancellation, native reporting, profile reporting, and FriiDump's
+  internal STOP UNIT.
+
+The validated cross-flashed unit had to start with a readable Video DVD before
+it identified as `HL-DT-ST DVD-ROM GDR8050L 0012`. The drive stayed powered and
+connected while the disc was changed to Sonic Mega Collection (US). Linux host
+media probing was temporarily quarantined for that run because earlier
+background reads had blocked the USB/SCSI path.
+
+See
+[`docs/reports/FRIIDUMP_LINUX_EXACT_RELEASE_HARDWARE_VALIDATION_0.5.3.16-pf1.md`](docs/reports/FRIIDUMP_LINUX_EXACT_RELEASE_HARDWARE_VALIDATION_0.5.3.16-pf1.md)
+for the exact evidence identities and validation limits.

 
 

+## Candidate11 Linux Xbox parity baseline

 Candidate11 begins the Linux parity campaign without replacing the validated
 Windows/MSVC GDR-8050L path. The Windows copied-reference implementation remains
 unchanged for challenge drives. Linux now uses the existing portable MMC/Xbox
 Candidate11 begins the Linux parity campaign without replacing the validated
 Windows/MSVC GDR-8050L path. The Windows copied-reference implementation remains
 unchanged for challenge drives. Linux now uses the existing portable MMC/Xbox


@@ -43,8 +65,8 @@ ordinary Linux ISO/XISO user paths.
 
 FriiDump is a command-line optical-disc dumping tool for Nintendo GameCube,
 Nintendo Wii, standard DVD-ROM, and selected Original Xbox/XGD workflows. This
 
 FriiDump is a command-line optical-disc dumping tool for Nintendo GameCube,
 Nintendo Wii, standard DVD-ROM, and selected Original Xbox/XGD workflows. This

-repository preserves the Project Frankenstein development branch based on
-FriiDump **0.5.3.5**.
+repository preserves the Project Frankenstein release line through
+FriiDump **0.5.3.16-pf1**.

 
 The branch extends the original FriiDump code with:
 
 
 The branch extends the original FriiDump code with:
 


@@ -61,31 +83,27 @@ Xbox-specific behavior is documented in [`docs/XBOX.md`](docs/XBOX.md).
 
 ## Repository status
 
 
 ## Repository status
 

-This is the active canonical Project Frankenstein FriiDump repository. Authority
-was accepted at annotated tag `v0.5.3.5-pf1`. The imported baseline is
-intentionally conservative: source and
-maintained documentation were preserved, while disc images, live logs, compiled
-binaries, build directories, result archives, and unrelated reverse-engineering
-work were excluded.
+This is the active canonical Project Frankenstein FriiDump repository.
+FriiDump 0.5.3.16-pf1 incorporates the accepted native-reporting campaign,
+Linux raw-I/O authorization boundary, GameCube/Linux parity work, and the
+GDR-8050L Linux Xbox DMI correction.

 
 

-The baseline source came from:
+Release authority is the annotated tag `v0.5.3.16-pf1`. Verify its live tag
+object, peeled commit, and tree before treating a checkout or archive as
+canonical.

 
 

-```text
-D:\vscode-workspace\friidump
-```
-
-No firmware binaries or disc images belong in this Git repository.
+Disc images, live logs, compiled binaries, build directories, result archives,
+and unrelated reverse-engineering work remain outside this repository.

 
 Authority surfaces:
 
 ```text
 repository: /srv/project-frankenstein/repos/friidump.git
 authority marker: /srv/project-frankenstein/catalog/authority/friidump.json
 
 Authority surfaces:
 
 ```text
 repository: /srv/project-frankenstein/repos/friidump.git
 authority marker: /srv/project-frankenstein/catalog/authority/friidump.json

-canonical tag: v0.5.3.5-pf1
+canonical tag: v0.5.3.16-pf1

 ```
 
 ## Build
 ```
 
 ## Build

-

 ### Windows — validated MSVC 32-bit path
 
 The maintained Windows helper invokes the Visual Studio 2019 Build Tools
 ### Windows — validated MSVC 32-bit path
 
 The maintained Windows helper invokes the Visual Studio 2019 Build Tools


@@ -210,7 +228,7 @@ FriiDump is distributed under the GNU General Public License, version 2 or
 later. See [`COPYING`](COPYING). Existing source-file copyright notices and
 authors are preserved.
 
 later. See [`COPYING`](COPYING). Existing source-file copyright notices and
 authors are preserved.
 

-## Candidate21 Xbox Linux scope
+## FriiDump 0.5.3.16-pf1 Xbox Linux scope

 
 Candidate21 preserves Candidate20's successful SG_IO Xbox handshake and
 Windows state-machine order. The only functional correction is the standard
 
 Candidate21 preserves Candidate20's successful SG_IO Xbox handshake and
 Windows state-machine order. The only functional correction is the standard