ESP32+MicroPython实战：5分钟搞定LED闪烁（附完整代码）

ESP32+MicroPython实战：5分钟搞定LED闪烁（附完整代码）

第一次接触硬件开发时，最让人兴奋的莫过于看到自己写的代码让LED灯闪烁起来。这种即时反馈带来的成就感，是软件调试无法比拟的。ESP32作为一款性价比极高的物联网开发板，配合MicroPython的简洁语法，让硬件开发的门槛大幅降低。本文将带你从零开始，用不到5分钟的时间完成第一个硬件项目——LED闪烁。

1. 准备工作：硬件与软件环境搭建

在开始编程前，我们需要准备好开发环境和必要的硬件。ESP32开发板种类繁多，但核心功能基本一致。推荐选择带有USB接口和内置LED的型号，这样无需额外接线就能完成基础实验。

所需材料清单：

• ESP32开发板（如ESP32-DevKitC）
• Micro USB数据线
• 电脑（Windows/Mac/Linux均可）

软件方面，我们需要：

1. Thonny IDE：轻量级的Python开发环境，内置MicroPython支持
2. MicroPython固件：ESP32专用版本

提示：Thonny的安装包可在官网免费下载，选择与操作系统匹配的版本即可。

固件烧录步骤：

# 使用esptool.py擦除原有固件 esptool.py --port /dev/ttyUSB0 erase_flash # 烧录MicroPython固件 esptool.py --chip esp32 --port /dev/ttyUSB0 write_flash -z 0x1000 esp32-20220117-v1.18.bin

Windows用户需要注意端口号可能是COM3这样的形式，而非/dev/ttyUSB0。烧录完成后，打开Thonny，在右下角选择正确的解释器和端口，就能开始MicroPython编程了。

2. 认识ESP32的GPIO与内置LED

大多数ESP32开发板都内置了一个可编程控制的LED，通常连接在GPIO2上。但在不同型号上可能有所差异，建议查阅具体开发板的原理图确认。

ESP32的GPIO引脚功能丰富，在使用前需要明确几点：

• 部分引脚在启动时有特殊功能（如GPIO0影响启动模式）
• 输入电压范围通常为0-3.3V，不能直接连接5V设备
• 每个GPIO都可以配置为上拉或下拉输入，推挽输出等模式

常见ESP32开发板LED连接情况：

通过以下代码可以测试LED是否可用：

from machine import Pin led = Pin(2, Pin.OUT) # 根据实际GPIO号调整 led.value(0) # 点亮LED led.value(1) # 熄灭LED

3. 实现LED闪烁的完整代码解析

理解了基础硬件知识后，让我们编写完整的LED闪烁程序。MicroPython提供了time模块来处理时间相关操作，结合GPIO控制就能实现周期性闪烁。

基础版本代码：

from machine import Pin import time led = Pin(2, Pin.OUT) # 创建LED对象 while True: led.value(not led.value()) # 切换LED状态 time.sleep(0.5) # 延时0.5秒

这段代码虽然简单，但包含了几个重要概念：

1. machine模块：MicroPython的硬件抽象层，提供对底层硬件的访问
2. Pin类：用于控制GPIO引脚
3. time.sleep()：实现延时功能

为了让代码更健壮，我们可以添加异常处理和配置选项：

from machine import Pin import time def blink_led(pin_num=2, interval=0.5, times=None): try: led = Pin(pin_num, Pin.OUT) count = 0 while True if times is None else count < times: led.value(not led.value()) time.sleep(interval) count += 1 except Exception as e: print("Error:", e) finally: led.value(1) # 确保最后LED熄灭 # 示例用法 blink_led(times=10) # 闪烁10次

4. 进阶技巧与常见问题解决

掌握了基础闪烁后，我们可以探索更多实用技巧和解决开发中可能遇到的问题。

4.1 使用PWM实现呼吸灯效果

除了简单的开关控制，ESP32的GPIO还支持PWM（脉冲宽度调制），可以轻松实现LED亮度渐变：

from machine import Pin, PWM import time pwm = PWM(Pin(2)) # 创建PWM对象 pwm.freq(1000) # 设置频率为1kHz def breathe(): for duty in range(0, 1024, 10): # 亮度渐增 pwm.duty(duty) time.sleep(0.02) for duty in range(1023, -1, -10): # 亮度渐减 pwm.duty(duty) time.sleep(0.02) while True: breathe()

4.2 常见问题排查

LED不亮怎么办？

1. 检查GPIO号是否正确
2. 确认LED极性（有些外接LED长脚为正极）
3. 用万用表测量GPIO输出电压（应为3.3V或0V）
4. 尝试更换LED或电阻

代码上传后不运行？

1. 确保文件保存为main.py（ESP32会自动运行此文件）
2. 检查是否有语法错误（Thonny会提示）
3. 尝试重启开发板

如何实现更精确的定时？MicroPython的time模块精度有限，对于需要精确计时的应用，可以使用硬件定时器：

from machine import Timer tim = Timer(-1) # 创建虚拟定时器 tim.init(period=500, mode=Timer.PERIODIC, callback=lambda t: led.value(not led.value()))

5. 项目扩展与实用案例

掌握了LED控制后，可以尝试将这些知识应用到实际项目中。以下是几个简单但实用的扩展方向：

5.1 WiFi状态指示灯

利用ESP32的WiFi功能，可以让LED显示网络连接状态：

import network from machine import Pin import time led = Pin(2, Pin.OUT) wlan = network.WLAN(network.STA_IF) def connect_wifi(ssid, password): wlan.active(True) if not wlan.isconnected(): print('connecting to network...') wlan.connect(ssid, password) while not wlan.isconnected(): led.value(not led.value()) # 连接中闪烁 time.sleep(0.2) led.value(0) # 连接成功常亮 print('network config:', wlan.ifconfig()) connect_wifi('your_SSID', 'your_password')

5.2 物联网远程控制LED

结合MQTT协议，可以实现通过手机APP远程控制LED：

from umqtt.simple import MQTTClient from machine import Pin import time led = Pin(2, Pin.OUT) client = MQTTClient("esp32", "mqtt_broker_address") def callback(topic, msg): if msg == b"on": led.value(0) elif msg == b"off": led.value(1) client.set_callback(callback) client.connect() client.subscribe(b"led/control") while True: client.wait_msg()

5.3 光敏自动灯

添加光敏电阻传感器，可以根据环境光线自动控制LED：

from machine import Pin, ADC import time led = Pin(2, Pin.OUT) light_sensor = ADC(Pin(34)) light_sensor.atten(ADC.ATTN_11DB) # 设置测量范围为0-3.3V while True: light_value = light_sensor.read() if light_value < 1000: # 光线较暗时点亮LED led.value(0) else: led.value(1) time.sleep(1)

在实际项目中，我发现ESP32的ADC精度受WiFi射频影响较大，对于需要精确测量的场景，建议使用外置ADC芯片或数字传感器。另外，MicroPython的内存管理需要特别注意，长时间运行的项目要避免内存泄漏。