iobroker.leapmotor 0.7.0 → 0.7.2

package/README.md

@@ -32,7 +32,15 @@ This way your main account stays logged in to the app at all times.
 - 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
+- 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)
@@ -40,6 +48,7 @@ This way your main account stays logged in to the app at all times.
 - 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
 
@@ -58,7 +67,12 @@ Install via ioBroker Admin UI.
 | Email | Leapmotor account email (recommend using a dedicated second account) |
 | Password | Leapmotor account password |
 | Vehicle PIN | 4-digit vehicle PIN – required for all remote commands |
-| Polling interval | Status update interval in minutes (default: 5) |
+| Cloud API Language | Affects Leapmotor cloud API text only (e.g. schedule day names) |
+
+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
 
@@ -71,7 +85,10 @@ leapmotor.0.<VIN>.pictures.*              → Vehicle images, including an anima
 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 used for cost estimation
+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
@@ -121,6 +138,9 @@ Simple on/off buttons under `cmd.*` (role `button`, set to `true` to trigger):
 | cmd.healthy_charging_on / off | Toggle battery-health charging mode | ✅ | Untested - same charging subsystem, expected on all models |
 | cmd.fuel_heating_on / off | Fuel heater on/off | ✅ | Untested - **REEV/range-extender trims only** (e.g. C10 EREV); not applicable on T03 (BEV) |
 | cmd.destination_send | Send the address/coordinates set below to the vehicle's built-in nav | – | Untested - expected on nav-equipped models (C10/B10/B11); unclear whether T03's built-in nav accepts cloud-pushed destinations at all |
+| cmd.prepare_to_work | Trigger Prepare-to-Work climate prep externally (e.g. from a shift-schedule/calendar script) | – | All models (uses same climate commands as Prepare-to-Drive) |
+| cmd.trips_merge | Merge a trip with the immediately preceding one (write the trip's start time in ms) - for a real trip split by a false stop detection | – | All models |
+| cmd.trips_merge_undo | Revert the last trip merge (one slot, lost on adapter restart) | – | All models |
 
 Value-based commands:
 
@@ -155,7 +175,36 @@ Which comfort commands actually appear depends on the detected vehicle model —
 
 ## Changelog
 
+### 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

package/admin/i18n/de.json

@@ -157,5 +157,7 @@
     "Diagnostics": "Diagnose",
     "No vehicle found. Is the adapter running?": "Kein Fahrzeug gefunden. Läuft der Adapter?",
     "Settings": "Einstellungen",
-    "Trips": "Fahrten"
+    "Trips": "Fahrten",
+    "Affects Leapmotor cloud API text only (e.g. schedule day names). Does not change the Admin Tab UI language, which follows your ioBroker Admin language setting. Everything else (polling, GPS recording, notifications, electricity prices, home location, Prepare-to-Drive/Work, data retention) has moved to the Settings tab inside the Leapmotor admin tab itself.": "Betrifft nur den Text der Leapmotor-Cloud-API (z.B. Wochentag-Namen im Zeitplan). Ändert nicht die Sprache des Admin-Tabs selbst, die folgt deiner ioBroker-Admin-Spracheinstellung. Alles andere (Polling, GPS-Aufzeichnung, Benachrichtigungen, Strompreise, Heim-Standort, Prepare-to-Drive/Work, Datenaufbewahrung) ist in den Settings-Tab innerhalb des Leapmotor-Admin-Tabs umgezogen.",
+    "Notify on new vehicle message (service reminders, recalls, etc.)": "Bei neuer Fahrzeug-Nachricht benachrichtigen (Service-Erinnerungen, Rückrufe, etc.)"
 }

package/admin/i18n/en.json

@@ -157,5 +157,7 @@
     "Diagnostics": "Diagnostics",
     "No vehicle found. Is the adapter running?": "No vehicle found. Is the adapter running?",
     "Settings": "Settings",
-    "Trips": "Trips"
+    "Trips": "Trips",
+    "Affects Leapmotor cloud API text only (e.g. schedule day names). Does not change the Admin Tab UI language, which follows your ioBroker Admin language setting. Everything else (polling, GPS recording, notifications, electricity prices, home location, Prepare-to-Drive/Work, data retention) has moved to the Settings tab inside the Leapmotor admin tab itself.": "Affects Leapmotor cloud API text only (e.g. schedule day names). Does not change the Admin Tab UI language, which follows your ioBroker Admin language setting. Everything else (polling, GPS recording, notifications, electricity prices, home location, Prepare-to-Drive/Work, data retention) has moved to the Settings tab inside the Leapmotor admin tab itself.",
+    "Notify on new vehicle message (service reminders, recalls, etc.)": "Notify on new vehicle message (service reminders, recalls, etc.)"
 }

package/admin/i18n/es.json

@@ -157,5 +157,7 @@
     "Diagnostics": "Diagnóstico",
     "No vehicle found. Is the adapter running?": "No se encontró ningún vehículo. ¿Está en ejecución el adaptador?",
     "Settings": "Ajustes",
-    "Trips": "Trayectos"
+    "Trips": "Trayectos",
+    "Affects Leapmotor cloud API text only (e.g. schedule day names). Does not change the Admin Tab UI language, which follows your ioBroker Admin language setting. Everything else (polling, GPS recording, notifications, electricity prices, home location, Prepare-to-Drive/Work, data retention) has moved to the Settings tab inside the Leapmotor admin tab itself.": "Afecta solo al texto de la API en la nube de Leapmotor (p. ej. nombres de dias en el horario). No cambia el idioma de la pestana de administracion, que sigue el ajuste de idioma de ioBroker Admin. Todo lo demas (sondeo, grabacion GPS, notificaciones, precios de electricidad, ubicacion del hogar, Preparar para conducir/trabajo, retencion de datos) se ha trasladado a la pestana Ajustes dentro del propio panel de Leapmotor.",
+    "Notify on new vehicle message (service reminders, recalls, etc.)": "Notificar ante un nuevo mensaje del vehículo (recordatorios de servicio, retiradas, etc.)"
 }

package/admin/i18n/fr.json

@@ -157,5 +157,7 @@
     "Diagnostics": "Diagnostic",
     "No vehicle found. Is the adapter running?": "Aucun véhicule trouvé. L'adaptateur est-il en cours d'exécution ?",
     "Settings": "Paramètres",
-    "Trips": "Trajets"
+    "Trips": "Trajets",
+    "Affects Leapmotor cloud API text only (e.g. schedule day names). Does not change the Admin Tab UI language, which follows your ioBroker Admin language setting. Everything else (polling, GPS recording, notifications, electricity prices, home location, Prepare-to-Drive/Work, data retention) has moved to the Settings tab inside the Leapmotor admin tab itself.": "Concerne uniquement le texte de l'API cloud Leapmotor (par ex. les noms des jours dans le planning). Ne change pas la langue de l'onglet d'administration lui-meme, qui suit le parametre de langue d'ioBroker Admin. Tout le reste (interrogation, enregistrement GPS, notifications, prix de l'electricite, emplacement du domicile, Pret a conduire/travailler, conservation des donnees) a ete deplace vers l'onglet Parametres a l'interieur du tableau de bord Leapmotor.",
+    "Notify on new vehicle message (service reminders, recalls, etc.)": "Notifier en cas de nouveau message du véhicule (rappels d'entretien, rappels constructeur, etc.)"
 }

package/admin/i18n/it.json

@@ -157,5 +157,7 @@
     "Diagnostics": "Diagnostica",
     "No vehicle found. Is the adapter running?": "Nessun veicolo trovato. L'adapter è in esecuzione?",
     "Settings": "Impostazioni",
-    "Trips": "Viaggi"
+    "Trips": "Viaggi",
+    "Affects Leapmotor cloud API text only (e.g. schedule day names). Does not change the Admin Tab UI language, which follows your ioBroker Admin language setting. Everything else (polling, GPS recording, notifications, electricity prices, home location, Prepare-to-Drive/Work, data retention) has moved to the Settings tab inside the Leapmotor admin tab itself.": "Riguarda solo il testo dell'API cloud Leapmotor (es. nomi dei giorni nella pianificazione). Non modifica la lingua della scheda di amministrazione stessa, che segue l'impostazione della lingua di ioBroker Admin. Tutto il resto (polling, registrazione GPS, notifiche, prezzi dell'elettricita, posizione di casa, Pronto per guidare/lavorare, conservazione dei dati) e stato spostato nella scheda Impostazioni all'interno della dashboard Leapmotor.",
+    "Notify on new vehicle message (service reminders, recalls, etc.)": "Notifica per un nuovo messaggio dal veicolo (promemoria di manutenzione, richiami, ecc.)"
 }

package/admin/i18n/nl.json

@@ -157,5 +157,7 @@
     "Diagnostics": "Diagnose",
     "No vehicle found. Is the adapter running?": "Geen voertuig gevonden. Draait de adapter?",
     "Settings": "Instellingen",
-    "Trips": "Ritten"
+    "Trips": "Ritten",
+    "Affects Leapmotor cloud API text only (e.g. schedule day names). Does not change the Admin Tab UI language, which follows your ioBroker Admin language setting. Everything else (polling, GPS recording, notifications, electricity prices, home location, Prepare-to-Drive/Work, data retention) has moved to the Settings tab inside the Leapmotor admin tab itself.": "Heeft alleen invloed op de tekst van de Leapmotor-cloud-API (bijv. dagnamen in het schema). Verandert niet de taal van het Admin-tabblad zelf, die volgt de taalinstelling van ioBroker Admin. Al het andere (polling, GPS-registratie, meldingen, elektriciteitsprijzen, thuislocatie, Klaar-om-te-rijden/werken, gegevensbewaring) is verplaatst naar het Instellingen-tabblad in het Leapmotor-dashboard zelf.",
+    "Notify on new vehicle message (service reminders, recalls, etc.)": "Melden bij nieuw voertuigbericht (servicemeldingen, terugroepacties, enz.)"
 }

package/admin/i18n/pl.json

@@ -157,5 +157,7 @@
     "Diagnostics": "Diagnostyka",
     "No vehicle found. Is the adapter running?": "Nie znaleziono pojazdu. Czy adapter działa?",
     "Settings": "Ustawienia",
-    "Trips": "Przejazdy"
+    "Trips": "Przejazdy",
+    "Affects Leapmotor cloud API text only (e.g. schedule day names). Does not change the Admin Tab UI language, which follows your ioBroker Admin language setting. Everything else (polling, GPS recording, notifications, electricity prices, home location, Prepare-to-Drive/Work, data retention) has moved to the Settings tab inside the Leapmotor admin tab itself.": "Dotyczy tylko tekstu chmury API Leapmotor (np. nazw dni w harmonogramie). Nie zmienia jezyka samej zakladki administracyjnej, ktory zalezy od ustawienia jezyka ioBroker Admin. Wszystko inne (odpytywanie, nagrywanie GPS, powiadomienia, ceny energii, lokalizacja domu, Gotowosc do jazdy/pracy, przechowywanie danych) zostalo przeniesione do zakladki Ustawienia wewnatrz samego panelu Leapmotor.",
+    "Notify on new vehicle message (service reminders, recalls, etc.)": "Powiadom o nowej wiadomości pojazdu (przypomnienia serwisowe, akcje serwisowe itp.)"
 }

package/admin/i18n/pt.json

@@ -157,5 +157,7 @@
     "Diagnostics": "Diagnóstico",
     "No vehicle found. Is the adapter running?": "Nenhum veículo encontrado. O adaptador está em execução?",
     "Settings": "Definições",
-    "Trips": "Viagens"
+    "Trips": "Viagens",
+    "Affects Leapmotor cloud API text only (e.g. schedule day names). Does not change the Admin Tab UI language, which follows your ioBroker Admin language setting. Everything else (polling, GPS recording, notifications, electricity prices, home location, Prepare-to-Drive/Work, data retention) has moved to the Settings tab inside the Leapmotor admin tab itself.": "Afeta apenas o texto da API cloud da Leapmotor (por ex. nomes dos dias no horario). Nao altera o idioma do proprio separador de administracao, que segue a definicao de idioma do ioBroker Admin. Tudo o resto (polling, gravacao de GPS, notificacoes, precos de eletricidade, localizacao de casa, Pronto para conduzir/trabalho, retencao de dados) foi movido para o separador Definicoes dentro do proprio painel Leapmotor.",
+    "Notify on new vehicle message (service reminders, recalls, etc.)": "Notificar em nova mensagem do veículo (lembretes de manutenção, recalls, etc.)"
 }

package/admin/i18n/ru.json

@@ -157,5 +157,7 @@
     "Diagnostics": "Диагностика",
     "No vehicle found. Is the adapter running?": "Автомобиль не найден. Адаптер запущен?",
     "Settings": "Настройки",
-    "Trips": "Поездки"
+    "Trips": "Поездки",
+    "Affects Leapmotor cloud API text only (e.g. schedule day names). Does not change the Admin Tab UI language, which follows your ioBroker Admin language setting. Everything else (polling, GPS recording, notifications, electricity prices, home location, Prepare-to-Drive/Work, data retention) has moved to the Settings tab inside the Leapmotor admin tab itself.": "Влияет только на текст облачного API Leapmotor (напр. названия дней в расписании). Не меняет язык самой вкладки администрирования, который зависит от настройки языка ioBroker Admin. Всё остальное (опрос, запись GPS, уведомления, цены на электроэнергию, домашнее местоположение, подготовка к поездке/работе, хранение данных) перемещено на вкладку Настройки внутри самой панели Leapmotor.",
+    "Notify on new vehicle message (service reminders, recalls, etc.)": "Уведомлять о новом сообщении автомобиля (напоминания о сервисе, отзывы и т.д.)"
 }

package/admin/i18n/uk.json

@@ -157,5 +157,7 @@
     "Diagnostics": "Діагностика",
     "No vehicle found. Is the adapter running?": "Автомобіль не знайдено. Адаптер запущено?",
     "Settings": "Налаштування",
-    "Trips": "Поїздки"
+    "Trips": "Поїздки",
+    "Affects Leapmotor cloud API text only (e.g. schedule day names). Does not change the Admin Tab UI language, which follows your ioBroker Admin language setting. Everything else (polling, GPS recording, notifications, electricity prices, home location, Prepare-to-Drive/Work, data retention) has moved to the Settings tab inside the Leapmotor admin tab itself.": "Впливає лише на текст хмарного API Leapmotor (напр. назви днів у розкладі). Не змінює мову самої вкладки адміністрування, яка залежить від налаштування мови ioBroker Admin. Все інше (опитування, запис GPS, сповіщення, ціни на електроенергію, домашнє розташування, підготовка до поїздки/роботи, зберігання даних) переміщено на вкладку Налаштування всередині самої панелі Leapmotor.",
+    "Notify on new vehicle message (service reminders, recalls, etc.)": "Сповіщати про нове повідомлення автомобіля (нагадування про сервіс, відкликання тощо)"
 }

package/admin/i18n/zh-cn.json

@@ -157,5 +157,7 @@
     "Diagnostics": "诊断",
     "No vehicle found. Is the adapter running?": "未找到车辆。适配器是否在运行?",
     "Settings": "设置",
-    "Trips": "行程"
+    "Trips": "行程",
+    "Affects Leapmotor cloud API text only (e.g. schedule day names). Does not change the Admin Tab UI language, which follows your ioBroker Admin language setting. Everything else (polling, GPS recording, notifications, electricity prices, home location, Prepare-to-Drive/Work, data retention) has moved to the Settings tab inside the Leapmotor admin tab itself.": "仅影响零跑云端API的文本(例如日程中的星期名称)。不会改变管理选项卡本身的语言,该语言取决于ioBroker管理界面的语言设置。其他所有内容(轮询、GPS记录、通知、电价、家庭位置、驾驶/上班准备、数据保留)已移至零跑管理面板内的设置选项卡中。",
+    "Notify on new vehicle message (service reminders, recalls, etc.)": "有新车辆消息时通知(保养提醒、召回等)"
 }

package/admin/jsonConfig.json

@@ -25,7 +25,7 @@
     "language": {
       "type": "select",
       "label": "Cloud API Language",
-      "help": "Affects Leapmotor cloud API text only (e.g. schedule day names). Does not change the Admin Tab UI language, which follows your ioBroker Admin language setting. Everything else (polling, GPS recording, notifications, electricity price) has moved to the Settings tab inside the Leapmotor admin tab itself.",
+      "help": "Affects Leapmotor cloud API text only (e.g. schedule day names). Does not change the Admin Tab UI language, which follows your ioBroker Admin language setting. Everything else (polling, GPS recording, notifications, electricity prices, home location, Prepare-to-Drive/Work, data retention) has moved to the Settings tab inside the Leapmotor admin tab itself.",
       "options": [
         {"label": "English", "value": "en-GB"},
         {"label": "Deutsch", "value": "de"},