sloray
054379dc64
- fix(installer): 修复低完整性产物无法写入临时目录的问题，并在 CI 打包前后检查完整性标签 - fix(firmware): 从本次 Cargo ELF 打包并同步配套镜像，修正短目录说明与 LLVM 搜索顺序 - fix(installer): 修复中文完成页和页眉遮挡，侧栏使用等比缩放的原始 Logo - style(client): 应用图标增加圆角，统一“裁判系统客户端”命名 - fix(config): 安装提示改用可选本地热点配置，排除 Wi-Fi 凭据 - docs: 润色项目说明并统一裁判系统术语 - test(packaging): 补充 Windows 完整性和固件打包回归，覆盖外部输出目录、旧镜像与重复生成 验证：Windows NSIS 构建及原生页面预览；通用与本地安装配置编译；固件 release 构建、重复打包和客户端离线校验；6 项固件打包回归与 Windows 权限回归；git diff --check。未执行实机烧录。
3.2 KiB
3.2 KiB
图传故障排查
以下命令均在仓库根目录执行。
常见问题
| 现象 | 检查方法 |
|---|---|
提示缺少 esp-1.97.0.0 |
按上述命令安装指定名称的工具链，重新打开终端后检查版本 |
espup 查询 GitHub 版本返回 403 |
对上述固定版本安装命令追加 --skip-version-parse，或稍后重试 |
找不到 ldproxy / libclang |
安装链接工具；Unix 加载 export-esp.sh；Windows 使用 scripts/build.ps1，由脚本将 esp-clang 及其 DLL 依赖目录放到 PATH 前面 |
| ESP-IDF 路径或版本错误 | 清除旧 IDF_PATH 或指向 v5.5.5 SDK |
Windows 报 Too long output directory |
构建前设置 $env:CARGO_TARGET_DIR = 'C:\s3vt'，再运行 scripts/build.ps1 -Package；完整输出路径不得超过 88 字符，见固件入门 |
| Wi-Fi 连不上 | 核对 2.4 GHz、凭据和认证方式，再重新编译烧录 |
| 相机无输出 / 初始化失败 | 核对板型接线、供电与 Octal PSRAM |
NO-EOI、几帧后停止 |
确认 CONFIG_CAMERA_PSRAM_DMA=n |
| 在线但没有画面 | 检查客户端订阅、UDP 5600、防火墙及 AP 隔离 |
| 界面提示协议不匹配 | 板子与客户端的线路协议号不同；按提示重新烧录同版本的固件 |
| 开启 VPN / 虚拟网卡后设备在线但无画面 | 使用支持按已发现设备 IP 定向续订的客户端；仅发送 255.255.255.255 广播可能走错网卡 |
| 改 C 组件后无变化 | 清理 esp-idf-sys 构建缓存后重编，见开发说明 |
| 主机项目被编为 Xtensa | 显式指定宿主 target，见各子项目说明 |
libclang.dll 文件存在却报 LoadLibraryExW failed 时，还需检查它的依赖是否来自同一套 LLVM。仅将目录追加到 PATH 末尾不够；若前面已有其他 LLVM，可能加载到不兼容的同名 DLL。PowerShell 构建入口会将本项目工具链的 esp-clang 目录移到 PATH 前面。
用 python scripts/udp_probe.py 10 可独立检查视频协议；装甲板用 python scripts/armor_probe.py 15。这些脚本需要裁判系统在线，构建通过不代表已完成硬件验证。
测量帧率和丢帧时，运行以下命令，并将 IP 替换为裁判系统的实际地址。对照测试前先退出桌面客户端，避免额外订阅者增加无线负载：
python scripts/perf_probe.py 192.168.1.139 --seconds 30 --json perf.json
脚本定向续订，支持保留 VPN / TUN 的环境。输出包含完整帧率、帧损失率、接收间隔和组装耗时；这些时间不等于摄像头到屏幕的端到端延迟。
运动图传保持 CAM_GRAYSCALE=0，优先使用自动曝光上限和自动增益协同控制拖影。室内强制 −1 EV / 固定短快门在本机过暗，已撤回；提高增益上限也会增加噪点。需要限流时设 CAM_MAX_FPS=15，追求帧率时用 0；可启用有界 JPEG 压缩调节应对发送回压，分片间隔按网络实测选择。灰度效果仍保留硬件 JPEG，不是改为 RGB565 或降低 JPEG 采样位数。75°C 是主动减载阈值，温度来自 ESP 芯片内部，不能代表摄像头或环境温度，也不是芯片损坏温度规格。五分钟彩色对照与此前中止的灰度长测见 持续运行记录。