Raspberry Pi Pico断言"tud_inited()"失败的原因咨询

问题现象 #

开发Raspberry Pi Pico时，偶尔会通过串口收到截断的断言错误：

assertion "tud_inited()" failed: file "<...>/pico-sdk/src/rp2_common/pico_stdio_usb/stdio_usb.c"

触发后设备直接停止运行，重构代码后部分构建正常、部分触发错误，疑似初始化顺序问题。

断言tud_inited()的校验内容 #

这个断言的核心是检查TinyUSB设备栈是否已完成初始化：tud_inited()函数会返回非零值表示TinyUSB栈初始化完成，返回0则表示未初始化。断言失败说明代码执行到依赖USB串口的逻辑时，TinyUSB栈还没准备好。

触发失败的常见场景 #

• 初始化顺序错误：调用依赖USB stdio的函数（如puts()）前，未先初始化TinyUSB栈。比如测试代码中注释掉tusb_init()就直接调用stdio_init_all()，而stdio_usb模块依赖TinyUSB，直接触发断言。
• TinyUSB初始化未完成就执行IO操作：即使调用了tusb_init()，但在USB设备完成枚举前就调用串口输出函数，也可能触发断言。
• SDK配置缺失：项目配置中未正确启用TinyUSB相关编译选项，导致tusb_init()实际未执行成功。

触发错误的示例代码 #

以下代码可直接复现问题，原因是stdio_init_all()初始化stdio_usb时，TinyUSB栈未被初始化：

int main() {
    // tusb_init();
    stdio_init_all();

    puts("v=============================================v");
    puts("v================= STARTUP ===================v");
    puts("v=============================================v");
    return 0;
}

合适的咨询渠道 #

• Raspberry Pi Pico官方论坛：聚集大量有Pico开发经验的用户和官方人员，能针对性解决SDK与硬件相关问题。
• Pico SDK的GitHub仓库Issues：若怀疑是SDK本身的BUG或功能疑问，可在此提交问题，项目维护团队会跟进处理。
• 嵌入式技术社区：国内的电子发烧友论坛、CSDN嵌入式板块，或国外的Reddit r/raspberrypipico板块，都能找到同行交流经验。

内容的提问来源于stack exchange，提问作者pqzpkaot