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

52 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.