Using BoxOnPost
Everything can be checked and controlled from the node's own screen. Here's what each page does, and how to get the best delivery.
First steps
- Flash it (see Firmware) and reconnect the MeshCore app. The version reads
v1.18.0-BOP-0.7.3. - Use the app as usual. Every direct message you send is now held until it's confirmed. Channel messages work as before.
- Keep your node powered. The phone doesn't need to stay connected; the node retries on its own.
- Check the MAILBOX page on the node to see what's held and when the next try is.
The screen pages
Short press PRG for the next page. Long press (about 1 second) to use the page you're on. The BoxOnPost pages come right after Recent adverts.
| Page | Shows | Long press |
|---|---|---|
| MAILBOX | Messages held and for how many people, time to the next try, deliveries since power-on | — |
| LAST TRIES | "Got it" replies heard; then per person: held, tries, last try, last heard, last confirmation | Next person |
| SEND NOW | "Try 4 people now" | One extra try per person; schedule unchanged |
| CLEAR MAILBOX | Messages held | Asks "Delete ALL?"; a second long press within 5 s deletes them |
| HOLD MESSAGES (0.7.3) | OFF, 2 DAYS, 5 DAYS or 15 DAYS | Next choice: Off, 2, 5, 15 days, then Off again |
| SIGNAL | Last packet heard, its strength, packets in the last hour | — |
| APP NOTICES (0.6) | Whether the BoxOnPost Status channel is on | If it was deleted in the app, brings it back (then reconnect the app) |
When a held message finally gets through, the screen pops up "Delivered: name".
Buttons, touch and e-ink screens
The pages are the same on every radio with a screen. Only the way you move between them changes.
| Radio | Change page | Use the page |
|---|---|---|
| Small screen (Heltec V3, V4) | Short press PRG | Hold PRG 1 second |
| With a knob | Turn it | Push it |
| Touch screen (V4 Expansion Kit) | Tap right or swipe left: next. Tap left or swipe right: back | Hold your finger still 1 second |
| E-ink (ThinkNode M1, M5) | Short press the button | Hold it 1 second |
Beeps on or off: quickly press the main button three times (on the ThinkNode M1 it's the bottom button, not the function button). The screen shows “Buzzer: ON” or “Buzzer: OFF”, and a speaker with an X next to the battery means it's muted. The setting is kept after a restart.
Touch screen
The PRG button keeps working alongside touch. A hold does exactly what a long press does on that page, so you can, for example, hold on APP NOTICES to bring the Status channel back. Touch controls work on the V4 touch screen from version 0.6; the V4 R8 touch screen is still being tested.
E-ink screen
E-ink holds its picture without power, so BoxOnPost pages refresh every 30 seconds instead of every second. That stops constant flashing and wear. Countdowns jump rather than tick, and a page change can take a moment to draw. After a long press, wait for the screen to finish updating before pressing again.
ThinkNode M1: comes in two versions. With Screen stays on, the last page stays readable when the backlight times out, after one quick black-and-white flash that clears any ghosting. With Stock, the screen goes blank like standard MeshCore 1.18. Either way, press the button to light it up again.
Reading LAST TRIES
Each person you hold mail for gets a screen like this:
2/4 Gary | Person 2 of 4 |
Held 3, sent 7 | Messages waiting; tries since power-on |
Last: 3h, flood | When the last try went out, and how |
Heard 5m, ack - | Last heard from them; last "got it" ("-" means never) |
Tries going up, "Heard -", "ack -": nothing is coming back. They're out of range, or their replies don't reach you.
"Heard 1m" right after a try, but "ack -": they answered but the confirmation didn't match. Please report it with a photo.
"ack 2m": delivered. The held count goes down.
The counts start over at every restart.
APP NOTICES (version 0.6)
This page shows whether your radio's BoxOnPost Status channel is set up in the app:
APP NOTICES | Page title |
BoxOnPost channel: on | The channel is in your app and notes are going to it |
delete it in the app | To stop the notes, delete the channel in the MeshCore app |
If you renamed the channel in the app, it still shows on. The radio finds it by its key, not its name.
"BoxOnPost channel: off" means the channel was deleted in the app, or there was no empty channel slot for it. The bottom line then reads restore: long press.
- Long press (touch screen: hold). The screen shows Restored: reconnect app.
- Disconnect and reconnect the MeshCore app. The BoxOnPost Status channel is back.
If it says No free channel slot, all your channel slots are in use. Delete a channel you don't need in the app and try again. Your other channels are never changed.
Hold time (version 0.7.3)
The HOLD MESSAGES page sets how long your radio keeps trying a message that hasn't had a “got it”. Long press to step through Off → 2 days → 5 days → 15 days → Off. The choice is saved and kept after a restart.
- 2 days is the default on a new install. Radios updated from 0.7.x keep 5 days, the old setting.
- Off stops the retries. Messages you send are still kept (for up to 15 days), and they go out again when you pick a number of days. While it's off, the MAILBOX page shows
Next try: OFF (hold). - A shorter time takes effect about a minute after you stop pressing, so stepping past 2 days on the way to another choice doesn't throw anything away.
Add a knob (optional)
A KY-040 rotary encoder module (or a bare 20-detent EC11 with a push switch) makes the pages quicker to use. Turn to change pages; push for what a long press does.
Unplug power before wiring, and use 3V3, never 5V. Turns the wrong way? Swap CLK and DT.
| Knob | V4 / V4 R8 | V3 |
|---|---|---|
| CLK | GPIO 47 | GPIO 6 |
| DT | GPIO 48 | GPIO 7 |
| SW | GPIO 6 | GPIO 5 |
| + | 3V3 | 3V3 |
| GND | GND | GND |
Better reception, better delivery
The most common problem we've seen: your message reaches the other person, but their "got it" never gets back. BoxOnPost then sends it again later, so they may see a duplicate, and your held count doesn't drop. Usually it's about radio, not firmware:
- Get the antenna outside. A metal truck cab or a basement blocks a lot. A roof or window antenna helps more than anything else.
- Repeater owners: repeaters often only announce themselves every couple of days.
set advert.interval 60makes them visible to nearby nodes every hour. - Regions: if someone has a MeshCore region set, their replies can be dropped by repeaters not set up for it.
- Repeater clock: a repeater whose clock reset may vanish from lists. Sync its clock from the app.
Troubleshooting
Restarts every few minutes
Power banks switch off when the draw is low. Use a wall charger or a battery on the node's own connector.
App shows the official version
You picked your device instead of Custom Firmware. Flash again via Custom Firmware; held messages come back.
Won't start after flashing
This usually happens when "Erase device" was ticked with an UPDATE file. To recover, open flasher.meshcore.io, pick your device and install the official MeshCore Companion firmware. Once it starts up, install BoxOnPost's UPDATE file through Custom Firmware, with "Erase device" left unticked. The erase also wiped your contacts and settings, so you'll need to set those up again.
Can't hear anyone
Check the radio settings match your area (Canada: 910.525 MHz, 62.5 kHz, SF7, CR5), keep the antenna on, and try a higher spot.
New in version 0.7.3
- The HOLD MESSAGES page lets you choose how long messages are held: Off, 2, 5 or 15 days. See Hold time.
- New installs hold for 2 days. Radios updated from 0.7, 0.7.1 or 0.7.2 keep 5 days until you change it.
- The MAILBOX RETRIES, SLEEP and WAKE TIME pages are removed. HOLD Off does what pausing did.
- Updating from 0.6 or 0.7.x: install the new file the same way. Contacts, channels, settings and held messages are kept.
New in version 0.7.2
- Messages are held for 5 days instead of 15. After that the mailbox gives up and the BoxOnPost Status channel tells you. Messages already held when you update follow the new limit.
- Updating from 0.6, 0.7 or 0.7.1: install the new file the same way. Contacts, channels, settings and held messages are kept.
New in version 0.7.1
- ThinkNode M1 is available, in two versions: Screen stays on keeps your info readable when the backlight turns off; Stock blanks the screen like standard MeshCore. See the M1 page.
- New start-up screen on every radio: BoxOnPost, “for MeshCore”, then the version.
- Updating from 0.6 or 0.7: install the new file the same way. Contacts, channels, settings and held messages are kept.
New in version 0.7
BoxOnPost 0.7 is built on MeshCore 1.18. Everything BoxOnPost does works the same; underneath you get MeshCore's security fixes, a clock that survives restarts, and on Heltec radios (Bluetooth versions) Wi-Fi and Bluetooth at the same time, set up from the MeshCore app 1.50 or newer.
- Updating: install the 0.7 UPDATE file directly, with “Erase device” unticked. No need to install MeshCore 1.18 first: it's built in.
- Heltec V3 and V4 R8 now hold 50 messages, to leave memory for Wi-Fi and Bluetooth. The Heltec V4 still holds 100.
- You don't need to update the phone app. The app's new Command Line works too; BoxOnPost only ever holds and retries normal direct messages, never commands.
New in version 0.6
Version 0.6 added these features, and every later version includes them. The newest version is always on the Firmware page.
- No double messages. A BoxOnPost radio remembers what it has already received. If the sender's mailbox sends a message again because the “got it” reply was lost, it isn't shown twice, and the sender still gets its “got it”, so it stops trying. Works with the phone app closed.
- “~BOP” on late deliveries. A message the mailbox delivered late ends with
~BOP, so the reader knows it was held for them. Messages that go straight through don't get it. - The BoxOnPost Status channel. Your radio adds a private channel to the app with one-line notes, like ✓ Delivered to Don: “Are you coming tonight…” (2h late), or a warning if the mailbox was full or gave up. The app's “failed” can also switch to delivered when a held message gets through.
About the channel: it exists only on your radio, nothing is sent over the air on it, and no other radio can see it. It goes in an empty channel slot and never touches your other channels. Rename or mute it in the app as you like. If you delete it, it stays deleted; to bring it back, long press on the radio's APP NOTICES page and reconnect the app.