1. 概述
地址标签为变量命名，例如 Temperature → LW1000，控件通过 $Temperature 引用。
点击“工程 → 地址标签”打开管理器：
| 分类 | 用途 | 管理方式 |
|---|---|---|
| 系统参数标签 | 页面、语言、背光、时间等系统功能 | 仅支持搜索和选择 |
| 用户自定义标签 | 温度、设备名称等工程变量 | 可新增、编辑、删除、导入和导出 |
标签表示变量的起始地址，数据类型由控件及通信配置决定。
2. 系统寄存器
选择“系统参数标签”，可按名称、地址或说明搜索，如 SysLang、SysKB、SysSnd。权限标记：R 只读、W 只写、RW 读写。
本节均为 LW 十六进制地址，位号从 bit0 开始。UINT32 占两个连续字，按 32 位读取；权限以系统标签为准。
2.1 常用配置
| 需要实现 | 地址 | 配置方法 |
|---|---|---|
| 切换页面 | LW0100 | 字设置按钮写入目标页面 ID |
| 切换中英文 | LW0119 | 本例写 0 为中文、1 为 English |
| 显示运行时间 | LW0116～LW0117 | UINT32，原值除以 100 得到秒 |
| 自动背光 | LW0120～LW0124 | 设置待机时间及两档亮度，再启用 LW0120.bit0 |
| 显示日期时间 | LW0170～LW0176 | 按年、月、日、星期、时、分、秒读取 |
| 调节音量 | LW0140 | 滑块读写，范围 0～100 |
| 显示输入范围 | LW01C1、LW01C0 | 显示下限、上限；LW01C4.bit1 控制可见性 |
2.2 页面与键盘
页面控制
| 地址 | 功能 | 说明 |
|---|---|---|
| LW0100 | 当前画面 | 切换或获取主画面 |
| LW0101 | 当前弹窗 | 切换或获取对话框画面 |
| LW0102 | 当前键盘 | 切换或获取键盘画面 |
| LW0103 | 输入控件 | 当前输入控件 ID |
| LW0104、LW0105 | 键盘位置 | X、Y；未指定时为 0xFFFF |
| LW0106 | 初始画面 | 开机初始页面 ID |
| LW0119 | 当前语言 | 工程中已配置的语言索引，从 0 开始 |
实际打开状态
| 地址 | 功能 | 无实例时的初值 |
|---|---|---|
| LW00FF | 已打开主画面 | 0xFFFF |
| LW00FE | 实际弹窗 | 0xFFFF |
| LW00FD | 实际键盘 | 0xFFFF |
| LW00FC | 键盘蒙版 | 0x00FF |
| LW00FB | 动画类型 | 按当前状态读取 |
键盘数据
| 地址 | 功能 | 说明 |
|---|---|---|
| LW01C0、LW01C1 | 输入上限、下限 | 由当前数值输入控件提供 |
| LW01C3 | 输入模式 | 0 字母、1 数字/符号、2 中文 |
| LW01C4 | 键盘状态 | 包括 Shift 状态；bit1 表示启用范围限制 |
| LW01C8、LW01C9 | 拼音、候选汉字 | 配合文本显示控件使用 |
| LW01CC | 录入内容 | 键盘输入预览，确认后才写入目标控件 |
LW01C0～LW01CC 含文本和键盘虚拟数据，不能整段按 UINT16 读取。旧 LW01C2 提示信息暂不支持。配置见“2.3 键盘”。
2.3 显示与触摸
背光
| 地址 | 功能 | 取值 / 单位 |
|---|---|---|
| LW0120 | 背光控制及状态 | 位定义见下表 |
| LW0121 | 实际亮度 | 0～100 |
| LW0122 | 空闲待机时间 | 秒 |
| LW0123 | 激活亮度 | 0～100 |
| LW0124 | 待机亮度 | 0～100 |
| LW0120 位 | 含义 |
|---|---|
| bit0 | 自动背光调节开关 |
| bit1 | 当前状态：0 待机、1 激活 |
| bit2 | 请求进入激活状态 |
| bit3 | 请求进入待机状态 |
先设置 LW0122～LW0124，再启用 LW0120.bit0。触摸可唤醒，有告警时不自动待机。
休眠、缩放与旋转
| 地址 | 功能 | 用法 |
|---|---|---|
| LW010F | 深度休眠 | 写 0x5503 进入休眠，命令自动清零 |
| LW011F | 字体缩放 | 高字节固定 0x55，低字节为百分比，范围 50～200 |
| LW0125 | 旧旋转配置镜像 | 兼容旧工程 |
| LW0157 | 当前旋转方向 | 0 / 1 / 2 / 3 对应 0° / 90° / 180° / 270° |
| LW0158、LW0159 | 逻辑宽度、高度 | 初始化后的尺寸，已考虑旋转方向 |
LW010F 低字节：bit0 允许触摸唤醒，bit1 允许主串口唤醒。LW011F 写 0x5550 表示 80%（0x50 = 80）。
LW0125、LW0157 是配置/状态镜像，不能作为运行时旋转命令。
触摸测试
| 地址 | 功能 | 取值 / 单位 |
|---|---|---|
| LW0128 | 测试与校准命令 | 0x5500 退出测试、0x5501 进入测试、0x5502 校准 |
| LW0128 | 灵敏度设置 | 0xAAxx，低字节为设置值 |
| LW0129 | 按下状态 | 读取当前触摸状态 |
| LW012A、LW012B | 触摸 X、Y | 松开后保留最后坐标 |
| LW012C～LW012D | 最近触摸活动时间 | UINT32，运行毫秒 |
2.4 时间
读取时间
| 地址 | 内容 | 类型 / 单位 |
|---|---|---|
| LW0116～LW0117 | 系统运行时间 | UINT32，10 ms |
| LW011C、LW011D、LW011E | RTC 时、分、秒镜像 | 可供指针时钟等控件读取 |
| LW0170、LW0171、LW0172 | 当前年、月、日 | 日历时间 |
| LW0173 | 当前星期 | 1～7，星期日为 7 |
| LW0174、LW0175、LW0176 | 当前时、分、秒 | 日历时间 |
RTC 在显示初始化时即可读取。运行、触摸和登录时间为运行计时，RTC 为日历时间。
设置 RTC
| 参数地址 | 内容 |
|---|---|
| LW0160、LW0161、LW0162 | 年、月、日 |
| LW0164、LW0165、LW0166 | 时、分、秒 |
| LW0167 | 提交设置命令 |
- 先写好年、月、日、时、分、秒参数。
- 再向 LW0167 写入下表中的命令。
- 读取 LW0170～LW0176，核对实际日期时间。
| 写入 LW0167 | 作用 |
|---|---|
| 0x5501 | 设置日期和时间 |
| 0x5502 | 仅设置日期 |
| 0x5503 | 仅设置时间 |
无效日期或不符合闰年规则的日期不生效。
2.5 告警与记录
告警设置与显示
| 地址 / 位 | 功能 | 取值 |
|---|---|---|
| LW0112.bit0 | 告警激活背光 | 按位启用 |
| LW0112.bit1～bit2 | 告警蜂鸣器 | 0 不控制、1 滴滴声、2 长鸣 |
| LW0113.bit0 | 告警状态 | 触发告警标记 |
| LW0115 | 告警等级显示 | 0 显示全部；bit0 显示等级 0，bit1 显示等级 1，依此类推 |
导出与清除
| 地址 | 操作对象 | 写入值 |
|---|---|---|
| LW0114 | 历史告警 | 0x0001 导出到 SD 卡/U 盘；0x0055 清除 |
| LW0188 | 操作记录 | 0x0001 导出；0x0055 清除 |
告警、操作记录及采样共用下列导出状态：
| 地址 | 内容 | 取值 / 单位 |
|---|---|---|
| LW0190 | 导出状态 | 1 进行中、2 成功、3 失败 |
| LW0191 | 导出进度 | 0～100 |
| LW0192～LW0193 | 开始时间 | UINT32，Unix 时间，秒 |
| LW0194～LW0195 | 结束时间 | UINT32，Unix 时间，秒 |
状态仅对应当前或最近一次导出，忙时新请求延后。
2.6 声音
| 地址 | 功能 | 取值 / 单位 |
|---|---|---|
| LW0110.bit0～bit1 | 触摸伴音 | 0 静音、1 蜂鸣器、2 声音文件 |
| LW0110.bit2 | 开机声音 | 按位启用 |
| LW0140 | 音量 | 0～100 |
| LW0141 | 音频选择 | 普通音频 ID |
| LW0142 | 播放控制 / 状态 | 写命令、读状态，含义见下表 |
| LW0143、LW0144 | 已播放 / 总时长 | 秒 |
| LW014F | 蜂鸣器时长 | 10 ms；写 0 停止 |
| LW0142 用法 | 数值 | 含义 |
|---|---|---|
| 写入 | 0x0001 | 播放 |
| 写入 | 0x0002 | 暂停 |
| 写入 | 0x0003 | 停止 |
| 读取 | 0 | 空闲 |
| 读取 | 0x0080 | 播放中 |
先写 LW0141 音频 ID，再写 LW0142 播放命令。模拟器不输出蜂鸣声。控件配置见“2.4 声音”。
2.7 数据与功能键
批量拷贝
| 地址 | 参数 |
|---|---|
| LW0131、LW0132 | 源、目标数据类型 |
| LW0133、LW0134 | 源、目标起始地址 |
| LW0135 | 拷贝字数 |
| LW0130 | 执行命令 |
- 写入源/目标类型、起始地址和字数。
- 向 LW0130 写
0x5501执行拷贝，或写0x5502拷贝但不通知。 - 读取目标地址，检查结果。
0x5501 仅在拷贝成功、目标为 LW、字数为 1～125时通知 DCBUS/DGUS。越界或地址回绕会被拒绝；Flash/协议写入中途失败时，已写部分不保证回滚。
模拟功能键
| 地址 | 参数 | 说明 |
|---|---|---|
| LW013B | 页面 ID | 0xFFFF 表示按当前层查找 |
| LW013C | 控件 ID | 指定目标按钮 |
| LW013D | 高亮颜色 | RGB565 |
| LW013A.bit0 | 触发执行 | 执行后自动清零 |
| LW013A.bit1 | 高亮控制 | 控制目标高亮 |
先指定页面和控件，再触发 LW013A.bit0。模拟点击仅支持普通按钮类型 0x06～0x0B；长按动作仍需真实长按。
地址索引
LW01D0～LW01DE 为 15 个地址索引，用于控件、告警、采样和配方。索引值按数值处理，不按八进制解释。
在“设置地址”中选择索引，偏移量由对应寄存器提供；不使用偏移时选择 NULL。
2.8 设备信息
| 地址 | 功能 | 说明 |
|---|---|---|
| LW0150 | 重启 | 仅写 0x5555 触发 |
| LW0152 | 工程 IDE 版本 | 保存版本字段原值 |
| LW0153～LW0154 | 工程编译时间 | UINT32 |
| LW0155 | 固件版本字段 | 编译月份 × 100 ＋ 日期 |
| LW0156 | 型号码 | 已确认 1 为 480×272、2 为 800×480 |
LW0150 在屏端重启设备，在模拟器中重启进程。
LW0152 保留版本字段原值，不换算为产品版本号。LW0153～LW0154 仅表示工程编译时间；LW0155 不含年份，不能用于判断全部功能。其他型号返回型号码 0 时，不代表设备故障。
2.9 用户登录
| 地址 | 功能 | 取值 / 类型 |
|---|---|---|
| LW0180 | 当前用户等级 | 0～8 |
| LW0181 | 验证命令 / 结果 | 写 0x0001 开始；读 2 成功、3 失败 |
| LW0182～LW0183 | 密码 | UINT32；验证后清零 |
| LW0184 | 所需等级 | 当前操作要求的等级 |
| LW0185～LW0186 | 最近登录活动时间 | UINT32，运行毫秒 |
先写密码，再向 LW0181 写验证命令并读取结果。登录活动时间为运行毫秒。
2.10 通信
站号
| 地址 | 功能 | 用法 |
|---|---|---|
| LW01A0 | 当前站号 | 修改成功后更新 |
| LW01A1 | 修改站号 | 0x5500 与站号低字节按位或，例如站号 2 写 0x5502 |
DCBUS 站号为 0～255，Modbus 从站为 1～247。主站协议不适用；非法设置不生效。
COM1 参数
| 地址 | 参数 | 取值 / 类型 |
|---|---|---|
| LW01B1～LW01B2 | 波特率 | UINT32 |
| LW01B3 | 数据位 | 7 或 8 |
| LW01B4 | 校验 | 0 无、1 奇、2 偶 |
| LW01B5 | 停止位 | 0 为 1 位、1 为 1.5 位、2 为 2 位 |
| LW01B0 | 提交配置 | 写 0x5501 |
- 先写好波特率、数据位、校验和停止位。
- 向 LW01B0 写入 0x5501，申请生效。
- 回读参数，确认实际配置。
配置失败时回写上一次有效参数。V3 下载期间不允许切换。
通信统计
| 地址 | 当前状态 |
|---|---|
| LW01A2 | 当前仅发布默认值 10 |
| LW01A3～LW01AD | 在线位图、屏蔽、错误和通信统计尚未接入各协议 |
不能用上述统计地址的零值判断从站在线或离线。
2.11 保留地址
| 地址 | 当前用途 / 限制 |
|---|---|
| LW0111、LW011A | 保留配置，没有已定义的运行行为 |
| LW011B | 工程特效配置镜像，不能当作全局动态特效开关 |
| LW0200～LW0223 | 旧内置分期兼容地址，当前运行库不维护旧分期，也不会据此锁屏或解锁 |
| LW0240～LW0243 | 旧编码器兼容地址，没有当前发布入口 |
语言掉电保存使用 RW，参见“2.2 多语言与文字标签”。
3. 用户标签
3.1 添加标签
- 选择“用户自定义标签”，点击“添加”。
- 双击单元格，填写名称、地址、权限和说明。
- 点击“确定”。
本例创建两个标签：
| 标签名称 | 地址 | 权限 | 说明 |
|---|---|---|---|
| Temperature | LW1000 | RW | 设定温度 |
| DeviceName | LW1010 | RW | 设备名称 |
用户变量从 LW1000 起规划，避免地址重叠。修改标签地址后，需同步调整直接使用原地址的控件和脚本。
下图添加 Speed → LW1030，权限为 RW，说明为“设定速度”：
3.2 地址格式
在“设置地址”中选择设备、地址类型和偏移索引，可切换十六进制、十进制或八进制输入。
LW1000 中的 1000 为十六进制，等于十进制 4096。
| 写法 | 含义 |
|---|---|
| LW1000 | 本机 LW 变量的字地址 |
| LW1000.1 | 该字的 bit1 |
| LW1000.0~3 | 该字的 bit0～bit3 位区间 |
| 4X… | Modbus 保持寄存器，设备和地址需按工程协议及设备手册设置 |
位号范围为 0～15。PLC 地址需按设备手册核对类型、进制和编号。
3.3 数据占用
| 数据类型 | 通常占用 | 示例 |
|---|---|---|
| UINT16、INT16 | 1 个字 | 从 LW1000 开始，占用 LW1000 |
| UINT32、INT32、32 位浮点 | 2 个连续字 | 从 LW1000 开始，占用 LW1000～LW1001 |
| 字符串 | 依长度、编码和存储方式确定 | 从 LW1010 开始，按控件设置预留连续空间 |
标签不自动分配空间。32 位数据需预留两个字，字符串按长度和编码预留连续地址。
3.4 修改与删除
双击单元格可编辑标签。“删除”移除选中项，“清空”移除全部用户标签。改名或删除前，请检查控件引用；批量清空前先导出备份。
3.5 导出标签
点击“导出”，选择保存位置，保存为 CSV 文件。
CSV 无表头，四列依次为“名称、地址、权限、说明”：
csv 复制代码Temperature,LW1000,RW,设定温度
DeviceName,LW1010,RW,设备名称文件使用 GBK 编码，编辑时保持列顺序、地址格式和编码不变。
3.6 导入标签
- 按导出格式编辑文件，保存并关闭。
- 点击“导入”，选择 CSV 或 TXT 文件。
- 核对标签内容，点击“确定”。
同名标签会跳过，不覆盖已有内容。 本例追加 Speed,LW1030,RW,设定速度 后，导入 1 条、跳过 2 条。已有标签可在管理器中直接修改。
4. 控件引用
以“设定温度”的数值控件为例：
- 点击数值控件“读取地址”右侧的“…”。
- 在“设置地址”中点击“已选标签”旁的“…”。
- 从“用户自定义标签”选择 Temperature，确认地址为 LW1000。
- 写入地址设为“与读取地址相同”，数据类型设为 UINT16。
属性显示 Temperature** 后，输入值写入 LW1000。文本控件可同样选择 **DeviceName（LW1010）；系统标签在“系统参数标签”中选择。