Case study

Guoran nixie clock: reconstructing its Bluetooth control protocol

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.

Targets: Protocol
Category: Independent reconstruction cases
Relationship: Independent reconstruction project
Sources reviewed: 2026-11-06
Evidence class: C1 partial scope or analysis entry

Stars: 0
Last commit: 2026-11-09
Language: Python
License (GitHub): MIT

GitHub data as of 2026-11-10

Copy as Markdown View JSON Cite

Evidence

Demo screenshot from the project's public documentation

Observed: Download and demo observed; the case covers part of the target software.
Scope: Partial
Checked: 2026-11-08

How evidence classes are assigned

Requirements & limits

Prerequisites: 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.
Limits: Several packet details remain inferred from app code and unconfirmed on hardware.
License: MIT license.

Cite

BibTeX

@misc{guoran-nixie-clock-case,
  title = {{Guoran nixie clock: reconstructing its Bluetooth control protocol}},
  howpublished = {\url{https://github.com/chiva/guoran-nixie-clock}},
  url = {https://github.com/chiva/guoran-nixie-clock},
  urldate = {2026-11-06},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/guoran-nixie-clock-case/}}
}

Plain text

Guoran nixie clock: reconstructing its Bluetooth control protocol. https://github.com/chiva/guoran-nixie-clock (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/guoran-nixie-clock-case/

Useful? Star Awesome REA on GitHub2.4k

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

README.md GitHub · chiva/guoran-nixie-clock · Revision bd2f491
docs/PROTOCOL.md GitHub · chiva/guoran-nixie-clock · Revision bd2f491