Dlt698Master
插件用途
DL/T 698 电能信息采集、主动上报和链路管理驱动
选择入口
进入“开发配置 → 采集配置”，创建设备并在“采集插件”中选择“Dlt698Master”。
支持的通道和数据类型
| 通道类型 | 配置前检查 |
|---|---|
| 串口 | 确认串口未被其它程序占用，并与设备保持一致的波特率、数据位、停止位和校验位。 |
| TCP 客户端 | 确认设备 IP、端口和网关到设备的网络可达性。 |
| TCP 服务端 | 确认本地监听地址和端口可用，并允许现场设备主动连接网关。 |
可选数据类型： Boolean、Byte、Int16、UInt16、Int32、UInt32、Int64、UInt64、Float、Double、String
插件参数
DL/T 698 使用采集公共属性中的读写超时、失败重试、写优先、串口/TCP 参数和 DTU 标识；公共字段见采集配置。本页列出 698 链路专用字段。
协议参数
| 参数 | 说明 |
|---|---|
| 服务器地址 | 必填；默认：000000000001；填写：文本输入。设置协议通信使用的服务器地址。 |
| 客户机地址 | 默认：0；填写：文本输入。设置协议通信使用的客户机地址。 |
| 启用 FE 前导 | 默认：是；填写：开关。控制“启用 FE 前导”功能是否启用。 |
连接配置
| 参数 | 说明 |
|---|---|
| 原生 TCP 生命周期 | 默认：否；填写：开关。控制“原生 TCP 生命周期”功能是否启用。 |
| DTU ID | 填写：文本输入。设置通过 DTU 服务识别当前设备连接的标识。 |
“服务器地址”填写 1～16 字节的十六进制文本，必须使用偶数位，例如 000000000001；变量地址中的 s= 可以只对当前变量覆盖该值。“客户机地址”是单字节地址，默认 0。启用“原生 TCP 生命周期”后，TCP 客户端会在连接后自动完成登录和应用连接；串口透传或普通 TCP 请求不要开启该项。
地址规则
- DL/T 698 地址使用四字节 OAD，例如 20-00-02-00。
- 可用 s=149100007290 覆盖服务器地址，ca=0 覆盖客户机地址，sat=single/wildcard/group/broadcast 和 logic=0..3 覆盖地址描述符。
- 数值按 OAD 常用倍率转换为当前变量类型；数组或结构体按响应顺序展开，变量 ArrayLength 必须与标量数量一致。
- 当前版本仅支持明文应用请求；安全请求因缺少真实密钥和认证生命周期配置而显式拒绝。
- TCP 客户端可选择串口透传或原生 TCP 生命周期；原生 TCP 会在连接后完成登录和应用连接。
特殊方法
| 方法 | 用途 | 参数 |
|---|---|---|
| ReadOadsAsync | 读取多个 OAD | addresses=20-00-02-00,20-01-02-00 |
| ExchangeClearApduAsync | 交换明文 APDU | address=20-00-02-00; apduHex=05 01 00 20 00 02 00 00 |
设备调试
进入“开发配置 → 采集配置”，选择当前设备后点击“更多功能”并打开“调试”。
专用调试页
协议调试页分为 OAD 和 APDU 两个页签。
| 功能 | 作用 |
|---|---|
| OAD | 一次读取一个或多个四字节 OAD，适合验证服务器地址、客户机地址和对象属性。 |
| APDU | 向指定 OAD 交换完整明文 APDU，可能包含控制语义，执行前需要高危确认。 |
| 调试结果 | 显示本次请求的响应内容或明确错误。 |
调试要点
按 OAD 列表先读对象属性；明文 APDU 十六进制交换属于高风险原始报文，执行前必须二次确认。
验证重点
- 在 OAD 页签读取一个设备文档已确认的 OAD，例如
20-00-02-00。 - 确认返回对象与电表当前数据一致，再增加第二个 OAD 验证批量读取顺序。
- 使用带服务器地址覆盖的变量时，确认
s=、ca=、sat=和logic=与目标设备地址描述符一致。 - 对数组或结构体 OAD，核对变量数组长度与响应展开后的标量数量一致。
- APDU 页签只用于已确认的明文报文；未知 APDU 不得在生产设备上执行。
排障差异
- OAD 读取没有响应：检查服务器地址、客户机地址、FE 前导、通道参数和 OAD 字节顺序。
- TCP 连接成功但应用请求失败：确认设备是否要求原生 TCP 生命周期，并检查登录和应用连接是否完成。
- 数值倍率或数组结果错误：核对 OAD 对象类型、变量数据类型和数组长度，不要把结构体响应当作单个标量。
- 设备要求安全认证：当前版本只支持明文应用请求，不能用 APDU 页签绕过设备的安全认证要求。
- 特殊方法执行失败：核对方法参数和权限；控制、写入或复位类方法还需确认设备处于允许操作的状态。
- 串口设备无响应：确认串口未被占用，并核对波特率、数据位、停止位和校验位。