【临时方案更新】RDK S100 UART2 与 I2C5 引脚切换简易解决方案
各位地瓜机器人社区开发者、用户大家好！
针对 RDK S100 设备 40Pin 引脚中 UART2 与 I2C5 功能切换 的使用需求，官方常规标准方案需要通过拉取 SDK 源码、修改设备树配置、重新编译并部署的方式完成。该流程步骤较多、编译门槛较高，对于新手开发者或需要快速完成项目调试的用户来说，使用成本相对较高。
为降低开发和调试难度，快速满足项目验证、外设适配等场景需求，官方现提供一套临时便捷解决方案：通过预编译 Deb 安装包的方式，帮助用户快速完成 UART2 与 I2C5 引脚功能切换，避免手动拉取源码、修改设备树、重新编译等复杂操作。
一、重要风险提示
请务必在使用本临时 Deb 包前备份重要数据。
本次提供的 Deb 包是基于特定系统版本编译生成的临时方案，主要用于快速调试和短期项目适配。由于不同用户设备的系统版本、软件包状态、历史配置可能存在差异，安装后可能出现兼容性问题。
极端情况下，安装 Deb 包并重启设备后，可能导致系统无法正常启动或无法进入系统。
因此，在使用前请务必确认以下事项：
-
必须提前备份重要数据。
-
建议在可接受系统恢复成本的设备上进行验证。
-
建议优先在测试设备或非关键生产环境中使用。
-
如设备中已有重要项目文件、配置文件或业务数据，请先完成备份后再操作。
-
若安装后出现异常，请根据官方标准开发手册，通过源码编译方式重新适配，或重新烧录系统后恢复数据。
二、方案说明
1. 标准常规方案
按照官方完整开发手册，RDK S100 实现 UART2 与 I2C5 引脚功能切换，需要开发者手动拉取完整 SDK 源码，修改设备树对应配置文件后重新编译并部署。
该方案适配性和可控性最高，适合长期项目、深度定制开发以及对系统稳定性要求较高的场景，但操作流程相对复杂，学习和调试成本较高。
参考手册：
3.3.4 串口应用 | RDK DOC
需要注意的是，UART2 与 I2C5 使用的引脚资源存在互斥关系。
开启 UART2 功能后，必须手动禁用 I2C5 设备，二者无法同时启用。
2. 临时便捷方案
为适配轻量化使用场景、简化操作流程，官方提前编译完成了专用 Deb 安装包。用户可直接下载安装使用，无需拉取 SDK 源码，也无需手动修改设备树并重新编译。
该方案适合以下场景：
-
快速验证 UART2 外设功能；
-
短期项目调试；
-
临时硬件适配；
-
不希望完整搭建 SDK 编译环境的用户。
临时 Deb 包获取方式：
飞书云文档：
https://horizonrobotics.feishu.cn/wiki/MItZwpSNXigLu1kZAD0czrlFnlh
3. 后续官方正式方案
后续版本迭代中，官方计划将 UART2 与 I2C5 引脚切换能力集成至 srpi-config 配置工具。
届时用户可通过可视化指令界面一键完成切换，实现零代码、零编译、零手动配置操作。该方式将替代当前临时 Deb 包方案，成为后续推荐使用的标准化便捷方案。
三、使用注意事项
-
本次临时方案主要适配 UART2 开启使用场景。
-
建议系统版本满足 RDK S100 系统版本 = 4.0.5 05-Mar-2026 。
-
由于 Deb 包基于特定版本编译，跨版本使用可能存在兼容性风险。
-
安装前必须备份重要数据。
-
安装后需要重启设备，请提前确认设备可恢复、数据已备份。
-
若 Deb 包安装后出现异常、功能失效或系统无法正常启动，请参考官方原始开发手册，通过标准源码编译流程自行适配。
-
UART2 与 I2C5 引脚资源互斥，开启 UART2 后必须禁用 I2C5，二者不能同时使用。
-
临时方案仅作为过渡优化方案，待 srpi-config 一键切换功能上线后，建议切换至官方标准化方案，以获得更好的系统兼容性和长期稳定性。
四、方案选择建议
-
快速调试、短期项目适配
可优先使用本次 Deb 包临时方案，但使用前必须做好数据备份，并充分了解可能存在的系统兼容性风险。 -
长期项目、量产项目或系统深度定制
建议参考官方标准开发手册，通过源码编译方式完成配置，便于后续维护、升级和版本适配。 -
对系统稳定性要求较高的场景
建议等待后续 srpi-config 一键切换功能正式上线后再使用，或采用标准源码编译方案。
后续我们将持续优化 RDK S100 设备的功能配置体验，简化各类硬件引脚和外设适配操作，帮助开发者更高效地完成机器人项目落地。
大家在使用过程中如遇到问题，可在社区留言反馈，官方将及时跟进解答。
临时 Deb 包获取：
https://horizonrobotics.feishu.cn/wiki/MItZwpSNXigLu1kZAD0czrlFnlh