WIoTa 协议版本更新说明

WIoTa
1

WIoTa 协议源码下载地址

终端侧代码：GitHub - ucchip/wiota_dev_customer
基站侧代码：GitHub - ucchip/wiota_ap_customer
异步节点代码：GitHub - ucchip/wiota_async_customer: WIoTa async code

备用地址：
终端侧代码 ：wiota_dev_customer: WIoTa IoTE 。
基站侧代码 ：wiota_ap_customer: WIoTa AP CUSTOMER 。
异步节点代码 ：wiota_async_customer: WIoTa async code 。

:watermelon: :arrow_down: :arrow_down: :arrow_down: 最新版本说明见底部

2022.01.16
同步v2.2和异步v2.5版本更新了！！！请有需要的及时更新。

------同步主要修改点：
AP侧：
1、修改发送接口超时时间设置过短导致的后续发送返回结果异常问题，建议超时时间不能小于当前配置下的一帧的时间
2、修改发送timer启动时机为发送第一个包时启动，避免数据堆积过多时，还未发送就以超时的情况
3、修改发送数据at指令在数据发送失败或超时后at为返回结果的问题
4、修改link文件中cce trace地址配置错误导致的无法抓取cce log问题
终端侧：

  1. OTP功能更新，校准数据不会被擦除
  2. 扫频接口更新，增加子网配置，可频点和子网配对扫频
  3. 协议栈测试bug修复
  4. 温度曲线更新

------异步主要修改点：

  1. OTP功能更新，校准数据不会被擦除
  2. 增加快速扫频功能，返回RSSI列表
  3. 温度曲线更新
  4. rtthread at bug
  5. 基带挂死检测和自动reset功能
  6. 打开bit加扰功能，数据全0也可传输
  7. 900M频点频偏bug修复
  8. 基带测试bug修复
  9. 完成单播/广播接收后快速停止接收过程优化
  10. 基带版本更新
2 个赞
4

WIoTa同步版本V2.3已更新，新增feature如下，欢迎更新体验：

终端修改：

  1. 扫频上报频点个数更新，不再限制为最优的4个
  2. run之后可动态修改userid、subsysid、频点，需要先disconnect再配置，再重新connect
  3. 断开连接的bug修复
    AP修改如下：
    1、run之后可以动态修改subsysid、频点
    2、终端接入上报优化
5

WIoTa同步v2.4版本已更新：
终端修改如下：

  1. 超低功耗唤醒功能（终端作为paging休眠和被唤醒方）
  2. 组播功能
  3. 自动功率bug修复
  4. 系统配置增加，bitscb和oldSubsysV，新版本默认分别为1和0，如果要v2.4之前的版本通信，需要将这两个值设置为0和1
  5. IDLE态下行接收默认打开，以防止终端异常重新同步后，AP无法直接发下行数据
  6. rtc闹钟mask设置bug修复
  7. 开机初始化默认重置uart IO配置，防止休眠唤醒后uart异常
  8. sleep前清除uart fifo，防止休眠唤醒后uart异常
  9. 静态数据备份问题
  10. 量产流程string问题
  11. 扫频后自动重置子网ID和频点
  12. 断开同步bug修复
  13. 帧长计算更新
  14. IDLE和NULL状态下处理异常短消息

AP修改如下：

  1. 修改ota发送的slot冲突，cce新增保护机制，修改ota后终端无法接收下行的问题
  2. 发送下行和发送广播接口新增参数void *para，改参数可在非阻塞发送时传入发送数据的地址，在数据发送完成后会将该参数通过callback返回，方便用户知道具体哪条数据的发送情况
  3. 更新发送下行和广播的at，兼容新参数和非阻塞发送，去除单独的非阻塞发送at指令
  4. 新增gps授时功能和1588协议授时功能（注意如果开启GPS授时，在GPS运行期间会占用50K左右内存，过程大概持续3分钟左右，授时完成后GPS停止，会释放占用内存），可通过接口选择开启gps或1588，不可同时开启，接口使用参考application/time_service_demo.c
  5. WIoTa协议栈代码和GPS代码段划分，请合并最新的link文件
  6. 子网配置增加旧版本（v2.3之前的版本）兼容标志位（old_subsys_v），默认为0，表示匹配v2.4的iote，如果只升级AP不升级iote，该标志位填1
  7. 子网配置增加比特加扰标志位（bitscb），默认为1，表示开启
  8. AP默认关闭了iote_info_list和ap_state_list，与其相关的api和at将失效，意味着AP不再存储boostlevel 0的iote的任何信息，只做数据传输，此改动后AP能接入的boostlevel 0的iote个数将不再有限制（不代表同时连接态的数量）
  9. AP新增paging tx相关api和at，可用ap唤醒iote
  10. AP新增组播发送相关api和at，发送前需知道有效组播id（iote设置的id）并通过接口设置，最多支持8个不同的组播id
  11. AP新增查询AP8288运行状态接口和at，只能通过该返回值判断异常或正常，当异常时不能判断导致异常的原因

AP和终端的API文档、AT文档、静态数据等在线文档均已更新

6

同步v2.5和异步v2.7版本更新了！！！请需要的同时及时到github更新，具体修改如下：
v2.5_ap8088修改如下：
1、修改下行连续数据包模式bug
2、子网配置移除系统id，请注意适配
3、提高了协议栈线程优先级
4、协议栈搬数改为spi标准接口，避免直接二次开发使用spi发生冲突，请对比合入spi驱动文件
5、修改paging tx bug

v2.5_iote修改如下：
1. 系统配置中删除系统ID
2. 超低功耗唤醒配置，增加extra period设置，可额外继续sleep一段时间
3. 修复超低功耗唤醒和RTC定时唤醒混用bug
4. 修复连续传输模式bug
5. 修复扫频bug，增加扫频结果中子网ID上报
6. 增加低功耗中物理层gating接口

v2.7_async修改如下：
1. 接收单播数据结果中增加分包大小和发送端功率
2. 物理层是否IDLE态查询接口
3. 优化低功耗时的数据接收成功率
4. 超低功耗唤醒配置，增加extra period设置，可额外继续sleep一段时间
5. 修复超低功耗唤醒和RTC定时唤醒混用bug
6. 修复基带数据mask异常bug

8

异步v2.8版本更新了！！！具体更新如下：

  1. 更新app驱动demo
  2. 修复paging tx和数据发送bug
  3. 按子帧发送api更新
  4. at波特率设置并保存进静态数据
  5. spi cs唤醒bug修复（uc_boot_strap.c更新！）
  6. 唤醒原因接口
  7. 外部32K晶振设置api
  8. license功能更新，暂未启用
  9. 指定帧头发送数据功能，上报接收时刻子帧边界
  10. 语音数据加速功能
  11. 获取rf状态api更新
  12. 获取当前时刻rf counter
9

同步v2.6版本更新了！

AP修改如下：
1.修改ap8288 gpio7复用为第一功能后（ap_sync），由于gpio7接地情况的不同导致有些版子出现dfe挂死问题，上层表现为协议栈停止运行或扫频超时
2.修改多线程临界区处理不当，导致下行任务异常触发断言的问题
3.关闭log口（uart1）rx中断，避免rx悬空状态接收到乱码问题，同时关闭FINSH功能（因为FINSH功能会重新打开rx中断），如需使用请用menuconfig配置打开
4.修改通过userid查询该id在帧结构位置信息的接口，请对比uc_wiota_api.h
5.修改上行接收重复包处理时，长度计算错误导致的内存越界问题，该问题会直接耗光内存池并导致程序卡死
6.将spi操作接口放到了packages/slave_uc8x88/目录下，二次开发是时请使用该接口，避免和协议栈发生冲突
备注：禁止在回调函数（包括接受回调和发送数据回调）里面加延迟操作，避免在回调函数里做大量操作！！！

IOTE修改如下:
1.修复paging时，32K时钟降频导致检测间隔不准的问题
2.修复上行失败时，继续接收下行的bug
3.唤醒原因API
4.外部32K晶振设置api
5.spi cs唤醒bug修复（uc_boot_strap.c更新！）
6.协议栈代码空间增加（link.flash.ld更新！）
7.默认at波特率保存到静态数据
8.LE模组的功率表更新，tx mode api设置（LE模组设为0）

10

同步v2.7版本和异步v2.9更新了，相关文档也已更新，具体内容如下：
AP：
1. 增加同步paging功能及相关api和at指令
2. 增加驱动demo，在application目录下
3. uboot刷写ap8288镜像增加校验，AT串口（uart0）默认不输出uboot的打印，uboot镜像更新
4. 修改分区不当导致OTA无法升级的问题，link文件更新
5. 1588协议授时精度优化
6. 优化协议栈log
IOTE：
1. 修复协议栈错误数据异常处理问题
2. uboot更新，默认配置及打印更新
3. 修复超长数据发送异常处理问题
4. 更新tcxo校准频偏配置和保存
5. otp write cache miss问题修复
6. at波特率存入静态数据
7. 内存检查at
8. sync paging功能，可根据userid唤醒特定终端，被唤醒后可快速同步
9. 唤醒原因api，paging唤醒原因api
10. 超低功耗唤醒支持最大次数自动醒来
11. 更新0a6g模组功率曲线
12. 超低功耗唤醒配置、频点保存到静态数据
13. 自动管理功能更新（配合网关使用）
ASYNC:
1. 更新按指定帧头发送数据功能，及上报收到数据的第一帧帧头rf counter
2. 更新低功耗LE模组的功率曲线，0a6g模组功率曲线
3. 修改api名字，uc_wiota_get_physical_status
4. 频点规则更新，频点间隔(不再是固定的200KHz)与带宽相同，更新为16bits类型
5. 子帧数为3的单播数据异常问题修复
6. 频段1范围更新为400M~470M
7. uboot更新，默认配置及打印更新
8. otp write cache miss问题修复
9. 根据输入配置参数计算帧长
10. 超低功耗唤醒支持窄带配置，支持最大次数自动醒来
11. 唤醒原因api，paging唤醒原因api
12. 接收数据的猜频偏bug修复
13. 超低功耗唤醒配置、频点保存到静态数据
14. 串口初始化时，先清空buf

11

异步v3.00 更新了，相关文档也已更新，具体内容如下：

  1. 新增获取dcxo值的接口
  2. 可在运行过程中动态配置子网id的接口
  3. 新增获取tx mode的接口
  4. 新增单独配置是否需要外部唤醒的接口
  5. 修复单播ack的功率问题
  6. 修复定时器与回调冲突问题
  7. 优化收发切换耗时
  8. 修复sleep可能无法成功的问题
  9. 修复cs awaken cause保存问题
  10. 增加resource test，可查看资源使用情况
12

异步v3.01 更新了，相关文档也已更新，具体内容如下：

  1. 优化单播传输成功率
  2. 增加单播ack自动功率控制接口（默认打开时，ack功率比发送端功率高0~5dbm，关闭时，使用本地配置功率）
  3. 增加suspend/recover接口，用于避免wiota运行和读写flash的冲突
  4. 获取paging唤醒原因接口中，增加唤醒检测次数
  5. 模组ID打印
  6. 温度adc接口更新，在uc_adda.c文件中
  7. 增加了协议栈代码空间
  8. 200K带宽的帧头gap减小
13

同步v2.8版本已更新，具体内容如下：
AP：
1. 对外接口编码采用C99规范，变量类型修改较多，请注意核对
2. 增加发送单音功能及相关api和at指令
3. 增加帧长查询api及at指令
4. 增加广播帧发送周期设置api及at指令（不建议更改）
5. 增加广播发送轮数设置，默认发送三轮
6. 去除单个子帧最大连接态iote个数设置接口，替换为设置最大连接态iote个数接口，用户不设置使用默认值（1:1为72个，1:2为144个）
7. 优化上行搬数逻辑，增加搬数校验
8. 系统配置中ap_max_power改名为ap_tx_power，表示当前AP的发射功率
9. 增加发送demo（供参考）
10. 优化上行接收性能
11. 增加资源管理，默认关闭，可在main函数打开，注意rt-thread/include/rtdef.h一定要对比合入
12. 修复已知bug
13. 对应api和at文档已更新，除了添加新增api和at外，还对广播和单波在不同symbol_length下的最大MCS和注意事项做了详细说明，具体请查看广播MCS设置部分

IOTE：
1. 新增idle paging消息上报
2. 系统配置中ap_tx_power名字更新
3. sync paging唤醒后的快速同步的接口，增加立即进入active状态的参数
4. 获取paging唤醒原因接口，增加当前检测次数上报
5. 新增获取校准参数接口、获取dcxo接口、获取tx mode接口
6. 新增底层分包重发次数接口
7. 新增获取当前帧号接口、获取当前帧号是否已与ap同步接口
8. 新增外部唤醒源配置接口
9. 降低了paging rx和sync paging的虚警率
10. 修复上下行高速模式中的bug
11. 默认关闭中速模式
12. 更新保存静态数据接口
13. 修复subsystemid list获取接口的bug
14. 修复单包数据（应用数据量小的情况）的重复上报问题
15. 增加数据收发测试例程

单路网关v2.8版本也同步更新，主要修改OTA、远程配置相关bug、增加DTU分时发送配置静态数据（请参考DTU分时发送策略文档），静态数据表同步更新

14

异步版本v3.02 已发布，相关文档也已更新。 版本更新内容如下：

  1. 规范c标准变量类型及命名
  2. 超低功耗唤醒支持同时检测第二个唤醒id
  3. 增加获取module id接口
  4. 增加wiota init/run/exit的切换中间态，获取运行状态接口
  5. 增加ack信息位功能
  6. 增加双向帧结构功能
  7. 增加gating相关接口
  8. 增加根据当前数据量和mcs计算匹配的子帧数的接口
  9. 增加主动等待接收数据接口
  10. 注意rt-thread库文件的更新
15

同步v2.9版本发布，主要更新如下：
AP修改如下：
1. 同步paging修改为周期性发送paging信号，具体用法见api接口文档
2. 新增帧号查询接口、让指定IOTE离开连接态接口、获取模组ID接口
3. 子网ID的高12bit，默认固定为模组内部的id_mask，默认值为0x214, 故默认的子网ID仍为0x21456981
4. 修改v2.8版本由于整理代码导致的GPS授时无法使用的问题
IoTE修改如下：
1. subsys id 的高12bit，测试版本默认固定为0x214, 32bit的整体默认值仍为0x21456981
2. 规范c标准变量类型及命名
3. 超低功耗唤醒支持同时检测第二个唤醒id，更新结构体 uc_lpm_rx_cfg_t
4. 增加 wiota init/run/exit 接口的中间态 SWITCHING
5. 增加获取模组ID的接口
6. 获取唤醒原因接口中，增加唤醒id的idx
7. 优化了sync paging和paging的虚警率和漏检率
8. 更新了功率ramp爬坡曲线，优化了射频谐波
9. 重发次数可配置为0，uc_wiota_set_sm_resend_times
10. sync paging模式更新，增加了睡前上行ctrl消息，可精确到特定帧唤醒
11. 全扫频超时bug修复
12. 更新外设demo
13. buliding.py更新，代码编译排版固定化

16

同步v3.0版本更新了，具体修改如下：
AP:
1. 子帧数据模式，仅支持二次开发，需参考网关开发demo
2. crc type功能，增加高mcs的子帧数据量
3. GPS库更新，GPS代码段增加，请合入link文件修改
4. GPS授时流程和精度优化，授时demo更新，请参考time_service_demo.c
5. 修改关闭协议栈log不生效问题

IOTE:
1. 增加开机及收到数据时的gpio脉冲通知功能，静态数据中设备信息对应更新，新增at/api
2. BT1.2功能优化，功能暂未开放
3. 子帧数据模式，仅支持二次开发，需参考网关开发demo
4. paging rx频点pll计算问题修复
5. 协议栈代码段增加，link file
6. 随机数api
7. 协议栈退出时，接收到ctrl包的临界问题解决
8. 非阻塞数据发送at
9. 保存静态数据接口，返回是否保存成功
10. crc calc api
11. crc type功能，增加高mcs的子帧数据量
12. tcxo校准频偏检测，异常处理
13. 增加uboot相关at接口
14. 增加是否使用温度校准dcxo的功能接口
15. 网关模式新增获取世界时间AT，并修改默认时区为8，合并time.c
16. 修改网关模式bug
17. 修改dac demo中设置值错误问题，10bit dac范围0~1023

17

异步v3.03正式版本发布，更新如下：

  1. paging at的timouet、freq范围修正
  2. 增加开机及收到数据时的gpio脉冲通知功能，静态数据中设备信息对应更新，新增at/api
  3. subsys id 的高12bit，测试版本默认固定为0x214, 32bit的整体默认值仍为0x21456981，（重要！）
  4. 从otp中获取温度曲线，防止flash中的曲线被擦除导致的异常，ucm200s模组特别注意！
  5. 增加根据温度计算并配置dcxo的接口。
  6. 应用可配置单次传输最大值。
  7. link file编译优化。
18

WIoTa异步V4.0正式版本发布，修改如下：

  1. 增加UC_RATE_PRM_GAP_MODE速率模式，默认为1，配置成0则会去掉帧结构中的preamble gap，提高了传输效率，开启方法：uc_wiota_set_data_rate(UC_RATE_PRM_GAP_MODE, 0)
  2. 增加UC_RATE_OLD_UNI_MODE速率模式，默认为1，默认为旧版单播模式，配置成0则会使得单播数据量增大，开启方法：uc_wiota_set_data_rate(UC_RATE_OLD_UNI_MODE, 0)
  3. 增加UC_RATE_CRC_TYPE速率模式，默认为0，配置成1则可使得高阶mcs下每个数据子帧多3字节的承载量。
  4. 增加UC_RATE_UNI_ACK_MODE速率模式，默认为1，配置成0则设置成发单播不回复ack模式。
  5. 增加UC_RATE_FIRST_MCS_MODE速率模式，默认为0，配置成1则配置成第一个控制子帧的mcs不固定为0，一般为(通用mcs-1)。
  6. 增加us级别的帧长接口（uc_wiota_get_frame_len_us）。
  7. uc_wiota_get_paging_awaken_cause接口中增加被唤醒id的idx。
  8. 增加保存静态数据是否成功的反馈回调（UC_RECV_SAVE_STATIC_DONE）。
  9. mem.c编译修复。
  10. buliding.py更新，使得每次编译结果相同。
  11. 增加从OTP中读取功率曲线的功能，功率曲线不会被烧写时擦除。
19

WIoTa同步V3.1正式版本发布，修改如下：

AP：

  1. AP增加低功耗，可被iote反向唤醒，paging rx相关接口
  2. 超低功耗唤醒扩展ID模式，uc_lpm_tx_cfg_t和uc_lpm_rx_cfg_t结构体中增加mode
  3. 授时功能周期可设置，默认15分钟一次
    4.增加广播时间UTC功能，可将时间时间同步给终端，同步周期与广播帧周期相同，默认11帧同步一次，该功能依赖于授时功能

IoTE：

  1. 超低功耗唤醒扩展ID模式，uc_lpm_tx_cfg_t和uc_lpm_rx_cfg_t结构体中增加mode
  2. 新增强制协议栈退回到IDLE状态的接口
  3. 新增是否需要退出协议栈时保存静态数据的开关
  4. paging tx发送完成回复tx done状态通知消息
  5. 增加从OTP中读取功率曲线的功能，功率曲线不会被烧写时擦除
  6. 反向超低功耗唤醒功能，iote唤醒ap
  7. 新增网关相关代码
  8. 新增世界时间同步功能，可通过at/api获取世界时间，依赖AP授时功能
  9. 增加模组ID获取的at
  10. 新增获取当前rf cnt的api
  11. 增加获取当前帧头rf cnt的api
  12. WIoTa设备地址AT+WIOTADEVADDRESS 由大端表示变为小端表示
  13. 网关模式下用于鉴权的设备ID即为AT+WIOTADEVADDRESS查询结果，代码去除将高位bit置0的操作，因为出厂时已经置0

兼容性说明
paging tx低功耗模式默认兼容老版本，如需开启扩展ID将mode参数设置为1即可

硬件要求
AP反向唤醒需AP模组（UCM202）硬件版本0A9G及以上

20

异步V4.1 正式版本发布：

外部更新：

  1. 增加快速配置功能，_QUICK_CONNECT_默认打开，在RT_USING_AT打开时使用该功能
  2. 修改memset/memcpy为rt_memset/rt_memcpy
  3. crt0.flash.S 增加pmc_init，修复休眠唤醒后可能的开机电流异常
  4. 中断处理函数更新， default_int_handler, 防止中断漏检问题
  5. boot_strap更新，增加qspi init，基带paging状态检测和恢复
  6. 更新uboot.bin，包括开机异常处理等
  7. 增加flash id获取接口，用于区分新老flash版本，并且兼容老版本flash接口
  8. onchip_flash_erase中cache miss问题修复
  9. 更新uboot.bin，包括开机异常处理，断电保护等
  10. bintools更新
  11. .gitignore更新，记得先清除本地跟踪 “git rm -r --chched .”

协议接口更新：

  1. 超低功耗唤醒扩展ID模式，uc_lpm_tx_cfg_t和uc_lpm_rx_cfg_t结构体中增加mode。
  2. 增加状态回调类型，UC_RECV_PG_TX_DONE，发送完paging tx后通知app。
  3. 增加adc校准计算，经过adc校准的模组，OTP中会有相关参数，默认在adc接口中直接使用，也可使用接口关闭该功能。adc采样率改为最高ADC_SR_360KSPS。
  4. uc_wiota_set_freq_info 增加返回值，表示是否成功配置配点。
  5. 去除auto_connect_flag。
  6. 增加dcxo获取at，at_dcxo_query。
  7. 增加功能宏区分，默认必须打开，对应目前完整协议栈库，仅用于裁剪版本编译（需要对应裁剪的协议栈库，另外提供）。
    （LPM_PAGING，NARROW_BAND，SUBFRAME_MODE，OLD_UNI_MODE，NEW_UNI_MODE，BROADCAST_MODE）
  8. 增加模组id的at，at_module_id_query

修复项

协议内部更新：

  1. 修复上一个版本通信问题，该版本（v4.1）可与之前版本（v4.0之前）在以下配置通信：单播，窄带（100K，50K，25K）。即V4.0该配置下均不能与其他版本通信。
  2. 优化根据温度曲线计算dcxo的公式
  3. 增加 l1_m/l1_f task堆栈空间到2K
  4. 修复反复paging唤醒上千次出现的异常挂死问题，128 200K配置下。
  5. 扩展ID唤醒，周期倍数不为1的异常处理
  6. paging唤醒的200K 128 nlen为1的特殊配置下，检测周期的更新优化，v4.0该配置本身就有问题。
  7. 对于特定数据解码异常问题的修复
  8. 去掉初始化时可能存在的 ”写OTP操作“（风险项，写otp可能导致otp异常清除）
  9. 增加量产测试cmd
  10. 频点接收计算带宽更新为400K（射频计算相关，非频谱带宽）
  11. 修复帧头dfe不准的bug
  12. 双向内嵌pg tx功能
  13. 读温度后，恢复adc配置
  14. 基带对应功能更新
  15. id mask范围更新，从 0~0xFFF 更新为 1~0xFFE，避免量产otp数据异常导致无法通信，默认值认为0x214

遗留问题

注意：

  1. 扩展ID模式使用重点：
    （1） 第二个唤醒ID仅支持与第一个唤醒ID相同周期
    （2） 进休眠不能32K时钟降频
    （3） paging tx的send time必须与paging rx的detect time相同
    （4） 如需修改nlen，发送端也要配置相同的paging rx（为了统一，建议两端的tx和rx配置均一样）
  2. 200K 128 3个子帧的双向有异常
  3. 200K 128 3个子帧的指定帧头功能无法使用

兼容性说明（软、硬件）

该版本（v4.1）可与之前版本（v4.0之前）在以下配置通信：单播，窄带（100K，50K，25K）。即V4.0该配置下均不能与其他版本通信。

21

WIoTa同步V3.2 正式版本发布，修改如下：

AP v3.2正式版本

新功能

  1. 增加顺序业务发送接口，同一子帧的多个终端顺序执行
  2. 增加指定帧收发接口，可指定从某帧开始安排短消息接收和发送短消息
  3. 增加新的接收回调和授时状态回调函数注册（上报的信息更加详细），AT标准固件使用旧版回调，两个接收回调只能生效一个
  4. 增加帧号刷新回调注册，如果需要用到帧号的可注册该回调
  5. 增加快速连接AT指令
  6. 增加单播重发次数设置接口
  7. 默认关闭bl0.5的接收可通过接口开启
  8. 新增aagc idx、ramp vale和rf ctrl idx的设置接口
  9. 增加GPS二次开发demo，如单独开发了GPS，不可再调用授时相关接口
    10.授时成功后可查询经纬度信息

优化项

  1. 设置类接口增加返回值和参数校验

修复项

1.修改通过系统配置设置AP功率大于29dbm时，未受最大功率27dbm的限制问题

遗留问题

无

兼容性说明（软、硬件）

1.uc_wiota_query_fix_pos改为uc_wiota_query_coordinate_xyz，授时成功查询三维坐标信息
2.uc_wiota_paging_tx_start返回值修改，跟原来相反

*----------------------------------------------------------------------------------------------------------------------------------

同步终端V3.2正式版本
（另外有中间版本v3.1.2和3.1.3，均为正式版本，主要用于OTA逐步升级，不建议二次开发使用）

新功能

外部更新：

  1. 快速配置qc功能模块，不需要可关闭
  2. memcpy/memset 修改为 rt_memcpy/rt_memset ！
  3. crt0.flash.S 增加pmc_init，修复休眠唤醒后可能的开机电流异常
  4. 中断处理函数更新， default_int_handler，防止中断漏检问题
  5. boot_strap更新，增加qspi init，基带paging状态检测和恢复
  6. 更新uboot.bin，包括开机异常处理，断电保护等
  7. iic优化
  8. 增加spim
  9. 增加flash id获取接口，更新flash读写接口，兼容新版硬件flash
  10. adc校准更新
  11. 网关相关功能更新
  12. onchip_flash_erase中cache miss问题修复
  13. rt-thread版本更新为4.1.1
  14. rt-thread驱动更新
  15. bintools更新
  16. .gitignore更新，记得先清除本地跟踪 “git rm -r --chched .”

优化项

协议接口更新：

  1. 帧号上报功能，UC_RECV_FN_CHANGE
  2. 下行单播不回ack功能，特殊场景使用，UC_RATE_NOACK_MODE
  3. 指定帧号发送功能，uc_wiota_send_data_by_fn/at_wiotasend_by_fn_setup，需提前至少1帧
  4. 设置频点新增返回值，是否设置成功，uc_wiota_set_freq_info
  5. 新增获取子帧长度接口，uc_wiota_get_subframe_len
  6. 新增查询dcxo的at接口，at_dcxo_query
  7. 优化at回调打印，wiota_recv_callback
  8. 增加宏_LPM_PAGING_，低功耗功能控制宏，关闭后可减小整体固件大小，如需关闭需要单独编译对应协议库
  9. 指示灯功能（LIGHT_PILOT），默认关闭，如需打开需要单独编译对应协议库
  10. 配置是否在退出协议栈自动保存静态数据，at_wiota_save_mode_setup/uc_wiota_set_exit_save_static
  11. 外部PA配置gpio相关接口（V3.1.2不支持）
  12. userid配置，不再需要先disconnect再重新connect，可直接动态配置（V3.1.2不支持）

修复项

协议内部更新：

  1. 去掉初始化时可能存在的 ”写OTP操作“（风险项，写otp可能导致otp异常清除）
  2. 增加帧号有效性检测，（广播帧号包的mcs检测，帧号突变检测，tracking状态检测）
  3. 快速扫频阶段，记录agc，在后续同步过程中使用该agc，有效避免信号饱和时同步异常或者同步tracking agc调整过慢问题。(应用建议流程：先扫频，再设频点，再同步)
  4. 在尝试同步阶段disconnect时异常临界问题解决
  5. cache miss问题优化
  6. 扩展ID唤醒，周期倍数不为1的异常处理
  7. 200K 128 nlen为1的特殊配置下，检测周期的更新优化
  8. 扫频临界问题修复
  9. grant模式优化（下个版本更新新策略）
  10. awaken cause中的cs flag记录，防止第二次查询时异常
  11. 频点接收计算带宽更新为400K（射频计算相关，非频谱带宽）
  12. 优化根据温度曲线计算dcxo的公式
  13. id mask范围更新，从 0~0xFFF 更新为 1~0xFFE，避免量产otp数据异常导致无法通信，默认值认为0x214
  14. 基带llr接收优化

遗留问题

无。

兼容性说明（软、硬件）

版本说明：

V3.1 基础大版本
V3.1.1 更新应用关于OTA相关bug（重要）
V3.1.2 更新协议栈接口（未更新基带，部分新接口暂不可用），更新quick connect模块，更新bintools
V3.1.3 更新基带（协议新接口均可用），更新应用新策略和优化
V3.2 更新外设，rt_thread系统相关，uboot，更新应用新策略和优化和对应协议接口等

注意：

  1. 由于本次V3.2更新内容，相对于V3.1.1改动较大，OTA升级空间不够，需要中间版本进行逐步OTA升级，
  2. V3.1.2和V3.1.3主要用于OTA升级，不建议在这两个版本上进行应用开发！
22

同步终端V3.3正式版本

新功能

AP：

  1. 新增bnack策略，能有效解决同一子帧终端的业务冲突问题，且该功能默认开启，可通过接口uc_wiota_set_bnack_func开关
    IoTE：
    外部更新：
  2. gpio pullup功能更新，gpio_set_pin_pupd
  3. gateway相关更新
  4. FACTORY_GPIO_IN测试更新

协议更新：

  1. gps info接口更新，设置查询gps信息时的gpio中断口
  2. bnack冲突检测、随机回退机制，功能新增
  3. voice flag虚警处理
  4. 基带更新

优化项
AP：

  1. paging tx优化，新增接口uc_paging_tx_frame_start，可在发送连续唤醒信号时维持同步信号，处于连接的终端不会失步
  2. 基带更新，优化paging tx、增加bnack支持和1024配置的性能优化
    IoTE：
  3. idle paging流程优化