跳到主要内容

ESP32-Dashboard 墨水屏仪表盘

ESP32-Dashboard 是一款运行在 ESP32 上的墨水屏仪表盘固件,当前版本包含多个成品页面(天气、时间轴、世界时钟、专注时钟等),天气数据由免费的 Open-Meteo API 提供——无需 API Key,无需注册账号。

  • 固件仓库:RockBase-iot/ESP32-Dashboard(含中文版 README_cn.md)
  • 开发框架:PlatformIO + Arduino(espressif32 @ 6.13.0)
  • 适配硬件:NM-EPD-420 等 ESP32 + 墨水屏组合

项目愿景是做一块真正的 "Dashboard for anything" 墨水屏,路线图还包括加密货币价格、股市数据、本地 IoT 设备监控等。

页面一览​

页面 ID名称内容
P0标准页时间与核心信息总览
P1今日天气当前温度、体感、风、湿度、气压、能见度、紫外线指数
P2今日概览当日综合信息
P4每周时间轴一周日程时间轴
P5月度概览月视图
P6每周天气5 日天气预报(WMO 天气图标)
P7世界时钟多时区时钟
P8专注时钟番茄钟式专注计时,可独立配置时长

另有逐小时温度趋势线 + 未来 12 小时降水概率柱状图,以及基于板载 AHT20 / BME280 传感器的室内温湿度显示、美标 AQI 与 PM2.5 浓度。

功能特性​

  • 免 Key 天气数据源:Open-Meteo 天气 + 空气质量,免费、无需账号
  • 低功耗设计:更新间隔可配置(默认 30 分钟),间隔期间深度睡眠;支持就寝/起床时间窗,夜间不刷屏
  • AP 配网模式:长按 Boot 键进入热点配网,首次配置无需 App
  • 浏览器配置门户:WiFi、位置、单位、时区、睡眠间隔均在网页端完成;新版菜单分 device / pages / data-source 三组
  • 开机配置窗口:每次 WiFi 连接后 Web 门户在设备 IP 上保持可达(PortalSec 默认 30 秒,设为 0 可关闭以最大化省电)
  • 多语言界面:en_US、zh_CN
  • 可配置单位:°C/°F、km/h/m/s/mph/kn、hPa/inHg/mmHg、km/mi、mm/in
  • 三色支持:在兼容面板上启用红/黑/白三色强调色
  • 四色面板支持:NM-EPD-420-4C(4.2 英寸黑/白/红/黄四色屏,GDEY0420F51),使用 PlatformIO 环境 nm-epd-420-4c;黄色通道目前预留给 Home 页面 UI
  • Home 主题:新增三个 HomeWeatherTheme 主题——HOME-RHYTHM、HOME-ATLAS、HOME-PRINT,配合四色面板的 Home 页面使用
  • 日历同步:支持 Google Calendar ICS 数据源(见下文)
  • SNTP 时间同步:UTC 偏移可配置

日历数据源配置​

自 v1.0.0 起,仪表盘可通过 ICS 订阅同步日历事件:

  1. 在 Google 日历中打开对应日历的设置,复制其 私密 iCal(ICS)地址。
  2. 在设备 Web 配置门户中打开 data-source 菜单,将 ICS URL 填入日历数据源字段。
  3. 日历相关页面将在下次刷新时显示订阅中的日程。

webcal:// 链接会自动转换为 HTTPS。Outlook 日历和 Apple 日历的 ICS 订阅走同一机制,但在当前版本中尚未充分测试。

快速上手​

  1. 通过 Web Flasher 烧录固件,或克隆仓库用 PlatformIO 编译
  2. 长按 Boot 键进入 AP 配网模式,连接设备热点完成 Wi-Fi 与位置设置
  3. 之后可通过浏览器访问设备 IP 随时调整页面与数据源配置
与 NM-EPD-420 配套部署指南

针对 NM-EPD-420 的接线、编译与烧录步骤,见 NM-EPD-420 部署 ESP32-Dashboard。