跳转到内容
YBO 技术文档

20261014-0022-air-hub-unify-esp32-c6-mini-module Use one ESP32-C6-MINI-1 part number on all three Air Hub products

  • status: completed
  • createdAt: 2026-10-14 00:22
  • approvedAt: 2026-10-14 00:28 (owner: "用Mini-1-N4")
  • relatedTask: 20261014-0022-air-hub-unify-esp32-c6-mini-module

Context

章节标题：“Context”

Air Hub spec R1.6 (commit 9c98849):

  • Air Hub and Air Hub Pro: ESP32-C6-MINI-1 as Wi-Fi uplink and configuration channel. The reference-board part list names ESP32-C6-MINI-1-N4 (LCSC C5736265, 2.83 USD @1.3k); the spec does not fix N or H.
  • Air Hub Mini: ESP32-C6-WROOM-1-N8 as the only controller (8 MB flash, 23 GPIO, −40…+85 °C only, 18.0 × 25.5 mm), chosen on 2026-10-09 over MINI-1 for its flash and one extra GPIO. A schematic and a first PCB on WROOM-1 were generated on 2026-10-13 (reference-board page §7.4, project /srv/ybo/switch/air_hub_mini/, task 20261013-0905) and are part of the hardware handover package (task 20261013-0200).

ESP32-C6-MINI-1 variants share chip, 4 MB flash and pinout: N4 (PCB antenna, +85 °C), H4 (PCB antenna, +105 °C), 1U-N4 and 1U-H4 (external antenna). LCSC 2026-10-09: N4 2.85, H4 3.10 USD @1.3k.

Consequences of MINI-1 on Air Hub Mini:

  • GPIO: MINI-1 brings out 22 GPIO (IO0–IO9, IO12–IO15, IO18–IO23, TXD0, RXD0; no IO10 / IO11). The Mini uses 21; UART CTS moves from IO10 to IO14 and the only spare pin is the IO15 strapping pin, so no freely usable GPIO remains.
  • Flash: 4 MB instead of 8 MB for two OTA slots, the EFR32MG21 images, configuration and the 4096-entry audit log. Both EFR32MG21 images cannot be stored next to two OTA slots; the inactive image has to be fetched during the maintenance session that switches it (GW-07).
  • Temperature: an H4 module adds a +105 °C grade the WROOM-1 does not have.
  • Board: module footprint changes from 18.0 × 25.5 mm to 13.2 × 16.6 mm; the 2026-10-13 schematic and PCB no longer match.

Proposal

章节标题：“Proposal”

Spec P05-air-hub.md R1.7: one order code, ESP32-C6-MINI-1-H4, on Air Hub, Air Hub Pro and Air Hub Mini (decision 1).

  1. §1, §2.1, §2.2 (H16), §2.3 (AH-21), §2.4 radio row: module named with its order code.
  2. §2.5: controller, flash (4 MB partition budget, EFR32MG21 image fetched on switch), capacity, environment and pin rows restated for MINI-1-H4.
  3. GW-07 note for the Mini (inactive image is downloaded and verified in the maintenance session), AIR-O-15 (4 MB partition table and zero spare GPIO become open items), BOM figures, §9 change-log row.

Design appendix, reference-board page (§2.4 pin table redone for MINI-1, §5 part list, §6 and §6.1 BOM: Linux boards +0.25 USD, Mini about −0.0 USD net; §7.4 handled per decision 2), guide, platform evaluation §8.5, product plan BOM row. Changelog, task and plan status.

Decisions requested (recommended first):

  1. Grade: H4 (−40…+105 °C) on all three, about 0.25 USD more than N4 per unit; Air Hub Pro is rated to +85 °C ambient-grade parts and gains margin for the enclosure rise. Alternative: N4 on all three.
  2. Mini schematic and PCB: regenerate the air_hub_mini project on MINI-1 in this task (generator scripts exist in /srv/ybo/switch/tools/) and refresh §7.4 and its diagrams. Alternative: documents only, with the WROOM-1 schematic and PCB marked superseded.
  3. Flash on the Mini: accept 4 MB with the EFR32MG21 image fetched at switch time. Alternative: add an external SPI NOR flash on the W5500 SPI bus (about 0.3 USD, needs one more chip-select pin, which MINI-1 does not have spare without giving up an LED).

Risks

章节标题：“Risks”
  • The Mini loses its flash headroom and its last free GPIO; adding NFC or another I2C part later needs a pin given up elsewhere.
  • Image switching on the Mini needs a network connection or the maintenance tool to supply the image.
  • The handover package of 2026-10-13 is outdated for the Mini until the project is regenerated.

Scope

章节标题：“Scope”

About 8 documentation files; with decision 2 as recommended also the air_hub_mini KiCad project and seven diagrams.

Alternatives

章节标题：“Alternatives”
  • Keep WROOM-1 on the Mini and fix only the Linux products on MINI-1-H4.

Annotations

章节标题：“Annotations”
  • 2026-10-14: owner asked for one ESP32-C6-MINI module on the Mini and Pro alike.
  • 2026-10-14: owner asked whether all three could use ESP32-C6-WROOM-1-N8 and for its size (18.0 × 25.5 × 3.1 mm), then asked to evaluate a 4 MB layout with an updater image plus one application instead of two full copies ("评估一下4M 放引导rom负责更新和应用双rom的可行性，不是完全的 两份"). Assessed as feasible with longer update downtime and no local rollback.
  • 2026-10-14: owner chose ESP32-C6-MINI-1-N4 ("用Mini-1-N4"). This supersedes decision 1 (N4, not H4) and decision 3 (4 MB with an updater image plus a single application). Decision 2 was not answered: only the documents were changed; the WROOM-1 Mini schematic, PCB and handover material are marked superseded and not regenerated.