Zephyr 板级实战Adafruit TRRS TrinkeySAMD21E18时钟配置、USB CDC-ACM 串口与 UF2 烧录全流程解析【免费下载链接】zephyrPrimary Git Repository for the Zephyr Project. Zephyr is a new generation, scalable, optimized, secure RTOS for multiple hardware architectures.项目地址: https://gitcode.com/GitHub_Trending/ze/zephyr本文以 Zephyr 官方板卡文档 boards/adafruit/trrs_trinkey/doc/index.rst 为主线完整覆盖 Adafruit TRRS Trinkey 的硬件规格、TRRS 插脚映射、系统时钟方案、STEMMA QT I2C 与 USB CDC-ACM 串口控制台的实现方式并结合仓库内的设备树、defconfig 与 board.cmake 源码给出从构建hello_world到 UF2 烧录上板的可复现实操步骤。读完后你可以掌握该板卡在 Zephyr 中的板级配置原理并能独立完成构建、串口监听与固件烧写。一、板卡概述与硬件规格Adafruit TRRS Trinkey 是一块小型 ARM 开发板板载 TRRS 插孔、RGB LED、USB 接口和 STEMMA QT 接口适合作为便携 USB 外设与 I2C 传感器扩展平台。其硬件配置如下处理器ATSAMD21E18AARM Cortex-M0主频 48 MHz存储256 KiB Flash、32 KiB RAM时钟源片内已微调trimmed8 MHz 内部振荡器外设TRRS 插孔、STEMMA QT I2C 接口、RGB NeoPixel LEDWS2812B、原生 USB 口、一个复位按键以上规格与仓库中的板卡元数据 adafruit_trrs_trinkey.yaml 完全一致arch: arm、ram: 32KiB、flash: 256KiB且声明支持zephyr与gnuarmemb两套工具链。板卡标识定义在 board.yml 中socs项明确其 SoC 为samd21e18a对应的 Kconfig 符号BOARD_ADAFRUIT_TRRS_TRINKEY在 Kconfig.adafruit_trrs_trinkey 中定义并select SOC_SAMD21E18A。设备树根节点的 compatible 为adafruit,trrs-trinkey, atmel,samd21e18a, atmel,samd21见 adafruit_trrs_trinkey.dts。官方支持的外设特性文档中的 Supported Features 表格由board.yaml的supported字段自动生成。从 adafruit_trrs_trinkey.yaml 看该板卡支持的特性清单为类别说明adc模拟输入TRRS 插孔的 AIN 通道依赖它counter/rtc计数器与实时时钟dmaDMA 引擎gpio通用 IOhwinfo硬件信息接口i2c/zephyr_i2cI2C 外设与板级别名节点pwm脉宽调制spiSPI通过 SERCOM 复用实现uartUART此处为 CDC-ACM 虚拟串口usbdUSB 设备watchdog看门狗二、系统时钟8 MHz 内部振荡器驱动 48 MHz 系统时钟官方文档明确说明SAMD21 MCU 被配置为使用 8 MHz 内部振荡器由片上锁频环DFLL/PLL产生 48 MHz 系统时钟APB 与 GCLK 时钟树的上游方式与 Arduino 官方库保持一致。这一方案的关键点在于板卡不依赖外部晶振全部时钟来自片内振荡器。该配置由板级 defconfig 落实见 adafruit_trrs_trinkey_defconfigCONFIG_SOC_ATMEL_SAMD_OSC8My CONFIG_SOC_ATMEL_SAMD_OSC8M_AS_MAINy CONFIG_SOC_ATMEL_SAMD_OSC32KyOSC8M使能 8 MHz 内部振荡器OSC8M_AS_MAIN将其设为 GCLK 主时钟源OSC32K使能 32.768 kHz 内部低频振荡器供 RTC 等使用。时钟频率的推导链可以在 SoC 源码中找到。在 soc/atmel/sam0/samd21/soc.h 中定义了关键常量SOC_ATMEL_SAM0_DFLL48M_MAX_FREQ_HZ 48000000与SOC_ATMEL_SAM0_OSC8M_FREQ_HZ 8000000。当选中CONFIG_SOC_ATMEL_SAMD_OSC8M_AS_MAIN分支时SOC_ATMEL_SAM0_GCLK1_SRC_FREQ_HZ被设为 8 MHz随后 GCLK0 分频器按DFLL48M / MCK计算最终 DFLL 输出 48 MHz 作为主时钟。设备树侧则在 adafruit_trrs_trinkey.dts 中把 CPU 主频声明为cpu0 { clock-frequency DT_FREQ_M(48); };两者配合完成了文档所述8 MHz 内部振荡器 锁频环 → 48 MHz 系统时钟的完整闭环。三、连接与 IOTRRS 插脚映射与 STEMMA QT I2CTRRS 插孔引脚TRRS 插孔直接连接到 SAMD21 的模拟输入通道AIN与 GPIO引脚映射如下来自官方文档MCU 引脚插孔功能PA02 (AIN0)Tip尖端PA03 (AIN1)Tip Switch尖端开关检测 Tip 插入PA04 (AIN4)Ring 2PA05 (AIN5)Sleeve袖端/地PA06 (AIN6)Ring 1PA07 (AIN7)Ring Switch检测 Ring 插入从引脚号 AIN0AIN7 可以看出这些引脚天然复用 ADC 通道把耳机/线材当作线缆外设识别Tip/Ring 开关作为插拔检测并用 ADC 读取模拟信号这正是 TRRS Trinkey 的设计用途。hwinfo特性的存在也印证了这类识别连接设备的场景。STEMMA QT I2CSERCOM2 复用为 I2CSAMD21 共有 5 个基于 SERCOM 的 I2C 外设TRRS Trinkey 选用SERCOM2驱动 STEMMA QT 接口。设备树中的完整配置adafruit_trrs_trinkey.dts为zephyr_i2c: sercom2 { status okay; compatible atmel,sam0-i2c; clock-frequency I2C_BITRATE_FAST; /* 400 kHz 快速模式 */ #address-cells 1; #size-cells 0; pinctrl-0 sercom2_i2c_default; pinctrl-names default; };几个可落地的细节400 kHz 快速模式I2C_BITRATE_FAST定义了总线速率符合 STEMMA QT 的 I2C 规范可直接挂接 Adafruit 各类 QT 传感器。引脚复用在 adafruit_trrs_trinkey-pinctrl.dtsi 中sercom2_i2c_default将 PA8 复用为 SERCOM2_PAD0SCL、PA9 复用为 SERCOM2_PAD1SDA复用模式均为 D多功能复用。板级别名根节点aliases { i2c-0 sercom2; watchdog0 wdog; }让DT_ALIAS(i2c_0)等惯例写法可直接命中 STEMMA QT 总线同时zephyr_i2c节点别名供板级 I2C 特性使用。连接器件节点stemma_connectorcompatiblestemma-qt-connector用gpio-map把 SCL 映射到PORTA 9、SDA 映射到PORTA 8使 I2C 从设备的io-channel-map能正确解析地址线。USB CDC-ACM原生 USB 口承担控制台 I/OTRRS Trinkey 有原生 USB 口但没有引出独立的 UART 引脚因此 Zephyr 使用USB CDC-ACM 虚拟串口作为控制台。板级设备树末尾包含了公共片段adafruit_trrs_trinkey.dts#include ../boards/common/usb/cdc_acm_serial.dtsi该公共片段 boards/common/usb/cdc_acm_serial.dtsi 完成了三件事在zephyr_udc0USB Device 控制器节点下创建board_cdc_acm_uart子节点compatible 为zephyr,cdc-acm-uart把zephyr,console、zephyr,shell-uart、zephyr,uart-mcmgr、zephyr,bt-mon-uart、zephyr,bt-c2h-uart五个 chosen 全部指向该 CDC-ACM 节点——即控制台、shell、mcumgr、蓝牙监控/主机链路串口全部复用同一 USB 口设备树中zephyr_udc0: usb0 { status okay; ... }使能 USB Device 控制器其引脚复用PA25 → USB_DP、PA24 → USB_DM见 pinctrl 文件中的usb_dc_default组。Kconfig 侧则通过 Kconfig.defconfigsource公共的boards/common/usb/Kconfig.cdc_acm_serial.defconfig自动打开 CDC-ACM 相关的内核选项defconfig 中显式列出的CONFIG_CONSOLEy、CONFIG_SERIALy、CONFIG_UART_CONSOLEy、CONFIG_UART_INTERRUPT_DRIVENy进一步保证中断驱动的串口控制台可用。RGB NeoPixel 的限制说明板上的 WS2812B RGB LED 接在PA01。官方文档特别指出目前没有适配该 MCU 引脚组合的 Zephyr 驱动因此在 Zephyr 中暂不能直接控制这颗灯。如果你在应用中看到 LED 不亮这是已知的支持缺口而非接线或烧录问题。四、Flash 分区与 UF2 启动流程256 KiB Flash 被划分为三个分区完整定义在 adafruit_trrs_trinkey.dts分区标签起始地址大小说明uf2boot_partition0x000000008 KiB只读存放 UF2 引导程序codecode_partition0x2000232 KiB256−8−16只读应用程序代码zephyr,code-partition指向它storagestorage_partition0x3C00016 KiB保留给应用启用后可供 FCB/LittleFS/NVS 存储子系统使用分区布局与 defconfig 中的引导加载配置相呼应CONFIG_BOOTLOADER_BOSSAy CONFIG_BOOTLOADER_BOSSA_ADAFRUIT_UF2y CONFIG_BUILD_OUTPUT_UF2y CONFIG_BUILD_OUTPUT_HEXy即固件同时输出 UF2 与 HEX 两种产物并声明板载的是 Adafruit 定制 UF2 布局的 BOSSA 兼容引导加载程序。五、编程与烧录实战引导加载程序TRRS Trinkey 出厂预置BOSSA 兼容的 UF2 引导加载程序进入方式为快速双击复位按键。进入后板子会作为 USB 大容量存储设备出现UF2 文件可被自动烧写。第一步构建内核与 hello_world 示例使用 west 以adafruit_trrs_trinkey为目标板构建官方示例west build -b adafruit_trrs_trinkey samples/hello_world等价于 Zephyr 文档指令块zephyr-app: samples/hello_world, board: adafruit_trrs_trinkey, goals: build。构建产物包含 UF2 镜像build/zephyr/zephyr.uf2。第二步监听串口输出用 USB 线连接 TRRS Trinkey 到主机打开终端程序监听输出。在 Linux 下该 CDC-ACM 设备呈现为/dev/ttyACM0$ minicom -D /dev/ttyACM0 -o-o选项让 minicom 不发送调制解调器初始化字符串。串口参数配置为Speed: 115200Data: 8 bitsParity: NoneStop bits: 1即 115200 8N1。Windows/macOS 下设备名不同但 CDC-ACM 的字符设备无需安装额外驱动。第三步进入 UF2 模式并烧写快速双击复位按键进入引导加载模式然后执行烧录目标west flash -b adafruit_trrs_trinkey对应文档指令块goals: flash。成功后终端应打印Hello World! adafruit_trrs_trinkey/samd21e18a可用的调试器Runner除了 UF2 烧录board.cmake 还配置了四个 SWD 调试器 runner可按需选用west flash -r runnerRunner关键参数uf2--board-idSAMD21E18A-TRRSTrinkey-v0UF2 板卡 IDbossac公共配置见 boards/common/bossac.board.cmake--bossac${BOSSAC}指定工具路径默认 flasherjlink--deviceATSAMD21E18A --speed4000openocdtransport select swd并加载at91samdXX.cfg目标pyocd--targetATSAMD21E18A --frequency400000其中board_set_flasher_ifnset(bossac)表明在 SWD runner 之外未显式指定时 bossac 会被视为默认 flasher。六、构建期的设备树细节与已知限制两个小细节值得了解便于排查构建告警DTC 告警抑制pre_dt_board.cmake 追加了-Wno-spi_bus_bridgeSPI 经 SERCOM 实现节点名不是spi...和-Wno-unique_unit_address_if_enabledpinmux 与 gpio 节点地址重叠属 SAMD 系列的固有结构。NeoPixel 无驱动如前所述PA01 上的 WS2812B 目前缺少适配该 MCU/引脚组合的 Zephyr 驱动相关功能暂不可用。七、关键文件索引文件作用boards/adafruit/trrs_trinkey/doc/index.rst官方板卡文档本文主线boards/adafruit/trrs_trinkey/adafruit_trrs_trinkey.dts设备树I2C、分区、USB、CPU 主频boards/adafruit/trrs_trinkey/adafruit_trrs_trinkey-pinctrl.dtsiSERCOM2 I2C 与 USB 引脚复用boards/adafruit/trrs_trinkey/adafruit_trrs_trinkey_defconfig时钟、BOSSA/UF2、控制台默认配置boards/adafruit/trrs_trinkey/board.cmakeuf2/bossac/jlink/openocd/pyocd runner 参数boards/common/usb/cdc_acm_serial.dtsiCDC-ACM 虚拟串口控制台公共片段soc/atmel/sam0/samd21/soc.h48 MHz 系统时钟推导常量boards/adafruit/trrs_trinkey/adafruit_trrs_trinkey.yaml板卡元数据与支持特性清单samples/hello_world烧录验证用示例应用总结TRRS Trinkey 在 Zephyr 中是一个无外部晶振、无物理 UART的典型 USB 优先型开发板——时钟完全依赖片内 8 MHz 振荡器经 DFLL 倍频到 48 MHz控制台与 shell 全部走 USB CDC-ACM烧录依赖 UF2 引导加载器。理解其设备树sam0-i2c的 SERCOM2 复用、cdc-acm-uart节点、三分区 Flash 布局与 defconfigOSC8M 主时钟、BOOTLOADER_BOSSA即可独立完成该板从构建到上板验证的完整流程也能以此为模板迁移到其他 SAMD21 平台的 USB-CDC 板卡。【免费下载链接】zephyrPrimary Git Repository for the Zephyr Project. Zephyr is a new generation, scalable, optimized, secure RTOS for multiple hardware architectures.项目地址: https://gitcode.com/GitHub_Trending/ze/zephyr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Zephyr 板级实战：Adafruit TRRS Trinkey（SAMD21E18）时钟配置、USB CDC-ACM 串口与 UF2 烧录全流程解析
Zephyr 板级实战Adafruit TRRS TrinkeySAMD21E18时钟配置、USB CDC-ACM 串口与 UF2 烧录全流程解析【免费下载链接】zephyrPrimary Git Repository for the Zephyr Project. Zephyr is a new generation, scalable, optimized, secure RTOS for multiple hardware architectures.项目地址: https://gitcode.com/GitHub_Trending/ze/zephyr本文以 Zephyr 官方板卡文档 boards/adafruit/trrs_trinkey/doc/index.rst 为主线完整覆盖 Adafruit TRRS Trinkey 的硬件规格、TRRS 插脚映射、系统时钟方案、STEMMA QT I2C 与 USB CDC-ACM 串口控制台的实现方式并结合仓库内的设备树、defconfig 与 board.cmake 源码给出从构建hello_world到 UF2 烧录上板的可复现实操步骤。读完后你可以掌握该板卡在 Zephyr 中的板级配置原理并能独立完成构建、串口监听与固件烧写。一、板卡概述与硬件规格Adafruit TRRS Trinkey 是一块小型 ARM 开发板板载 TRRS 插孔、RGB LED、USB 接口和 STEMMA QT 接口适合作为便携 USB 外设与 I2C 传感器扩展平台。其硬件配置如下处理器ATSAMD21E18AARM Cortex-M0主频 48 MHz存储256 KiB Flash、32 KiB RAM时钟源片内已微调trimmed8 MHz 内部振荡器外设TRRS 插孔、STEMMA QT I2C 接口、RGB NeoPixel LEDWS2812B、原生 USB 口、一个复位按键以上规格与仓库中的板卡元数据 adafruit_trrs_trinkey.yaml 完全一致arch: arm、ram: 32KiB、flash: 256KiB且声明支持zephyr与gnuarmemb两套工具链。板卡标识定义在 board.yml 中socs项明确其 SoC 为samd21e18a对应的 Kconfig 符号BOARD_ADAFRUIT_TRRS_TRINKEY在 Kconfig.adafruit_trrs_trinkey 中定义并select SOC_SAMD21E18A。设备树根节点的 compatible 为adafruit,trrs-trinkey, atmel,samd21e18a, atmel,samd21见 adafruit_trrs_trinkey.dts。官方支持的外设特性文档中的 Supported Features 表格由board.yaml的supported字段自动生成。从 adafruit_trrs_trinkey.yaml 看该板卡支持的特性清单为类别说明adc模拟输入TRRS 插孔的 AIN 通道依赖它counter/rtc计数器与实时时钟dmaDMA 引擎gpio通用 IOhwinfo硬件信息接口i2c/zephyr_i2cI2C 外设与板级别名节点pwm脉宽调制spiSPI通过 SERCOM 复用实现uartUART此处为 CDC-ACM 虚拟串口usbdUSB 设备watchdog看门狗二、系统时钟8 MHz 内部振荡器驱动 48 MHz 系统时钟官方文档明确说明SAMD21 MCU 被配置为使用 8 MHz 内部振荡器由片上锁频环DFLL/PLL产生 48 MHz 系统时钟APB 与 GCLK 时钟树的上游方式与 Arduino 官方库保持一致。这一方案的关键点在于板卡不依赖外部晶振全部时钟来自片内振荡器。该配置由板级 defconfig 落实见 adafruit_trrs_trinkey_defconfigCONFIG_SOC_ATMEL_SAMD_OSC8My CONFIG_SOC_ATMEL_SAMD_OSC8M_AS_MAINy CONFIG_SOC_ATMEL_SAMD_OSC32KyOSC8M使能 8 MHz 内部振荡器OSC8M_AS_MAIN将其设为 GCLK 主时钟源OSC32K使能 32.768 kHz 内部低频振荡器供 RTC 等使用。时钟频率的推导链可以在 SoC 源码中找到。在 soc/atmel/sam0/samd21/soc.h 中定义了关键常量SOC_ATMEL_SAM0_DFLL48M_MAX_FREQ_HZ 48000000与SOC_ATMEL_SAM0_OSC8M_FREQ_HZ 8000000。当选中CONFIG_SOC_ATMEL_SAMD_OSC8M_AS_MAIN分支时SOC_ATMEL_SAM0_GCLK1_SRC_FREQ_HZ被设为 8 MHz随后 GCLK0 分频器按DFLL48M / MCK计算最终 DFLL 输出 48 MHz 作为主时钟。设备树侧则在 adafruit_trrs_trinkey.dts 中把 CPU 主频声明为cpu0 { clock-frequency DT_FREQ_M(48); };两者配合完成了文档所述8 MHz 内部振荡器 锁频环 → 48 MHz 系统时钟的完整闭环。三、连接与 IOTRRS 插脚映射与 STEMMA QT I2CTRRS 插孔引脚TRRS 插孔直接连接到 SAMD21 的模拟输入通道AIN与 GPIO引脚映射如下来自官方文档MCU 引脚插孔功能PA02 (AIN0)Tip尖端PA03 (AIN1)Tip Switch尖端开关检测 Tip 插入PA04 (AIN4)Ring 2PA05 (AIN5)Sleeve袖端/地PA06 (AIN6)Ring 1PA07 (AIN7)Ring Switch检测 Ring 插入从引脚号 AIN0AIN7 可以看出这些引脚天然复用 ADC 通道把耳机/线材当作线缆外设识别Tip/Ring 开关作为插拔检测并用 ADC 读取模拟信号这正是 TRRS Trinkey 的设计用途。hwinfo特性的存在也印证了这类识别连接设备的场景。STEMMA QT I2CSERCOM2 复用为 I2CSAMD21 共有 5 个基于 SERCOM 的 I2C 外设TRRS Trinkey 选用SERCOM2驱动 STEMMA QT 接口。设备树中的完整配置adafruit_trrs_trinkey.dts为zephyr_i2c: sercom2 { status okay; compatible atmel,sam0-i2c; clock-frequency I2C_BITRATE_FAST; /* 400 kHz 快速模式 */ #address-cells 1; #size-cells 0; pinctrl-0 sercom2_i2c_default; pinctrl-names default; };几个可落地的细节400 kHz 快速模式I2C_BITRATE_FAST定义了总线速率符合 STEMMA QT 的 I2C 规范可直接挂接 Adafruit 各类 QT 传感器。引脚复用在 adafruit_trrs_trinkey-pinctrl.dtsi 中sercom2_i2c_default将 PA8 复用为 SERCOM2_PAD0SCL、PA9 复用为 SERCOM2_PAD1SDA复用模式均为 D多功能复用。板级别名根节点aliases { i2c-0 sercom2; watchdog0 wdog; }让DT_ALIAS(i2c_0)等惯例写法可直接命中 STEMMA QT 总线同时zephyr_i2c节点别名供板级 I2C 特性使用。连接器件节点stemma_connectorcompatiblestemma-qt-connector用gpio-map把 SCL 映射到PORTA 9、SDA 映射到PORTA 8使 I2C 从设备的io-channel-map能正确解析地址线。USB CDC-ACM原生 USB 口承担控制台 I/OTRRS Trinkey 有原生 USB 口但没有引出独立的 UART 引脚因此 Zephyr 使用USB CDC-ACM 虚拟串口作为控制台。板级设备树末尾包含了公共片段adafruit_trrs_trinkey.dts#include ../boards/common/usb/cdc_acm_serial.dtsi该公共片段 boards/common/usb/cdc_acm_serial.dtsi 完成了三件事在zephyr_udc0USB Device 控制器节点下创建board_cdc_acm_uart子节点compatible 为zephyr,cdc-acm-uart把zephyr,console、zephyr,shell-uart、zephyr,uart-mcmgr、zephyr,bt-mon-uart、zephyr,bt-c2h-uart五个 chosen 全部指向该 CDC-ACM 节点——即控制台、shell、mcumgr、蓝牙监控/主机链路串口全部复用同一 USB 口设备树中zephyr_udc0: usb0 { status okay; ... }使能 USB Device 控制器其引脚复用PA25 → USB_DP、PA24 → USB_DM见 pinctrl 文件中的usb_dc_default组。Kconfig 侧则通过 Kconfig.defconfigsource公共的boards/common/usb/Kconfig.cdc_acm_serial.defconfig自动打开 CDC-ACM 相关的内核选项defconfig 中显式列出的CONFIG_CONSOLEy、CONFIG_SERIALy、CONFIG_UART_CONSOLEy、CONFIG_UART_INTERRUPT_DRIVENy进一步保证中断驱动的串口控制台可用。RGB NeoPixel 的限制说明板上的 WS2812B RGB LED 接在PA01。官方文档特别指出目前没有适配该 MCU 引脚组合的 Zephyr 驱动因此在 Zephyr 中暂不能直接控制这颗灯。如果你在应用中看到 LED 不亮这是已知的支持缺口而非接线或烧录问题。四、Flash 分区与 UF2 启动流程256 KiB Flash 被划分为三个分区完整定义在 adafruit_trrs_trinkey.dts分区标签起始地址大小说明uf2boot_partition0x000000008 KiB只读存放 UF2 引导程序codecode_partition0x2000232 KiB256−8−16只读应用程序代码zephyr,code-partition指向它storagestorage_partition0x3C00016 KiB保留给应用启用后可供 FCB/LittleFS/NVS 存储子系统使用分区布局与 defconfig 中的引导加载配置相呼应CONFIG_BOOTLOADER_BOSSAy CONFIG_BOOTLOADER_BOSSA_ADAFRUIT_UF2y CONFIG_BUILD_OUTPUT_UF2y CONFIG_BUILD_OUTPUT_HEXy即固件同时输出 UF2 与 HEX 两种产物并声明板载的是 Adafruit 定制 UF2 布局的 BOSSA 兼容引导加载程序。五、编程与烧录实战引导加载程序TRRS Trinkey 出厂预置BOSSA 兼容的 UF2 引导加载程序进入方式为快速双击复位按键。进入后板子会作为 USB 大容量存储设备出现UF2 文件可被自动烧写。第一步构建内核与 hello_world 示例使用 west 以adafruit_trrs_trinkey为目标板构建官方示例west build -b adafruit_trrs_trinkey samples/hello_world等价于 Zephyr 文档指令块zephyr-app: samples/hello_world, board: adafruit_trrs_trinkey, goals: build。构建产物包含 UF2 镜像build/zephyr/zephyr.uf2。第二步监听串口输出用 USB 线连接 TRRS Trinkey 到主机打开终端程序监听输出。在 Linux 下该 CDC-ACM 设备呈现为/dev/ttyACM0$ minicom -D /dev/ttyACM0 -o-o选项让 minicom 不发送调制解调器初始化字符串。串口参数配置为Speed: 115200Data: 8 bitsParity: NoneStop bits: 1即 115200 8N1。Windows/macOS 下设备名不同但 CDC-ACM 的字符设备无需安装额外驱动。第三步进入 UF2 模式并烧写快速双击复位按键进入引导加载模式然后执行烧录目标west flash -b adafruit_trrs_trinkey对应文档指令块goals: flash。成功后终端应打印Hello World! adafruit_trrs_trinkey/samd21e18a可用的调试器Runner除了 UF2 烧录board.cmake 还配置了四个 SWD 调试器 runner可按需选用west flash -r runnerRunner关键参数uf2--board-idSAMD21E18A-TRRSTrinkey-v0UF2 板卡 IDbossac公共配置见 boards/common/bossac.board.cmake--bossac${BOSSAC}指定工具路径默认 flasherjlink--deviceATSAMD21E18A --speed4000openocdtransport select swd并加载at91samdXX.cfg目标pyocd--targetATSAMD21E18A --frequency400000其中board_set_flasher_ifnset(bossac)表明在 SWD runner 之外未显式指定时 bossac 会被视为默认 flasher。六、构建期的设备树细节与已知限制两个小细节值得了解便于排查构建告警DTC 告警抑制pre_dt_board.cmake 追加了-Wno-spi_bus_bridgeSPI 经 SERCOM 实现节点名不是spi...和-Wno-unique_unit_address_if_enabledpinmux 与 gpio 节点地址重叠属 SAMD 系列的固有结构。NeoPixel 无驱动如前所述PA01 上的 WS2812B 目前缺少适配该 MCU/引脚组合的 Zephyr 驱动相关功能暂不可用。七、关键文件索引文件作用boards/adafruit/trrs_trinkey/doc/index.rst官方板卡文档本文主线boards/adafruit/trrs_trinkey/adafruit_trrs_trinkey.dts设备树I2C、分区、USB、CPU 主频boards/adafruit/trrs_trinkey/adafruit_trrs_trinkey-pinctrl.dtsiSERCOM2 I2C 与 USB 引脚复用boards/adafruit/trrs_trinkey/adafruit_trrs_trinkey_defconfig时钟、BOSSA/UF2、控制台默认配置boards/adafruit/trrs_trinkey/board.cmakeuf2/bossac/jlink/openocd/pyocd runner 参数boards/common/usb/cdc_acm_serial.dtsiCDC-ACM 虚拟串口控制台公共片段soc/atmel/sam0/samd21/soc.h48 MHz 系统时钟推导常量boards/adafruit/trrs_trinkey/adafruit_trrs_trinkey.yaml板卡元数据与支持特性清单samples/hello_world烧录验证用示例应用总结TRRS Trinkey 在 Zephyr 中是一个无外部晶振、无物理 UART的典型 USB 优先型开发板——时钟完全依赖片内 8 MHz 振荡器经 DFLL 倍频到 48 MHz控制台与 shell 全部走 USB CDC-ACM烧录依赖 UF2 引导加载器。理解其设备树sam0-i2c的 SERCOM2 复用、cdc-acm-uart节点、三分区 Flash 布局与 defconfigOSC8M 主时钟、BOOTLOADER_BOSSA即可独立完成该板从构建到上板验证的完整流程也能以此为模板迁移到其他 SAMD21 平台的 USB-CDC 板卡。【免费下载链接】zephyrPrimary Git Repository for the Zephyr Project. Zephyr is a new generation, scalable, optimized, secure RTOS for multiple hardware architectures.项目地址: https://gitcode.com/GitHub_Trending/ze/zephyr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考