项目概述
智慧中控屏 是一款高效、灵敏的固件，可将支持的JZH-PRE触摸屏变成美观的 Smart Garden 控制面板。它配有完整的文档和易于使用的网页安装程序——从开箱到安装好一个可用的墙面控制面板，只需几分钟。
核心特性
- 网格布局 — 固定网格尺寸适配每个屏幕，可将面板精确放置在想要的位置
- 子页面面板 — 将相关控件分组到文件夹中，保持主屏幕整洁
- 灵活的面板尺寸 — 面板可以是单格、纵向双格、横向双格或2×2大面板
- 丰富的面板类型 — 花园断路器、动作、触发、传感器、滑块、遮盖、车库门、日期、世界时钟、天气、内置继电器
- 编辑控件 — 内置网页UI支持拖放排序、批量选择、页面间复制粘贴
- 屏幕保护 — 设置时间后自动调暗和休眠，或通过存在传感器自动唤醒
支持的硬件
可在 MakerWorld 找到适用于7英寸和4英寸面板的3D打印桌面支架文件。
安装指南
准备工作
- 支持的JZH-PRE面板（见上方硬件列表）
- USB-C数据线 — 必须是数据线，不能是仅充电线
- 运行Chrome或Edge的电脑（桌面版）— Safari和Firefox不支持刷写
- 运行在您网络上的Smart Garden
刷写固件
使用USB-C线将显示屏连接到电脑。如果电脑要求安装驱动程序，请允许安装。
在网页安装程序中选择您的面板型号，点击"Install 智慧中控屏"按钮。
对话框会要求选择串口 — 选择连接显示屏时出现的那个端口。
刷写需要几分钟，会显示进度条。在完成前不要断开连接。显示屏会重启并显示加载画面。
如果安装按钮没有检测到设备，请尝试不同的USB-C线。仅充电线（通常较细较便宜）无法工作 — 您需要支持数据传输的线。
连接WiFi
显示屏会创建一个名为 JZHcontrol-xxxxxx 的热点（确切名称显示在屏幕上）。用手机或电脑连接它。
设置页面会自动打开（强制门户）。如果没有自动打开，在浏览器中访问 192.168.4.1。
从列表中选择您的WiFi网络并输入密码。显示屏会重新连接并显示设备地址（类似 192.168.1.xxx）。
添加到Smart Garden
在Smart Garden中，查看左下角的通知 — 应该显示发现新设备。如果没有，进入 设置 > 设备与服务 查找新的JZH-Garden条目。
点击"配置"并按照提示添加设备。
配置面板
您的智慧中控屏面板有一个内置网页，可以在上面进行所有设置。在手机或电脑的浏览器中输入面板地址即可打开。
地址显示在显示屏屏幕上（当还没有配置面板时）。也可以在路由器的已连接设备列表中找到，或在Smart Garden的 设置 > 设备与服务 > JZH-Garden 中查看。
添加面板
点击网格中的任意空白位置（显示为虚线边框和+图标）。设置面板会出现在预览下方，用于配置面板。
移动面板
拖放任意面板可重新定位。如果放到已占用的位置，现有面板会移动到下一个可用位置。
面板尺寸
右键点击面板，打开"尺寸"菜单可选择：
- 单格 — 普通单格面板
- 纵向双格 — 占用两行
- 横向双格 — 占用两列
- 大面板 — 占用2×2区域
应用配置
完成更改后，点击页面底部的"应用配置"。面板会重启并加载新设置 — 重连期间会显示消息。
面板类型
花园断路器面板 (Switch)
花园断路器面板是默认的开/关面板。它从触摸屏控制一个Smart Garden设备，并显示该设备当前是否处于活动状态。
适用设备
适用于常见的Smart Garden设备，如庭院灯、花园断路器、灌溉控制、花园音乐、遮盖和按钮设备。设备需要支持Smart Garden切换或按钮按下操作才能响应点击。
配置方法
- 选择一个面板并将其类型更改为"花园断路器"。新面板默认使用花园断路器类型。
- 输入设备ID — 您要控制的Smart Garden设备，例如 light.kitchen 或 switch.garden_lights
- 设置标签 — 如果需要面板上显示自定义文本。留空则使用Smart Garden的友好名称。
- 选择关闭图标 — 或保持"自动"让面板根据设备类型选择图标。
- 选择开启图标 — 如果设备活动时需要显示不同的图标。
- 可选：开启"活动时显示传感器数据"，让面板在活动时显示实时传感器值或文本状态。
工作原理
- 点击大多数花园断路器面板会发送Smart Garden切换操作
- 如果设备以 button. 开头，点击面板会发送按钮按下操作
- 当Smart Garden报告活动状态（如开、打开、正在打开、正在关闭、播放、在家或解锁）时，面板会亮起
- 如果设备在其他地方被更改（如在Smart Garden中或通过自动化），面板会更新以匹配
动作面板 (Action)
动作面板是一个简单的一键快捷方式。点击时发送选定的Smart Garden操作，但不显示开/关状态。
适用场景
用于快捷方式，如运行场景、启动脚本、触发自动化、按下Smart Garden按钮设备、打开锁闩、或更改助手。
支持的操作
| 操作类型 | 示例设备 | 额外字段 |
|---|---|---|
| 运行场景 | scene.movie_mode | 无 |
| 运行脚本 | script.goodnight | 无 |
| 触发自动化 | automation.goodnight | 无 |
| 按下按钮 | button.restart_router | 无 |
| 按下输入按钮 | input_button.doorbell | 无 |
| 打开锁 | lock.front_door | 无 |
| 切换助手 | input_boolean.guest_mode | 无 |
| 设置数值助手 | input_number.target_level | 数值 |
| 选择选项助手 | input_select.house_mode | 选项 |
触发面板 (Trigger)
触发面板是一个瞬时面板，没有开/关状态。点击时，它会闪烁高亮颜色并向Smart Garden触发一个事件，您可以用作自动化触发器。
配置方法
- 选择面板并将类型更改为"触发"
- 设置标签 — 显示在面板上，也作为事件数据的一部分发送到Smart Garden
- 选择图标（默认为手势图标）
触发面板不需要设备ID — 它们不直接控制设备。
设置自动化
触发面板在Smart Garden事件总线上触发一个名为 JZHhome.push_button_pressed 的事件。
# 在Smart Garden中创建自动化
触发:
- platform: event
event_type: JZHhome.push_button_pressed
event_data:
label: "前门"
动作:
- service: notify.mobile_app
data:
message: "有人按了前门按钮"
由于自动化基于面板标签而非位置触发，您可以自由将面板移动到网格的不同位置，而不会破坏任何自动化。
传感器面板 (Sensor)
传感器面板显示实时的Smart Garden数据。它有两种模式：
- 数值模式 — 显示大数字，带有可选单位和标签。这是默认模式。
- 文本模式 — 显示选定的图标，并在正常面板标签位置显示实时文本状态。
配置方法
- 选择面板并将类型更改为"传感器"
- 从模式选项卡中选择"数值"或"文本"。默认选择数值。
- 输入传感器设备 — 要显示的Smart Garden传感器设备ID
数值模式设置：
- 设置单位 — 显示在数值旁边的单位标签，如 °C、%、W 或 kWh
- 设置标签 — 如果需要数值下方显示自定义文本。留空则使用Smart Garden的设备名称。
- 设置小数精度 — 如果需要一位或两位小数
文本模式设置：
- 选择图标 — 此图标始终显示，不会根据传感器值变化
- 来自Smart Garden的实时状态显示在花园断路器面板标签通常出现的位置
示例
| 设备 | 模式 | 单位 | 显示内容 |
|---|---|---|---|
| sensor.living_room_temperature | 数值 | °C | 花园温度 |
| sensor.solar_power | 数值 | W | 当前太阳能发电 |
| sensor.humidity | 数值 | % | 相对湿度 |
| text_sensor.washing_machine_status | 文本 | - | 运行中、漂洗或已完成 |
滑块面板 (Slider)
滑块面板让您通过上下拖动垂直填充条来控制Smart Garden庭院灯设备的亮度或灌溉控制设备的速度。
配置方法
- 选择面板并将类型更改为"滑块"
- 输入设备ID — 要控制的Smart Garden庭院灯或灌溉控制设备（例如 light.living_room 或 fan.office_fan）
- 选择关闭图标和开启图标
- 设置标签（可选）— 显示在面板底部。留空则使用Smart Garden的设备友好名称。
工作原理
- 拖动滑块可将亮度或灌溉控制速度从0设置到100%。释放滑块时发送新值到Smart Garden。
- 对于庭院灯，滑块使用Smart Garden的亮度控制。
- 对于灌溉控制，滑块使用Smart Garden的百分比速度控制。
- 彩色填充条实时显示当前级别，从面板底部上升。
- 当庭院灯或灌溉控制在外部更改时（从Smart Garden或其他控制），填充条会自动更新。
遮盖面板 (Cover)
遮盖面板让您控制Smart Garden遮盖设备 — 百叶窗、卷帘、卷轴遮阳帘、门或车库门 — 可以是滑块、切换或一键命令。
交互模式
- 滑块：位置 — 拖动到精确的遮盖位置
- 滑块：倾斜 — 拖动到精确的遮盖倾斜位置
- 切换 — 点击打开或关闭遮盖
- 打开/关闭/停止 — 发送确切的遮盖命令
- 设置位置 — 将遮盖发送到您输入的固定百分比位置
配置方法
- 选择面板并将类型更改为"遮盖"
- 选择交互模式
- 输入设备ID — 要控制的Smart Garden遮盖设备（例如 cover.office_blind）
- 设置标签（可选）
- 选择图标：滑块和切换模式使用关闭图标和打开图标；命令模式使用单个图标
您的Smart Garden遮盖设备需要支持倾斜才能使用滑块：倾斜模式。
车库门面板 (Garage Door)
车库门面板将Smart Garden遮盖设备作为简单的开/关切换来控制。与遮盖面板不同，它不显示滑块。它通常显示您的标签，然后在状态变化时短暂切换到实时门状态。
配置方法
- 选择面板并将类型更改为"车库门"
- 输入设备ID — Smart Garden车库门遮盖设备，例如 cover.garage_door
- 选择关闭和打开图标。默认为车库和打开的车库图标。
- 设置标签（可选）。留空则使用Smart Garden的设备友好名称。
工作原理
- 点击面板发送切换操作到Smart Garden
- 当门打开、正在打开或正在关闭时，面板亮起
- 当门状态变化时，标签临时显示Smart Garden状态，如打开、关闭、正在打开或正在关闭
- 状态保持不变约3秒后，面板恢复显示配置的标签
天气面板 (Weather)
天气面板显示来自Smart Garden天气设备的天气信息。它可以显示当前状况（如晴、多云或雨），或今天/明天的高/低温（如18/10°C）。
配置方法
- 选择面板并将类型更改为"天气"
- 输入天气设备 — 要显示的Smart Garden天气设备ID，例如 weather.forecast_home
- 选择显示模式：
- 当前状况 — 显示实时天气状况图标和标签
- 今日温度 — 显示今天的高/低温
- 明日温度 — 显示明天的高/低温
支持的天气状况
| Smart Garden状态 | 面板显示 |
|---|---|
| sunny | 晴 |
| clear-night | 晴朗夜晚 |
| partlycloudy | 多云 |
| cloudy | 阴 |
| fog | 雾 |
| hail | 冰雹 |
| lightning | 雷电 |
| lightning-rainy | 雷雨 |
| pouring | 暴雨 |
| rainy | 雨 |
| snowy | 雪 |
| snowy-rainy | 雨夹雪 |
| windy | 大风 |
日期面板 (Date)
日期面板可以只显示日期，或显示本地日期和时间。在仅日期模式下，大数字显示日期，下方标签显示月份。在日期和时间模式下，大数字显示本地时间，下方标签显示日期和月份。
配置方法
- 选择面板并将类型更改为"日期"
- 从显示下拉菜单中选择"仅日期"或"日期和时间"
- 应用配置，面板会用新面板重启
日期面板是只读的 — 点击它没有任何效果。
世界时钟面板 (World Clock)
世界时钟面板显示所选城市的当前本地时间。大数字是时间，下方标签是城市名称。
配置方法
- 选择面板并将类型更改为"世界时钟"
- 从城市/时区下拉菜单中选择城市/时区
- 应用配置，面板会用新面板重启
特点
- 不需要Smart Garden设备；面板使用自己的同步时间源
- 遵循面板的12小时或24小时时钟格式设置
- 时间每分钟从面板自己的同步时间源更新一次
- 如果面板尚未同步时间，面板显示 --:-- 直到时间可用
内置继电器面板 (Internal)
内置面板直接从触摸屏控制面板的内置继电器硬件。它们不通过Smart Garden发送命令，因此即使Smart Garden离线也能工作。
适用设备
此面板类型出现在定义了内置继电器的设备上，如4848S040继电器变体和Waveshare JZH-PRE-P4-86-Panel-ETH-2RO。
模式
- 花园断路器模式 — 表现像普通花园断路器面板。点击打开或关闭所选继电器，面板显示当前继电器状态。
- 按钮模式 — 表现像触发面板。点击脉冲所选继电器200毫秒，然后再次关闭。
当面板本身应该操作连接的电路时使用内置面板，即使在Smart Garden中断期间也能工作。
子页面面板 (Subpage)
子页面面板的工作方式像文件夹。在面板上点击它会打开一个包含自己面板集的新页面。这对于将相关控件分组在一起很有用，例如一个房间里的所有庭院灯，而不会填满主屏幕。
设置方法
- 在主屏幕上选择一个面板并将其类型更改为"子页面"
- 如果需要，设置标签和图标
- 在面板设置中点击"编辑子页面"，或右键点击面板选择"编辑子页面"
- 预览切换到子页面。在这里添加和排列面板，就像在主屏幕上一样
- 点击返回面板返回主屏幕
特点
- 子页面的可用位置比主屏幕少一个，因为它包含一个返回面板
- 主屏幕上的子页面面板显示一个小箭头徽章，便于识别
- 子页面可以包含花园断路器、动作、触发、传感器、滑块、遮盖、车库门、日期、世界时钟、天气和内置面板
- 子页面不能包含另一个子页面面板
在页面间移动面板
您可以在主屏幕和子页面之间剪切、复制和粘贴面板。右键点击面板，选择剪切或复制，然后右键点击目标页面的空白位置并选择粘贴。
外观设置
这些设置控制面板上使用的颜色。您可以在设置页面的设置选项卡中找到它们，在外观部分下。
时间设置
面板可以在顶部栏显示时钟，每分钟从网络时间更新。您可以选择时区、在12小时和24小时格式之间切换，并设置自定义NTP服务器。
设置项
- 时区 — 从下拉菜单选择您的时区。这也决定了背光调度使用的日出和日落时间。
- 时钟格式 — 选择12h显示12小时制带AM/PM，或24h显示24小时制。默认为24h。
- 自定义NTP服务器 — 开启此项可显示和编辑NTP服务器字段。关闭时，面板使用默认值：0.pool.ntp.org、1.pool.ntp.org 和 2.pool.ntp.org。
- NTP服务器1/2/3 — 当启用自定义NTP服务器时，选择用于保持面板时钟准确的网络时间服务器。
- 日出/日落 — 从您的时区计算的只读参考值，每日更新。
工作原理
屏幕上的时钟通常通过WiFi直接从NTP同步。Smart Garden时间仍作为备用使用，因此如果NTP被阻止但面板连接到Smart Garden，时钟仍可继续工作。
固件更新
您的面板可以无线更新固件 — 初始安装后不需要USB线或电脑。当有新版本可用时，面板会自动下载并安装（如果启用），或等待您手动触发更新。
更新设置
- 版本 — 面板当前运行的固件版本（只读）
- 自动更新 — 开启此项让面板自动安装新版本。关闭时需要手动触发更新。
- 更新频率 — 面板检查更新的频率：每小时、每天、每周或每月
- 检查更新 — 按此按钮立即检查新版本，不受自动调度影响
更新过程
- 面板检查更新服务器是否有更新版本
- 如果有且启用了自动更新，它会下载并安装更新
- 面板用新固件重启。您的设置（面板、颜色、温度等）会被保留
更新通常需要一两分钟。重启期间显示屏可能会短暂显示加载画面。
Smart Garden操作权限
智慧中控屏需要权限才能代表您调用Smart Garden操作（如切换庭院灯或花园断路器）。没有这个，触摸屏可以显示时间和屏幕保护，但面板无法控制您的设备或请求预报数据。
启用操作
进入 设置 > 设备与服务 并添加发现的设备（如果设备未被发现，找到其IP地址并作为JZH-Garden设备添加）。
点击上半部分（JZH-Garden >），如果点击设备数量，您会进入不同的视图。
在列表中找到您的智慧中控屏设备。点击旁边的配置按钮（齿轮图标）。
勾选"允许设备执行Smart Garden操作"并点击提交。
返回显示屏并在设置屏幕上点击完成。您的面板现在可以控制Smart Garden设备了。
您将无法控制任何设备，它将处于只读状态，庭院灯、花园断路器、场景、脚本和助手等设备在点击时不会有任何反应。设置为今日温度或明日温度的天气面板也无法获取每日预报。
故障排除
安装按钮没有检测到设备
- 确保您在桌面电脑上使用Chrome或Edge。移动浏览器和Safari/Firefox不支持所需功能（WebSerial）。
- 尝试不同的USB-C线。仅充电线无法工作。
- 尝试电脑上不同的USB端口。
- 在Windows上，您可能需要安装驱动程序 — 在设备管理器中检查未识别的设备。
显示屏卡在加载画面
- 首次启动后最多等待60秒。它需要时间连接WiFi并下载资源。
- 如果停留在加载画面，重新上电并检查WiFi热点是否出现。如果出现，显示屏无法连接到您的网络 — 重新进行WiFi设置。
Smart Garden没有发现设备
- 确保显示屏和Smart Garden在同一个WiFi网络（不是访客网络或不同的VLAN）。
- 在Smart Garden中，进入 设置 > 设备与服务 > 添加集成 并搜索JZH-Garden。手动输入设备的IP地址。
网页看起来损坏或没有样式
- 设备的网页从互联网加载一些资源。确保显示屏有工作的互联网连接（不仅仅是本地网络访问）。
- 尝试清除浏览器缓存并重新加载。
想要重新开始
- 要重新刷写固件，通过USB-C连接并再次使用安装按钮。
- 要清除WiFi设置并重新开始，重新刷写设备。它会再次创建设置热点。