MeshCore Ninja
← All firmwares

CubeCell MeshCore

Fork

A minimal MeshCore-compatible repeater firmware for Heltec CubeCell boards (HTCC-AB01, AB02, AC01). Extends mesh coverage with flood routing, supports authenticated remote management via companion app, and includes automatic daily health reports. Optimized for solar-powered deployments.

Fork of MeshCore (Official)

Maintainer
atomozero ↗
Status
active
Maturity
beta
Lifecycle
active
Latest version
0.5.0
Released
2026-02-14
Runtime
Arduino · C++
Distribution
community
License
MIT

Capabilities

Transports

  • BLE
  • USB serial
  • Native TCP
  • Wi-Fi AP

Operations

  • Web flasher
  • OTA updates

Networking

  • Repeater
  • Room server
  • Observer
  • KISS modem

Hardware

  • GPS
  • Display
  • Sensors
  • Low-power RX

Protocol

  • MeshCore compatible

Node roles

repeater

Features

  • Flood routing repeater
  • Authenticated remote management via companion app
  • Automatic daily health reports
  • Solar-powered optimization
  • CubeCell board support (HTCC-AB01, AB02, AC01)

Project signals

popularity 2026-06-21 verification 2026-06-21
GitHub stars
13
Forks
1
Watchers
3
Open issues
5
Contributors
2
Release downloads
79
Latest downloads
49
Source available
Yes
Releases available
Yes
CI builds
No

Releases

from GitHub · updated 2026-06-21
  1. v0.5.0 # Latest 4 months ago · 2026-02-14 16:53 UTC

    Quiet Hours + Circuit Breaker + Adaptive TX Power

    Three new features leveraging the existing SNR/RSSI infrastructure to improve reliability, power savings, and mesh network resilience.

    • Quiet Hours — Configurable night-time rate limiting (e.g. 22:00-06:00) reduces forwarding from 100 to 30 packets/min. Saves battery during low-traffic periods. Requires TimeSync.

    • Circuit Breaker — Automatically blocks DIRECT forwarding to neighbours with degraded links (SNR < -10dB). Transitions to half-open after 5 minutes for a test packet. Good SNR closes the breaker. FLOOD traffic is never blocked.

    • Adaptive TX Power — Dynamically adjusts transmit power (5-14 dBm EU) based on average neighbour SNR. Reduces power when signal is strong, increases when weak.

  2. v0.4.0 # 4 months ago · 2026-02-09 22:23 UTC

    What's New in v0.4.0

    Bug Fixes

    • Battery ADC fixed - Resolved 0V battery reading caused by CubeCell framework 1.6.0 bug (ch3 SAR calibration not initialized). New workaround uses analogRead() + ch0 calibration + VBAT_ADC_CTL circuit control
    • Airtime tracking - RX/TX airtime now properly calculated per-packet using LoRa formula
    • Noise floor estimation - EMA-smoothed noise floor from RSSI-SNR, no longer stuck at 0dB
    • Remote CLI commands - Fixed "Err:Unknown" for commands only available on local serial

    New Features

    • radiostats command - Noise floor, last RSSI/SNR, airtime TX/RX (serial + remote)
    • packetstats command - Packet breakdown: flood/direct RX/TX (serial + remote)
    • lifetime command - Now available via remote CLI (was serial-only)
    • tempradio command - Temporary radio parameter changes without saving to EEPROM

    Optimizations

    • Flash savings: 2,904 bytes - String abbreviation in LOG/LOG_RAW macros (98.3% → 96.0%)
    • Startup banner simplified (removed unicode box-drawing characters)

    Documentation

    • Complete command reference tables in README
    • Corrected radio parameters (frequency, TX power, sync word)

    Build Info

    • Flash: 96.5% (126,492 / 131,072 bytes)
    • RAM: 51.3% (8,408 / 16,384 bytes)
    • Board: Heltec CubeCell HTCC-AB01
    • Region: EU868
  3. v0.3.3 # 5 months ago · 2026-01-23 21:37 UTC

    Features

    • MeshCore Protocol Compatible - Works with MeshCore Android/iOS apps
    • Ed25519 Authentication - Secure login with encrypted sessions
    • Rate Limiting - Protection against brute-force and flood attacks
    • Persistent Statistics - Lifetime stats survive reboots (EEPROM)
    • Neighbour Tracking - Direct repeater discovery via 0-hop ADVERTs
    • Remote CLI - Encrypted command access via mesh network
    • Deep Sleep - Low power mode support

    What's New in v0.3.3

    • Added persistent statistics stored in EEPROM
    • Tracks lifetime: RX/TX/FWD packets, unique nodes, logins, uptime
    • Auto-save every 5 minutes with CRC16 integrity
    • New commands: lifetime, savestats
    • Boot counter for reliability monitoring

    Installation

    Download CubeCellMeshCore-v0.3.3.zip and flash using CubeCellTool or PlatformIO.

    See INSTALL.md for detailed instructions.

    Hardware

    • Heltec CubeCell HTCC-AB01
    • Flash: 95.8% used
    • RAM: 51.1% used

Device compatibility (1)

✓ 1 Supported
DeviceMCURadioStatusNotes
Heltec CubeCell HTCC-AB01stm32wlSemtech SX1262✓ Supported