nils/mg4

Files

T

TCFDONMEZandClaude 2fd7b2dde1 Fatih'sMG4 — ABRP telemetry for an MG4 EH32 on SWI69

A fork of malys/EVABRPUploader (itself a fork of Leon Kernan's ABRP_Uploader)
carrying the changes that make it work on this car. History starts here: the
tree is what matters, and the upstream projects are where the earlier work
belongs.

EVHardware is vendored rather than tracked as a submodule, so one clone
builds.

Telemetry. SOC, battery power and range read as unavailable on SWI69 because
the vendor fallbacks were gated to SWI68 alone, while the property ids they
use are the ones this car publishes — the gates now admit SWI69. Tyre
pressure, the odometer and charge status come from the vendor block too,
since the generic properties for all three are declared here and never
publish. Tyre pressure is confirmed on the vehicle; the other two are not
yet.

Vehicle page. Every signal the car answers, in a table. One that it does not
publish shows a dash: an unimplemented VHAL property returns zero, and
"0 °C" would read as a measurement.

Wi-Fi page. Joins a network the unit already has saved, so a phone hotspot
does not need a trip into Settings on every drive. Tried on the upload tick
and from a button, skipped while already associated. This leans on the unit
being API 28 and the build being platform-signed — getConfiguredNetworks and
enableNetwork are closed to ordinary apps from API 29 — and fails quietly
where that does not hold.

The OTA updater points at this repository. An APK from upstream is signed
with a different key, which Android will not install over a platform-signed
build.

Co-Authored-By: Claude <noreply@anthropic.com>

2026-09-22 10:45:00 +03:00

3.1 KiB

Raw Permalink Blame History

Contributing

This library reads and writes a car. That single fact drives everything below.

Ground rules

The 0 km/h gate is load-bearing. Any road-behaviour write must pass through VehicleWriteGate and carry @RequiresStandstill. It fails closed on unreadable speed — keep it that way.
Branch every vehicle call per firmware generation via FirmwareInfo. Never assume a method or property id is universal across SWI68/69/131/132/133/165.
Unreadable is not a value. Return null / -1 when the layer is not ready or the property is absent; never fabricate 0/false.
Property ids come from evidence. Confirm ids/transaction codes against the R69 OEM sources (or on-vehicle logs) and document the source inline. An unverified id is read-only until confirmed — no write path.

Before a PR

mise run check     # JVM unit tests + firmware-matrix freshness

New vehicle catalogue entries need a @SupportedOn(...); a test fails without it, and docs/firmware-matrix.md regenerates on the test run — commit it, do not hand-edit it.

Language

English only — code, comments, commit messages, docs. User strings in values/ (English) with a values-fr/ translation.

Consumers

Changing a public signature ripples into EVProfile, EVTasker and EVABRPUploader (submodule consumers). Note the affected apps in the PR; a minified consumer must be verified on a vehicle because vehicle access is reflection-based.

Ways to help

Not every useful contribution is code:

Bug reports — firmware generation, app version, what you did, what happened.
Feature requests — describe the problem before the solution.
Documentation — README, this guide, the firmware matrix, translations.
Pull requests — see below.
Testing pre-releases — install an unstable build and report what broke.
Sponsorship — see below.

Contributing efficiently

Maintainer time and AI quota are the scarce resources here, ideas are not. If you have access to Claude Opus or another capable coding model, a finished pull request is worth much more than a feature request: someone still has to design, write, test and verify the request, and that someone has a limited quota too.

A pull request that lands quickly usually carries:

The problem, in one or two sentences.
The proposed solution, and what you rejected.
The implementation, scoped to one concern.
Tests — mise run check passes.
Documentation updated: README, CHANGELOG, this guide where relevant.

Generate the change locally with whatever model you have, then read every line yourself before opening the PR. You are the author, not the model. Unreviewed generated code on a path that reaches the vehicle will be sent back.

Sponsorship

Maintaining EVSuite costs development time, test hardware and AI usage. If it is useful in your daily driving, consider sponsoring through GitHub Sponsors. Sponsorship covers those costs and gets fixes and features out faster.

Contributions are accepted under MIT (see LICENSE.md).

3.1 KiB Raw Permalink Blame History