Hallo zusammen,

ich habe einen Adapter für Omoda / Jaecoo (Chery) Fahrzeuge geschrieben und würde mich über Tester freuen. Der Adapter ist seit kurzem im latest-Repository, Version 0.2.0.

(Entschuldigt bitte mein Deutsch — die englische Fassung steht unten. Antworten auf Englisch sind für mich einfacher, Deutsch geht aber auch.)

GitHub: https://github.com/AlanSRU/ioBroker.omoda
npm: https://www.npmjs.com/package/iobroker.omoda

Was der Adapter macht
Er verbindet sich mit demselben Cloud-Backend wie die offizielle Omoda-/Jaecoo-App (REST + MQTT-Telemetrie über mTLS) und legt pro Fahrzeug ein Gerät omoda.0.<VIN> an:

info – Name, Modell, Marke, Power-Typ, online (MQTT), letztes Update, Session-Status
location – Breite, Länge, Geschwindigkeit, Kurs, Zeitstempel
battery / charging – Ladestand, elektrische Reichweite, Gesamtreichweite, Ladezustand, Ladeleistung, Stecker eingesteckt, Restladezeit
doors / windows – 4 Türen, Kofferraum, Motorhaube, Verriegelung, 4 Fenster, Schiebedach
climate / status / tyres – Klima läuft, Min/Max-Temperatur, Motor an, Kilometerstand, Reifendruck und -temperatur (4x)
commands – Ver-/Entriegeln, Klima ein/aus mit Zieltemperatur, GPS-Position anfordern, „Wecken & Vollstatus abrufen", plus commands.result mit der letzten Rückmeldung des Autos
Weitere Funktionen der App (Sitzheizung/-belüftung, Defroster, Laden starten/stoppen und Ladeplanung, Fenster/Schiebedach/Kofferraum, Diebstahlalarm) sind für eine spätere Version geplant.

Voraussetzungen
Node.js >= 22, js-controller >= 6.0.11, Admin >= 7.6.20
Ein Omoda-/Jaecoo-Konto, dem das Fahrzeug zugeordnet ist (Besitzer oder freigegebener Zugriff)
E-Mail-Adresse und Kommando-PIN des Kontos
Installation & Einrichtung
Adapter aus dem latest-Repo installieren (oder per Custom-URL: iobroker url iobroker.omoda) und eine Instanz anlegen.
Reiter Konto: E-Mail und Kommando-PIN eintragen, speichern.
Reiter Login (OTP): OTP-Code anfordern — der Einmalcode kommt per E-Mail.
Code eintragen und OTP bestätigen. Der Adapter meldet sich an, findet die Fahrzeuge und legt die Objekte an.
Ein neuer OTP ist nur nötig, wenn die Session später abläuft (meistens weil die offizielle App geöffnet wurde) — sonst wird sie automatisch erneuert.

Tipp: Am besten ein zweites, freigegebenes Konto für den Adapter verwenden. Wenn ihr hier und in der App dasselbe Konto benutzt, werfen sich beide gegenseitig immer wieder raus.

Region: Standard ist Europa. Die Dept ID muss die Telefonvorwahl eures Kontolandes sein (UK = 44, IT = 39, ES = 34, NL = 31, DE = 49 …). Unter Region & Polling lassen sich Hosts, Poll-Intervall und Wake-Cooldown anpassen.

Bitte vorher lesen
⚠️ Inoffizielle, reverse-engineerte Software. Keine Verbindung zu Omoda, Jaecoo oder Chery. Benutzung auf eigene Gefahr und nur am eigenen Fahrzeug.
Die PIN ist eure Konto-PIN. Mehrfach falsch eingegeben kann das Konto sperren, deshalb stoppt der Adapter nach wenigen Fehlversuchen — dann bitte die PIN in den Einstellungen prüfen, bevor ihr weitermacht.
commands.lock folgt der ioBroker-Spezifikation switch.lock: true = ENTRIEGELN, false = verriegeln. Das ist bewusst so (Alexa/Google via ioBroker.iot, VIS-Widgets und der Type-Detector erwarten diese Polarität) — bitte nicht mit der App-Logik verwechseln.
Im Standby liefert das Auto viele Werte als null; Batterie, Geschwindigkeit und Kilometerstand aktualisieren sich beim Fahren oder Laden oder nach Vollstatus abrufen (weckt das Auto kurz). Das Wecken ist backend-seitig limitiert, deshalb erzwingt der Adapter einen Cooldown.
Die MQTT-Telemetrie nutzt mutual TLS mit den Zertifikaten, die die Upstream-HA-Integration extrahiert hat. Falls Chery die rotiert, muss eine neue Adapter-Version raus.
Worüber ich mich beim Feedback besonders freue
Fahrzeug + Land + Dept ID, mit denen es funktioniert (oder nicht) — z. B. „Omoda 5 EV, Deutschland, deptId 49". Getestet ist bisher hauptsächlich UK.
Welche Werte bleiben leer? Nicht jedes Modell meldet alles (Reifen, Schiebedach, Ladeleistung). Ein Screenshot des Objektbaums hilft.
info.powerType — Chery veröffentlicht die Codetabelle nicht. Bestätigt ist nur 0 = BEV und 1 = mit Verbrennungsmotor (OMODA 9 SHS). Wenn ihr einen anderen Wert seht, sagt mir bitte welches Modell.
Kommandos: funktionieren Verriegeln/Entriegeln und Klima, und was steht danach in commands.result?
Login-Probleme: Bei „contact customer service" ist es meistens entweder eine falsche Dept ID oder ein Konto ohne zugeordnetes Fahrzeug.
Bei Fehlern bitte das Log auf Debug stellen und den relevanten Ausschnitt posten. VIN und MQTT-User-ID werden im Log maskiert, aber schaut trotzdem kurz drüber, bevor ihr etwas öffentlich postet. Issues gerne auch direkt auf GitHub: https://github.com/AlanSRU/ioBroker.omoda/issues

Credits
Der Adapter ist eine Portierung der hervorragenden Reverse-Engineering-Arbeit aus der Home-Assistant-Integration omoda-jaecoo-ha von Caslinovich und JackRonan (MIT). Protokollkonstanten, Signaturberechnung, MQTT-Credential-Ableitung und die Endpoints stammen von ihnen — ohne dieses Projekt gäbe es den Adapter nicht. Schaut dort vorbei und gebt einen Stern. Alle Fehler in dieser ioBroker-Portierung sind meine, nicht ihre.

Danke fürs Testen!
Alan

English version
Hi all,

I've written an adapter for Omoda / Jaecoo (Chery) vehicles and I'm looking for testers. It's now in the latest repository, version 0.2.0.

GitHub: https://github.com/AlanSRU/ioBroker.omoda
npm: https://www.npmjs.com/package/iobroker.omoda

What it does
It talks to the same cloud backend as the official Omoda / Jaecoo app (REST plus MQTT telemetry over mutual TLS) and creates one device per vehicle at omoda.0.<VIN>:

info – name, model, brand, power type, online (MQTT), last update, session status
location – latitude, longitude, speed, heading, position timestamp
battery / charging – state of charge, electric range, total range, charge state, charging power, plug connected, remaining charge time
doors / windows – 4 doors, trunk, hood, locked, 4 windows, sunroof
climate / status / tyres – climate running, min/max temperature, engine on, odometer, tyre pressure and temperature (4x)
commands – lock/unlock, climate on/off with target temperature, request GPS location, "wake & refresh full status", plus commands.result carrying the car's last reply
Further app functions (seat heating/ventilation, defrosters, EV charge start/stop and scheduled charging, windows/sunroof/trunk, theft alarm) are planned for a later version.

Requirements
Node.js >= 22, js-controller >= 6.0.11, admin >= 7.6.20
An Omoda / Jaecoo account with the vehicle associated (owner or delegated access)
The account email and command PIN
Install & setup
Install the adapter from the latest repo (or via custom URL: iobroker url iobroker.omoda) and create an instance.
Account tab: enter email and command PIN, save.
Login (OTP) tab: press Request OTP code — a one-time code is emailed to you.
Enter it and press Confirm OTP. The adapter logs in, discovers your vehicles and creates the objects.
A new OTP is only needed if the session later expires (usually because the official app was opened); otherwise it refreshes automatically.

Tip: use a delegated second account for the adapter. Using the same account here and in the app makes the two repeatedly log each other out.

Region: defaults to Europe. The Dept ID must be your account country's dialing code (UK 44, IT 39, ES 34, NL 31, DE 49 …). Hosts, poll interval and wake cooldown are under Region & polling.

Please read first
⚠️ Unofficial, reverse-engineered software. Not affiliated with Omoda, Jaecoo or Chery. Use at your own risk and only on your own vehicle.
The PIN is your account PIN. Entering it wrong repeatedly can lock the account, so the adapter stops after a couple of failed attempts — re-check the PIN before retrying.
commands.lock follows the ioBroker switch.lock spec: true = UNLOCK, false = lock. That's deliberate (Alexa/Google via ioBroker.iot, VIS lock widgets and the type detector all assume this polarity) — don't confuse it with the app's logic.
Many values read null while the car is in standby; battery, speed and odometer update while driving or charging, or after Refresh full status (which briefly wakes the car). Waking is rate-limited by the backend, so the adapter enforces a cooldown.
MQTT telemetry uses mutual TLS with the certificates recovered by the upstream HA integration. If Chery rotates them, a new adapter release will be needed.
What feedback is most useful
Vehicle + country + Dept ID that work (or don't) — e.g. "Omoda 5 EV, Germany, deptId 49". Testing so far has been mostly UK.
Which values stay empty? Not every model reports everything (tyres, sunroof, charging power). A screenshot of the object tree helps.
info.powerType — Chery doesn't publish the code table. Only 0 = BEV and 1 = has a combustion engine (OMODA 9 SHS) are confirmed. If you see another value, tell me which model.
Commands: do lock/unlock and climate work, and what appears in commands.result afterwards?
Login trouble: a "contact customer service" error is usually either a wrong Dept ID or an account with no vehicle attached.
For errors please set the log level to debug and post the relevant part. The VIN and MQTT user id are masked in the log, but do give it a glance before posting publicly. GitHub issues welcome too: https://github.com/AlanSRU/ioBroker.omoda/issues

Credits
This adapter is a port of the excellent reverse-engineering work in the Home Assistant integration omoda-jaecoo-ha by Caslinovich and JackRonan (MIT). The protocol constants, request signing, MQTT credential derivation and endpoint recipes are theirs — this adapter wouldn't exist without them. Please go star and support the upstream project. All bugs in this ioBroker port are mine, not theirs.

Thanks for testing!
Alan