命令接口
概述
命令接口用于:
-
发送远程命令
-
发送远程控制命令
因此命令是非入侵性命令。它们没有密码保护,始终处于启用状态。
远程控制命令是入侵性命令,如果保护设置被修改,要么可能对断路器附近的人员有害,要么可能导致设备损坏。因此,远程控制命令:
-
在命令中需要密码的情况下受到密码保护
-
受到配置的保护:
-
在配有 IFM 接口的情况下,在 IFM 接口上的挂锁处于打开位置时,会启用远程控制命令。
-
在配有 IFE 接口的情况下,在 IFE 接口上的挂锁处于打开位置时,会启用远程控制命令。
-
在配有 EIFE 接口的情况下,在利用 EcoStruxure Power Commission software 通过 EIFE 配置解锁了入侵性命令模式时,会启用远程控制命令。
-
每个命令都有一个特定的代码。例如,命令代码 904 定义了分闸断路器的命令。
执行命令
按照以下步骤执行命令:
步骤 |
操作 |
---|---|
1 |
加载缓冲器。 |
2 |
从寄存器 8000 开始,使用写入请求(Modbus 功能 16)对这个缓冲器执行写操作。 |
3 |
读取命令状态寄存器 8021,如果其内容显示命令正在执行中 (0x0003),则继续等待。 |
4 |
读取命令状态寄存器 8020:
|
5 |
读寄存器 8021 中最低有效位的错误代码:
|
命令图
命令的数据结构
命令接口使用寄存器 8000 至 8149:
-
命令的输入参数写入寄存器 8000 至 8015。寄存器 8016 至 8019 被保留。
-
命令执行结束后返回的数据写入寄存器 8020 至 8149。
命令的输入参数的详细说明见下表:
地址 |
寄存器 |
说明 |
备注 |
---|---|---|---|
0x1F3F |
8000 |
命令代码 |
在这个寄存器写入,会触发使用以下寄存器参数的命令。 |
0x1F40 |
8001 |
参数长度 |
包括当前参数在内的参数所使用的字节数(从 10 到 30)。这个数值提供给每个命令。 |
0x1F41 |
8002 |
目的地 |
为每个命令提供的常数值。 出厂设置:0x0000 |
0x1F42 |
8003 |
安全类型 |
为每个命令提供的常数值:
|
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/NW 和 ComPact NS 的 BCM ULP 断路器通讯模块 |
20 (0x14) |
ComPact NSX 的脱扣单元 MicroLogic |
21 (0x15) |
MasterPact MTZ 的控制单元 MicroLogic |
32 (0x20) |
用于单个断路器的 IO 输入/输出应用程序模块 1 |
33 (0x21) |
用于单个断路器的 IO 输入/输出应用程序模块 2 |
34 (0x22) |
|
命令结果
下表列出了与命令结果相对应的代码。
代码 |
说明 |
---|---|
0 (0x00) |
成功的命令 |
1 (0x01) |
用户权限不足(密码不正确) |
2 (0x02) |
|
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 模块的固件。