# open-desk-lamp-firmware：小米台灯的替代固件

> 根据主板接线，为基于 ESP8266 的小米台灯实现替代固件，提供本地开关、调光和色温控制。

- 类型：案例
- 目标：固件
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-10-27
- 收录于：2026-11-09
- 原始资源：<https://github.com/fvollmer/open-desk-lamp-firmware>
- 一手来源：<https://github.com/fvollmer/open-desk-lamp-firmware/blob/043aeb9f95c0454b92200cded4b7e4cc3b23011e/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/xiaomi-desk-lamp-open-firmware-case/>
- 记录 JSON：<https://awesomerea.org/resources/xiaomi-desk-lamp-open-firmware-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/xiaomi-desk-lamp-open-firmware-case/index.md)

## 使用条件与局限

- 固件涵盖台灯的本地旋钮控制：开关、亮度及色温；文档针对作者使用的硬件型号。
- 安装需拆开台灯，将 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 许可证。原厂固件和小米应用受各自条款约束。

## 一手来源

1. <https://github.com/fvollmer/open-desk-lamp-firmware/blob/043aeb9f95c0454b92200cded4b7e4cc3b23011e/README.md>
2. <https://github.com/fvollmer/open-desk-lamp-firmware/blob/043aeb9f95c0454b92200cded4b7e4cc3b23011e/src/CMakeLists.txt>
3. <https://github.com/fvollmer/open-desk-lamp-firmware/blob/043aeb9f95c0454b92200cded4b7e4cc3b23011e/src/main.c>
4. <https://github.com/fvollmer/open-desk-lamp-firmware/blob/043aeb9f95c0454b92200cded4b7e4cc3b23011e/src/leds.c>
5. <https://github.com/fvollmer/open-desk-lamp-firmware/blob/043aeb9f95c0454b92200cded4b7e4cc3b23011e/.travis.yml>
6. <https://github.com/fvollmer/open-desk-lamp-firmware/blob/043aeb9f95c0454b92200cded4b7e4cc3b23011e/LICENSE>
7. <https://github.com/fvollmer/open-desk-lamp-firmware/releases/tag/v0.0.1>
8. <https://github.com/pfalcon/esp-open-sdk/blob/c70543e57fb18e5be0315aa217bca27d0e26d23d/README.md>
9. <https://github.com/pfalcon/esp-open-sdk/blob/c70543e57fb18e5be0315aa217bca27d0e26d23d/Makefile>

## 同分区更多条目：固件与硬件

- [EchoPod：Snowsky Echo Mini 8 GB 替代固件](https://awesomerea.org/zh/resources/echopod-echo-mini-firmware-case/index.md) · 案例
- [GLaBIOS：从零编写的 8K ROM BIOS](https://awesomerea.org/zh/resources/glabios-rom-bios-case/index.md) · 案例
- [TC66 定制固件：RuiDeng USB-C 功率计的替代镜像](https://awesomerea.org/zh/resources/tc66-meter-firmware-case/index.md) · 案例
- [UV-K5：泉盛固件 v2.1.27 的开源重实现](https://awesomerea.org/zh/resources/uv-k5-firmware-case/index.md) · 案例
- [R64Emu：Nintendo 64 硬件的低层重建](https://awesomerea.org/zh/resources/r64emu-n64-case/index.md) · 案例
- [Nuked-MD-FPGA：Sega Mega Drive 芯片组重建](https://awesomerea.org/zh/resources/nuked-md-fpga-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。