# Magene L308: reconstructing a smart taillight's BLE control protocol

> Magene L308 interop tools reconstruct the smart taillight's BLE control protocol and light_mode.bin pattern format. A protocol specification records GATT characteristics, command frames and upload sequences; browser, Python and Garmin clients use those findings to control settings and patterns directly.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-06
- Original resource: <https://github.com/mchardysam/magene-l308-taillight>
- Primary source: <https://github.com/mchardysam/magene-l308-taillight/blob/346da4577e6980b48b50f7f02e387280c165a812/spec/L308-ble-protocol.md>
- Catalog page: <https://awesomerea.org/resources/magene-l308-taillight-case/>
- Record JSON: <https://awesomerea.org/resources/magene-l308-taillight-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/magene-l308-taillight-case/index.md)

## Requirements & limits

- **Prerequisites:** A Magene L308 light is required; the Python CLI uses bleak.
- **Prerequisites:** The web client requires Chrome or Edge with Web Bluetooth in an HTTPS or localhost context.
- **Limits:** Pattern uploads replace the whole on-device store, which has no read-back; keep exported .bin backups.
- **License:** Code is MIT licensed; the protocol specification is CC-BY-4.0 licensed.

## Primary sources

1. <https://github.com/mchardysam/magene-l308-taillight/blob/346da4577e6980b48b50f7f02e387280c165a812/spec/L308-ble-protocol.md>
2. <https://github.com/mchardysam/magene-l308-taillight/blob/346da4577e6980b48b50f7f02e387280c165a812/README.md>

## More in Protocols

- [xbloom-ble: a client for the xBloom Studio BLE protocol](https://awesomerea.org/resources/xbloom-ble-case/index.md) · Case study
- [ak820: reconstructing AJAZZ AK820 Pro HID control on macOS](https://awesomerea.org/resources/ajazz-ak820-pro-mac-case/index.md) · Case study
- [GameTrak Liberation: a client for the controller's HID protocol](https://awesomerea.org/resources/gametrak-liberation-case/index.md) · Case study
- [Cooper Hunter AC: UART and infrared protocol investigation](https://awesomerea.org/resources/cooper-hunter-ac-protocol-case/index.md) · Case study
- [aw5d-linux: driving an iBUYPOWER cooler LCD from USB-HID research](https://awesomerea.org/resources/aw5d-linux-case/index.md) · Case study
- [MyJBxHeadsetControl: JBL Quantum 950 controls over USB HID](https://awesomerea.org/resources/myjbxheadsetcontrol-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.