# Robocup **Repository Path**: sqkert/robocup ## Basic Information - **Project Name**: Robocup - **Description**: Robocup物流组视觉 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-06-26 - **Last Updated**: 2026-08-16 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README 这是一份为你量身定制的**《视觉-电控联合开发与通信最终版白皮书》**。 这套协议已经包含了我们最新加入的**“具体颜色/字母密码”**、**“全画幅畸变矫正”**以及**“二维码结果透传”**。 你只需要**直接把下面的内容全部复制,发给负责写 STM32 / 底盘控制的同学**。他看完绝对会对你顶礼膜拜,因为所有的脏活累活和防踩坑设计,你都已经帮他在视觉端做完了。 --- # 🤖 2026 RoboCup 视觉-电控联调终极指南 兄弟,视觉这边的框架已经全部竣工。为了咱们的车能丝滑跑满全场,请仔细阅读以下协议,STM32 端直接照抄即可。 ## 一、 系统架构:你是“大脑”,我是“眼睛” 1. **控制权在你:** 视觉程序绝不会自己乱动。**视觉现在的模式完全由你(STM32)通过串口发指令来切换。** 你让我找什么,我就找什么。 2. **伴随式发送:** 一旦你命令我开始找东西,只要我看到了,我就会以 **30Hz** 的超高频率给你发坐标和它的身份码,你直接拿去丢进 PID 控制车轮就行。 ## 二、 物理连接与底层约定 * **串口波特率:** 强制统一为 **`921600`**(因为 30Hz 发浮点数,低波特率必卡顿)。 * **连线:** TX-RX,RX-TX,**必须共地 (GND)**。 * **字节序:** 小端序 (Little-Endian)。*STM32 也是小端序,所以你收到我的 `float` 数据不需要做任何高低位转换,直接内存强制转换就能用!* --- ## 三、 你发给我的指令 (STM32 -> Jetson) 随时随地,你只要向我发送 **1 个字节 (HEX)**,就能强制接管视觉状态: | 你发送的 1Byte (HEX) | 视觉进入的模式 | 场景说明 | | :--- | :--- | :--- | | **`0x00`** | 休眠待机 | 车在跑长途或没任务时发给我,我把算法全停了,省 CPU 算力。 | | **`0x01`** | 扫任务 1 二维码 | 车开到左侧扫码区停稳后,发这个给我。 | | **`0x02`** | 找彩色物块 | 扫完码开到场地上,发这个给我,我开始给你回传颜色坐标。 | | **`0x03`** | 扫任务 2 二维码 | 车开到右侧扫码区停稳后,发这个给我。 | | **`0x04`** | 找白色奖杯+看字母 | 去抓奖杯时发这个给我,我用 OCR 读字母并回传坐标。 | | **`0x05`** | 找同心圆靶心 | 抓到东西准备放下时发给我,我帮你找地毯上的靶心。 | | 👉 **`0x0A`** | **抓取/放置完成** | **【极其重要】当你机械臂抓完或放完一个东西,发这个给我,视觉会自动把目标切换成清单里的下一个!** | --- ## 四、 我发给你的数据包 (Jetson -> STM32) 我会发给你两种数据包,它们都是 **22 字节固定长度**,帧头都是 `0xA5` `0x14`。区别在于 `Cmd_ID`。 ### 1. 目标坐标包(最常用,30Hz疯狂发送) * **Cmd_ID:** `0x0200` * **数据包结构:** `[0xA5] [0x14] [0x00 0x02] [身份Flags(2字节)] [CX(float)] [CY(float)] [W(float)] [H(float)]` * 🔥 **身份 Flags 字典(极其重要,决定你要抬多高):** * **彩色物料:** `11`=黑, `12`=白, `13`=红, `14`=绿, `15`=蓝 *(你收到几,就知道正在抓什么颜色,可在OLED上显示)* * **颁奖台奖杯:** `21`=奖杯A, `22`=奖杯B, `23`=奖杯C *(你收到 21 机械臂就抬 36mm,收到 22 抬 18mm,收到 23 贴地放)* * **同心圆靶心:** `30`=靶心 ### 2. 事件通知包(仅在扫码成功瞬间发 1 次) * **Cmd_ID:** `0x0201` * **功能:** 告诉我扫到了什么码,方便你点亮屏幕或者发车。 * **身份 Flags 定义:** * **1 ~ 16**:代表任务一扫码成功,并且扫到的数字是 1-16。 * **101 ~ 106**:代表任务二扫码成功,扫到的数字是 1-6。(加100是为了防止和任务一冲突)。 ### 🛠️ C 语言极速解析代码(直接复制进 STM32 即可): ```c #pragma pack(push, 1) typedef struct { uint8_t header; // 0xA5 uint8_t length; // 0x14 uint16_t cmd_id; // 0x0200(坐标) 或 0x0201(扫码事件) uint16_t flags; // 身份码 (11~15, 21~23, 30 或 扫到的数字) float cx; // X中心坐标 float cy; // Y中心坐标 float width; // 宽度 float height; // 高度 } VisionPacket; #pragma pack(pop) void process_uart_data(uint8_t* rx_buf) { if(rx_buf[0] == 0xA5 && rx_buf[1] == 0x14) { VisionPacket* vp = (VisionPacket*)rx_buf; if(vp->cmd_id == 0x0201) { // 扫码成功!可以控制底盘发车去场地了 int qr_num = vp->flags; } else if(vp->cmd_id == 0x0200) { // 收到坐标!用 cx, cy 控制电机 PID! int current_target = vp->flags; } } } ``` --- ## 五、 底盘 PID 控制指南(必读) 你拿到的 `cx` 和 `cy` 是非常完美的。**我已经做了相机内参的“全画幅畸变矫正”**,画面边缘没有任何鱼眼拉伸,所见即所得。 * **画面分辨率是 640 x 480。** * **左右转向 (控制 X 轴):** * 绝对中心点是 **`320.0`**。 * 你的 `Error_X = cx - 320.0`。 * 如果 cx=500,Error 为正,说明东西在画面右边,请控制车头向右。 * **前后刹车 (控制 Y 轴):** * Y 轴是**向下的(数值越大越靠近车底盘)**。 * 最上面是 0,最下面是 480。 * 你可以设定一个死区(例如 `cy > 400.0`),一旦 cy 超过 400,说明东西已经被吸到机械爪正下方了,立刻刹车并触发夹取动作!夹完记得给我发个 `0x0A`。 --- 把这份文档发给电控,他就能马上开始写解析结构体和 PID 寻迹逻辑了。你们的系统接口现在已经严丝合缝了! # 🚀 RoboCup 视觉系统开机自启配置与管理指南 本文档记录了基于 Ubuntu (Jetson) `systemd` 守护进程的视觉系统自启动配置方法,以及日常开发中如何随时开启、关闭、重启该服务。 --- ## ⛔ 核心警告:手动调试前必须停止后台服务! 如果你设置了开机自启,系统在后台会一直占用你的 USB 摄像头。 此时如果你打开终端,手动输入 `python3 core_framework.py`,**必定会报错“摄像头打不开”或“设备被占用 (Device or resource busy)”**。 **所以,在你要进行手动代码测试前,必须先【暂时停止】后台的自启服务!** --- ## 🎮 一、 常用管理命令速查表 (Cheatsheet) 在 Jetson 的终端中运行以下命令进行管理(需要输入开机密码): ### 1. 关闭与停止 (你最需要的功能) * **【临时停止】当前运行的视觉程序**(重启电脑后依然会自动启动): ```bash sudo systemctl stop robocup_vision.service ``` * **【永久关闭】开机自启动**(以后开机再也不会自动跑了): ```bash sudo systemctl disable robocup_vision.service ``` ### 2. 开启与重启 * **【热更新/重启】**(当你修改了 Python 代码并保存后,执行此命令立刻生效): ```bash sudo systemctl restart robocup_vision.service ``` * **【恢复开机自启】**(比赛前准备上场,重新让它开机自动跑): ```bash sudo systemctl enable robocup_vision.service sudo systemctl start robocup_vision.service ``` ### 3. 查看状态与报错日志 * **【查看运行状态】**(看看是绿色的 running 还是红色的 failed): ```bash sudo systemctl status robocup_vision.service ``` * **【查看后台 Print 日志】**(实时滚动查看程序的打印信息和报错,按 `Ctrl+C` 退出): ```bash journalctl -u robocup_vision.service -n 50 -f ``` --- ## 🛠️ 二、 首次配置/重新部署指南 如果你重装了 Jetson 系统,或者换了一台新机器,请按以下两步重新配置: ### 第一步:创建启动脚本 1. 在项目文件夹下新建脚本:`nano /home/nvidia/Desktop/Robocup/start_vision.sh` 2. 写入以下内容(注意确认你的真实用户名是否为 `nvidia`,以及路径是否正确): ```bash #!/bin/bash # 等待硬件加载 sleep 10 # 强制进入工作目录 cd /home/nvidia/Desktop/Robocup/ # 执行程序 /usr/bin/python3 core_framework.py ``` 3. 赋予执行权限:`chmod +x /home/nvidia/Desktop/Robocup/start_vision.sh` ### 第二步:创建 Systemd 服务文件 1. 创建服务文件:`sudo nano /etc/systemd/system/robocup_vision.service` 2. 写入以下内容(注意修改 `User` 和 `ExecStart` 路径): ```ini [Unit] Description=RoboCup Vision System Auto Start After=network.target [Service] Type=simple User=nvidia ExecStart=/home/nvidia/Desktop/Robocup/start_vision.sh Restart=always RestartSec=5 StandardOutput=syslog StandardError=syslog [Install] WantedBy=multi-user.target ``` 3. 刷新系统并设置开机自启: ```bash sudo systemctl daemon-reload sudo systemctl enable robocup_vision.service sudo systemctl start robocup_vision.service ``` --- ## ❓ 三、 常见问题 (FAQ) **Q1: 我修改了 `core_framework.py` 里面的代码,需要重新配置自启动吗?** > **不需要。** 只要你不改变 `core_framework.py` 这个文件的名字,也不移动它的文件夹,每次开机系统都会自动读取你保存的最新代码。 **Q2: 我把 `Robocup` 文件夹改名成了 `Robocup2026`,为什么自启失效了?** > 因为启动脚本找不到旧路径了。你需要做: > 1. 修改 `start_vision.sh` 里的 `cd` 路径。 > 2. 修改 `robocup_vision.service` 里的 `ExecStart` 路径。 > 3. 运行 `sudo systemctl daemon-reload` 刷新配置。 > 4. 运行 `sudo systemctl restart robocup_vision.service` 重启服务。