Case study
FIIL 耳机控制: a Windows client for FIIL headphone BLE commands
FIIL 耳机控制 implements a Windows client from reverse-engineered BLE GATT commands used by FIIL headphones. Protocol notes describe the fdb3 service, ff17 write and ff18 notification characteristics, message framing, unlock sequence and command responses. The desktop app controls supported modes and records raw traffic alongside parsed results.
- Targets
- Protocol
- Category
- Independent reconstruction cases
- Relationship
- Independent reconstruction project
- Sources reviewed
- Evidence class
- C2 code & docs, no demo or download
- Stars
- 1
- Last commit
- 2026-11-03
- Language
- Python
- License (GitHub)
- GPL-3.0
GitHub data as of 2026-11-10
Evidence
- Observed
- Code, documentation and a download method observed; no demo found.
- Checked
- 2026-11-08
Requirements & limits
- Prerequisites: Live use requires Windows 10/11 and a supported FIIL headset; running from source requires Python 3.10 or newer.
- Testing evidence: The author reports physical tests with FIIL Key Max firmware 3.0.1.1 and FIIL Atom.
- Limits: EQ writing is not confirmed to take effect; Linux and macOS are untested.
- License: GPL-3.0 license.
Cite
BibTeX
@misc{fiil-headphone-control-case,
title = {{FIIL 耳机控制: a Windows client for FIIL headphone BLE commands}},
howpublished = {\url{https://github.com/FNKG9527/fiil-pods-pc}},
url = {https://github.com/FNKG9527/fiil-pods-pc},
urldate = {2026-11-06},
note = {Awesome REA entry: \url{https://awesomerea.org/resources/fiil-headphone-control-case/}}
}Plain text
FIIL 耳机控制: a Windows client for FIIL headphone BLE commands. https://github.com/FNKG9527/fiil-pods-pc (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/fiil-headphone-control-case/
Useful? Star Awesome REA on GitHub2.4k
About this entry
The description was reviewed against primary sources.
Primary sources
- docs/PROTOCOL_PC.md GitHub · FNKG9527/fiil-pods-pc · Revision e7a1198
- README.md GitHub · FNKG9527/fiil-pods-pc · Revision e7a1198
- docs/evidence/README.md GitHub · FNKG9527/fiil-pods-pc · Revision e7a1198
More in Protocols
- Wireless AA Bridge: reconstructing a wireless Android Auto relay · Case study
- atmos-lcd: a replacement client for the MasterLiquid Atmos II LCD · Case study
- B&K 2318: reconstructing a thermal printer's serial interface · Case study
- TCOMAS LG600: reconstructing a cooler LCD's USB HID display protocol · Case study
- Wanderer: rebuilding sensor control over a reverse-engineered serial link · Case study
- Clockwise Calipers Data Interface: reconstructing the DTCR-02 cable · Case study