RT-Thread 在 Infineon CY8CKIT-062S2-43012 上的 BSP 版本演进与 PSoC6 开发板实战指南
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,其板卡实物图如下:
从 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,调用顺序如下:
- 初始化硬件资源管理器与电源管理:调用
cyhal_hwmgr_init()和cyhal_syspm_init();若配置了CY_CFG_PWR_VDDA_MV,再通过cyhal_syspm_set_supply_voltage()设置 VDDA 供电电压; - 外设配置初始化:
cycfg_config_init()默认在第一个运行用户代码的核上执行(优先 CM0+,若 CM0+ 不可用或使用预编译 CM0+ 镜像则为 CM4),随后调用cycfg_config_reservations()完成所有核的资源预留; - 注册时钟电源管理回调:默认注册
Cy_SysClk_DeepSleepCallback(顺序号CYBSP_SYSCLK_PM_CALLBACK_ORDER,默认 255,定义于 cybsp.c,建议作为进入 DeepSleep 前最后一个、退出后第一个执行的回调,以最小化低功耗进出时间);若定义了CYBSP_CUSTOM_SYSCLK_PM_CALLBACK,则改调应用自定义回调; - 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 开发
- 硬件连接:使用数据线连接开发板到 PC;
- 下载软件包:在 ENV 环境下执行
pkgs --update,将所需的 HAL 库软件包下载到Packages目录; - 生成 MDK 工程:执行
SCons --target=MDK5,ENV 自动生成 MDK5 工程; - 配置工程:打开 MDK,若未安装
Infineon-PSoC6芯片支持包,按提示在线安装;网络受限时可从 Keil 官网下载安装包离线安装(安装界面参见 figures/mdk_package.png); - 编译:安装芯片支持包后在 MDK 中编译;
- 下载:工程默认使用板载 DAP-LINK 以 SWD 方式下载,连接数据线后直接点击下载按钮即可。
使用 RT-Thread Studio 开发
- 打开 RT-Thread Studio,选择 文件 → 导入 → RT-Thread Studio 项目到工作空间(界面参见 figures/studio1.png);
- 选择
PSoC6 CY8CKIT-062S2-43012开发板支持包目录完成导入(参见 figures/studio2.png); - 点击 IDE 左上角的构建选项编译工程;
- 编译无错误告警后,点击
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 及对应源码为准。
