{
  "added_at": "2026-11-09",
  "additional_evidence_urls": [
    "https://github.com/fvollmer/open-desk-lamp-firmware/blob/043aeb9f95c0454b92200cded4b7e4cc3b23011e/src/CMakeLists.txt",
    "https://github.com/fvollmer/open-desk-lamp-firmware/blob/043aeb9f95c0454b92200cded4b7e4cc3b23011e/src/main.c",
    "https://github.com/fvollmer/open-desk-lamp-firmware/blob/043aeb9f95c0454b92200cded4b7e4cc3b23011e/src/leds.c",
    "https://github.com/fvollmer/open-desk-lamp-firmware/blob/043aeb9f95c0454b92200cded4b7e4cc3b23011e/.travis.yml",
    "https://github.com/fvollmer/open-desk-lamp-firmware/blob/043aeb9f95c0454b92200cded4b7e4cc3b23011e/LICENSE",
    "https://github.com/fvollmer/open-desk-lamp-firmware/releases/tag/v0.0.1",
    "https://github.com/pfalcon/esp-open-sdk/blob/c70543e57fb18e5be0315aa217bca27d0e26d23d/README.md",
    "https://github.com/pfalcon/esp-open-sdk/blob/c70543e57fb18e5be0315aa217bca27d0e26d23d/Makefile"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "Replaces the ESP8266-based Xiaomi desk lamp firmware with an open implementation of the lamp's local power, dimming and colour-temperature controls, based on the documented board wiring.",
  "description_zh": "根据主板接线，为基于 ESP8266 的小米台灯实现替代固件，提供本地开关、调光和色温控制。",
  "entry_url": "https://awesomerea.org/resources/xiaomi-desk-lamp-open-firmware-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/xiaomi-desk-lamp-open-firmware-case/",
  "evidence_url": "https://github.com/fvollmer/open-desk-lamp-firmware/blob/043aeb9f95c0454b92200cded4b7e4cc3b23011e/README.md",
  "group": "cases",
  "id": "xiaomi-desk-lamp-open-firmware-case",
  "json_url": "https://awesomerea.org/resources/xiaomi-desk-lamp-open-firmware-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/xiaomi-desk-lamp-open-firmware-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/xiaomi-desk-lamp-open-firmware-case/index.md",
  "name": "open-desk-lamp-firmware: replacement firmware for the Xiaomi desk lamp",
  "name_zh": "open-desk-lamp-firmware：小米台灯的替代固件",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirements": [
    "The firmware covers the lamp's local knob controls: power, dimming and colour temperature; the author's hardware variant is the documented target.",
    "Installation requires opening the lamp, wiring U0RX, U0TX, GPIO0 and GND to a USB serial adapter, and overwriting stock firmware. Back up the original flash; the backup contains Wi-Fi credentials. Check flash size for other variants.",
    "Build with CMake 2.8+, xtensa-lx106-elf from esp-open-sdk and Espressif's ESP8266 NONOS SDK. CI compiles the firmware but runs no tests.",
    "The project uses MIT; Espressif's SDK libraries have their own modified MIT license. Stock firmware and the Xiaomi app retain their own terms."
  ],
  "requirements_zh": [
    "固件涵盖台灯的本地旋钮控制：开关、亮度及色温；文档针对作者使用的硬件型号。",
    "安装需拆开台灯，将 U0RX、U0TX、GPIO0 和 GND 接到 USB 串口转换器，并覆盖原厂固件。应先备份原闪存；备份含 Wi-Fi 凭据。其他型号需核对闪存容量。",
    "构建需要 CMake 2.8+、esp-open-sdk 的 xtensa-lx106-elf 工具链及 Espressif ESP8266 NONOS SDK。CI 仅编译固件，不运行测试。",
    "项目采用 MIT；Espressif SDK 库使用其自身的修改版 MIT 许可证。原厂固件和小米应用受各自条款约束。"
  ],
  "targets": [
    "firmware"
  ],
  "url": "https://github.com/fvollmer/open-desk-lamp-firmware",
  "verification": "source-reviewed",
  "verified_at": "2026-10-27"
}