Skip to content

Catalog Heltec V3/V4 Ultimate v2 releases #20

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
n30nex merged 1 commit into from
Aug 23, 2026
Merged

Catalog Heltec V3/V4 Ultimate v2 releases #20

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -148,8 +148,8 @@ Each product release is pinned to an exact source commit and artifact checksum i

| Hardware | Role | Current release | Normal install |
|---|---|---|---|
| Heltec WiFi LoRa 32 V3 + OLED | BLE or native-USB companion with NeonPocket UI | [v1.0.0-rc.3](https://github.com/n30nex/NeonPocketMC-Heltec-V3/releases/tag/v1.0.0-rc.3) | Flash the selected app `.bin` at `0x10000` |
| Heltec WiFi LoRa 32 V4 + OLED | BLE or native-USB companion with NeonPocket UI | [v1.0.0-rc.3](https://github.com/n30nex/NeonPocketMC-Heltec-V4/releases/tag/v1.0.0-rc.3) | Flash the selected app `.bin` at `0x10000` |
| Heltec WiFi LoRa 32 V3 + OLED | BLE, native-USB, Ultimate Web companion, or Ultimate Repeater WebUI | [v2.0.0-rc.1](https://github.com/n30nex/NeonPocketMC-Heltec-V3/releases/tag/v2.0.0-rc.1) | Flash the selected app `.bin` at `0x10000` |
| Heltec WiFi LoRa 32 V4 + OLED | BLE, native-USB, Ultimate Web companion, or Ultimate Repeater WebUI | [v2.0.0-rc.1](https://github.com/n30nex/NeonPocketMC-Heltec-V4/releases/tag/v2.0.0-rc.1) | Flash the selected app `.bin` at `0x10000` |
Comment on lines +151 to +152

@chatgpt-codex-connector chatgpt-codex-connector Bot Aug 23, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Update the flashing guide for the new Heltec modes

For users following the repository's manual-install path, these rows now advertise Ultimate BLE/Web/repeater modes, but FLASHING.md:21-31 still states that each Heltec release offers only BLE and native-USB images and provides no selection or onboarding guidance for the new Wi-Fi modes. Update that section with the new filenames/modes and any required Web companion or repeater setup so the release documentation is internally consistent.

AGENTS.md reference: AGENTS.md:L40-L43

Useful? React with 👍 / 👎.

| RC52-L62 + NV3001B TFT | BLE or native-USB companion with NeonPocket UI | [v1.1.0-rc.4](https://github.com/n30nex/NeonPocketMC-RC52/releases/tag/v1.1.0-rc.4) | Copy the selected `.uf2` to the RC52 bootloader drive |
| RC52-L62 without TFT | Screenless BLE companion; pairing PIN `123456` | [v1.0.0-rc.1](https://github.com/n30nex/NeonPocketMC-RC52-Headless/releases/tag/v1.0.0-rc.1) | Copy the BLE `.uf2` to the RC52 bootloader drive |
| RC52-L62 | Headless low-power repeater | [v1.1.0-rc.2](https://github.com/n30nex/NeonPocketMC-RC52-Repeater/releases/tag/v1.1.0-rc.2) | Copy the repeater `.uf2` to the RC52 bootloader drive |
Expand Down
50 changes: 31 additions & 19 deletions catalog.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,39 +1,51 @@
{
"schema": 1,
"suite_version": "1.9.0-rc.2",
"suite_version": "1.10.0-rc.1",
"products": [
{
"id": "heltec-v3-companion",
"hardware": "Heltec WiFi LoRa 32 V3 with integrated 128x64 OLED",
"role": "BLE or native-USB companion with NeonPocket OLED UI",
"role": "BLE, native-USB, Ultimate Web companion, or Ultimate Wi-Fi repeater with NeonPocket OLED UI",
"repository": "https://github.com/n30nex/NeonPocketMC-Heltec-V3",
"release": "https://github.com/n30nex/NeonPocketMC-Heltec-V3/releases/tag/v1.0.0-rc.3",
"tag": "v1.0.0-rc.3",
"commit": "4c8b6d56a3976f2b34a0a70e5b5f2b9051e20e21",
"release": "https://github.com/n30nex/NeonPocketMC-Heltec-V3/releases/tag/v2.0.0-rc.1",
"tag": "v2.0.0-rc.1",
"commit": "02f8ec87a3061811d78e3b6ac3614bacd99b3b24",
"submodule": "firmware/heltec-v3-companion",
"profiles": ["ble-companion-oled", "usb-companion-oled"],
"profiles": ["ble-companion-oled", "usb-companion-oled", "ultimate-ble-companion-oled", "ultimate-web-companion-oled", "ultimate-repeater-web-oled"],
"artifacts": [
{"name": "NeonPocketMC-Heltec-V3-BLE-app.bin", "size": 1272352, "sha256": "ce7e7b3cbc56b8a984f22618aff582cf62cceec6ff6af495f493f71a9e506a15", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V3/releases/download/v1.0.0-rc.3/NeonPocketMC-Heltec-V3-BLE-app.bin"},
{"name": "NeonPocketMC-Heltec-V3-BLE-recovery-preserves-settings.bin", "size": 1337888, "sha256": "cc0253b9fb6b5164651c6c3e27fea4c57154efdf667b58356a3f147009cd28f6", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V3/releases/download/v1.0.0-rc.3/NeonPocketMC-Heltec-V3-BLE-recovery-preserves-settings.bin"},
{"name": "NeonPocketMC-Heltec-V3-USB-app.bin", "size": 645824, "sha256": "487c9a2e72702810bc6a56dc04c09b97a98222ec9c0549eade0d9617bd5ee955", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V3/releases/download/v1.0.0-rc.3/NeonPocketMC-Heltec-V3-USB-app.bin"},
{"name": "NeonPocketMC-Heltec-V3-USB-recovery-preserves-settings.bin", "size": 711360, "sha256": "dd601a8ef38817576bf49653dfa76fd05d74b53ded21759b3edfe8accef8035f", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V3/releases/download/v1.0.0-rc.3/NeonPocketMC-Heltec-V3-USB-recovery-preserves-settings.bin"}
{"name": "NeonPocketMC-Heltec-V3-BLE-app.bin", "size": 1272784, "sha256": "4abb0282a95aef240010775e432c3b20344897b5a3b76d827ee583822a17219b", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V3/releases/download/v2.0.0-rc.1/NeonPocketMC-Heltec-V3-BLE-app.bin"},
{"name": "NeonPocketMC-Heltec-V3-BLE-recovery-preserves-settings.bin", "size": 1338320, "sha256": "31312a1266f2d1e9e021b6ff142ccda0c6011f9dfbb6016dfba371cdfa0cf388", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V3/releases/download/v2.0.0-rc.1/NeonPocketMC-Heltec-V3-BLE-recovery-preserves-settings.bin"},
{"name": "NeonPocketMC-Heltec-V3-USB-app.bin", "size": 646304, "sha256": "7c57b57b796d19aed922269fdecfd03c403f3db7010d0cfb483abde9e7bdc5f0", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V3/releases/download/v2.0.0-rc.1/NeonPocketMC-Heltec-V3-USB-app.bin"},
{"name": "NeonPocketMC-Heltec-V3-USB-recovery-preserves-settings.bin", "size": 711840, "sha256": "07298e381c9280e60c91210dc4a3929bf29b7abca49068c5876a73fe67256843", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V3/releases/download/v2.0.0-rc.1/NeonPocketMC-Heltec-V3-USB-recovery-preserves-settings.bin"},
{"name": "NeonPocketMC-Heltec-V3-Ultimate-BLE-app.bin", "size": 1314640, "sha256": "df58930aab88842361f994c570ead412c6352b31bb84e0bfec38165b62c5cbcc", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V3/releases/download/v2.0.0-rc.1/NeonPocketMC-Heltec-V3-Ultimate-BLE-app.bin"},
{"name": "NeonPocketMC-Heltec-V3-Ultimate-BLE-recovery-preserves-settings.bin", "size": 1380176, "sha256": "b685e3e51f8c6e2c12c98c33e234c429d8abae26a76771ef060647756c4ef926", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V3/releases/download/v2.0.0-rc.1/NeonPocketMC-Heltec-V3-Ultimate-BLE-recovery-preserves-settings.bin"},
{"name": "NeonPocketMC-Heltec-V3-Ultimate-Web-app.bin", "size": 1251360, "sha256": "7b28b486067f8b376e76cc93091084748e49dabdf0da52e64070c219e8cf55e0", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V3/releases/download/v2.0.0-rc.1/NeonPocketMC-Heltec-V3-Ultimate-Web-app.bin"},
{"name": "NeonPocketMC-Heltec-V3-Ultimate-Web-recovery-preserves-settings.bin", "size": 1316896, "sha256": "15038e902af98972361924abb11c11e9cc101330c40b91f4efa4dd34e080f48e", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V3/releases/download/v2.0.0-rc.1/NeonPocketMC-Heltec-V3-Ultimate-Web-recovery-preserves-settings.bin"},
{"name": "NeonPocketMC-Heltec-V3-Ultimate-Repeater-Web-app.bin", "size": 1117712, "sha256": "59b96ebc918cd73a19123a4b0d785d74d5295453db6978a862099a4bfa2923ef", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V3/releases/download/v2.0.0-rc.1/NeonPocketMC-Heltec-V3-Ultimate-Repeater-Web-app.bin"},
{"name": "NeonPocketMC-Heltec-V3-Ultimate-Repeater-Web-recovery-preserves-settings.bin", "size": 1183248, "sha256": "95bb751ac6ef2d52ec8cbc263bc44e830ca436f80eb443529379ad3788d56d4e", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V3/releases/download/v2.0.0-rc.1/NeonPocketMC-Heltec-V3-Ultimate-Repeater-Web-recovery-preserves-settings.bin"}
]
},
{
"id": "heltec-v4-companion",
"hardware": "Heltec WiFi LoRa 32 V4/V4.3 with integrated 128x64 OLED",
"role": "BLE or native-USB companion with NeonPocket OLED UI",
"role": "BLE, native-USB, Ultimate Web companion, or Ultimate Wi-Fi repeater with NeonPocket OLED UI",
"repository": "https://github.com/n30nex/NeonPocketMC-Heltec-V4",
"release": "https://github.com/n30nex/NeonPocketMC-Heltec-V4/releases/tag/v1.0.0-rc.3",
"tag": "v1.0.0-rc.3",
"commit": "9e5796badca70d1eafd97c94481e646ed82422f5",
"release": "https://github.com/n30nex/NeonPocketMC-Heltec-V4/releases/tag/v2.0.0-rc.1",
"tag": "v2.0.0-rc.1",
"commit": "807efbba11dda35d3d72d0f8ee9e3a0502e24bcf",
"submodule": "firmware/heltec-v4-companion",
"profiles": ["ble-companion-oled", "usb-companion-oled"],
"profiles": ["ble-companion-oled", "usb-companion-oled", "ultimate-ble-companion-oled", "ultimate-web-companion-oled", "ultimate-repeater-web-oled"],
"artifacts": [
{"name": "NeonPocketMC-Heltec-V4-BLE-app.bin", "size": 1270048, "sha256": "d1b57b3489cc2b4b38e17b0e239e4cc270de942c97c378b85f6519691788c5dd", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V4/releases/download/v1.0.0-rc.3/NeonPocketMC-Heltec-V4-BLE-app.bin"},
{"name": "NeonPocketMC-Heltec-V4-BLE-recovery-preserves-settings.bin", "size": 1335584, "sha256": "1f91e22087a00a86d8d95d171eb4b7706b99ba8357d812b8f5d5df2bcd373a13", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V4/releases/download/v1.0.0-rc.3/NeonPocketMC-Heltec-V4-BLE-recovery-preserves-settings.bin"},
{"name": "NeonPocketMC-Heltec-V4-USB-app.bin", "size": 643536, "sha256": "f06966e1410a009da05525e32eff3461fe4e550108f0e737e5f4a8b12f68cbac", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V4/releases/download/v1.0.0-rc.3/NeonPocketMC-Heltec-V4-USB-app.bin"},
{"name": "NeonPocketMC-Heltec-V4-USB-recovery-preserves-settings.bin", "size": 709072, "sha256": "9e3ec619d0eb1e88ea7470cdf23dd237973d68e648f4eb4f9b9d61887e974931", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V4/releases/download/v1.0.0-rc.3/NeonPocketMC-Heltec-V4-USB-recovery-preserves-settings.bin"}
{"name": "NeonPocketMC-Heltec-V4-BLE-app.bin", "size": 1270544, "sha256": "1e6c6e0ea0837252e3c158fd61d14c7b7896b5c970c493c1c5011d36b7527bd8", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V4/releases/download/v2.0.0-rc.1/NeonPocketMC-Heltec-V4-BLE-app.bin"},
{"name": "NeonPocketMC-Heltec-V4-BLE-recovery-preserves-settings.bin", "size": 1336080, "sha256": "284b643ee2b8d35a622348b684406f8d68cd08247cc10e6667aa322678cd4a1a", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V4/releases/download/v2.0.0-rc.1/NeonPocketMC-Heltec-V4-BLE-recovery-preserves-settings.bin"},
{"name": "NeonPocketMC-Heltec-V4-USB-app.bin", "size": 644032, "sha256": "6e181c57d1e757ba503421c0a5f12e0ae4864da3eee0a71ce424d37950b85b48", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V4/releases/download/v2.0.0-rc.1/NeonPocketMC-Heltec-V4-USB-app.bin"},
{"name": "NeonPocketMC-Heltec-V4-USB-recovery-preserves-settings.bin", "size": 709568, "sha256": "c7b44e90b7e63cd9c575c74f6b782f7d70e269189b128869e3569e750607b54e", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V4/releases/download/v2.0.0-rc.1/NeonPocketMC-Heltec-V4-USB-recovery-preserves-settings.bin"},
{"name": "NeonPocketMC-Heltec-V4-Ultimate-BLE-app.bin", "size": 1312448, "sha256": "96a751ab782c451fcae1bac70b629e60fc8fc68f470dede17ef0d8f71bf092d5", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V4/releases/download/v2.0.0-rc.1/NeonPocketMC-Heltec-V4-Ultimate-BLE-app.bin"},
{"name": "NeonPocketMC-Heltec-V4-Ultimate-BLE-recovery-preserves-settings.bin", "size": 1377984, "sha256": "5a274d0ce789b0af0a654dedf578615c2e3efe83e118307ce0d0fca1ecf2e185", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V4/releases/download/v2.0.0-rc.1/NeonPocketMC-Heltec-V4-Ultimate-BLE-recovery-preserves-settings.bin"},
{"name": "NeonPocketMC-Heltec-V4-Ultimate-Web-app.bin", "size": 1248928, "sha256": "cee81b67cbe2a3adfcf3677733179c5d45bc00dc05458eac8280506aed57d889", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V4/releases/download/v2.0.0-rc.1/NeonPocketMC-Heltec-V4-Ultimate-Web-app.bin"},
{"name": "NeonPocketMC-Heltec-V4-Ultimate-Web-recovery-preserves-settings.bin", "size": 1314464, "sha256": "2629815dc5e69d984ccc658ab4b2627e531ebaee5dca6f533495328d94f5eec8", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V4/releases/download/v2.0.0-rc.1/NeonPocketMC-Heltec-V4-Ultimate-Web-recovery-preserves-settings.bin"},
{"name": "NeonPocketMC-Heltec-V4-Ultimate-Repeater-Web-app.bin", "size": 1115408, "sha256": "c538b931b41e0bc29feab4f2c65a9d181659534a40c0bd38b2b4ef5ab6f23671", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V4/releases/download/v2.0.0-rc.1/NeonPocketMC-Heltec-V4-Ultimate-Repeater-Web-app.bin"},
{"name": "NeonPocketMC-Heltec-V4-Ultimate-Repeater-Web-recovery-preserves-settings.bin", "size": 1180944, "sha256": "7551875a375a2fec1273b720f6244a7d27cdbecf37d633d4ccaeb71dd969b151", "url": "https://github.com/n30nex/NeonPocketMC-Heltec-V4/releases/download/v2.0.0-rc.1/NeonPocketMC-Heltec-V4-Ultimate-Repeater-Web-recovery-preserves-settings.bin"}
]
},
{
Expand Down
2 changes: 1 addition & 1 deletion firmware/heltec-v3-companion
Open in desktop
Submodule heltec-v3-companion updated 38 files
+81 −4 .github/workflows/neonpocket-build.yml
+43 −0 AGENTS.md
+24 −5 README.md
+22 −0 examples/companion_radio/AbstractUITask.h
+456 −28 examples/companion_radio/MyMesh.cpp
+33 −2 examples/companion_radio/MyMesh.h
+2 −1 examples/companion_radio/NodePrefs.h
+12 −0 examples/companion_radio/UltimateOtaPublicKey.h
+1,305 −0 examples/companion_radio/UltimateService.cpp
+394 −0 examples/companion_radio/UltimateService.h
+469 −0 examples/companion_radio/UltimateWebApi.cpp
+66 −0 examples/companion_radio/UltimateWebApi.h
+90 −0 examples/companion_radio/main.cpp
+111 −4 examples/companion_radio/ui-new/UITask.cpp
+5 −0 examples/companion_radio/webui/.gitignore
+35 −0 examples/companion_radio/webui/README.md
+3,341 −0 examples/companion_radio/webui/Rcc6WebUiAssets.h
+13 −0 examples/companion_radio/webui/THIRD_PARTY_NOTICES.md
+58 −0 examples/companion_radio/webui/build.mjs
+815 −0 examples/companion_radio/webui/package-lock.json
+16 −0 examples/companion_radio/webui/package.json
+1,426 −0 examples/companion_radio/webui/src/app.js
+262 −0 examples/companion_radio/webui/src/index.html
+301 −0 examples/companion_radio/webui/src/styles.css
+50 −0 examples/companion_radio/webui/verify.mjs
+288 −0 examples/simple_repeater/UltimateRepeaterWeb.h
+83 −0 examples/simple_repeater/main.cpp
+22 −0 scripts/ultimate_build_flags.py
+15 −0 scripts/verify_neonpocket_mono.py
+99 −0 scripts/verify_ultimate_mono.py
+4 −2 src/helpers/BaseChatMesh.cpp
+2 −2 src/helpers/BaseChatMesh.h
+34 −30 src/helpers/CommonCLI.cpp
+766 −0 src/helpers/esp32/SerialWebInterface.cpp
+135 −0 src/helpers/esp32/SerialWebInterface.h
+171 −0 tools/package_ultimate_ota.py
+3 −0 tools/ultimate_ota_public.pem
+76 −0 variants/heltec_v3/platformio.ini
2 changes: 1 addition & 1 deletion firmware/heltec-v4-companion
Open in desktop
Submodule heltec-v4-companion updated 38 files
+81 −4 .github/workflows/neonpocket-build.yml
+43 −0 AGENTS.md
+24 −5 README.md
+22 −0 examples/companion_radio/AbstractUITask.h
+456 −28 examples/companion_radio/MyMesh.cpp
+33 −2 examples/companion_radio/MyMesh.h
+2 −1 examples/companion_radio/NodePrefs.h
+12 −0 examples/companion_radio/UltimateOtaPublicKey.h
+1,305 −0 examples/companion_radio/UltimateService.cpp
+394 −0 examples/companion_radio/UltimateService.h
+469 −0 examples/companion_radio/UltimateWebApi.cpp
+66 −0 examples/companion_radio/UltimateWebApi.h
+90 −0 examples/companion_radio/main.cpp
+111 −4 examples/companion_radio/ui-new/UITask.cpp
+5 −0 examples/companion_radio/webui/.gitignore
+35 −0 examples/companion_radio/webui/README.md
+3,341 −0 examples/companion_radio/webui/Rcc6WebUiAssets.h
+13 −0 examples/companion_radio/webui/THIRD_PARTY_NOTICES.md
+58 −0 examples/companion_radio/webui/build.mjs
+815 −0 examples/companion_radio/webui/package-lock.json
+16 −0 examples/companion_radio/webui/package.json
+1,426 −0 examples/companion_radio/webui/src/app.js
+262 −0 examples/companion_radio/webui/src/index.html
+301 −0 examples/companion_radio/webui/src/styles.css
+50 −0 examples/companion_radio/webui/verify.mjs
+287 −0 examples/simple_repeater/UltimateRepeaterWeb.h
+83 −0 examples/simple_repeater/main.cpp
+22 −0 scripts/ultimate_build_flags.py
+15 −0 scripts/verify_neonpocket_mono.py
+99 −0 scripts/verify_ultimate_mono.py
+4 −2 src/helpers/BaseChatMesh.cpp
+2 −2 src/helpers/BaseChatMesh.h
+34 −30 src/helpers/CommonCLI.cpp
+766 −0 src/helpers/esp32/SerialWebInterface.cpp
+135 −0 src/helpers/esp32/SerialWebInterface.h
+171 −0 tools/package_ultimate_ota.py
+3 −0 tools/ultimate_ota_public.pem
+76 −0 variants/heltec_v4/platformio.ini
Loading