水下机器人项目代码与相关资料。
本仓库放水下的机器资料,技术报告,机械3d文件等。
- 26.11.3 上传地面站软件安装包和机器手册
- 26.11.4 上传道具建模文件
- 26.11.10 上传地面站配置教程视频
- 26.11.11 上传水上机器人技术报告通用模板
- 26.11.16 上传QGC地面站源码摘要
本工程为 A-Zealous 沿用所提供电赛模板的 ctexart、XeLaTeX 和基础宏包,和之前RST水下写的报告的内容排版,改成的水下机器人报告的摘要与双栏版式。学校名称保留,队名使用“某某队”。正文保留任务设计范例,不表示所有水下机器人比赛均采用这些规则。形成了比较通用化的一个水下类比赛都能用的LaTex模板
范本链接:https://github.com/SHMTU-EEHUB/Template-for-Electrical-Competition-Report
main.tex:编译入口,包含字体、页面设置、题名和中英文摘要。src/content.tex:正文、表格、公式与参考文献。pic/:7 幅报告插图。LICENSE:原电赛模板的 MIT 许可,保留原版权声明。
在工程根目录执行两次 xelatex -interaction=nonstopmode -halt-on-error main.tex,或使用 latexmk -xelatex main.tex。使用 TeX Live / MiKTeX 时应安装 ctex、fontspec、multicol、caption 等宏包。不要使用 pdfLaTeX。
优先使用原电赛模板的 Source Han Serif SC 与 Source Han Sans SC。未安装时自动使用 Fandol 中文字体;西文字体优先 Times New Roman,否则使用 TeX Gyre Termes。不同字体可能导致少量分页差异。
- 在
main.tex中替换队名、中英文题名和摘要;需要署名时填写“队员1、队员2”等实际信息。 - 在
src/content.tex中替换本队设计、试验记录和结论。20 kg、10 min、任务 A/B/C、道具尺寸、角度和分值均是保留的示例条件,须按目标比赛逐项核对。 - 参考文献 [1] 是规则占位项,正式使用时换成实际规则及版本。文献 [2]、[3] 为去除个人姓名后的题名式著录,题名和出版信息可用于查找原文。
- 插图中的结构与道具对应本范例;更换机器人或任务时,应同步替换插图、图题和正文。保留真实来源,不把基础平台或规则图当作本队原创成果。
- 完成修改后重新编译,检查图表、公式、分页和参考文献。没有实测数据时,不填写未经验证的成功率或性能结论。
保留工程中的 LICENSE。原模板的版权署名属于许可信息,不属于报告中的参赛身份。
zjm54321 和 SandOcean-ovo 开源的电赛报告范本。
作者:A-Zealous
供队友研究、配置交接和轻量分享的源码选读。按原路径保留代表实现,集中展示:
手柄 → QGC 映射 → MAVLink 通信 → ArduSub 控制/混控 → 电调与推进器
视频接收单列;常用连接设置、参数说明和队伍记录模板集中归档。
| 分类 | 研究重点 |
|---|---|
| 01_手柄与操控 | 手柄采集、校准、轴和按钮映射 |
| 02_通信与参数读写 | 串口/UDP/TCP、MAVLink、参数同步、电机测试指令 |
| 03_机器人配置与控制 | 布局/方向设置、ArduSub 控制模式、推进器混控 |
| 04_视频与图传 | 视频源、GStreamer 接收、显示和录像 |
| 05_配置速查 | 默认设置、参数 XML、USB 接口规则、队伍记录模板 |
先顺着 01 → 02 → 03 看操控链,再查 05 整理队伍配置;图传问题看 04。源码摘录供定点阅读;构建与全依赖研究可按清单中的上游仓库和版本定位完整工程。各分类摘要已原文拼接在下方,便于一份文档通读。 至于获取完整代码,请到官方仓库下载↓↓
- 地面站:QGroundControl v3.5.6。
- 机器人:ArduPilot / ArduSub-3.5.4。
- 精选文件、版本与 SHA256 见
来源与清单.json;体积与完整性结果见校验结果.json。 - 源文件保留上游版权及许可证;配置采用通用待填模板,适合公开分享。
用途:读取手柄、校准轴范围、处理回中与反向,将轴和按钮转换为操控量。
源码入口(相对本目录 QGC/):
src/Joystick/JoystickSDL.cc:SDL 手柄采集。src/Joystick/Joystick.cc:轴归一化、油门模式、按钮位图;发出 manualControl 信号。src/VehicleSetup/JoystickConfig.qml与 Controller:校准、轴映射和按钮配置界面。
配置要点:换手柄后检查轴号、正反向、回中和油门模式。按设备校准结果填写 Roll/Pitch/Yaw/Throttle 轴号及反向标记。操控信号随后进入 02 的 UAS 发送链路;按钮功能与 03 的机器人参数一起核对。
用途:管理连接、收发 MAVLink、维护车辆状态并同步参数。
源码入口(QGC/):
src/comm/LinkManager.cc:链路管理;SerialLink / UDPLink / TCPLink:传输实现。src/comm/MAVLinkProtocol.cc:MAVLink 消息接收和协议处理。src/uas/UAS.cc的 setExternalControlSetpoint:将手柄输入打包为 MANUAL_CONTROL,经 priorityLink 发送。src/FactSystem/ParameterManager.cc:参数下载、更新和保存流程;Fact 表示参数值及元数据。src/Vehicle/Vehicle.cc:车辆状态与指令;motorTest 发送 MAV_CMD_DO_MOTOR_TEST。
配置要点:UDP 内置默认端口 14550;地面站系统 ID 按目标通信网络统一规划。按实际网络填写 IP、端口、转发关系;使用串口时另核对 COM 口和波特率。参数修改后读回核对,涉及重启的项目按元数据提示处理。连接设置定义集中在 05。
用途:把地面站的参数/电机配置界面,与机器人端的输入处理、控制模式、推进器混控对应起来。
QGC 源码入口(QGC/):
src/FirmwarePlugin/APM/ArduSubFirmwarePlugin.*:ArduSub 模式及功能适配;APMParameterMetaData 解析参数说明。src/AutoPilotPlugins/APM/APMSubFrameComponent.qml:选择推进器布局。APMSubMotorComponent.qml:电机测试、方向设置;连接 02 的 Vehicle::motorTest。- 同目录 Safety/Tuning/Lights/CameraSub/Sensors 相关文件:失效保护、调参、灯光、相机和传感器配置。
机器人端源码入口(ArduSub/ 下保留项目原路径):
ArduSub/joystick.cpp:解释 MANUAL_CONTROL 的轴和按钮。ArduSub/GCS_Mavlink.cpp:接收通信消息与指令。ArduSub/control_*.cpp、motors.cpp:手动/稳姿/定深控制及电机输出衔接。libraries/AP_Motors/AP_Motors6DOF.*:按布局将运动控制量混合成各推进器输出。- Parameters、Sub.h、failsafe 相关文件:参数定义、模块组织和安全逻辑。
配置要点:将 FRAME_CONFIG、MOT_n_DIRECTION、SERVOx_* 与实机电机编号/接线表一一对应;再核对手柄按钮、深度基准和失联保护。先保存参数备份,修改后读回确认;推进器测试按设备安全要求在受控环境进行。
版本:QGC v3.5.6;机器人选读采用官方 ArduSub-3.5.4(2019-04-01),固定提交 05fed49b8ee1db3c6bca924e0b334b2e0ece980d。按队伍实际固件版本对照使用。详细文件来源与哈希见清单。
用途:接收机器人视频流,建立 GStreamer 管线,显示画面并处理录像。
源码入口(QGC/):
src/FlightDisplay/VideoManager.cc:视频源与接收器管理。src/VideoStreaming/VideoReceiver.cc:接收、解码与录像流程。src/VideoStreaming/VideoSurface.*:画面显示衔接。src/Settings/VideoSettings.cc:视频设置;对应 JSON 在 05。
配置要点:UDP 视频内置默认端口 5600;还可研究 RTSP/TCP 地址设置。队伍记录应包含发送端地址、编码/封装、接收端口与录像目录。视频与操控遥测分开排查:先确认网络可达,再检查流格式、端口及解码链路。
文件用途:
队伍配置记录.example.json:汇总连接、视频、手柄和机器人配置,填写后便于队友交接。QGC/src/Settings/AutoConnect.SettingsGroup.json:自动连接项目及默认值。QGC/src/Settings/Video.SettingsGroup.json:视频源、端口、RTSP/TCP、录像设置。QGC/src/comm/USBBoardInfo.json:USB 板卡识别信息。QGC/src/FirmwarePlugin/APM/APMParameterFactMetaData.Sub.3.5.xml:ArduSub 3.5 参数说明、单位、范围和枚举。USB接口/*.inf:PX4FMU / ChibiOS 的 Windows USB 串口匹配与服务配置,可查看 VID/PID 和端口绑定规则。
参数检索顺序:
| 项目 | 重点参数 |
|---|---|
| 推进器布局与方向 | FRAME_CONFIG、MOT_n_DIRECTION |
| 输出通道与范围 | SERVOx_FUNCTION、SERVOx_MIN/MAX/TRIM、MOT_PWM_* |
| 手柄与按钮 | BTNn_FUNCTION、BTNn_SFUNCTION、JS_GAIN_* |
| 失联保护 | FS_GCS_ENABLE、FS_PILOT_INPUT、FS_PILOT_TIMEOUT |
| 深度与传感器 | SURFACE_DEPTH、压力/IMU/电池相关参数 |
配置要点:先记录飞控型号、固件版本、推进器接线,再选择对应参数解释。把实机参数导出、按钮表和电机编号一起维护;默认端口用于初始核对,最终以队伍记录为准。示例中的待填项按目标设备和网络填写。