保姆级教程：用ESP32和MicroPython给1.8寸ST7735屏做个网络时钟（附完整代码包）
ESP32+MicroPython打造智能网络时钟：从硬件连接到NTP校时的完整指南
记得第一次用ESP32点亮ST7735屏幕时，那种"Hello World"的兴奋感至今难忘。但真正让我着迷的，是把这块小屏幕变成能自动对时的智能时钟——不用手动调整，永远分秒不差。下面就把这个项目的完整实现过程，包括那些容易踩坑的细节，毫无保留地分享给大家。
1. 硬件准备与连接
1.1 物料清单
制作网络时钟需要以下硬件：
- ESP32开发板（推荐ESP32-WROOM-32，性价比高且兼容性好）
- 1.8寸ST7735 TFT屏幕（128x160分辨率足够显示时间信息）
- 杜邦线（建议使用母对母，连接更稳固）
- Micro USB数据线（用于供电和刷写固件）
注意：购买屏幕时确认驱动芯片是ST7735，市面上有ST7789等类似型号，引脚定义可能不同。
1.2 引脚连接指南
ESP32与ST7735的正确连接是项目成功的第一步。以下是经过实测稳定的接线方案：
| ESP32引脚 | ST7735引脚 | 说明 |
|---|---|---|
| GND | GND | 地线 |
| 3.3V | VCC | 电源正极 |
| GPIO23 | SDA | 数据线 |
| GPIO18 | SCL | 时钟线 |
| GPIO22 | RST | 复位信号 |
| GPIO21 | DC | 数据/命令选择 |
| GPIO16 | CS | 片选信号 |
| 3.3V | BLK | 背光控制（接正极常亮） |
# 硬件连接检查代码 from machine import Pin import time def check_pin(pin_num): p = Pin(pin_num, Pin.OUT) p.value(1) time.sleep(0.5) p.value(0) print(f"GPIO{pin_num} 测试完成") check_pins = [16, 18, 21, 22, 23] for pin in check_pins: check_pin(pin)运行上述代码时，用万用表测量各引脚应有电压变化。如果某个引脚无反应，可能是接触不良或引脚损坏。
2. 软件环境搭建
2.1 MicroPython固件刷写
推荐使用Thonny IDE完成固件刷写：
- 下载最新MicroPython固件（官方地址：micropython.org/download/ESP32）
- 打开Thonny，进入"运行→选择解释器"
- 选择"MicroPython(ESP32)"和对应串口
- 点击"安装或更新MicroPython"刷入固件
刷写成功后，在Shell窗口输入print('Hello MicroPython')测试交互环境。
2.2 必备库文件上传
需要准备两个关键文件：
st7735.py：屏幕驱动库GB2312-12.fon：中文字库
使用Thonny的文件管理器直接拖拽上传到ESP32根目录。上传后运行以下测试代码：
from st7735 import ST7735 from machine import Pin, SPI spi = SPI(2, baudrate=20000000, polarity=0, phase=0, sck=Pin(18), mosi=Pin(23)) lcd = ST7735(128, 160, spi, dc=Pin(21), cs=Pin(16), rst=Pin(22), rot=0, bgr=0) lcd.fill(0xFFFF) # 填充白色 lcd.show()如果屏幕变为纯白，说明驱动加载成功。如果出现花屏或白屏，请检查：
- 接线是否正确，特别是SCL和SDA是否接反
- 屏幕初始化参数（如rot和bgr）是否需要调整
- 电源是否稳定（建议单独给屏幕供电测试）
3. 中文显示实现
3.1 字体渲染原理
MicroPython通过FrameBuffer机制实现图形显示。我们加载的GB2312字库包含6763个汉字和682个符号，每个字符采用12x12点阵存储。
显示中文时需要特别注意：
- 坐标系统以左上角为原点(0,0)
- 颜色使用RGB565格式（16位色）
- 调用
show()方法才会实际刷新屏幕
3.2 实用显示函数封装
为提高代码复用性，建议封装显示函数：
def show_text(lcd, text, x, y, color=0xFFFF, bg_color=0x0000): lcd.fill_rect(x, y, len(text)*12, 12, bg_color) lcd.text(text, x, y, color) lcd.show() # 使用示例 show_text(lcd, "北京时间", 20, 30, 0xF800) # 红色文字常用颜色值参考：
0xF800：红色0x07E0：绿色0x001F：蓝色0xFFFF：白色0x0000：黑色
4. 网络时间同步系统
4.1 NTP校时配置
ESP32通过WiFi连接NTP服务器获取标准时间。关键配置参数：
import ntptime import network # WiFi连接配置 def connect_wifi(ssid, password): wifi = network.WLAN(network.STA_IF) wifi.active(True) if not wifi.isconnected(): wifi.connect(ssid, password) while not wifi.isconnected(): pass print('IP地址:', wifi.ifconfig()[0]) # NTP时间设置 def sync_ntp_time(): ntptime.NTP_DELTA = 3155644800 # 北京时间偏移量 ntptime.host = 'ntp.aliyun.com' # 国内推荐服务器 ntptime.settime()重要提示：
NTP_DELTA值决定时区转换，3155644800对应UTC+8。如果显示时间快/慢8小时，请检查此值。
4.2 低功耗时钟保持
即使网络断开，ESP32也能通过RTC维持时间运行：
from machine import RTC rtc = RTC() def update_display(): datetime = rtc.datetime() # 格式：(年,月,日,星期,时,分,秒,微秒) # 时间格式化显示代码... # 定时器每500ms刷新一次 tim = Timer(-1) tim.init(period=500, mode=Timer.PERIODIC, callback=lambda t:update_display())实际项目中，可以添加WiFi重连逻辑和本地时间校准功能：
def check_time_sync(): if rtc.datetime()[0] < 2023: # 如果年份异常 sync_ntp_time() elif not network.WLAN(network.STA_IF).isconnected(): connect_wifi(MY_SSID, MY_PASSWORD)5. 项目优化与扩展
5.1 界面美化技巧
- 多页面设计：通过按钮切换显示日期、天气等信息
- 动画效果：利用
fill_rect和show实现简单过渡动画 - 自定义字体：修改字库文件实现不同字体大小和样式
5.2 电源管理
长时间运行需考虑功耗问题：
- 设置屏幕亮度自动调节（通过PWM控制BLK引脚）
- 启用ESP32的深度睡眠模式
- 添加锂电池充放电管理
5.3 扩展功能
- 天气信息显示（通过API获取）
- 闹钟功能（利用ESP32的定时器中断）
- 远程控制（开发Web配置界面）
完整项目代码已打包，包含：
- 优化后的ST7735驱动库
- 中文显示示例
- NTP时间同步模块
- 电源管理代码片段
在实现过程中最让我头疼的是时区设置问题，直到发现需要调整NTP_DELTA值才解决。另一个实用技巧是：在初始化SPI时，将波特率设为20MHz（baudrate=20000000）可以获得最流畅的显示效果。