RT-Thread 在 Infineon CY8CKIT-062S2-43012 上的 BSP 版本演进与 PSoC6 开发板实战指南

原创2026-09-22 17:48:101,864 阅读
文章标签:操作系统嵌入式OSRTOS物联网系统编程嵌入式

RT-Thread 在 Infineon CY8CKIT-062S2-43012 上的 BSP 版本演进与 PSoC6 开发板实战指南

CY8CKIT-062S2-43012 是英飞凌基于 PSoC6 双核 MCU 的低成本 Wi-Fi + Bluetooth 开发平台,其 BSP(板级支持包)以"按产品家族统一版本号"的方式持续演进。本文以该 BSP 的 RELEASE.md 为骨架,结合 RT-Thread 仓库中同型号的 BSP 目录,系统梳理 BSP 的组成结构、版本迭代要点、支持的工具链与环境,并给出在 RT-Thread 中编译、烧录与运行的具体步骤。读完本文,你将能看懂该 BSP 的版本语义,理解其源码目录与初始化流程,并独立完成一次从源码到板端运行的完整实践。

开发板与 BSP 概览

CY8CKIT-062S2-43012(PSoC 6S2 Wi-Fi BT Pioneer Kit)是一块低成本硬件平台,用于 PSoC 6 MCU 的设计与调试。RELEASE.md 明确列出的板载特性包括:

  • 主控:PSoC 6 双核 MCU(150 MHz Arm Cortex-M4F + 100 MHz Cortex-M0+);
  • 无线:Murata 1LV 模块(CYW43012 Wi-Fi + Bluetooth Combo Chip);
  • 人机交互:业界领先的 CAPSENSE™ 触摸按键与滑条;
  • 调试与存储:板载 KitProg3 调试器/编程器、microSD 卡接口、512-Mb Quad-SPI NOR Flash、PDM-PCM 麦克风接口。

在 RT-Thread 仓库中,与该 BSP 对应的工程位于 bsp/Infineon/psoc6-cy8ckit-062S2-43012,其板卡实物图如下:

CY8CKIT-062S2-43012 开发板实物图,可见 PSoC6 主芯片、Quad SPI Flash、microSD 卡槽、CAPSENSE 触摸滑条与按键等板载资源

从 BSP README 可确认板载 MCU 为 CY8C624ABZI-S2D44(2 MB Flash、1 MB SRAM),BSP 已支持 UART、GPIO、I2C、RTC、WDT、PWM、SPI、HardTimer、DAC(IDAC)、片内 Flash、触摸(触摸滑条)等外设,而 SDIO、USB Device / USB Host 暂不支持。

BSP 按家族统一版本号的版本机制

RELEASE.md 中有一条关键说明:BSP 按家族(family)统一版本号。这意味着同一家族(例如 PSoC 6)内任意 BSP 的 1.2.0 版本具有相同的软件成熟度;但并非每个更新都适用于家族内每一块板卡,因此不是所有板卡都拥有每个版本号,新 BSP 也不一定从 1.0.0 开始。

其版本递增规则可以概括为:当需要在所有 BSP 中引入公共特性时,库会被赋予相同的版本号。例如若 BSP_A 处于 v1.3.0、BSP_B 处于 v1.2.0,则该事件会把两者同时更新到 v1.4.0,从而以一致的方式追踪公共特性。理解这一机制有助于你在查看不同板卡 BSP 时,将"版本号对齐"解读为"公共能力对齐",而不是单纯比较各自变更记录。

从当前仓库的 props.json 可以看到本 BSP 当前 core 版本为 4.1.0.30528,最低工具环境要求 min_tools: 3.0.0,与 RELEASE.md 中"Minimum required ModusToolbox™ Software Environment: v3.0.0"的说明一致。

BSP 库的组成结构

RELEASE.md 的 "What's Included?" 一节列出了一个完整 BSP 库应包含的部件。在 RT-Thread 仓库的 TARGET_CY8CKIT-062S2-43012 库目录 中,这些部件一一对应:

  • BSP 专用构建配置:BSP 顶层通过 SConstruct、rtconfig.py 与 rtconfig.h 组织 RT-Thread 的构建(原版 ModusToolbox 工程中对应顶层 bsp.mk,v4.0.0 起由 makefile 改名为 bsp.mk)。
  • cybsp.c/h:板级初始化入口,提供 cybsp_init();
  • cybsp_types.h:描述基本板级设置(LED/按键电平、Wi-Fi 接口类型等);
  • 链接脚本与启动代码:在 COMPONENT_CM0P/ 与 COMPONENT_CM4/ 两个目录下,分别按 TOOLCHAIN_ARM(linker.sct)、TOOLCHAIN_A_Clang(.S)、TOOLCHAIN_GCC_ARM(linker.ld)、TOOLCHAIN_IAR(linker.icf)提供 CM0+ 与 CM4 的链接脚本和启动文件;
  • Configurator 设计文件与生成代码:config/design.modus、config/design.cycapsense、config/design.cyqspi 以及 config/GeneratedSource/ 下的 cycfg*.c/h 系列文件;
  • 依赖库引用:deps/ 下的 .mtbx 文件(cat1cm0p、core-lib、core-make、mtb-hal-cat1、mtb-pdl-cat1、recipe-make-cat1a);
  • API 文档:cybsp_doc.h 中的 doxygen 注释体系。

版本演进要点解析(v1.0.0 → v4.1.0)

RELEASE.md 记录了从 v1.0.0(初始发布)到 v4.1.0 的完整演进,可归纳为以下几条主线:

依赖与工具链升级主线

  • v2.0.0:切换到 mtb-pdl / mtb-hal 依赖,时钟频率更新为 100 MHz(fast)/ 50 MHz(slow),需要 ModusToolbox 2.2+,且与 1.x 不向后兼容;
  • v3.0.0:HAL 依赖升级到 v2.0.0,CAPSENSE™ 依赖升级到 v3.0.0,使用 ModusToolbox v2.4.0 Configurator 重新生成代码;
  • v4.0.0:仅兼容 ModusToolbox 3.0+,recipe-make、core-make、PDL 升级到新大版本,使用 v3.0.0 Configurator 重新生成代码,顶层板级 makefile 更名为 bsp.mk,version.xml 被 props.json 取代。

外设与配置主线

  • v1.3.0:若在 Configurator 中设置了 VDDA 电压则进行初始化(需 psoc6hal 1.3.0+);
  • v2.0.1:优化 SCL 库的构建包含逻辑;
  • v2.1.0:为所有板卡加入 CAT1 组件,新增连接类芯片组件,为支持的板卡加入 BT 配置;
  • v2.3.0:新增连接组件便于板卡定制,简化 BT 配置;
  • v3.1.0:新增可选宏 CYBSP_CUSTOM_SYSCLK_PM_CALLBACK 用于覆盖默认时钟电源管理行为,并为带集成 BLE 射频的 MCU 启用 AIROC™ BLE 协议栈。

宏与代码质量主线

  • v1.1.0:链接脚本与启动代码按核(core)放入独立目录,避免部分工具链告警;
  • v4.1.0:新增宏 CYBSP_USER_BTN_DRIVE 表示用户按键应使用的驱动模式;修复 PSoC 64 板卡在使用 TFM 时 cybsp_init 无法识别预编译 CM0+ 镜像的问题。

其中两个宏在源码中可以直接看到定义:

  • CYBSP_USER_BTN_DRIVE 定义于 cybsp_hw_config.h,默认值为 CYHAL_GPIO_DRIVE_PULLUP;
  • CYBSP_CUSTOM_SYSCLK_PM_CALLBACK 的语义定义于 cybsp.h:定义该宏后,应用需自行实现 cybsp_register_custom_sysclk_pm_callback() 以替换默认的时钟 DeepSleep 回调逻辑。

cybsp_init 初始化流程的源码级剖析

BSP 的核心 API 是 cybsp_init(),其实现位于 cybsp.c,调用顺序如下:

  1. 初始化硬件资源管理器与电源管理:调用 cyhal_hwmgr_init() 和 cyhal_syspm_init();若配置了 CY_CFG_PWR_VDDA_MV,再通过 cyhal_syspm_set_supply_voltage() 设置 VDDA 供电电压;
  2. 外设配置初始化:cycfg_config_init() 默认在第一个运行用户代码的核上执行(优先 CM0+,若 CM0+ 不可用或使用预编译 CM0+ 镜像则为 CM4),随后调用 cycfg_config_reservations() 完成所有核的资源预留;
  3. 注册时钟电源管理回调:默认注册 Cy_SysClk_DeepSleepCallback(顺序号 CYBSP_SYSCLK_PM_CALLBACK_ORDER,默认 255,定义于 cybsp.c,建议作为进入 DeepSleep 前最后一个、退出后第一个执行的回调,以最小化低功耗进出时间);若定义了 CYBSP_CUSTOM_SYSCLK_PM_CALLBACK,则改调应用自定义回调;
  4. Wi-Fi 资源预留:若板卡具备 Wi-Fi 能力且使用 UDB SDIO 接口,则调用 SDIO_ReserveResources() 预留时钟与 DMA 实例。若 BSP 所需资源被用户提前占用,cybsp_init() 会返回 CYHAL_HWMGR_RSLT_ERR_INUSE,此时应检查 design.modus 与资源预留列表是否冲突。

在 RT-Thread 工程中,cybsp_init() 被 board.c 的 cy_bsp_all_init() 封装:初始化失败时直接执行 CY_ASSERT(0) 停止运行,成功则继续启动 RT-Thread 内核。

板级设置与引脚状态宏

cybsp_types.h 提供了一组"屏蔽高低电平差异"的宏,保证示例代码在不同板卡上行为一致:

宏 默认值 含义
CYBSP_LED_STATE_ON 0U LED 点亮时的引脚电平
CYBSP_LED_STATE_OFF 1U LED 熄灭时的引脚电平
CYBSP_BTN_PRESSED 0U 按键按下时的引脚电平
CYBSP_BTN_OFF 1U 按键松开时的引脚电平

同时,cybsp_types.h 中还定义了 Wi-Fi 接口类型常量(CYBSP_SDIO_INTERFACE、CYBSP_SPI_INTERFACE、CYBSP_M2M_INTERFACE),并根据 COMPONENT_WIFI_INTERFACE_SDIO/SPI/M2M 自动映射 CYBSP_WIFI_INTERFACE_TYPE,为旧代码提供兼容。本板卡采用 CYW43012 组合芯片,从 props.json 的 capabilities 列表(cyw43012、wifi、bt)可以看出 Wi-Fi/BT 均为该板的官方能力项。

蓝牙配置项说明

针对带 BLE 的板卡,BSP 提供蓝牙平台配置结构体,定义于 bluetooth/cybsp_bt_config.h,仅在定义了 COMPONENT_WICED_BLE 或 COMPONENT_WICED_DUALMODE 时生效。可覆盖的宏包括:

宏 默认值 说明
CYBSP_BT_PLATFORM_CFG_BAUD_DOWNLOAD 115200 固件下载波特率
CYBSP_BT_PLATFORM_CFG_BAUD_FEATURE 115200 正常工作波特率
CYBSP_BT_PLATFORM_CFG_BITS_DATA 8 数据位
CYBSP_BT_PLATFORM_CFG_BITS_STOP 1 停止位
CYBSP_BT_PLATFORM_CFG_MEM_POOL_BYTES 2048 任务内存池大小(字节)

这些宏均以 #if !defined(...) 包裹,可在应用层预定义以覆盖默认值,便于适配不同射频模块与吞吐需求。

支持的工具链与软件环境

RELEASE.md 给出了本版本 BSP 验证过的软件与工具组合:

软件与工具 版本
ModusToolbox™ 软件环境 3.0.0
GCC 编译器 10.3.1
IAR 编译器 9.30.1
ARM 编译器 6.16

最低要求的 ModusToolbox™ 软件环境为 v3.0.0。这一点在仓库中得到了双重印证:props.json 的 min_tools 字段同为 3.0.0,且 v4.0.0 起生成的 Configurator 代码与构建脚本(bsp.mk、props.json 取代 version.xml)均面向 ModusToolbox 3.x 设计。因此,若要基于该 BSP 使用 ModusToolbox 生态,需确保工具版本 ≥ 3.0.0。

需要说明的是:在 RT-Thread 仓库内,该板卡的开发环境以 BSP README 为准,支持 MDK V5(ARMClang)与 RT-Thread Studio(GCC)两条路径,链接脚本覆盖 GCC(linker.ld)、IAR(linker.icf)、ARM(linker.sct)、A_Clang(.S)四种工具链。

在 RT-Thread 中快速上手(MDK V5 与 RT-Thread Studio)

下面按 BSP 的 快速上手文档 复述两种开发路径。

使用 MDK V5 开发

  1. 硬件连接:使用数据线连接开发板到 PC;
  2. 下载软件包:在 ENV 环境下执行 pkgs --update,将所需的 HAL 库软件包下载到 Packages 目录;
  3. 生成 MDK 工程:执行 SCons --target=MDK5,ENV 自动生成 MDK5 工程;
  4. 配置工程:打开 MDK,若未安装 Infineon-PSoC6 芯片支持包,按提示在线安装;网络受限时可从 Keil 官网下载安装包离线安装(安装界面参见 figures/mdk_package.png);
  5. 编译:安装芯片支持包后在 MDK 中编译;
  6. 下载:工程默认使用板载 DAP-LINK 以 SWD 方式下载,连接数据线后直接点击下载按钮即可。

使用 RT-Thread Studio 开发

  1. 打开 RT-Thread Studio,选择 文件 → 导入 → RT-Thread Studio 项目到工作空间(界面参见 figures/studio1.png);
  2. 选择 PSoC6 CY8CKIT-062S2-43012 开发板支持包目录完成导入(参见 figures/studio2.png);
  3. 点击 IDE 左上角的构建选项编译工程;
  4. 编译无错误告警后,点击 Debug 或 Download 调试/下载(参见 figures/studio4-download.png)。若下载成功后串口无输出,请手动按下复位按键重启运行。

运行结果验证

程序下载成功后系统自动运行。打开串口助手(如 MobaXterm),波特率选择 115200,复位设备后 LED 以 500 Hz 频率闪烁,终端输出 RT-Thread 启动信息:

 \ | /
- RT -     Thread Operating System
 / | \     4.1.1 build Jul 25 2022 18:03:35
 2006 - 2022 Copyright by RT-Thread team
msh >

进入 msh 命令行后,即可利用 applications/main.c 及 board/ports 下的示例(如 spi_sample.c、slider_sample.c、drv_rw007.c、fal_cfg.h)进一步体验 SPI、触摸滑条等外设。

总结

CY8CKIT-062S2-43012 BSP 的 RELEASE.md 不仅是变更日志,更是一份理解 PSoC6 板级支持包演进逻辑的指南:按家族统一版本号保证了公共特性的可追踪性;从 v1.0.0 到 v4.1.0 的更新记录清晰展示了依赖升级、Configurator 代码再生成、宏能力扩展三条主线。结合 cybsp.c、cybsp_types.h 等源码,可以直观看到初始化流程、引脚状态宏与蓝牙配置项如何落地;配合 RT-Thread BSP 工程 的 MDK/Studio 上手步骤,即可快速将 RT-Thread 跑在这块双核 Wi-Fi/BT 开发板上。


© Cypress Semiconductor Corporation (an Infineon company),2019-2022。文中版本信息与工具版本均以当前仓库 RELEASE.md 及对应源码为准。

登录后查看全文
rt-thread