BMW CarData

Plugin BMW CarData získává data vozidel z rozhraní BMW CarData API a poskytuje je jako vstupy v Loxone Config. Každé vozidlo je konfigurováno jako samostatné podřízené zařízení.

Požadavky: aktivní účet BMW s přiřazeným vozidlem, Loxone Miniserver Gen.2 s přístupem k internetu a desktopový prohlížeč pro jednorázovou aktivaci. Přepínač CarData API je k dispozici pouze ve webovém portálu MyBMW na adrese bmw.com/mybmw — v mobilní aplikaci MyBMW NENÍ k dispozici.

Kompatibilní vozidla: obvykle modely BMW přibližně od roku 2017 vybavené systémem ConnectedDrive. Rozhraní BMW CarData API umožňuje maximálně 50 datových požadavků za den na jedno vozidlo.

Obsah

• Konfigurace
• Limit počtu požadavků a chybové zprávy
• Sensors and Actuators
• Vstupy, výstupy, vlastnosti

Konfigurace↑

První nastavení

Postupujte podle těchto kroků v pořadí:
1. V desktopovém prohlížeči (mobilní aplikace MyBMW toto nenabízí) otevřete bmw.com/mybmw a přihlaste se pomocí svého účtu BMW.
2. Vyberte své vozidlo a poté přejděte: BMW CarData → Technical Access to BMW CarData → CarData API. Aktivujte 'Request access to CarData API' a přijměte podmínky sdílení dat BMW CarData. Portál poté zobrazí identifikátor ve formátu xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx — zkopírujte jej do schránky.
3. V Loxone Config přidejte plugin 'BMW CarData' do síťové periferie. Otevřete nastavení pluginu pomocí jeho ikony ozubeného kola a vložte identifikátor do pole Client ID. (Jeden identifikátor je sdílen mezi všemi vozidly konfigurovanými v rámci tohoto pluginu.)
4. Klikněte pravým tlačítkem na plugin a přidejte podřízené zařízení 'BMW Vehicle'. Zadejte VIN — 17místné identifikační číslo vozidla. VIN najdete v dokladu o registraci vozidla, na spodním okraji čelního skla a v MyBMW → Vehicle overview po výběru vozidla.
5. Připojte vstup Poll Trigger k signálu, který má spustit aktualizaci dat — pro rychlý test postačí tlačítko nebo položka Weekly Timer; v produkčním provozu jsou typickými zdroji událost připojení k wallboxu, změny stavu nabíjení nebo jakákoli jiná událost automatizace. Bez připojeného Poll Trigger plugin nenačítá žádná data.
6. Uložte konfiguraci do Miniserveru.
7. Při prvním spuštění Poll Trigger se v Loxone Config a v Loxone App zobrazí systémová zpráva s autorizačním odkazem. Otevřete odkaz v prohlížeči, přihlaste se pomocí svého účtu BMW a potvrďte — uživatelský kód je již vložen v odkazu, takže BMW žádá pouze o potvrzení.
8. Plugin nyní načítá data vozidla při každém impulzu Poll Trigger. Přístupový token je uložen na Miniserveru a automaticky obnovován; znovu se přihlašovat nemusíte, pokud nezrušíte přístup v portálu MyBMW.

Client ID

Client ID se vytváří jednou na účet BMW ve webovém portálu MyBMW na adrese bmw.com/mybmw (vyžadován desktopový prohlížeč — mobilní aplikace MyBMW tuto nabídku neobsahuje) v části Vehicle overview → BMW CarData → Technical Access to BMW CarData → CarData API. Přijetí podmínek sdílení dat BMW CarData je při první aktivaci povinné. Jedno Client ID je sdíleno mezi všemi vozidly konfigurovanými v rámci tohoto pluginu a zůstává platné, dokud není přístup zrušen ve stejném portálu.

Souřadnice domova

Výstup Vzdálenost od domova se počítá jako ortodromická vzdálenost mezi souřadnicemi Miniserveru a aktuální GPS polohou vozidla. Polohu Miniserveru nakonfigurujte v Loxone Config → nastavení Miniserveru → Poloha.

Dotazování

Plugin nedotazuje automaticky — data načítá pouze tehdy, když vstup Poll Trigger obdrží vzestupnou hranu. Připojte jej k libovolnému signálu, který má aktualizovat data vozidla. Pro rychlý test použijte tlačítko nebo položku Weekly Timer; v produkčním provozu použijte události, jako je připojení k wallboxu, změna stavu nabíjení nebo aktivace scény. Mějte na paměti limit 50 požadavků za den na vozidlo (viz Limit počtu požadavků a chybové zprávy níže).

Autorizace

Při prvním použití plugin vyžaduje jednorázovou autorizaci pomocí vašeho účtu BMW. Když se Poll Trigger spustí poprvé, výstup Vyžadována autorizace přejde na 1 a zobrazí se systémová zpráva s autorizačním odkazem. Otevřete odkaz v prohlížeči, přihlaste se pomocí svého účtu BMW a potvrďte — uživatelský kód je již vložen v odkazu, takže BMW žádá pouze o potvrzení. Stejná zpráva také zobrazuje uživatelský kód v prostém textu jako záložní možnost; zadejte jej ručně pouze tehdy, pokud o něj přihlašovací stránka skutečně požádá (vzácně). Po úspěšném přihlášení plugin načte data a výstup Vyžadována autorizace se vrátí na 0. Přístupový token je poté automaticky obnovován; nové přihlášení je vyžadováno pouze v případě, že je přístup zrušen v portálu MyBMW.

Where the authorization code comes from

You never create this code yourself — not in the MyBMW portal and not on the BMW API or Swagger pages. When the Poll Trigger fires, the plugin automatically requests a one-time code from BMW and shows it to you in two places: in the Loxone App system message (after 'enter the code:'), and in the Authorization URL output as the user_code parameter of the link (https://customer.bmwgroup.com/oneid/link?user_code=...). You normally never type it: the 'Open BMW login' button and the Authorization URL link already contain the code, so BMW only asks you to sign in and confirm. The plain-text code is only a fallback if a login page ever asks for it manually. The code is valid for a few minutes; if it expires before you finish, fire the Poll Trigger again to get a fresh one.

Limit počtu požadavků a chybové zprávy↑

Rozhraní BMW CarData API umožňuje maximálně 50 datových požadavků za den na jedno vozidlo. Počítadlo se resetuje o půlnoci UTC. Běžná aktualizace dat spotřebuje 1 požadavek. Úplně první aktualizace po nastavení spotřebuje jednorázově jeden nebo dva další požadavky pro zjištění modelu vozidla a přípravu datového kanálu — počítejte s přibližně 3 požadavky v den prvotního nastavení.

Nespouštějte více než přibližně 45 dotazů za den na vozidlo, abyste ponechali rezervu pro požadavky prvního dotazu a ad hoc aktualizace.

Systémové zprávy

Plugin generuje systémové zprávy v Loxone Config a Loxone App pro následující situace: Vyžadována autorizace — viz část Autorizace výše. Dosažen limit počtu požadavků — kvóta 50 požadavků/den byla překročena; zpráva zobrazuje čas zbývající do půlnoci UTC, kdy se počítadlo resetuje. Chyba připojení — Miniserver nemůže dosáhnout rozhraní BMW CarData API; zkontrolujte připojení k internetu. Chybí Client ID — v nastavení pluginu nebylo nakonfigurováno žádné Client ID. Vozidlo nenalezeno — nakonfigurované VIN není přiřazeno k účtu BMW nebo neexistuje; zkontrolujte VIN a oprávnění vozidla v portálu MyBMW.

Sensors and Actuators↑

This section explains what each signal is for. Units and value ranges are listed in the Sensors and Actuators tables above.

Sensors

VIN — the 17-character vehicle identification number; use it to tell several vehicles apart or for logging.
Model — the model name reported by BMW; for display and labeling.
Battery SOC (%) — high-voltage battery state of charge; charge control, low-battery notifications, visualization.
Electric Range (km) — remaining electric range; range warnings, trip planning.
Mileage (km) — odometer reading; service-interval tracking, logging.
Charging (0/1) — 1 while the vehicle is actively charging; PV-surplus logic, notifications, summer cabin ventilation.
Remaining Charge Time (min) — estimated time until full (only meaningful while charging); 'ready by' display, departure planning.
Cable Connected (0/1) — 1 while the charge cable is connected; remind the user to plug in, gate charging automations.
Charging Power (kW) — current charging power; energy monitoring, load management.
Authorization Required (0/1) — 1 while the plugin is waiting for authorization; trigger a reminder.
Authorization URL (Text) — the login link; display it in the Loxone App so the user can authorize.
Distance from Home (km) — air-line distance between the Miniserver location and the vehicle's GPS position. Use it as a coarse 'is the car at home?' indicator, e.g. together with Charging to confirm the car is charging at home. It is not suitable for real-time arrival automations (such as opening the garage), because that would require near-constant polling while the API is limited to 50 requests per day and the plugin only fetches on a Poll Trigger.

Actuators

Poll Trigger — a rising edge fetches fresh vehicle data once. The plugin never polls on its own; drive this from a scheduled time trigger (for example a few times a day), a 'wallbox connected' event, or a button.

Senzory↑

Aktory↑

Vstupy pro diagnostiku↑

Vlastnosti↑