GitHub - SliDeeN/MG4Control: MG4Control is an android app that lets you adjust the MG4 EV's driving settings and apply them at startup

Application Android Automotive pour le contrôle avancé des paramètres de conduite du MG4 électrique. Android Automotive app for advanced driving settings control on the MG4 electric vehicle.

🇫🇷 Français

Présentation

MG4Control est une application système conçue pour Android Automotive OS, destinée à fonctionner sur les écrans de bord des véhicules MG4 équipés du SoC SAIC MT2712. Elle offre un accès direct et unifié aux réglages de conduite qui ne sont pas accessibles — ou difficilement accessibles — via l'interface constructeur.

L'application communique avec le véhicule via le SDK propriétaire SAIC, en accédant aux services Android Automotive (CarPropertyManager, CarHvacManager) ainsi qu'aux services de bas niveau exposés par le firmware du véhicule.

Important : Cette application nécessite des privilèges système (sharedUserId="android.uid.system") et doit être signée avec la clé de la ROM. Elle ne peut pas fonctionner sur un appareil standard débloqué.

[!WARNING] MG4Control est un projet communautaire indépendant. Il n'est en aucun cas affilié, approuvé ou soutenu par MG Motor, SAIC Motor ou l'une de leurs filiales. L'utilisation de cette application se fait entièrement à vos risques. Des réglages incorrects peuvent affecter le comportement du véhicule. Procédez avec précaution.

Fonctionnalités

Paramètres de conduite

Mode de conduite : ECO / NORMAL / SPORT / SNOW / CUSTOM
Régénération : Off / Faible / Moyen / Fort / Adaptatif / 1 Pédale

Climatisation

Volant chauffant : On / Off
Sièges chauffants gauche et droit : Off / Niveau 1 / 2 / 3

ADAS (Assistance à la conduite)

SWI133 : Off / Limiteur / Auto / ACC / ICA + alertes excès de vitesse / changement de limite
SWI68 : Désactiver / ACC / TJA + avertissement sonore On / Off
SWI69 / SWI131 : Anti-collision avant (AEB) — On / Off + mode Alerte uniquement / Alerte + Freinage
SWI165 : Désactiver / ACC / TJA + Anti-collision avant (AEB) On/Off + mode Alerte / Alerte+Freinage + avertissement sonore

Raccourcis volant

Configuration des 4 boutons du volant (boutons latéraux gauche/droit)
Actions disponibles : Mode de conduite / Régénération / ADAS / Ouvrir l'application
Activation / désactivation des raccourcis avec dialog d'avertissement

Gestion de profils

Sauvegarde jusqu'à 5 profils personnalisés
Application instantanée d'un profil en un clic
Application automatique du profil par défaut au démarrage du véhicule

Réglages

Choix de la langue (Français / English)
Activation/désactivation de l'application automatique du profil
Mise à jour automatique : vérification GitHub + téléchargement APK vers le dossier Téléchargements
Nettoyage APK : suppression des anciens fichiers MGControl*.apk du dossier Téléchargements
Dialog "À propos" avec version de l'app, version firmware et QR code GitHub
Bouton "Fermer" pour revenir directement au dashboard

Profils

Bouton "Fermer" pour revenir directement au dashboard

Compatibilité firmware inconnue (UNKNOWN)

Dialog d'avertissement au démarrage si le firmware n'est ni SWI133 ni SWI68
L'utilisateur peut fermer l'application ou continuer
En mode "Continuer", les chips SWI133 / SWI68 / SWI69 / SWI131 deviennent cliquables pour forcer un mode de compatibilité
Le choix forcé est persisté en SharedPreferences et survit aux redémarrages de l'app

Compatibilité

Élément	Valeur
Véhicule cible	MG4 Electric (SAIC)
OS	Android Automotive 9+ (API 28+)
SoC	SAIC MT2712
Résolution d'écran	1280 × 480 (orientation paysage forcée)
Firmware SWI133	Compatible ✅
Firmware SWI68	Compatible ✅
Firmware SWI69 / SWI131	Compatible ✅
Firmware SWI165	Compatible ✅
Firmware UNKNOWN	Mode forcé SWI133/SWI68/SWI69/SWI131/SWI165 disponible ⚠️

Architecture

Vue d'ensemble

┌──────────────────────────────────────────────────────┐
│                    INTERFACE                          │
│  MainActivity ─── NavController ─── Fragment Host   │
│  ┌─────────────┐  ┌──────────────┐  ┌─────────────┐ │
│  │  Dashboard  │  │   Profils    │  │  Réglages   │ │
│  └─────────────┘  └──────────────┘  └─────────────┘ │
└──────────────────────────────────────────────────────┘
                         │
┌──────────────────────────────────────────────────────┐
│                 COUCHE MÉTIER                         │
│  ProfileManager  ─  ProfileApplier  ─  FirmwareInfo  │
└──────────────────────────────────────────────────────┘
                         │
┌──────────────────────────────────────────────────────┐
│            ABSTRACTION MATÉRIELLE (MG4Hardware)       │
│  Katman1 (Car API) → Katman2 (Binder) → Katman4      │
│                      (ADAS / SWI133 / SWI68)          │
└──────────────────────────────────────────────────────┘
                         │
┌──────────────────────────────────────────────────────┐
│              SERVICES SYSTÈME & BOOT                  │
│      MG4ControlService  ─────  BootReceiver          │
└──────────────────────────────────────────────────────┘

Démarrage de l'application

Démarrage véhicule
       │
       ▼
BootReceiver.onReceive()
       │
       ▼
MG4ControlService.onCreate()
  └─ MG4Hardware.init()
  └─ Découverte des services Katman1 / Katman4
  └─ Application du profil par défaut (si activé)
       │
       ▼
MainActivity (IHM)
  └─ FirmwareInfo.initWithContext()     ← charge mode forcé (SharedPreferences)
  └─ Détection du firmware (SWI133 / SWI68 / UNKNOWN)
  └─ Configuration de la top bar (chips firmware)
  └─ checkUnknownFirmware()             ← dialog si UNKNOWN et non forcé
  └─ Navigation vers DashboardFragment

Structure du projet

MG4Control/
├── app/src/main/
│   ├── java/com/mg4/control/
│   │   ├── MG4App.kt                  # Application — mode nuit, locale
│   │   ├── MainActivity.kt            # Activité principale, top bar, navigation
│   │   │
│   │   ├── model/
│   │   │   ├── DrivingProfile.kt      # Modèle de données d'un profil
│   │   │   ├── DriveMode.kt           # Enum modes de conduite (ECO/NORMAL/SPORT/SNOW/CUSTOM)
│   │   │   └── RegenLevel.kt          # Enum niveaux de régénération
│   │   │
│   │   ├── profile/
│   │   │   ├── ProfileManager.kt      # CRUD profils (SharedPreferences + Gson)
│   │   │   └── ProfileApplier.kt      # Application des réglages au véhicule (async)
│   │   │
│   │   ├── hardware/
│   │   │   └── MG4Hardware.kt         # Abstraction matérielle (4 couches)
│   │   │
│   │   ├── ui/
│   │   │   ├── DashboardFragment.kt   # Écran principal unifié
│   │   │   ├── ProfileFragment.kt     # Gestion des profils
│   │   │   ├── SettingsFragment.kt    # Réglages & À propos
│   │   │   ├── ProfileAdapter.kt      # Adaptateur RecyclerView profils
│   │   │   ├── ConsoleFragment.kt     # Journal de debug en temps réel
│   │   │   ├── DriveRegenFragment.kt  # Héritage (non utilisé en v2)
│   │   │   ├── ClimateFragment.kt     # Héritage (non utilisé en v2)
│   │   │   └── AdasFragment.kt        # Héritage (non utilisé en v2)
│   │   │
│   │   ├── service/
│   │   │   └── MG4ControlService.kt   # Service de premier plan (boot + auto-apply)
│   │   │
│   │   ├── receiver/
│   │   │   └── BootReceiver.kt        # Récepteur de démarrage système
│   │   │
│   │   ├── util/
│   │   │   ├── FirmwareInfo.kt        # Détection firmware (SWI133/SWI68/UNKNOWN) + mode forcé
│   │   │   ├── FirmwareHelper.kt      # Lecture version firmware complète (async)
│   │   │   └── LocaleHelper.kt        # Gestion de la langue (FR / EN)
│   │   │
│   │   └── update/
│   │       ├── UpdateChecker.kt       # Vérification dernière release GitHub (API)
│   │       ├── UpdateDialogManager.kt # Dialog MAJ + DownloadManager + ouverture dossier
│   │   │
│   │   └── debug/
│   │       └── AppLogger.kt           # Buffer de logs en mémoire (400 entrées)
│   │
│   ├── res/
│   │   ├── layout/
│   │   │   ├── activity_main.xml      # Top bar + NavHostFragment
│   │   │   ├── fragment_dashboard.xml # Écran principal (conduite + climat + alertes)
│   │   │   ├── fragment_profile.xml   # Liste des profils
│   │   │   ├── fragment_settings.xml  # Réglages
│   │   │   ├── item_profile.xml       # Item liste de profil
│   │   │   ├── dialog_profile_edit.xml       # Dialog création / édition de profil
│   │   │   ├── dialog_app_info.xml           # Dialog "À propos"
│   │   │   └── dialog_unknown_firmware.xml   # Dialog firmware inconnu (UNKNOWN)
│   │   ├── navigation/nav_graph.xml   # Dashboard → Profils / Réglages
│   │   ├── values/strings.xml         # Chaînes FR
│   │   ├── values-en/strings.xml      # Chaînes EN
│   │   └── values/colors.xml          # Palette dash_* (dark theme)
│   │
│   └── AndroidManifest.xml
│
└── mockup/
    └── index.html                     # Maquette interactive HTML 1280×480

Couches matérielles

MG4Hardware est organisé en 4 couches d'accès, du plus haut niveau au plus bas, avec repli automatique en cas d'échec.

Katman1 — Android Automotive Car API

Couche principale. Utilise les APIs officielles Android Automotive :

CarPropertyManager → modes de conduite, régénération, pédale unique
CarHvacManager → siège chauffant, volant chauffant

La connexion est initialisée par réflexion sur Car.createCar() avec plusieurs surcharges tentées successivement. Les actions en attente sont mises en file d'attente et exécutées dès que le service est prêt.

Katman2 — Raw Binder (fallback)

Repli sur ServiceManager.getService("vehiclesetting") avec appels binderTransact() directs. Souvent bloqué par SELinux en production.

Katman4 — Services ADAS (firmware-specific)

Couche dédiée aux fonctions ADAS, chargée dynamiquement selon la génération de firmware :

Firmware	Service	Mécanisme
SWI133	`VehiclePropertyManager`	Chargé depuis l'APK launcher via `ClassLoader` + réflexion sur `mIVehiclePropertyService`. Utilise `getMixProperty()` / `setMixProperty()`
SWI68	`VehicleSettingManager`	Singleton statique chargé via réflexion. Utilise `setAccTjaMode()` / `setLaneKeepingWarningSound()`
SWI69 / SWI131	`VehicleSettingManager`	Même singleton que SWI68. Utilise `setFcwState()` / `getFcwState()` / `setFcwAutoBrakeMode()` / `setFcwSensitivity()` pour l'AEB. Valeurs confirmées empiriquement sur véhicule réel : `setFcwState(1)` = DÉSACTIVER, `setFcwState(2)` = ACTIVER.
SWI165	`VehicleSettingManager`	Même SDK que SWI68 (`com.saicmotor.sdk.vehiclesettings`). ADAS via `setAccTjaMode()`. AEB via `setAutoEmergencyBraking(1/2)` comme toggle principal + `setFcwAlarmMode(1/2)` + `setFcwAutoBrakeMode(1/2)`. Modes : 1=OFF, 2=ON.

Détection du firmware

// util/FirmwareInfo.kt
FirmwareInfo.initWithContext(context)   // Charge le mode forcé depuis SharedPreferences
val gen = FirmwareInfo.getGeneration()  // Lit ro.build.mt2712.version
// → Gen.SWI133 | Gen.SWI68 | Gen.UNKNOWN

// Si firmware inconnu, l'utilisateur peut forcer un mode :
FirmwareInfo.forceGeneration(context, FirmwareInfo.Gen.SWI133)
FirmwareInfo.isForced(context)          // true si mode forcé actif
FirmwareInfo.getDetectedString()        // Ex : "SWI69-12345" (brut)

Le résultat est mis en cache. Si le firmware est UNKNOWN et aucun mode forcé, un dialog d'avertissement s'affiche au démarrage. L'utilisateur peut choisir de continuer et forcer SWI133 ou SWI68 via les chips de la top bar.

Système de profils

Modèle `DrivingProfile`

data class DrivingProfile(
    val id: String,             // UUID unique
    val name: String,           // Nom affiché
    val driveMode: DriveMode,   // ECO / NORMAL / SPORT / SNOW / CUSTOM
    val regenLevel: RegenLevel, // OFF / LOW / MEDIUM / HIGH / ADAPTIVE / ONE_PEDAL
    val steeringHeat: Boolean,
    val seatHeatLeft: Int,      // 0–3
    val seatHeatRight: Int,     // 0–3
    // SWI133 uniquement :
    val overspeedAlarm: Boolean,
    val speedLimitTone: Boolean,
    val adasMode: Int,          // 0=Off 1=Lim 2=Auto 3=ACC 4=ICA
    // SWI68 uniquement :
    val soundWarning: Boolean,
    val swi68AdasMode: Int      // Swi68Mode.OFF / ACC / TJA
)

Persistance

Les profils sont sérialisés en JSON via Gson et stockés dans SharedPreferences. Maximum 5 profils par appareil.

Application d'un profil

ProfileApplier.apply() exécute les appels matériels dans l'ordre suivant sur Dispatchers.IO :

Mode de conduite (rapide — binder)
Niveau de régénération (rapide — binder)
Volant chauffant (~2 s — polling de confirmation d'état)
Siège gauche (~7 s — polling par toggle)
Siège droit (~7 s — polling par toggle)
Attente Katman4 → ADAS (selon firmware)

Interface utilisateur

Navigation

L'application utilise un NavController avec 3 destinations :

DashboardFragment (départ)
    ├──► ProfileFragment  (bouton PROFILS — toggle)
    └──► SettingsFragment (bouton RÉGLAGES — toggle)

Un second appui sur PROFILS ou RÉGLAGES ferme la vue et revient au dashboard.

Dashboard (écran principal)

Disposition en 2 rangées (ratio 2:1) optimisée pour 1280×480 :

Rangée haute (2/3) : Mode de conduite | Régénération | ADAS
Rangée basse (1/3) : Climatisation (volant + sièges) | Alertes

Dark theme — palette de couleurs

Token	Hex	Usage
`dash_bg`	`#0C0C0E`	Fond général
`dash_card`	`#141416`	Cartes
`dash_section`	`#1C1C1F`	Sections internes
`dash_border`	`#2A2A2E`	Bordures
`dash_accent`	`#38BDF8`	Sélection active (bleu)
`dash_eco`	`#22C55E`	Mode ECO (vert)
`dash_warn`	`#F59E0B`	Mode SPORT (orange)
`dash_danger`	`#F43F5E`	Suppression / danger

Compilation et installation

Vous pouvez directement télécharger la dernière version de MG4Control via les releases : https://github.com/SliDeeN/MG4Control/releases Il ne vous faut qu'une clé USB et l'accès aux paramètres AAOS afin d'installer l'APK.

Vous pouvez aussi compiler vous même le projet :

Prérequis

Android Studio Hedgehog (2023.1) ou supérieur
JDK 17+
Android SDK API 34

Build debug

# Avec le JDK d'Android Studio
JAVA_HOME="/path/to/Android Studio/jbr" ./gradlew assembleDebug

L'APK se trouve dans :

app/build/outputs/apk/debug/app-debug.apk

Installation sur le véhicule

L'application nécessite d'être signée avec la clé système de la ROM. Sur un système de développement :

adb push app-debug.apk /sdcard/
adb shell pm install -r --system /sdcard/app-debug.apk

Sur une ROM de production, l'APK doit être incluse dans le build système ou installée via un mécanisme OEM spécifique.

Permissions requises

Permission	Justification
`FOREGROUND_SERVICE`	Service de premier plan pour l'auto-apply
`WAKE_LOCK`	Empêche le sleep pendant l'application des réglages
`RECEIVE_BOOT_COMPLETED`	Démarrage automatique au boot
`CAR_POWERTRAIN`	Contrôle du mode de conduite et de la régénération
`CONTROL_CAR_CLIMATE`	Contrôle des sièges et du volant chauffants
`CAR_VENDOR_EXTENSION`	Extensions propriétaires SAIC
`CAR_ENERGY`	Informations batterie / motorisation
`INTERNET`	Vérification des mises à jour (GitHub API)
`DOWNLOAD_WITHOUT_NOTIFICATION`	Téléchargement silencieux de l'APK de mise à jour
`WRITE_EXTERNAL_STORAGE`	Enregistrement APK dans le dossier Téléchargements

🇬🇧 English

Overview

MG4Control is a system-level application designed for Android Automotive OS, intended to run on the head unit of MG4 electric vehicles equipped with the SAIC MT2712 SoC. It provides direct, unified access to driving settings that are unavailable — or poorly accessible — through the stock manufacturer interface.

The app communicates with the vehicle through the proprietary SAIC SDK, accessing Android Automotive services (CarPropertyManager, CarHvacManager) as well as low-level services exposed by the vehicle's firmware.

Important: This application requires system privileges (sharedUserId="android.uid.system") and must be signed with the ROM's platform key. It cannot run on a standard unlocked device.

[!WARNING] MG4Control is an independent community project. It is in no way affiliated with, endorsed by, or supported by MG Motor, SAIC Motor, or any of their subsidiaries. Use this application entirely at your own risk. Incorrect settings may affect vehicle behaviour. Proceed with caution.

Features

Driving Settings

Drive mode: ECO / NORMAL / SPORT / SNOW / CUSTOM
Regenerative braking: Off / Low / Medium / High / Adaptive / One Pedal

Climate Control

Heated steering wheel: On / Off
Heated seats (left & right): Off / Level 1 / 2 / 3

ADAS (Advanced Driver Assistance)

SWI133: Off / Speed Limiter / Auto / ACC / ICA + overspeed alert / speed limit change alert
SWI68: Disable / ACC / TJA + audible warning On / Off
SWI69 / SWI131: Forward Collision Warning (AEB) — On / Off + mode Alert only / Alert + Emergency Braking

Steering Wheel Shortcuts

Configure 4 steering wheel buttons (left/right side buttons)
Available actions: Drive mode / Regeneration / ADAS / Open app
Enable/disable shortcuts with a warning dialog

Profile Management

Save up to 5 custom profiles
Instant one-tap profile application
Automatic default profile application on vehicle startup

Settings

Language selection (French / English)
Enable/disable automatic profile application
Auto-update: GitHub release check + APK download to Downloads folder
APK cleanup: removes old MGControl*.apk files from Downloads folder
"About" dialog showing app version, firmware version, and GitHub QR code

Compatibility

Item	Value
Target vehicle	MG4 Electric (SAIC)
OS	Android Automotive 9+ (API 28+)
SoC	SAIC MT2712
Screen resolution	1280 × 480 (forced landscape)
SWI133 firmware	Supported ✅
SWI68 firmware	Supported ✅
SWI69 / SWI131 firmware	Supported ✅
SWI165 firmware	Supported ✅
UNKNOWN firmware	Forced SWI133/SWI68/SWI69/SWI131/SWI165 mode available ⚠️

Architecture

Overview

┌──────────────────────────────────────────────────────┐
│                      UI LAYER                         │
│  MainActivity ─── NavController ─── Fragment Host    │
│  ┌─────────────┐  ┌──────────────┐  ┌─────────────┐ │
│  │  Dashboard  │  │   Profiles   │  │  Settings   │ │
│  └─────────────┘  └──────────────┘  └─────────────┘ │
└──────────────────────────────────────────────────────┘
                         │
┌──────────────────────────────────────────────────────┐
│                  BUSINESS LOGIC                       │
│  ProfileManager  ─  ProfileApplier  ─  FirmwareInfo  │
└──────────────────────────────────────────────────────┘
                         │
┌──────────────────────────────────────────────────────┐
│           HARDWARE ABSTRACTION (MG4Hardware)          │
│  Katman1 (Car API) → Katman2 (Binder) → Katman4      │
│                      (ADAS / SWI133 / SWI68)          │
└──────────────────────────────────────────────────────┘
                         │
┌──────────────────────────────────────────────────────┐
│               SYSTEM SERVICES & BOOT                  │
│       MG4ControlService  ─────  BootReceiver         │
└──────────────────────────────────────────────────────┘

Startup Sequence

Vehicle boot
       │
       ▼
BootReceiver.onReceive()
       │
       ▼
MG4ControlService.onCreate()
  └─ MG4Hardware.init()
  └─ Katman1 / Katman4 service discovery
  └─ Apply default profile (if enabled)
       │
       ▼
MainActivity (UI)
  └─ Firmware detection (SWI133 / SWI68)
  └─ Top bar setup
  └─ Navigate to DashboardFragment

Project Structure

MG4Control/
├── app/src/main/
│   ├── java/com/mg4/control/
│   │   ├── MG4App.kt                  # Application — night mode, locale
│   │   ├── MainActivity.kt            # Main activity, top bar, navigation
│   │   │
│   │   ├── model/
│   │   │   ├── DrivingProfile.kt      # Profile data model
│   │   │   ├── DriveMode.kt           # Drive mode enum (ECO/NORMAL/SPORT/SNOW/CUSTOM)
│   │   │   └── RegenLevel.kt          # Regen level enum
│   │   │
│   │   ├── profile/
│   │   │   ├── ProfileManager.kt      # Profile CRUD (SharedPreferences + Gson)
│   │   │   └── ProfileApplier.kt      # Applies settings to vehicle (async)
│   │   │
│   │   ├── hardware/
│   │   │   └── MG4Hardware.kt         # Hardware abstraction (4 layers)
│   │   │
│   │   ├── ui/
│   │   │   ├── DashboardFragment.kt   # Unified main screen
│   │   │   ├── ProfileFragment.kt     # Profile management
│   │   │   ├── SettingsFragment.kt    # Settings & About
│   │   │   ├── ProfileAdapter.kt      # Profile list RecyclerView adapter
│   │   │   ├── ConsoleFragment.kt     # Real-time debug log viewer
│   │   │   ├── DriveRegenFragment.kt  # Legacy (unused in v2)
│   │   │   ├── ClimateFragment.kt     # Legacy (unused in v2)
│   │   │   └── AdasFragment.kt        # Legacy (unused in v2)
│   │   │
│   │   ├── service/
│   │   │   └── MG4ControlService.kt   # Foreground service (boot + auto-apply)
│   │   │
│   │   ├── receiver/
│   │   │   └── BootReceiver.kt        # System boot receiver
│   │   │
│   │   ├── util/
│   │   │   ├── FirmwareInfo.kt        # Firmware generation detection (SWI133 / SWI68)
│   │   │   ├── FirmwareHelper.kt      # Full firmware version string reader (async)
│   │   │   └── LocaleHelper.kt        # Language management (FR / EN)
│   │   │
│   │   └── debug/
│   │       └── AppLogger.kt           # In-memory log ring buffer (400 entries)
│   │
│   ├── res/
│   │   ├── layout/
│   │   │   ├── activity_main.xml      # Top bar + NavHostFragment
│   │   │   ├── fragment_dashboard.xml # Main screen (drive + climate + alerts)
│   │   │   ├── fragment_profile.xml   # Profile list
│   │   │   ├── fragment_settings.xml  # Settings screen
│   │   │   ├── item_profile.xml       # Profile list item
│   │   │   ├── dialog_profile_edit.xml# Profile create / edit dialog
│   │   │   └── dialog_app_info.xml    # About dialog
│   │   ├── navigation/nav_graph.xml   # Dashboard → Profiles / Settings
│   │   ├── values/strings.xml         # French strings
│   │   ├── values-en/strings.xml      # English strings
│   │   └── values/colors.xml          # dash_* color palette (dark theme)
│   │
│   └── AndroidManifest.xml
│
└── mockup/
    └── index.html                     # Interactive HTML mockup (1280×480)

Hardware Layers

MG4Hardware is organized into 4 access layers, from highest to lowest level, with automatic fallback on failure.

Katman1 — Android Automotive Car API

Primary layer. Uses official Android Automotive APIs:

CarPropertyManager → drive modes, regeneration, one-pedal
CarHvacManager → seat heating, steering wheel heating

The connection is initialized via reflection on Car.createCar() with multiple overloads tried in sequence. Pending actions are queued and executed once the service is ready, with exponential backoff retry (2 s → 60 s).

Katman2 — Raw Binder (fallback)

Falls back to ServiceManager.getService("vehiclesetting") with direct binderTransact() calls. Usually blocked by SELinux in production builds.

Katman4 — ADAS Services (firmware-specific)

Dedicated layer for ADAS functions, dynamically loaded according to the detected firmware generation:

Firmware	Service	Mechanism
SWI133	`VehiclePropertyManager`	Loaded from the launcher APK via `ClassLoader` + reflection on `mIVehiclePropertyService`. Uses `getMixProperty()` / `setMixProperty()`
SWI68	`VehicleSettingManager`	Static singleton loaded via reflection. Uses `setAccTjaMode()` / `setLaneKeepingWarningSound()`
SWI69 / SWI131	`VehicleSettingManager`	Same singleton as SWI68. Uses `setFcwState()` / `getFcwState()` / `setFcwAutoBrakeMode()` / `setFcwSensitivity()` for AEB. Values confirmed empirically on real hardware: `setFcwState(1)` = DISABLE, `setFcwState(2)` = ENABLE.
SWI165	`VehicleSettingManager`	Same SDK as SWI68 (`com.saicmotor.sdk.vehiclesettings`). ADAS via `setAccTjaMode()`. AEB via `setAutoEmergencyBraking(1/2)` as the main toggle + `setFcwAlarmMode(1/2)` + `setFcwAutoBrakeMode(1/2)`. Values: 1=OFF, 2=ON.

Firmware Detection

// util/FirmwareInfo.kt
val gen = FirmwareInfo.getGeneration()  // Reads ro.build.mt2712.version
// → Gen.SWI133 | Gen.SWI68 | Gen.UNKNOWN

The result is cached and used throughout the app to branch firmware-specific code paths.

Profile System

`DrivingProfile` Model

data class DrivingProfile(
    val id: String,             // Unique UUID
    val name: String,           // Display name
    val driveMode: DriveMode,   // ECO / NORMAL / SPORT / SNOW / CUSTOM
    val regenLevel: RegenLevel, // OFF / LOW / MEDIUM / HIGH / ADAPTIVE / ONE_PEDAL
    val steeringHeat: Boolean,
    val seatHeatLeft: Int,      // 0–3
    val seatHeatRight: Int,     // 0–3
    // SWI133 only:
    val overspeedAlarm: Boolean,
    val speedLimitTone: Boolean,
    val adasMode: Int,          // 0=Off 1=Limiter 2=Auto 3=ACC 4=ICA
    // SWI68 only:
    val soundWarning: Boolean,
    val swi68AdasMode: Int      // Swi68Mode.OFF / ACC / TJA
)

Persistence

Profiles are serialized to JSON via Gson and stored in SharedPreferences. Maximum 5 profiles per device.

Applying a Profile

ProfileApplier.apply() executes hardware calls in the following order on Dispatchers.IO:

Drive mode (fast — binder call)
Regen level (fast — binder call)
Heated steering wheel (~2 s — state confirmation polling)
Left seat heating (~7 s — toggle polling)
Right seat heating (~7 s — toggle polling)
Wait for Katman4 → ADAS (firmware-dependent)

User Interface

Navigation

The app uses a NavController with 3 destinations:

DashboardFragment (start)
    ├──► ProfileFragment  (PROFILS button — toggle)
    └──► SettingsFragment (RÉGLAGES button — toggle)

A second press on PROFILS or RÉGLAGES closes the view and returns to the dashboard.

Dashboard (main screen)

2-row layout (2:1 weight ratio) optimized for 1280×480:

Top row (2/3 height): Drive mode | Regeneration | ADAS
Bottom row (1/3 height): Climate (steering + seats) | Alerts

Dark Theme — Color Palette

Token	Hex	Usage
`dash_bg`	`#0C0C0E`	App background
`dash_card`	`#141416`	Cards
`dash_section`	`#1C1C1F`	Inner sections
`dash_border`	`#2A2A2E`	Borders
`dash_accent`	`#38BDF8`	Active selection (blue)
`dash_eco`	`#22C55E`	ECO mode (green)
`dash_warn`	`#F59E0B`	SPORT mode (amber)
`dash_danger`	`#F43F5E`	Delete / danger actions

Build & Installation

You can download the latest version of MG4Control directly from the releases page: https://github.com/SliDeeN/MG4Control/releases All you need is a USB drive and access to the AAOS settings to install the APK.

You can also compile the project yourself:

Prerequisites

Android Studio Hedgehog (2023.1) or later
JDK 17+
Android SDK API 34

Debug Build

# Using Android Studio's bundled JDK
JAVA_HOME="/path/to/Android Studio/jbr" ./gradlew assembleDebug

Output APK location:

app/build/outputs/apk/debug/app-debug.apk

Installing on the Vehicle

The application must be signed with the ROM's system key. On a development system:

adb push app-debug.apk /sdcard/
adb shell pm install -r --system /sdcard/app-debug.apk

On a production ROM, the APK must be included in the system build or installed through an OEM-specific mechanism.

Required Permissions

Permission	Reason
`FOREGROUND_SERVICE`	Persistent foreground service for auto-apply
`WAKE_LOCK`	Prevents sleep during settings application
`RECEIVE_BOOT_COMPLETED`	Auto-start on vehicle boot
`CAR_POWERTRAIN`	Drive mode and regeneration control
`CONTROL_CAR_CLIMATE`	Seat and steering wheel heating control
`CAR_VENDOR_EXTENSION`	SAIC proprietary extensions
`CAR_ENERGY`	Battery / powertrain information

Credits

Made with ❤ by SliDeeN and Claude IA

Basé sur l'application DriveHub Dort développée par Merth4n & hotboy_ist

Remerciements spéciaux à confor1max pour les tests approfondis du firmware SWI68 🙏

Name		Name	Last commit message	Last commit date
Latest commit History 36 Commits
.github		.github
app		app
gradle		gradle
.gitattributes		.gitattributes
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
build.gradle.kts		build.gradle.kts
gradle.properties		gradle.properties
gradlew		gradlew
gradlew.bat		gradlew.bat
mg4control_github_banner.svg		mg4control_github_banner.svg
settings.gradle.kts		settings.gradle.kts

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

Table des matières

Présentation

Fonctionnalités

Paramètres de conduite

Climatisation

ADAS (Assistance à la conduite)

Raccourcis volant

Gestion de profils

Réglages

Profils

Compatibilité firmware inconnue (UNKNOWN)

Compatibilité

Architecture

Vue d'ensemble

Démarrage de l'application

Structure du projet

Couches matérielles

Katman1 — Android Automotive Car API

Katman2 — Raw Binder (fallback)

Katman4 — Services ADAS (firmware-specific)

Détection du firmware

Système de profils

Modèle DrivingProfile

Persistance

Application d'un profil

Interface utilisateur

Navigation

Dashboard (écran principal)

Dark theme — palette de couleurs

Compilation et installation

Prérequis

Build debug

Installation sur le véhicule

Permissions requises

Table of Contents

Overview

Features

Driving Settings

Climate Control

ADAS (Advanced Driver Assistance)

Steering Wheel Shortcuts

Profile Management

Settings

Compatibility

Architecture

Overview

Startup Sequence

Project Structure

Hardware Layers

Katman1 — Android Automotive Car API

Katman2 — Raw Binder (fallback)

Katman4 — ADAS Services (firmware-specific)

Firmware Detection

Profile System

DrivingProfile Model

Persistence

Applying a Profile

User Interface

Navigation

Dashboard (main screen)

Dark Theme — Color Palette

Build & Installation

Prerequisites

Debug Build

Installing on the Vehicle

Required Permissions

Credits

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Modèle `DrivingProfile`

`DrivingProfile` Model

Packages