{
  "added_at": "2026-11-08",
  "additional_evidence_urls": [
    "https://github.com/chiva/guoran-nixie-clock/blob/bd2f491e1f68cd1f669622001606739b5f6b48f5/docs/PROTOCOL.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "Guoran nixie clock documents the BLE control protocol of GANXIN IN1204M family clocks and implements it in a Web Bluetooth app and Home Assistant integration. The author derived the commands from the original Android app and the clock manual; the protocol document records GATT characteristics, message handling, and open questions.",
  "description_zh": "Guoran nixie clock 记录 GANXIN IN1204M 系列辉光管时钟的 BLE 控制协议，并提供 Web Bluetooth 应用和 Home Assistant 集成。作者从原版 Android 应用及设备手册梳理命令；协议文档列出 GATT 特征值、消息处理方式和待确认问题。",
  "entry_url": "https://awesomerea.org/resources/guoran-nixie-clock-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/guoran-nixie-clock-case/",
  "evidence_class": 1,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/chiva/guoran-nixie-clock/blob/bd2f491e1f68cd1f669622001606739b5f6b48f5/README.md",
  "group": "cases",
  "id": "guoran-nixie-clock-case",
  "json_url": "https://awesomerea.org/resources/guoran-nixie-clock-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/guoran-nixie-clock-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/guoran-nixie-clock-case/index.md",
  "name": "Guoran nixie clock: reconstructing its Bluetooth control protocol",
  "name_zh": "Guoran nixie clock：重建辉光管时钟蓝牙控制协议",
  "preview_kind": "image",
  "preview_url": "https://awesomerea.org/previews/guoran-nixie-clock-case.jpg",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "A supported Guoran or GANXIN clock; the web app requires Chrome with Web Bluetooth on a computer, while Home Assistant requires a nearby Bluetooth adapter or active ESPHome proxy.",
    "Several packet details remain inferred from app code and unconfirmed on hardware.",
    "MIT license."
  ],
  "requirements_zh": [
    "需要受支持的 Guoran 或 GANXIN 时钟；网页应用需要电脑上的 Chrome 与 Web Bluetooth，Home Assistant 需要附近的蓝牙适配器或可主动连接的 ESPHome 代理。",
    "部分数据包细节仍依据应用代码推断，尚未经硬件确认。",
    "采用 MIT 许可证。"
  ],
  "scope": "partial",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/chiva/guoran-nixie-clock",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}