作者:admin于 2018年10月11日 发布在分类 / 产品相关 / 通讯模块 / 模块硬件规格 下,并于 2018年10月12日编辑

ZigBee HA 透传 MZY-ZB-1560-ZTP17-HA 模块软件规格书

276

0

1.产品概述

1.1型号列表

在打板前，请与妙同工程师确认原理图是否与约定匹配。以下型号的引脚定义完全相同，型号列表见表 1-1 所示。

表 1-1 型号列表

型号	功能说明
MZY-ZB-1560-ZTP17-HA	ZigBee HA 低功耗透传模块，配置陶瓷天线
MZY-ZB-35A3-ZTP17-HA	ZigBee HA 低功耗透传模块，配置陶瓷天线
MZY-ZB-3564-ZTP17-HA	ZigBee HA 低功耗透传模块，配置陶瓷天线，带屏蔽罩，FCC 认证
MZY-ZB-3565-ZTP17-HA	ZigBee HA 低功耗透传模块，配置陶瓷天线
MZY-ZB-3567-ZTP17-HA	ZigBee HA 低功耗透传模块，配置陶瓷天线
MZY-ZB-35A2-ZTP17-HA	ZigBee HA 低功耗透传模块，配置 IPEX 天线接口

1.2 产品 I/O 口定义

MZY-ZB-1560 模块接口定义如图 1-1 所示。

图 1-1 MZY-ZB-1560 模块接口定义

ZigBee HA 透传模块 I/O 口定义如表 1-2 所示。

表 1-2 ZigBee HA 透传控制模块 I/O 口定义

引脚号	功能名称	I/O	描述(多行代表复用)
1	VDD	I	电源输入（+3.3V）
2	Nc.
3	Nc.
4	GND.	地
5	FAC_RESET	I	加网按键描述，平时为低电平，上升沿触发，作为加网和退网按键（短按加网，长按退网），浮空输入。
6	Nc
7	Nc
8	Status LED	O	状态 LED（绿色），用来单独指示联网状态，完全由无线模块控制。（上电不亮，加网时快闪，加网成功后长亮 2 秒后灭），状态灯为高电平点亮
9	Tx.	O	串口发 Tx（波特率 57600）
10	Rx	I	串口收 Rx（波特率 57600）
11	WakeUp_MCU	O	模块唤醒外部设备引脚（高有效）
12	WakeUp_Mod.	I	唤醒 ZigBee 模块的引脚（高有效）
13	GND.		地
14	RESETn		系统 RESET 信号，低电平有效
15	DC	I	DEBUG 口,悬空即可
16	DD	I/O	DEBUG 口,悬空即可
17	VDD		电源输入（+3.3V）

2.产品功能说明

2.1 组网

在模块已经是出厂设置的状态下。给 FAC_RESET（PIN5）一个高电平，可对模块进行组网操作。
按下网关‘允许入网’按键，让网关允许其他设备加入网关，给 FAC_RESET 脚一个高电平，若 Status LED 脚检测到有高低电平的变化，则表示模块执行入网操作，若入网成功，Status LED 脚会持续 3s 的高电平，之后一直保持低电平。

2.2 恢复出厂设置

给 FAC_RESET 脚 10s 以上的高电平，若检测到 Status LED 脚持续 3s 高电平，则表示该模块退网操作成功。

恢复出厂设置后，波特率为默认的 57600。

2.3 功能实现

2.3.1 数据透传发送

当要向 ZigBee 模块发送数据时，需先给 WakeUp_Mod 一个高电平来唤醒 ZigBee 模块，再发串口数据。
例如发送：
00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 10 11 12 13 14 15 16 17 18 19 1A 1B 1C1D 1E 1F 20 21 22 23 24 25 26 27 28 29 2A 2B 2C 2D 2E 2F 30 31 32 33 34 35 36 37 38
网口会收到数据如图 2-1 所示。

图 2-1 网口收到数据

2.3.2 数据透传接收
当 ZigBee 模块要给 MCU 发串口数据时，会先给 WakeUp_MCU 一个高电平，然后开始向 MCU发送数据。
用 zll_test 上位机软件发送数据配置如图 2-2
图 2-2 zll_test 上位机软件发送数据配置

每点击一次“设置”都会发送一次数据。

2.3.3 心跳功能

心跳时间设置为 20min，心跳内容上传电池（低压）状态。由 ZigBee 模块做定时上报。每次报警都会重新计算心跳计时。

2.3.4低压功能

DC3V 供电，低压在心跳中体现，并在电池状态跳变为低压时立即上报低压。
电池电量由 ZigBee 模块检测，当电池电压低于 2.4V 时，ZigBee 发送低压报警标志位给网关，APP 提醒用户更换电池。

2.4网络稳定性维护

1、当设备发现父节点丢失时，会全信道找网两次，每次找网 1min，每次间隔 20min；找网两次后便不再找网。
2、每 2h 会找一次网。

2.5部分参数配置操作

通过本地串口或网络远程可对串口波特率、低功耗的唤醒时间、低功耗的唤醒时长、入网操作、退网操作进行配置。
配置参数都进入 Flash，掉电不会丢失。
配置命令帧均为低字节在前的小端传输，其格式如表 2-1 所示。

表 2-1 部分参数配置命令帧

FB BF	Length	CmdCode	Data	Checksum
帧头	命令长度	命令控制码	命令数据	校验和
2byte	1byte	1byte	（Length-1）byte	1byte

注：校验和为 CmdCode 和 Data 数据的 XOR 校验和。可参考以下代码：
unsigned char calcFCS(unsigned char *pMsg, unsigned char len)

{

unsigned char result = 0; while (len--)
{

result ^= *pMsg++;

}

return result;

}

2.5.1配置波特率

如表 2-2，模块有五种波特率可供选择配置。

表 2-2 波特率配置命令帧

波特率	命令帧
9600	FB BF 02 01 00 01
19200	FB BF 02 01 01 00
38400	FB BF 02 01 02 03
57600	FB BF 02 01 03 02
115200	FB BF 02 01 04 05

2.5.2配置保持唤醒的时间

CmdCode：0x02 Length：0x05
单位为 ms
例：

1s (0x03E8) FB BF 05 02 E8 03 00 00 E9

10S (0X2710) FB BF 05 02 10 27 00 00 35

20S (0X4E20) FB BF 05 02 20 4E 00 00 6C

30s (0x7530) FB BF 05 02 30 75 00 00 47

若配置成功，则会将配置参数通过串口进行响应！响应帧的数据同配置帧数据一样。

2.5.3配置睡眠的时间

CmdCode：0x03 Length：0x03
单位为 100ms
例：
5s = 50*100ms (0x0032) FB BF 03 03 32 00 31
若配置成功，则会将配置参数通过串口进行响应！响应帧的数据同配置帧数据一样。

2.5.4恢复出厂设置

CmdCode：0x04 Length：0x01 FB BF 01 04 04
若配置成功，如同按键恢复出厂一样，有 3s 的 LED 灯亮。

2.5.5启动入网操作

CmdCode：0x05 Length：0x01 FB BF 01 05 05
若配置成功，如同按键恢复出厂一样，LED 灯快闪。

2.5.6读取版本号

CmdCode：0x06 Length：0x01 FB BF 01 06 06
CmdCode 后面的两个字节为版本号的 16 进制形式。例

FB BF 03 06 64 02 60
FB BF 03 06 64 01 63
0x64 换算成十进制为 100，即版本号为 V1.0.0，02 表示的是 Router（即非低功耗）版本的模块，01 表示的是 PowerSave（即低功耗）版本的模块。

3.网关接口

3.1状态上报

状态上报的数据包中包含了设备的报警状态、电池是否低电欠压等信息。透传设备电压状态上报数据格式见表 3-1。
例：70 0E 73 9F 08 01 00 02 20 00 20 20 35 00 20 00

表3-1 透传设备电压状态上报数据格式

注：
1、簇ID为0x0001表示本包数据为power configuration 电源配置相关的簇信息。（详细的簇ID请参见表3-6）。
2、电压值单位为100mv，20即32*100mv = 3.2v
3、属性ID 0x0020：后接数据是电池当前电压值
0x0035：后接数据位电压欠压报警信息
4、0x00：电压正常，0x01：电池欠压。

3.2网口数据透传发送

数据透传发送的数据如下：
S:4F 00 02 22 2E 11 FE A7 46 EB 79 0B 03 40 00 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 10 11 12 13 14 15 16 17 18 19 1A 1B 1C 1D 1E 1F 20 21 22 23 24 25 26 27 28 29 2A 2B 2C 2D 2E 2F 30 31 32 33 34 35 36 37 38 39 3A 3B 3C 3D 3E 3F

其对应的数据格式如表3-2所示。

表3-2 透传设备数据发送数据格式

3.3网口数据透传接收

数据透传接收的数据如下：
R:70 4A EB 79 0B 00 00 01 0C 41 42 40 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 10 11 12 13 14 15 16 17 18 19 1A 1B 1C 1D 1E 1F 20 21 22 23 24 25 26 27 28 29 2A 2B 2C 2D 2E 2F 30 31 32 33 34 35 36 37 38 39 3A 3B 3C 3D 3E 3F
其对应的数据格式如表3-3所示。

表3-3 透传设备数据接收数据格式

Device ID 表

Device ID 见表 3-5 所示。

表 3-5 Device ID 表

	Device	Device ID
Lighting	On/Off Light	0x0100
	Dimmable Light	0x0101
	Color Dimmable Light	0x0102
	On/Off Light Switch	0x0103
	Dimmer Switch	0x0104
	Color Dimmer Switch	0x0105
	Light Sensor	0x0106
	Occupancy Sensor	0x0107
	Reserved	0x0108 – 0x1FF
Closures	Shade	0x0200
	Shade Controller	0x0201
	Window Covering Device	0x0202
	Window Covering Controller	0x0203
	Reserved	0x0204 – 0x2FF
HVAC	Heating/Cooling Unit	0x0300
	Thermostat	0x0301
	Temperature Sensor	0x0302
	Pump	0x0303
	Pump Controller	0x0304
	Pressure Sensor	0x0305
	Flow Sensor	0x0306
	Mini Split AC	0x0307
	Reserved	0x0308 - 0x3FF
Intruder Alarm Systems	IAS Control and Indicating Equipment	0x0400
	IAS Ancillary Control Equipment	0x0401
	IAS Zone	0x0402
	IAS Warning Device	0x0403
	Reserved	0x0404-0xFFFF

簇 ID 表

簇 ID 见表 3-6 所示。

表 3-6 簇 ID 表

Functional Domain	Cluster Name		Cluster ID Certifiable
General	Basic		0x0000
General	Power Configuration		0x0001
General	Device Temperature Configuration		0x0002
General	Identify		0x0003
General	Groups		0x0004
General	Scenes		0x0005
General	On/Off		0x0006
General	On/Off Switch Configuration		0x0007
General	Level Control		0x0008
General	Alarms		0x0009
General	Time		0x000A
General	Binary Input (Basic)		0x000F
General	Partition		0x0016
General	Power Profile		0x001a
General	EN50523Appliance Control		0x001b
General	Poll Control		0x0020
Closures	Shade Configuration		0x0100
Closures	Door Lock		0x0101
Closures	Window Covering		0x0102
HVAC	Pump Configuration and Control		0x0200
HVAC	Thermostat		0x0201
HVAC	Fan Control		0x0202
HVAC	Thermostat User Interface Configuration		0x0204
Lighting	Color Control		0x0300
Measurement & Sensing	Illuminance Measurement		0x0400
Measurement & Sensing	Illuminance Level Sensing		0x0401
Measurement & Sensing	Temperature Measurement	0x0402
Measurement & Sensing	Pressure Measurement	0x0403
Measurement & Sensing	Flow Measurement	0x0404
Measurement & Sensing	Relative Humidity Measurement	0x0405
Measurement & Sensing	Occupancy Sensing	0x0406
Security and Safety	IAS Zone	0x0500
Security and Safety	IAS ACE	0x0501
Security and Safety	IAS WD	0x0502
Smart Energy	Metering	0x0702
Home Automation	EN50523 Appliance Identification	0x0b00
Home Automation	Meter Identification	0x0b01
Home Automation	EN50523 Appliance events and Alert	0x0b02
Home Automation	Appliance statistics	0x0b03
Home Automation	Electricity Measurement	0x0b04
Home Automation	Diagnostics	0x0b05

Data Types 表

Data Types 见表 3-7 所示。

表 3-7 Data Types 表

Type Class	Data Type ID	Data Type	Length Of Data(Octets)	Invalid Number	Analog / Discrete
Unsigned integer	0x20	Unsigned 8-bit	1	0xff	A
	0x20	integer
	0x21	Unsigned 16-bit integer	2	0xffff
	0x22	Unsigned 24-bit integer	3	0xffffff
	0x23	Unsigned 32-bit integer	4	0xffffffff
	0x24	Unsigned 40-bit integer	5	0xffffffffff
	0x25	Unsigned 48-bit integer	6	0xffffffffffff
	0x26	Unsigned 56-bit integer	7	0xffffffffffffff
	0x27	Unsigned 64-bit integer	8	0xffffffffffffffff
Signed integer	0x28	Signed 8-bit integer	1	0x80	A
	0x29	Signed 16-bit integer	2	0x8000
	0x2a	Signed 24-bit integer	3	0x800000
	0x2b	Signed 32-bit integer	4	0x80000000
	0x2c	Signed 40-bit integer	5	0x8000000000
	0x2c	Signed 40-bit integer	5	0x8000000000
	0x2d	Signed 48-bit integer	6	0x8000000000 00
	0x2e	Signed 56-bit integer	7	0x8000000000 0000
	0x2f	Signed 64-bit integer	8	0x8000000000000000
Enumeration	0x30	8-bit enumeration	1	0xff	D
	0x31	16-bit enumeration	2	0xffff
	0x32 –0x37	Reserved	-	-
Floating point	0x38	Semi-precision	2	Not a Number	A
	0x39	Single precision	4	Not a Number
	0x3a	Double precision	8	Not a Number
	0x3b –0x3f	Reserved	-	-
String	0x40	Reserved	-	-	D
	0x41	Octet string	Defined in first octet	0xff in first octet
	0x42	Character string	Defined in first octet	0xff in first octet
	0x43	Long octet string	Defined in first two octets	0xffff in first two octets
	0x44	Long character string	Defined in first two octets	0xffff in first two octets
	0x45 –0x47	Reserved	-	-
Ordered sequence	0x48	Array	2 + sum of lengths of contents	0xffff in first 2 octets	D
	0x49 -0x4b	Reserved	-	-
	0x4c	Structure	2 + sum of lengths of contents	0xffff in first 2 octets
	0x4d -0x4f	Reserved	-	-
Collection	0x50	Set	Sum of lengths of contents	Number of elements returned as 0xffff	D
	0x51	Bag	Sum of lengths of contents	Number of elements returned as 0xffff
	0x52 -0x57	Reserved	-	-
Reserved Time	0x58 –0xdf	-	-	-	-
	0xe0	Time of day	4	0xffffffff	A
	0xe1	Date	4	0xffffffff
	0xe2	UTCTime	4	0xffffffff
	0xe3 –0xe7	Reserved	-	-
Identifier	0xe8	Cluster ID	2	0xffff	D
	0xe9	Attribute ID	2	0xffff
	0xea	BACnet OID	4	0xffffffff
	0xeb –0xef	Reserved	-	-
Miscellaneous	0xf0	IEEE address	8	0xffffffffffffffff	D
	0xf1	128-bit security -key	16	-
	0xf2 –0xfe	Reserved	-	-
Unknown	0xff	Unknown	0	-	-

访问权限

创建人	admin
工作小组	MIOC物联网开放平台
文档编辑权限	创建者私有
文档阅读权限	来自分类
分类阅读权限	所有人
分类编辑权限	所有人
分类审核权限	无

标签

数据配置模块 bitinteger 电平状态发送所示低功耗功耗

历史版本

修改日期	修改人	备注
2018-10-12 15:09:26[当前版本]	admin	修正
2018-10-11 17:39:49	admin	CREAT

附件

PNG

276

0