Expand description
Pioneer optical drive (BD/DVD) firmware and vendor protocol, as pure byte transforms plus command sequences over a caller-supplied transport.
The public API is five modules:
envelope— the codec: load, header, repack, sign/verify and encode a firmware envelope or a Kernel+Normal update (envelopefeature).classify— pair verdicts and their vocabulary (families, required words, why two firmwares differ); never materializes an image.prepare— materialize a corrected update against the installed receiver into an opaque plan that yields the exact byte streams to write.cdb— the vendor command descriptor blocks, as byte constructors, the DVR handshake solver and refusal-sense classification.no_std.drive— identify, read, capture, dump and update sequences over a caller-supplieddrive::Transport(drivefeature).
The crate root carries only shared vocabulary: Identity, Role,
ComponentKind, DriveClass, CodedError and the lifecycle
observations IssueKind, Phase, Component and Progress.
§Drive state
Two independent drive states gate the vendor commands:
- extended read — enabled by
cdb::knock. Allowscdb::read_memoryabove the0x8000boot window; the drive refuses reads pastcdb::READ_CEILING. Read-only. - update session — entered by
cdb::enter_update. Accepts Kernel and Normal chunk writes (cdb::transfer) and thecdb::finishcommit. DVR generations require thecdb::dvrhandshake before entry.
Neither state enables the other.
Modules§
- cdb
- Command descriptor blocks.
- classify
- Pair verdicts and their vocabulary. Nothing here materializes an image:
these are the facts a flasher, a
--whyexplanation or a catalogue graph use to say whether, and why, firmwareBmay replace firmwareA. - drive
- Command sequences over a caller-supplied
Transport: identify, protected memory read, and the update session. - envelope
- Pioneer firmware envelope decoder, byte-exact repacker, builder and signer.
- prepare
- Materialize a corrected update against the installed receiver.
Structs§
- Identity
- A drive’s identity: the standard INQUIRY response plus the vendor identity
block (
cdb::vendor_identity). - Product
Identity - A borrowed, display-oriented view of an optical product identity. Raw vendor/product/revision values are preserved; parsing never changes flash compatibility.
- Progress
- Observed work in one phase; absent counts mean indeterminate activity.
Enums§
- Component
- A region label; hosts may translate these without knowing the protocol.
- Component
Kind - The kind of firmware component a Pioneer envelope carries.
- Drive
Class - The vendor command dialect a drive speaks.
- Issue
Kind - A host-facing error category; detailed causes remain in the typed library error.
- Phase
- A protocol-neutral operation phase.
- Role
- A firmware component written during an update session.
Constants§
- IDENTITY_
LEN - Length of the vendor identity block, in bytes.
- INQUIRY_
LEN - Length of a standard INQUIRY response header, in bytes.
Traits§
- Coded
Error - Machine-readable error identity for diagnostics and translation catalogs.