YBO 技术文档

主题

P11 · YBO Eye — 摄像头集成规范(Level 2) ​

1. 范围 ​

本附录是 Eye v1(M8–9,第三方 ONVIF 摄像头在 Hub 上的集成)的软件集成规范,以及 v1.5 AI 契约(M13–14,Hub NPU 上的人员检测)。它定义"认可"白名单摄像头必须提供什么、发现/开通流程、片段管线、NPU 模型契约以及白名单测试协议。所有代码运行在 Hub 服务 eyed / npu-worker 中(P03-hub-design.md §7);本附录不涉及任何 Eye 硬件。v2(自研摄像头)与 v3(靠泊/环视)除两个挂钩外均不在范围内:v2 摄像头必须通过 ONVIF Profile T 一致性认证,使 v1 软件可原样运行(P11-eye.md FR-14);摄像头端 AI 必须发出与 Hub 端检测相同的事件模式。精简的硬件说明仅出现在 §2(PoE 等级)与 §7(PoE 交换机配件)。阶段边界、FR 编号与所有引用数值均由 P11-eye.md 和 PRODUCT-PLAN.md §P11/§3 拥有。

2. 摄像头集成规范 ​

白名单("认可")摄像头的要求。ONVIF Profile T 功能集依官方 profile 页面 (ONVIF Profile T);Profile S 依 (ONVIF Profile S) ——最后一批一致性提交受理至 2027-03-31(已在该页面核实,升级了 P11-eye.md FR-02 中的"未核实"注记)。

#要求数值 / 约束理由
C-01ONVIF 一致性完整支持需 Profile T(H.264/H.265、成像、运动告警与篡改事件、元数据流);Profile S 仅接受用于实时查看(P11-eye.md FR-02)Profile S 于 2027-03-31 弃用;事件与元数据需要 T
C-02发现WS-Discovery 响应端(Probe match 与 Hello),上电后 ≤30 s 在 Hub UI 中列出 (t)(P11-eye.md FR-01)零配置调试
C-03媒体 profile≥2 个可独立配置的 profile(主码流 + 子码流),可经 ONVIF media service 设置主码流用于片段/实时查看,子码流用于 NPU
C-04PTZ排除——eyed 不使用、不测试、不配置船用固定安装;更小的攻击面/测试面
C-05事件经 ONVIF pull-point 订阅的运动与篡改事件;事件延迟按 §6 T-05片段触发源
C-06主码流上限H.264 ≤1920×1080、≤15 fps、≤4 Mbit/s CBR (t)USB 2.0 写入与片段大小预算(见下)
C-07子码流上限H.264 ≤640×360、≤5 fps、≤512 kbit/s (t)用于 NPU 输入的 A55 软件解码预算(§5)
C-08RTSP 传输RTSP 1.0,RTP 在 RTSP TCP 连接上交织传输 (RFC 2326 §10.12;已被 RFC 7826 取代,但摄像头实际出货的是 1.0)每摄像头一条 TCP 流;可承受交换机缓冲;无需 UDP 打洞
C-09快照经 media service 暴露 HTTPS/HTTP JPEG 快照 URI上传阶梯的 4G 档,无需 Hub 解码
C-10认证ONVIF 用户管理(WS-UsernameToken / HTTP digest);禁用匿名 RTSP;出厂默认密码必须可修改——Hub 在调试时拒绝默认密码(P11-eye.md FR-07)凭据卫生
C-11PoE 等级优先 802.3af Class 3,PD 端 ≤12.95 W;802.3at 仅在显式核对交换机预算后接受(§7)(P11-eye.md §5)60 W 交换机上的 4 摄像头预算
C-12隐私遮罩强烈建议支持经 ONVIF 配置的摄像头端隐私遮罩 (t);回退方案为按 §8 的 Hub 端遮罩避免 Hub 重编码(见 §10 D-03)
C-13厂商责任摄像头固件更新仍由厂商负责,在白名单中按型号注明(P11-eye.md §6)责任边界

吞吐核对 (t):i.MX93 仅有 USB 2.0(P03-hub.md §7、§15 第 1 项);假设大容量存储有效吞吐 ≥30 MB/s (t),在 Hub DVT 实测(P11-eye.md 待决事项 8)。4 台摄像头按 C-06 上限写入 4 × 4 Mbit/s = 2 MB/s——余量 ≥15×。真正的约束是 A55 软件解码(i.MX93 未列出硬件视频解码器,未核实——P11-eye.md §5):因此 eyed 从不解码主码流;片段以 H.264 重封装方式存储、不转码,只有子码流被解码(§5)。

3. 发现与开通流程 ​

摄像头是 LAN 设备,永远不是 YBO-CAN 节点(P11-eye.md §3)。按 X02 的能力术语,Hub 在其节点能力块中通告 eye 能力(X02-config-schema.md §8),列出摄像头注册表;Studio 配置中的 cameras[] 块(P11-eye.md §5)由 deployd 经标准的 schema → 语义 → 合理性校验管线验证并由 eyed 应用——它从不经 YBO-CAN 传输。

  1. 摄像头上电;eyed 匹配其 WS-Discovery Hello 或周期性 Probe,并在 ≤30 s 内于 Hub UI 中列为未认领(P11-eye.md FR-01)。
  2. 安装者认领摄像头。若出厂默认凭据仍然有效,则在设置新的按摄像头凭据之前调试被阻断;eyed 将其写入摄像头与 Hub 安全存储。凭据仅以 secret id 引用,绝不出现在 Studio 配置导出中(P11-eye.md FR-07)。
  3. eyed 枚举媒体 profile,将主、子 profile 配置到 §2 上限(若无法满足则拒绝该摄像头),并记录 profile token。
  4. eyed 打开 pull-point 事件订阅并运行 60 s (t) 自检:实时帧、快照获取、测试片段、事件往返。
  5. 注册表条目(id、名称、分区、endpoint URI、profile token、录像策略、遮罩/区域引用、触发链接)同步到 Studio 清单;Studio 的编辑经部署管线返回。
  6. 注册表健康:eyed 在 10 s (t) 无码流数据后将摄像头标记为 offline,按退避重试,并在 eye/<camera>/event 上发布 offline 事件(P11-eye.md §5)。

4. 片段管线 ​

[camera main RTSP] ──► pre-roll RAM ring (10 s/cam) ──► remux MP4 ──► USB SSD / eMMC quota
[camera sub RTSP] ──► A55 decode ──► npu-worker (v1.5) ─┐              │ retention ring,
[ONVIF pull-point events: motion / tamper] ─────────────┼► trigger ◄──┘ alarm clips pinned
[YBO-CAN ALARM via ybo-cand: bilge / trip] ─────────────┤   engine ──► eye/<camera>/event
[manual button: Hub UI / Mate] ─────────────────────────┘     │
                                              connmand link class (P03-hub.md FR-05/06)
                                Wi-Fi/Starlink: clip | 4G: snapshot | minimal: text
                                store-and-forward queue, upgrade on better link
阶段设计
前置/后置每摄像头一条主码流 RAM 环:前置 10 s + 后置 20 s(P11-eye.md FR-03);按 C-06 上限,前置环每摄像头占用 ≤5 MB (t)
触发摄像头运动/篡改事件(C-05);NPU 人员事件(§5);经 cameras[].trigger_links 映射、由 ybo-cand 接收的 YBO-CAN ALARM 帧(Sense 舱底、Core 跳闸);手动 UI/App 按钮(P11-eye.md FR-03)
编码无——H.264 重封装为 MP4 (t),不转码;带遮罩的摄像头遵循 §10 D-03
存储布局USB SSD(回退为 eMMC 配额 4 GB (t)):/clips/<camera-id>/<YYYY>/<MM>/<DD>/<utc-ts>_<trigger>.mp4 + .json sidecar(触发源、ts、置信度、事件 id)(t)
保留环形缓冲区按介质容量设定;最旧的未固定片段先删除;告警片段在 Hub 上固定 30 天(P11-eye.md FR-05);云端保留归 Mate 负责(P08-mate.md §6);存储压力下先裁剪片段再裁剪遥测,审计日志永不裁剪(P03-hub-design.md §7 故障表)
事件发布eye/<camera>/event,含类型(motion/person/tamper/offline)、ts、置信度、快照引用、片段引用(P11-eye.md §5),由 Mate 消费
上传阶梯按 connmand 的链路等级(PRODUCT-PLAN.md §3;P11-eye.md FR-06):Wi-Fi/Starlink → 完整片段;4G → JPEG 快照(C-09,无需 Hub 解码);最低链路 → 仅文本。未发送项进入存储转发队列,链路改善后升级
带宽上限分层级的 4G 上限 (t):Security 层级片段上传 ≤500 MB/月 (t),快照始终允许 (t)——数值由数据经济学决策拥有(P08-mate.md §10 第 4 项,OPEN-QUESTIONS P8-3);计量按 P08-mate.md §7 挂钩

5. NPU 模型契约(v1.5) ​

项目契约
输入解码后的子码流帧(C-07),letterbox 到 320×320 RGB888 (t);A55 解码,经 eIQ/Vela 在 Ethos-U65 上推理(P03-hub-design.md §7 npu-worker)
速率2 摄像头时每摄像头 ≥2 fps,或 4 摄像头时 ≥1 fps (t)(P11-eye.md FR-08);调度器在单一 NPU 队列上轮询各摄像头
延迟船上检测到告警 ≤5 s (t)(FR-08),预算拆分 (t):解码+预处理 ≤200 ms、推理 ≤100 ms、去抖 N = 3 个连续阳性帧 (t)、事件发布 ≤100 ms
精度在已标注的码头/锚泊数据集上,人员类精确率 ≥0.90、召回率 ≥0.85 (t);误报 ≤1/摄像头/24 h (t)(P11-eye.md §9、FR-12);AI 性能声明协议执行前不发布任何声明(P11-eye.md §6)
布防船在其母港地理围栏内(来自 gnssd)且无授权手机经 BLE 在场时布防;Mate 中的手动覆盖记入审计日志(P11-eye.md FR-09);检测区域与隐私遮罩在任何事件离开 Hub 之前应用(FR-10)
交付模型是 Hub A/B OTA 镜像内的签名工件(P11-eye.md FR-11);模型版本与 sbom_id 一并在 DIAG 中上报;回滚随上一镜像恢复上一模型——v1.5 无独立模型通道 (t)
反馈闭环Mate 中每条告警都带"误报"操作;标注、sidecar 元数据以及(经船主同意,§8)片段加入训练集;按摄像头的误报率在 Hub 上计算并发布在 Mate 告警历史中(FR-12)

6. 摄像头白名单测试协议 ​

在每个候选型号进入白名单前执行(M8 时 2–3 款认可 SKU,P11-eye.md 待决事项 4)。所有测试在演示船 LAN 上、经 §7 交换机进行。

  1. T-01 发现:10 次冷上电;每次均在 ≤30 s 内于 Hub UI 中列出(C-02)。
  2. T-02 Profile:主、子 profile 可经 ONVIF 配置到 C-06/C-07 上限;设置在摄像头重启后保持。
  3. T-03 码流稳定性:主 + 子码流并发 72 h;无 >2 s 间断 (t),摄像头无重启,eyed 内存平稳。
  4. T-04 重连:拔 LAN 线 60 s 与摄像头断电重启各 ×10;码流与事件订阅在 ≤60 s 内恢复 (t),无需人工干预。
  5. T-05 事件延迟:布置运动 → ONVIF 事件到达 Hub ≤2 s (t),×20。
  6. T-06 夜间/IR:在定义的夜间照度下限 (t) 下,于参考距离布置人员;下限定义先于任何入侵声明(P11-eye.md 待决事项 6)。
  7. T-07 功耗:IR 开/IR 关时实测 PD 功耗 ≤ 所声明的 PoE 等级;浪涌电流不使 §7 交换机端口跳断。
  8. T-08 认证:调试时拒绝默认凭据;拒绝匿名 RTSP;验证 digest 认证(C-10)。
  9. T-09 快照:并发推流下 JPEG URI 在 ≤2 s (t) 内响应(C-09)。
  10. T-10 共存:4 台设备(允许混合候选型号)并发推流;在保持 T-03 条件的同时,4 台均可抓取片段。
  11. T-11 隐私遮罩:经 ONVIF 配置摄像头端遮罩,并验证其在主码流、子码流与快照中均不透明(C-12);若不支持,该型号带 D-03 回退标记进入白名单。

7. PoE 配件集成 ​

对照 Level-1 候选进行预算核对(P11-eye.md §5;数字与 URL 以该处引用为准):Teltonika TSW101——60 W 总预算、30 W/口、9–30 V DC 输入;PLANET ISW-504PT——120 W 总预算、36 W/口、12–54 V DC 输入。

核对项TSW101ISW-504PT
4× C-11 摄像头(4 × 12.95 W = 51.8 W)通过(60 W 预算)通过(120 W 预算)
4× 802.3at 摄像头(4 × 25.5 W = 102 W)不通过——at 等级摄像头在此交换机上排除通过
9–32 V 计划窗口(P11-eye.md §5 配件行)缺口 30–32 V:输入规格止于 30 V;24 V 充电可超过 30 V缺口 9–12 V:输入规格起于 12 V;无法覆盖冷启动低压端

两个候选在纸面上均不能覆盖 9–32 V,因此鉴定挂钩是强制的:Eye v1(M8)时做 8–32 V 扫描、ISO 7637-2 脉冲与 EMC 预扫,期间无重启、无 PoE 掉电(P11-eye.md §9 配件行);候选冻结见 P11-eye.md 待决事项 9。eyed 将整台交换机失联(所有摄像头在 10 s (t) 内离线)作为一条带交换机提示的 offline 事件处理,而非四条告警 (t)。

8. 隐私与责任护栏 ​

  • 调试时对朝向码头的分区默认设置隐私遮罩;安装手册附标识指引;各国码头/租船规则在 v1.5 GA 前需法律顾问意见(P11-eye.md §6、待决事项 3)。
  • 被遮罩像素绝不离开 Hub(P11-eye.md FR-10)。优先的执行方式是摄像头端遮罩(C-12、T-11);Hub 端回退(D-03)遮罩快照与 NPU 帧,并在重编码不可行时阻断该摄像头的主码流片段上传 (t)。
  • 保留默认值:片段进环形缓冲,告警片段在 Hub 上固定 30 天(P11-eye.md FR-05);GDPR——船主为控制者,YBO 为云端片段的处理者,欧盟托管,按请求导出与删除(P11-eye.md §6);片段用于训练集为 opt-in,同意按船记录 (t)。
  • 每个告警界面均标注"辅助——非经认证的安防或安全系统"(P11-eye.md FR-13);不保证检出、不作值守声明、声明协议执行前不发布精确率/召回率(P11-eye.md §6)。
  • 摄像头 VLAN 与 WAN 隔离;无入站端口;远程实时查看仅经云中转的 mTLS 会话(P11-eye.md FR-07、§6)。

9. 验证 ​

测试方法通过标准
互操作矩阵(M8)在来自 ≥2 家厂商的 ≥3 款摄像头上执行 §6 协议 T-01…T-11全部通过;白名单发布(P11-eye.md §9)
4G 片段(M9)Cat-1 与 Cat-4 调制解调器样品,触发告警 20×,强制链路中断快照 ≤30 s (t),Cat-4 上完整片段 ≤5 min (t),中断期间无丢失(P11-eye.md §9)
检测指标(M13)已标注的码头/锚泊数据集,昼/夜/雨;基于事件的评分:检测事件若在去抖窗口内与已标注的人员区间重叠则计为真 (t)精确率 ≥0.90、召回率 ≥0.85 (t);误报 ≤1/摄像头/24 h (t)
NPU 吞吐(M13)Hub DVT 板上 2 路与 4 路子码流,同时录制片段满足 FR-08 速率且 A55 负载 ≤70 % (t);确认 §2 的 USB 写入余量
地理围栏布防(M14)演示船 10 次离港/到港切换后 ≤60 s 内布防/撤防 (t);覆盖操作记入审计日志(P11-eye.md §9)

10. 可桌面决定的事项 ​

决策建议 (t)理由冻结门槛
D-01 码流上限(C-06/C-07)主码流 1080p15 @ 4 Mbit/s;子码流 640×360 @ 5 fps带余量地满足 USB 2.0 与 A55 解码Hub DVT 吞吐实测(M8)
D-02 片段容器与布局MP4 重封装 + JSON sidecar,§4 的路径方案不转码;播放器兼容;sidecar 让元数据免受 schema 约束Eye v1 代码冻结(M8)
D-03 隐私遮罩位置白名单准入要求摄像头端遮罩;Hub 端回退仅限快照/子码流,无法遮罩处阻断上传A55 承担不起 1080p 的 Hub 重编码白名单发布(M8)
D-04 NPU 输入几何320×320 RGB888 letterbox常见检测器输入;对 Vela 友好模型选型(M13)
D-05 去抖 N 与延迟拆分N = 3 帧;§5 的预算拆分平衡 FR-08 延迟与 FR-12 误报预算检测测试(M13)
D-06 分层级 4G 片段上限Security 500 MB/月,快照不设上限数据经济学报价落地前的占位值OPEN-QUESTIONS P8-3(云 beta,M10)
D-07 eMMC 片段配额4 GB,先裁剪片段策略保护审计日志与遥测空间Hub DVT 存储测试(M8)
D-08 离线/交换机失联去抖每摄像头 10 s;整台交换机失联合并为一条事件避免电源抖动引发告警风暴Eye v1 实船试验(M9)

11. 变更记录 ​

日期变更参考
2026-08-31依据 P11-eye.md、P03-hub.md/P03-hub-design.md §7、P08-mate.md、PRODUCT-PLAN.md §P11/§3 的初版摄像头集成规范;已核实 ONVIF Profile S/T 页面与 RFC 2326PLAN-029

最后更新: