BoxOnPost for the RAK WisBlock (RAK4631)
BoxOnPost pages on the radio's screen · holds 48 messages.
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.
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.
Download the file
The RAK WisBlock (RAK4631) version is being tested on real radios. The download appears here once it passes.
Want to help test it? Get in touch
Install it
- Plug the radio into a computer with a USB data cable. Any computer works: Windows, Mac, Linux or a Chromebook.
- 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.)
- Copy the
.uf2file you downloaded onto that drive. - Wait. The drive disappears by itself and the radio restarts. Your computer may say the drive wasn't ejected properly; that's normal.
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.
Try it
- 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.
- 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.
- 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.
Good to know
- Screen is optional: if you've fitted RAK's small OLED screen, BoxOnPost pages show on it. Without one, the mailbox works fully and you watch it from the phone app.
- Holds 48 messages (less file space on this chip).
Help us test the RAK WisBlock (RAK4631)
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.