iobroker.omoda

ioBroker.omoda

Tests:

omoda adapter for ioBroker

Brings your Omoda / Jaecoo car into ioBroker: vehicle status, GPS location, battery/charging, and remote lock and climate — using the same cloud backend as the official Omoda / Jaecoo app.

Unofficial, reverse-engineered software. Not affiliated with, endorsed by, or connected to Omoda, Jaecoo or Chery. Provided "as is", use at your own risk and only on your own vehicle. Names and trademarks belong to their respective owners. See the LICENSE.

What it does

• Status — doors, windows, sunroof, lock, engine, climate running, tyre pressures/temperatures.
• Location — GPS latitude/longitude, speed, heading.
• Battery & charging — state of charge, electric/total range, charge state, charging power, charge plug connected, remaining charge time.
• Commands — lock/unlock, climate on/off with a settable target temperature, request GPS location, and "wake & refresh full status".

Additional functions from the vehicle app (individual seat heating/ventilation, defrosters, EV charge start/stop and scheduled charging, windows/sunroof/trunk control, theft alarm) are planned for a later version.

Requirements

• An Omoda / Jaecoo account with the vehicle associated (owner or delegated access).
• The account email and command PIN.
• Region: defaults to Europe (also confirmed working in the UK). Other markets can be configured under Region & polling in the adapter settings.

Tip: consider using a delegated second account for the adapter. Logging in with the same account here and in the official app makes the two repeatedly log each other out.

Setup

1. Install the Omoda / Jaecoo adapter from the ioBroker admin Adapters tab and create an instance.
2. On the Account tab, enter your email and command PIN and save.
3. On the Login (OTP) tab, press Request OTP code — a one-time code is emailed to you.
4. Enter the code and press Confirm OTP. The adapter logs in and discovers your vehicle(s), creating a device per VIN under omoda.0.<VIN>.

A new OTP is only needed if the session later expires (typically because the official app was opened); otherwise the session is refreshed automatically.

Notes & safety

• The command PIN is your account PIN. Entering a wrong PIN repeatedly can lock the account, so the adapter stops after a couple of failed attempts — re-check the PIN in the settings before retrying.
• Many values read null while the car is in standby; battery, speed and mileage update while driving or charging, or after pressing Refresh full status (which briefly wakes the car).
• Waking the car is rate-limited by the backend, so the adapter enforces a cooldown.

Credits

This adapter is a port of the excellent reverse-engineering work in the Home Assistant integration omoda-jaecoo-ha by Caslinovich and JackRonan. The protocol constants, request-signing formulas, MQTT credential derivation, and endpoint recipes were recovered by them and are used here under the MIT License — this project would not exist without their effort. Please star and support the upstream project. All bugs in this ioBroker port are mine, not theirs.

Changelog

0.1.1 (2026-07-18)

• (Alan Paris) Security: never log the VIN or MQTT user id in cleartext (masked to a short suffix)
• (Alan Paris) Fixed a leak of the car MQTT client and polling timers when re-logging in after a session drop
• (Alan Paris) Added credit to the upstream Home Assistant integration (JackRonan/omoda-jaecoo-ha) in the README and LICENSE
• (Alan Paris) Added full admin UI translations for all 11 languages
• (Alan Paris) Config: clearer "Dept ID" help — it must match your account country's dialing code (UK=44, IT=39, …)
• (Alan Paris) Require Node.js >= 22 and admin >= 7.6.17; enabled automated npm publishing via trusted publishing (OIDC)
• (Alan Paris) Marked the OTP code as protected; various adapter-checker compliance fixes

0.1.0 (2026-07-18)

• (Alan Paris) initial release

License

MIT License

Copyright (c) 2026 Alan Paris alan.paris@scottish.rugby

Portions Copyright (c) 2026 Caslinovich and the omoda-jaecoo-ha contributors (JackRonan), ported from https://github.com/JackRonan/omoda-jaecoo-ha (MIT) and retained under its terms.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.