ESP32玩转1.8寸LCD屏：用TFT_eSPI库做个桌面小时钟（附完整代码）

ESP32打造高颜值桌面时钟从TFT_eSPI库到完整项目实战在创客的世界里将硬件与代码结合创造出实用又有趣的项目总是令人兴奋。今天我们要用ESP32开发板和1.8寸ST7735驱动的LCD屏幕打造一个功能完善、界面美观的桌面电子时钟。这个项目不仅适合作为桌面摆件更是学习嵌入式GUI开发的绝佳案例。1. 项目准备与环境搭建1.1 硬件清单要完成这个项目你需要准备以下硬件组件ESP32开发板推荐使用ESP32-WROOM-321.8寸TFT LCD屏幕ST7735驱动芯片杜邦线若干面包板可选用于临时连接USB数据线用于供电和编程硬件连接示意图如下ESP32引脚LCD引脚功能说明3.3VVCC电源正极GNDGND电源地线GPIO18SCLSPI时钟线GPIO23SDASPI数据线GPIO5RES复位信号GPIO4DC数据/命令选择GPIO15CS片选信号1.2 软件环境配置首先确保你已经安装了Arduino IDE和ESP32开发板支持包。然后按照以下步骤配置TFT_eSPI库通过Arduino库管理器安装TFT_eSPI库找到库目录下的User_Setup.h文件通常位于Arduino/libraries/TFT_eSPI修改配置文件以适配ST7735驱动#define ST7735_DRIVER #define TFT_WIDTH 128 #define TFT_HEIGHT 160 #define TFT_RGB_ORDER TFT_BGR // 颜色顺序 #define TFT_MISO -1 // 不使用MISO #define TFT_MOSI 23 // GPIO23 #define TFT_SCLK 18 // GPIO18 #define TFT_CS 15 // GPIO15 #define TFT_DC 4 // GPIO4 #define TFT_RST 5 // GPIO5 #define LOAD_GLCD // 加载标准字体2. 基础时钟功能实现2.1 获取网络时间(NTP)一个实用的时钟需要准确的时间源。我们将使用NTP(网络时间协议)从互联网获取时间#include WiFi.h #include time.h const char* ssid 你的WiFi名称; const char* password 你的WiFi密码; void setupTime() { WiFi.begin(ssid, password); while (WiFi.status() ! WL_CONNECTED) { delay(500); Serial.print(.); } configTime(8 * 3600, 0, pool.ntp.org, time.nist.gov); struct tm timeinfo; if (!getLocalTime(timeinfo)) { Serial.println(Failed to obtain time); return; } Serial.println(timeinfo, %A, %B %d %Y %H:%M:%S); }2.2 基本时钟显示现在让我们在屏幕上显示时间#include TFT_eSPI.h TFT_eSPI tft TFT_eSPI(); void displayTime() { struct tm timeinfo; if (!getLocalTime(timeinfo)) { tft.setTextColor(TFT_RED); tft.drawString(Time Sync Failed, 10, 10, 2); return; } char timeStr[20]; strftime(timeStr, sizeof(timeStr), %H:%M:%S, timeinfo); tft.setTextColor(TFT_WHITE, TFT_BLACK); tft.drawString(timeStr, 20, 50, 7); // 使用大号字体显示时间 }3. 界面美化与高级功能3.1 设计美观的时钟界面一个好看的时钟界面需要考虑以下元素字体选择混合使用不同大小的字体突出重点颜色搭配选择对比度高但不刺眼的配色方案布局设计合理利用屏幕空间避免拥挤动态效果添加秒针动画或日期滚动效果下面是一个改进后的显示函数void drawClockFace() { // 绘制时钟背景 tft.fillScreen(TFT_BLACK); tft.drawRoundRect(5, 5, 118, 150, 10, TFT_NAVY); tft.fillRoundRect(7, 7, 114, 146, 8, TFT_DARKGREY); // 绘制刻度 for (int i 0; i 12; i) { float angle i * PI / 6; int x1 64 50 * sin(angle); int y1 80 - 50 * cos(angle); int x2 64 45 * sin(angle); int y2 80 - 45 * cos(angle); tft.drawLine(x1, y1, x2, y2, TFT_WHITE); } } void updateClock() { struct tm timeinfo; getLocalTime(timeinfo); // 显示时间 char timeStr[9]; strftime(timeStr, sizeof(timeStr), %H:%M:%S, timeinfo); tft.setTextColor(TFT_CYAN, TFT_DARKGREY); tft.drawString(timeStr, 15, 30, 4); // 显示日期 char dateStr[20]; strftime(dateStr, sizeof(dateStr), %a, %d %b %Y, timeinfo); tft.setTextColor(TFT_YELLOW, TFT_DARKGREY); tft.drawString(dateStr, 10, 120, 2); // 绘制秒针动画 static int prevSecond -1; if (timeinfo.tm_sec ! prevSecond) { // 清除旧秒针 float oldAngle prevSecond * PI / 30 - PI/2; int xOld 64 40 * cos(oldAngle); int yOld 80 40 * sin(oldAngle); tft.drawLine(64, 80, xOld, yOld, TFT_DARKGREY); // 绘制新秒针 float angle timeinfo.tm_sec * PI / 30 - PI/2; int x 64 40 * cos(angle); int y 80 40 * sin(angle); tft.drawLine(64, 80, x, y, TFT_RED); prevSecond timeinfo.tm_sec; } }3.2 添加温度显示功能许多ESP32开发板内置温度传感器我们可以利用它显示环境温度#ifdef __cplusplus extern C { #endif uint8_t temprature_sens_read(); #ifdef __cplusplus } #endif void displayTemperature() { float temp (temprature_sens_read() - 32) / 1.8; // 转换为摄氏度 char tempStr[10]; sprintf(tempStr, %.1f C, temp); tft.setTextColor(TFT_GREEN, TFT_DARKGREY); tft.drawString(tempStr, 20, 100, 2); }4. 低功耗优化与自动亮度调节4.1 实现自动亮度调节通过光敏电阻或环境光传感器实现自动亮度#define LIGHT_SENSOR_PIN 34 // 光敏电阻连接引脚 void adjustBrightness() { int lightValue analogRead(LIGHT_SENSOR_PIN); int brightness map(lightValue, 0, 4095, 10, 255); // 注意ST7735没有直接调节背光的功能这里需要PWM控制背光LED ledcWrite(0, brightness); // 使用LEDC通道控制背光 } void setup() { // 配置PWM通道用于背光控制 ledcSetup(0, 5000, 8); // 通道0, 5kHz, 8位分辨率 ledcAttachPin(27, 0); // 假设背光控制接在GPIO27 // ...其他初始化代码 }4.2 低功耗模式实现对于电池供电的应用低功耗设计至关重要void enterLowPowerMode() { // 夜间模式(23:00-6:00)降低刷新率 struct tm timeinfo; getLocalTime(timeinfo); if (timeinfo.tm_hour 23 || timeinfo.tm_hour 6) { // 每小时只刷新一次时间 static int lastHour -1; if (timeinfo.tm_hour ! lastHour) { updateClock(); lastHour timeinfo.tm_hour; } // 关闭WiFi以节省电量 WiFi.disconnect(true); WiFi.mode(WIFI_OFF); // 降低CPU频率 setCpuFrequencyMhz(80); } else { // 正常模式 setCpuFrequencyMhz(240); if (WiFi.status() ! WL_CONNECTED) { WiFi.begin(ssid, password); } } }5. 完整项目代码与进阶扩展5.1 完整时钟项目代码将前面所有功能整合成一个完整的项目#include TFT_eSPI.h #include WiFi.h #include time.h #include esp_sleep.h TFT_eSPI tft TFT_eSPI(); // WiFi配置 const char* ssid your_SSID; const char* password your_PASSWORD; void setup() { Serial.begin(115200); // 初始化显示屏 tft.init(); tft.setRotation(1); tft.fillScreen(TFT_BLACK); // 连接WiFi WiFi.begin(ssid, password); tft.setTextColor(TFT_WHITE); tft.drawString(Connecting WiFi..., 10, 10, 2); while (WiFi.status() ! WL_CONNECTED) { delay(500); Serial.print(.); } // 配置NTP configTime(8 * 3600, 0, pool.ntp.org, time.nist.gov); // 初始化时钟界面 drawClockFace(); // 配置背光PWM ledcSetup(0, 5000, 8); ledcAttachPin(27, 0); ledcWrite(0, 128); } void loop() { adjustBrightness(); updateClock(); displayTemperature(); enterLowPowerMode(); // 控制刷新率 static unsigned long lastUpdate 0; if (millis() - lastUpdate 200) { // 每秒刷新5次 lastUpdate millis(); // 其他需要频繁更新的内容... } delay(50); // 短暂延迟减少CPU负载 } // 前面定义的所有功能函数...5.2 进阶功能扩展思路天气信息显示通过API获取实时天气数据显示温度、湿度、天气图标多时区支持添加按钮切换不同时区同时显示多个时区时间闹钟功能设置多个闹钟添加振动马达或蜂鸣器提醒OTA更新实现无线固件更新无需连接电脑即可升级功能语音控制集成语音识别模块通过语音命令设置闹钟或查询信息// 示例添加简单的闹钟功能 struct Alarm { uint8_t hour; uint8_t minute; bool enabled; }; Alarm alarms[3]; // 支持3个闹钟 void checkAlarms() { struct tm timeinfo; getLocalTime(timeinfo); for (int i 0; i 3; i) { if (alarms[i].enabled alarms[i].hour timeinfo.tm_hour alarms[i].minute timeinfo.tm_min timeinfo.tm_sec 0) { triggerAlarm(); break; } } } void triggerAlarm() { // 闪烁屏幕和触发蜂鸣器 for (int i 0; i 10; i) { tft.invertDisplay(true); digitalWrite(BUZZER_PIN, HIGH); delay(200); tft.invertDisplay(false); digitalWrite(BUZZER_PIN, LOW); delay(200); } }这个ESP32桌面时钟项目展示了如何将硬件驱动、网络通信、用户界面和电源管理等多个嵌入式开发概念融合到一个实用项目中。通过不断迭代和添加新功能你可以把它打造成一个真正个性化的智能设备。