P05 · YBO Switch —— 无线 Air 与有线 Key 开关，及两者共用的中枢 Air Hub
- 治理摘要：PRODUCT-PLAN §P5
- 总交付要求：P05-switch-guide.md（三份产品指南的公共条款）
- 引用的基础文件：X01 YBO-CAN 协议、X02 配置模式
- 适用产品：Air、Key、Air Hub
Air、Key 与 Air Hub 同属产品线 P05；P06 编号不使用。
1. 定位
章节标题：“1. 定位”Switch 是船上和船外的墙面控制面板产品线。同一件事有两种形态：不便布线的位置用无线的 Air，可以布线的固定位置用有线的 Key（首期为外接按键控制盒 Key Box 36，Key 面板延后）；两者共用一个中枢 Air Hub——Air 经 BLE 接入，Key 经 YBO CAN 支路接入。三者合为一条线的依据是同一个控制面：同一份 X01 / X02 基线、同一套 SYS-0n 系统要求、同一条“只有真实回读才算成功”的准则。
型号：Air 2 / Air 4、Key Box 36（外接 36 个船用按键的控制盒，对 YBO CAN 是一个节点）、Air Hub、Air Hub Pro 与 Air Hub Mini（三者都用 EFR32MG24 模组连接 Air，BLE / Zigbee / Thread 按固件切换；Air Hub 为 RK3506G 邮票孔核心板（128 MB + 256 MB NAND，原生 CAN），Air Hub Pro 为 RK3506J 邮票孔核心板（256 MB + 256 MB NAND），另有加密的 433 MHz 链路并兼容第三方 433 设备，两者用 ESP32-C5 作双频 Wi-Fi 与配置；Air Hub Mini 以 ESP32-C5 作唯一控制器，不运行 Linux）。Key 4 / Key 8 面板及其 I2C / CAN 扩展单元尚未设计，延后（2026-10-29），需求保留在 Key 规格中作为后续设计输入。
| 产品 | 规格 | 层级 | 供电 | 控制路径 | 建议零售价 (t) | 合规路径 | 里程碑 |
|---|---|---|---|---|---|---|---|
| Key Box 36（外接按键控制盒） | key/P05-key.md §2.1 | T0 | 船上 12/24 V，连续 9–32 V；电源与 YBO CAN 经 1 号 AMPSEAL 35 线束 | 船内外部按键 → Key Box 36 → CAN → Core；船外 → CAN → Air Hub | 待定 | 同 Key：RED 及网络安全、CRA、RoHS、WEEE、GPSR；NMEA 2000 插座首版只预留，不认证 | 沿用 Key 的 T0 排期：EVT M4–5；DVT M8–9；PVT M12 |
| Air（无线开关） | air/P05-air.md | T1 | 1×可更换 CR2450 纽扣锂电池 | Air → Air Hub → CAN → Core | $59 | RED 及网络安全、CRA、欧盟电池法规（COMPLIANCE-MATRIX 无线行） | EVT M6–7；DVT/PVT M13–14 |
| Air Hub Mini（共用中枢，最小配置） | air-hub/P05-air-hub.md | T1 | 同 Air Hub | Air（BLE）与 Key（CAN）→ Air Hub Mini → Core；不作本地 broker、Matter 控制器与船外宿主 | $49 | 同 Air Hub | 随 Air 首发 |
| Air Hub Pro（共用中枢，高配） | air-hub/P05-air-hub.md | T1 | 同 Air Hub | 同 Air Hub，另有 433 MHz 设备 | $119 | 同 Air Hub，另含 433 MHz 发射机 | 在 Air Hub Mini 之后 |
| Air Hub（共用中枢，后续选项） | air-hub/P05-air-hub.md | T1 | 船上 12/24 V，常供电不休眠 | Air（BLE）与 Key（CAN）→ Air Hub → Core 或第三方执行器；可切换为 Zigbee 协调器或 Thread RCP | $59 | 同 Air 的无线行 | 后续选项，排在 Air Hub Pro 之后，不排里程碑 |
| Key 4 / Key 8（有线面板，延后） | key/P05-key.md | — | 船上 12/24 V，四功能线（V+、GND、CAN-H、CAN-L） | 船内 Key → CAN → Core；船外 Key → CAN → Air Hub | 延后后重新定价（原 $149） | 同 Key Box 36 | 未设计，不在首期排期 |
产品顺序（2026-10-29）：表中自上而下即开发与发布顺序——Key Box 36（T0）→ Air → Air Hub Mini（随 Air 首发的中枢）→ Air Hub Pro；标准版 Air Hub 为后续选项，Key 4 / Key 8 面板延后。只有 Linux 机型才有的本地 broker、Matter 控制器、P09 船外宿主与 433 MHz 随 Air Hub Pro 提供。
需求编号互不重叠：Air 为 AIR-nn，Key 为 KEY-nn（FR-nn 到 KEY-nn 的映射在 Key 规格 §9），Air Hub 为 GW-nn，跨半边共用 SYS-nn、SEC-nn、IF-nn、MFG-nn；待决项为 AIR-O-nn、KEY-O-nn，线级待决项为 SW-O-nn。
2. 文档地图
章节标题：“2. 文档地图”三个产品用同一组四个文件，每个文件只承担一个登记簿：
| 登记簿 | 文件 | 面向 | 规则 |
|---|---|---|---|
| 说明展示 | P05-<x>-brief.md |
客户、安装商、经销、销售 | 只复述规格中的能力，不新增承诺 |
| 功能描述 + 规格书 | P05-<x>.md（Level 1） |
内部工程、治理、供应商 | 唯一的需求来源，唯一允许出现数值的文件；第 3 章是功能与状态行为的 ID 表 |
| 开发需求（内部设计输入） | P05-<x>-design.md（Level 2） |
内部工程、设计公司 | 平台对比、推荐器件、架构与预算；引用规格 ID，不复述目标值 |
| 开发需求（供应商交付） | P05-<x>-guide.md |
设计公司、代工厂 | 需求追踪（ID → 验收）、验证矩阵、工厂测试、报价；公共条款在 P05-switch-guide.md |
供应商交付：Air 与 Air Hub 由同一代工范围报价，Key 由不同代工范围报价；每个产品的规格加指南即其 RFQ 包，设计附录按需提供。
3. 系统位置
章节标题：“3. 系统位置”- 船内：Key 经 YBO CAN 直接控制 Core，不需要 Air Hub、Mate 或互联网；Air 经 Air Hub 转发到同一条 CAN 上的 Core。Mate 经局域网 MQTT 与 YBO CAN 到达 Air Hub，但不在控制环路内。
- 船外：Air Hub 是 P09 Control 的宿主，驱动第三方断路器/继电器。Air Hub 带 CAN，所以船外安装同样可以用有线 Key：Key → CAN → Air Hub → 执行器，既没有 Air 也没有 Core。
- 回读准则：链路 ACK 只表示收到，成功必须来自执行侧的真实回读。船内该回读来自 Core；船外没有 Core 时由谁充当状态权威，见
SW-O-01。
4. 失效安全
章节标题：“4. 失效安全”船内的兜底路径是 Key 的有线 CAN：Air Hub 或其 Linux 丢失时，Air 控制不可用，但 Key → Core 仍然工作，X02 G-01 也禁止把关键回路只绑到 wireless_key。
船外这条兜底不存在：没有 Core，Key 与 Air 都经过 Air Hub，它的 Linux 因此成为有线开关的单点。这必须写进船外形态的销售与安装材料，不能沿用船内的失效安全表述；具体处置见 SW-O-02。
5. 线级待决项
章节标题：“5. 线级待决项”| ID | 项目 | 关口 |
|---|---|---|
| SW-O-01 | 无 Core 时的回读权威：Air Hub 是否充当权威、状态从哪个执行器读回、pending/未知如何表示 | D0/D1 |
| SW-O-02 | 船外失效安全表述：Linux 单点的看门狗/有界恢复要求，销售与安装材料如何声明 | D0 |
| SW-O-03 | 支路供电预算（Key 面板延后后随面板重启）：Air Hub 的 CAN 支路是否为 Key 面板供电、可带几块、背光电流如何计入输入预算 | D1 |
6. 变更记录
章节标题：“6. 变更记录”| 日期 | 版本 | 变更 | 记录 |
|---|---|---|---|
| 2026-09-12 | R0.1 | 合并 P05 Air Switch、P05 Air Hub 与 P06 Key 为一条产品线；记录 Key 经 Air Hub CAN 支路接入的拓扑（GW-06），新增 SW-O-01…03 |
changelog |
| 2026-09-14 | R0.2 | 产品线改为三个子包（air/、key/、air-hub/）；Air 与 Air Hub 各合并为单一规格文件 | 任务 20260914-0010 |
| 2026-09-22 | R0.3 | 三个子包统一为说明/规格/设计/指南四文件；新增 §2 文档地图与线级公共条款 P05-switch-guide.md；Key 的 FR-nn 并入 KEY-nn |
任务 20260921-1700 |
| 2026-09-23 | R0.4 | Air 行的电池改为 1×CR2450（Air 规格 R0.5） | 任务 20260922-2048 |
| 2026-09-25 | R0.5 | 型号表加入 Air Hub LR（Air Hub 规格 R0.5 拆分为两个型号） | 任务 20260925-0942 |
| 2026-09-27 | R0.6 | Air Hub 行随 Air Hub 规格 R0.7：平台按组合选定，Air Hub LR 可为 LoRaWAN 网关或自有 LoRa 星型网 | 任务 20260927-1640 |
| 2026-09-28 | R0.7 | Key 行随 Key 规格 R0.3：带 BLE 服务通道，合规改为无线设备；每块板最多 8 键，可带扩展单元 | 任务 20260928-0836 |
| 2026-09-28 | R0.8 | Key 型号说明随 Key 规格 R0.4：可带 I2C 与内部 CAN 两种扩展单元 | 任务 20260928-1330 |
| 2026-09-29 | R0.9 | Air Hub 行随 Air Hub 规格 R0.9：分为 Air Hub（$59）与 Air Hub Pro（$119），两者带 433 MHz 链路；Air Hub LR 撤销 | 任务 20260929-0011 |
| 2026-09-29 | R1.0 | Air Hub 行随 Air Hub 规格 R1.0：两个产品都带 EFR32MG21，433 MHz 只在 Air Hub Pro | 任务 20260929-0235 |
| 2026-10-06 | R1.1 | Air Hub 行随 Air Hub 规格 R1.1：入门款平台改为 SSD2351 邮票孔核心板 | 任务 20261006-0315 |
| 2026-10-09 | R1.2 | 型号表加入 Air Hub Mini（Air Hub 规格 R1.4） | 任务 20261009-1106 |
| 2026-10-12 | R1.3 | Air Hub 行随 Air Hub 规格 R1.6：入门款平台锁定为 RK3506G 邮票孔核心板，SigmaStar 平台放弃 | 任务 20261012-2303 |
| 2026-10-19 | R1.4 | §1 型号与产品表只写当前状态，去掉合并与选型的日期和过程 | 任务 20261019-1200 |
| 2026-10-28 | R1.5 | Air Hub 型号行的 Wi-Fi 由 ESP32-C6 改为 ESP32-C5（Air Hub 规格 R1.22） | 任务 20261028-1709 |
| 2026-10-29 | R1.7 | Key Box 36 列入型号行与产品表，T0 有线产品改为 Key Box 36；Key 4 / Key 8 面板与扩展单元未设计，延后 | 任务 20261029-0443 |
| 2026-10-29 | R1.8 | 产品顺序改为 Key Box 36 → Air → Air Hub Mini → Air Hub Pro：产品表按此重排，Air Hub Mini 随 Air 首发，Air Hub Pro 在其后，标准版 Air Hub 为后续选项 | 任务 20261029-0614 |