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

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

337

0

1.产品概述

1.1型号列表

在打板前，请与妙同工程师确认原理图是否与约定匹配。型号列表见表 1-1 所示。

表 1-1 型号列表

型号	功能说明
MZY-ZB-1560+ZTP06-HA	ZigBee HA 透传模块(带 PA)，配置贴片天线

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	加网按键描述，平时为低电平，上升沿触发，作为加网和退网按键（短按加网，长按退网），浮空输入（需接 10K下拉电阻）。
6	Nc.
7	Nc
8	Status LED	O	状态 LED（绿色），用来单独指示联网状态，完全由无线模块控制。（上电不亮，加网时快闪，加网成功后长亮 2秒后熄灭），状态灯为高电平点亮
9	Tx.	O	串口发 Tx（波特率默认为 57600）
10	Rx.	I	串口收 Rx（波特率默认为 57600）
11	Nc.		（需接 10K 下拉电阻）
12	Nc.		（需接 10K 下拉电阻）
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 的高电平，之后一直保持低电平。若一分钟后，模块没有入网，Status LED 脚之后会一直保持低电平。如果要再执行入网操作，需重复上述步骤。

2.2 恢复出厂设置

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

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

2.3 功能实现

2.3.1数据透传发送

MCU 向 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 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
图 2-1 网口收到数据

2.3.2数据透传接收

ZigBee 模块向 MCU 发送串口数据：
用 zll_test 上位机软件发送数据配置如图 2-2 所示。
图 2-2 zll_test 上位机软件发送数据配置

每点击一次“透传”都会发送一次数据。

2.3.3心跳功能

心跳时间设置为 20min，上报模块的电压状态。由 ZigBee 模块做定时上报。

2.4部分参数配置操作

通过本地串口或网络远程可对串口波特率、入网操作、退网操作等进行配置。配置参数都进入 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.4.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.4.2恢复出厂设置

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

2.4.3启动入网操作

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

2.4.4读取版本号

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-4 所示。

表 3-4 Device ID 表

	Device	Device ID
Lighting	On/Off Light	0x0100
	Dimmable Light	0x0101
	Color Dimmable Ligh	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 Equipmen	0x0401
	IAS Zone	0x0402
	IAS Warning Device	0x0403
	Reserved	0x0404-0xFFFF

簇 ID 表

簇 ID 见表 3-5 所示。

表 3-5 簇 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-6 所示。

表 3-6 Data Types 表

Type Class	Data Type ID	Data Type	Length Of Data(Octets)		Invalid Number	Analog / Discrete
Unsigned integer	0x20	Unsigned 8-bit integer	1		0xff	A
	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
	0x2d	Signed 48-bit integer	6		0x8000000000 00
	0x2e	Signed 56-bit integer	7		0x8000000000 0000
	0x2f	Signed 64-bit integer	8		0x8000000000 000000
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 r	Defined in first octet	0xff in first octet
	0x42	Characte 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 配置电平状态发送所示 reserved 波特率

历史版本

修改日期	修改人	备注
2018-10-12 15:23:57[当前版本]	admin	修正
2018-10-11 18:02:23	admin	CREAT

附件

PNG

337

0