跳转到内容
YBO 技术文档

20260914-0010-air-subghz-lora-and-consistency Add sub-GHz/LoRa chip selection and repair Air/Air Hub inconsistencies

  • status: completed
  • priority: P1
  • owner: claude/session-63037002
  • createdAt: 2026-09-14 00:10

Description

章节标题：“Description”

The user reported three things about the Switch line: the Air Hub has no chip selection for 433.92 / 915 / LoRa, the Air switch needs the same, and Air and Air Hub disagree in several places.

Investigation confirms five defects, of which three are pure documentation drift and two need a decision plus datasheet work.

Drift, fixable without any new decision:

  1. Air's recommended MCU contradicts itself three ways. PRODUCT-PLAN.md §P5 says nRF54L15 is the primary recommendation; P05-air-switch.md §6 says ESP32-H2 (MINI-1) is primary and nRF54L15 is the alternate; P05-air-supplier-guide.md §4 labels its only Air MCU row "备选" while §5's battery budget is computed against ESP32-H2's 3.6 V ceiling.
  2. Air Hub carries two platform generations at once. PRODUCT-PLAN.md and P05-air-hub.md §2 put it on Linux (SSD202D) plus 2×ESP32-C6 and demote STM32G0B1CE + nRF54L15 to a comparison; P05-air-supplier-guide.md §4 still lists STM32G0B1CE + nRF54L15 as the recommendation, and P05-air-hub-design.md still carries that pair in its block diagram, responsibility table and upgrade chain.
  3. Air Hub's power target is 5–10× out of date. P05-air-hub.md and P05-air-hub-design.md keep ≤15 mA listening / ≤30 mA running, which were derived from the STM32 pair; the plan and the platform comparison put the Linux platform at 125–210 mA@12 V.

Gaps needing a decision and datasheet evidence:

  1. Only Air has a sub-GHz candidate. TI CC1312R appears in the Air guide, the Air design appendix and platform option D. The Air Hub side names no part, only "评审相同区域方案".
  2. LoRa has no candidate anywhere, and the existing one cannot provide it. CC1312R supports (G)FSK; LoRa is Semtech's proprietary CSS modulation and needs an SX126x-class radio or an STM32WL-class MCU. P12 Tag leaves the PHY open; the Air Hub extension table only says regional receive hardware is required.

The package also frames sub-GHz as a replacement for BLE, not an addition — "sub-GHz 不叠加在 BLE 方案之上", "不默认在每个 Air 上同时安装两套射频". The user's request reads as wanting support for all three, which is the opposite framing and changes BOM, antenna, certification and cost.

ActiveForm

章节标题：“ActiveForm”

Adding sub-GHz/LoRa chip selection and repairing Air/Air Hub inconsistencies.

Dependencies

章节标题：“Dependencies”
  • blocked by: the positioning question — whether sub-GHz and LoRa are added alongside BLE or remain a conditional replacement.
  • blocks: (none)

Notes

章节标题：“Notes”

  • Full tier. Defects 1–3 are drift repair; 4–5 need a selection study with datasheet sources before any specification changes.

  • unclaim: Owner session ended; the user directed this session to complete the plan.

  • complete: Air and Air Hub consolidated; drift repaired per the 2026-09-11/12 decisions; sub-GHz/LoRa candidates recorded, positioning open as AIR-O-09.