Repository navigation
mups17-2 (v1.17.1.mups2)
mups17-2 – MeshCore v1.17.1.mups2
Custom MeshCore firmware based on IoTThinks PowerSaving-v17 (MeshCore main v1.17.1).
Full documentation: MUPS17.md · Maintenance handbook (German): MUPS17-HOWTO.md
Changes since mups17-1
- Repeated sending (
max.resend) is now a core feature, on by default with 3 attempts on all roles (was 2). Devices that already stored a value keep it:set max.resend 3(companion: rescue CLI). - DMC packet filter – channel block by key:
filter channel add #namenow verifies the packet's MAC under the channel key instead of matching only the one-byte channel hash, so other channels sharing that byte are no longer blocked. The repeater still cannot read messages. The malformed scan no longer drops other channels that share the Public hash byte0x11. - New: airtime reserve for scoped floods (repeater, off by default):
set fwd.scoped.reserve <0-100>keeps a share of the repeater's TX time per 60 s free for floods with a region; unscoped floods are dropped first when the repeater is busy.get fwd.scoped.reserve,get fwd.scoped.stats. Idea from ACETyr/MeshCore. - Upstream updates from PowerSaving-v17 and MeshCore
mainsince mups17-1. - Documentation: core vs. optional features, assessed but not included PRs (meshcore-dev#2997, meshcore-dev#1923), maintenance handbook.
Included
| Component | Source | Notes |
|---|---|---|
RX duty-cycle power saving (radio.rxps), powerlog, sensor, outpath, reboot.interval |
IoTThinks PowerSaving-v17 | base |
| Release fixes | MeshCore main |
merged |
| Fix 1970 date after crash/watchdog/brownout (ESP32) | PR #1896 | already in PowerSaving-v17 |
| Time keeping across resets (nRF52) | PR #2704 | already in PowerSaving-v17 |
| Allow setting the clock backwards, elapsed-time underflow fix | PR #1349 | |
| Separate replay counters for login and messages | PR #2834 | repeater, room server, sensor |
| Flood ACK on DM retries | PR #3260 | |
| Beeps for buzzer on/off, T1000-E button debounce 20 ms | PR #3536 | companion |
Repeated sending of direct packets (max.resend, on by default, 3) |
PR #2670 | partial port: without noise-floor median estimator and RX-desync watchdog (both conflict with power saving) |
WiFi companion: credentials from flash (/wifi_config) |
PR #2706 | adapted: credential loading only |
| WiFi companion: set SSID/password via rescue CLI | PR #2720 | adapted |
Repeater packet filter (filter …) |
Dutch-MeshCore dmc-dev | repeater only, off by default; start with filter dryrun on; own fix: channel block by key (MAC) |
Airtime reserve for scoped floods (fwd.scoped.reserve) |
own, idea from ACETyr/MeshCore | repeater only, off by default |
Own changes
Radio preset (all roles): 869.618 MHz, BW 62.5, SF 8, CR 8
Duty cycle (all roles): 10 % (af 9.0)
Repeater defaults:
| Setting | Value |
|---|---|
rxdelay / txdelay / direct.txdelay |
2 / 1.0 / 0.4 |
advert.interval / flood.advert.interval |
240 min / 167 h |
flood.max / flood.max.unscoped / flood.max.advert |
10 / 3 / 3 |
multi.acks / path.hash.mode |
1 / 2 |
loop.detect |
moderate |
agc.reset.interval |
12 s |
Companion rescue CLI: get/set af, get/set dutycycle, get/set max.resend, get pin; replies now display correctly in the flasher.meshcore.io web console.
WiFi companion (Heltec V3 WiFi): the firmware contains no WiFi credentials. Set them once in the rescue CLI (long press of the PRG button within 8 s after boot, serial console 115200 baud):
wifi_ssid <your SSID>
wifi_pwd <your password>
wifi_commit
wifi_show shows the state, wifi_clear removes the stored credentials.
Defaults apply to new installs / after erasing the settings only – existing devices keep their stored settings (set dutycycle 10, set flood.max 10, … on the repeater; rescue CLI on the companion).
Files
| Device type | File | Use |
|---|---|---|
| ESP32 (Heltec V3) | *.bin |
Update (app image only) – web flasher (non-merged) or OTA; settings are kept |
| ESP32 (Heltec V3) | *-merged.bin |
New install / recovery (bootloader + partitions + app, written at 0x0). The web flasher erases the whole flash when a merged image is selected |
| nRF52 (RAK4631, SenseCAP Solar, T1000-E, Wio Tracker L1) | *.zip |
Update via DFU – web flasher (serial) or nRF Connect app (BLE); settings are kept |
| nRF52 (same) | *.uf2 |
Update via drag & drop – enter bootloader (usually double reset), copy file to the USB drive; settings are kept |
.zip and .uf2 contain the same firmware – two ways to flash it. Neither erases settings.
For a clean install on nRF52, erase first (web flasher erase function, or rescue CLI erase on a companion), then flash.
Firmware version on the device: v1.17.1.mups2 (ver).