Repository navigation
Add Libratone (FFAA) firmware extractor - #979
Open
mschoenlaub wants to merge 1 commit into
Open
mschoenlaub wants to merge 1 commit into
mschoenlaub wants to merge 1 commit into
Conversation
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
marked this pull request as ready for review
October 28, 2026 15:24
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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:
The payload is a standard ZIP obfuscated by subtracting
(offset mod 16)from each byte (offset counted from the payload start), soPK\x03\x04becomesPJ\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\nat offset 0 only, validates the twoFFAAmarkers 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_02builds (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.