{
  "added_at": "2026-11-08",
  "additional_evidence_urls": [
    "https://github.com/xydac/sp542e-ha-bridge/blob/6723ee3488a8216c2ca5699b96f6d84543164673/LICENSE"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "An MQTT-to-BLE bridge that controls the SP542E LED controller from Home Assistant using BanlanX_6xx commands. Its protocol notes identify service FFE0, write characteristic FFE1, plaintext 53-prefixed frames and acknowledged writes for power, white color temperature and brightness.",
  "description_zh": "这项实现通过 MQTT-to-BLE 桥接服务，让 Home Assistant 使用 BanlanX_6xx 命令控制 SP542E 灯带控制器。协议记录列出 FFE0 服务、FFE1 写入特征、以 53 开头的明文帧，以及电源、白光色温和亮度命令所需的确认写入。",
  "entry_url": "https://awesomerea.org/resources/sp542e-ha-bridge-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/sp542e-ha-bridge-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/xydac/sp542e-ha-bridge/blob/6723ee3488a8216c2ca5699b96f6d84543164673/README.md",
  "group": "cases",
  "id": "sp542e-ha-bridge-case",
  "json_url": "https://awesomerea.org/resources/sp542e-ha-bridge-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/sp542e-ha-bridge-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/sp542e-ha-bridge-case/index.md",
  "name": "SP542E MQTT ↔ BLE bridge: local control through the controller protocol",
  "name_zh": "SP542E MQTT ↔ BLE bridge：通过控制器协议实现本地控制",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "An always-on Mac with a local GUI session, Bluetooth permission and BLE access to the SP542E.",
    "Home Assistant with MQTT and credentials configured for the bridge.",
    "The bridge keeps optimistic local state; changes made through the original app or remote are not reflected.",
    "MIT License."
  ],
  "requirements_zh": [
    "需要持续运行的 Mac、本地图形会话、蓝牙权限，以及与 SP542E 的 BLE 连接。",
    "需要配置 MQTT 的 Home Assistant，并为桥接服务设置凭据。",
    "桥接服务使用本地估计状态；原应用或遥控器所做的更改不会同步回来。",
    "MIT 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/xydac/sp542e-ha-bridge",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}