github cvhviz/CAIRN experimental-heltec-v4-136
Experimental: Heltec WiFi LoRa 32 V4 (OLED) and V4 Expansion Kit — Cairn 136

pre-releaseone hour ago

Experimental builds of the Cairn companion for the Heltec WiFi LoRa 32 V4 with its OLED (the plain V4, ESP32-S3R2 with 2 MB PSRAM; not the V4-R8), from Cairn 136. Requested in #53.

This is a pre-release: devices never offer it as an update, and it may change or go away. Please report in #53 what works and what doesn't.

Two builds:

  • HeltecV4: the V4 on its own. It runs on at least one V4 (updated over Cairn 107). Another V4 stops on "Loading..." after a fresh install, and we're looking into it in #53: a serial log from power-on helps most.
  • HeltecV4ExpKit, new: the V4 in Heltec's non-touch Expansion Kit (glass front, the V4's own OLED). The same companion, plus the kit's BME280 and GXHTC3 sensors (on SDA 4 / SCL 3; their readings reach the app as telemetry) and its buzzer on GPIO 6 for message and startup tones. Menu › Settings › Sound turns it off and on (hold the button on the row); a muted icon shows next to the battery. Not run on a kit yet. Not for the touch kits, which have their own builds in the release.

What both have (as the V4-R8 OLED companion in the release):

  • The one-button interface (click, hold and double-click on the PRG button) on the 128x64 OLED. New in 136: with a two-digit hour, AM/PM sits under the date instead of running into it.
  • The phone app over Bluetooth (PIN 123456 until you change it) and over Wi-Fi at the same time (TCP port 5000). Wi-Fi stays off until you set a network: Menu › Wi-Fi, Menu › Settings › Wi-Fi setup (from your phone's browser), or the app's CLI (set wifi.ssid / set wifi.pwd).
  • GPS, the band scope and noise floor, and MeshCore 1.18.0 underneath.

Install

The easiest way is the browser installer at https://www.cvhvisuals.com/cairn-install.html (Chrome or Edge on a computer): pick Experimental › WiFi LoRa 32 V4, or WiFi LoRa 32 V4 · Expansion Kit for the kit. It writes the right file at the right address for you.

By hand, pick the file that matches where your flasher writes:

  • …-ble-full.bin at 0x0, after Erase Flash (a web flasher set to 0x0, or esptool.py write_flash 0x0 <file>). It erases everything, so back up your node's private key from the app first if you want to keep your identity.
  • …-ble-update.bin at 0x10000, without erasing, over Cairn already on the board. Your identity, contacts and settings stay.

A -full.bin written at 0x10000 does not start: the board loops or stays on a blank screen. If your flasher always writes at 0x10000, use the -update.bin.

Not for the V4-R8 (use MeshCore-HeltecV4R8-…-ble-full.bin from the release) or the touch kits. The MeshCore-HeltecV4-…-repeater files in the release are the repeater, not this companion.

SHA256SUMS.txt covers all four files: shasum -a 256 -c SHA256SUMS.txt.

Don't miss a new CAIRN release

NewReleases is sending notifications on new releases.