# 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.

- Type: Case study
- Targets: 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/chiva/guoran-nixie-clock>
- Primary source: <https://github.com/chiva/guoran-nixie-clock/blob/bd2f491e1f68cd1f669622001606739b5f6b48f5/README.md>
- Catalog page: <https://awesomerea.org/resources/guoran-nixie-clock-case/>
- Record JSON: <https://awesomerea.org/resources/guoran-nixie-clock-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/guoran-nixie-clock-case/index.md)

## 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.

## Primary sources

1. <https://github.com/chiva/guoran-nixie-clock/blob/bd2f491e1f68cd1f669622001606739b5f6b48f5/README.md>
2. <https://github.com/chiva/guoran-nixie-clock/blob/bd2f491e1f68cd1f669622001606739b5f6b48f5/docs/PROTOCOL.md>

## More in Protocols

- [1st Player RT LCD: reconstructing a case-display HID protocol](https://awesomerea.org/resources/1stplayer-rt-lcd-case/index.md) · Case study
- [Ecovacs Deebot X1: reconstructing local map and control interfaces](https://awesomerea.org/resources/ecovacs-x1-local-control-case/index.md) · Case study
- [MyEnergy Dashboard: reconstructing INFINITY 1000 Bluetooth controls](https://awesomerea.org/resources/myenergy-dashboard-case/index.md) · Case study
- [sk700v-linux: a Linux display client for the Sudokoo SK700V](https://awesomerea.org/resources/sk700v-linux-case/index.md) · Case study
- [OpenNoiseRep: a BLE client for the Noise REP fitness band](https://awesomerea.org/resources/opennoiserep-case/index.md) · Case study
- [rtchair: local control of the Rotai RT7709S massage chair](https://awesomerea.org/resources/rtchair-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.