Skip to content

Add Libratone (FFAA) firmware extractor - #979

Open
mschoenlaub wants to merge 1 commit into
ReFirmLabs:masterfrom
mschoenlaub:libratone-firmware
Open

mschoenlaub wants to merge 1 commit into
ReFirmLabs:masterfrom
mschoenlaub:libratone-firmware

Conversation

@mschoenlaub

@mschoenlaub mschoenlaub commented Oct 28, 2026 •

Copy link
Copy Markdown

Summary

Adds a signature and internal extractor for Libratone Zipp / Zipp Mini (Zipp_02) OTA firmware, which ships in a vendor "FFAA" container rather than as a plain archive.

Container format

A short ASCII header followed by an obfuscated ZIP:

FFAA\n
<Bluetooth version>\n
<DSP version>\n
<MCU version>\n
<system version>\n
<build number>\n
FFAA\n
<obfuscated ZIP payload>

The payload is a standard ZIP obfuscated by subtracting (offset mod 16) from each byte (offset counted from the payload start), so PK\x03\x04 becomes PJ\x01\x01. There is no key; the transform is period-16 and reversible by adding (i mod 16) back. The header length varies with the version-string lengths, so the parser locates the payload marker instead of assuming a fixed offset.

The signature matches FFAA\n at offset 0 only, validates the two FFAA markers and the ASCII header, and reports the build and component versions. The extractor de-obfuscates the payload and carves the inner ZIP, which binwalk then extracts recursively into the kernel, device tree, UBI root filesystems and MCU/BT/DSP images.

Testing

Verified against all ten published Zipp_02 builds (287 through 879, 2017-2025). In every case the signature is detected at offset 0 and the carved archive is byte-identical to an independent reference decode, with all ZIP entry CRCs valid.

Libratone Zipp / Zipp Mini (Zipp_02) OTA firmware uses an "FFAA" container: a
short ASCII header carrying the Bluetooth, DSP, MCU and system versions plus the
build number, followed by a ZIP archive obfuscated with a position-based additive
transform of period 16 (no key). Add a signature that validates the header and an
extractor that de-obfuscates the payload and carves the ZIP, so recursive
extraction unpacks the kernel, device tree, UBI root filesystems and MCU/BT/DSP
images.

Tested against all ten published Zipp_02 builds (287 through 879, 2017-2025); the
carved archive is byte-identical to the reference decode in every case.
@mschoenlaub
mschoenlaub marked this pull request as ready for review October 28, 2026 15:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant