P05 · YBO Air Hub —— 供应商交付指南
- 产品入口：P05-switch.md
- Level-1 规格：P05-air-hub.md（需求以规格为准，本文只补充验收与报价范围）
- 设计附录：P05-air-hub-design.md
- 适用产品：Air Hub、Air Hub Pro 与 Air Hub Mini；与 Air 由同一代工范围报价，见 P05-air-guide.md
1. 用途与标记
章节标题：“1. 用途与标记”本文是 Air Hub、Air Hub Pro 与 Air Hub Mini 的 RFQ 包：与规格一起交给设计公司与代工厂，设计附录按需提供。标记含义、责任边界、工厂流程、设计关口与报价格式的公共条款见 Switch 公共条款，本文只列 Air Hub 特有条款。供应商按 §3 的 ID 逐项响应规格 §3，并注明所响应的组合（规格 §2.3）。
2. 责任边界（Air Hub 特有）
章节标题：“2. 责任边界（Air Hub 特有）”Air Hub Mini 没有 Linux：其固件/工具工作包是 ESP32-C5 的单一签名固件（含规格 GW-14 的任务隔离设计说明、分区表与内存预算）、EFR32MG24 模组的三种镜像与经 ESP32-C5 烧录的工具；下文凡写"Linux"之处，对 Air Hub Mini 指 ESP32-C5 的固件，核心板条款不适用。
在公共责任表之上：固件/工具工作包覆盖两个产品的固件链（Linux、ESP32-C5 与 EFR32MG24 模组的 BLE、Zigbee、Thread 三种镜像；Air Hub Pro 的 RFM310 模组无固件，由 Linux 经 SPI 配置）的源码、构建、签名、固件切换与升级工具，以及 Linux 与射频芯片之间的内部协议 ICD；两个产品交付 C5 配置通道协议（规格 GW-13），Air Hub Pro 另交付 433 MHz 链路规范：YBO 类的帧格式、密钥建立、加密与防重放，第三方码型的学习与发射（规格 GW-09）；主机软件以 Rust 实现，Zigbee 主机为自研时列为单独工作包；主控采用核心板时，核心板厂的 BSP、供货寿命、变更通知与二次来源责任写入合同；电子/射频工作包须交付共存测试报告：三个产品都有 EFR32MG24 模组与 ESP32-C5（双频 Wi-Fi，工作在 2.4 GHz 时与前者同频段）两个射频，Air Hub Pro 另加 433 MHz 链路；第三方 Linux 发行版、MQTT broker、Matter SDK、Zigbee / Thread 协议栈的授权、再分发限制与漏洞响应责任分别列明。
3. 需求追踪
章节标题：“3. 需求追踪”| ID | 性质 | 验收 |
|---|---|---|
| GW-01 | 必须 | V-01、V-03 |
| GW-02 | 目标 | V-02、V-05 |
| GW-03 | 必须 | V-09 |
| GW-04 | 必须 | V-05、V-07 |
| GW-05 | 目标 | V-07、V-08 |
| GW-06 | 必须 | V-01、V-07 |
| SYS-02 | 必须 | V-01、V-02 |
| SYS-03 | 必须 | V-03 |
| SEC-01…04 | 必须 | V-03 |
| SEC-05 | 必须 | V-03、V-09、V-10 |
| AIR-05 | 目标 | V-05 |
| GW-07 | 必须 | V-09、V-11 |
| GW-08 | 不使用（ID 保留） | — |
| GW-09 | 必须 | V-03、V-12 |
| GW-10 | 必须 | V-01、V-13 |
| GW-11 | 必须（当前没有适用的选定产品） | V-03、V-05、V-13 |
| GW-12 | 不使用（ID 保留） | — |
| GW-13 | 必须 | V-03、V-10 |
| GW-14 | 必须（Air Hub Mini） | V-03、V-05、V-13 |
| IF-01 | 必须 | V-01、V-07 |
| MFG-01 / MFG-02 | 必须 | V-10 |
| REG-01 | 必须 | V-15、V-16 |
| REG-02 | 必须 | V-15、V-16 |
| REG-03 | 必须 | V-07、V-15、V-16 |
| REG-04 | 必须 | V-16 |
| REG-05 | 必须 | V-07、V-16 |
| REG-06 | 必须 | V-08、V-16 |
4. 验证矩阵
章节标题：“4. 验证矩阵”| 测试 | 方法与样本 | 通过条件 | 需求 |
|---|---|---|---|
| V-01 系统与回读 | ≥3 台；Core 实机/冻结仿真器；断 Mate/互联网，丢 ACK/STATE，断 CAN，断电重启；Key 经 CAN 支路 | 本地控制正常；无重复执行、假成功或越权；新鲜状态恢复前保持未知 | GW-01、GW-06、SYS-02、IF-01 |
| V-02 容量 | 32 台注册、4 台在 100 ms 内操作；Core 负载固定并记录 | 正常及并发工况 ≥99.9 % 在 5 s 内确认；零重复/错误目标 | GW-02、SYS-02 |
| V-03 安全 | ≥3 台；≥1000 次/类重放、篡改、伪造 ID/回包；未授权配对、降级、撤销、管理越权、非法镜像；局域网侧未授权访问；Air Hub Mini 另做从 Wi-Fi、MQTT、Matter 与配置通道注入 CAN 帧的尝试，以及调试口与下载模式的访问 | 所有恶意请求拒绝且无对应 CAN 控制帧；Air Hub Mini 的调试口与下载模式不可用；合法操作不被异常流量无限饿死 | SEC-01…05、SYS-03、GW-01、GW-14 |
| V-05 链路与失联 | 满注册量 7 天运行；射频芯片卡死、Linux 重启、CAN BUS-OFF、服务口插拔、镜像版本不匹配 | 无失败制造执行成功或恢复旧指令；有界资源/重试和故障日志；升级中断时长在上限内 | GW-02/03/04、AIR-05 |
| V-07 供电 | ≥3 台；8/12/24/32 V；接收/发射、CAN 满载、以太网满载（Air Hub Pro）、USB 插拔、只接 5 V USB 时的欠压行为（Air Hub / Pro）、热稳态；按冻结的瞬态计划 | 正常范围功能/温升合格；功耗量级报告；无 USB 倒灌；保护与恢复符合判据；两个产品在 60 °C 环境下、Air Hub 另在 −20 °C 环境下满负荷运行 ≥4 h，器件温度留出余量 | GW-04/05/06、IF-01 |
| V-08 机械环境 | ≥3 套；IP、温度、湿热、连接器 | 达到目标 | GW-05 |
| V-09 更新与配置 | ≥3 台；≥100 个随机断电时刻覆盖配置/Linux、功能射频与 ESP32-C5 镜像写入及固件切换；错误型号、错误签名、版本不匹配 | 可恢复到完整受信版本；无半配置、丢配对、重复动作或安全回退 | SEC-05、GW-03 |
| V-10 量产与追溯 | 每台 EOL；≥30 台试产 | 记录完整、密钥唯一；失败隔离和返修复测闭环 | MFG-01/02 |
| V-11 固件切换（两个产品） | ≥3 台；BLE → Zigbee → Thread → BLE 循环 ≥50 次；错误型号/功能/签名镜像；切换中断电 | 只有签名且匹配的镜像被启用；失败回到原镜像；切回 BLE 后配对与绑定完整；非 BLE 镜像下 Air 控制被拒绝并提示 | GW-07 |
| V-12 433 MHz 链路（Air Hub Pro） | ≥3 台；YBO 类：录制重放、篡改、伪造 ID、帧计数回退、授权窗口外入网；第三方类：固定码/学习码学习、收发、未学习码、相邻频点干扰；两类同时启用 7 天；发射功率与占空比按区域核查 | YBO 类恶意帧全部拒绝且无对应控制，应答与回读完整；第三方类只触发已学习且允许的舒适性绑定，关键回路不可绑定，发射显示"已发送、未确认"；两类同时启用时持续接收（GW-04）不漏帧；区域限值满足 |
GW-09 |
| V-13 CAN 来源 | 每个产品 ≥3 台；500 kbit/s 满负荷收发 ≥1 h；BUS-OFF 与错误注入；以太网 / Wi-Fi 满负荷并发；Air Hub 与 Air Hub Pro 另做 ESP32-C5 复位与 OTA 期间 CAN 不受影响的确认；Air Hub Mini 另做 C5 看门狗复位与 OTA 期间的中断时长 | 零接收丢帧；BUS-OFF 有界恢复并记录；下发时延 p99 达到组合交付值；Air Hub Mini 的中断时长在声明上限内且期间显示未知 | GW-10、GW-11、GW-14 |
| V-14 | 不使用（ID 保留，不复用） | — | — |
| V-15 预合规 | 每个产品 ≥2 台，带最终外壳、线束与天线：辐射发射预扫（150 kHz–6 GHz，按 EN 55032 Class B 与 IEC 60945 两套限值，另看 156–165 MHz）、电源口传导发射（10 kHz–30 MHz）、静电（接触 ±8 kV、空气 ±15 kV）与快速瞬变预测、ISO 7637-2 等级 IV 与抛负载试验 A；无线传导功率、频谱与杂散，三个发射机同时工作 | 发射对限值留出余量（目标 ≥6 dB）；抗扰与瞬态期间无未授权 CAN 控制帧、试验后自恢复；不合格项整改后复测 | REG-01、REG-02、REG-03 |
| V-16 正式认证测试 | 认可实验室按冻结的测试计划对每个市场、每种无线配置测试，等级取规格 REG-02、REG-03、REG-06；RF-BM-MG24B2 与 RFM310-433S2 模组的证书范围未核实前做完整的无线测试；ESP32-C5 的 5 GHz 按 EN 301 893（含 DFS 客户端要求）；样机与量产一致；安全取 CB 报告与 NRTL 列名；网络安全按 EN 18031 评估 |
全部项目合格并取得报告；技术文件、符合性声明与标识齐备；变更后的重测判定有记录 | REG-01…06 |
5. 工厂测试（Air Hub 特有）
章节标题：“5. 工厂测试（Air Hub 特有）”每台 EOL 验证供电、CAN 实收实发、Wi-Fi 链路（Air Hub Pro 另验以太网）、按钮/灯、Linux、功能射频与 ESP32-C5 镜像版本/身份和调试保护；两个产品另验 BLE 控制/结果往返，Air Hub Pro 另验 433 MHz 收发（天线口传导测试，含 YBO 类加密帧往返与一组第三方码型）；CAN 实收实发按产品的 CAN 来源执行，Air Hub 同时验证 C5 镜像版本与通道认证。流程、记录字段、节拍与抽样规则见公共条款 §3。
6. 设计关口（Air Hub 特有）
章节标题：“6. 设计关口（Air Hub 特有）”D0 必须完成设计附录 §2.2 的硬门槛：规格 §2.3 的选定组合；RK3506G 核心板与 RK3506J 核心板的原厂资料、勘误、芯片温度等级、生命周期承诺与报价；Air Hub 在 128 MB 内存下的主机服务原型结果；CAN 来源 V-13 原型结果；Air Hub 的成本缺口收敛方案；温度偏差的热测试计划；9–36 V 输入级（TVS 截止电压与钳位、K7805-2000R3 降额）的整改方案（AIR-O-04）；固件链的升级与恢复方案；5 s 启动目标的验证（AIR-O-03）；Tag 接收方式（AIR-O-12）。D0 另须确认目标市场（AIR-O-14；芯片直贴与最严开发等级已定）并取得实验室的测试计划与报价；D1 前完成评估 §5的 A 类原理图整改，D2 前完成不带外壳的台架预测，D3 前通过 V-15 并取得 V-16 的报告。D1 冻结 433 MHz 链路规范（AIR-O-13）。D1 冻结 Linux 与射频芯片的内部接口、连接器与线束 ICD（AIR-O-04）。其余关口按公共条款 §4。
7. 报价格式与交付清单（Air Hub 特有）
章节标题：“7. 报价格式与交付清单（Air Hub 特有）”按公共条款 §5 的阶梯报价，Air Hub（RK3506G 核心板，128 MB + 256 MB NAND，按所报型号成行）、Air Hub Pro（RK3506J 核心板，256 MB + 256 MB NAND，按所报型号成行；两者共用底板）与 Air Hub Mini（无核心板）；ESP32-C5 在两个 Linux 产品上是 ESP32-C5-WROOM-1-N4，在 Air Hub Mini 上是 ESP32-C5-WROOM-1-N8R8（芯片版本 ≥ v0.2）；分别报价，底板元件以参考板与元件清单为起点，并对照规格 §2.1 的落地成本上限；供应商可另行建议组合但须写明对各轴条件的满足情况；N2K、PoE、315 MHz 版本只能作为独立选项。交付清单另含 Linux、EFR32MG24 模组（三种功能）与 ESP32-C5 镜像的发布镜像/哈希与版本兼容矩阵、Linux 与射频芯片内部协议 ICD、受控 USB 配置与固件切换工具。
8. 硬件交接包
章节标题：“8. 硬件交接包”交给接手的硬件工程师的材料是工作区 /srv/ybo/switch/（不在本仓库）里的产品目录，每个目录可以整体拷出，随附 README.md（板子、电路要点、已验证与未验证项）：air-hub-pro/ 是 Linux 底板（修订 D，ESP32-C5，104 × 97 mm，6 层，5 V 用 K7805-2000R3L 模块）与外壳外观模型，air-hub/ 是同一块底板的 Air Hub 贴装变体（只有原理图、BOM 与核价表，PCB 用 air-hub-pro/ 的），air-hub-mini/ 是 Air Hub Mini。各目录内容：
| 目录 | 内容 |
|---|---|
| 目录根 | KiCad 10 工程：原理图、PCB（只在 air-hub-pro/）、工程内封装库与 3D 模型（核心板焊盘图按厂家 DXF） |
export/ |
原理图 PDF 与 SVG、PCB 顶底渲染与透视图、分层 PDF、Gerber 与钻孔、贴片坐标、DRC 摘要、板子 STEP |
bom.csv、bom-cost.csv |
BOM（DNP 列标出不贴件）与按 LCSC 阶梯价的核价表 |
pinmaps/、diagrams/ |
核心板 128 脚到底板网络的对照（含 G 版差异）；功能框图与电源树 |
3d/、enclosure/ |
只在 air-hub-pro/：机顶盒式外壳外观模型（上壳、底板、天线、M8 插头的 STEP）、整机装配 STEP 与渲染图；是外观与空间研究，不是开模数据 |
datasheets/、docs/ |
所用器件的数据手册、核心板厂家资料；规格、设计附录、参考板页、本指南与认证评估 |
接手后的工作顺序（细节见参考板页 §7.3、§7.4、§8与认证评估 §4、§5）：
- 人工重新布板：差分线等长同层、降压高频输入电容贴引脚、射频 50 Ω 走线与屏蔽罩、换层回流过孔；保持按外壳外观模型定的板框、连接器、按键、指示灯与天线位置（参考板页 §7.3）。脚本生成的板子只用于上电与功能联调，不能用于预扫（规格
REG-02）。 - 向万象奥科确认核心板焊盘图：DXF 板框 37.9 mm 与手册 35 mm 的关系、钢网厚度、7 个改作 GPIO 的引脚（参考板页 §2.2）。
- 供电：M8 的 9–36 V 输入级把 TVS 换为截止电压不低于 36 V 的型号，并核对钳位对 LM74502 背靠背 MOS 管、K7805-2000R3 与 LMR36520 的余量；USB-C PD 取电台架验证充电器兼容性、两路切换与热插拔（
AIR-O-04）。 - 台架验证按数据手册取的电路：输入浪涌与抛负载、电源共模电感对 CAN 的影响、滤波衰减、两个射频模组的焊盘图（按规格书尺寸图画）与天线禁铜区、RFM310 到天线座的馈线与 RFPDK 配置、EFR32MG24 模组的引导入口脚。
- 向核心板厂确认 RK3506G 的 USB device 模式与温度等级，取得两块核心板报价；M8 面板插座定型号与孔号（家族接口决策为草案，
AIR-O-04）。 - 整改后按 V-15 预扫，再按 V-16 送认可实验室；认证等级见规格
REG-01…06，防点燃与船级社型式认可不在范围内。
9. 变更记录
章节标题：“9. 变更记录”| 日期 | 版本 | 变更 | 记录 |
|---|---|---|---|
| 2026-09-22 | R0.1 | 建立文件：从 P05-air-hub.md R0.3 §7 移出供应商交付条款，公共部分收入线级公共条款 |
任务 20260921-1700 |
| 2026-09-25 | R0.2 | 两个型号与工业级平台：责任边界改为两条固件链与核心板责任；新增 GW-07…09 追踪与 V-11、V-12；EOL、D0 关口与报价按型号和实现方式分开 | 任务 20260925-0942 |
| 2026-09-25 | R0.3 | 共用底板加 ESP32-C6 Wi-Fi 上行：三条固件链、双 2.4 GHz 共存报告、EOL 加 Wi-Fi 链路 | 任务 20260925-1017 |
| 2026-09-27 | R0.4 | 按组合报价与验证（规格 R0.7）：责任边界加 C6 的 CAN 通道与星型网协议；追踪加 GW-10…12；新增 V-13 CAN 来源与 V-14 星型网，V-07 加温度偏差组合的高低温运行，V-12 限于 LoRaWAN；EOL、D0 关口与报价按组合 |
任务 20260927-1640 |
| 2026-09-29 | R0.5 | 两个产品（规格 R0.9）：责任边界改为 Air Hub / Air Hub Pro 的固件链，加 GW-13 配置通道与 433 MHz 链路规范；GW-08、GW-12 与 V-14 撤销；V-12 改为 433 MHz 链路验证；EOL、D0 关口与报价按产品分开 |
任务 20260929-0011 |
| 2026-09-29 | R0.6 | Air Hub 加 EFR32MG21、去 433（规格 R1.0）：固件链与共存报告按两个产品都带 EFR32MG21 改写；V-11 适用两个产品，V-12 与 433 EOL 只适用 Air Hub Pro | 任务 20260929-0235 |
| 2026-10-06 | R0.7 | Air Hub 改用 SSD2351 核心板（规格 R1.1）：D0 硬门槛与报价行改为按核心板；报价以参考板元件清单为起点 | 任务 20261006-0315 |
| 2026-10-06 | R0.8 | 认证写成需求（规格 R1.2）：追踪加 REG-01…05；新增 V-15 预合规与 V-16 正式认证测试；设计关口加认证路径决定与预合规 |
任务 20261006-0822 |
| 2026-10-06 | R0.9 | 按最严认证等级开发（规格 R1.3）：追踪加 REG-06；V-15、V-16 的等级随 REG-02、REG-03 提高；认证路径已定为芯片直贴 |
任务 20261006-1156 |
| 2026-10-09 | R1.0 | 新增 Air Hub Mini（规格 R1.4）：责任边界加 ESP32-C6 单一固件工作包；追踪加 GW-14；V-03 加从网络侧注入 CAN 与调试口访问，V-13 加 C6 复位与 OTA 中断时长；报价加 Air Hub Mini 行 |
任务 20261009-1106 |
| 2026-10-12 | R1.1 | Air Hub 锁定 RK3506G 核心板、CAN 改为原生（规格 R1.6）：责任边界去掉 C6 的 CAN 通道；GW-11 没有适用产品；V-13、D0 硬门槛与报价行相应修改 |
任务 20261012-2303 |
| 2026-10-13 | R1.2 | 新增 §8 硬件交接包：交接目录内容与接手后的工作顺序；原 §8 变更记录改为 §9 | 任务 20261013-0200 |
| 2026-10-14 | R1.3 | 三个产品的 ESP32-C6 统一为 ESP32-C6-MINI-1-N4（规格 R1.7）：报价行相应修改；§8 注明交接包中 Air Hub Mini 的 WROOM-1 版材料已过时 | 任务 20261014-0022 |
| 2026-10-14 | R1.4 | 按当前原理图与 PCB 修订（规格 R1.8）：§8 更正交接包说明（Mini 部分已是 MINI-1 修订 B，R1.3 说它过时是错的）、目录与核对项按 2026-10-14 的交接包；D0 关口加 9–36 V 输入级的整改 | 任务 20261014-2350 |
| 2026-10-15 | R1.5 | §8 交接包说明更新为 2026-10-15 的刷新（原理图修正与重新布线，见参考板页 R1.1） | 任务 20261015-1500 |
| 2026-10-19 | R1.6 | 正文只写当前状态：去掉撤销日期与交接包刷新过程；工作顺序改引认证评估 §4、§5 | 任务 20261019-1200 |
| 2026-10-20 | R1.7 | 工作顺序的供电与连接器两项按双路供电（USB-C PD 优先、M8 9–36 V，规格 R1.12）改写 | 任务 20261020-1000 |
| 2026-10-21 | R1.8 | Air Hub Mini 不再有以太网（规格 R1.13）：V-03 的注入尝试只经 Wi-Fi、MQTT、Matter 与配置通道，工作顺序去掉 W5500 变压器接法 | 任务 20261020-1000 |
| 2026-10-23 | R1.9 | Air Hub Mini 主控改为 ESP32-C6-WROOM-1-N8（规格 R1.14）：§8 的封装与引脚表说明相应修改 | 任务 20261023-1850 |
| 2026-10-24 | R1.10 | Linux 底板修订 D 减件（规格 R1.18）：V-07 加只接 5 V USB 时的欠压行为，以太网满载只测 Air Hub Pro；EOL 去掉 CAN 唤醒（TCAN3413 无唤醒），以太网只验 Pro | 任务 20261024-2130 |
| 2026-10-24 | R1.11 | §8 硬件交接包改为工作区的产品目录（air-hub/、air-hub-pro/、air-hub-mini/），Linux 底板 104 × 90 mm 并带外壳外观模型 |
任务 20261024-2230 |
| 2026-10-24 | R1.12 | §8：外壳外观模型改为机顶盒式黑色方盒（上壳与底板） | 任务 20261024-2357 |
| 2026-10-28 | R1.13 | Wi-Fi 改用 ESP32-C5（规格 R1.22）：§2 固件链、配置通道与共存报告，V-09、V-13、EOL 与报价行的 C6 改为 C5；V-16 加 5 GHz 的 EN 301 893 与 DFS；报价行写明 C5-WROOM-1-N4 / N8R2 与芯片版本 | 任务 20261028-1709 |
| 2026-10-28 | R1.14 | Air Hub Mini 主控订货型号由 ESP32-C5-WROOM-1-N8R2 改为 N8R8（8 MB PSRAM，封装与引脚相同，模组估 $4.5） | 任务 20261028-1730 |
| 2026-10-28 | R1.15 | §8：Linux 底板换 ESP32-C5 后为 104 × 97 mm | 任务 20261028-1709 |