NeonPocketMC

One bright interface for pocket-sized MeshCore radios.

One release catalog for the NeonPocketMC firmware family. This repository pins the exact released source for every supported RadioCore build and links to each product-owned download.

Choose by exact hardware and role. There is no universal image. Never cross-flash RC52, RCC6, Heltec V3, or Heltec V4 firmware. Attach a suitable LoRa antenna before transmitting.

Demo-scene boot

The TFT builds open with a 3.2-second procedural NeonPocketMC sequence: vector-pocket reveal, mesh nodes, chromatic title glitch, star field, raster beam, specular sweep, staged link status, and a final MESH READY lockup. This GIF contains 27 checksum-verified frames captured directly from the RCC6 framebuffer—not a mockup. RC52 companions and TFT Room Servers use the same visual language with role-specific status text.

Capture provenance and checksums are recorded in docs/images/demoscene/README.md.

Live RCC6 UI

These are direct, pixel-for-pixel captures of the 220×128 framebuffer running on an RCC6—not mockups. They were captured from a temporary diagnostics build based on the exact v1.2.0-rc.1 source; the capture hook is not included in public firmware.

Home	Nearby
Radio statistics	Mesh advert
One-button Quick Reply	Diagnostics
Power confirmation

Capture provenance and checksums are recorded in docs/images/rcc6-ui/README.md.

Live Heltec OLED UI

These frames were captured from the OLED framebuffer running on the physical Heltec V3 qualification unit. The Heltec V4 uses the same compact NeonPocket interaction model with its own board and radio-power implementation.

Home	Bluetooth
Advert	Power

Heltec V4/V4.3

Home	Nearby
Radio	Bluetooth
Advert	Power

Capture provenance and checksums are recorded with each device gallery under docs/images.

Current builds

Each product release is pinned to an exact source commit and artifact checksum in catalog.json. Board-specific bootloaders, partitions, displays, and radio power paths remain separate.

Hardware	Role	Current release	Normal install
Heltec WiFi LoRa 32 V3 + OLED	BLE companion with NeonPocket UI	v1.0.0-rc.1	Flash the app .bin at 0x10000
Heltec WiFi LoRa 32 V4 + OLED	BLE companion with NeonPocket UI	v1.0.0-rc.1	Flash the app .bin at 0x10000
RC52-L62 + NV3001B TFT	BLE companion with NeonPocket UI	v1.1.0-rc.2	Copy the companion .uf2 to the RC52 bootloader drive
RC52-L62	Headless low-power repeater	v1.1.0-rc.2	Copy the repeater .uf2 to the RC52 bootloader drive
RC52-L62	Headless Room Server	v1.1.0-rc.2	Copy the headless Room Server .uf2
RC52-L62 + NV3001B TFT	Room Server with local dashboard	v1.1.0-rc.2	Copy the TFT Room Server .uf2
RCC6 + NV3001B TFT	BLE companion or Wi-Fi Web/AP companion	v1.2.0-rc.2	Flash the selected app .bin at 0x10000
RCC6	MQTT observer/repeater with setup WebUI	v1.1.0-rc.2	Flash the repeater app at 0x10000, then run the configurator
RCC6, TFT optional	Minimal or full Room Server	v1.1.0-rc.2	Pick minimal/full and headless/TFT, then flash its app at 0x10000

The RCC6 MQTT observer/repeater defaults to 3-byte packet hash mode. Its WebUI and Windows/Linux configurator cover node name, radio preset and custom radio values, Wi-Fi, MQTT broker selection, and post-setup IP discovery. The preferred public brokers are mqtt1.meshcore.ca and mqtt2.meshcore.ca; the other upstream-compatible brokers remain selectable/configurable.

Download the suite

Use the newest NeonPocketMC suite release as the index. It carries the machine-readable catalog and checksum for the catalog; the product repositories above remain the single owners of their firmware binaries and setup packages.

Exact install filenames, sizes, SHA-256 values, release links, and source commits for all 28 installable files are recorded in catalog.json.

Source layout

The six firmware histories intentionally remain separate because they target different chips, bootloaders, transports, displays, and deployment roles. This repository indexes them as pinned Git submodules:

firmware/
  heltec-v3-companion/
  heltec-v4-companion/
  rc52-companion/
  rc52-repeater/
  rcc6-companion/
  rcc6-mqtt-repeater/

Clone the exact suite source with:

git clone --recurse-submodules https://github.com/n30nex/NeonPocketMC.git

If already cloned:

git submodule update --init --recursive

Important hardware notes

• RC52: use the UF2 bootloader path for normal installs. Do not replace the SoftDevice or bootloader.
• Heltec V3/V4: use the matching app image at 0x10000 for normal updates. Do not erase the whole flash; full-chip backups can contain private MeshCore identity material.
• RCC6: use the app image at 0x10000 for normal updates. Use a merged recovery image at 0x0 only when bootloader/partition recovery is required. Do not erase the whole flash.
• RCC6 merged recovery images stop well before SPIFFS and preserve MeshCore identity, contacts, channels, and preferences; they reset NVS-backed BLE bonds and saved Wi-Fi.
• The RC52 and RCC6 boards do not contain an MPPT controller suitable for an unregulated solar panel. Outdoor solar installs need an external regulator/charger matched to the panel and protected 1-cell battery.
• These are community prereleases, not official Heltec or MeshCore firmware.

See FLASHING.md for practical install and recovery instructions.

Room Server profiles, animated companion startup, RCC6 Diagnostics, and one-button Quick Reply are now shipped as prerelease candidates. Remaining improvements are tracked in docs/STACK_ROADMAP.md.

Verification

scripts/verify_catalog.py confirms each Git submodule pin, release URL, digest, and catalog invariant. Product repositories retain their own exact-target build workflows and hardware-specific release evidence.

Root documentation and catalog code are MIT licensed. Each firmware submodule retains its own upstream and third-party licenses.