Embassy项目中使用STM32F103RC的UART5接口问题解析

在使用Embassy嵌入式框架开发STM32F103RC项目时，开发者可能会遇到无法找到UART5外设的问题。本文将深入分析这一问题的原因，并提供完整的解决方案。

问题现象

当开发者尝试在STM32F103RC芯片上使用UART5接口连接LiDAR设备时，发现embassy_stm32::peripherals模块中并没有提供UART5的相关定义。然而，查阅STM32-METAPAC(版本15)的文档可以确认STM32F103RC芯片确实支持UART5接口。

原因分析

经过深入调查，发现问题的根源在于Cargo.toml中引用的embassy-stm32版本。当前crates.io上发布的0.1.0版本与GitHub上的最新代码存在差异，GitHub仓库中的代码已经包含了UART5的支持，但官方发布的crate版本尚未同步这一更新。

解决方案

要解决这个问题，开发者需要修改Cargo.toml文件，直接从GitHub仓库引用embassy-stm32的最新代码，而不是使用crates.io上的发布版本。具体修改如下：

embassy-stm32 = { git = "https://github.com/embassy-rs/embassy.git" }

技术背景

STM32F103RC属于STM32F1系列微控制器，其外设配置需要通过PAC(Peripheral Access Crate)来访问。Embassy框架为了提供更友好的异步编程接口，在其外围设备抽象层中对PAC进行了进一步封装。

UART5作为STM32F1系列的高级串行通信接口，通常用于需要额外串口的应用场景。在嵌入式开发中，直接从GitHub引用依赖项是一种常见做法，特别是在需要使用最新功能或修复特定问题时。

注意事项

1. 直接从GitHub引用依赖会使用最新的开发版本，可能存在一定的稳定性风险
2. 项目构建时需要联网获取GitHub代码
3. 对于生产环境，建议锁定特定的Git提交哈希以保证可重复构建
4. 当官方发布新版本后，可考虑切换回crates.io的稳定版本

总结

Embassy作为一个活跃发展的嵌入式框架，其GitHub仓库往往包含最新的功能支持。当开发者遇到外设支持不全的问题时，考虑直接从源码仓库获取最新版本是一个有效的解决方案。这也提醒我们在嵌入式开发中，需要密切关注所使用框架的更新动态，特别是在需要使用特定硬件功能时。