BMW CarData

Doplnok BMW CarData získava údaje o vozidle z rozhrania BMW CarData API a poskytuje ich ako vstupy v Loxone Config. Každé vozidlo je nakonfigurované ako samostatné podriadené zariadenie.

Požiadavky: aktívny účet BMW s priradeným vozidlom, Loxone Miniserver Gen.2 s prístupom na internet a desktopový prehliadač pre jednorazovú aktiváciu. Prepínač CarData API je dostupný iba vo webovom portáli MyBMW na adrese bmw.com/mybmw — NIE je dostupný v mobilnej aplikácii MyBMW.

Kompatibilné vozidlá: zvyčajne modely BMW približne od roku 2017 s výbavou ConnectedDrive. Rozhranie BMW CarData API umožňuje maximálne 50 dátových požiadaviek za deň na jedno vozidlo.

Obsah

• Konfigurácia
• Limit počtu požiadaviek a chybové správy
• Sensors and Actuators
• Vstupy, výstupy, vlastnosti

Konfigurácia↑

Prvé nastavenie

Postupujte podľa týchto krokov v poradí:
1. V desktopovom prehliadači (mobilná aplikácia MyBMW túto možnosť neponúka) otvorte bmw.com/mybmw a prihláste sa pomocou svojho účtu BMW.
2. Vyberte svoje vozidlo, potom prejdite: BMW CarData → Technical Access to BMW CarData → CarData API. Aktivujte 'Request access to CarData API' a prijmite podmienky zdieľania údajov BMW CarData. Portál potom zobrazí identifikátor vo formáte xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx — skopírujte ho do schránky.
3. V Loxone Config pridajte doplnok 'BMW CarData' do Sieťovej periférie. Otvorte nastavenia doplnku cez ikonu ozubeného kolieska a vložte identifikátor do poľa Client ID. (Jeden identifikátor je zdieľaný pre všetky vozidlá nakonfigurované v rámci tohto doplnku.)
4. Kliknite pravým tlačidlom na doplnok a pridajte podriadené zariadenie 'BMW Vehicle'. Zadajte VIN — 17-znakové identifikačné číslo vozidla. VIN je uvedené v osvedčení o evidencii vozidla, na spodnom okraji čelného skla a v MyBMW → Vehicle overview po výbere vozidla.
5. Pripojte vstup Poll Trigger k signálu, ktorý má spustiť obnovenie údajov — na rýchly test stačí tlačidlo alebo položka Weekly Timer; v prevádzke sú typickými zdrojmi udalosť pripojenia k wallboxu, zmeny stavu nabíjania alebo akákoľvek iná udalosť automatizácie. Bez pripojeného Poll Trigger doplnok nezískava žiadne údaje.
6. Uložte konfiguráciu do Miniservera.
7. Pri prvom spustení Poll Trigger sa v Loxone Config a v Loxone App zobrazí systémová správa s autorizačným odkazom. Otvorte odkaz v prehliadači, prihláste sa pomocou svojho účtu BMW a potvrďte — kód používateľa je už vložený v odkaze, takže BMW žiada len o potvrdenie.
8. Doplnok teraz získava údaje o vozidle pri každom impulze Poll Trigger. Prístupový token je uložený v Miniserveri a automaticky obnovovaný; nemusíte sa znovu prihlasovať, pokiaľ nezrušíte prístup v portáli MyBMW.

Client ID

Client ID sa vytvára raz na každý účet BMW vo webovom portáli MyBMW na adrese bmw.com/mybmw (vyžaduje sa desktopový prehliadač — mobilná aplikácia MyBMW túto ponuku nemá) v časti Vehicle overview → BMW CarData → Technical Access to BMW CarData → CarData API. Prijatie podmienok zdieľania údajov BMW CarData je pri prvej aktivácii povinné. Jedno Client ID je zdieľané pre všetky vozidlá nakonfigurované v rámci tohto doplnku a zostáva platné, kým sa prístup nezruší v tom istom portáli.

Domáce súradnice

Výstup Vzdialenosť od domova sa vypočítava ako ortodromická vzdialenosť medzi súradnicami Miniservera a aktuálnou GPS polohou vozidla. Polohu Miniservera nakonfigurujte v Loxone Config → Miniserver settings → Location.

Dopytovanie

Doplnok sa nedopytuje automaticky — údaje získava iba vtedy, keď vstup Poll Trigger prijme nábežnú hranu. Pripojte ho k akémukoľvek signálu, ktorý má obnoviť údaje o vozidle. Na rýchly test použite tlačidlo alebo položku Weekly Timer; v prevádzke použite udalosti, ako je pripojenie wallboxu, zmena stavu nabíjania alebo aktivácia scény. Majte na pamäti limit 50 požiadaviek za deň na jedno vozidlo (pozri Limit počtu požiadaviek a chybové správy nižšie).

Autorizácia

Pri prvom použití doplnok potrebuje jednorazovú autorizáciu pomocou vášho účtu BMW. Keď sa Poll Trigger spustí prvýkrát, výstup Vyžaduje sa autorizácia prejde na 1 a zobrazí sa systémová správa s autorizačným odkazom. Otvorte odkaz v prehliadači, prihláste sa pomocou svojho účtu BMW a potvrďte — kód používateľa je už vložený v odkaze, takže BMW žiada len o potvrdenie. Tá istá správa zobrazuje aj kód používateľa v podobe čistého textu ako záložnú možnosť; zadajte ho manuálne iba vtedy, ak ho prihlasovacia stránka vyžaduje (zriedkavé). Po úspešnom prihlásení doplnok získa údaje a výstup Vyžaduje sa autorizácia sa vráti na 0. Prístupový token sa potom automaticky obnovuje; nové prihlásenie sa vyžaduje iba vtedy, ak sa prístup zruší v portáli 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žiadaviek a chybové správy↑

Rozhranie BMW CarData API umožňuje maximálne 50 dátových požiadaviek za deň na jedno vozidlo. Počítadlo sa vynuluje o polnoci UTC. Bežné obnovenie údajov spotrebuje 1 požiadavku. Úplne prvé obnovenie po nastavení jednorazovo spotrebuje jednu alebo dve ďalšie požiadavky na zistenie modelu vozidla a prípravu dátového kanála — v deň úvodného nastavenia počítajte s približne 3 požiadavkami.

Nespúšťajte viac ako približne 45 dopytov za deň na jedno vozidlo, aby ste ponechali rezervu pre požiadavky prvého dopytu a ad hoc aktualizácie.

Systémové správy

Doplnok generuje systémové správy v Loxone Config a Loxone App pre nasledujúce situácie: Vyžaduje sa autorizácia — pozri časť Autorizácia vyššie. Dosiahnutý limit počtu požiadaviek — kvóta 50 požiadaviek/deň bola prekročená; správa zobrazuje čas do polnoci UTC, keď sa počítadlo vynuluje. Chyba pripojenia — Miniserver nemôže dosiahnuť rozhranie BMW CarData API; skontrolujte internetové pripojenie. Chýba Client ID — v nastaveniach doplnku nebolo nakonfigurované žiadne Client ID. Vozidlo sa nenašlo — nakonfigurované VIN nie je priradené k účtu BMW alebo neexistuje; skontrolujte VIN a oprávnenia vozidla v portáli 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↑