报警主机（mal）标准指令集

标准指令集

指令	名称	数据类型	取值约束
sos_state	紧急状态	Boolean	{}
night_light_delay	夜灯延时	Integer	{“unit”:“s”, “min”:0, “max”:300, “scale”:0, “step”:1}
night_light_bright	夜灯亮度	Integer	{“unit”:“”, “min”:0, “max”:100, “scale”:0, “step”:1}
master_mode	主机模式	Enum	{“range”:[“disarmed”, “arm”, “home”, “sos”, “work”, “play”]}
alarm_bright	光亮度调节	Integer	{“unit”:“”, “min”:0, “max”:100, “scale”:0, “step”:1}
switch_alarm_light	报警灯开关	Boolean	{}
alarm_volume	报警音量	Enum	{“range”:[“low”, “middle”, “high”, “mute”]}
switch_alarm_sound	报警声开关	Boolean	{}
alarm_time	报警时长	Integer	{“unit”:“min”, “min”:1, “max”:60, “scale”:0, “step”:1}
delay_set	延时设置	Integer	{“unit”:“s”, “min”:0, “max”:300, “scale”:0, “step”:1}
switch_alarm_sms	报警短信开关	Boolean	{}
switch_alarm_call	报警电话开关	Boolean	{}
alarm_sms_number	报警短信号码	Raw	{}
alarm_call_number	报警电话号码	Raw	{}
switch_low_battery	低电量报警开关	Boolean	{}
password_set	设置密码	String	{“maxlen”:255}
switch_kb_light	键盘背景灯开关	Boolean	{}
switch_kb_sound	键盘按键音开关	Boolean	{}
switch_mode_light	工作模式指示灯开关	Boolean	{}
switch_mode_sound	工作模式提示音开关	Boolean	{}
alarm_ringtone	报警铃声	enum	{“range”:[“1”, “2”, “3”, “4”, “5”]}
master_state	主机状态	Enum	{“range”:[“normal”, “alarm”]}
night_light	夜灯模式	Enum	{“range”:[“light_on”, “light_off”, “light_white”, “light_warm_yellow”]}
doorbell_volume	门铃音量	Enum	{“range”:[“low”, “middle”, “high”, “mute”]}
switch_mode_dl_sound	模式生效倒计时提示音	Boolean	{}
alarm_delay_time	告警后延时报警	Integer	{“unit”:“s”, “min”:0, “max”:300, “scale”:0, “step”:1}
switch_alarm_propel	告警推送	Boolean	{}
muffling	消音	Boolean	{}
zone_attribute	防区属性	Enum	{“range”:[“disarmed”, “arm”, “home”, “24h”, “delay”, “others”]}
call_looptimes	未接听重复拨打次数	Integer	{“unit”:“”, “min”:1, “max”:10, “scale”:0, “step”:1}
alarm_volume_value	报警音量大小	Integer	{“unit”:“”, “min”:0, “max”:100, “scale”:0, “step”:1}
master_language	主机语言	Enum	{“range”:[“chinese_simplified”, “chinese_traditional”, “english”, “french”, “italian”, “german”, “spanish”, “portuguese”, “russian”, “japanese”]}
sub_admin	子设备管理	Raw	{}
sub_type	子设备类型	Enum	{“range”:[“motion_sensor”, “contact_sensor”, “smoke_alarm”, “gas_alarm”, “co_alarm”, “vibration_detector”, “water_leak_sensor”, “infrared_emission_detector”, “glass_break_detector”, “sos_button”, “remote_controller”, “keypad”, “doorbell”, “door_lock”, “rfid”, “alarm”, “environment_detector”, “others”]}
sub_class	子设备品类	Enum	{“range”:[“detector”, “remote_controller”, “wired_detector”, “rfid”, “doorbell_door_lock”, “alarm”, “others”]}
factory_reset	恢复出厂设置	Boolean	{}
doorbell_ringtone	门铃铃声	Enum	{“range”:[“1”, “2”, “3”, “4”, “5”]}

sub_admin 指令示例

sub_admin 表示子设备管理的功能（DP），其支持的功能如下。

功能编码（十六进制）	说明
0x01	查询指定品类的子设备数量
0x02	查询指定品类下所有子设备的属性
0x03	查询子设备属性
0x04	修改子设备属性
0x05	删除子设备
0x06	添加子设备

0x01

字段说明

查询指定品类的子设备数量功能指令下发协议。

字段说明	序号	字节数	数据代表说明
功能编码	1	1	0x01：代表查询指定品类的子设备数量
设备品类	2	1	解析字节数据为对应设备品类，见下文 设备品类 说明

下发示例

• 下发的十六进制数据：0101
• Base64 编码后的数据：AQE=

数据编码过程说明（后续协议字段说明与该过程相同）

• 十六进制：01 01

• 二进制：00000001 00000001

• Base64 格式：AQE=

  二进制到 Base64 的转换，请自行参考 Base64 编码表。

  字段说明	字段值	说明
  功能编码	01	查询指定品类的子设备数量
  设备品类	01	遥控器

0x02

字段说明

查询指定品类下所有子设备的属性功能指令下发协议。

字段说明	序号	字节数	数据代表说明
功能编码	1	1	0x02：代表查询指定品类下所有子设备的属性
设备品类	2	1	解析字节数据为对应设备品类，见下文 设备品类 说明

下发示例

• 下发的十六进制数据：0201

• Base64 编码后的数据：AgE=

  字段说明	字段值	说明
  功能编码	02	查询指定品类下所有子设备的属性
  设备品类	01	遥控器

0x03

字段说明

查询子设备属性功能指令下发协议。

字段说明	序号	字节数	数据代表说明
功能编码	1	1	0x03：代表查询子设备属性
设备品类	2	1	解析字节数据为对应设备品类，见下文 设备品类 说明
子设备序号	3	1	0x01：代表第 1 个设备，请确保每个设备序号唯一性

下发示例

• 下发的十六进制数据：030001

• Base64 编码后的数据：AwAB

  字段说明	字段值	说明
  功能编码	03	查询子设备属性
  设备品类	00	探测器
  子设备序号	01	设备序号为 1

0x04

字段说明

子设备属性修改功能指令下发协议。

字段说明	序号	字节数	数据代表说明
功能编码	1	1	0x04：代表子设备属性修改
设备品类	2	1	解析字节数据为对应设备品类，见下文 设备品类 说明
序号	3	1	0x01：代表第 1 个设备，请确保每个设备序号唯一性
类型	4	1	解析字节数据为对应子设备类型，见下文 子设备类型 说明
防区属性	5	1	解析字节数据为对应防区属性，见下文 防区属性 说明
开启关联	6	1	0x00：开启 0x01：关闭 0xFF：无此功能
工作状态	7	1	0x00：正常 0x01：报警 0x02：故障 0x03：其它 0xFF：无此功能
电池电量	8	1	0x00：正常 0x01：报警 0xFF：无此功能
名称字节数	9	1	参数说明：名称字段的字节数 取值范围：0x01～0xFE、0xFF（表示无此功能） 示例：0x03，名称字段有 3 个字节
名称	10	n	有名称则按 UTF-16BE 编码格式下发，并去掉 FEFF 前缀，否则没有此字段

下发示例

• 下发的十六进制数据：0400010C00FFFFFF0C00530065006e0073006f0072

• Base64 编码后的数据：BAABDAD///8MAFMAZQBuAHMAbwBy

  字段说明	字段值	说明
  功能编码	04	修改子设备属性
  设备品类	00	设备品类为探测器
  序号	01	第一个设备
  类型	0C	门铃
  防区属性	00	普通防区
  开启关联	FF	无此功能
  工作状态	FF	无此功能
  电池电量	FF	无此功能
  名称字节数	0C	名称有 12 个字节
  名称	00530065006e0073006f0072	表示名称为 Sensor

0x05

字段说明

删除子设备功能指令下发协议。

字段说明	序号	字节数	数据代表说明
功能编码	1	1	0x05：代表删除子设备
设备品类	2	1	解析字节数据为对应设备品类，见下文 设备品类 说明
子设备序号	3	1	0x01：代表第 1 个设备，请确保每个设备序号唯一性

下发示例

• 下发的十六进制数据：050001

• Base64 编码后的数据：BQAB

  字段说明	字段值	说明
  功能编码	05	删除子设备
  设备品类	00	设备品类为探测器
  子设备序号	01	设备序号为 1

0x06

字段说明

添加子设备功能指令下发协议。

字段说明	序号	字节数	数据代表说明
功能编码	1	1	0x06：代表添加子设备
设备品类	2	1	解析字节数据为对应设备品类，见下文 设备品类 说明 0xFF：代表不指定具体品类

下发示例

• 下发的十六进制数据：06ff

• Base64 编码后的数据：Bv8=

  字段说明	字段值	说明
  功能编码	06	添加子设备
  设备品类	ff	不指定具体品类

设备品类说明

取值和 DP=36（即 sub_class）枚举对应。

编码（十六进制）	标识符	名称
0x00	detector	探测器
0x01	remote_controller	遥控器
0x02	wired_detector	有线探测器
0x03	rfid	RFID
0x04	doorbell_door_lock	门铃门锁
0x05	alarm	报警器
0x06	others	其它

子设备类型说明

取值和 DP=37（即 sub_type）枚举对应。

编码（十六进制）	标识符	名称
0x00	motion_sensor	人体红外
0x01	contact_sensor	门磁
0x02	smoke_alarm	烟雾
0x03	gas_alarm	燃气
0x04	co_alarm	一氧化碳（CO）
0x05	water_leak_sensor	水浸
0x06	vibration_detector	振动
0x07	infrared_emission_detector	红外对射
0x08	glass_break_detector	玻璃破碎
0x09	sos_button	紧急按钮
0x0A	remote_controller	遥控器
0x0B	keypad	安防键盘
0x0C	doorbell	门铃
0x0D	door_lock	门锁
0x0E	rfid	RFID
0x0F	alarm	报警器
0x10	environment_detector	环境探测器
0x11	others	其它
0xFF	无	无此功能

防区属性说明

取值和 DP=24 （即 zone_attribute） 枚举对应。

编码（十六进制）	标识符	名称
0x00	disarmed	普通防区
0x01	arm	紧急防区
0x02	home	在家防区
0x03	24h	24 小时防区
0x04	delay	延迟防区
0x05	others	其他防区
0xFF	无	无此功能

最多支持 8 个多选防区，0-7 bit 对应位置 1，代表对应的 DP24 枚举值被选中。该功能默认不支持，如果支持则需要增加面板配置项。