BoxOnPost
Heltec T114
Heltec · installs by drag and drop

BoxOnPost for the Heltec T114

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

TESTING 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 not running MeshCore yet?

Radios often arrive with other firmware (such as Meshtastic) or a factory test program. Before installing BoxOnPost, first install the official MeshCore Companion firmware for your radio from flasher.meshcore.io, connect it to the MeshCore app and make sure it works. Then come back here.

Already on MeshCore? Any recent version is fine: BoxOnPost v0.7.3 replaces it with MeshCore 1.18.0 plus the BoxOnPost features. If your radio runs a MeshCore version newer than 1.18.0, do the backup below before installing.

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

Download the file

Pick your version first.

Available after testing

This version is being tested on real radios. The download appears here once it passes.

Want to help test it? Get in touch

3

Install it

  1. Plug the radio into a computer with a USB data cable. Any computer works: Windows, Mac, Linux or a Chromebook.
  2. Double-press the reset button quickly. A USB drive appears on your computer, like a memory stick. If it doesn't, try again a little faster or slower. (Some ThinkNode models use a different button combination: check Elecrow's guide for yours.)
  3. Copy the .uf2 file you downloaded onto that drive.
  4. Wait. The drive disappears by itself and the radio restarts. Your computer may say the drive wasn't ejected properly; that's normal.
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

  • Holds 48 messages. The T114's chip has less file space than the Heltec V3/V4.

Help us test the Heltec T114

This build compiles and passes every mailbox test, but nobody has run it on a real radio yet. If you try it, please tell us what worked and send photos of anything odd. That's how it gets the Tested badge.

Something went wrong?

No USB drive appears? Try the double-press again at a different speed, use a different USB cable (it must carry data), or check Elecrow's or Heltec's guide for your model's button combination.

Going back to official MeshCore: download the official Companion .uf2 for your radio from flasher.meshcore.io or the MeshCore releases page, and copy it on the same way. Your identity and contacts are kept.