Repository navigation
mups17-3 (v1.17.1.mups3)
mups17-3 – MeshCore v1.17.1.mups3
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-2
- Base updated to the latest PowerSaving-v17 state (PowerSaving 17.1.6 and the later IoTThinks commits up to its "last build file for PowerSaving 17.1"), including RadioLib 7.8.1 (
^7.8.1; previously pinned to a specific RadioLib git commit) and FEM support for Heltec V4.3 R8. - DMC packet filter – own defaults for new installs and
filter reset: dry-run on, malformed scan on, advert window 24 h, age limit 30 min, no rate limits, hop limit 6 for REQ/RESPONSE/ANON_REQ (login), no hop limit for all other types. The filter itself stays off by default. - DMC packet filter – fix: rate limiters and the advert window were only set up when
/filter_prefsalready existed, andfilter resetkept the old limits until reboot. Both now take effect immediately. get cad– fix: the "channel busy" counter was never incremented; it now counts CAD scans before TX that do not report a free channel (reset withclear stats).- Repeater defaults changed:
flood.max15 (was 10),cadon (was off). New installs only – existing repeaters:set flood.max 15,set cad on. - MeshCore
mainstays at v1.17.1 (plus documentation updates). v1.18.0 will come with the next firmware line (mups18).
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; own defaults (dry-run on); own fixes: channel block by key (MAC), limiter setup |
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 |
15 / 3 / 3 |
multi.acks / path.hash.mode |
1 / 2 |
loop.detect |
moderate |
agc.reset.interval |
12 s |
cad |
on |
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 15, … 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.mups3 (ver).