# 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.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/FNKG9527/fiil-pods-pc>
- Primary source: <https://github.com/FNKG9527/fiil-pods-pc/blob/e7a11989e3ba007211ad548c8f04ad6fa4374bc2/docs/PROTOCOL_PC.md>
- Catalog page: <https://awesomerea.org/resources/fiil-headphone-control-case/>
- Record JSON: <https://awesomerea.org/resources/fiil-headphone-control-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/fiil-headphone-control-case/index.md)

## 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.

## Primary sources

1. <https://github.com/FNKG9527/fiil-pods-pc/blob/e7a11989e3ba007211ad548c8f04ad6fa4374bc2/docs/PROTOCOL_PC.md>
2. <https://github.com/FNKG9527/fiil-pods-pc/blob/e7a11989e3ba007211ad548c8f04ad6fa4374bc2/README.md>
3. <https://github.com/FNKG9527/fiil-pods-pc/blob/e7a11989e3ba007211ad548c8f04ad6fa4374bc2/docs/evidence/README.md>

## More in Protocols

- [Wireless AA Bridge: reconstructing a wireless Android Auto relay](https://awesomerea.org/resources/wireless-aa-bridge-case/index.md) · Case study
- [atmos-lcd: a replacement client for the MasterLiquid Atmos II LCD](https://awesomerea.org/resources/atmos-lcd-case/index.md) · Case study
- [B&K 2318: reconstructing a thermal printer's serial interface](https://awesomerea.org/resources/bk2318-esp32-case/index.md) · Case study
- [TCOMAS LG600: reconstructing a cooler LCD's USB HID display protocol](https://awesomerea.org/resources/tcomas-lg600-lcd-case/index.md) · Case study
- [Wanderer: rebuilding sensor control over a reverse-engineered serial link](https://awesomerea.org/resources/wanderer-device-case/index.md) · Case study
- [Clockwise Calipers Data Interface: reconstructing the DTCR-02 cable](https://awesomerea.org/resources/clockwise-calipers-data-interface-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.