Leapmotor Vehicle Integration

Unofficial Leapmotor electric vehicle integration for ioBroker. Tested on T03.

⚠️ Important: Use a Second Account

Do not use your main Leapmotor account!

The adapter maintains a permanent session with the Leapmotor cloud. If the same account is used simultaneously in the Leapmotor app, both sessions will conflict and log each other out.

Recommended setup:

1. Create a second Leapmotor account (e.g. with a second email address)
2. In the Leapmotor app, navigate to: Personal Center → My Vehicle → [Vehicle Name] → Shared Members → Add Shared Member
3. Enter the second account's email and grant all rights
4. Use the second account credentials in the adapter configuration

This way your main account stays logged in to the app at all times.

Features

• React-based admin dashboard with Dashboard, Consumption, Trips, Datapoints, and Diagnostics tabs
• Vehicle status polling every 1–60 minutes (configurable)
• Battery SOC, range, temperature, tire pressure, GPS, doors, windows
• Remote control: climate (heat/cool/vent), lock/unlock, windows, sunshade, trunk, find
• Climate scheduling (recurring, by weekday) and charge limit / charge scheduling
• Comfort features where supported by the vehicle: sentry mode, seat heat/ventilation, steering wheel heat, speed limit, mirror heat
• Trip detection with daily kilometer tracking and individual trip history, GPS route recording (opt-in), trip merge/undo, elevation gain, min/max outdoor temperature and a regen estimate per trip
• CSV and PDF (table + summary) trip-log export for a chosen date range
• Configurable trip/GPS-route history retention (days, 0 = forever, with a hard safety cap)
• Prepare-to-Drive: auto climate (heat/cool/vent) on ignition-on, based on outdoor temperature thresholds, with lock-state and self-triggered-command guards against false positives
• Prepare-to-Work: same climate-prep core, triggered via a datapoint instead of an ignition edge (for shift-schedule/calendar automations)
• Sunshade/sunroof automation for both Prepare-to-Drive/Work, with separate positions for heat/cool/vent and a "open when dark" rule (except when heating for cold protection)
• Outdoor temperature from Open-Meteo (not the vehicle's own sensor - missing on some models, e.g. B10, and misleading when parked in a garage), 30-minute cache with fallback to the last known value on API errors
• Estimated battery health (SoH) from official per-trip cloud energy vs. SoC used, median of the last 30 trips
• Home/public charging cost split by GPS distance to a configurable home location (address search via Nominatim + map with draggable marker/radius), with separate electricity prices - home can use a dynamic price datapoint (e.g. Tibber), public is always a fixed manual price
• Charging cost estimation based on configurable electricity price
• Vehicle messages and unread count
• Vehicle-model-specific feature capability system (unsupported features are hidden automatically)
• Consumption statistics with weekly history
• Dynamic vehicle dashboard (composite HTML widget for VIS)
• Automatic token refresh
• Picture cache (downloaded once, stored locally)
• Notifications (adapter-agnostic via sendTo, incl. telegrammenu2 severity/area and email): trip done, charge done, OTA update, window-left-open warning, Prepare-to-Drive/Work triggered - with a test-notification button in the Settings tab

Tested Vehicles

• Leapmotor T03 ✅ (fully tested, including all remote commands)
• Leapmotor B10 - status/data reporting extensively verified by a real owner (battery, range, mileage, speed, ignition, all doors, all windows, tire pressure, sunroof, GPS, charge plan, charge limit, AC vent direction); remote commands (lock, climate, etc.) not separately confirmed via the adapter's own buttons, but expected to work (same command subsystem as T03)
• Leapmotor C10 / C16 - should work, not yet verified

Installation

Install via ioBroker Admin UI.

Configuration

Everything else (polling intervals, GPS route recording, notifications, electricity prices, home location, Prepare-to-Drive/Work, data retention) has moved out of the native instance config into the Settings tab inside the Leapmotor admin dashboard itself.

Datapoints

leapmotor.0.<VIN>.status.*                → Vehicle status (read-only)
leapmotor.0.<VIN>.consumption.*           → Consumption & statistics (read-only)
leapmotor.0.<VIN>.trips.*                 → Daily kilometers and trip history (read-only)
leapmotor.0.<VIN>.charging.*              → Current charging session cost/kWh (read-only)
leapmotor.0.<VIN>.pictures.*              → Vehicle images, including an animated composite image (read-only)
leapmotor.0.<VIN>.cmd.*                   → Commands (writable)
leapmotor.0.<VIN>.info.*                  → Static vehicle info (read-only)
leapmotor.0.messages.*                    → Vehicle messages from the Leapmotor app (read-only)
leapmotor.0.config.*                      → Electricity price / battery capacity, Prepare-to-Drive/Work,
                                             home location & radius, notification targets, and
                                             trip/route history retention settings
leapmotor.0.<VIN>.battery.soh_percent     → Estimated battery health (State of Health, read-only)

The full set of available datapoints, including all writable command states, is best explored directly in the ioBroker object tree, or via the Datapoints tab in the adapter's own admin UI — it lists every datapoint with its current value and a short description.

Admin Dashboard

The adapter ships its own React-based admin tab (click the adapter icon in the instance list) with five sub-tabs: Dashboard (live status and remote control), Consumption (weekly energy use and cost estimate), Trips (daily kilometers and individual detected trips), Datapoints (full datapoint browser), and Diagnostics.

Animated Vehicle Image for VIS

leapmotor.0.<VIN>.pictures.composite_html now contains a simple, embeddable animated vehicle image (transparent background, no buttons or dashboard chrome — that has moved into the admin tab). Add a basic - string (unescaped) widget in VIS, or embed it via <iframe>, and set the Object ID to:

leapmotor.0.<VIN>.pictures.composite_html

Available Commands (selection)

Simple on/off buttons under cmd.* (role button, set to true to trigger):

Value-based commands:

Comfort commands (only created/shown if the vehicle model supports the feature):

sunroof/sunshade are handled the same way — see src-admin/src/vehicleCapabilities.js for the confirmed B10 vs T03 difference.

Which comfort commands actually appear depends on the detected vehicle model — see src-admin/src/vehicleCapabilities.js in the repository for the current capability matrix per model.

Changelog

WORK IN PROGRESS

0.7.5 (2026-10-25)

• Fix: several boolean status datapoints (climate active, recirculate, locked, door-control-allowed, all four doors, ignition, Bluetooth, hotspot, and the non-T03 window-open indicators) were written straight from the raw cloud signal without converting it to an actual boolean - harmless on models/signals that happen to come back as JS true/false already, but logged a "has to be type boolean but received type number" warning (and stored a 0/1 number instead of a real boolean) wherever the cloud sends a plain 0/1 flag instead, confirmed on a B10. All of the above are now explicitly coerced to boolean, null/undefined (no data) left as-is.

0.7.4 (2026-10-25)

• Fix: login could fail with "Could not open account certificate" for some accounts, depending entirely on the numeric size of the account's internal ID - Node's default JSON parsing silently rounds integer literals above 2^53 to the nearest representable value with no error, which corrupted the ID for any account whose ID exceeded that threshold and, with it, the password derived from that ID to decrypt the account certificate the cloud sends back at login. Confirmed as the cause on a B10 account that could never log in; the login response is now parsed in a way that preserves the ID's exact value regardless of its size. If you were hitting "Could not open account certificate" on login before, this should fix it.

0.7.3 (2026-10-15)

• New: optional comfort extras for Prepare-to-Drive/Work, opt-in and off by default since not every model/trim has them (confirmed absent on T03; unconfirmed on B10/C10/B05/C16):
  • Driver seat heat (level 1-3) when heating (cold)
  • Steering wheel heat when heating (cold)
  • Windshield defrost (cmd.defrost - the working "max defrost" command, not the ineffective cmd.defrost_level) below its own separate, independently configurable temperature threshold (icing risk, distinct from the general heat/cool/vent split)
• Fix: sunshade cold-protection close now has its own separate, stricter threshold (default 5°C) instead of triggering for the entire "heat" range - confirmed in practice that the general heat threshold alone closed the roof at 14°C, which doesn't need insulating against. Still applies day or night once genuinely cold enough (heat loss through the glass roof is real at night too)
• New: official, cloud-metered charging session history cross-check (Diagnostics tab) - synced once daily against the manufacturer's own device-metered log (community-documented endpoint), classified home/public by GPS the same way as live tracking. Comparison only for now; live-tracked totals still drive the cost figures shown elsewhere
• Chore: enabled CI linting (previously off). main.js, lib/leapmotor-crypto.js and lib/leapmotor-client.js reformatted with Prettier and a handful of real findings fixed (dead code, unused params/vars, empty catch blocks) - verified via full AST comparison that no logic changed. Fixed the eslint config's admin-tab ignore list, which excluded the built output but not its React/Vite source, causing the frontend to be linted against rules meant for the backend
• Known limitation (T03): cmd.charge_limit_set and the charge-schedule commands (cmd_id=190) have no verified effect on the T03, even while awake - community-confirmed (leapmotor-ha #70/#72, 2026-09). The cloud accepts and echoes back the write (the official app and this adapter's own schedule readback will show the new value), but the vehicle silently keeps charging to whatever limit it already had. Confirmed in practice: schedule readback said 100%, official app said 100%, but the vehicle's live status kept reporting 80% regardless. Commands are still sent (other models/firmware may differ) but now log a clear warning on T03 - check the actual behavior in the official app rather than trusting a successful write
• Fix: an in-progress charging session's accumulated cost/kWh is now persisted and restored across an adapter restart (update, crash, manual restart mid-charge) - previously this lived only in memory and silently reset to 0, undercounting the total for that session
• New: optional extended trip-done notification (own toggle, off by default) - includes the total kWh and driving/climate/other split when official cloud energy data is available for that trip, falls back to the plain "Xkm in Ymin" message otherwise

0.7.2 (2026-09-24)

• New: notification for new vehicle inbox messages (service reminders, recalls, etc.), separate from the existing software-update notification
• Fix: outdoor temperature (used for trip min/max temp and Prepare-to-Drive/Work) now falls back to Open-Meteo not just when the vehicle doesn't report a value at all, but also when its reported value has stopped updating (confirmed on T03: the cloud keeps serving the same reading once parked long enough) - same 30min staleness threshold as the existing data-age indicator, cached for 10min so this never polls Open-Meteo more than necessary
• Fix: the Cloud API Language field's help text (and its translations, which didn't exist in any language) referenced settings under wording that predated their move to the Settings tab
• Note: 0.7.1 was pushed to GitHub but never tagged/published to npm - its changes are included here in 0.7.2 instead

0.7.0 (2026-09-24)

• New: trip merge undo (cmd.trips_merge_undo, one slot, lost on adapter restart)
• Fix: merging a trip's GPS route now works correctly - previously the merged route was deleted right after being written, due to an off-by-one in the route-key handling during merge
• New: elevation gain per trip (via Open-Meteo, no API key)
• New: min/max outdoor temperature per trip
• New: regen estimate per trip (voltage x current integration), now correctly excluded from charging sessions
• New: CSV export for a chosen date range
• New: PDF trip-log export (table + summary row, chosen date range)
• New: configurable trip and GPS-route history retention, independently, in days (0 = forever, with a hard count-based safety cap)
• New: Prepare-to-Drive - auto heat/cool/vent on ignition-on based on outdoor-temperature thresholds, with a lock-state check and a guard against self-triggered commands causing false positives
• New: Prepare-to-Work - same climate-prep core, triggered via cmd.prepare_to_work instead of an ignition edge, for shift-schedule/calendar automation
• New: sunshade automation for both Prepare-to-Drive/Work, with separate position for heat/cool/vent and an "open when dark" rule (kept closed when heating for cold protection)
• New: outdoor temperature now sourced from Open-Meteo instead of the vehicle's own sensor (missing entirely on some models, e.g. B10, and misleading when parked in a garage) - 30-minute cache, falls back to the last known value on API errors
• New: estimated battery health (SoH), derived from official per-trip cloud energy vs. SoC used (median of the last 30 trips, deliberately not derived from the adapter's own charging-cost estimate to avoid a circular "always ~100%" result)
• New: home/public charging cost split by GPS distance to a configurable home location (address search via Nominatim, map with draggable marker and radius circle); home charging can use a dynamic price datapoint (e.g. Tibber/aWATTar), public charging always uses a separate fixed manual price
• New: notifications (trip done, charge done, OTA update, window-left-open warning, Prepare-to-Drive/Work triggered) via sendTo, with telegrammenu2 severity levels/area support and a dedicated email payload; test-notification button in the Settings tab
• Fix: Prepare-to-Drive missed real drive starts after a long idle period, because the vehicle auto-relocks itself while driving - now also gates on movement (speed/gear), not lock state alone
• Fix: Prepare-to-Drive could misfire from a transient ignition-on reading caused by any remote command (its own or an external script's) waking the vehicle - now ignores an ignition edge within 2 minutes of any command sent
• Fix: bcmKeyPositionOn1 staying on during charging previously kept a trip open and counted charging current as regen - now correctly separated
• Fix: Leaflet's default marker showed as a broken "?" under Vite (bundler doesn't serve leaflet/dist/images/*.png automatically) - now explicitly imported and overridden
• Fix: several {condition && <JSX>} renders showing a literal "0" instead of nothing, when condition was the number 0 rather than false
• Improved: Datapoints tab moved to the end of the tab order
• Improved: full i18n coverage across all 11 languages - fixed several previously silent gaps (category group headings, tab names, "Parked")
• Fix: battery color threshold corrected (turns yellow at 20%, was incorrectly 50%)
• Fix: vehicles west of Greenwich (UK, Ireland, Portugal, parts of Spain/France) showed their GPS position mirrored into the wrong hemisphere; latitude/longitude now use the signed signal values instead of the absolute-value-only fields (community-confirmed via leapmotor-ha)
• Fix: window open/close/set-to-percent commands now scale to each model's native range - B05/B10/C10 expect a 0-10 scale, not 0-100 like T03; commands sent to those models previously moved the window far less than requested
• Fix: the "charging" status could get stuck showing active from a stale/phantom cloud flag while the car was actually being driven or just powered on and ready; it's now cross-checked against gear position, speed and ignition before being reported
• Fix: on T03, the binary window-open flags could remain at 0 even with the window actually open; open/closed status on this model now falls back to the live position percentage
• Fix: steering-wheel heating and seat heating/ventilation commands used a payload format the cloud silently ignored; both now send the numeric level/position format confirmed correct against two independent community reverse-engineering projects - not live-tested here, as this T03 doesn't have this hardware
• Known limitation: mirror heating is not controllable via the API on this T03 - confirmed non-functional even via the official Leapmotor app, so likely not exposed to the API/app for this vehicle at all. Payload sent matches the community-verified format; left in for other models/regions where it may work.
• Chore: cross-checked the tire-pressure signal ID mapping (front-left/front-right/rear-left/rear-right) against leapmotor-ha's independently corrected mapping - confirmed correct, no code change
• New: added B11 handling - not a separate model, it's Leapmotor's internal platform code for the C10 itself (confirmed via ADAC vehicle database); some cloud responses surface this code as carType instead of "C10", now mapped to the same endpoint and window scale.
• New (untested, community feedback welcome): start/stop charging, unlock charging connector, healthy-charging-mode toggle, fuel-heater toggle (REEV/range-extender models only), and sending a navigation destination (address or coordinates) to the vehicle. Payloads verified against two independent community reverse-engineering projects, not against real hardware - none of this is testable on this T03 (no REEV fuel heater; the other commands need a vehicle where charging/nav can safely be tried). Please open a GitHub issue with your model and result if you test any of these.
• Fix: trip tracking lives entirely in memory and gets wiped on every adapter restart, but trips.current_trip_active kept whatever value it last had - if a trip was active when the adapter restarted (or crashed), it stayed stuck showing "in progress" forever, since nothing afterward re-evaluated it without a matching in-memory entry. Now cleared at startup if left over from before the restart (the original trip's exact end time/mileage can't be recovered at that point).
• Improved: every remote command now logs a "Command: ..." line before sending and a "successful"/"failed" line after, at debug level - previously several commands (ac_temp/fan/position, speed limit, seat heat/ventilation, destination send, charge limit, refresh, defrost cycle) sent silently on success, making it impossible to tell from the log whether anything actually happened without also checking the raw status. Commands that only stage a value for a later command (ac_temp, climate/charge schedule fields, defrost level) now log that explicitly instead, so they're not mistaken for a command that was actually sent to the vehicle.
• Fix: cmd.charge_limit_set never synced with the vehicle's actual charge limit unless changed through this adapter's own control - if you changed it via the official app instead (e.g. to 100%), the internal control stayed frozen at its creation-time default of 80. cmd.charge_schedule_apply would then silently send that stale 80 back to the vehicle, overwriting your real setting. Now synced from the vehicle's actual reported limit on every poll, and charge_schedule_apply falls back to the vehicle's current schedule value instead of a hardcoded 80 if the control was never touched.
• Improved: trip detection now closes a trip immediately once the vehicle is locked and the ignition is explicitly off, instead of always waiting the full 10-minute grace period. The 10-minute grace period still applies for ambiguous cases (e.g. ignition status not reported, or car left unlocked with ignition off). Also added a second, independent fast-path signal: a completed lock → unlock → lock cycle since the trip started (the car auto-locks while driving, so getting out requires unlocking, then it's locked again afterward) is treated as equally definitive proof the trip is over, even on models where ignition status isn't reliably reported.
• Fix: a token expiry hitting exactly during cmd.refresh (or the delayed status fetch after certain commands) crashed the whole adapter process with an unhandled promise rejection, instead of re-logging in like the regular polling cycle already does. Both paths now catch the error and retry after a fresh login, same as the poller.
• Confirmed via a real B10 owner (extensive status field testing, 2026-07): battery/range/mileage/speed/ignition/doors/windows/tire pressure/sunroof/GPS/charge plan/charge limit status all report correctly; the hotspot status field doesn't exist on B10, same as T03. Also confirmed the vehicle's reported AC vent direction is decoded correctly (2026-09 dumps). Battery preheat was attempted but inconclusive (vehicle declined to activate in warm weather) - still untested.

0.6.8 (2026-09-19)

• Fix: the 0.6.7 re-login fix correctly detected an expired session token, but retried login using the same device identity every time - which the cloud started rejecting after the first failure, leaving the adapter stuck until a manual restart. A fresh device identity is now generated on every login attempt.
• Fix: remote pre-conditioning (heating/cooling the car before getting in, which turns the ignition on without the car moving) no longer gets misdetected as the start of a trip
• Fix: a completed trip's recorded end time now uses the vehicle's own reported timestamp instead of when our next poll happened to notice the stop, giving more accurate trip duration and a better match for the cloud's energy-breakdown time window
• Chore: added diagnostic logging of raw login/energy-breakdown responses to aid future troubleshooting

0.6.7 (2026-09-18)

• Fix: the automatic re-login on an expired session token was case-sensitive and never triggered for the cloud's "TOKEN_NOT_AVAILABLE" error, causing all polling to silently fail until a manual adapter restart
• Fix: a trip now only ends once the ignition is actually off (not just when speed reaches 0), and only after a 10-minute confirmation grace period - a brief stop at a light or curb no longer splits one drive into several
• Fix: the trip energy-breakdown retry queue now survives adapter restarts instead of leaving trips stuck showing "not yet available" forever; trips whose data never arrives are now clearly marked unavailable after the retry budget is exhausted
• Chore: raw status/energy-breakdown debug logging improvements to aid future diagnosis

0.6.6 (2026-09-17)

• Fix: B05 vehicles now use the shared C10 status endpoint (community-confirmed via leapmotor-ha), resolving the HTTP 404 status error (#38)
• Fix: right-side door overlays now render correctly behind the vehicle body/hood for proper depth ordering
• Chore: added ESLint config, tsconfig.json, VSCode JSON schema hints, converted i18n files to short format, bumped several dependencies, added Node.js 26 to the test matrix

0.6.5 (2026-09-02)

• New: on adapter start, the raw (pre-parsing) status response is logged once per vehicle at debug level, to help diagnose unsupported or under-tested vehicle models (e.g. B05)
• New: status request errors now also include the requested URL and the server's response body (if any)

0.6.4 (2026-09-02)

• Chore: migrated Admin Tab to adapter-react-v5 8.x and MUI v6 (React stays on 18, no breaking change for users)
• Fix: corrected Grid layout usage after the MUI v6 update, which had caused overlapping text on the Diagnostics tab
• Fix: unified card spacing/padding across all Admin Tab pages for a consistent look
• Fix: pinned react-dom to 18.3.1 to avoid a dependency resolution conflict
• Chore: minor CI workflow fix

0.6.3 (2026-09-01)

• Fix: preserve the existing charge schedule (enabled state, recurrence, start/end time) when changing the charge limit, instead of resetting it every time
• Fix: corrected door z-order and window-closed overlay logic on both vehicle sides
• Fix: clarified that the "Language" setting only affects Leapmotor cloud API text, not the Admin Tab UI (renamed to "Cloud API Language")
• Chore: bumped axios to 1.19.0
• Adapter is now available in the ioBroker stable repository
• (ioBroker-Bot) Adapter requires admin >= 7.8.23 now.

0.6.2 (2026-07-08)

• Fix: B10 model now correctly uses the c10 cloud status endpoint (community-confirmed), resolving empty status/trips/charging datapoints
• Fix: enabled full i18n for jsonConfig.json now that admin/i18n translation files cover all keys

0.6.1 (2026-07-03)

• Fix: repository checker findings - node: prefix for built-in modules, removed raw setTimeout fallback, included admin-tab i18n source in npm package, trimmed news list to 7 entries

0.6.0 (2026-07-03)

• Refactor: moved to standard plain-JS repository layout (main.js at repository root, supporting modules under lib/ instead of build/)
• Fix: removed dead/duplicate code, added VIN sanitization for object IDs, subscribed and acknowledged config.* states
• Fix: enforced upper bound on polling interval in code, switched picture cache from package-directory file to adapter's own file storage
• Fix: translated remaining German backend strings to English, enabled compact mode support, adapter-managed timers used throughout

0.5.8 (2026-07-02)

• Fix: repository checker compliance - added missing intermediate object structure (charging/consumption/pictures/trips channels), corrected invalid state roles, added real integration test

0.5.7 (2026-06-29)

• Fix: avoid npm transparency log conflict from a previous failed publish attempt (no functional changes vs. 0.5.5)

Older changes can be found in CHANGELOG_OLD.md.

License

MIT License

Copyright (c) 2026 Henrik Schönhofen (backfisch88) henrik.schoenhofen@icloud.com

See LICENSE for the full license text.