v0.3.0-alpha.0

11/10/2025•prerelease•
Verified

Downloads

LC-Alpha

heltec_v3

Download

LC-Alpha+

heltec_v3

Download

Release Notes

⚠️ BREAKING CHANGES\n\n- feat(api)!: standardize LoRa config parameters to use explicit units

  • BREAKING CHANGE: LoRa configuration JSON API now uses explicit unit suffixes
  • Changed parameter names:
    • frequency -> frequency_khz (value now in kHz instead of Hz)
    • bandwidth -> bandwidth_khz
    • tx_power -> tx_power_dbm
  • Internal storage remains in Hz for precision. Conversion happens at API boundary.
  • This makes the API self-documenting and consistent with band parameters
  • (center_khz, min_khz, max_khz, max_power_dbm).\n\n

📦 Product Models

ModelBoardHardwareDescription
LC-AlphaHeltec V31 onboard buttonPrototype with single button
LC-Alpha+Heltec V32 separate buttonsEnhanced prototype with prev/next buttons
LC-GammaLilyGO T5 ProE-paper + touchProfessional with 4.7" display

📥 Installation

Use LoRaCue Manager to flash firmware to your devices.

LoRaCue Manager provides:

  • ✅ Automatic device detection
  • ✅ One-click firmware updates
  • ✅ Integrity verification
  • ✅ Cross-platform support (Windows, macOS, Linux)

🔐 Security & Verification

All firmware binaries include:

  • ✅ SHA256 checksums for integrity verification
  • ✅ Embedded firmware manifest with board ID
  • ✅ OTA compatibility checking (prevents wrong board flashing)

🔄 Changelog

🚀 Features

  • add preset system and extended bandwidth support
  • add comprehensive parameter validation
  • add I2Console logging bridge component
  • add I2Console Wokwi chip simulation
  • add device info to advertisement service data
  • add RSA-4096 signature for manifests.json
  • add WebUI to firmware release packages

🐛 Bug Fixes

  • sign SHA256 hash in manifest signing too
  • always use GitVersion semver for release versions
  • sign SHA256 hash instead of raw data in firmware signing
  • add repository checkout to create-release job
  • handle mklittlefs directory structure in tar archive
  • improve mklittlefs installation with verification
  • remove duplicate mklittlefs installation
  • install mklittlefs inside ESP-IDF container
  • add verification and debugging for LittleFS image
  • add LittleFS image generation step
  • upgrade to Node.js 20 for Next.js compatibility
  • build WebUI inside ESP-IDF Docker container
  • use heredoc for Python script to avoid YAML issues
  • use external Python script file for mklittlefs download
  • use python instead of python3 command
  • use Python urllib for mklittlefs download
  • remove debugging commands that require unavailable tools
  • detect available tools and install mklittlefs to user bin directory
  • install wget via apt-get for mklittlefs download
  • use curl instead of wget for mklittlefs download
  • set PATH environment variable at step level for mklittlefs
  • add verbose logging and error handling to mklittlefs installation
  • ensure mklittlefs is in PATH and add fallback location check
  • correct mklittlefs download filename in release workflow
  • install mklittlefs in release workflow for WebUI build
  • resolve status bar disappearing issue
  • correct WebUI flash offset to 0x640000

🔧 Refactoring

  • clean up debug logging from UI troubleshooting
  • make manifest generation data-driven

📋 Other Changes

  • feat(api)!: standardize LoRa config parameters to use explicit units
  • chore: update build configuration and project files
  • chore: remove i2console subtree
  • Squashed 'components/i2console/' content from commit 4c6d70ec
  • chore: update GitVersion branch strategy
  • chore: add model names to sdkconfig and update footer with German flag

🛠️ Technical Details

  • ESP-IDF: v5.5
  • Build Date: 2025-11-10 15:41:23 UTC
  • Commit: 664f2df57a5f0714489d9d86bb6fcc3ee4770230
  • Branch: v0.3.0

📚 Documentation

🏙️ Made with ❤️ in Hannover 🇩🇪