Horldsence/ESP32S3_vt
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
13 Commits 2 Branches 0 Tags
a30eb3200af7317dd92a5b88b709ba3e1d5ed356
Commit Graph
4 Commits
Author SHA1 Message Date
Horldsence 4f7a142a39 desktop: 用户端与裁判端两套页面（Tauri v2 + React），删掉 Slint 客户端 
界面部分。后端在前一个提交里，这一提交把它接上，并删掉 client/。

用户端：
- 底部胶囊血条（宽度/数字/阈值/脉动可配），未接入时显示占位说明而不是 0；
- 瞄准器画在 canvas 上并与画面共用同一次变换计算——位置跟着缩放走、大小不跟，
  像真瞄具；偏移校准存的是画面比例而不是像素，换分辨率不会失效；
- 命中反馈：整屏闪红 + 抖动 + 准星旁的伤害数字。大号数字刻意不放画面正中：
  第一版放了，正好压住瞄准点。掉血事件由相邻两次读数之差派生（主板只报"现在多少血"）；
- 摄像头/装甲板下拉绑定、队伍号、镜像；改动要密码，退出/关闭也要。

裁判端：
- 两路等宽（flex: 1 1 0 + min-width: 0）各自独立缩放；
- 装甲板发现列表：id、地址、自报队伍、血量、四条齐不齐、静默多久、分到哪个槽位；
- 截图 PNG + ffmpeg 录 mp4，界面内回放（资源协议白名单外的目录给"用系统播放器打开"的退路）。

密码：Argon2id PHC，首启强制设置，会话内解锁一次。执行点在 Rust 侧命令里，界面上的
解锁对话框只是入口。故意不做 --camera-id 这类命令行覆盖：那是一条不用密码就能改绑的路。

其它：
- 配置换成 serde + toml，字段名统一 camelCase（磁盘=IPC=TS），仍然拒绝未知键名，
  原子写；旧客户端配置首次启动导入并备份成 .bak（只在默认路径下做）；
- 演示模式（CAM_DEMO=1）合成协议数据报喂进真实接收路径，没有板子也能把整条链路跑起来；
- 仅 dev 的浏览器预览（?preview=referee），两重门保证不进正式产物（已验证）；
- CSP 收紧成白名单，验证方式是"前端能不能连上后端"：clients 从 0 变成 1 同时证明
  JS 加载、IPC、WebSocket、React effect 四件事。

删掉 client/：它的功能全部被 desktop/ 覆盖，且其中有几处真 bug 在新实现里改掉了
（槽位分配会让两格显示同一块板子、帧率窗口基线、密码哈希截断被当成密码错、录制文件名
同秒互相覆盖）。注意 client/ 里那几处**未提交**的改动随之丢弃，历史里的版本还在。

测试：protocol 15、cam-core 69、src-tauri 30；前端 tsc + vite build 通过。
 2026-10-14 19:28:49 +08:00
Horldsence eafa112959 文档：写防作弊、缩放布局、槽位语义 
client/README.md 新增三节：

  防作弊  说明为什么必须在**接收端**挡而不是界面里隐藏——Hello 广播已经带着
          MAC 派生 id 和 IP，对手 tcpdump 一下就有，而数据本来也已收下解码。同时
          明确写出这一版挡不住什么：对手知道 IP 后可以自己发 Subscribe，固件会向
          任何订阅者推流。要真正封住得回固件加配对 token。

  缩放    image-fit 必须跟着 zoom 在 contain/fill 之间切，否则放大不会改变画面；
          缩回 1.0 要归位，否则下次放大从偏移开始像跳了一下。

  槽位    记下"按 id 顺序对号入座"这个做法错在哪，以及为什么会出现画面左右互换。

根 README 排查表加两条：两格宽窄不一的检查点，以及放大后画面没变清晰的原因。
 2026-10-05 21:45:24 +08:00
Horldsence 7b6593bb75 文档：按 UDP 多端架构重写根 README 与 client README 
三份文档此前还是 UDP 之前的内容（旧 HTTP 架构、单路、无身份概念），与实现不符。

根 README 是总入口：拓扑（两块板不区分队伍，"哪一边"由客户端决定）、实测性
能对比、发现协议、身份派生理由、构建烧录、硬件坑、排查表。

client README 覆盖：两种身份对应的两个组件、命令行、绑定流程与配置格式、三个
线程的分工、Slint 的硬约束（Image/Weak 不是 Send、ModelRc 没有 From<Vec<T>>、
基础元素不能挂 callback）。

写的时候逐条核对了代码，发现并修正了几处"我以为是这样"：

  - WIFI_AUTH 一直能用但从未进文档，.env.example 里也没有
  - 两端各有超时淘汰（原以为没有），值不同：固件 6 秒丢订阅者、客户端 60 秒
    才从界面列表移除。固件还有 MAX_PEERS=4 的上限，也补上了
  - 两处注释写死 app 分区在 0x40000，实际由 flash.sh 自动挑选
  - 实测数字重测：22 fps / 0 丢帧 / 平均帧 22 kB / 350 包每秒

也把两条踩过的坑写进去了，因为它们都属于"看起来是 A，实际是 B"：帧率必须按
计数除以墙钟（累计值除窗口值会报出单调上升的假数字，这个错误出现过两次），
以及探到链路异常先怀疑测量工具。
 2026-10-05 19:13:52 +08:00
Horldsence 4f893ce140 ESP32-S3 摄像头图传：固件 + Slint 客户端 + 共享协议 
两块 ESP32-S3-WROOM-1-N16R8 图传板（DVP 接口接 OV2640/OV3660/OV5640），
向队伍客户端与裁判终端推 UDP 图传。固件是跑在 ESP-IDF 上的 Rust，用官方
esp32-camera 组件采集；客户端是 Rust + Slint 桌面程序。

三个 crate 各自独立构建：
  .            firmware，交叉编译到 Xtensa
  protocol/    线路格式与帧重组，两端共用，无 ESP-IDF 依赖，有单元测试
  client/      Slint 桌面客户端

视频走 UDP 而非 TCP：实测传感器产出 22 fps，TCP MJPEG 只送出 1.9 fps，
且只占用链路能力的 1%——链路是空的，帧堵在队头阻塞后面等一个实时画面
等不起的重传计时器。改为独立数据报、不重传、缺片丢整帧后达到 20.8 fps。

发现是双向的：板子每 2 秒广播 Hello，客户端广播 Subscribe，板子据此定向
推流。板子身份由 MAC 派生，重启不变，所以客户端可以把绑定存进配置。

裁判端同时收两块板子（每个发送方一个重组器），队伍端绑定其中一块并只显示
自己那一边的血量。装甲板接口已预留（ArmorSource trait + ARMOR_PORT），
当前无数据源，界面显示占位符。

vendor 了 esp32-camera 2.1.7：组件注册表的版本求解器找不到它，且需要打一处
补丁（见 components/esp32-camera/target/esp32s3/ll_cam.c）。

.gitignore 三条 target/ 都锚定在根目录，因为 protocol/ 与 client/ 各自也是
独立 crate；而 components/esp32-camera/target/ 是上游的按芯片分目录，里面是
源码，必须保留。
 2026-10-05 18:22:19 +08:00