WIOTA 快速配置

1 功能介绍

1.1 功能简介

为快速体验WIOTA的功能，整理了常用的配置组合，使用此功能可以快速开启WIOTA的通信测试。

1.2 功能打开方式

同步IOTE和异步IOTE: 通过menuconfig--->wiota app--->open quick connect，选择打开或关闭快速配置功能(默认为开)

同步AP：默认打开

2 同步AP和IOTE的接口

2.1 API接口

以下接口全声明在“quick_connect.h”文件中。

启动快速配置

同步IOTE：int wiota_quick_connect_start(unsigned char freq,e_qc_mode mode);

停止快速配置

int wiota_quick_connect_stop(void);

2.2 AT接口

以下接口全声明在“at_wiota.h”文件中。

启动/停止快速配置

AT+WIOTAQC=onoff,freq,mode

2.3 参数定义

onoff：0:关闭，1:打开

freq：频点（范围：0~200)

mode：模式，定义如下所示：

0：//短距高并发//近距离，连接大量设备，高频上报场景
1：//中距高速率//室内整层覆盖，室外次公里级覆盖，高速率传输
2：//中距高并发//室内整层覆盖，室外次公里级覆盖，高频上报场景
3：//远距离通信//室内多层楼覆盖，室外公里级覆盖
4：//超远距离通信//最远通信距离，传输时间较长

以下是WIoTa 同步协议测距表

测试备注：

1.测试设备手持高度，开阔道路，无严重遮挡；
2.上下行80字节，单播发送；
3.同步协议带宽200k；
4.测试环境高度、遮挡、干扰等情况存在差异，仅供参考

通信场景	场景说明	上行型号	下行型号	symbol符号长度	dlul上下行配比	mcs速率级别	dBm上行发射功率	dBm下行发射功率	km通信距离
0：短距高并发	近距离，连接大量设备，高频上报场景	UCM200 / UCM200T	UCM202	128	1:2	2	22	24	0.3~0.6
1：中距高速率	室内整层覆盖，室外次公里级覆盖，高速率传输	UCM200 / UCM200T	UCM202	256	1:1	3	22	24	0.5~1
2：中距高并发	室内整层覆盖，室外次公里级覆盖，高频上报场景	UCM200 / UCM200T	UCM202	256	1:2	2	22	24	0.5~1
3：远距离通信	室内多层楼覆盖，室外公里级覆盖	UCM200T	UCM202	512	1:1	0	22	24	1~2
4：超远距离通信	最远通信距离，传输时间较长	UCM200T	UCM202	1024	1:1	0	22	24	2~3

2.4 示例

AP侧：
//参数含义：
//1:启动快速链接，
//100:频点，
//0:模式
发→◇AT+WIOTAQC=1,100,0

//向iote发送广播
//参数含义：
//0:(dataid)任意值，
//10:数据长度,
//0:普通广播,
//1000:timeout，
//0:非阻塞发送
发→◇AT+WIOTABC=0,10,0,1000,0

收←◆>

发→◇123456789

收←◆OK

//参数含义:
//0:发送成功,
//0x0:(dataid)任意值
收←◆+WIOTABC:0,0x0

//接收到iote的数据
//参数含义:
//0x63c8b54c:iote的userid，
//0：(type)接入短消息,
//10:上报的数据长度
收←◆+WIOTARECV:0x63c8b54c,0,10:
123456789

//停止快速链接
//参数含义：
//0:停止快速链接，
//100:频点，
//0:模式
发→◇AT+WIOTAQC=0,100,0

收←◆OK


IOTE侧：
//参数含义：
//1:启动快速链接，
//100:频点，
//0:模式
发→◇AT+WIOTAQC=1,100,0

//回显详细配置，
//参数含义：
//63c8b54c：userid，
//100：freq频点
//0：symbol_len字符长度,
//1:dlul_ratio上下行比例,
//1:group_num上行group速率,
//22:cur_power当前功率,
//24:ap_tx_power ap发送功率,
//2:mcs当前速率
收←◆+QCSTART:63c8b54c,100,0,1,1,22,24,2

收←◆OK

//回显链接ap过程
//参数含义
//100：频点
//-89：当前rssi
//1:同步状态，1表示同步成功
收←◆+QCCONN:100,-89,1

//回显链接ap结果
//参数含义
//63c8b54c：模组的userid
//100：当前频点
//-89：当前rssi
//succ:同步成功
收←◆+QCRESULT:63c8b54c,100,-89 SUCC

//接收到ap的广播消息
//参数含义：
//1:type广播消息，
//10:数据长度，
//123456789:数据
收←◆+WIOTARECV,1,10,123456789

//向ap发送数据
//参数含义：
//1000:超时时间
//10:数据长度
发→◇AT+WIOTASEND=1000,10

收←◆>
发→◇123456789

收←◆SEND SUCC

//停止快速链接
//参数含义：
//0:停止快速链接，
//100:频点，
//0:模式
发→◇AT+WIOTAQC=0,100,0

收←◆OK

3 异步IOTE的接口

3.1 API接口

以下接口全声明在“quick_connect.h”文件中。

启动快速配置 int wiota_quick_connect_start(unsigned short freq,e_qc_mode mode);

停止快速配置 int wiota_quick_connect_stop(void);

3.2 AT接口

以下接口全声明在“at_wiota.h”文件中。

启动/停止快速配置 AT+WIOTAQC=onoff,freq,mode

2.3 参数定义

freq：频点，范围(200k带宽：0~200,25k带宽：0~1600）

mode：模式，定义如下所示：

0：//短距高速率
1：//短距强穿透
2：//中距高速率
3：//中距强穿透
4：//远距离通信//室内多层楼覆盖，室外公里级覆盖
5：//超远距离通信//最远通信距离，传输时间较长

以下是WIoTa 异步协议测距表

测试备注：

1.测试设备手持高度，开阔道路，无严重遮挡；
2.上下行80字节，单播发送；
3.测试环境高度、遮挡、干扰等情况存在差异，仅供参考

通信场景	上行型号	下行型号	symbol符号长度	band带宽	mcs速率级别	subnum子帧数	dBm下行发射功率	km通信距离
0：短距高速率	UCM200 / UCM200T	UCM200 / UCM200T	128	200	3	8	22	0.3
1：短距强穿透	UCM200 / UCM200T	UCM200 / UCM200T	128	25	0	8	22	0.5~0.8
2：中距高速率	UCM200 / UCM200T	UCM200 / UCM200T	256	200	2	8	22	0.5~1.2
3、中距强穿透	UCM200 / UCM200T	UCM200 / UCM200T	256	25	0	8	22	1~1.5
4：远距离通信	UCM200T	UCM200T	512	25	0	8	22	1~2
5：超远距离通信	UCM200T	UCM200T	1024	25	0	8	22	2~3

3.4 示例

//启动快速配置
//参数含义
//1：启动快速链接
//100：频点
//0：模式
发→◇AT+WIOTAQC=1,100,0

//回显详细配置,
//参数含义：
//100：freq当前频点,
//0:symbol_len字符长度,
//1:bandwidth带宽,
//8:subframe_num子帧数,
//3:mcs当前速率,
//22:cur_power当前功率
收←◆+QCSTART:100,0,1,8,3,22

收←◆OK

//回显链接过程
//参数含义
//63c8b54c：自身userid
//100：当前频点
收←◆+QCCONN:63c8b54c,100

//接收另外的终端发送的信息
//参数含义：
//-58:当前rssi
//31:当前snr
//1：type广播数据
//0:上报结果succ
//10:数据长度
//123456789:数据
收←◆+WIOTARECV,-58,31,1,0,10,123456789

//向另外的终端发送信息
//参数含义
//1000：超时时间
//10：数据长度
//0：对方userid，若为0表示广播
发→◇AT+WIOTASEND=1000,10,0

收←◆>
发→◇123456789

收←◆SEND SUCC
OK

//停止快速配置
//参数含义
//0：停止快速链接
//100：频点
//0：模式

发→◇AT+WIOTAQC=0,100,0

收←◆OK