# RoboCup **Repository Path**: lrein/robo-cup ## Basic Information - **Project Name**: RoboCup - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-06-13 - **Last Updated**: 2026-09-09 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README #视觉通讯说明: 波特率:921600 (必须这么高,保证30Hz实时性) 格式:8数据位,1停止位,无校验 注意:TX接RX,RX接TX,必须共地(GND)。数据是小端序,STM32收到后直接内存拷贝,不用转换高低位! 单片机干的: 发送单字节(HEX)指令干活: 0x00:待机休眠(跑空载路段时发,省电) 0x01:去扫任务 1 二维码 0x02:去找地上的【彩色物块】 0x03:去扫任务 2 二维码 0x04:去找台子上的【白色奖杯】 0x05:去找地上的【同心圆靶心】 🌟 0x0A:【完成信号】当你机械臂抓完或放完东西,必须发这个收到后会自动切换找下一个颜色/字母 单片机收的: 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是为了防止和任务一冲突)。 可能可以用的接收例程: #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; } } } To do list: 1.视觉完成像素到米的解算; 2.dial_motor未加入; 3.进入任务2调节高度; 4.任务二放置逻辑修改; 5.调节路径; 6.调节高度; # 🚀 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 ``` ---