告别‘从入门到放弃’：ESP32+MicroPython项目实战，用OLED做个物联网温湿度计

从零打造物联网温湿度计：ESP32+MicroPython实战指南

项目背景与核心价值

在物联网技术快速普及的今天，掌握嵌入式开发已成为开发者的一项重要技能。ESP32作为一款功能强大且价格亲民的微控制器，结合MicroPython的易用性，为初学者打开了物联网开发的大门。不同于传统枯燥的理论学习，本项目将通过构建一个完整的温湿度监测系统，带你体验真实的开发流程。

这个项目特别适合已经完成基础环境搭建，但苦于找不到合适练手项目的开发者。我们将使用常见的DHT11传感器采集环境数据，通过0.96寸OLED屏幕实时显示，最终还能将数据上传至物联网平台。整个过程涵盖了硬件连接、驱动编写、数据显示等关键环节，为你后续开发更复杂的物联网应用打下坚实基础。

1. 硬件准备与连接

1.1 所需组件清单

在开始项目前，请确保准备好以下硬件组件：

• ESP32开发板（推荐WEMOS LOLIN32 Lite）
• DHT11温湿度传感器
• 0.96寸OLED显示屏（I2C接口）
• 面包板及杜邦线若干
• Micro USB数据线

提示：购买组件时，注意选择兼容3.3V工作电压的型号，避免损坏ESP32开发板。

1.2 硬件连接示意图

正确连接硬件是项目成功的第一步。以下是各组件与ESP32的接线方式：

连接时需特别注意：

• 确保电源极性正确，反接可能损坏组件
• 使用质量较好的杜邦线，避免接触不良
• 建议先断电连接，检查无误后再通电

2. 开发环境配置

2.1 Thonny IDE安装与设置

Thonny是一款非常适合MicroPython开发的轻量级IDE，以下是配置步骤：

1. 从官网下载并安装最新版Thonny
2. 打开Thonny，进入"工具"→"选项"
3. 在"解释器"选项卡中选择"MicroPython(ESP32)"
4. 连接ESP32开发板，选择对应的串口
5. 点击"安装或更新MicroPython"按钮，选择适合ESP32的固件

# 测试MicroPython环境是否正常工作 print("Hello, ESP32!")

运行上述代码，如果能在Shell窗口看到输出，说明环境配置成功。

2.2 必要库的安装

本项目需要两个关键库：ssd1306用于OLED显示，dht用于读取传感器数据。由于MicroPython的标准库不包含这些驱动，我们需要手动安装：

import upip upip.install("micropython-ssd1306") upip.install("micropython-dht")

如果网络连接有问题，也可以下载.py文件手动上传到ESP32。

3. 代码实现与模块化设计

3.1 传感器数据读取模块

我们首先创建sensor.py文件，封装DHT11的读取逻辑：

import dht from machine import Pin import time class DHT11Sensor: def __init__(self, pin): self.sensor = dht.DHT11(Pin(pin)) def read(self): try: self.sensor.measure() temp = self.sensor.temperature() humi = self.sensor.humidity() return temp, humi except Exception as e: print("传感器读取失败:", e) return None, None

这段代码实现了：

• 封装DHT11初始化过程
• 提供简单的读取接口
• 加入异常处理增强稳定性

3.2 OLED显示模块

创建display.py文件，实现OLED显示功能：

from machine import I2C, Pin import ssd1306 import time class OLEDDisplay: def __init__(self, sda_pin=21, scl_pin=22): i2c = I2C(sda=Pin(sda_pin), scl=Pin(scl_pin)) self.oled = ssd1306.SSD1306_I2C(128, 64, i2c) def show_text(self, text, x=0, y=0, clear=True): if clear: self.oled.fill(0) self.oled.text(text, x, y) self.oled.show() def show_temp_humi(self, temp, humi): self.oled.fill(0) self.oled.text("环境监测", 30, 0) self.oled.text("温度: {:.1f}C".format(temp), 0, 20) self.oled.text("湿度: {:.1f}%".format(humi), 0, 40) self.oled.show()

关键功能点：

• 初始化I2C接口和OLED屏幕
• 提供文本显示和温湿度专用显示方法
• 支持清屏控制，避免残留显示

3.3 主程序逻辑

创建main.py作为程序入口：

from sensor import DHT11Sensor from display import OLEDDisplay import time sensor = DHT11Sensor(4) display = OLEDDisplay() def main(): while True: temp, humi = sensor.read() if temp is not None and humi is not None: display.show_temp_humi(temp, humi) time.sleep(2) if __name__ == "__main__": main()

主程序流程：

1. 初始化传感器和显示屏
2. 进入循环，每2秒读取一次数据
3. 有效数据则显示在OLED上
4. 加入简单异常处理

4. 调试与优化技巧

4.1 常见问题排查

开发过程中可能会遇到以下问题：

• OLED不显示：检查I2C地址是否正确，接线是否牢固
• 传感器读数异常：确保DHT11供电稳定，数据线连接正确
• 程序崩溃重启：增加异常捕获，避免单次失败导致系统重启

4.2 性能优化建议

随着项目复杂度增加，可以考虑以下优化：

# 低功耗优化示例 import machine def deep_sleep(duration_ms): # 配置唤醒源 rtc = machine.RTC() rtc.irq(trigger=rtc.ALARM0, wake=machine.DEEPSLEEP) # 设置唤醒时间 rtc.alarm(rtc.ALARM0, duration_ms) # 进入深度睡眠 machine.deepsleep()

其他优化方向：

• 减少不必要的显示刷新
• 实现数据平滑滤波
• 加入看门狗定时器提高稳定性

4.3 物联网功能扩展

将数据上传到云平台是物联网项目的核心功能。以下是MQTT发布的简单实现：

from umqtt.simple import MQTTClient def connect_mqtt(): client = MQTTClient("esp32_client", "mqtt.broker.com") client.connect() return client def publish_data(client, temp, humi): client.publish(b"home/sensor/temp", str(temp)) client.publish(b"home/sensor/humi", str(humi))

实际应用中还需要考虑：

• 安全的认证机制
• 断线重连逻辑
• 数据压缩和批处理

5. 项目进阶方向

完成基础功能后，可以考虑以下扩展：

• 多传感器融合：增加光照、气压等传感器
• 本地数据记录：使用SPI Flash存储历史数据
• 低功耗优化：实现定时唤醒采集
• Web界面：通过ESP32内置WiFi提供配置页面
• OTA升级：支持无线更新固件

每个扩展方向都能带来新的学习机会，建议从一个最感兴趣的点开始，逐步完善项目功能。