# Eufy Local Light: reconstructing BLE control for E10 and E22 lights

> Eufy Local Light implements a Home Assistant client for Eufy Outdoor String Lights E10 and Permanent Outdoor Lights E22 using BLE traffic analyzed from the Eufy app. Its protocol notes describe GATT endpoints, packet framing, AES-128-CBC session setup, and light-control commands.

- 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/SudoSaturn/eufy-local-ha>
- Primary source: <https://github.com/SudoSaturn/eufy-local-ha/blob/4f2164281977000754611dd35e144d45858a8b96/PROTOCOL.md>
- Catalog page: <https://awesomerea.org/resources/eufy-local-ha-case/>
- Record JSON: <https://awesomerea.org/resources/eufy-local-ha-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/eufy-local-ha-case/index.md)

## Requirements & limits

- **Prerequisites:** Home Assistant and a supported Eufy light are required; development and testing covered E10 T8L10 and E22 T8L02.
- **Limits:** The integration does not yet expose per-segment DIY patterns on the E22; E10 state readback is untested.
- **License:** GPL-3.0 license.

## Primary sources

1. <https://github.com/SudoSaturn/eufy-local-ha/blob/4f2164281977000754611dd35e144d45858a8b96/PROTOCOL.md>
2. <https://github.com/SudoSaturn/eufy-local-ha/blob/4f2164281977000754611dd35e144d45858a8b96/README.md>
3. <https://github.com/SudoSaturn/eufy-local-ha/blob/4f2164281977000754611dd35e144d45858a8b96/E22SUPPORT.md>

## More in Protocols

- [OpenPeats: reconstructing SoundPEATS earbud controls](https://awesomerea.org/resources/openpeats-case/index.md) · Case study
- [hongtai-panel: reconstructing a cooler LCD's USB serial protocol](https://awesomerea.org/resources/hongtai-panel-case/index.md) · Case study
- [ESPHome ↔ L&S Emotion Control: reconstructing a smart-light radio client](https://awesomerea.org/resources/emotion-control-ha-case/index.md) · Case study
- [akp02: reconstructing the Ajazz AKP02 display protocol](https://awesomerea.org/resources/akp02-display-protocol-case/index.md) · Case study
- [RK M75: reconstructing wired and wireless RGB control](https://awesomerea.org/resources/rk-m75-case/index.md) · Case study
- [ACiQ K18W: reconstructing a mini split's UART protocol](https://awesomerea.org/resources/aciq-minisplit-protocol-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.