# MN103S Emulator

Project Frankenstein's MN103S optical-drive firmware emulator and GDR-8050L
host/iSCSI bridge research environment.

## Baseline

This repository begins with the accepted **v258** workspace snapshot.

- **v206** remains the known-good live behavior reference: Windows detected a
  single `HL-DT-ST DVD-ROM GDR8050L`, locked video playback worked, and the
  Xbox authentication/unlock flow exposed the game view.
- **v234** restored the stable runtime line after the rejected v235-v249
  automated-runner experiments.
- **v250-v258** add firmware parser/descriptor proof work on that stable line.
- **v258** proves READ(10) parser state handoff through the phase-4 consumer to
  descriptor output (`0x05EC -> 0x06E4`, `0x06E0 = 0xF0`).

The bridge's unlocked media delta `0x00030600` is still profile-selected, not
firmware-derived. Single uninterrupted call-stack proof is also incomplete.

## Repository boundary

The repository tracks emulator source, launchers, profiles, test definitions,
proof documents, and small text configuration. It intentionally excludes:

- firmware binaries and flash images;
- disc images and media payloads;
- generated traces, logs, reports, result archives, and caches;
- compiled programs and Python bytecode.

External firmware and media must be supplied explicitly at runtime.

## Portability status

The v258 baseline is preserved without behavior-changing path rewrites. It is
still coupled to the historical Windows workspace layout in many configs and
launchers. Repository-relative path normalization is a future controlled task,
not part of this baseline import.

## Entry points

- `mn103s_emu.py` — MN103S emulator core.
- `mn103s_emu_test.py` — emulator test harness.
- `gdr_host_iscsi_pdu_bridge.py` — live iSCSI bridge.
- `gdr8050l_auth_v258_stateful_relock_keep_loaded_iscsi_start.cmd` — current
  v258 quick-smoke launcher.
- `MN103S_GDR8050L_emulator_handoff_v258.md` — detailed current handoff.

Python 3.12+ is the current tested environment. One analysis helper imports
`pandas`; the core emulator and bridge use the Python standard library.

## Licensing

No repository-wide license has been established by this import. Do not infer
redistribution rights beyond the rights attached to individual source files.
