# xLamp: LampSmartPro lamp-control protocol and Android client

> xLamp reconstructs LampSmartPro 1.4.0's pairing and lamp-control flow in a Flutter Android app. It documents a 31-byte command frame with AES-128, XOR, and CRC-16/CCITT processing, then broadcasts encoded commands through 13 Bluetooth service UUIDs to control pairing, power, brightness, color temperature, and scenes.

- Type: Case study
- Targets: App · 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/qinjunhaocn/xLamp>
- Primary source: <https://github.com/qinjunhaocn/xLamp/blob/9229e9fbf28f393f8271e9d001209c094ca61f41/README.md>
- Catalog page: <https://awesomerea.org/resources/xlamp-case/>
- Record JSON: <https://awesomerea.org/resources/xlamp-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/xlamp-case/index.md)

## Requirements & limits

- **Prerequisites:** Android 7.0 or later on a device that supports BLE advertising; grant Nearby devices permission.
- **Prerequisites:** Flutter 3.47 and Dart 3.13 for local builds.
- **Scope:** Scope is pairing and control through BLE advertising.
- **License:** PolyForm Noncommercial License 1.0.0.

## Primary sources

1. <https://github.com/qinjunhaocn/xLamp/blob/9229e9fbf28f393f8271e9d001209c094ca61f41/README.md>
2. <https://github.com/qinjunhaocn/xLamp/blob/9229e9fbf28f393f8271e9d001209c094ca61f41/LICENSE>

## More in Apps

- [Slovak Telekom App API: mapping the mobile service requests](https://awesomerea.org/resources/slovak-telekom-app-api-case/index.md) · Case study
- [dyson-lamp-ble: reconstructing local control of a Dyson lamp](https://awesomerea.org/resources/dyson-lamp-ble-case/index.md) · Case study
- [MiFit-Hack-API: reconstructing Mi Fit account and fitness requests](https://awesomerea.org/resources/mifit-hack-api-case/index.md) · Case study
- [Foreca S60: reconstructing a legacy weather service](https://awesomerea.org/resources/symbian-foreca-weather-server-case/index.md) · Case study
- [XY Remote: reconstructing XinYi amplifier BLE control](https://awesomerea.org/resources/xy-remote-sinilink-ble-case/index.md) · Case study
- [RideLink: reconstructing TVS SmartXonnect scooter communication](https://awesomerea.org/resources/ridelink-tvs-smartxonnect-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.