CubeCell MeshCore
ForkA 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
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
- 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-21v0.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.
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_CTLcircuit 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
radiostatscommand - Noise floor, last RSSI/SNR, airtime TX/RX (serial + remote)packetstatscommand - Packet breakdown: flood/direct RX/TX (serial + remote)lifetimecommand - Now available via remote CLI (was serial-only)tempradiocommand - 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
- Battery ADC fixed - Resolved 0V battery reading caused by
CubeCell framework 1.6.0 bug (ch3 SAR calibration not initialized).
New workaround uses
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.zipand flash using CubeCellTool or PlatformIO.See
INSTALL.mdfor detailed instructions.Hardware
- Heltec CubeCell HTCC-AB01
- Flash: 95.8% used
- RAM: 51.1% used
Device compatibility (1)
| Device | MCU | Radio | Status | Notes |
|---|---|---|---|---|
| Heltec CubeCell HTCC-AB01 | stm32wl | Semtech SX1262 | ✓ Supported |