DOCA0091ZH-08

命令接口

概述

命令接口用于:

  • 发送远程命令

  • 发送远程控制命令

因此命令是非入侵性命令。它们没有密码保护,始终处于启用状态。

远程控制命令是入侵性命令,如果保护设置被修改,要么可能对断路器附近的人员有害,要么可能导致设备损坏。因此,远程控制命令:

  • 在命令中需要密码的情况下受到密码保护

  • 受到配置的保护:

    • 在配有 IFM 接口的情况下,在 IFM 接口上的挂锁处于打开位置时,会启用远程控制命令。

    • 在配有 IFE 接口的情况下,在 IFE 接口上的挂锁处于打开位置时,会启用远程控制命令。

    • 在配有 EIFE 接口的情况下,在利用 EcoStruxure Power Commission software 通过 EIFE 配置解锁了入侵性命令模式时,会启用远程控制命令。

每个命令都有一个特定的代码。例如,命令代码 904 定义了分闸断路器的命令。

执行命令

按照以下步骤执行命令:

步骤

操作

1

加载缓冲器。

2

从寄存器 8000 开始,使用写入请求(Modbus 功能 16)对这个缓冲器执行写操作。

3

读取命令状态寄存器 8021,如果其内容显示命令正在执行中 (0x0003),则继续等待。

4

读取命令状态寄存器 8020:

  • 如果寄存器 8020 的内容是在步骤 2 输入至寄存器 8000 中的命令代码,则转至下一步。

  • 如果寄存器 8020 的内容不是在步骤 2 输入至寄存器 8000 中的命令代码,则从步骤 1 重新开始操作。

5

读寄存器 8021 中最低有效位的错误代码:

  • 如果最低有效位 ≠ 0,那么表示命令失败。检查错误代码,以便找到错误原因(参见下节)。例如,如果寄存器 8021 返回 4609 (0x1201),则错误代码为 1,这表示密码不正确(用户权限不足)。

  • 如果最低有效位 = 0,那么表示执行了命令,没有出现错误。

注: Modbus 应用程序将等待一个命令执行完成后才会发送下一个命令。如果没有响应,Modbus 应用程序会重新发送该命令。在这种情况下,第一个命令将自动中止。

命令图

下图给出了执行命令的步骤:

命令的数据结构

命令接口使用寄存器 8000 至 8149:

  • 命令的输入参数写入寄存器 8000 至 8015。寄存器 8016 至 8019 被保留。

  • 命令执行结束后返回的数据写入寄存器 8020 至 8149。

命令的输入参数的详细说明见下表:

地址

寄存器

说明

备注

0x1F3F

8000

命令代码

在这个寄存器写入,会触发使用以下寄存器参数的命令。

0x1F40

8001

参数长度

包括当前参数在内的参数所使用的字节数(从 10 到 30)。这个数值提供给每个命令。

0x1F41

8002

目的地

为每个命令提供的常数值。

出厂设置:0x0000

0x1F42

8003

安全类型

为每个命令提供的常数值:

  • 0(对于不受密码保护的非入侵性命令)

  • 1(对于受密码保护的入侵性命令)

0x1F43

0x1F44

8004

8005

密码

密码包括 4 个 ASCII 字节。

要使用的密码取决于命令。

此信息提供给每个命令。

0x1F45–0x1F4E

8006–8015

附加参数

附加参数定义了命令的执行方式。一些命令没有附加参数。

0x1F4F

8016

保留

必须设置为 0(出厂设置)。

0x1F50

8017

保留

必须设置为 8019(出厂设置)。

0x1F51

8018

保留

必须设置为 8020(出厂设置)。

0x1F52

8019

保留

必须设置为 8021(出厂设置)。

命令执行结束后返回的数据的详细说明见下表:

地址

寄存器

说明

备注

0x1F53

8020

最后一个命令代码

执行该命令时,其将保留最后一个命令代码。

0x1F54

8021

命令状态

如果命令退出繁忙状态,它会保留完成代码。

0x1F55

8022

数据缓冲器大小

返回的字节数。

0x1F56–0x1FD4

8023–8149

数据缓冲器

返回值。如果前一个寄存器为 0,该值为空。

命令状态

命令成功后,命令状态为 0。

命令正在执行时,命令状态为 3。

命令生成错误时,命令状态寄存器包含:

  • LSB:错误代码

  • MSB:生成错误的模块的地址

返回命令结果的模块

下表给出了模块的地址:

模块地址

模块

1 (0x01)

UTA 维护模块

2 (0x02)

用于单个断路器的 FDM121 ULP 显示器

3 (0x03)

用于单个断路器的 IFM Modbus-SL 接口

17 (0x11)

ComPact NSX 的 BSCM 断路器状态控制模块

18 (0x12)

MasterPact NT/NWComPact NSBCM ULP 断路器通讯模块

20 (0x14)

ComPact NSX 的脱扣单元 MicroLogic

21 (0x15)

MasterPact MTZ 的控制单元 MicroLogic

32 (0x20)

用于单个断路器的 IO 输入/输出应用程序模块 1

33 (0x21)

用于单个断路器的 IO 输入/输出应用程序模块 2

34 (0x22)

  • 用于单个断路器的 IFE 以太网接口

  • IFE 以太网交换机服务器

注: MicroLogicMasterPact NT/NW 断路器的ComPact NS 脱扣单元没有 IMU 模块地址。

命令结果

下表列出了与命令结果相对应的代码。

代码

说明

0 (0x00)

成功的命令

1 (0x01)

用户权限不足(密码不正确)

2 (0x02)

访问违规(IFM 挂锁已锁定,或者IFE 挂锁已锁定,或者入侵性命令模式已锁定)

3 (0x03)

无法执行一个读访问

4 (0x04)

无法执行一个写访问

5 (0x05)

无法执行服务(IFM 挂锁已锁定)

6 (0x06)

存储器不足

7 (0x07)

分配的存储器太小

8 (0x08)

资源不可用

9 (0x09)

资源不存在

10 (0x0A)

资源已经存在

11 (0x0B)

资源处于乱序状态

12 (0x0C)

在可用资源之外访问

13 (0x0D)

字符串太长

14 (0x0E)

缓冲器太小

15 (0x0F)

缓冲器太大

16 (0x10)

输入参数超出范围

17 (0x11)

不支持请求的安全级

18 (0x12)

不支持请求的组件

19 (0x13)

不支持命令

20 (0x14)

输入参数有一个不被支持的数值

21 (0x15)

在命令过程中出现内部错误

22 (0x16)

在命令过程中超时

23 (0x17)

在命令过程中出现校验和错误

24 (0x18)

目的地不受支持

151 (0x97)

断路器已脱扣,在命令执行之前复位

152 (0x98)

断路器已合闸

153 (0x99)

断路器已分闸

154 (0x9A)

断路器已复位

155 (0x9B)

执行器处于手动模式

156 (0x9C)

执行器不存在

157 (0x9D)

ASIC 配置不当

158 (0x9E)

正在执行前面的命令

159 (0x9F)

复位命令已禁止

160 (0xA0)

抑制模式已打开

169 (0xA9)

已处于请求状态

170 (0xAA)

无法预设计数器

171 (0xAB)

输出命令遭拒,已经分配

172 (0xAC)

已禁止发送器执行命令

173 (0xAD)

模式与所请求的命令无关

174 (0xAE)

会话密钥无效

175 (0xAF)

在会话范围外

176 (0xB0)

会话已经打开

177 (0xB1)

没有打开的会话

178 (0xB2)

未提交有效的设置

180 (0xB4)

无线组件未启动

190 (0xBE)

读取并获取了无效值

191 (0xBF)

未安装许可证

不支持命令

本指南介绍了包含最新固件版本的每个 IMU 模块可用的命令。若本指南中所述的命令没有在包含旧固件版本的 IMU 模块中实施,则会返回具有错误代码 19 (0x13) 的命令状态(不支持此命令)。

您可以通过 EcoStruxure Power Commission 软件更新 IMU 模块的固件。