Skip to content
tianbotPublic

About

Product inspection tool, GUI edition. Runs per-product check profiles, interactive reports with PDF export

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

tb-verify

车辆出厂检测工具。通过图形界面连接车载上位机,按产品配置检查网络、系统、传感器和运动控制,并生成检测报告。

当前默认产品是 Tianracer T110 RDK,包含 19 项检测。检测清单和产品目标见产品说明。

后续方向已确定为 MyGo 桌面壳 + 独立检测运行时 + 产品插件,支持不同协议和流程的机器人,架构及 UI/UX 参考 mygo-music。见完整技术方案与 ADR-0006。目前只完成方案文档,新平台尚未实现;下文仍描述当前 Python 程序。

tb-verify 界面

开始使用

准备一台能通过 SSH 连接车辆的电脑,以及车辆的 SSH 地址和账号。运行检测需要车端具备相应产品配置所要求的 ROS 环境、设备和话题。

从源码运行图形界面:

python -m pip install -r requirements.txt
python app.py

已有的历史 Windows GUI 包见 GitHub Releases。当前版本尚未发布,构建和发布步骤见发布流程。

Python 命令行版已移除,请使用图形界面。

连接与检测

图形界面提供两种连接方式:

  • 无线:车辆已接入网络时,填写车辆 IP 和 SSH 账号。
  • 有线:通过 USB-C 连接车载上位机,固定地址为 192.168.128.10。程序尝试让车辆连接电脑所在的 Wi-Fi,获取无线 IP 后提示拔线,再通过无线连接开始检测。此过程可能在车端创建或更新持久 Wi-Fi 配置。

检测可选择由程序自动启停 ROS bringup,或使用车上已运行的 ROS 环境。自动模式会操作车端 ROS 进程;界面的「清理使用记录」会删除车端日志等文件,执行前需要确认。

运动安全

运动测试默认关闭。允许微动后,程序会执行短距离响应检测;完整运动测试包含微动、架空和落地阶段。落地航向互校会让车辆左右各转一圈,需要约 2.5 m × 2.5 m 的开阔平地。开始前确认人员和障碍物已离开测试区域,并准备好遥控器随时接管。

程序会要求确认安全条件,并在电压未知或低于安全阈值时默认跳过运动。运行中可请求停止;若车辆未停止或停车指令失败,应立即通过遥控器接管。

报告与判定

每次检测生成独立目录,通常包含:

test records/<车辆地址>_<时间戳>/
├── report.html           # 交互式报告,可导出 PDF
├── report.md             # Markdown 报告
├── raw.log               # 已记录的远程命令和输出
├── jspdf.umd.min.js      # 离线 PDF 依赖
└── html2canvas.min.js

源码运行时,test records/ 位于项目目录的上一级;打包运行时位于 exe 同目录。报告生成失败时,界面会显示错误。

检测项使用 PASS、WARN、FAIL、SKIP、PENDING 等状态。程序根据失败项、未验证项及中止情况给出自动判定;人工复核与自动判定分开展示,不能覆盖原始结果。HTML 报告支持确认告警和未验证项、填写人工检查,并导出 PDF。

当前有几项限制需要结合报告判断:

  • 未做落地航向互校时,程序可能仍显示「可交付,但需确认」。已确认的业务要求是未互校自动判不可交付,这一差距尚未修复;具体见航向互校决策。
  • 人工勾选状态保存在本机浏览器;操作记录刷新后丢失,不会自动随报告目录转移。
  • raw.log 不包含所有采集路径;例如电压可能来自未写入命令历史的 tap 文件。证据缺口见复核与证据方案。

产品配置

products/<产品id>/profile.yaml 定义产品、ROS 环境和检测项,baseline.yaml 定义判定阈值。新增产品可从 products/_template/ 开始,按车型填写配置;已有检测能力可以复用,新设备或检测能力可能需要修改代码。配置缺少必需字段或检测阶段顺序不合法时,加载会报错。

开发与验证

python -m pip install -r requirements.txt pytest
python -m pytest tests -q

无显示环境运行界面测试时设置 QT_QPA_PLATFORM=offscreen。测试使用替身,不代表实车验证。GUI 自检可运行 python app.py --self-check;打包产物仍需单独检查。

路径 内容
app.py 图形界面入口
ui/ / core/ 界面、连接、执行、判定和报告流程
checks/ / probes/ 检测项及车端探针
products/ / report/ 产品配置及报告模板
tests/ 自动化测试

更多信息:产品说明 · 架构与 ADR · 开发与验证 · 发布流程

About

Product inspection tool, GUI edition. Runs per-product check profiles, interactive reports with PDF export

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages