【保姆级打包】水下管道巡检机器人源码拆解|全国第八名参赛作品,STM32 + K210 双 MCU 一次跑通
【保姆级打包】水下管道巡检机器人源码拆解|全国第八名参赛作品,STM32 + K210 双 MCU 一次跑通
这套水下管道巡检机器人源码来自 2021 年中国大学生工程实践与创新能力大赛(智能+赛道·水下管道巡检赛项),团队编号 ZS8434,最终拿下全国第八名(国银奖)。仓库里是当年参赛用的完整工程:STM32 主控固件加 K210 视觉程序,你能直接看到一台比赛级水下 ROV 是怎么搭起来的。
项目背景与含金量
- 赛事:2021 年中国大学生工程实践与创新能力大赛(国赛)
- 赛道/赛项:智能+赛道 · 水下管道巡检赛项
- 成绩:全国第八名,国银奖,团队编号 ZS8434
- 硬件规格:STM32F411 + K210 双芯片架构,姿态解算(MPU6050 + 卡尔曼滤波)、深度测量(MS5837)、ESC 舵机驱动、视觉定位全部跑在单台机器人上
- 参考意义:从传感器采集到闭环控制是完整链路,水下 ROV 常见的几个难点它都覆盖了,比只做"循线小车"类项目能学到的东西多得多
仓库里到底有什么?拆解水下管道巡检机器人源码
仓库顶层很干净,真正的代码都在一个压缩包里:
- Keil_ROV 国赛初赛程序.7z —— 完整参赛工程,解开后是 STM32 Keil 工程、CubeMX 工程文件
Keil_ROV.ioc和 K210 视觉程序 - K210/(包内目录) ——
main.py加预训练好的yolov2.kmodel,负责水下目标的识别与定位 - Keil_ROV/(包内目录) —— STM32F411 固件,FreeRTOS 多任务调度,内含 PID、卡尔曼滤波、OLED 显示、ESC 驱动、串口 DMA 等模块
- README.md —— 项目说明与上手流程
- LICENSE —— MIT 协议
解压 7z 之后就是完整的双端源码,其余细节详见仓库 README。
核心技术架构:双 MCU 怎么分工
整体思路是"主控 + AI 协处理器":STM32F411 负责实时控制回路,K210 负责视觉识别,两颗芯片通过串口交换数据,各干各擅长的事。
- STM32F411 | 主控:姿态控制、传感器采集、电机输出、OLED 状态显示 | 带 FPU 的 Cortex-M4,跑 FreeRTOS 做多任务调度稳定省心
- K210 | 视觉:运行 YOLOv2 模型,做目标检测与定位 | 自带 KPU 硬件加速,低功耗、实时性好,水下弱光场景识别更从容
- MPU6050 / MS5837 | 姿态与深度数据源 | 一个给姿态角、一个给深度,是闭环控制的反馈输入
仓库内没有附带原理图,接线关系以 README 里的硬件说明为准,先读文档再动手不容易翻车。
从零到跑通:5 步上手指南
- 环境准备 —— 装好 Keil MDK(STM32 端)和 Kendryte KDK(K210 端)两套工具链。⚠️ 手头没有 K210 开发板的话,先把 STM32 端跑起来也不迟。
- 解压并导入工程 —— 用
7z x "Keil_ROV 国赛初赛程序.7z"解压,Keil 打开MDK-ARM/Keil_ROV.uvprojx;K210 端导入main.py即可。⚠️ 想改引脚或外设配置,建议通过Keil_ROV.ioc重新生成代码,别手改寄存器。 - 硬件对接 —— 按 README 的说明接好 MPU6050、MS5837、OLED、ESC 和 K210 摄像头。⚠️ 建议先单独上电确认各模块无短路,再整机电源上电。
- 编译与烧录 —— 两端分别编译、分别烧录:STM32 端走 Keil 下载,K210 端刷 KDK 生成的固件。⚠️ K210 首次烧录前确认板子的 bootloader 状态正常。
- 联调测试 —— 先在桌面验证双板串口通信和 OLED 数据输出,再下水做控制测试;遇到异常对照调试记录排查。
烧录前必须确认的 3 件事
-
芯片型号:固件按 STM32F411 配置,如果你手上是 F103 或其他型号,工程目标要调整,不能直接编译。
-
K210 模型文件:
yolov2.kmodel是参赛时用的现成模型,换数据集就需要自己重新训练导出。 -
传感器型号对得上:代码里写死了 MPU6050、MS5837 的驱动实现,先确认手头的传感器和驱动一致再通电。
-
协议方面一句话:仓库是 MIT License,学习、二次开发都没问题。
工程跑通之后,建议对照 Core/ 目录里的 FreeRTOS 任务划分和 PID、卡尔曼滤波的实现读一遍——双核之间数据怎么流转、姿态怎么稳住,这套源码最有价值的部分就藏在这里。
登录后查看全文