WS7300系列用户指南2

RF_002

上次介绍了用户在拿到利尔达 WS7300系列Wi-SUN 模组时体验Wi-SUN组网的过程，这次我们继续深入了解关于模组的指令， 针对Debug 串口的指令集,该指令集内容主要用于配置、 调试、 状态指示等等。
1.指令分类
· cfg – 配置指令
· rpl – 查看 RPL 路由
· cent – 射频部分硬件配置
· ping6 – Ping 测试
· mac – Wi-SUN MAC
· reboot /heapinfo/ps/ver– 系统指令  
2.具体介绍（具体参数项说明见文档）
简单介绍几个常用的指令，具体的请参考文档；
2.1 cfg 指令
“cfg” 指令用于显示&配置当前所有参数配置， 包括 debug、 csma、 rpl、 dhcp、 wisun 等 15 类参数，下面主要针对几个较常用的参数配置指令进行说明
1) “cfg rpl” 查看 rpl 相关的所有参数配置， 如下：

2) “ cfg wisun ” 查看 wisun 相关的所有参数配置 ，如下：

3) “cfg broadcast” 指令用于查看 broadcast 相关的所有参数配置（该部分参数仅在 root 端需要配置，node 端无需配置， 默认即可）
4) “cfg dbg uart 1” 指令可以使用 debug uart 监控通信内容， 包括 SLIP uart、 timer uart；
5) “cfg reset” 、 “cfg wisun reset” 、 “cfg broadcast reset” 指令用于重置 cfg 相关配置参数， 使其恢复出厂设置， 尽量避免使用；
2.2 RPL 指令
1) “rpl” 指令可以获得以下信息:
· 加入 PAN 后显示其全球 IPv6 地址[2001::]；
· 显示本地链路 IPv6 地址 [fe80::]（由 MAC 地址转换而来） ；
· 显示它的首选父节点的本地链路 IPv6 地址（Node 端） ；
· 显示所有入网的节点及其父节点的全球 IPv6 地址（Border Router 端） ；
2) “rpl repair” 指令有如下功能：
· 对于 Node 端， 触发该 Node 退网后重新入网；
· 对于 Border Router 端， 触发所有已入网节点退网并重新入网；
3) “rpl dhcps” 获取 DHCPv6 列表， 即获取 Node 的全球 IPv6 地址与其 MAC 地址的对应列表， 该功能只在 Border Router 端有效。
4) “rpl dis” 触发 node 设备发送 RPL DIS 信息， 该指令仅在 node 端有效；
5) “ rpl dio” 触发 root 设备发送 RPL DIO 信息， 该指令仅在 root 端有效；
2.3 RPL Neighbor 指令
1) “nbr” 指令用于显示邻居列表内基于 EUI64 地址的各邻居节点的使用状况；

2) “nbr link” 显示与邻居节点间的链路质量， ETX 数值越大， 说明传输的能力越弱（ ETX 代表预期的传输次数） ， ETX（ 最小值为 128） 计算方式如下：ETX=尝试传输的次数/收到的确认帧数*128

3) “nbr reg” 指令用于显示所有连接至该设备的子节点地址（ MAC 地址和 IPv6 全球地址） ；
2.4  cent 指令
1) “cent nv” 获取射频参数值， 显示如下， 除了功率和 MAC 地址外， 其它参数是出厂时经过校准后写入的， 不建议修改掉。

2) “cent band” 指令显示当前频点， 注： 在测试模式、 和非测试&跳频模式下， 显示的为固定频点， 可以通过“cent band 频点” 指令格式设置当前频点；
3) “cent dctune” 指令用于显示当前晶体调谐参数（频偏偏移量） ， 可以通过“cent dctune 数值” 指令格式设置当前调谐参数；
4) “cent dwen [opt]” 操作数据白化功能， “0” 代表关闭、 “1” 代表开启；
5) “ cent mod [idx]” 设置调制参数， [idx]=调制指数*1000， 例如： 如果设置调制指数为 0.5 则指令是“cent mod 500” ；
6) “ cent rate [val]” 设置当前通信速率， 例如设置速率 50kbps 则指令是“ cent rate 50000” ；
7) “ cent rssi [val]” 读取当前接收到的信号强度， 数值设置为读取次数， 例如“cent rssi 50” ；
8) “ cent pwr” 查询当前发射功率值， 修改功率可以用指令“ cent pwr 数值” ， 例如“ cent pwr 5” ；
9) “ cent hop [freq] [freq] [spacing] [delay]” 指令用于查询指定频段范围内的 rssi 结果
10) “ cent txcw [opt]” 指令用于发射连续单载波， “0” 表示开启发射、 “ 1” 表示关闭发射；
11) “ cent txcm [opt]” 指令用于发射连续调制波， “ 0” 表示开启发射、 “ 1” 表示关闭发射；
12) “ cent rxc [opt] [pktsz]” 用于接收连续的数据包， 例如： “ cent rxc fa” ；
13) “ cent txc [opt] [-dinp] [pktsz] [dlyus]” 用于发射连续的数据包， 例如： “cent txc fa 64 000” ，说明： 包长度 250 字节、 100 包、 包间隔 1ms；
14) “cent nv rftest [opt]” 指令用于设置工程测试模式， “0” 表示退出测试模式、 “1” 表示进入测试模式，注意： 指令发送后需要复位模块后才能生效；
2.5 Ping指令
ping 指令可以用于测试某个链路是否可以正常通信（ 双向通信） ， 指令格式为：ping6+地址+选项 1+选项 2+…
1) 地址可以是 IPv6 全球地址、 链路本地地址、 多播地址（ 使用“rpl” 指令可以查看设备各地址） ；
2) 选项包括以下参数：
s: TX payload 长度， max=1232；
t: 超时时间， 单位是： ms；
c: 测试次数， max=65534， 0=无穷大；
r: 远程控制命令；
举例：
使用 IPv6 全球地址 [NETWORK_PREFIX::3] Ping 测试、 超时时间 3 秒、 发射次数 3 次；

使用 ping6 指令远程修改节点（IPv6 全球地址 4） 发射功率为 18dBm；  

2.6 Wi-SUN MAC指令
WiSUN 定义了一些特殊的数据包， 用来由用户通过发送指令“mac send pas/pa/pcs/pc” 来实现一些测试目的， 具体如下：
1) pas（PAN 广播请求帧） 正在入网的 node 设备发射来控制邻居节点发射 pa 帧的频率；
2) pa（PAN 广播帧） 由已入网的 node 或 root 设备发射， 以提供准备入网节点发现和选择几个可用 pan中的一个以确保连接尝试安全所需的最小信息；
3) pcs（PAN 配置请求帧） 由节点发射用来控制邻居节点发射 pc 帧的频率；
4) pc（PAN 配置帧） 由一个节点传输， 以通知它的邻居它的频道跳跃时间表， 活动群密钥， 当前时间和 PAN 网络的各种其他细节的安全操作；  
2.7 系统指令
1) “reboot” 指令用户触发模块复位操作；  
2) “heapinfo” 指令用于显示系统剩余的堆内存；
3) “ps” 指令用于显示系统中所有的进程；
4) “ver” 指令用于显示软件和固件版本号；  


更多详细信息请参考本份文档