Raspberry Pi Pico示例项目中的MbedTLS SHA256函数兼容性问题解析

在Raspberry Pi Pico示例项目(pico-examples)中，开发者在使用mbedtls_sha256示例代码时可能会遇到一个关于函数声明的警告问题。这个问题涉及到MbedTLS加密库不同版本间的兼容性处理。

问题现象

当开发者编译pico-examples中的mbedtls_sha256示例时，编译器会报告如下警告：

警告: 隐式声明函数'mbedtls_sha256_starts_ret'; 您是指'mbedtls_sha256_starts'吗?

这个警告表明代码中使用的函数没有显式声明，编译器只能猜测开发者的意图。

问题根源

这个问题源于MbedTLS库从2.x版本升级到3.x版本时的API变更。具体来说：

1. 在MbedTLS 3.0版本中，移除了旧版的mbedtls_sha256_starts函数
2. 引入了新的mbedtls_sha256_starts_ret函数作为替代
3. 但示例代码可能需要在不同版本的MbedTLS库上都能正常工作

技术背景

MbedTLS(前身为PolarSSL)是一个轻量级的加密库，广泛应用于嵌入式系统中。在版本演进过程中，为了改进API设计，MbedTLS团队对部分函数进行了重构：

• 旧版(2.x)使用简单的函数名，如mbedtls_sha256_starts
• 新版(3.x)引入了带有_ret后缀的函数，更明确地表示这些函数会返回操作结果

这种变更属于库的向前兼容性破坏，需要开发者特别注意。

解决方案

在Raspberry Pi Pico生态系统中，考虑到以下因素：

1. 用户可能使用自定义的MbedTLS库版本
2. 需要保持对旧版本库的兼容性
3. 同时支持新版本库的特性

开发团队采取了以下措施：

1. 更新示例代码，使用条件编译来处理不同版本的API
2. 确保代码在MbedTLS 2.x和3.x版本上都能正常工作
3. 提供清晰的编译警告信息，帮助开发者理解兼容性问题

开发者建议

对于使用Pico SDK和MbedTLS的开发者，建议：

1. 明确项目依赖的MbedTLS版本
2. 在代码中使用适当的版本检测和条件编译
3. 关注编译器警告，及时处理兼容性问题
4. 查阅MbedTLS官方迁移指南，了解API变更详情

通过正确处理这些兼容性问题，可以确保加密功能在各种环境下都能可靠工作，同时保持代码的整洁和可维护性。