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

ESP32打造高颜值桌面时钟：从TFT_eSPI库到完整项目实战

在创客的世界里，将硬件与代码结合创造出实用又有趣的项目总是令人兴奋。今天我们要用ESP32开发板和1.8寸ST7735驱动的LCD屏幕，打造一个功能完善、界面美观的桌面电子时钟。这个项目不仅适合作为桌面摆件，更是学习嵌入式GUI开发的绝佳案例。

1. 项目准备与环境搭建

1.1 硬件清单

要完成这个项目，你需要准备以下硬件组件：

• ESP32开发板（推荐使用ESP32-WROOM-32）
• 1.8寸TFT LCD屏幕（ST7735驱动芯片）
• 杜邦线若干
• 面包板（可选，用于临时连接）
• USB数据线（用于供电和编程）

硬件连接示意图如下：

1.2 软件环境配置

首先确保你已经安装了Arduino IDE和ESP32开发板支持包。然后按照以下步骤配置TFT_eSPI库：

1. 通过Arduino库管理器安装TFT_eSPI库
2. 找到库目录下的User_Setup.h文件（通常位于Arduino/libraries/TFT_eSPI）
3. 修改配置文件以适配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 进阶功能扩展思路

1. 天气信息显示：

   • 通过API获取实时天气数据
   • 显示温度、湿度、天气图标

2. 多时区支持：

   • 添加按钮切换不同时区
   • 同时显示多个时区时间

3. 闹钟功能：

   • 设置多个闹钟
   • 添加振动马达或蜂鸣器提醒

4. OTA更新：

   • 实现无线固件更新
   • 无需连接电脑即可升级功能

5. 语音控制：

   • 集成语音识别模块
   • 通过语音命令设置闹钟或查询信息

// 示例：添加简单的闹钟功能 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桌面时钟项目展示了如何将硬件驱动、网络通信、用户界面和电源管理等多个嵌入式开发概念融合到一个实用项目中。通过不断迭代和添加新功能，你可以把它打造成一个真正个性化的智能设备。