Files
mg4/FIRMWARE.md
T
nilsandClaude Opus 5.5 851a4a34d4 App 2.17.1: tidier Settings and Logs
- Settings: the Wi-Fi and saved-networks cards are gone, and the rest
  sits in three columns (display and steering wheel | battery |
  charging price and app) instead of one tall column. The background
  Wi-Fi auto-connect stays on, without a switch.
- Logs: only the upload log. The steering-key reports, the car-colour
  probe and the screen line answered their questions and are removed,
  with their code (CarColorProbe, the key-report log) and strings.
- README lists the current tabs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLJfZQZeAKAwSqViTmLzki
2026-10-18 20:32:01 +02:00

2.5 KiB
Raw Blame History

Supported firmware notes

This document records project compatibility constraints and behaviour confirmed during development. It must not be treated as a vendor specification.

Identity

Tested generation SWI68-29958-1300R69
Android 9 (Pie) — API 28
Chipset MediaTek MT2712
Device mt2712_saic_eh32 (eh32 = MG4)
Display 1920×720 px @ 160 dpi; the app window is 1778×720 px (≈1778×640 dp for layouts), the car's own sidebar taking the rest. Confirmed on the car 2026-10-18 (read with app 2.16.2, SWI68).
Emulator display profile 1920×720 @ 160 dpi
ro.build.mtk2712.vehicle_type AS28 (a vehicle type code; the paint colour is not among the system properties)

EVProfile's README gives the display as 1280×480. That is 1920×720 px at 240 dpi expressed in dp; on this car the density is 160 dpi, so it does not apply here.

Signing caveat

Certificate equality alone does not prove an APK came from this project. The nightly OTA therefore also requires https and an exact-host GitHub allowlist. The same caveat applies to EVProfile's OTA.

Vendor property IDs

The vendor VHAL is vendor/bin/hw/android.hardware.automotive.vehicle@2.0-service (ARM aarch64), backed by vendor/lib64/android.hardware.automotive.YFvehicle@2.0.so ("YF" supplier implementation). The property IDs (0x2160F404 SOC, 0x2140F41C range, …) are compiled into that binary, not stored in a readable config. The project therefore treats these IDs as implementation details with firmware-specific compatibility limits.

These IDs are therefore confirmed for SWI68 (R69) only. MG4 ships other generations (SWI69/131/132/133/165) and the VHAL binary lists many SAIC platforms (eh32, as33, ec32, ip42, …); the IDs may differ there.

Only SOC and range still ride these vendor IDs. Speed, outside temperature and park state are read through EVHardware, which branches per generation internally and so covers all six firmwares — CarPropertyAdapter carries just the SWI68 EV cluster plus the standard-AAOS charge / cabin-temp reads. EVHardware has no EV-battery abstraction for any generation, which is why SOC/range cannot yet follow the same path. See AGENTS.md for the full per-signal split.

Emulator fidelity

The mise emulator tasks use an API 33 automotive AVD for the car service and an API 28 AVD at 1920×720 @ 160 dpi for the screen, as on the car. Neither exposes the SAIC vendor properties, so vehicle-specific behaviour still requires on-vehicle validation.