如何看懂 Tessera 的 OTA 更新机制：ESP32 触摸屏夜间 Wi-Fi 自动更新固件完整指南

【免费下载链接】homeassistant_espscreenTessera: beautiful, easy touch screens for Home Assistant on affordable ESP32 panels, 2.8 to 10.1 inch (CYD, Guition, Waveshare). Drag-and-drop editor, no YAML, no MQTT.项目地址https://gitcode.com/gh_mirrors/ho/homeassistant_espscreen点击查看免费下载Tesserahomeassistant_espscreen把廉价的 ESP32 触摸面板变成 Home Assistant 里漂亮易用的屏幕。它的 OTA 更新机制会让所有屏幕在凌晨通过 Wi-Fi 自动下载并安装最新固件——不用 USB 线、不用手动烧录。本文带你完整看懂这套夜间自动更新的工作原理什么时候触发、更新哪些屏幕、每一步在做什么以及万一失败时系统如何保护你的屏幕不变砖。夜间自动更新什么时候触发Tessera 的管理插件screen_manager内置一个每分钟唤醒一次的检查循环。它会在本地时间凌晨 3:00 至 5:59之间尝试发起一轮更新这个时间窗定义在 screen_manager/app/updates.py 的NIGHT_HOURS中——选择凌晨是因为这段时间你几乎不会去操作屏幕更新造成的短暂离线不会影响使用。一轮更新要真正开始必须同时满足三个条件updates.py 中的due()判断你在 Tessera 的Settings里开启了自动更新开关当前时间落在凌晨 3–5 点窗口内今天还没有跑过一轮——每跑一轮就记录当天日期重启插件也不会重复更新。为什么放在凌晨、又是逐台更新因为固件更新期间屏幕会短暂离线、重启凌晨的静默时段是对家庭用户打扰最小的时刻。哪些屏幕会被更新只更新真正需要的插件并不是对每块屏幕盲目重刷固件。它会先算出每台屏幕的目标固件版本版本跟随插件自身的发布节奏详见 docs/RELEASING.md再筛出待更新的屏幕条件包括屏幕当前在线屏幕上运行的固件版本低于目标版本或者屏幕显示语言与 Settings → Language region 里选择的语言不一致语言变了也要重新编译安装插件能找到它的配置文件和 IP 地址且它还没有排进构建队列。已经跑着最新固件的屏幕会被直接跳过所以夜间更新只会挑有更新的任务不会无谓地反复编译机制说明见 docs/BOARD_RELEASES.md 与 docs/BUILDS.md。更新一台屏幕的完整流程多台待更新屏幕会组成一个轮次Round一台接一台依次处理两台之间暂停约 2 分钟。每台屏幕的更新走同一条流水线updates.py 的update_one分三个阶段页面里也会实时显示当前阶段阶段做什么说明install编译固件并通过 Wi-Fi 安装编译约 1500 个源文件GitHub 每晚预编译好每块开发板的缓存ccache插件下载后复用所以夜间编译更快verify等待屏幕上报新固件版本每 5 秒轮询一次最长等 240 秒屏幕必须在线、版本达标且语言正确才算通过settle静置 60 秒再确认屏幕仍在线等待 ESPHome 的试用期保护窗口过去下一节详述三个步骤全部通过这次更新才记为成功。整个流程由统一的构建队列 screen_manager/app/build_queue.py 调度——全插件同一时间只编译一个固件夜间更新和你手动点的其他操作排队互不冲突。双槽分区更新失败也不会变砖ESP32 的闪存被分成app0 和 app1 两个更新槽位新固件写入空闲的槽位正在运行的固件原封不动。这意味着即使新固件本身有严重问题旧固件仍然完整保留。更关键的是试用期回滚ESPHome 的启动器会给新固件 1 分钟试用期如果屏幕在这 1 分钟内重启就会自动切回旧固件。这正是上面settle 阶段静置 60 秒的原因——熬过试用期更新才算真正落定。对于 4 MB 闪存的开发板CYD 等还有一层特殊处理这些板子使用自定义的宽分区表把每个槽位从 1,835,008 字节扩大到 2,031,616 字节分区文件见 components/flash_layout/partitions-4mb-wide.csv原理见 docs/FLASH_LAYOUT.md。如果新固件超出了旧分区表的容量插件会先装一个只有约三分之一槽位大小的桥梁固件packages/bridge.yaml通过它把宽分区表送进屏幕最后再安装真正的固件。这一过程由屏幕的Screen flash诊断传感器wide/widen/widen_next等状态驱动用户视角只需看 docs/UPDATING_4MB_SCREENS.md。屏幕在更新时显示了什么更新期间你会注意到屏幕活过来了这并非巧合唤醒固件在安装开始前会点亮背光、退出待机并关闭屏保由 packages/core.yaml 绑定避免你在一片黑屏前干等实时进度ESPHome 的 OTA 下载过程会占用主循环屏幕上的 LVGL 界面暂时画不动看起来像卡死。固件注册了一个 OTA 状态监听器components/smart_display/ota_status.h每秒左右收到一次下载进度并立刻把百分比画到玻璃上覆盖在一切内容之上结束时提示即将重启。所以对屏幕上的观众来说一次夜间更新看起来就是屏幕亮起 → 显示下载百分比 → 重启 → 几分钟后以新固件身份回到 Home Assistant。如何开启或关闭自动更新打开 Tessera 面板侧边栏的Settings找到夜间固件更新开关界面对应 web/src/components/AppSettingsView.vue 中的auto-update选项每台屏幕详情里的Update徽章会列出本次固件有什么新东西来自 CHANGELOG进行中的更新会实时显示进度不想要夜间动作时关掉开关即可随时也可以在屏幕页面手动点Update或点Update all立即执行同样一轮更新。更新失败会发生什么系统设计上非常保守坏结果永远止于本机一轮中的失败会终止整轮某台屏幕构建或安装失败时排在后面的屏幕本轮直接跳过skipped有问题的构建绝不会波及下一台屏幕持久通知自动轮次中途失败时插件会向 Home Assistant 发送一条 persistent notification告诉你哪台屏幕停了、原因是什么桥梁状态可恢复即使插件重启或断电导致桥梁流程中断状态会记在本地updates.json之后每隔 5 分钟自动从断点续做与夜间轮次无关失败后自动消隐如果屏幕后来通过别的方式跑上了目标固件旧失败记录就不再显示为新闻。相关文件速览想了解的内容去哪里看夜间轮次的触发、调度与重试screen_manager/app/updates.py统一构建队列与轮次规则screen_manager/app/build_queue.py、docs/BUILDS.md屏幕端 OTA 进度绘制components/smart_display/ota_status.h4 MB 板分区表与桥梁机制docs/FLASH_LAYOUT.md、docs/UPDATING_4MB_SCREENS.md固件版本与发布节奏docs/RELEASING.md、docs/BOARD_RELEASES.md日常使用与设置说明screen_manager/DOCS.md一句话总结Tessera 把给一排 ESP32 屏幕升级固件这件琐事压缩成开一个开关凌晨自动搞定——编译、下载、双槽安装、试用期验证、失败隔离全程无需你在场而屏幕上的进度条和 Home Assistant 的通知随时让你知道发生了什么。赞分享【免费下载链接】homeassistant_espscreenTessera: beautiful, easy touch screens for Home Assistant on affordable ESP32 panels, 2.8 to 10.1 inch (CYD, Guition, Waveshare). Drag-and-drop editor, no YAML, no MQTT.项目地址https://gitcode.com/gh_mirrors/ho/homeassistant_espscreen点击查看免费下载相关推荐xiaozhi-esp32固件升级OTA无线更新与版本管理机制xiaozhi esp32固件升级OTA无线更新与版本管理机制 还在为每次固件更新需要连接USB线、手动烧录而烦恼吗小智AI聊天机器人XiaoZhi AI人工智能AI 应用语音智能硬件物联网ESP32 BLE OTA更新终极完整指南快速实现无线固件升级ESP32 BLE OTA更新终极完整指南快速实现无线固件升级 本文为您详细介绍如何通过蓝牙低功耗 BLE 技术实现ESP32设备的无线固件更新 OTA 。E嵌入式物联网固件如何快速实现ESP8266/ESP32优雅OTA更新AsyncElegantOTA完整指南 如何快速实现ESP8266/ESP32优雅OTA更新AsyncElegantOTA完整指南 AsyncElegantOTA是一款专为ESP8266和ES上一篇backtesting.py量化回测从想法到图表下一篇NanoVG 从零跑通OpenGL上的抗锯齿向量渲染凭什么这么轻创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考