CHANGELOG.md
@@ -1,5 +1,176 @@
# 更新日志
## **PAN10XX NDK v0.8.0**
TBD
## **PAN10XX NDK v0.7.0**
PAN10XX Nimble DK `v0.7.0` *(2024-10-20)* 已发布:
### 1. SDK
#### nimble
- App Config 配置框架重构,所有配置选项统一使用 `sdk_config.h` 配置,并重新梳理各个配置的层次结构,使之更容易理解和使用
  - 将蓝牙 Host 与 Controller 相关的重要配置开放到 App 配置文件中
  - 将 FreeRTOS 相关的重要配置开放到 App 配置文件中
  - 将 Flash KVStore 区域的配置开放到 App 配置文件中
  - 将 Flash Map 与 Bootloader 相关配置开放到 APp 配置文件中
  - 使能 UART Log 后,支持从 App 配置文件中修改 Log UART Tx 引脚及波特率
  - 新增使能 Segger RTT Log 的配置
- 更新 所有例程的入口函数,由 `app_main()` 修改为 `app_init()`,以提醒用户此函数仅可编写初始化逻辑,不可以写 `while (1)`
- 新增 获取自定义蓝牙 MAC 地址滚码地址的接口 `pan10x_roll_mac_addr_get()`,用于配合 PanLink 的蓝牙 MAC 滚码烧录功能使用
- 修复 Nimble Standby Mode 1 低功耗流程中,配置为“唤醒不复位方式”后,唤醒后获取不到正确的 32K Counter 值的问题
- 新增 PAN3740(Sub-1G)支持及对应例程
#### Panchip HAL
- Panchip Spark BLE Controller Library:
  - PAN101x:
    - 新增 Local SCA 的动态更新逻辑
    - 优化 ACL 数据发送逻辑
    - 优化 Heap 占用计算方法
    - 修复 一些兼容性问题
    - 修复 RF 实际 Tx Power 比预期偏大的问题
  - PAN107x:
    - 新增 Local SCA 的动态更新逻辑
    - 优化 ACL 数据发送逻辑
    - 优化 Heap 占用计算方法
    - 修复 一些兼容性问题
    - 新增 硬件 ADV PDU Filter 功能
    - 修复 HCI_Encrypt_Changed_Evt 事件报告比秘钥分配 ACL(Master)晚的问题
    - 修复 RF 实际 Tx Power 比预期偏大的问题
- Panchip PRF (2.4G Private RF) Library:
  - 新增 `panchip_prf_get_pipe()` 接口
  - 优化 PRF IRQ 流程
  - 更新 Set Mac Address 接口
  - 更新 `panchip_prf_enable_rssi()` 与 `panchip_prf_disable_rssi()` 接口
  - 修复 RF 实际 Tx Power 比预期偏大的问题
- BSP:
  - 新增 Segger RTT Driver
  - 新增 Sub-1G Driver
  - 更新 量产芯片校准参数载入流程,新增 `CONFIG_SOC_INCREASE_LPLDOH_CALIB_CODE` 用于抬高 LPLDOH 电压
  - 更新 ADC Driver,以稍微牺牲温度采样精度的代价,缩短 `ADC_MeasureSocTemperature()` 的执行时间和占用 RAM
  - 更新 FMC Driver,支持 PAN101x MSOP10 芯片,并修复一些潜在问题
#### Samples
- bluetooth:
  - ble_cent_prph:
    - 新增 SMP 支持
  - bleprph_hr:
    - 新增 BLE_GAP_EVENT_CONN_UPDATE 事件处理
    - 新增 CONFIG_USER_ROLL_MAC_ADDR 配置,用于使能自定义的滚码 MAC 地址(默认不使能)
- os_debug:
  - os_rtt_logging:
     - 重构例程,使用新增加的系统级开启 RTT Log 机制的方式
- peripheral:
  - spi_master_dma_send_receive:
    - 新增 全双工收发数据的场景
  - spi_master_int_send_receive:
    - 新增 全双工收发数据的场景
  - spi_master_poll_send_receive:
    - 新增 全双工收发数据的场景
  - spi_slave_dma_receive_send:
    - 新增 全双工收发数据的场景
  - spi_slave_int_receive_send:
    - 新增 全双工收发数据的场景
  - spi_slave_poll_receive_send:
    - 新增 全双工收发数据的场景
- security:
  - swd_protection (新增):
    - 演示芯片通过禁止 SWD 正常通信的方式保护芯片数据的方法,并演示如何通过载入正确调试秘钥的方式恢复正常的 SWD 通信
- solutions:
  - ble_hid_selfie:
    - 优化兼容性,新增通过了 500 台手机的兼容性测试(总计 1000 台)
  - ble_hid_uart_capture (新增):
    - 演示基于 BLE HID 服务和串口透传服务实现用按键进行拍照、录像和调焦,并通过串口透传数据到手机的功能
  - prf_dongle (新增):
    - 配合 PAN108x 鼠标,演示 2.4G Dongle 的功能
  - rf_mini_test (新增):
    - 演示发送 RF 单载波的功能
- sub_1g:
  - cad_rx (新增):
    - 演示使用 PAN3740 的 CAD 特性检测 Sub-1G 信号的功能
  - cad_tx (新增):
    - 演示使用 PAN3740 的 CAD 特性检测 Sub-1G 信号的功能
  - intelligent_search_rx (新增):
    - 演示 PAN3740 Sub-1G 的智能搜索功能
  - intelligent_search_tx (新增):
    - 演示 PAN3740 Sub-1G 的智能搜索功能
  - packet_reception_rate (新增):
    - 演示 PAN3740 Sub-1G 收报率统计功能
  - plhd (新增):
    - 演示 PAN3740 Sub-1G 接收提前中断功能
  - trx_sample (新增):
    - 演示 PAN3740 Sub-1G 收发切换功能
- 其他:
  - 所有例程更新 configuration 配置框架,统一使用新的 `sdk_config.h` 配置文件
### 2. HDK
- 移除 PAN1070UA1A v1.4 版本核心板图纸、设计源文件、生产文件
- 新增 PAN1070UAEC 核心板图纸、设计源文件、生产文件
- 新增 PAN1010M9BA 核心板图纸、设计源文件、生产文件
### 3. MCU
- 重构 **LowPower** 例程:
  - 梳理并重构例程代码框架,重写所有测试用例,使例程更加易懂和易于移植
  - 新增例程演示文档
- 新增 **PRF_API_RX** 和 **PRF_API_TX** 例程:
  - 演示 PRF 2.4G API 收发接口
  - 新增例程演示文档
- 新增 **PRF_RX_MULTI_PIPE** 和 **PRF_TX_MULTI_PIPE** 例程:
  - 演示 PRF 2.4G API Multi-Pipe 功能
  - 新增例程演示文档
- 更新 **usb_hid** 例程:
  - 修复一些代码问题
  - 新增例程演示文档
### 4. DOC
- 更新 `NDK 快速入门指南` 文档,补充一些描述模糊的部分,并新增一些参考文档的跳转链接
- 更新 `NDK 开发环境搭建` 文档,补充更多内容
- 新增 `NDK Chip Migration` 文档,介绍 PAN107x 和 PAN101x 芯片的不同点以及移植的一般方法
- 更新 `NDK Configuration 开发指南` 文档,介绍重构后的 SDK Config 配置机制,并解释各个 Config 选项的含义
- 更新 `NDK 低功耗开发指南` 文档,增加芯片电源管理框图
- 更新 `BLE MULTI ROLE` 例程文档,新增不同版本 Controller Lib 的选择介绍
- 更新 `BLE Peripheral HR OTA` 例程文档,添加 OTA 功能移植相关介绍
- 更新 `Firmware Encryption` 例程文档
- 新增 `OS RTT Logging` 例程文档
- 新增 `SWD Protection` 例程文档
- 新增 `PRF Dongle` 方案例程文档
- 新增 `RF Mini Test` 方案例程文档
- 新增 `Sub1G - CAD` 例程文档
- 新增 `Sub1G - Intelligent Search` 例程文档
- 新增 `Sub1G - Packet Reception Rate` 例程文档
- 新增 `Sub1G - PLHD` 例程文档
- 新增 `Sub1G - TRx Sample` 例程文档
- 更新 例程介绍主页,补充一些之前版本漏掉的文档链接
- 修复 一些文档中的描述错误,并优化一些文档的显示效果
### 5. TOOLS
- 更新 量产烧录工具 `PAN10xx Download Tool` 至 `v0.0.008` 版本:
  - 修复自定义下载配置模式保存配置文件,在下载加密信息使能时,在下载配置模式加载配置失败问题
  - 固定蓝牙 MAC 滚码写入位置为 Flash INFO 区 0x100 地址
  - 添加支持无 RST 脚芯片进入 ROM 模式下载程序的功能
  - 添加支持下载 SWD Debug 加密芯片,通过密钥解密进行再次下载功能
  - 优化烧录加密信息写 efuse,写之前先进行读取校验,防止重复写入
- 更新 RF测试固件 至 `v003`,支持更多封装的芯片
### 6. ISSUES
#### 遗留问题
- `BUG #873`:  兼容问题--peripheral_ota---与小米手机11配合升级,小米11安装的nRF Conenct软件版本是4.28时,无法升级
## **PAN10XX NDK v0.6.0**
PAN10XX Nimble DK `v0.6.0` *(2024-08-05)* 已发布: