diff --git a/README.md b/README.md index 0d97ed7..558d652 100644 --- a/README.md +++ b/README.md @@ -47,26 +47,26 @@ navigation, and what inspired it. The Retro Overview style in full screen: turquoise seven-segment digits for speed, charge, range and usage, amber labels

-Version 2.18.1 in the car's app window (1778×640 dp next to the MG4's own sidebar), full screen, -on the Android 9 emulator. There is no vehicle there, so every value shows as a dash. Every tab -fits the window without scrolling. +The tabs of version 2.35.2 in the car's app window (1778×640 dp next to the MG4's own sidebar), +full screen, on the Android 9 emulator right after installing. There is no vehicle there, so +every live value shows as a dash. Every tab fits the window without scrolling.

- Overview tab: battery, range, power and speed tiles with since-start and 5-minute averages, vehicle info and tyre pressures + Overview tab: battery, range, power and speed tiles with since-start and 5-minute averages, vehicle info and tyre pressures

- - + + - - + + - - + +
Consumption tab: period totals beside the daily logCharging tab: live charging values beside the SOC/power curveConsumption tab: period totals beside the daily logCharging tab: live charging values beside the SOC/power curve
Live data tab: on/off, ABRP credentials, upload frequencyServer tab: URL, pairing, ingest token, installation IDLive data tab: on/off, ABRP credentials, upload frequencyServer tab: URL, pairing, ingest token, installation ID
Settings tab: display, battery, charging price, phone entry, app updatesLogs tab: recent uploadsSettings tab: display and steering wheel, drive mode, battery and charging price, phone entry, app updatesLogs tab: the signal recorder and recent uploads
@@ -88,23 +88,26 @@ with the server using a token of its own, obtained by pairing with a phone (belo | Tab | What it shows | |---|---| -| **Overview** | Battery, range, power and speed; range, usage and energy since start; 5-minute averages of range, usage, power and speed; vehicle info (odometer, climate setpoint) and tyre pressures. Read five times a second. Looks to choose from in Settings → Overview style: Tiles, Gauges, Cockpit, Retro, Futuristic, Sci-fi, Cartoon, MG, Minimal, Terminal, Nixie tubes and Chronograph ([THEMES.md](THEMES.md) shows them all). A style with its own colours (Sci-fi, Cartoon, Nixie tubes, and Retro and Terminal with "Original") colours the whole app to match, e.g. turquoise for Retro. The small button next to the MG4 logo in the navigation hides the navigation for a full-width Overview; swipe in from the left edge (a faint handle marks it) to bring it back; with Settings → Full screen off, the car's own sidebar sits at that edge, so tap the small tab at the left edge (›) instead. Pages change only by the navigation, not by swiping sideways | +| **Overview** | Battery, range, power and speed; range, usage and energy since start; 5-minute averages of range, usage, power and speed; vehicle info (odometer, lease allowance, climate setpoint) and tyre pressures. Read five times a second. Looks to choose from in Settings → Overview style: Tiles, Gauges, Cockpit, Retro, Futuristic, Sci-fi, Cartoon, MG, Minimal, Terminal, Nixie tubes and Chronograph ([THEMES.md](THEMES.md) shows them all). A style with its own colours (Sci-fi, Cartoon, Nixie tubes, and Retro and Terminal with "Original") colours the whole app to match, e.g. turquoise for Retro. The small button next to the MG4 logo in the navigation hides the navigation for a full-width Overview; swipe in from the left edge (a faint handle marks it) to bring it back; with Settings → Full screen off, the car's own sidebar sits at that edge, so tap the small tab at the left edge (›) instead. Pages change only by the navigation, not by swiping sideways | | **Consumption** | Lifetime, last 7 and 30 days, Trip A and B (distance, energy, average consumption and speed, SOC change), and a daily log of the last four months | | **Charging** | The current session (SOC, voltage, current, power, energy into the battery and from the grid, time, cost) and its SOC/power curve | | **Live data** | Live data on/off, ABRP credentials for sending directly from the car, upload frequency | | **Server** | Server URL, pairing by QR code, ingest token, installation ID, config import | -| **Settings** | Drive mode (Eco, Normal, Sport, Snow, Custom: changes only in P at a standstill; the highlighted one is what the car reports; with "Set at start" the last confirmed choice is set again when the car starts, while it is still in P), full screen, voice key, tyre pressure unit, accent colour, battery (manual SoH, usable capacity), charging price, entry on the phone, version, update check, install from USB stick, About | -| **Logs** | Update log (every install step), upload log | +| **Settings** | Full screen, voice key, Overview style and accent colour, tyre pressure unit; drive mode (Eco, Normal, Sport, Snow, Custom: changes only in P at a standstill; the highlighted one is what the car reports; with "Set at start" the last confirmed choice is set again when the car starts, while it is still in P); battery (manual SoH, usable capacity) and charging price; entry on the phone; version, update check, install from USB stick, About | +| **Logs** | Signal recorder (records every value the head unit offers for 3 minutes and lists what changed, to find where the car publishes something; saved to a USB stick too), update log (every install step), upload log | - **Opening the app:** the MG4 launcher does not list third-party apps. **Double-press the voice key** on the steering wheel and the app comes to the front (switch on the Settings tab, on by default). - **Full screen:** hides SAIC's top and bottom bars while the app is open; a swipe from the edge shows them briefly (Settings tab, on by default). -- **Live telemetry:** every 15 s while driving or charging, much less often while parked. A - value the car cannot read is left out, never sent as zero, so ABRP is never told the battery - is empty because a read failed. -- **Read-only:** the app never writes a vehicle setting. +- **Live telemetry:** while driving or charging, at the upload frequency set on the Live data + tab (15 s to 5 min, every minute by default; every 15 s below a low battery threshold, if + switched on); parked and unplugged, once every 15 minutes. A value the car cannot read is left + out, never sent as zero, so ABRP is never told the battery is empty because a read failed. +- **Read-only, with one exception:** the app writes no vehicle setting except the drive mode, and + that only in P at a standstill, when you tap it on the Settings tab or, with "Set at start", + once when the car starts. What it shows is what the car reports back. Signals the MG4 does not publish (battery, cabin and outside temperature, pack energy and capacity) are listed in [`SPECS.md`](SPECS.md#signals-the-car-does-not-provide). diff --git a/SPECS.md b/SPECS.md index 6730afe..2d325db 100644 --- a/SPECS.md +++ b/SPECS.md @@ -138,6 +138,11 @@ tyre pressures, GPS (lat, lon, elevation, heading) and the is_* flags. It does * confirmed car facts, app structure, UI conventions, build/test/ship, documents. It replaces upstream's EVABRPUploader text. The test emulator is now in the flake: `nix run .#car-emulator` (Android 9 AOSP at 1920×720, 160 dpi; the car build installs as the system user — checked). +- 2026-10-25 — README.md brought up to date: the tab screenshots retaken with 2.35.2 on the + emulator right after installing (`screenshots/nilsmg4-2.35.2-*.png`, the 2.18.1 ones removed), + "read-only" now names the drive mode exception, the upload frequency matches the app (1 min by + default, 15 s at low battery, 15 min parked), and the Settings and Logs rows list what is there + now (Overview style, drive mode, signal recorder). - 2026-10-25 — App 2.35.2: the full-screen button is round. Its disc was an even inset in a 64 × 72 dp (narrow: 64 × 76) area, so an oval; the area is now a square 72 × 72 dp (inset 18 dp, a 36 dp disc), pulled 8 dp into the panel's padding in the wide layout so "MG4" keeps diff --git a/screenshots/nilsmg4-2.18.1-charging.png b/screenshots/nilsmg4-2.18.1-charging.png deleted file mode 100644 index c695ae5..0000000 Binary files a/screenshots/nilsmg4-2.18.1-charging.png and /dev/null differ diff --git a/screenshots/nilsmg4-2.18.1-consumption.png b/screenshots/nilsmg4-2.18.1-consumption.png deleted file mode 100644 index bbf144e..0000000 Binary files a/screenshots/nilsmg4-2.18.1-consumption.png and /dev/null differ diff --git a/screenshots/nilsmg4-2.18.1-live-data.png b/screenshots/nilsmg4-2.18.1-live-data.png deleted file mode 100644 index 9120e2e..0000000 Binary files a/screenshots/nilsmg4-2.18.1-live-data.png and /dev/null differ diff --git a/screenshots/nilsmg4-2.18.1-logs.png b/screenshots/nilsmg4-2.18.1-logs.png deleted file mode 100644 index 5753582..0000000 Binary files a/screenshots/nilsmg4-2.18.1-logs.png and /dev/null differ diff --git a/screenshots/nilsmg4-2.18.1-overview.png b/screenshots/nilsmg4-2.18.1-overview.png deleted file mode 100644 index f892b97..0000000 Binary files a/screenshots/nilsmg4-2.18.1-overview.png and /dev/null differ diff --git a/screenshots/nilsmg4-2.18.1-server.png b/screenshots/nilsmg4-2.18.1-server.png deleted file mode 100644 index 4007a69..0000000 Binary files a/screenshots/nilsmg4-2.18.1-server.png and /dev/null differ diff --git a/screenshots/nilsmg4-2.18.1-settings.png b/screenshots/nilsmg4-2.18.1-settings.png deleted file mode 100644 index e9c0f83..0000000 Binary files a/screenshots/nilsmg4-2.18.1-settings.png and /dev/null differ diff --git a/screenshots/nilsmg4-2.35.2-charging.png b/screenshots/nilsmg4-2.35.2-charging.png new file mode 100644 index 0000000..2a4f6d5 Binary files /dev/null and b/screenshots/nilsmg4-2.35.2-charging.png differ diff --git a/screenshots/nilsmg4-2.35.2-consumption.png b/screenshots/nilsmg4-2.35.2-consumption.png new file mode 100644 index 0000000..4ca5a53 Binary files /dev/null and b/screenshots/nilsmg4-2.35.2-consumption.png differ diff --git a/screenshots/nilsmg4-2.35.2-live-data.png b/screenshots/nilsmg4-2.35.2-live-data.png new file mode 100644 index 0000000..58d4e74 Binary files /dev/null and b/screenshots/nilsmg4-2.35.2-live-data.png differ diff --git a/screenshots/nilsmg4-2.35.2-logs.png b/screenshots/nilsmg4-2.35.2-logs.png new file mode 100644 index 0000000..cb3f9a1 Binary files /dev/null and b/screenshots/nilsmg4-2.35.2-logs.png differ diff --git a/screenshots/nilsmg4-2.35.2-overview.png b/screenshots/nilsmg4-2.35.2-overview.png new file mode 100644 index 0000000..f6529a3 Binary files /dev/null and b/screenshots/nilsmg4-2.35.2-overview.png differ diff --git a/screenshots/nilsmg4-2.35.2-server.png b/screenshots/nilsmg4-2.35.2-server.png new file mode 100644 index 0000000..ed81d4d Binary files /dev/null and b/screenshots/nilsmg4-2.35.2-server.png differ diff --git a/screenshots/nilsmg4-2.35.2-settings.png b/screenshots/nilsmg4-2.35.2-settings.png new file mode 100644 index 0000000..381d8c5 Binary files /dev/null and b/screenshots/nilsmg4-2.35.2-settings.png differ