Display Actions

Synchronized Device Documentation

This page corresponds to the synchronized Chinese source. Commands, JSON examples, API paths, field names, and screenshots are kept aligned with the Chinese device-side source documentation.

What This Page Covers

• Display Actions context and expected reader workflow.
• Configuration, verification, and release-readiness details.
• Source-aligned implementation notes, screenshots, and troubleshooting references.

Source Reference

The detailed operational source is preserved below so implementation details stay exact while the English navigation, titles, and reading path remain available.

显示屏动作

动作类型

动作	actionType	说明
ACTION_DISPLAY_NUMBER	24	显示数字
ACTION_DISPLAY_TEXT	25	显示文本
ACTION_DISPLAY_CLEAR	26	清屏
ACTION_OLED_DISPLAY	27	OLED 多行模板显示

配置示例

方式1：Web界面配置（推荐）

外设执行页面如下。显示动作配置时重点核对目标显示外设、显示内容模板和刷新频率。

显示输出管道

显示动作排查时按管道图分层处理：数据源是否存在、模板是否能解析、目标显示外设是否在线、刷新频率是否过高。

示例1：显示数字（TM1637数码管）

场景：在数码管上显示温度值23.5

配置步骤：

1. 在外设执行管理页面编辑规则

2. 点击 添加动作 按钮

3. 填写动作配置：

   字段	填写内容	说明
   动作类型	选择 显示数字	数字显示
   目标外设	选择 tm1637_1	数码管外设
   显示值	23.5	要显示的数字

4. 点击 保存 按钮

💡 提示：支持格式：1234（整数）、12.34（小数）、12:34（时钟）

---

示例2：显示文本

场景：在数码管上显示“PLAY”

配置步骤：

1. 编辑规则，添加动作

2. 填写：

   • 动作类型：选择 显示文本
   • 目标外设：选择 tm1637_1
   • 显示文本：PLAY

3. 点击 保存

💡 提示：TM1637仅支持有限字符集，超长内容自动截断

---

示例3：清屏

场景：清除数码管或OLED显示内容

配置步骤：

1. 编辑规则，添加动作

2. 填写：

   • 动作类型：选择 清屏
   • 目标外设：选择 tm1637_1 或 oled1

3. 点击 保存

---

示例4：OLED 多行模板显示

场景：在OLED上显示环境监测数据

配置步骤：

1. 编辑规则，添加动作

2. 填写：

   • 动作类型：选择 OLED显示
   • 目标外设：选择 oled1
   • 显示模板：

   #环境监测
   温度: ${dht1.temperature}°C
   湿度: ${dht1.humidity}%
   IP: ${sys.ip}

3. 点击 保存

💡 提示：

• 首行以 # 开头为居中标题
• ${id.field} 引用传感器缓存数据
• $value 引用触发时的接收值
• \n 为换行符

---

方式2：JSON配置文件导入

适用外设

动作	适用外设
DISPLAY_NUMBER	TM1637(47), LCD(36)
DISPLAY_TEXT	TM1637(47), LCD(36)
DISPLAY_CLEAR	TM1637(47), LCD(36)
OLED_DISPLAY	LCD(36) - 仅 OLED

注意事项

1. TM1637 限制：仅 4 位显示，超长内容自动截断
2. OLED 行数：128x64 约显示 4-6 行，超出部分不显示
3. 缓存依赖：${id.field} 引用的数据需要先通过 SENSOR_READ 采集
4. 刷新频率：建议 OLED 刷新间隔 ≥1 秒