BoxOnPost
Heltec V3
Heltec · flashes from your browser

BoxOnPost for the Heltec V3

BoxOnPost pages on the radio's screen · holds 50 messages.

TESTED v0.7.3

BoxOnPost v0.7.3 includes MeshCore 1.18.0. Installing it replaces the firmware on your radio with this version.

Brand-new radio, or coming from Meshtastic?

No need to install anything else first. Click Flash below and tick “Erase device” when it asks: you get a clean BoxOnPost install with MeshCore built in. Then pair it with the free MeshCore app.

Already on MeshCore or BoxOnPost? Leave “Erase device” unticked and your identity, contacts and settings are kept.

1

Back up your private key

Installing keeps your identity, contacts and settings. The backup is a safety net in case something goes wrong.

In the MeshCore app, open Settings and choose Export private key. Keep it somewhere private, like a password manager, and never share it. Also screenshot your radio settings and note any private channels. Full backup steps.

2

Flash it from your browser

TESTED This version has been run on real radios.

This browser can't flash radios. Use Chrome or Edge on a computer, or download the file below.Flashing needs a secure (https) page. Open https://boxonpost.com and try again.

Plug the radio into this computer with a USB data cable first. Works in Chrome or Edge on Windows, Mac, Linux and Chromebook.

Prefer to download the file? heltec_v3_companion_radio_ble-v1.18.0-BOP-0.7.3-UPDATE.bin

The Bluetooth version, for the phone app. It's an UPDATE file: it replaces the firmware and keeps your identity, contacts and settings. Install it at flasher.meshcore.io → Custom Firmware, with “Erase device” unticked.

3

What happens when you click Flash

  1. Click the Flash button above and pick your radio's port in the pop-up (it may be named USB JTAG, CP210x or similar).
  2. Already on MeshCore or BoxOnPost? When it asks “Erase device?”, leave it unticked. That keeps your identity, contacts and settings.
  3. Brand-new or wiped radio? Tick “Erase device” for a clean start.
  4. Wait about a minute while it installs. Keep the cable plugged in.
  5. When it says the install is complete, press the RST button once (or unplug the radio and plug it back in). Heltec radios sometimes stay in install mode until you do. If the screen still stays blank, run Flash again with “Erase device” ticked.

Nothing happens when you click? You need Chrome or Edge on a computer; Safari, Firefox and phones can't talk to USB devices. Or use the download option above.

4

Check it worked

Reconnect the MeshCore app. In Settings the version reads v1.18.0-BOP-0.7.3, and your contacts are still there.

5

Try it

  1. Find the new pages. Short-press the button to move through the pages. After “Recent adverts” come MAILBOX, LAST TRIES, SEND NOW, CLEAR MAILBOX, HOLD MESSAGES and SIGNAL. A long press (about 1 second) uses the page you're on.
  2. Hold a message. Send a direct message to a radio that's switched off. The app says “failed”, but MAILBOX on your radio shows Held: 1.
  3. Watch it deliver. Switch the other radio back on. Within about 15 minutes (or straight away if you long-press SEND NOW) it gets the message and your screen shows Delivered.

The Guide explains every page.

Is BoxOnPost working well for you? A tip helps cover hosting and development. ☕ Support BoxOnPost

Good to know

  • The V3 holds 50 messages instead of 100 (it has less memory), and there's no USB-cable version: use the Bluetooth file.
  • Optional knob: the small-screen versions also work with a rotary knob (KY-040) for faster page turning. How to wire one.

Something went wrong?

Won't start after installing? Install the official MeshCore Companion firmware for your radio from flasher.meshcore.io (pick your radio from the list), then install the BoxOnPost file again with “Erase device” unticked. If you had to erase, import your private key to get your identity back.

Going back to official MeshCore: in the flasher, pick your radio, choose Companion Bluetooth, version 1.18.0, and flash with “Erase device” unticked. Your identity and contacts are kept, and if you come back to BoxOnPost later your held messages are still there.

Blank or broken radio: FRESH-INSTALL file
This erases everything, including your identity and contacts. Only use it on a blank radio, or one that won't start any other way. In the flasher, choose it under Custom Firmware the same way; it warns before erasing.