MattJackson
dbc5789406
Parses device keys, processing keys, host cert, per-disc VUKs. Full KEYDB.cfg (60MB, 180K entries) parsed in 1.85 seconds. All test discs found with VUKs. Next: disc hash computation, title key decryption, content decryption.
libfreemkv
Rust library for 4K UHD / Blu-ray / DVD optical drives. Drive access, disc format parsing, and raw sector reading in one crate. 206 bundled drive profiles.
Part of the freemkv project.
Install
[dependencies]
libfreemkv = "0.2"
Quick Start
use libfreemkv::DriveSession;
use std::path::Path;
let mut session = DriveSession::open(Path::new("/dev/sr0"))?;
session.unlock()?; // activate raw read mode
session.calibrate()?; // optimize read speed
let mut buf = vec![0u8; 2048];
let n = session.read_sectors(0, 1, &mut buf)?;
How It Works
- INQUIRY (SPC-4 §6.4) — reads vendor_id, product_id, product_revision, vendor_specific
- GET CONFIGURATION 010C (MMC-6 §5.3.10) — reads firmware_date
- Profile match — five fields uniquely identify the drive against 206 bundled profiles
- READ BUFFER — single command with per-drive mode/buffer_id activates raw read mode
- Signature verify — drive responds with 4-byte signature + "MMkv" confirmation
No fingerprints. No encrypted lookups. All identification uses standard SCSI fields.
API
let mut session = DriveSession::open(device_path)?;
// Drive identity
session.drive_id.vendor_id // "HL-DT-ST"
session.drive_id.product_id // "BD-RE BU40N"
session.drive_id.product_revision // "1.03"
session.drive_id.vendor_specific // "NM00000"
session.drive_id.firmware_date // "211810241934"
// Profile data
session.profile.chipset // Chipset::MediaTek
session.profile.unlock_mode // 0x01
session.profile.unlock_buf_id // 0x44
session.profile.signature // [0x99, 0x9e, 0xc3, 0x75]
// Operations
session.unlock()?;
session.calibrate()?;
session.read_sectors(lba, count, &mut buf)?;
session.status()?;
session.read_config()?;
session.read_register(index)?;
Chipset Support
| Chipset | Status | Drives | Brands |
|---|---|---|---|
| MediaTek MT1959 | Supported | 206 | LG, ASUS, HP |
| Renesas | Planned | -- | Pioneer |
Drive Profile
Each bundled profile (compiled into the binary):
{
"vendor_id": "HL-DT-ST",
"product_id": "BD-RE BU40N ",
"product_revision": "1.03",
"vendor_specific": "NM00000",
"firmware_date": "211810241934",
"chipset": "mediatek",
"unlock_mode": 1,
"unlock_buf_id": 68,
"signature": "999ec375",
"register_offsets": ["10e291", "11ab1c"]
}
Error Codes
| Code | Error | Meaning |
|---|---|---|
| E1000 | DeviceNotFound | Device path doesn't exist |
| E1001 | DevicePermission | No access (try sudo or cdrom group) |
| E2000 | UnsupportedDrive | No matching profile |
| E3000 | UnlockFailed | Unlock command rejected |
| E3001 | SignatureMismatch | Response signature wrong |
| E3002 | NotUnlocked | Operation requires unlock first |
| E4000 | ScsiError | SCSI command failed |
| E5000 | IoError | System I/O error |
Platform
| Platform | Status | Backend |
|---|---|---|
| Linux | Supported | SG_IO ioctl |
| macOS | Planned | IOKit |
| Windows | Planned | SPTI |
The ScsiTransport trait abstracts the platform. Adding a backend is one file behind a cfg gate.
Contributing
Run freemkv info --share with the freemkv CLI to submit your drive's profile.
License
AGPL-3.0-only