ZLGnet使用说明V1.01
广州致远电子有限公司
ZLGnet 固件用户手册
无线射频通讯
修订历史
目录
1. ZLGnet固件描述 (4)
2. 固件使用方法 (5)
2.1固件下载 (6)
2.2参数说明 (8)
3. ZLGnet通讯实例 (12)
3.1路径查找 (12)
3.2数据通讯 (14)
4. ZLGNET配置 (16)
4.1命令格式 (16)
4.2命令介绍 (16)
4.2.1读取本地配置命令（CCELDev::GetLocalInfo( )） (16)
4.2.2设置通道号命令 (18)
4.2.3设置速率命令 (18)
4.2.4搜索命令 (19)
4.2.5获取信息命令 (19)
4.2.6修改配置命令 (20)
4.2.7复位命令 (20)
4.2.8指定搜索ID命令 (20)
4.2.9设置远程IO命令 (20)
5. ZLGNET通讯 (22)
5.1帧格式 (22)
5.2帧命令 (22)
5.2.1传输数据 (22)
5.2.2查找远程路由表 (23)
5.2.3查找本地路由表 (24)
5.2.4设置本地路由表 (24)
1. ZLGnet固件描述
ZLGnet是致远电子开发的一套无线路由协议，实现底层节点路径查找，保存，更新等路由功能，用户可以简单高效的进行无线数据收发。
ZLGnet的路由策略考虑了各项实际应用当中可能会出现的情况，如节点数目很多，某些节点或所在环境不稳定，暂时性干扰，节点丢失，新增节点等情况，ZLGnet路由协议在权衡速度和稳定性之后，做出最佳路由选择。
ZLGnet固件可实现20级路由路径查找（按照1000米一级计算，可实现20公里的覆盖，应用在城市路灯系统中，可覆盖前后20公里，总共40公里），内部缓存30级节点路径。
注：ZLGnet固件已在网站上公布，使用要求如下：因ZICM2410模块的固件由Boot和应用层两个固件构成，要使用ZLGnet固件必须具备V1.04版本BOOT引导程序，如果您手上的评估板是V1.12版本，可以直接升级，否则需要与当地销售联系更新BOOT程序，或者将评估板寄回致远电子升级。
2. 固件使用方法
ZigBee模块有几种类型的固件，通常您可以在购买时通过标签确知您的模块的固件类型和版本，如果您确定模块中是ZLGnet固件，请直接跳转到2.2节查看参数说明，或者直接到【ZLGnet通讯实例】中查看如何配置使用ZLGnet节点。
如果因为某些原因你能不确定（标签丢失或者需要更换固件等），您可以通过以下方法查看及升级固件，必须是ZLGnet固件才能使用。
图2.1 打开串口
图 2.2 检测设备类型
弹出对话框显示“此串口接的设备是ZLGNET设备”，说明固件为ZLGnet固件。
2.1 固件下载
如果使用标准固件（或者其他非ZLGnet固件）的客户，可以按照以上操作打开串口，点击“ZLG”选项卡，“高级设置”栏，点击“升级”。
图2.3 点击升级固件
选择ZLGnet固件。
图2.4 选择固件
图2.5点击升级
图 2.6 升级成功
图2.7 在此测试设备类型
图2.8 点击获取信息
2.2 参数说明
连接上评估板，打开配置软件，选择串口，点击“打开串口”，如图 2.9所示。
点击“检测设备类型”，查看是否是ZLGnet固件程序。
切换到ZLGnet选项卡，点击“获取信息”。
在主界面（如图 2.12所示）查看参数信息。
图 2.12 主参数界面
关于参数的说明，见表格2-1、表格2-2。
表格2-1 模块版本信息
表格2-2 工作参数
3. ZLGnet通讯实例
本章中，我们通过一个实例来了解如何使用ZLGnet通讯协议。
3.1 路径查找
首先，将两块板子插上PC，假设它们在PC上生成的Com口分别为Com7和Com9，地址分别配置成0x2001，0x2002，配置好之后，在0x2001的板子上添加0x2002的路由路径；
图 3.1 查找路由表
填入目标地址：0x2002，点击“开始查找”。
图3.2 开始查找
查找到路由之后，弹出成功提示框，如图 3.3所示。
图3.3 查找路由成功
路由表详细信息中会显示从本机到目标节点需要经过的跳数“路由级数”，以及路径当中最小的信号强度及节点地址，方便在布网的时候，确定哪一个点的信号不好，如图 3.4所示。
图3.4 路由表项
在Com9的配置界面中，查找到0x2001的路径，如图 3.5所示。
图3.5 路由表项（二）
3.2 数据通讯
我们在Com7口下。按照16进制填入：
A5 07 D1 20 02 00 00 00 00 5A
这串数据的格式参看【5.2.1】，在本章中，直接填上去即可，如图 3.6所示。
-------------------------------------------------------------------------------------------------------------------- 注：通讯协议包括 1.发送数据；2.查找本地路由；3.路径查找；4.设置路由四项，之所以将路径查找和路由查找分开来处理，给客户提供更大的灵活性，用户使用时通过PC编程或者MCU编程，在发送数据之前先查找本地路由是否有路由表，没有则发起路径命令，成功后发送数据，详见第四章。
图 3.6 Com口数据传输
再打开另外一个串口调试软件，打开Com9端口，发送数据
A5 07 D1 20 01 00 00 00 00 5A
图3.7 Com9串口数据传输
注意同样要十六进制格式发送。
接收端即可看到数据。
图 3.8 两个节点之间通讯
4. ZLGNET配置
4.1 命令格式
表1
协议标志为3个字节：0xAC, 0xBC, 0xCD。字节校验：整条命令除校验位外所有字节相加的和（1字节）
ZLGNET配置协议共有11条命令，分别是读取本地配置命令、设置通道号命令、设置速率命令、获取信息命令、修改配置命令、复位命令、指定ID搜索命令。如下表所示：
表2
4.2 命令介绍
4.2.1 读取本地配置命令（CCELDev::GetLocalInfo( )）
表3
设置成功回应如下报文；
表 4
DEV_INFO结构信息如下表所示：
表5 DEV_INFO结构信息
注：红色部分是为了兼容原来固件保留下来的，在配置时不需显示出来。
串口波特率：值为0～10，分别对应波特率：1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200, 230400, 460800；
数据位：5～8；
停止位：1～2；
校验位：0——无校验；
1——奇校验；
2——偶校验；
3——强制为0；
4——强制为1；
4.2.2 设置通道号命令
表6
设置成功回应报文如下;
表7
响应状态如下表所示：
表8
4.2.3 设置速率命令
表9
注：通讯速率0=250k; 1=500k; 2=1M。
设置成功回应报文如下;
表10
4.2.4 搜索命令
表11
设置成功回应报文如下所示。
表12
typedef struct _tagCELDevSearched
{
WORD wType; //设备类型
BYTE iChannel;
BYTE iRate; //速率
WORD iPanID;
WORD wID; //搜索到的设备的本地网络地址BYTE iWorkMode; //0xaa
}TCELDevSearched, CELSCHINFO;
4.2.5 获取信息命令
表13
设置成功回应如下报文；
表14
4.2.6 修改配置命令
表15
设置成功回应如下报文；
表16
4.2.7 复位命令
表17
无返回。设备类型用raninfo.DevType
4.2.8 指定搜索ID命令
表18
设置成功回应报文如下所示;
表19
4.2.9 设置远程IO命令
表20
设置成功回应报文如下所示;
表21