当前页面为 开发中 版本,查看特定版本的文档,请在页面左下角的下拉菜单中进行选择。

ChangeLog

PAN3029/3060 SDK V1.0 Release Notes

版本:V1.0
日期:2025/6/11

一、RF驱动层优化

1. 代码规范

  • 统一SDK命名格式为驼峰式

  • 完善变量、宏定义及函数接口注释,提升代码可读性

2. 性能优化

  • 重构参数获取接口:从寄存器读取改为本地变量读取,提升执行速度

  • 优化页切换机制,降低寄存器切换频率,提升执行效率

  • 重构RF校准接口,减少RAM占用,提升执行效率

  • SNR计算改为查表方式,减少代码量,提升计算速度

  • 简化频率设置接口,移除浮点数运算,提升MCU兼容性

3. 接口重构

  • 调整发射功率范围(最大档位22)

  • 新增芯片模式快速切换接口

  • 新增IQ设置接口,支持IQ反转场景

  • 新增3线SPI驱动及3/4线SPI动态切换机制

  • 移除MPA/MPB宏标识

  • 重构发送/接收函数接口及参数,提升易用性

4. 架构精简

  • 移除各例程中OLED/Key依赖(OLED例程除外)

  • 抽离MCU相关BSP接口至/mcu公共目录

  • 移除rf_port.c,底层接口整合至pan_rf.c

  • 迁移自动搜索SF接口至独立模块,降低耦合度

  • 移除中断传递变量,改用寄存器中断变量

5. MAPM专项优化

  • 合并field/group配置接口至统一函数

  • 重构MAPM地址设置为连续寄存器模式

  • 新增单field时间计算接口(含详细说明)

  • 新增MAPM剩余时间计算接口(含详细说明)

  • 重定义gn参数意义为number of group,提升可读性

二、示例代码优化

1. 公共优化项

  • 移动BSP代码文件至公共文件夹,精简了代码文件,文件架构更清晰

  • 优化各例程中BSP函数命名,统一驼峰命名规则,规范代码格式,增加代码注释

  • 去掉原有自定义的中断传递变量,改用寄存器中断变量,减少代码复杂度

  • 除oled例程外,其它例程均删除oled和key功能代码,凸显例程要展示的RF功能

  • 增加例程主文件头注释,包括例程功能说明、版本、代码流程和注意事项等

  • 将各例程中默认的连续发送方式改为单次发送方式

  • 统一各例程中断处理方式为查询方式

2. 基础收发例程

  • 合并原tx和rx例程至01_normal_trx中,并共用一个readme对两例程进行演示说明

  • 完善readme文档功能演示说明

3. 收发转换例程

  • 将原有trx例程文件夹更名为pingpong,并更改为ping和pong两例程

  • 完善readme文档功能演示说明

4. 发送带休眠例程

  • 优化sleep和deepsleep例程流程,增加详细代码注释

  • 完善readme文档功能演示说明

5. 实时信号强度例程

  • 去除oled和key等RF不相关代码逻辑,简化代码,增加详细代码注释

  • 完善readme文档功能演示说明

6. 自动识别SF例程

  • 去除oled和key等RF不相关代码逻辑,改为串口log演示模式

  • 重写SF集合前导码计算函数,增加详细计算过程注释

  • 原有单个例程改为auto_sf发送和接收两个例程,过程演示更易懂

  • 完善readme文档功能演示说明

7. CAD检测例程

  • 新增tx_with_lbt例程,演示发送数据包前检测信道是否空闲的功能

  • 更名cad_rx为rx_with_cad,将重构代码流程,去除oled和key等RF不相关代码逻辑

  • 增加代码流程和检测时间等代码注释,方便用户理解

  • 完善readme文档功能演示说明

8. MAPM例程

  • 去除oled和key等RF不相关代码逻辑,改为串口log演示模式

  • 原有单个例程改为auto_sf发送和接收两个例程,过程演示更易懂

  • 重构发送和接收代码流程,简化代码,增加详细注释

  • 完善readme.md文档功能演示说明

三、文档更新

  • 《PAN3029_3060_驱动接口指南_v1.1.pdf》

  • 《PAN3029_3060_CAD配置参考_v1.1.pdf》

  • 《PAN3029_3060_MAPM应用指南_v1.1.pdf》

  • 《PAN3029_3060_扩频因子(SF)自动识别参考_v1.1.pdf》

  • 《PAN3029_3060_AT指令集参考_v1.1.pdf》

  • 新增HC32F460相关说明文档

四、工具更新

ChirpIOT计算工具

  • 更名为ChirpIOT_Calculator_vX.X.exe

  • 修复参数计算边界错误

  • 修正ChirpIOT帧格式解析异常

  • 增加SF自动识别参数计算模块

PAN3029/3060 SDK V0.x Release Notes

版本:SDK_V0.8
日期:2024/4/30
更新内容:
1.修复示例工程变更优化等级后运行异常的问题
2.优化STB2-STB3转换时间
3.更新SDK目录结构、RF接口名称、优化代码逻辑
4.更新文档接口描述
5.新增智能搜索、深度休眠、噪声能量、休眠示例及说明文档
6.新增功耗计算工具
7.新增一键SDK工程清除和编译脚本

版本:SDK_V0.7
日期:2024/3/29
更新内容:
1.修复计算发射时间错误问题
2.增加PAN3029MPB版本配置及与MPA版本兼容
3.新增SPI写PAN3029寄存器回读开关
4.修改CAD及智能搜索应用参考文档
5.更新硬件参考设计原理图匹配
6.更新产品说明书V1.7

版本:SDK_V0.6
日期:2024/2/2
更新内容:
1.修复test mode切换时LDR自适应开启被强制关闭
2.更新AGC 800-900MHz段配置

版本:SDK_V0.5
日期:2023/12/27
更新内容:
1、更新MAPM使用实例工程,增加多SF适配
2、更新433MHz、470MHz发射功率档位1-23档位,更新AGC参数配置
3、OLED工程新增模式1、2接收灵敏度测试,单载波测试,删除LDR按键开关
4、新增AT DEMO工程及AT使用文档说明
5、更新EVB板原理图
6、更新CAD使用文档
7、更新PAN3029评估板使用说明
8、更新PAN3029_SDK用户指南
9、新增PAN3029测试报告
10、更新PAN3029硬件参考设计
11、更新PAN3029_PAN3060产品说明书

版本:SDK_V0.4
日期:2023/11/17
更新内容:
1、更新MAPM使用实例工程
2、新增PAN3029射频模块说明书
3、新增900M频段AGC配置
4、新增不同SF,BW时LDR自动开启和关闭
5、更新PLL LDO挡位,频率锁定范围配置,更新功率档位表
6、更新硬件参考设计(原理图和BOM,特殊注意点说明)
7、新增FT校准参数读取与配置
8、新增PAN3029晶体选型说明文档
9、新增EVB V1.2硬件原理图

版本:SDK_V0.3
日期:2023/09/19
更新内容:
1、更新MAPM使用实例工程
2、修改发射功率挡位
3、更新PAN3029硬件设计参考
4、更新PAN3029产品说明书
5、修改LDO PA开关使用方式
6、新增EVB板电池电量检测功能
7、新增单天线多通道网关模组说明书
8、根据拉距测试优化寄存器配置

版本:SDK_V0.2
日期:2023/08/04
更新内容:
1、OLED拉距工程增加LDR设置
2、优化休眠唤醒中的延时参数
3、优化BW带宽设置参数
4、优化AGC参数,改善RSSI线性度,降低能量检测误触发概率
5、增加空中能量检测接口
6、新增PAN3029产品说明书
7、优化参数改善SF12通信
8、修改PAN3029GPIO(TXEN,RXEN,TXO)配置,使其适配PAN3029模块V1.1及之后的硬件版本
9、修改EVB版CAD检测引脚,PAN3029 CAD引脚不需要再飞线到底板
10、更新PAN3029硬件参考设计

版本:SDK_V0.1
日期:2023/06/30
更新内容:
1、Release新版本初始内容