Reverse-Engineering-Notizen und Python-Tooling für die Firmware der JBL Wave Buds 2 (BES1306): OTA-Containerformat, Flash-Layout, BLE/GATT-Protokoll und CRC-32-Vertrauensmodell.
Reverse-Engineering-Notizen und reproduzierbare Tooling für die JBL Wave Buds 2
(Bestechnic BES1306, PID 2100): das On-Flash-Layout, das OTA-Container-
Format bis aufs Byte, das BLE/GATT-Kommando-Protokoll und der verschlüsselte
BES-„TOTA v2"-Transport, die Vertrauensgrenzen auf Geräte- und App-Seite, die
Factory-Konsole sowie eine reproduzierbare Methode, um ein selbstgebautes Image
auf ein Gerät zu laden, das Sie besitzen.
Die Analyse umfasst zwei Builds — das IDA-analysierte wavebuds.elf (Apr. 2025)
und das Distributionspaket 2.9.0 (Sep. 2026) —, einen vollständig
spezifizierten 8-Stream-OTA-Container (verifiziert durch byte-identisches
Repack), das CRC-32-Integritätsmodell, bestätigt auf App- und Geräteseite, eine
Factory-Kommandotabelle mit 54/59 Einträgen, 12 OTA-RAM-Zustandsvariablen, eine
Enumeration von 7.960 Funktionen und ein Cross-Build-Differential. Die semantische
Wiederherstellung ist für die OTA-/Flash-/CRC-/Factory-Subsysteme tiefgehend und
ansonsten auf Enumeration beschränkt — siehe das
Vollständigkeitsaudit.
[!WARNING] Dies ist vom Eigentümer durchgeführte Hardware-Forschung, kein offizielles JBL-Update. Das Flashen eines modifizierten Images ist irreversibel: Die Download-Phase ist gestaffelt und brick-sicher, aber die Aktivierung eines CRC-gültigen, jedoch defekten Images hat keinen offengelegten Wiederherstellungspfad. Lesen Sie SAFETY.md, bevor Sie etwas reproduzieren.
Türkische Version: README.tr.md

Hardware-Ergebnis am getesteten Gerät: Nachdem die OTA-Pipeline aus App + User-CA-MITM validiert wurde, verbinden sich beide Ohrhörer, melden 100 % und jede App-Steuerung (ANC/Ambient, Gesten, EQ) funktioniert. Als das um ein Byte modifizierte Paket bereitgestellt wurde, meldete der Eigentümer Update-Erfolg, Neustart und Normalbetrieb. Das geänderte Byte wurde nicht vom Gerät zurückgelesen; dies ist eine Zustandsbeobachtung, kein Beweis dafür, welches Image ausgeführt wurde.
Die Adressen stammen aus dem analysierten Build (wavebuds.elf); siehe das
Adressverzeichnis und die
Herkunft.
0x2C0918BC prüft die Konfiguration, jedes Segment und das gesamte
Image mit der CRC-32-Routine 0x2C0CE944 (Tabelle 0x2C0F5218) sowie einer
"BEST"-Magic. Das um ein Byte modifizierte Paket führte zu einem gemeldeten
erfolgreichen Update; die Ausführung des modifizierten Bytes und ROM-Prüfungen
bleiben unverifiziert.com.jbl.counterfeit.Rsa2048DynamicVerifier)
dient der Anti-Fälschung (Geräteauthentizität), nicht der
Firmware-Signierung.0x28120000
geschrieben, während die laufende Anwendung intakt bleibt. Dies reduziert das
Risiko in der Download-Phase, garantiert jedoch keine Wiederherstellung nach
einem fehlerhaften Update.0x2C0905E4:
MEMORY[0x20026BA0] ∈ {2,4}).UNRESOLVED.Die Änderung ist bewusst minimal — ein Byte des dekomprimierten Images.
Die Markierung RTX V5.5.1 beginnt bei dekomprimiertem Offset 64096; ihre letzte Ziffer
wurde bei Offset 64105 (0xFA69) geändert, um V5.5.2 zu erzeugen, und die Container-
CRC-32 wurde neu berechnet. Sie ist von Natur aus kosmetisch: Der
Zweck besteht darin, die Auslieferung eines modifizierten, aber CRC-gültigen Images zu testen, ohne das
Verhalten zu ändern. Der Eigentümer meldete Erfolg und normalen Betrieb, aber die modifizierte
Markierung wurde nicht zurückgelesen; siehe die Validierungsgrenze.
Base (owner-supplied; not redistributed)
official 2.9.0 package 549,558 bytes SHA-256 836cb251f9fb2261dde14f39ba18d358c48018817f3c3d1b527e1ac5f3ab7ba2
decompressed image 955,596 bytes SHA-256 489663e80b76f20f4c94671064908569fac5f4e3df10ab6d7369baffe094f67d
container CRC-32 A0C7CCEC (valid), input range [0x0, 0x862AD)
Das Repository enthält absichtlich keine JBL-Firmware. Stellen Sie Ihr eigenes rechtmäßig erworbenes Paket bereit und reproduzieren Sie:
python3 tools/ota_unpack.py <official_2.9.0_package.bin> --extract image.bin
python3 tools/ota_repack.py make-test <official_2.9.0_package.bin> test.bin
python3 tools/ota_unpack.py test.bin # exactly one decompressed byte differs; CRC valid
Die exakten Bytes des neu gepackten Containers hängen vom LZMA-Encoder ab; das Gerät prüft CRC-32, nicht einen Paket-Hash (siehe docs/04), und der einbyteige dekomprimierte Unterschied ist deterministisch. Die Auslieferung über die App wird in docs/08 beschrieben.
| Flash-Karte | 2-MB-NOR-Partitionierung |
| OTA-Befehlablauf | die Sequenz und ihre CRC-32-Prüfpunkte |
| Vertrauensgrenzen | was jede Stufe verifiziert und worauf das Vertrauen in die Images beruht |