TCFDONMEZandClaude
2fd7b2dde1
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>
3.4 KiB
AGENTS.md — EVHardware
Shared vehicle-access library for the SAIC MG4 (AAOS 9, MT2712), consumed by EVProfile, EVTasker, EVABRPUploader and EVChargePilot via git submodule + Gradle subproject.
EVHardware is the shared vehicle layer for EVSuite. The workspace AGENTS.md and
normative workspace DESIGN.md apply; this file defines library-specific invariants.
Commit author: malys.training@gmail.com
License exception: EVHardware's own sources use PolyForm Noncommercial 1.0.0, not the workspace MIT default.
Why this exists
One implementation of the reflection hardware layer, the 0 km/h gate, the models, and the condition/action catalogue — so the apps do not each re-derive vehicle access and drift. The apps are thin; the vehicle lives here.
Non-negotiables
- The 0 km/h gate is here.
VehicleWriteGatedecides every vehicle-setting write inside the low-level write primitives. Every setter carries@RequiresStandstill; coverage keeps the set honest. Unknown or negative speed fails closed, and a moving reading is never rescued by anything. The threshold is fixed at a readable 0 km/h, with no caller override and no park rescue. - Per-firmware routing, never universal. SWI68/69/131/132/133/165 differ; dispatch
through
FirmwareInfo. Any new vehicle call must branch per generation. - Unreadable ≠ a value. Getters return null / -1 when the layer is not ready or the property is absent; callers must treat that as "unknown", never as 0/false.
- Energy semantics are shared. Property ids, units, sign convention, physical validation,
fallback order, trip integration and charging-session integration belong in
telemetry/. Consumers own their UI, sampling cadence and network payload only. @SupportedOnis the source of truth fordocs/firmware-matrix.md(generated, never hand-edited) and for consumers' runtime filters. A vehicle catalogue entry without it fails the tests.- Never write an unverified AOSP id. The climate and window ids currently known are
used for reads only. Writes go through
saic.*, with every constant documented and validated per supported firmware generation. - English only — code, comments, commits, docs. User strings in
values/(English) +values-fr/.
Consuming it
Submodule at ./EVHardware; settings.gradle.kts includes EVHardware/lib as
:evhardware; app depends on project(":evhardware"). The library declares no
permissions and no sharedUserId — vehicle-write capability is the app's platform-signing
decision, not the library's.
Every consuming app tracks the HEAD of master. Never pin an older commit, and never
commit on a detached submodule HEAD: the catalogue is shared, so an entry removed here must
disappear from every app at once, and two apps on two lines of this library means the same
change written twice and reconciled by hand afterwards. Land library work in the standalone
checkout, push it, then move each app's pointer forward and run that app's tests.
Reflection + R8
All vehicle access reflects android.car (absent from the compile SDK). consumer-rules.pro
keeps the reflected names (android.car / SAIC / models / catalogue enums / @SupportedOn)
so a consumer's R8 does not strip them. Verify a minified consumer on a vehicle.
Build
mise run test | build | check. JDK 17. Tests are JVM-only (no emulator): gate decision,
firmware annotations, catalogue consistency, matrix generation.