Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,17 @@ this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm

## [Unreleased]

## [3.0.30] - 2026-11-19

### Fixed

- **Saving the Ethernet or mobile data (SIM) uplink now shows the Restart
button**, like the other settings that apply after a restart. Before, only
a short note said to restart. The monthly data limit still applies at once
and does not ask for a restart.
- System → About shows the RecoveryGateway repository as the source (the
link already opened it; the text still showed the old name).

## [3.0.29] - 2026-11-19

### Fixed
Expand Down
4 changes: 2 additions & 2 deletions CITATION.cff
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,8 @@ abstract: >-
optional MQTT, Home Assistant, ntfy and SNMP integration.
authors:
- alias: Mattboxx
version: 3.0.29
date-released: 2026-11-18
version: 3.0.30
date-released: 2026-11-19
license: GPL-3.0-only
repository-code: "https://github.com/Mattboxx/RecoveryGateway"
url: "https://mattboxx.github.io/RecoveryGateway/"
Expand Down
2 changes: 1 addition & 1 deletion CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ include($ENV{IDF_PATH}/tools/cmake/project.cmake)

# PROJECT_VER lands in the esp_app_desc_t struct so the running firmware
# can report its version via the OTA APIs and the web UI's Status page.
set(PROJECT_VER "3.0.29")
set(PROJECT_VER "3.0.30")
# The migration bridge (env esp32-s3-bridge, CONFIG_TSR_MIGRATION_BRIDGE) is a
# 2.x-line release so that 2.x updaters install it like any other update.
set(TSR_BRIDGE_VER "2.1.0")
Expand Down
8 changes: 7 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,13 @@ configuration, peers and measurements. Open an image for the full view.

[Browse the gallery](https://mattboxx.github.io/RecoveryGateway/screenshots/) for mobile, first boot, recovery, alerts, firewall and diagnostics.

## What's new in Firmware 3.0.29
## What's new in Firmware 3.0.30

- **Saving the Ethernet or mobile data (SIM) uplink shows the Restart
button**, like the other settings that apply after a restart.
- System → About shows the RecoveryGateway repository as the source.

### Also in 3.0.29

- **USB SIM sticks on the home network's address range** (e.g. 192.168.1.x
on both sides) no longer cut the gateway off from the home devices.
Expand Down
16 changes: 16 additions & 0 deletions docs/DEVELOPMENT-ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -257,12 +257,28 @@ PSRAM placement, cache tuning) is the base of this branch (`v3`).

## Next firmware (after 3.0.29) — owner requests to carry

Status: both items are implemented on `feat/next-firmware` as 3.0.30
(not published; owner 2026-11-19: "crea la nuova versione ... ma ancora non
pubblicarla"). Browser tests cover the banner after Ethernet and cellular
saves, no banner after a data-limit save, and the About source text.

- **System → About, "Source":** the link already opens `Mattboxx/RecoveryGateway`
(3.0.29), but its visible text still reads
`github.com/Mattboxx/esp32-tailnet-gateway` (`main/index.html` and the
`main/i18n/*.json` entries). Show `github.com/Mattboxx/RecoveryGateway`
(owner, 2026-11-19: "ricorda nella prossima versione di aggiustare questo
nelle info del firmware").
- **Restart button after saving the Ethernet or cellular (SIM data) uplink:**
both settings apply at the next boot and their POST answers
`restart_required: true`, but the page only writes "saved settings apply
after restart" in the card; unlike the other settings that need a restart,
it never raises the pending-reboot banner with its Restart button
(`setPendingReboot(true)` is not called after `/api/ethernet` and
`/api/cellular` saves; the monthly data limit applies at once and answers
`restart_required: false`, so it must not raise it). Raise it the same way,
with a browser test (owner, 2026-11-19: "quando si
imposta ethernet o SIM dati che appaia il tasto di reboot come le altre cose
che lo richiedono").

## 3.0.26 and later — Tailnet reach (owner decision, 2026-11-18)

Expand Down
6 changes: 6 additions & 0 deletions docs/VALIDATION-STATUS.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,11 @@
# Validation records

3.0.30 candidate, not published (source `9f51909`; BIN 75a7d48f79ff119effdc0a5a6126df5f7d6fa366a7472d2d89f8fedcfdcf5665, ELF 8a5a3434969c4fe14800fc116a024ed7b5a8ce05b8677cb355e3d964f48df5c9, archived in ignored `build/development-3.0.30/9f51909`). Content: the restart banner after Ethernet and cellular uplink saves (not after a data-limit save), and the About source text `github.com/Mattboxx/RecoveryGateway`.

- **Offline:** clean build, image provenance and USB RAM placement PASS; `validate_all.py --build --browser` 165/168 PASS in one run, the other three (host crypto build, `first_boot`, `password_crypto`) failed only because the host Mbed TLS tree was not set and PASS when rerun against the pinned ESP-IDF 6.1 tree, as does `tailnet_sdk` with its lwIP; browser tests include the banner after both saves, no banner after a data-limit save, and the About text.
- **Board A over the LAN, 15/15 PASS** (OTA of the exact image, 8 saved-setting groups unchanged): version 3.0.30, tailnet and policy authority, product name; the served UI carries the restart banner call after both uplink saves and the RecoveryGateway source text; Ethernet and cellular status readable with no restart pending; names resolve; Tailscale connected for 5 minutes with no drop; update check answered by `Mattboxx/RecoveryGateway`; reconnect after a restart without the auth key; web polls; RAM floors (free 50.4 KB, lowest 38.9 KB).
- **Not run:** the banner by a real save on the board (covered by the browser tests; a save would change settings), the SIM stick (cellular uplink off on board A during this run).

3.0.29 stable (release source `6440d7a`, MicroLink `9b0a70e`; BIN b5d26ac742104987cd0931bbd0e7965da4d2cb5d9dcd51a6c743e5d720753d8c; bootloader, partition table and esptool as 3.0.28). Content:
- a USB stick network on the home LAN's prefix (board A: Wi-Fi 192.168.1.0/24, router .254; TCL stick 1BBB:0195 also 192.168.1.0/24, gateway .1): home addresses go to the LAN uplink, the stick's address and (while it carries the Internet uplink) its gateway and DHCP server to the stick;
- the resolver follows a network-mode stick that carries the Internet uplink and is restored afterwards (on 3.0.28 board A's lookups all failed and the control session flapped about 200 s up / 200 s down);
Expand Down
2 changes: 1 addition & 1 deletion main/i18n/de.json
Original file line number Diff line number Diff line change
Expand Up @@ -1877,7 +1877,7 @@
"from the AP.": "vom Access Point.",
"from {}": "von {}",
"gateway@example.com": "gateway@example.com",
"github.com/Mattboxx/esp32-tailnet-gateway": "github.com/Mattboxx/esp32-tailnet-gateway",
"github.com/Mattboxx/RecoveryGateway": "github.com/Mattboxx/RecoveryGateway",
"github.com/…/issues": "github.com/…/issues",
"in Telegram, press Start and copy your numeric Id. This is a third-party helper; never share your bot token with it.": "in Telegram, tippe auf Starten und kopiere deine numerische Id. Dies ist ein Dienst von Dritten; gib dort nie dein Bot-Token weiter.",
"internet": "internet",
Expand Down
2 changes: 1 addition & 1 deletion main/i18n/es.json
Original file line number Diff line number Diff line change
Expand Up @@ -1923,7 +1923,7 @@
"from the AP.": "del AP.",
"from {}": "desde {}",
"gateway@example.com": "gateway@example.com",
"github.com/Mattboxx/esp32-tailnet-gateway": "github.com/Mattboxx/esp32-tailnet-gateway",
"github.com/Mattboxx/RecoveryGateway": "github.com/Mattboxx/RecoveryGateway",
"github.com/…/issues": "github.com/…/issues",
"in Telegram, press Start and copy your numeric Id. This is a third-party helper; never share your bot token with it.": "en Telegram, pulsa Iniciar y copia tu Id numérico. Es un servicio de terceros: nunca compartas con él el token de tu bot.",
"internet": "internet",
Expand Down
2 changes: 1 addition & 1 deletion main/i18n/fr.json
Original file line number Diff line number Diff line change
Expand Up @@ -1877,7 +1877,7 @@
"from the AP.": "du point d'accès.",
"from {}": "depuis {}",
"gateway@example.com": "gateway@example.com",
"github.com/Mattboxx/esp32-tailnet-gateway": "github.com/Mattboxx/esp32-tailnet-gateway",
"github.com/Mattboxx/RecoveryGateway": "github.com/Mattboxx/RecoveryGateway",
"github.com/…/issues": "github.com/…/issues",
"in Telegram, press Start and copy your numeric Id. This is a third-party helper; never share your bot token with it.": "dans Telegram, appuyez sur Démarrer et copiez votre Id numérique. C'est un service tiers : ne partagez jamais le jeton de votre bot avec lui.",
"internet": "internet",
Expand Down
2 changes: 1 addition & 1 deletion main/i18n/it.json
Original file line number Diff line number Diff line change
Expand Up @@ -1956,7 +1956,7 @@
"from the AP.": "dall'AP.",
"from {}": "da {}",
"gateway@example.com": "gateway@example.com",
"github.com/Mattboxx/esp32-tailnet-gateway": "github.com/Mattboxx/esp32-tailnet-gateway",
"github.com/Mattboxx/RecoveryGateway": "github.com/Mattboxx/RecoveryGateway",
"github.com/…/issues": "github.com/…/issues",
"in Telegram, press Start and copy your numeric Id. This is a third-party helper; never share your bot token with it.": "su Telegram, premi Avvia e copia il tuo Id numerico. È un servizio di terze parti: non condividere mai il token del tuo bot.",
"internet": "internet",
Expand Down
2 changes: 1 addition & 1 deletion main/i18n/source.json
Original file line number Diff line number Diff line change
Expand Up @@ -2006,7 +2006,7 @@
"fresh",
"from the AP.",
"gateway@example.com",
"github.com/Mattboxx/esp32-tailnet-gateway",
"github.com/Mattboxx/RecoveryGateway",
"github.com/…/issues",
"in Telegram, press Start and copy your numeric Id. This is a third-party helper; never share your bot token with it.",
"internet",
Expand Down
2 changes: 1 addition & 1 deletion main/i18n/zh.json
Original file line number Diff line number Diff line change
Expand Up @@ -1923,7 +1923,7 @@
"from the AP.": "(AP)。",
"from {}": "来源 {}",
"gateway@example.com": "gateway@example.com",
"github.com/Mattboxx/esp32-tailnet-gateway": "github.com/Mattboxx/esp32-tailnet-gateway",
"github.com/Mattboxx/RecoveryGateway": "github.com/Mattboxx/RecoveryGateway",
"github.com/…/issues": "github.com/…/issues",
"in Telegram, press Start and copy your numeric Id. This is a third-party helper; never share your bot token with it.": "在 Telegram 中点击“开始”并复制你的数字 Id。这是第三方工具;切勿与其分享你的机器人令牌。",
"internet": "internet",
Expand Down
4 changes: 3 additions & 1 deletion main/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -4637,7 +4637,7 @@ <h1 class="page-title">System</h1>
<div class="stat-row"><span class="stat-label">Build tag</span> <span class="stat-value mono" id="about-build-tag" title="—">—</span></div>
<div class="stat-row"><span class="stat-label">Build commit</span><span class="stat-value mono" id="about-commit">—</span></div>
<div class="stat-row"><span class="stat-label">MicroLink</span><span class="stat-value mono"><a href="https://github.com/Mattboxx/microlink" target="_blank" rel="noopener">Mattboxx/microlink</a></span></div>
<div class="stat-row"><span class="stat-label">Source</span><span class="stat-value mono"><a href="https://github.com/Mattboxx/RecoveryGateway" target="_blank" rel="noopener" style="color:var(--accent);">github.com/Mattboxx/esp32-tailnet-gateway</a></span></div>
<div class="stat-row"><span class="stat-label">Source</span><span class="stat-value mono"><a href="https://github.com/Mattboxx/RecoveryGateway" target="_blank" rel="noopener" style="color:var(--accent);">github.com/Mattboxx/RecoveryGateway</a></span></div>
<div class="stat-row"><span class="stat-label">Issues</span><span class="stat-value mono"><a href="https://github.com/Mattboxx/RecoveryGateway/issues" target="_blank" rel="noopener" style="color:var(--accent);">github.com/&hellip;/issues</a></span></div>
<div class="stat-row"><span class="stat-label">Credits</span><span class="stat-value"><a href="https://github.com/Csontikka/esp32-tailscale-subnet-router" target="_blank" rel="noopener">Csontikka</a> · <a href="https://github.com/CamM2325/microlink" target="_blank" rel="noopener">Cameron Malone</a></span></div>
<div class="stat-row"><span class="stat-label">License</span><span class="stat-value mono">GPL-3.0 — see LICENSE and NOTICE.md in the repo</span></div>
Expand Down Expand Up @@ -7426,6 +7426,7 @@ <h1 class="page-title">System</h1>
var btn=this;btn.disabled=true;
try{var r=await apiFetch('/api/ethernet',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify(body)});var d=await r.json();
if(!r.ok||!d.ok)throw new Error(d.error||('HTTP '+r.status));
if(d.restart_required)setPendingReboot(true);
showToast('success','Ethernet settings saved','Restart the device to apply them.',5000);await loadEthernet();}
catch(e){document.getElementById('eth-status').textContent='Not saved: '+e.message;btn.disabled=false;}
});
Expand Down Expand Up @@ -7496,6 +7497,7 @@ <h1 class="page-title">System</h1>
var btn=this;btn.disabled=true;
try{var r=await apiFetch('/api/cellular',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify(body)});var d=await r.json();
if(!r.ok||!d.ok)throw new Error(d.error||('HTTP '+r.status));
if(d.restart_required)setPendingReboot(true);
showToast('success','Cellular settings saved','Restart the device to apply them.',5000);await loadCellular();}
catch(e){document.getElementById('cell-status').textContent='Not saved: '+e.message;btn.disabled=false;}
});
Expand Down
2 changes: 1 addition & 1 deletion tools/build_site.py
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@
# Current firmware: keep NEXT_PUBLISHED False until the qualified release
# exists. When True, website/firmware/<NEXT_VERSION>/ must hold the exact
# released files (see website/firmware/README.md); the build verifies them.
NEXT_VERSION = '3.0.29'
NEXT_VERSION = '3.0.30'
NEXT_PUBLISHED = True
FIRMWARE_DIR = SRC / 'firmware'
EWT_VERSION = '10.4.0' # ESP Web Tools bundle vendored in website/assets/esp-web-tools/
Expand Down
11 changes: 10 additions & 1 deletion tools/test_automation_ui.cjs
Original file line number Diff line number Diff line change
Expand Up @@ -137,7 +137,7 @@ async function fixture(browser, options = {}) {
state.migrationBody = {...state.migrationBody, busy: true, state: 'downloading', progress: 40, target: 'v3.0.0'}; status = 202; body = {ok: true}; }
else body = state.migrationBody || {layout: '3.x', needed: false};
} else if (url.pathname === '/api/cellular') {
if (route.request().method() === 'POST') { state.savedCellular = route.request().postDataJSON(); body = {ok: true, restart_required: true}; }
if (route.request().method() === 'POST') { state.savedCellular = route.request().postDataJSON(); body = {ok: true, restart_required: !state.savedCellular.data_limit}; }
else body = state.cellularBody || {};
} else if (url.pathname === '/api/tailnet-forward/import') {
const input=route.request().postDataJSON();
Expand Down Expand Up @@ -408,6 +408,8 @@ async function main() {
await f.page.waitForFunction(() => document.getElementById('cell-status').textContent.startsWith('Connected'));
await f.page.waitForTimeout(300);
assert.equal(f.state.savedCellular.enabled, true); assert.equal(f.state.savedCellular.data_ack, true);
/* A modem setting applies after a restart: the restart banner is raised like for other settings. */
assert.equal(await f.page.locator('#pendingRebootBanner').isVisible(), true);
assert.equal('pin' in f.state.savedCellular, false); assert.equal('password' in f.state.savedCellular, false);
await f.page.locator('#cell-pin').fill('1234'); await f.page.locator('#cell-save').click(); await f.page.waitForTimeout(300);
assert.equal(f.state.savedCellular.pin, '1234');
Expand Down Expand Up @@ -472,6 +474,8 @@ async function main() {
await f.page.locator('#cell-limit-save').click();
for (let i = 0; i < 50 && !f.state.savedCellular; i++) await f.page.waitForTimeout(100);
assert.deepEqual(f.state.savedCellular, {data_limit: {limit_mb: 1000, warn_percent: 80, reset_day: 10, pause: true}});
await f.page.waitForTimeout(200);
assert.equal(await f.page.locator('#pendingRebootBanner').isVisible(), false); /* the limit applies at once */
await f.page.waitForFunction(() => document.getElementById('cell-limit-status').textContent.includes('1000 MB / 1000 MB'));
assert.match(await f.page.locator('#cell-limit-status').textContent(), /^Used this month: 1000 MB \/ 1000 MB \(100%\) · since 2026-11-10 · limit reached: mobile data paused until the next month$/);
assert.equal(await f.page.locator('#cell-limit-reset').isVisible(), true);
Expand Down Expand Up @@ -917,6 +921,10 @@ async function main() {
assert.equal(await f.page.locator('#sys-updates-release').isVisible(), shown, url);
if (shown) assert.equal(await f.page.getAttribute('#sys-updates-release', 'href'), url);
assert.equal(await f.page.getAttribute('#sys-updates-repo', 'href'), 'https://github.com/Mattboxx/RecoveryGateway/releases');
/* About: the visible Source text names the current repository, not a redirect. */
const src = await f.page.evaluate(() => [...document.querySelectorAll('.stat-row')].filter(r => r.querySelector('.stat-label') && r.querySelector('.stat-label').textContent.trim() === 'Source' && r.querySelector('a'))
.map(r => [r.querySelector('a').textContent.trim(), r.querySelector('a').getAttribute('href')]));
assert.deepEqual(src, [['github.com/Mattboxx/RecoveryGateway', 'https://github.com/Mattboxx/RecoveryGateway']]);
assert.deepEqual(f.errors, []); await f.context.close(); count++;
}
// Failed status reads retain visible policy, disable writes and do not
Expand Down Expand Up @@ -1586,6 +1594,7 @@ async function main() {
for(let i=0;i<50&&!f.state.savedEthernet;i++)await f.page.waitForTimeout(100);
assert.deepEqual(f.state.savedEthernet,{enabled:true,transport:'spi',chip:'w5500',preference:'ethernet_first',spi_host:2,spi_mhz:20,sclk:12,mosi:11,miso:13,cs:10,int:14,rst:9,static_ip:true,ip:'192.168.1.60',netmask:'255.255.255.0',gateway:'192.168.1.1',dns:''});
assert.equal(await f.page.locator('#eth-sclk').isVisible(),true);assert.equal(await f.page.locator('#eth-card div.form-hint.eth-usb').isVisible(),false);
await f.page.waitForFunction(()=>document.getElementById('pendingRebootBanner').classList.contains('visible')); /* restart banner after an uplink save */
assert.deepEqual(f.errors,[]);await f.context.close();count++;
// Ethernet over USB (adapter or phone tethering): SPI fields hidden, USB status, typed save.
f=await fixture(browser,{page:'network',ethernetBody:{config:{enabled:true,transport:'usb',chip:'w5500',spi_host:2,spi_mhz:20,sclk:12,mosi:11,miso:13,cs:10,int:14,rst:9,static_ip:false,ip:'',netmask:'',gateway:'',dns:'',preference:'ethernet_first'},
Expand Down
Loading
Loading