第1章：开发环境搭建
各位同学，欢迎来到《按摩仪LED灯效驱动编程实战》的第一课。
做嵌入式开发，说白了就是跟硬件打交道。你写再漂亮的代码，烧不进芯片也是白搭。所以，咱们第一步就是把“厨房”收拾利索——搭建开发环境。
我个人习惯，拿到一块新板子，第一件事不是写代码，而是先确认三件事：能不能连上、能不能烧录、能不能跑通。今天我们就按这个顺序来。
1.1 固件烧录：给芯片装上“操作系统”
MicroPython 是什么？你可以把它理解成跑在单片机上的 Python 解释器。ESP32 和 STM32 出厂时，默认跑的是 C 语言固件。我们要想用 Python 控制它，就得先刷入 MicroPython 固件。
嗯，这里要注意：不同芯片的固件不通用。ESP32 和 STM32 的固件文件是分开的，千万别搞混。
1.1.1 下载固件
去 MicroPython 官网下载对应你板子的固件。以 ESP32 为例，文件名通常是 esp32-20220618-v1.19.1.bin 这样的格式。
我曾经遇到过一个问题：下载了最新版固件，结果烧录后板子反复重启。后来发现是固件版本跟我的 Flash 大小不匹配。所以，建议选稳定版，别追新。
1.1.2 烧录工具：esptool.py
这是官方推荐的烧录工具。安装很简单：
pip install esptool烧录前，先擦除 Flash：
esptool.py --port COM3 erase_flash然后烧录固件：
esptool.py --port COM3 --baud 460800 write_flash --flash_size=detect 0 esp32-20220618-v1.19.1.bin这里有个小坑：波特率别设太高。我一开始用 921600，结果老是烧到一半报错。降到 460800 就稳了。你想想看，省那几秒钟，换来一堆报错，不值当。
device manager 查看 COM 口。Linux/Mac 用户用 ls /dev/tty* 查找。
1.2 Thonny IDE 配置：写代码的“编辑器”
Thonny 是我个人比较推荐的 MicroPython IDE。它轻量、开箱即用，对新手很友好。
1.2.1 安装 Thonny
去官网下载对应系统的安装包。安装过程一路 Next 就行，没什么特别的。
1.2.2 配置解释器
打开 Thonny，点击菜单栏 运行 -> 选择解释器。
- 解释器选 MicroPython (ESP32) 或 MicroPython (STM32)
- 端口选你板子对应的 COM 口
配置好后，点击右下角的 Shell 窗口，如果看到 >>> 提示符，说明连接成功了。
1.3 开发板连接：让电脑“认识”板子
这一步其实很简单，但很多新手会卡在这里。说白了，就是让电脑通过 USB 跟板子通信。
1.3.1 硬件连接
用 USB 线把开发板连到电脑。注意：数据线！数据线！数据线！ 有些 USB 线只能充电，不能传数据。我吃过这个亏，折腾了半小时才发现是线的问题。
1.3.2 驱动安装
ESP32 常用 CH340 或 CP2102 芯片做 USB 转串口。STM32 则用 ST-Link 或虚拟串口。
| 芯片 | 常见 USB 芯片 | 驱动名称 |
|---|---|---|
| ESP32 | CH340 / CP2102 | CH340 驱动 / CP210x 驱动 |
| STM32 | ST-Link / VCP | ST-Link 驱动 / STM32 VCP 驱动 |
驱动装好后，在设备管理器里能看到对应的 COM 口。如果出现黄色感叹号，那就是驱动没装对。
1.3.3 验证连接
打开 Thonny，在 Shell 里输入：
print("Hello, 按摩仪!")如果看到输出，恭喜你，环境搭建成功了！
1.4 本章小结
今天我们做了三件事：
- 给 ESP32/STM32 刷入了 MicroPython 固件
- 配置了 Thonny IDE 并连接了开发板
- 验证了板子能正常通信
说白了，就是让电脑能跟板子“说话”。下一章，我们会开始控制 LED 灯，让第一个灯亮起来。
记住：环境搭好了，后面就顺了。如果卡在哪一步，别硬扛，回头检查一下驱动、端口、固件版本。我当年也是这么一步步踩过来的。