下载地址：https://resource.hpmicro.com/sdk_env_v1.13.0.zip

测试工具版本

• ZCC 4.1.5
• Segger Embedded Studio 8.28

版本更新概况

本版本新增 HPM5100 系列 SoC 支持,并在音频与网络两个方向持续演进:音频侧完善 codec 音量控制 API 体系、USB Audio Class 示例功能与精确 44.1kHz 时钟支持;网络侧引入 ENET 硬件校验和卸载、RTL8211F PHY 支持并统一 lwIP 示例端口架构、引入 zero-copy 发送路径。同时本版本包含多项驱动稳定性修复(I2C、I2S、PLL、ADC 等)。

• [Added]  HPM5100 系列 SoC 与 hpm5100evk 开发板
• 新增 HPM5100 系列SoC 支持
• [Added]  Audio Codec 音量控制 API
• sgtl5000 / wm8960 / es8389 三款 codec 统一新增音量百分比/分贝设置、音量范围查询与钳位 API
• [Added]  ENET 硬件校验和卸载
• 驱动新增 HW checksum offload API,lwIP 示例可一键开启收发硬件校验和,TX 侧支持 CRC 模式选择(append/replace/off)
• [Added]  RTL8211F Ethernet PHY 支持
• enet_phy 组件新增 RTL8211F PHY 适配
• [Added]  UAC2 Headset 示例
• CherryUSB 与 TinyUSB 均新增基于 codec 的 UAC2 Headset示例。其中，CherryUSB的 UAC2 Headset示例支持speaker feedback和mic adaptive功能。
• [Updated]  lwIP 示例端口架构统一
• 单/多网口示例的 lwipopts、arch、ethernetif 合并为共享端口实现,引入 zero-copy 发送与多段接收 pbuf chain 支持
• [Fixed]  驱动稳定性修复
• I2C 阻塞传输超时与总线释放、I2S 软件 reset 系列、ADC 转换时钟上限、Standby 唤醒后 DCDC 状态等修复

新增 SoC 支持

• [Added] HPM5100 系列(HPM5151)
• SoC 层新增 HPM5100 支持
• [Added] hpm5100evk 开发板
• 新增 HPM5100 EVK 板级支持

新增/更新的中间件(Middleware)

• [Updated] NetX Duo
• ENET 适配器使能硬件校验和卸载,提升网络收发效率
• [Updated/Fixed] NetX / lwIP
• 对齐 ENET MMC 中断掩码配置
• NetX 侧 PHY 初始化调整至 ENET 控制器初始化之后,修正初始化顺序
• [Fixed] CherryUSB
• 修复 FreeRTOS OSAL中 usb_osal_sem_take() 与 usb_osal_timer_stop() 在 ISR 上下文的调用问题
• 修正 AUDIO_FREQ_TO_FEEDBACK_HS 宏定义
• [Fixed] FatFS
• 调整 diskio 读路径 cache invalidate 顺序，避免读到脏数据
• [Fixed] ThreadX
• 修复 ip32d context 错误

新增/更新的组件(Components)

• [Added]  audio codec(sgtl5000 / wm8960 / es8389)
• 统一新增 set_volume_percent()、set_volume_db() 音量设置 API
• 新增 get_volume_db_range() 与 clamp_volume_db() 音量范围查询与钳位 API,便于应用层做统一的音量映射
• wm8960 额外新增 wm8960_mute() 静音 API
• [Added] enet_phy
• 新增 RTL8211F Ethernet PHY 支持
• [Fixed] enet_phy
• 修复链路速度在有效值建立前被错误上报的问题
• [Fixed] I2C 组件
• 重复起始(repeated-start)读操作中等待第二次地址命中,提升读时序兼容性
• 总线释放等待改为带超时处理,避免异常时阻塞

新增/更新的驱动(Drivers)

• [Added] ENET
• 新增硬件校验和卸载(HW checksum offload)API
• 修复多段(multi-segment)收发路径的 PTP 时间戳处理
• [Added] SYNT
• 新增 synt_enable_oneshot_mode() 单次模式 API
• SYNT 特性由 SoC feature 迁移为 IP feature,提升跨 SoC 一致性
• [Added] SEI
• 新增 sei_restart_asynchronous_xcvr() API,支持异步收发器重启
• HPM5300 新增 errata E00047 / E00048 特性开关,驱动与示例默认启用相应变通
• [Added] TFA
• 新增 CONFIG_TFA_IRQ_NEST_PROTECT 宏,支持中断嵌套保护
• 更新 TFA 数学常量与计算时间
• [Updated] PLLCTL
• 优化整数与小数 PLL 频率配置流程,小数 PLL 配置时不再额外调用 pllctl_pll_ss_disable()
• [Updated] PDGO
• 更新 pcnt 分辨率(pcnt resolution)设置
• [Updated] I2S
• API 重构:以 i2s_start() / i2s_stop() 取代 i2s_enable() / i2s_disable(),语义更明确
• 修复 i2s_reset_rx() / i2s_reset_tx() 与软件复位函数,TX FIFO 填充不再依赖 BCLK
• [Fixed] I2C
• 放大阻塞 API 的轮询超时,提升大数据量/低速场景下的可靠性
• [Fixed] ADC12 / ADC16 / DAC
• ADC12 校准完成后恢复应用时钟配置
• 修复周期配置按时间(纳秒)匹配,使误差门限按时间比较
• 约束转换时钟不超过上限,保证转换精度
• [Fixed] PCFG
• 修复 standby 模式唤醒后 DCDC 稳定状态恒返回 false 的问题
• [Fixed] DMAV2
• 修复链式传输的最后一个链不能配置无限循环模式的问题。
• [Fixed] SoC 级
• HPM5301:ROM auto_config 流程补充 fencei()
• HPM6P00:修复 flash_sdram_xxx.ld 链接脚本与 SEGGER linker 文件 AXI SRAM region 错误
• HPM6800 / HPM6E00 / HPM6P00 / HPM5100:新增 I2S 软件复位状态位与特性
• HPM6200 / HPM5300 / HPM5100:移除 sysctl_config_cpu0_domain_clock() 中冗余的 cpu_div 切换
• [Updated] Boards
• HPM6750EVK2 / HPM6800EVK 新增可选的精确 44.1kHz 音频时钟配置
• RGMII 复位后补充延时,提升 PHY 上电稳定性
• 修复 hpm6300evk / hpm6p00evk / hpm6e00evk 的 I2S 44.1kHz 时钟配置与 hpm5300evk / hpm536fevk 的 DAC 模拟时钟
• hpm6p00evk: 新增known issue，sdram和codec引脚有复用，不能同时工作
• [Updated] 构建系统
• CMake 特殊配置改为按 app 与 board feature 门控
• CONFIG_CODEC
   可由 board YAML 中的 board_codec_* feature 自动检测
• 工具链文件探测编译器 march 扩展支持
• 修复 IAR 工程 virtual path 显示问题

Samples改动

• [Added] UAC2 Headset
• CherryUSB 与 TinyUSB 新增 UAC2 耳机(headset)示例,基于板载 codec
• [Updated] USB Audio(cherryusb / tinyusb)
• cherryusb uac2 headset示例的采样率支持 44.1kHz
• 新增扬声器反馈(speak feedback)与麦克风/扬声器自适应(adaptive)特性支持
• 音频设备改为从板级 feature 自动检测,包率由端点间隔(endpoint interval)推导
• 集成 codec 播放/录音通路,更新初始化时序与麦克风调节窗口
• 音量控制函数统一以 dB 为单位;wm8960 通路使用 wm8960_mute() 实现静音
• I2S 的 start/stop 移至 USB 端点 open/close 中处理,音频数据在 I2S DMA ISR 与 USB ISR 中处理,降低延迟
• 修复 UAC2 声道错位问题
• [Updated] audio_codec
• 使能精确 44100Hz 音频 PLL,DAC 默认音量设为 -20dB
• DMA burst 大小对齐声道数
• 修复 DMA abort 函数参数使用
• [Updated] lwIP
• 单/多网口的 lwipopts、arch、ethernetif 合并为共享端口(shared ports)实现
• 支持 zero-copy 发送 hold、多段接收 payload 组成 pbuf chain
• 新增 ENET 硬件校验和开关与 TX CRC 模式选择(append/replace/off)
• CHECKSUM_BY_HARDWARE
   改为无值定义;高吞吐场景强制 -O3 优化
• 修复 RX d-cache invalidate 覆盖范围、netif 状态竞态、DLM region 溢出与 ENET TX 路径稳定性问题;RX 缓冲归还 DMA 前先 invalidate cache
• [Updated] modbus / opener / erpc
• 对齐 lwIP zero-copy 路径;修复非 GCC 构建下 sys_now 未声明问题
• modbus:TCP master 链路 up 后自动重连,启动时主动 bring up 网络接口
• opener:迁移至 CMSIS-OS 函数与公共 lwIP 应用源文件
• [Updated] SEI
• 各编码器协议示例补充看门狗激活与断线时的 rewind 处理
• [Updated] TSN
• 示例命名与交换机端口名、Qci 输入对齐
• [Fixed] I2S / smix
• 修正软件复位执行时机,复位后重新使能 TX/RX 模块;检查 I2S API 返回值
• [Fixed] openocd_algo
• auto config 前先使能 FPU;hybrid XPI 使能增加空指针检查
• [Fixed] tinyengine
• 修复 person_obj 示例在 Andes GCC 14.2 下的构建错误
• [Fixed] netx
• 增大 IP 协议栈任务栈,避免溢出

注意事项

本版本存在若干 API 重命名与示例结构迁移,涉及破坏性变更,已有工程需按以下清单适配:

• drivers/samples: I2S API 迁移
• i2s_enable()
   / i2s_disable() 由 i2s_start() / i2s_stop() 取代
• samples: lwIP 端口结构迁移
• 单/多网口的 lwipopts、arch、ethernetif 已合并为共享端口实现,依赖旧目录结构的工程需相应调整
• CHECKSUM_BY_HARDWARE
   宏改为无值定义( CHECKSUM_BY_HARDWARE),条件判断请勿再比较宏值
• drivers: SYNT 特性迁移
• SYNT 移除 SoC feature,改用 IP feature 判断,依赖 hpm_soc_feature.h 中 SYNT 宏的工程需迁移
• samples: pdgo 字段重命名
• resolution 重命名为 total_lines
• samples: TSN 示例重命名
• 示例命名与 switch port 名及 Qci 输入对齐,引用原示例名的脚本需更新
• boards: hpm5100evk 默认配置
• 默认运行点为 CPU 400MHz / AHB 200MHz,需外部 DCDC 供电

更多更新内容请参考在线文档 https://hpm-sdk.readthedocs.io/en/latest/CHANGELOG.html

已知问题

• hpm6p00evk:I2S0 与 FEMC 引脚复用问题

• PB00 引脚在 I2S0_TXD_3 与 FEMC_A_00 之间复用,使用 I2S0 codec 的示例不可用 flash_sdram_xip build type 构建或运行,否则可能损坏外部 SDRAM 数据;建议改用 flash_xip 或 ram

常用链接

在线工具

• hpm tools (pinmux & clock) https://tools.hpmicro.com/

在线文档

• hpm_sdk 在线文档：
• English: https://hpm-sdk.readthedocs.io/en/latest/
• 中文：https://hpm-sdk-zh.readthedocs.io/zh-cn/latest/
• Knowledge Base: https://kb.hpmicro.com

代码仓库

• sdk_env: github https://github.com/hpmicro/sdk_env / gitee https://gitee.com/hpmicro/sdk_env
• hpm_sdk: github https://github.com/hpmicro/hpm_sdk / gitee https://gitee.com/hpmicro/hpm_sdk
• riscv_openocd: github https://github.com/hpmicro/riscv-openocd
• riscv-gnu-toolchain releases: github https://github.com/hpmicro/riscv-gnu-toolchain/releases

先楫半导体

“先楫半导体”（HPMicro）是一家致力于高性能嵌入式解决方案的半导体公司，产品覆盖微控制器及其配套的开发工具和生态系统。公司总部坐落于上海市浦东软件园区，并在北京、天津、苏州和深圳均设立分公司，入选2025年福布斯亚洲Top100最具潜力的企业榜单。先楫半导体以产品质量为本，所有产品均通过严格的可靠性测试。目前已经量产八大系列高性能通用MCU产品，产品性能及通用性领先国际同类产品并通过AEC-Q100认证。公司已完成ISO9001质量管理和ISO 26262/IEC61508功能安全管理体系双认证，全力服务中国乃至全球的工业自动化、机器人、能源和汽车市场。更多信息，请访问 https://hpmicro.com/