Pcileech-enigma-x1-top.bin Jun 2026

Feature draft — pcileech-enigma-x1-top.bin Summary Add support for the Enigma X1 "top" firmware image (pcileech-enigma-x1-top.bin) so the loader can detect, validate, and flash this variant safely while preserving user data and offering rollback. Goals

Detect Enigma X1 top image reliably. Validate image integrity before flashing. Provide safe flashing with progress, verification, and rollback. Integrate with existing UI/CLI and logging. Keep compatibility with current pcileech workflows and device IDs.

Detection & Identification

Identify file by filename pattern: pcileech-enigma-x1-top.bin Also detect via embedded header magic bytes and version field: pcileech-enigma-x1-top.bin

Expect magic: 0x45 0x4E 0x47 0x58 ("ENGX") Read firmware metadata at offset 0x40: fields [version(uint32), type(uint8)=0x02 for "top", length(uint32), checksum(uint32)]

Verify device compatibility via board ID table; map Enigma X1 top to existing product ID(s).

Pre-flash Checks

Validate file existence and read access. Verify magic and metadata fields. Verify checksum (CRC32 or SHA256 — prefer SHA256 if image includes it). Verify target device is connected and in bootloader mode; check VID/PID and serial. Backup user partitions/configuration if present (attempt safe read of NVRAM/config partitions and save locally). Warn user about risk and require confirmation (CLI flag --yes to skip).

Flash Procedure

Put device into firmware update mode (existing mechanism). Upload image in chunks (64 KiB default) with retry on failure (3 retries). Show progress percentage and ETA. After upload, send commit command and wait for device reboot. Poll device boot status; verify bootloader or expected firmware signature. Feature draft — pcileech-enigma-x1-top

Post-flash Verification

Re-read firmware header from device and compare version/checksum. Validate critical partitions accessible. Restore user config from backup if flashing replaced them (prompt/automate based on --restore flag). Provide explicit success/failure message and logs.