# open-cardi：还原 Cardi 灯光的 BLE 控制协议

> open-cardi 在 Android 和网页客户端中重建 Cardi K3、K4 Active Ultra 灯具的 BLE 控制。作者通过反编译厂商应用并重放 HCI 抓包，整理 GATT 服务、报文结构及颜色、分区、模式和重置命令。

- 类型：案例
- 目标：应用 · 协议
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-11-06
- 收录于：2026-11-08
- 原始资源：<https://github.com/harshmandan/open-cardi>
- 一手来源：<https://github.com/harshmandan/open-cardi/blob/d8eaf5b116abe306fa5041bfe45989752b5e57f5/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/open-cardi-case/>
- 记录 JSON：<https://awesomerea.org/resources/open-cardi-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/open-cardi-case/index.md)

## 使用条件与局限

- **范围：**文档涵盖 Cardi K3、K4 Active Ultra 及列出的其他 ConSmart 系列灯具。
- **局限：**网页客户端可能使复位中的灯具持续闪烁，需断电重启并用厂商应用设置颜色；Android 客户端使用默认 23 字节 MTU。
- **局限：**锁定及解锁对附近控制器的影响仍属推断。
- **许可：**采用 MIT 许可证。

## 一手来源

1. <https://github.com/harshmandan/open-cardi/blob/d8eaf5b116abe306fa5041bfe45989752b5e57f5/README.md>
2. <https://github.com/harshmandan/open-cardi/blob/d8eaf5b116abe306fa5041bfe45989752b5e57f5/debug/README.md>

## 同分区更多条目：应用

- [Pool Comfort / Galaxywind：基于 Android 与 UDP 分析的泳池热泵本地客户端](https://awesomerea.org/zh/resources/poolcomfort-galaxywind-case/index.md) · 案例
- [Mondeer Bluetooth scale：重建 BLE 称重与绑定流程](https://awesomerea.org/zh/resources/mondeer-bluetooth-scale-ha-case/index.md) · 案例
- [Smartboard notebook Exporter：解析并转换 .notebook 文件](https://awesomerea.org/zh/resources/smartboard-notebook-exporter-case/index.md) · 案例
- [WeChat：恢复 macOS 聊天数据库并导出 HTML](https://awesomerea.org/zh/resources/wechat-export-case/index.md) · 案例
- [led-hue-cycle：重建 LEDDMX 灯带的 BLE 控制](https://awesomerea.org/zh/resources/led-hue-cycle-case/index.md) · 案例
- [OPPO 移动电源助手：在 macOS 上重建移动电源控制功能](https://awesomerea.org/zh/resources/oppo-powerbank-mac-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。