shade/MeshCoreTel-firmware
1
0
Форкнуть 0
Код Задачи Запросы на слияние Действия Пакеты Проекты Релизы Вики Активность

docs: improve board guidance and normalise eastmesh mqtt targets

Просмотр исходного кода
Этот коммит содержится в:
Jared Dohrman
2026-04-13 16:01:22 +10:00
родитель 09399c75eb
Коммит 631fcc67fb
6 изменённых файлов: 665 добавлений и 622 удалений
Скачать Patch файл Скачать Diff файл Показать все файлы Свернуть все файлы
.github/workflows/pr-build-check.yml
+2 -3
Просмотреть файл
@@ -21,8 +21,6 @@ jobs:
matrix: matrix:
environment: environment:
# ESP32-S3 / core EastMesh targets # ESP32-S3 / core EastMesh targets
- Heltec_v3_companion_radio_wifi
- Heltec_v3_repeater_mqtt
- heltec_v4_companion_radio_wifi - heltec_v4_companion_radio_wifi
- heltec_v4_repeater_mqtt - heltec_v4_repeater_mqtt
- T_Beam_S3_Supreme_SX1262_companion_radio_wifi - T_Beam_S3_Supreme_SX1262_companion_radio_wifi
@@ -31,7 +29,8 @@ jobs:
- Xiao_C3_companion_radio_wifi - Xiao_C3_companion_radio_wifi
- Xiao_C3_repeater_mqtt - Xiao_C3_repeater_mqtt
# ESP32-C6 # ESP32-C6
- LilyGo_Tlora_C6_repeater_mqtt_ - LilyGo_Tlora_C6_repeater_mqtt
- Xiao_C6_repeater_mqtt
steps: steps:
- name: Clone Repo - name: Clone Repo
.github/workflows/push-build-check.yml
+2 -2
Просмотреть файл
@@ -21,13 +21,13 @@ jobs:
matrix: matrix:
environment: environment:
# ESP32-S3 / core EastMesh targets # ESP32-S3 / core EastMesh targets
- Heltec_v3_repeater_mqtt
- heltec_v4_repeater_mqtt - heltec_v4_repeater_mqtt
- T_Beam_S3_Supreme_SX1262_repeater_mqtt - T_Beam_S3_Supreme_SX1262_repeater_mqtt
# ESP32-C3 # ESP32-C3
- Xiao_C3_repeater_mqtt - Xiao_C3_repeater_mqtt
# ESP32-C6 # ESP32-C6
- LilyGo_Tlora_C6_repeater_mqtt_ - LilyGo_Tlora_C6_repeater_mqtt
- Xiao_C6_repeater_mqtt
steps: steps:
- name: Clone Repo - name: Clone Repo
docs/boards.md
+89 -60
Просмотреть файл
@@ -1,81 +1,109 @@
# Board Comparison # Board Comparison
The tables below are built from the repo's PlatformIO board metadata and variant build flags. `RAM` is the MCU's on-chip RAM where it is known from the MCU family. `PSRAM` is only shown when the repo declares it explicitly or enables it in board metadata. If the board enables PSRAM but the repo does not declare a size, it is marked as `Yes (size not declared)`. This page is meant to help you choose a board, not just list every technical detail.
## Quick Guidance If you only want a quick answer:
- for a roof-mounted or set-and-forget MQTT repeater, start with `heltec_v4`, `heltec_v4_tft`, `Station_G2`, or `T_Beam_S3_Supreme_SX1262`
- for an app-first Wi-Fi companion, headless boards are fine and often simpler
- if you want an onboard screen people will actually use, prefer TFT boards
- if you want a low-power status screen, prefer e-paper boards
The tables below are built from the repo's PlatformIO board metadata and variant build flags.
- `Target` is the short board name used in this comparison page. Release filenames and local build commands still use the full env names such as `heltec_v4_repeater_mqtt`.
- `RAM` is the MCU's built-in RAM.
- `PSRAM` is extra memory on some boards. More PSRAM usually means more headroom for UI, MQTT, and future features.
- `Web UI` means the local repeater web panel is enabled in that build.
If a board enables PSRAM but the repo does not declare the exact size, it is shown as `Yes (size not declared)`.
## Start Here
- Pick an `ESP32-S3` board with `16MB` flash and PSRAM if you want the most headroom for MQTT plus UI: `heltec_v4_tft`, `heltec_v4`, `Station_G2`, `T_Beam_S3_Supreme_SX1262`. - Pick an `ESP32-S3` board with `16MB` flash and PSRAM if you want the most headroom for MQTT plus UI: `heltec_v4_tft`, `heltec_v4`, `Station_G2`, `T_Beam_S3_Supreme_SX1262`.
- Pick a TFT board if this will be used as a human-facing companion or field node: `heltec_v4_tft`, `heltec_tracker_v2`, `LilyGo_TDeck`, `Heltec_T190`. - Pick a TFT board if this will be used as a human-facing companion or field node: `heltec_v4_tft`, `heltec_tracker_v2`, `LilyGo_TDeck`, `Heltec_T190`.
- Pick e-paper if you want a status screen with lower idle draw and less frequent refresh: `Heltec_E213`, `Heltec_E290`, `Heltec_Wireless_Paper`, `ThinkNode_M5`. - Pick e-paper if you want a status screen with lower idle draw and less frequent refresh: `Heltec_E213`, `Heltec_E290`, `Heltec_Wireless_Paper`, `ThinkNode_M5`.
- Pick a headless board if this is mainly a fixed MQTT gateway and screen space is not useful: `Xiao_C3`, `RAK_3112`, `Tenstar_C3`, `Heltec_ct62`, `Generic_E22`. - Pick a headless board if this is mainly a fixed MQTT gateway and screen space is not useful: `Xiao_C3`, `RAK_3112`, `Tenstar_C3`, `Heltec_ct62`, `Generic_E22`.
- Pick a headless Wi-Fi companion if the phone app will be the primary UI anyway: `Xiao_C3_companion_radio_wifi`, `RAK_3112_companion_radio_wifi`, `Xiao_S3_WIO_companion_radio_wifi`, `Station_G2_companion_radio_wifi`.
- Pick a GPS-capable board if location-aware/mobile use matters: the T-Beam family, `heltec_tracker_v2`, `Heltec_v3`, `heltec_v4`, `Station_G2`, `ThinkNode_M5`. - Pick a GPS-capable board if location-aware/mobile use matters: the T-Beam family, `heltec_tracker_v2`, `Heltec_v3`, `heltec_v4`, `Station_G2`, `ThinkNode_M5`.
- If you want the most conservative, older radio family choices, the `SX1276` boards are `LilyGo_TLora_V2_1_1_6`, `Tbeam_SX1276`, and `Heltec_v2`. - If you want the most conservative, older radio family choices, the `SX1276` boards are `LilyGo_TLora_V2_1_1_6`, `Tbeam_SX1276`, and `Heltec_v2`.
## `repeater_mqtt` Boards ## `repeater_mqtt` Boards
Rows with a trailing `_` in the env name are still included because they exist in `variants/eastmesh_mqtt/platformio.ini`, but they look more experimental than the main EastMesh targets listed in [local-builds.md](./local-builds.md). This table includes all repeater MQTT targets currently defined in `variants/eastmesh_mqtt/platformio.ini`.
| Env | CPU | RAM | PSRAM | Flash | LoRa | Display | GPS | Web UI | Notes | | Target | CPU | RAM | PSRAM | Flash | LoRa | Display | GPS | Web UI | Notes |
| -------------------------------------- | ----------------- | ------ | ----------------------- | ----- | ------ | --------------- | --- | ------ | --------------------------------------- | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| T_Beam_S3_Supreme_SX1262_repeater_mqtt | ESP32S3 / 240 MHz | 512 KB | 8 MB | 8MB | SX1262 | OLED (SH1106) | Yes | Yes | GPS, more memory headroom | | Ebyte_EoRa-S3 | ESP32S3 / 240 MHz | 512 KB | Yes (size not declared) | 4MB | SX1262 | OLED (SSD1306) | No | Yes | more memory headroom |
| LilyGo_TLora_V2_1_1_6_repeater_mqtt | ESP32 / 240 MHz | 520 KB | No | 4 MB | SX1276 | OLED (SSD1306) | Yes | Yes | GPS | | Generic_E22_sx1262 | ESP32 / 240 MHz | 520 KB | No | 4 MB | SX1262 | None | No | Yes | headless |
| LilyGo_TBeam_1W_repeater_mqtt | ESP32S3 / 240 MHz | 512 KB | Yes (size not declared) | 16MB | SX1262 | OLED (SH1106) | Yes | Yes | GPS, more memory headroom | | Generic_E22_sx1268 | ESP32 / 240 MHz | 520 KB | No | 4 MB | SX1268 | None | No | Yes | headless |
| Xiao_C3_repeater_mqtt | ESP32C3 / 160 MHz | 400 KB | No | 4 MB | SX1262 | None | Yes | No | headless, GPS, web panel off | | Heltec_ct62 | ESP32C3 / 160 MHz | 400 KB | No | 4 MB | SX1262 | None | No | Yes | headless |
| Ebyte_EoRa-S3_Repeater_mqtt | ESP32S3 / 240 MHz | 512 KB | Yes (size not declared) | 4MB | SX1262 | OLED (SSD1306) | No | Yes | more memory headroom | | Heltec_E213 | ESP32S3 / 240 MHz | 512 KB | 8 MB | 16MB | SX1262 | E-paper (2.13") | No | Yes | low-power display, more memory headroom |
| RAK_3112_repeater_mqtt | ESP32S3 / 240 MHz | 512 KB | No | 8 MB | SX1262 | None | Yes | Yes | headless, GPS | | Heltec_E290 | ESP32S3 / 240 MHz | 512 KB | 8 MB | 16MB | SX1262 | E-paper (2.9") | No | Yes | low-power display, more memory headroom |
| Tbeam_SX1262_repeater_mqtt | ESP32 / 240 MHz | 520 KB | No | 4 MB | SX1262 | OLED (SSD1306) | Yes | Yes | GPS | | Heltec_T190 | ESP32S3 / 240 MHz | 512 KB | 8 MB | 16MB | SX1262 | TFT (ST7789) | No | Yes | richer UI, more memory headroom |
| Heltec_E290_repeater_mqtt | ESP32S3 / 240 MHz | 512 KB | 8 MB | 16MB | SX1262 | E-paper (2.9") | No | Yes | low-power display, more memory headroom | | heltec_tracker_v2 | ESP32S3 / 240 MHz | 512 KB | No | 8MB | SX1262 | TFT (ST7735) | Yes | Yes | richer UI, GPS |
| Tbeam_SX1276_repeater_mqtt | ESP32 / 240 MHz | 520 KB | No | 4 MB | SX1276 | OLED (SSD1306) | Yes | Yes | GPS | | Heltec_v2 | ESP32 / 240 MHz | 520 KB | No | 8 MB | SX1276 | OLED (SSD1306) | No | Yes | |
| Heltec_E213_repeater_mqtt | ESP32S3 / 240 MHz | 512 KB | 8 MB | 16MB | SX1262 | E-paper (2.13") | No | Yes | low-power display, more memory headroom | | Heltec_v3 | ESP32S3 / 240 MHz | 512 KB | No | 8 MB | SX1262 | OLED (SSD1306) | Yes | Yes | GPS |
| Heltec_Wireless_Tracker_repeater_mqtt | ESP32S3 / 240 MHz | 512 KB | No | 8 MB | SX1262 | TFT (ST7735) | Yes | Yes | richer UI, GPS | | heltec_v4 | ESP32S3 / 240 MHz | 512 KB | 2 MB | 16MB | SX1262 | OLED (SSD1306) | Yes | Yes | GPS, more memory headroom |
| M5Stack_Unit_C6L_repeater_mqtt | ESP32C6 / 160 MHz | 512 KB | No | 4 MB | SX1262 | None | Yes | Yes | headless, GPS | | heltec_v4_tft | ESP32S3 / 240 MHz | 512 KB | 2 MB | 16MB | SX1262 | TFT (ST7789) | Yes | Yes | richer UI, GPS, more memory headroom |
| LilyGo_TDeck_repeater_mqtt | ESP32S3 / 240 MHz | 512 KB | No | 16MB | SX1262 | TFT (ST7789) | Yes | Yes | richer UI, GPS | | Heltec_Wireless_Paper | ESP32S3 / 240 MHz | 512 KB | No | 8 MB | SX1262 | E-paper (2.13") | No | Yes | low-power display |
| Station_G2_repeater_mqtt | ESP32S3 / 240 MHz | 512 KB | Yes (size not declared) | 16MB | SX1262 | OLED (SH1106) | Yes | Yes | GPS, more memory headroom | | Heltec_Wireless_Tracker | ESP32S3 / 240 MHz | 512 KB | No | 8 MB | SX1262 | TFT (ST7735) | Yes | Yes | richer UI, GPS |
| Station_G2_logging_repeater_mqtt | ESP32S3 / 240 MHz | 512 KB | Yes (size not declared) | 16MB | SX1262 | OLED (SH1106) | Yes | Yes | GPS, more memory headroom | | Heltec_WSL3 | ESP32S3 / 240 MHz | 512 KB | No | 8 MB | SX1262 | None | Yes | Yes | headless, GPS |
| LilyGo_T3S3_sx1262_repeater_mqtt | ESP32S3 / 240 MHz | 512 KB | Yes (size not declared) | 4MB | SX1262 | OLED (SSD1306) | No | Yes | more memory headroom | | LilyGo_T3S3_sx1262 | ESP32S3 / 240 MHz | 512 KB | Yes (size not declared) | 4MB | SX1262 | OLED (SSD1306) | No | Yes | more memory headroom |
| Meshadventurer_sx1262_repeater_mqtt | ESP32 / 240 MHz | 520 KB | No | 4 MB | SX1262 | OLED (SSD1306) | Yes | Yes | GPS | | LilyGo_T3S3_sx1276 | ESP32S3 / 240 MHz | 512 KB | Yes (size not declared) | 4MB | SX1276 | OLED (SSD1306) | No | Yes | more memory headroom |
| Meshadventurer_sx1268_repeater_mqtt | ESP32 / 240 MHz | 520 KB | No | 4 MB | SX1268 | OLED (SSD1306) | Yes | Yes | GPS | | LilyGo_TBeam_1W | ESP32S3 / 240 MHz | 512 KB | Yes (size not declared) | 16MB | SX1262 | OLED (SH1106) | Yes | Yes | GPS, more memory headroom |
| Heltec_Wireless_Paper_repeater_mqtt | ESP32S3 / 240 MHz | 512 KB | No | 8 MB | SX1262 | E-paper (2.13") | No | Yes | low-power display | | LilyGo_TDeck | ESP32S3 / 240 MHz | 512 KB | No | 16MB | SX1262 | TFT (ST7789) | Yes | Yes | richer UI, GPS |
| heltec_v4_repeater_mqtt | ESP32S3 / 240 MHz | 512 KB | 2 MB | 16MB | SX1262 | OLED (SSD1306) | Yes | Yes | GPS, more memory headroom | | LilyGo_Tlora_C6 | ESP32C6 / 160 MHz | 512 KB | No | 4 MB | SX1262 | None | No | Yes | headless |
| heltec_v4_tft_repeater_mqtt | ESP32S3 / 240 MHz | 512 KB | 2 MB | 16MB | SX1262 | TFT (ST7789) | Yes | Yes | richer UI, GPS, more memory headroom | | LilyGo_TLora_V2_1_1_6 | ESP32 / 240 MHz | 520 KB | No | 4 MB | SX1276 | OLED (SSD1306) | Yes | Yes | GPS |
| heltec_tracker_v2_repeater_mqtt | ESP32S3 / 240 MHz | 512 KB | No | 8MB | SX1262 | TFT (ST7735) | Yes | Yes | richer UI, GPS | | M5Stack_Unit_C6L | ESP32C6 / 160 MHz | 512 KB | No | 4 MB | SX1262 | None | Yes | Yes | headless, GPS |
| Heltec_v3_repeater_mqtt | ESP32S3 / 240 MHz | 512 KB | No | 8 MB | SX1262 | OLED (SSD1306) | Yes | Yes | GPS | | Meshadventurer_sx1262 | ESP32 / 240 MHz | 520 KB | No | 4 MB | SX1262 | OLED (SSD1306) | Yes | Yes | GPS |
| Heltec_WSL3_repeater_mqtt | ESP32S3 / 240 MHz | 512 KB | No | 8 MB | SX1262 | None | Yes | Yes | headless, GPS | | Meshadventurer_sx1268 | ESP32 / 240 MHz | 520 KB | No | 4 MB | SX1268 | OLED (SSD1306) | Yes | Yes | GPS |
| LilyGo_T3S3_sx1276_repeater_mqtt | ESP32S3 / 240 MHz | 512 KB | Yes (size not declared) | 4MB | SX1276 | OLED (SSD1306) | No | Yes | more memory headroom | | Meshimi | ESP32C6 / 160 MHz | 512 KB | No | 4 MB | SX1262 | None | No | Yes | headless |
| LilyGo*Tlora_C6_repeater_mqtt* | ESP32C6 / 160 MHz | 512 KB | No | 4 MB | SX1262 | None | No | Yes | headless | | nibble_screen_connect | ESP32S3 / 240 MHz | 512 KB | No | 4MB | SX1262 | OLED (SSD1306) | No | Yes | |
| Xiao*C6_repeater_mqtt* | ESP32C6 / 160 MHz | 512 KB | No | 4 MB | SX1262 | None | No | Yes | headless | | RAK_3112 | ESP32S3 / 240 MHz | 512 KB | No | 8 MB | SX1262 | None | Yes | Yes | headless, GPS |
| Meshimi*repeater_mqtt* | ESP32C6 / 160 MHz | 512 KB | No | 4 MB | SX1262 | None | No | Yes | headless | | Station_G2 | ESP32S3 / 240 MHz | 512 KB | Yes (size not declared) | 16MB | SX1262 | OLED (SH1106) | Yes | Yes | GPS, more memory headroom |
| WHY2025*badge_repeater_mqtt* | ESP32C6 / 160 MHz | 512 KB | No | 4 MB | SX1262 | None | No | Yes | headless | | Station_G2_logging | ESP32S3 / 240 MHz | 512 KB | Yes (size not declared) | 16MB | SX1262 | OLED (SH1106) | Yes | Yes | GPS, more memory headroom |
| Heltec_v2_repeater_mqtt | ESP32 / 240 MHz | 520 KB | No | 8 MB | SX1276 | OLED (SSD1306) | No | Yes | | | T_Beam_S3_Supreme_SX1262 | ESP32S3 / 240 MHz | 512 KB | 8 MB | 8MB | SX1262 | OLED (SH1106) | Yes | Yes | GPS, more memory headroom |
| nibble_screen_connect_repeater_mqtt | ESP32S3 / 240 MHz | 512 KB | No | 4MB | SX1262 | OLED (SSD1306) | No | Yes | | | Tbeam_SX1262 | ESP32 / 240 MHz | 520 KB | No | 4 MB | SX1262 | OLED (SSD1306) | Yes | Yes | GPS |
| ThinkNode_M2_Repeater_mqtt | ESP32S3 / 240 MHz | 512 KB | No | 4MB | SX1262 | OLED (SH1106) | No | Yes | | | Tbeam_SX1276 | ESP32 / 240 MHz | 520 KB | No | 4 MB | SX1276 | OLED (SSD1306) | Yes | Yes | GPS |
| ThinkNode_M5_Repeater_mqtt | ESP32S3 / 240 MHz | 512 KB | No | 4MB | SX1262 | E-paper (GxEPD) | Yes | Yes | low-power display, GPS | | Tenstar_C3_sx1262 | ESP32C3 / 160 MHz | 400 KB | No | 4 MB | SX1262 | None | No | Yes | headless |
| Heltec*T190_repeater_mqtt* | ESP32S3 / 240 MHz | 512 KB | 8 MB | 16MB | SX1262 | TFT (ST7789) | No | Yes | richer UI, more memory headroom | | Tenstar_C3_sx1268 | ESP32C3 / 160 MHz | 400 KB | No | 4 MB | SX1268 | None | No | Yes | headless |
| Tenstar_C3_sx1262_repeater_mqtt | ESP32C3 / 160 MHz | 400 KB | No | 4 MB | SX1262 | None | No | Yes | headless | | ThinkNode_M2 | ESP32S3 / 240 MHz | 512 KB | No | 4MB | SX1262 | OLED (SH1106) | No | Yes | |
| Tenstar_C3_sx1268_repeater_mqtt | ESP32C3 / 160 MHz | 400 KB | No | 4 MB | SX1268 | None | No | Yes | headless | | ThinkNode_M5 | ESP32S3 / 240 MHz | 512 KB | No | 4MB | SX1262 | E-paper (GxEPD) | Yes | Yes | low-power display, GPS |
| Heltec_ct62_repeater_mqtt | ESP32C3 / 160 MHz | 400 KB | No | 4 MB | SX1262 | None | No | Yes | headless | | WHY2025_badge | ESP32C6 / 160 MHz | 512 KB | No | 4 MB | SX1262 | None | No | Yes | headless |
| Xiao_S3_WIO_repeater_mqtt | ESP32S3 / 240 MHz | 512 KB | No | 8 MB | SX1262 | None | Yes | Yes | headless, GPS | | Xiao_C3 | ESP32C3 / 160 MHz | 400 KB | No | 4 MB | SX1262 | None | Yes | No | headless, GPS, web panel off |
| Generic_E22_sx1262_repeater_mqtt | ESP32 / 240 MHz | 520 KB | No | 4 MB | SX1262 | None | No | Yes | headless | | Xiao_C6 | ESP32C6 / 160 MHz | 512 KB | No | 4 MB | SX1262 | None | No | Yes | headless |
| Generic_E22_sx1268_repeater_mqtt | ESP32 / 240 MHz | 520 KB | No | 4 MB | SX1268 | None | No | Yes | headless | | Xiao_S3_WIO | ESP32S3 / 240 MHz | 512 KB | No | 8 MB | SX1262 | None | Yes | Yes | headless, GPS |
## `companion_radio_wifi` Boards With A Display ## `companion_radio_wifi` Boards With A Display
This table only includes Wi-Fi companion envs that actually have a display configured. Headless Wi-Fi companion envs such as `Xiao_C3_companion_radio_wifi` are intentionally excluded here. These are the Wi-Fi companion targets that have a display configured for local status, setup help, or occasional direct interaction.
| Env | CPU | RAM | PSRAM | Flash | LoRa | Display | GPS | Notes | | Target | CPU | RAM | PSRAM | Flash | LoRa | Display | GPS | Notes |
| --------------------------------------------- | ----------------- | ------ | ----------------------- | ----- | ------ | --------------- | --- | ------------------------------------ | | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| heltec_tracker_v2_companion_radio_wifi | ESP32S3 / 240 MHz | 512 KB | No | 8MB | SX1262 | TFT (ST7735) | Yes | richer UI, GPS | | Heltec_v2 | ESP32 / 240 MHz | 520 KB | No | 8 MB | SX1276 | OLED (SSD1306) | No | |
| Heltec_v2_companion_radio_wifi | ESP32 / 240 MHz | 520 KB | No | 8 MB | SX1276 | OLED (SSD1306) | No | | | Heltec_v3 | ESP32S3 / 240 MHz | 512 KB | No | 8 MB | SX1262 | OLED (SSD1306) | Yes | GPS |
| Heltec_v3_companion_radio_wifi | ESP32S3 / 240 MHz | 512 KB | No | 8 MB | SX1262 | OLED (SSD1306) | Yes | GPS | | heltec_tracker_v2 | ESP32S3 / 240 MHz | 512 KB | No | 8MB | SX1262 | TFT (ST7735) | Yes | richer UI, GPS |
| heltec_v4_companion_radio_wifi | ESP32S3 / 240 MHz | 512 KB | 2 MB | 16MB | SX1262 | OLED (SSD1306) | Yes | GPS, more memory headroom | | heltec_v4 | ESP32S3 / 240 MHz | 512 KB | 2 MB | 16MB | SX1262 | OLED (SSD1306) | Yes | GPS, more memory headroom |
| heltec_v4_tft_companion_radio_wifi | ESP32S3 / 240 MHz | 512 KB | 2 MB | 16MB | SX1262 | TFT (ST7789) | Yes | richer UI, GPS, more memory headroom | | heltec_v4_tft | ESP32S3 / 240 MHz | 512 KB | 2 MB | 16MB | SX1262 | TFT (ST7789) | Yes | richer UI, GPS, more memory headroom |
| LilyGo_TBeam_1W_companion_radio_wifi | ESP32S3 / 240 MHz | 512 KB | Yes (size not declared) | 16MB | SX1262 | OLED (SH1106) | Yes | GPS, more memory headroom | | LilyGo_TBeam_1W | ESP32S3 / 240 MHz | 512 KB | Yes (size not declared) | 16MB | SX1262 | OLED (SH1106) | Yes | GPS, more memory headroom |
| LilyGo_TLora_V2_1_1_6_companion_radio_wifi | ESP32 / 240 MHz | 520 KB | No | 4 MB | SX1276 | OLED (SSD1306) | Yes | GPS | | LilyGo_TLora_V2_1_1_6 | ESP32 / 240 MHz | 520 KB | No | 4 MB | SX1276 | OLED (SSD1306) | Yes | GPS |
| nibble_screen_connect_companion_radio_wifi | ESP32S3 / 240 MHz | 512 KB | No | 4MB | SX1262 | OLED (SSD1306) | No | | | nibble_screen_connect | ESP32S3 / 240 MHz | 512 KB | No | 4MB | SX1262 | OLED (SSD1306) | No | |
| Station_G2_companion_radio_wifi | ESP32S3 / 240 MHz | 512 KB | Yes (size not declared) | 16MB | SX1262 | OLED (SH1106) | Yes | GPS, more memory headroom | | Station_G2 | ESP32S3 / 240 MHz | 512 KB | Yes (size not declared) | 16MB | SX1262 | OLED (SH1106) | Yes | GPS, more memory headroom |
| T_Beam_S3_Supreme_SX1262_companion_radio_wifi | ESP32S3 / 240 MHz | 512 KB | 8 MB | 8MB | SX1262 | OLED (SH1106) | Yes | GPS, more memory headroom | | T_Beam_S3_Supreme_SX1262 | ESP32S3 / 240 MHz | 512 KB | 8 MB | 8MB | SX1262 | OLED (SH1106) | Yes | GPS, more memory headroom |
| ThinkNode_M2_companion_radio_wifi | ESP32S3 / 240 MHz | 512 KB | No | 4MB | SX1262 | OLED (SH1106) | No | | | ThinkNode_M2 | ESP32S3 / 240 MHz | 512 KB | No | 4MB | SX1262 | OLED (SH1106) | No | |
| ThinkNode_M5_companion_radio_wifi | ESP32S3 / 240 MHz | 512 KB | No | 4MB | SX1262 | E-paper (GxEPD) | Yes | low-power display, GPS | | ThinkNode_M5 | ESP32S3 / 240 MHz | 512 KB | No | 4MB | SX1262 | E-paper (GxEPD) | Yes | low-power display, GPS |
## `companion_radio_wifi` Headless Boards
These are the Wi-Fi companion targets that rely on the companion app as the primary interface. For many users, this is the best everyday option.
| Target | CPU | RAM | PSRAM | Flash | LoRa | GPS | Notes |
| --- | --- | --- | --- | --- | --- | --- | --- |
| Heltec_WSL3 | ESP32S3 / 240 MHz | 512 KB | No | 8 MB | SX1262 | Yes | headless, GPS |
| RAK_3112 | ESP32S3 / 240 MHz | 512 KB | No | 8 MB | SX1262 | Yes | headless, GPS |
| Xiao_C3 | ESP32C3 / 160 MHz | 400 KB | No | 4 MB | SX1262 | Yes | smallest headless option, web panel off |
| Xiao_S3_WIO | ESP32S3 / 240 MHz | 512 KB | No | 8 MB | SX1262 | Yes | headless, GPS |
## Practical Picks ## Practical Picks
@@ -84,4 +112,5 @@ This table only includes Wi-Fi companion envs that actually have a display confi
- Best low-power display MQTT builds: `Heltec_E213_repeater_mqtt`, `Heltec_E290_repeater_mqtt`, `Heltec_Wireless_Paper_repeater_mqtt`, `ThinkNode_M5_Repeater_mqtt`. - Best low-power display MQTT builds: `Heltec_E213_repeater_mqtt`, `Heltec_E290_repeater_mqtt`, `Heltec_Wireless_Paper_repeater_mqtt`, `ThinkNode_M5_Repeater_mqtt`.
- Best companion choices if you want the richest local UI: `heltec_v4_tft_companion_radio_wifi` and `heltec_tracker_v2_companion_radio_wifi`. - Best companion choices if you want the richest local UI: `heltec_v4_tft_companion_radio_wifi` and `heltec_tracker_v2_companion_radio_wifi`.
- Best companion choices if you want maximum memory headroom: `T_Beam_S3_Supreme_SX1262_companion_radio_wifi`, `heltec_v4_companion_radio_wifi`, `heltec_v4_tft_companion_radio_wifi`, `Station_G2_companion_radio_wifi`. - Best companion choices if you want maximum memory headroom: `T_Beam_S3_Supreme_SX1262_companion_radio_wifi`, `heltec_v4_companion_radio_wifi`, `heltec_v4_tft_companion_radio_wifi`, `Station_G2_companion_radio_wifi`.
- Best companion choices if you are happy with an app-first, mostly headless setup: `Xiao_C3_companion_radio_wifi`, `RAK_3112_companion_radio_wifi`, `Xiao_S3_WIO_companion_radio_wifi`, `Station_G2_companion_radio_wifi`.
- Best companion choices if you prefer OLED over TFT: `T_Beam_S3_Supreme_SX1262_companion_radio_wifi`, `heltec_v4_companion_radio_wifi`, `LilyGo_TBeam_1W_companion_radio_wifi`. - Best companion choices if you prefer OLED over TFT: `T_Beam_S3_Supreme_SX1262_companion_radio_wifi`, `heltec_v4_companion_radio_wifi`, `LilyGo_TBeam_1W_companion_radio_wifi`.
docs/index.md
+5
Просмотреть файл
@@ -6,6 +6,11 @@ MeshCore-EastMesh keeps the upstream MeshCore firmware intact and adds an EastMe
- `companion_radio_wifi` builds for Wi-Fi-connected companion devices - `companion_radio_wifi` builds for Wi-Fi-connected companion devices
- EastMesh-specific release automation and versioning on top of upstream MeshCore releases - EastMesh-specific release automation and versioning on top of upstream MeshCore releases
If you are just trying to pick a board or download firmware, start with:
- [Compare Boards](./boards.md)
- [Download and Flash Releases](./releases.md)
## End User Guides ## End User Guides
- [Compare Boards](./boards.md) - [Compare Boards](./boards.md)
docs/local-builds.md
+52 -42
Просмотреть файл
@@ -2,6 +2,8 @@
This repo uses `uv` for Python tooling and runs PlatformIO through `uv run`. This repo uses `uv` for Python tooling and runs PlatformIO through `uv run`.
This page is for building from source. If you just want firmware to flash, start with [Download and Flash Releases](./releases.md) instead.
## Setup ## Setup
From the repo root: From the repo root:
@@ -60,65 +62,73 @@ This produces versioned artifacts in `out/`.
## Supported `repeater_mqtt` Boards ## Supported `repeater_mqtt` Boards
These are the full PlatformIO env names used for local source builds and release artifact naming.
```text ```text
T_Beam_S3_Supreme_SX1262_repeater_mqtt
LilyGo_TLora_V2_1_1_6_repeater_mqtt
LilyGo_TBeam_1W_repeater_mqtt
Xiao_C3_repeater_mqtt
RAK_3112_repeater_mqtt
Tbeam_SX1262_repeater_mqtt
Heltec_E290_repeater_mqtt
Tbeam_SX1276_repeater_mqtt
Heltec_E213_repeater_mqtt
Heltec_Wireless_Tracker_repeater_mqtt
M5Stack_Unit_C6L_repeater_mqtt
LilyGo_TDeck_repeater_mqtt
Station_G2_repeater_mqtt
Station_G2_logging_repeater_mqtt
LilyGo_T3S3_sx1262_repeater_mqtt
Meshadventurer_sx1262_repeater_mqtt
Meshadventurer_sx1268_repeater_mqtt
Heltec_Wireless_Paper_repeater_mqtt
heltec_v4_repeater_mqtt
heltec_v4_tft_repeater_mqtt
heltec_tracker_v2_repeater_mqtt
Heltec_v3_repeater_mqtt
Heltec_WSL3_repeater_mqtt
LilyGo_T3S3_sx1276_repeater_mqtt
Heltec_v2_repeater_mqtt
nibble_screen_connect_repeater_mqtt
Tenstar_C3_sx1262_repeater_mqtt
Tenstar_C3_sx1268_repeater_mqtt
Heltec_ct62_repeater_mqtt
Xiao_S3_WIO_repeater_mqtt
Generic_E22_sx1262_repeater_mqtt Generic_E22_sx1262_repeater_mqtt
Generic_E22_sx1268_repeater_mqtt Generic_E22_sx1268_repeater_mqtt
Heltec_ct62_repeater_mqtt
Heltec_E213_repeater_mqtt
Heltec_E290_repeater_mqtt
Heltec_T190_repeater_mqtt
heltec_tracker_v2_repeater_mqtt
Heltec_v2_repeater_mqtt
Heltec_v3_repeater_mqtt
heltec_v4_repeater_mqtt
heltec_v4_tft_repeater_mqtt
Heltec_Wireless_Paper_repeater_mqtt
Heltec_Wireless_Tracker_repeater_mqtt
Heltec_WSL3_repeater_mqtt
LilyGo_T3S3_sx1262_repeater_mqtt
LilyGo_T3S3_sx1276_repeater_mqtt
LilyGo_TBeam_1W_repeater_mqtt
LilyGo_TDeck_repeater_mqtt
LilyGo_Tlora_C6_repeater_mqtt
LilyGo_TLora_V2_1_1_6_repeater_mqtt
M5Stack_Unit_C6L_repeater_mqtt
Meshadventurer_sx1262_repeater_mqtt
Meshadventurer_sx1268_repeater_mqtt
Meshimi_repeater_mqtt
nibble_screen_connect_repeater_mqtt
RAK_3112_repeater_mqtt
Station_G2_logging_repeater_mqtt
Station_G2_repeater_mqtt
T_Beam_S3_Supreme_SX1262_repeater_mqtt
Tbeam_SX1262_repeater_mqtt
Tbeam_SX1276_repeater_mqtt
Tenstar_C3_sx1262_repeater_mqtt
Tenstar_C3_sx1268_repeater_mqtt
WHY2025_badge_repeater_mqtt
Xiao_C3_repeater_mqtt
Xiao_C6_repeater_mqtt
Xiao_S3_WIO_repeater_mqtt
``` ```
Notes: Notes:
- some `*_repeater_mqtt_` experimental C6-style envs exist in the repo but are not listed here as primary EastMesh targets
- `Xiao_C3_repeater_mqtt` disables the web panel to stay within flash limits - `Xiao_C3_repeater_mqtt` disables the web panel to stay within flash limits
## Supported `companion_radio_wifi` Boards ## Supported `companion_radio_wifi` Boards
These are the full PlatformIO env names used for local source builds and release artifact naming.
```text ```text
Xiao_S3_WIO_companion_radio_wifi
Heltec_v3_companion_radio_wifi
Heltec_WSL3_companion_radio_wifi
LilyGo_TBeam_1W_companion_radio_wifi
RAK_3112_companion_radio_wifi
LilyGo_TLora_V2_1_1_6_companion_radio_wifi
ThinkNode_M5_companion_radio_wifi
Xiao_C3_companion_radio_wifi
heltec_tracker_v2_companion_radio_wifi heltec_tracker_v2_companion_radio_wifi
Heltec_v2_companion_radio_wifi
Heltec_v3_companion_radio_wifi
heltec_v4_companion_radio_wifi heltec_v4_companion_radio_wifi
heltec_v4_tft_companion_radio_wifi heltec_v4_tft_companion_radio_wifi
Station_G2_companion_radio_wifi Heltec_WSL3_companion_radio_wifi
ThinkNode_M2_companion_radio_wifi LilyGo_TBeam_1W_companion_radio_wifi
LilyGo_TLora_V2_1_1_6_companion_radio_wifi
nibble_screen_connect_companion_radio_wifi nibble_screen_connect_companion_radio_wifi
Heltec_v2_companion_radio_wifi RAK_3112_companion_radio_wifi
Station_G2_companion_radio_wifi
T_Beam_S3_Supreme_SX1262_companion_radio_wifi T_Beam_S3_Supreme_SX1262_companion_radio_wifi
ThinkNode_M2_companion_radio_wifi
ThinkNode_M5_companion_radio_wifi
Xiao_C3_companion_radio_wifi
Xiao_S3_WIO_companion_radio_wifi
``` ```
## Companion WiFi CLI ## Companion WiFi CLI
variants/eastmesh_mqtt/platformio.ini
+515 -515
Просмотреть файл
Разница между файлами не показана из-за своего большого размера Загрузить разницу