1. 项目概述与环境搭建
各位同学，欢迎来到《智能灯控自动化实例开发》的第一章。我是你们这门课的老朋友，一个在嵌入式与物联网领域摸爬滚打了十来年的工程师。今天咱们不聊虚的，直接上手，把智能灯控这个项目的来龙去脉和开发环境给捋清楚。
智能灯控，说白了就是让灯学会“看人下菜碟”。你走进房间，它自动亮起；你离开，它缓缓熄灭；你想调个色温，动动嘴或者点一下手机就行。我最早接触这类项目是在一个智能家居展会上，当时看到一套基于 Zigbee 的灯控系统，觉得挺酷。后来自己用 ESP32 复刻了一个，才发现坑也不少。嗯，咱们这门课就是要带你把这些坑都填平。
核心目标： 用 ESP32 或树莓派，结合 Python/MicroPython，实现一套可远程控制、可定时、可感知环境的智能灯控系统。
1.1 项目背景：为什么是灯控？
你想想看，灯控是物联网里最经典、也最实用的入门项目。它不复杂，但五脏俱全：需要传感器（光敏、人体红外）、需要执行器（继电器、PWM 调光）、需要通信（Wi-Fi、MQTT）、需要逻辑控制（自动化规则）。我当年带团队做第一个物联网项目时，就是拿灯控练的手。做完这个，后面做温湿度监控、门禁系统，基本就是换汤不换药。
咱们这个课程会覆盖几个典型场景：
- 场景一：人来灯亮，人走灯灭 —— 用人体红外传感器 + 光敏电阻实现。
- 场景二：手机远程开关 —— 通过 MQTT 协议，用手机 App 控制。
- 场景三：定时开关与场景联动 —— 比如晚上 7 点自动开灯，配合窗帘电机。
- 场景四：语音控制 —— 接入小爱同学或天猫精灵。
这些场景，咱们会一步步实现。但第一步，先把家伙事儿备齐。
1.2 硬件选型：ESP32 还是树莓派？
这是很多新手纠结的问题。我个人习惯是：做嵌入式原型，首选 ESP32；做复杂逻辑或需要跑 Linux 服务，再考虑树莓派。 为什么？
| 对比项 | ESP32 | 树莓派 (Raspberry Pi 4/5) |
|---|---|---|
| 价格 | 20-40 元 | 200-500 元 |
| 功耗 | 极低（几十 mA） | 较高（几百 mA 到 1A+） |
| 实时性 | 强（硬件定时器、中断） | 弱（依赖操作系统调度） |
| 开发语言 | MicroPython / C++ | Python / C++ / 其他 |
| 适用场景 | 传感器采集、简单控制、低功耗节点 | 图像处理、Web 服务器、复杂逻辑 |
咱们这门课，主推 ESP32。原因很简单：便宜、省电、够用。你想想看，一个灯控节点，犯不着上树莓派。我曾在项目里用 ESP32 挂了 6 个传感器加一个继电器，跑了大半年没出过问题。树莓派当然也能做，但杀鸡用牛刀了。
我的建议： 如果你手头有树莓派，也可以跟着学，但后续章节的 GPIO 操作和 MicroPython 代码需要做少量适配。我会在关键地方给出提示。
1.3 开发环境：Python 与 MicroPython 固件烧录
好，硬件选好了，接下来就是搭环境。咱们用 MicroPython 来写 ESP32 的程序。MicroPython 是 Python 3 的一个精简版，专门跑在微控制器上。语法基本一样，但库少一些。我刚开始用的时候，最不习惯的就是没有标准库里的 threading 和 requests，不过后来发现 uasyncio 和 urequests 也能凑合用。
1.3.1 安装 Python 环境
首先，你电脑上得装 Python。我建议用 Python 3.8 以上版本。去官网下载安装包，记得勾选“Add Python to PATH”。
装完后，打开终端（Windows 用 cmd 或 PowerShell，Mac/Linux 用 bash），验证一下：
python --version
pip --version如果能看到版本号，说明装好了。接下来，我们需要一个串口工具来和 ESP32 通信。我个人习惯用 esptool 和 ampy，都是 Python 包。
pip install esptool adafruit-ampy注意： 如果你用的是 Linux 或 macOS，可能需要用 pip3 而不是 pip。另外，Linux 下操作串口需要把用户加入 dialout 组，否则会报权限错误。我曾经在这上面卡了半小时，后来发现是忘了加组。
1.3.2 下载 MicroPython 固件
去 MicroPython 官网的下载页面，找到 ESP32 对应的固件。一般选最新的稳定版，文件后缀是 .bin。下载后放到一个你记得住的目录，比如 ~/Downloads/ 或 C:\firmware\。
1.3.3 烧录固件到 ESP32
这一步是新手最容易出问题的。别急，按我的步骤来。
- 连接硬件： 用 USB 线把 ESP32 连到电脑。如果 ESP32 是裸板，可能需要按住 BOOT 键再上电，才能进入下载模式。我用的开发板（比如 ESP32-DevKitC）一般自带自动下载电路，不用手动按。
- 查看串口号：
- Windows：打开设备管理器，看“端口 (COM 和 LPT)”下面，一般叫
COM3或COM4。 - Mac/Linux：在终端输入
ls /dev/tty*，找类似/dev/ttyUSB0或/dev/ttyACM0的设备。
- Windows：打开设备管理器，看“端口 (COM 和 LPT)”下面，一般叫
- 擦除原有固件： 这一步很重要。我遇到过好几次，旧固件没擦干净，新固件烧进去后跑不起来。
# 把 COM3 换成你的实际串口
esptool.py --port COM3 erase_flash- 烧录新固件：
esptool.py --port COM3 --baud 460800 write_flash --flash_size=detect 0 esp32-20220618-v1.19.1.bin这里 0 是起始地址，esp32-20220618-v1.19.1.bin 是你下载的固件文件名。烧录成功后，你会看到类似 Hash of data verified. 的提示。
避坑指南： 我曾经用 115200 的波特率烧录，结果慢得让人抓狂。后来发现 ESP32 支持 460800 甚至 921600，速度快很多。但如果你用的 USB 线质量差，高速烧录可能会失败，这时候降回 115200 试试。
1.3.4 验证固件是否烧录成功
烧录完成后，用串口工具连接 ESP32。我推荐用 picocom（Mac/Linux）或 putty（Windows）。也可以用 screen：
screen /dev/ttyUSB0 115200连接后，按一下 ESP32 的 EN 键（复位键），你应该能看到 MicroPython 的交互提示符 >>>。输入 print("Hello, Smart Light!")，如果能看到输出，恭喜你，环境搭好了。
1.4 知识体系总览
为了让你对本章内容有个整体印象，我画了一张图。这张图展示了从项目背景到环境搭建的完整链路。
1.5 本章小结
好，咱们把第一章的内容捋一遍：
- 智能灯控项目，说白了就是让灯学会自动响应。它是个完美的物联网入门项目。
- 硬件选型上，我推荐 ESP32，便宜、省电、够用。树莓派适合更复杂的场景。
- 开发环境用 Python + MicroPython。装好
esptool和ampy，下载固件，擦除旧固件，烧录新固件，最后用串口验证。