巨控GRM230使用手册（六）：短信命令

GRM230 支持多种形式短信命令，并将执行结果以短信形式发送到命令发送者手机中。 GRM230 接收的短信命令包括读变量、写变量、查询、控、管理和报警确认命令。
GRM230 具备自动过滤骚扰短信能力。当收到的信息包含非法操作码时， GRM230 自动丢弃该信息，并且不产生任何回复信息。

1.1 短信命令语法
短信命令语法格式：操作码<#用户名><##密码>，动作参数
◆ 操作码
在一条短信命令中，操作码是必需的。
操作码定义如下：

◆ 用户名
在一条短信命令中，用户名不是必需的。普通用户不需要写用户名，因为用户名与手机号码是一一对应的。只有在用户编辑器中设为“允许任意手机号码”的用户发出的命令才需要提供用户名，如下图。

输入用户名时，用户名必须紧跟在操作码后面，中间不能有空格，且用户名前必须加#号。如：查#用户 1，机组状态//如果用户还配置了密码，短信内容还需带上密码和用户名
◆ 密码
在一条短信命令中，密码也不是必需的。如果该用户没有设置密码，则不需要提供密码。输入密码时，密码必须紧跟在操作码或用户名后面，中间不能有空格，且密码前必须加双#号。如

写#经理##123，回水温度=26 //设置回水温度，用户名是经理，密码是 123

写#用户 1，回水温度=26 //设置回水温度，用户名是用户 1，无密码

写，回水温度=26 //设置回水温度，无用户名和密码

◆ 动作参数

在一条短信命令中，动作参数是必需的。动作参数写在短信命令的尾部，且必须用逗号（，）与前面内容分隔开。不同操作码时，动作参数有所不同。多个动作参数之间必须以号（，）分隔。如，

读， 出水温度， 回水温度 // 注意： 两个逗号都不可缺少

写##123， 运行模式=1， 回水温度=26 // 注意： 两个逗号都不可缺少

1.2 短信读变量

短信读变量用于手机发短信给 GRM230,来读取 GRM230 中的变量值，一次可以读取 4 个变量当前值，被读取变量在建立时，需勾选短信读属性。 只有属于“$读取变量用户组”内的用户的手机有读取变量权限。

读变量短信格式：

读<#用户名><##密码>,变量 1<,变量 2><,变量 3><,变量 4>

举例：

1. 用户发送短信给 GRM230 读取 GRM230 中名为模块 1 温度的变量：读，模块 1 温度 //如果用户还配置了密码，短信内容还需带上密码和用户名。

GRM230 返回：模块 1 温度=24;

GRM230 返回
模块 1 温度=24;模块 2 温度=25;
正常情况下， GRM230 返回每个变量当前值，并以分号（；）分隔每个变量。有时 GRM230 并不能返回变量当前值，如变量模块 1 温度所在设备与 GRM230 出现通讯故障时， GRM230 返回读变量错误信息，如，
模块 1 温度:设备通讯故障;模块 2 温度=25;
读变量命令可能返回的错误信息及原因如下：

1.3 短信写变量
短信写变量用于手机发短信给 GRM230 来修改 GRM230 中的变量值，一条写变量短信， 可以最多修改 4个变量，被写的变量在建立时，需勾选短信写属性。 只有属于“$写入变量组”内的用户的手机有写变量权限。
写变量命令格式：
写<#用户名><##密码>,赋值表达式 1<,赋值表达式 2><,赋值表达式 3><,赋值表达式 4>
赋值表达式形式为：变量=常量，如：模块 2 温度=25。
举例：
1：配置了手机号的用户向 GRM230 短信模块发送如下短信修改 GRM230 中的变量“设置温度“写， 设置温度=25
GRM230 返回
设置温度=25:OK
2： 若用户名为经理，密码为 123，向短信模块发送如下一次短信写两个变量：
写#经理##123， 设置温度=25， 电流阀值=100
GRM230 返回
设置温度=25， 电流阀值=100: OK;
正常情况下， GRM230 返回 OK 表示变量赋值执行成功。有时 GRM230 并不能执行赋值操作，如变量模块 1 温度所在设备与 GRM230 出现通讯故障时， GRM230 返回赋值错误信息，如，

模块 1 温度:设备通讯故障;模块 2 温度=25:OK;
写变量命令可能返回的错误信息及原因如下：

1.4 短信查询
授权用户组内的用户发送一条短信给 GRM230， GRM230 以文本或数字形式回送一条短信，反映当前状态(GRM230 中的一个或者多个变量值，相关文字描述)。
短信查询命令格式如下：
查<#用户名><##密码>,查询名称
每条短信查询命令只允许有一个查询名称。

◆ 查询名称
每个短信查询有唯一的查询名称，查询名称不区分大小写，且最大长度不能超过 15 个字符。用户在编写查询命令短信时，查询名称也可以使用查询名称缩写替代。如上图所示，查询命令“查,系统温度”和查询命令“查,XTWD”是等效的。

◆ 授权用户组
只有授权用户组内用户发送的查询命令才会被 GRM230 接受。

举例：
发送查询系统温度命令，包括冻水出水温度和冻水回水温度。配置了手机号且属于该查询的授权用户组的用户向短信模块发送如下短信：
查，系统温度 //如果用户还配置了密码，短信内容还需带上密码和用户名若用户名为经理，密码为 123，向短信模块发送如下短信：
查#经理##123，系统温度
GRM230 返回
冻水出水温度=20℃，冻水回水温度=26℃
正常情况下， GRM230 返回查询消息模板中定义的信息。如果查询名称超出 15 个字符， GRM230 返回“无效的查询”信息。如果消息模板某个参数变量所在设备与 GRM230 出现通讯故障， GRM230 返回的是变量在出现通讯故障前的值。

1.5 短信控制
GRM230 允许定义多个短信控制，短信控制命令简化了短信写命令，用户不需要知道变量和赋值等细节，授权用户组内的用户只需向 GRM230 发送一条短信控制命令信息， GRM230 接收信息后把设定值赋给相应变量，并写入设备，完成操作后给发送方回送一条信息表示操作成功或失败。
当短信控制中触发查询为“无”时，系统按默认方式回复信息表示赋值操作成功或失败。当短信控制中触发查询不为“无”时，如果系统执行变量赋值操作失败，则先回送失败信息，然后回送查询信息，否则只返回查询信息。
短信查询命令格式：
控<#用户名><##密码>,控制名称
每条短信控制命令只允许有一个控制名称。

◆ 控制名称
每个短信控制有唯一的控制名称，控制名称不区分大小写，且最大长度不能超过 15 个字符。用户在编写控制命令短信时，控制名称也可以使用控制名称缩写替代。如上图所示，控制命令“控,启动机组”和控制命令“C,QDJZ”是等效的。
◆ 授权用户组
只有授权用户组内用户发送的控制命令才会被 GRM230 接受。
◆ 触发查询代替默认回复短信
GRM230 在执行短信控制内容规定的赋值后， 给发送方回送一条已定义的查询信息。
若不选此选项， GRM230 默认回复为
控制名称： OK

◆ 短信控制内容

短信控制内容实际上就是变量赋值操作，本命令最多允许 8 个变量赋值操作。

举例：
发送启动机组命令，包括开启冷冻站、开启柜机 1 和开启柜机 2 功能。
配置了手机号且属于该控制的授权用户组的用户向短信模块发送如下短信：
控，启动机组    //如果用户还配置了密码，短信内容还需带上密码和用户名
若用户名为经理，密码为 123，向短信模块发送如下短信：
控#经理##123，启动机组
GRM230 默认返回
启动机组： OK

正常情况下， GRM230 默认会返回控制名称加“： OK”字样表示成功执行控制命令中全部赋值操作。有时GRM230 并不能执行控制命令中全部赋值操作，如变量开柜机 2 所在设备与 GRM230 出现通讯故障时，GRM230 返回赋值错误信息，如，

开冷冻站： OK;开柜机 1： OK;开柜机 2：设备通讯故障;
短信控制命令可能返回的错误信息及原因如下：

1.6 短信管理用户
短信管理命令用于修改用户手机号，同时可以禁用或启用某个用户。一条短信管理命令可以修改 4 个用户手机号。只有系统管理员组的用户才有修改用户手机号权限。
短信管理命令格式：
管<#用户名><##密码>,用户 1=手机号<,用户 2=手机号><,用户 3=手机号><,用户 4=手机号>
如果手机号是空白， 表示清空该用户的号码， 这样该用户无法收到报警短信，但仍然可以用带用户名和密码的形式进行短信查询和短信控制。 用具备管理员权限的号码将该用户设置正确的手机号可以启用被清空的用户。
如果手机号是星号（*）表示禁用该用户， 被禁用的用户名将失去全部权限。 用具备管理员权限的号码
将该用户设置正确的手机号可以启用被禁用的用户。
注意： “SIM”是个特殊用户名，表示 SIM 卡，例当用户发送“M,SIM=10086”时表示修改短信模块 SIM 卡
运营商为移动。
举例：
经理发送短信管理命令将“维修工 1”手机号改为 13126483913，同时清空“维修工 2”。
管#经理，维修工 1=13126483913，维修工 2=
GRM230 返回
维修工 1=13126483913，维修工 2= : OK
正常情况下， GRM230 返回 OK 表示改号成功。
短信管理命令可能返回的错误信息及原因如下：

1.7 短信查询用户

系统管理员组的用户可以发短信查询 SIM 卡运营商，
已经有的全部用户名， 手机号， 密码。
命令格式：
查，用户 //如果用户还配置了密码，短信内容还需带上密码和用户名
或 Q，
USER
举例：
查#管理员##123456，用户
GRM230 返回
SIM，， 10010
管理员，， 13126483912
用户 1，， 13126483913

1.8 短信查询序号，型号

工程中配置的任意用户可以发短信查询 GRM230 的设备序号和设备型号。设备型号和 GRM230 的硬件配置有关。设备序号是设备出厂的唯一识别码，只有带 4G 功能的短信报警器才具备。
命令格式：
查，序号//如果用户还配置了密码，短信内容还需带上密码和用户名
或 Q，ID
GRM230 返回
GRM230A:----

1.9 短信校时

系统管理员组的用户可以发短信校准模块的时间。
命令格式：
管， 校时//如果用户还配置了密码，短信内容还需带上密码和用户名
或 M， JS
如果配置了用户名和密码，格式如下
管#用户名##密码， 校时

1.10 短信查询余额和流量

任意用户可以用手机发短信给 GRM 模块里面的 SIM 卡的号码，来查询模块里面的 SIM 卡的余额。
命令格式：
转，短信模块内 SIM 卡运营商 SP 号，余额查询码或流量查询码
中国移动 SIM 卡运营商 SP 号是 10086，中国联通 SIM 卡运营商 SP 号是 10010。 余额查询码与短信模块内插入的 SIM 卡运营商和区域有关，使用时请咨询短信模块内的 SIM 卡运营商。
常见可能代码如下表：

举例：
短信模块内使用中国移动广州的卡，值班人员可以用自己的手机给短信模块里面 SIM 卡号码发送如下短信，查询短信模块内 SIM 卡的余额。 短信内容如下：
转， 10086， HF
如果用户配置了用户名加密码，发短信就需要配上用户名，密码
转#经理##123， 10086， HF

1.11 短信进行报警确认

在安全性要求很高的场合，我们可以将报警短信设置为多次重复发送，直到相关人员发短信确认报警，并去现场排查。如果启用了确认通知，在值班人员发送确认报警短信后， GRM230 会以短信的形式，发送确认通知给相关人员，以作为记录备查。
如下图，当报警条件成立后，报警会每隔 3 分钟发送 1 次，共计重复发送 10 次，给该报警配置的报警
发送目标！
如果勾上“确认后停止发送报警”选项后，该报警配置的报警发送目标中的任何用户，只要发报警确认短信给 GRM230 确认此报警， GRM230 收到后，将不再重复发送该报警信息。
报警确认短信命令格式如下：
答,报警名称
如果用户还配置了密码，需带上密码和用户名如
答#经理##123， 报警名称
报警确认命令中必须有且只有一个报警名称。 如下图,报警名称为 A1，则报警确认短信命令格式：
答,A1 //如果用户还配置了密码，需带上密码和用户名答#经理##123， 报警名称

    如果在报警发送模板中，勾上“接收确认通知”，那么报警发送目标里面配置的任意用户发短信确认报警后，只要勾选了“接收确认通知”的用户，将收取到确认通知！

报警确认通知的短信内容在工程选项中指定：

如上图配置，收到的确认通知如下：
[GRM232G 设备 1]:2013-03-22,17:17:53 被管理员:135XXXXXXXXX 确认