如何将显示屏改造为一个紧凑型环境桌面仪表

概览

本项目将1.91英寸的LilyGO T-Display-S3 AMOLED显示屏改造为紧凑型环境桌面仪表。主页面显示当前本地时间，以及来自LTR390紫外线/环境光传感器和BH1750照度传感器的数据。专用详情页提供更大尺寸的读数和滚动历史图表，第四个页面则显示Wi-Fi网络及信号信息。

显示屏采用专为AMOLED面板设计的横向“夜灯”主题。按下BOOT按钮可切换浏览摘要、LTR390、BH1750和Wi-Fi页面。在支持触摸的开发板上，也可通过顶部的页面按钮进行操作。

时钟通过Wi-Fi使用NTP实现时间同步。时区配置采用POSIX时区字符串，马来西亚地区已预设MYT-8时区。

功能特点

• NTP同步本地时钟和日期

• LTR390原始紫外线计数、计算出的紫外线指数以及原始ALS读数

• 分离的滚动图表显示LTR390测量数据

• BH1750照度读数及全光谱照度历史记录

• Wi-Fi SSID、RSSI、信号强度计及信号历史

• 启动按钮和可选触摸屏页面导航

• 专为RM67162 AMOLED面板设计的横向界面，采用LVGL实现

接线说明

两个传感器共用同一根I2C总线：

• GPIO 3 → LTR390和BH1750的SDA

• GPIO 2 → LTR390和BH1750的SCL

• 3V3 → 两个传感器的VIN/3V3

• GND → 两个传感器的GND

LTR390使用地址0x53，BH1750通常使用0x23;若其ADDR引脚处于高电平，请将BH1750_ADDRESS设置为0x5C。

软件配置

固件使用PlatformIO与Arduino框架构建，依赖官方LilyGO AMOLED库、LVGL 8.4、Adafruit LTR390库1.1.2以及BH1750库1.3.0。

1. 下载附带的源文件存档。

2. 将 include/secrets.example.h 复制到 include/secrets.h 中。

3. 添加您的Wi-Fi SSID和密码，并确认POSIX时区。

4. 通过USB-C连接主板。

5. 构建并上传 lilygo-amoled PlatformIO 环境。

6. 以115200波特率打开串行监视器进行诊断。

已验证的版本使用了约14.7%的RAM和36.1%的配置应用闪存。

工作原理

在启动时，ESP32-S3会初始化RM67162 AMOLED面板，并创建四个LVGL页面。两个传感器共享一个I2C总线。BH1750保持在持续高分辨率模式下，而LTR390则在环境光模式和紫外模式之间交替切换，每次测量之间有较短的稳定间隔。每个采样值都会根据其在屏幕上的读数进行归一化处理，并附加到一个48点滚动图表中。

Wi-Fi重连逻辑不会阻塞接口。一旦连接成功，ESP32的时间服务将与pool.ntp.org或time.nist.gov同步，并应用配置的POSIX时区。LVGL定时器继续运行，同时通过millis()函数调度传感器、时钟、按钮和网络更新。

测试

上传完成后，板子能成功初始化AMOLED显示屏，连接Wi-Fi，同步时钟，并读取两个I2C传感器的数据。可通过BOOT按钮循环切换Summary、LTR390、BH1750和Wi-Fi页面。

故障排除

• 如果上传失败，请使用支持数据传输的USB-C数据线。按住 BOOT 键，点击 RESET，然后重试以进入 ROM 启动加载程序。

• 如果传感器离线，请检查 3.3 V、地线、SDA/SCL 以及所选的 BH1750 地址。

• 如果时钟显示为空白，请检查 Wi-Fi 密码、网络连接以及时区字符串。

• 屏幕空白或损坏通常表示选择了错误的 LilyGO AMOLED 型号;此固件专门针对 1.91 英寸板型。

注意事项

本项目针对 1.91 英寸 LilyGO AMOLED 型号，并明确调用 beginAMOLED_191() 函数。它需要配置为 ESP32-S3 的 16 MB Flash 和 OPI PSRAM。源代码和文档均采用 MIT 许可证发布;依赖项保留各自的许可证。

本文编译自hackster.io