Skip to main content

Crate pioneer_optical

Crate pioneer_optical 

Source
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 (envelope feature).
  • 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-supplied drive::Transport (drive feature).

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:

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 --why explanation or a catalogue graph use to say whether, and why, firmware B may replace firmware A.
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).
ProductIdentity
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.
ComponentKind
The kind of firmware component a Pioneer envelope carries.
DriveClass
The vendor command dialect a drive speaks.
IssueKind
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§

CodedError
Machine-readable error identity for diagnostics and translation catalogs.