Skip to content

docs: bring README, changelog and CAD docs in line with the new boards - #19

Merged
Elektr0Vodka merged 4 commits into
mainfrom
Docs/sync-after-board-prs
Oct 18, 2026
Merged

Elektr0Vodka merged 4 commits into
mainfrom
Docs/sync-after-board-prs

Conversation

@Elektr0Vodka

@Elektr0Vodka Elektr0Vodka commented Oct 18, 2026 •

Copy link
Copy Markdown
Owner

What

Docs follow-up to #16, #17 and #18. No firmware changes.

Why

These went stale when the T-Echo family and the new S3 boards were added.

Testing

Docs only. Checked the rendered tables and that every board named matches MESHCOMOD_COMPANION_ENVS and the env's UI in variants/*/platformio.ini.

Firmware or build impact

None.

disable_debug_flags() passed -UCFG_DEBUG. The Adafruit nRF52 core reads
CFG_DEBUG unconditionally (cores/nRF5/rtos.cpp), and the platform
builder only adds its CFG_DEBUG=0 default when the flags don't mention
the macro, so every nRF52 build with DISABLE_DEBUG=1 failed with
"'CFG_DEBUG' was not declared". Pass -DCFG_DEBUG=0 instead, which is
the quiet setting the builder would have used.

Built with DISABLE_DEBUG=1: LilyGo_T-Echo_companion_radio_ble,
WioTrackerL1_companion_radio_usb (both failed before) and
heltec_v4_companion_radio_usb_tcp (same size as before).
The C6 envs use pioarduino (Arduino core 3.x) through esp32c6_base but
inherited h2zero/NimBLE-Arduino 1.4.3 from esp32_base, which only builds
against core 2.x ("syscfg/syscfg.h: No such file"). Every C6 companion
failed to compile.

esp32c6_base now pulls NimBLE-Arduino 2.3.9. SerialBLEInterface keeps
its behaviour but implements both callback APIs: the bodies move into
shared helpers and thin overrides match each version's signatures
(NimBLEConnInfo, onPassKeyDisplay, onConfirmPassKey with
injectConfirmPasskey, enableScanResponse). The version is picked with
__has_include(<NimBLEAdvertisementData.h>), which only 2.x ships. Core
3.x moved esp_efuse_mac_get_default to esp_mac.h, so include it when
present.

Built: Xiao_C6, Meshimi, WHY2025_badge and LilyGo_Tlora_C6 BLE
companions, M5Stack_Unit_C6L BLE and USB, Xiao_C6_repeater_ (all failed
or untested before). The S3 boards stay on 1.4.3:
heltec_v4_companion_radio_ble and _usb_tcp build, the latter +136 B
from the helper indirection. Not tested on hardware.
After #16, #17 and #18:

- README: the multi-transport claim only holds for the Wi-Fi boards;
  add how to flash the nRF52 boards (.uf2, DFU .zip); describe nRF52
  build outputs and warn that DISABLE_DEBUG=1 breaks nRF52 builds.
- CAD toggle doc: the per-UI board examples now name the released
  boards (ui-new on the display usb_tcp boards, Wio Tracker L1 and
  T-Echo; ui-tiny on the T-Echo Card; ui-orig on the ThinkNode M7).
- Changelog: tag the Unreleased entries with the PR that landed them.
@Elektr0Vodka
Elektr0Vodka force-pushed the Docs/sync-after-board-prs branch from 1fb28b1 to 56de25f Compare October 18, 2026 17:49
@Elektr0Vodka
Elektr0Vodka merged commit 9cda000 into main Oct 18, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant