BMW CarData

A BMW CarData beépülő modul lekéri a járműadatokat a BMW CarData API-ból, és bemenetekként biztosítja azokat a Loxone Configban. Minden jármű külön gyermekeszközként van konfigurálva.

Követelmények: egy aktív BMW fiók, amelyhez a jármű hozzá van rendelve, egy internet-hozzáféréssel rendelkező Loxone Miniserver Gen.2, valamint egy asztali böngésző az egyszeri aktiváláshoz. A CarData API kapcsoló csak a MyBMW webes portálon érhető el a bmw.com/mybmw címen — a MyBMW mobilalkalmazásban NEM található meg.

Kompatibilis járművek: jellemzően a kb. 2017-től gyártott, ConnectedDrive felszereltséggel rendelkező BMW modellek. A BMW CarData API járművenként naponta legfeljebb 50 adatlekérést engedélyez.

Tartalom

• Konfiguráció
• Lekérési korlát és hibaüzenetek
• Sensors and Actuators
• Bemenetek, kimenetek, beállítások

Konfiguráció↑

Első beállítás

Kövesse ezeket a lépéseket sorrendben:
1. Egy asztali böngészőben (a MyBMW mobilalkalmazás ezt nem kínálja) nyissa meg a bmw.com/mybmw oldalt, és jelentkezzen be a BMW fiókjával.
2. Válassza ki a járművét, majd navigáljon ide: BMW CarData → Technical Access to BMW CarData → CarData API. Aktiválja a 'Request access to CarData API' lehetőséget, és fogadja el a BMW CarData adatmegosztási feltételeit. A portál ezután egy xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx formátumú azonosítót jelenít meg — másolja a vágólapra.
3. A Loxone Configban adja hozzá a 'BMW CarData' beépülő modult a Hálózati Periféria alá. Nyissa meg a beépülő modul beállításait a fogaskerék ikonjával, és illessze be az azonosítót a Client ID mezőbe. (Egyetlen azonosító közös az ehhez a beépülő modulhoz konfigurált összes járműnél.)
4. Kattintson jobb gombbal a beépülő modulra, és adjon hozzá egy 'BMW Vehicle' gyermeket. Adja meg a VIN-t — a 17 karakteres alvázszámot. A VIN megtalálható a forgalmi engedélyen, a szélvédő alsó szélén, valamint a MyBMW → Vehicle overview menüben, amikor kiválasztja a járművet.
5. Csatlakoztassa a Poll Trigger bemenetet egy olyan jelhez, amely adatfrissítést indít — gyors teszteléshez elegendő egy nyomógomb vagy egy Weekly Timer bejegyzés; éles üzemben jellemző források a wallbox csatlakoztatási esemény, a töltési állapot változásai vagy bármilyen más automatizálási esemény. Csatlakoztatott Poll Trigger nélkül a beépülő modul nem kér le adatokat.
6. Mentse a konfigurációt a Miniserverre.
7. Amikor a Poll Trigger először aktiválódik, egy rendszerüzenet jelenik meg a Loxone Configban és a Loxone Appban egy engedélyezési hivatkozással. Nyissa meg a hivatkozást egy böngészőben, jelentkezzen be a BMW fiókjával, és erősítse meg — a felhasználói kód már be van ágyazva a hivatkozásba, így a BMW csak megerősítést kér.
8. A beépülő modul mostantól minden Poll Trigger impulzusnál lekéri a járműadatokat. A hozzáférési token a Miniserveren tárolódik és automatikusan frissül; nem kell újra bejelentkeznie, kivéve ha visszavonja a hozzáférést a MyBMW portálon.

Client ID

A Client ID BMW fiókonként egyszer jön létre a MyBMW webes portálon a bmw.com/mybmw címen (asztali böngésző szükséges — a MyBMW mobilalkalmazásban nincs meg ez a menü) a Vehicle overview → BMW CarData → Technical Access to BMW CarData → CarData API alatt. A BMW CarData adatmegosztási feltételeinek elfogadása az első aktiváláskor kötelező. Egyetlen Client ID közös az ehhez a beépülő modulhoz konfigurált összes járműnél, és érvényes marad, amíg a hozzáférést vissza nem vonják ugyanazon a portálon.

Otthoni koordináták

A Távolság az otthontól kimenet a Miniserver koordinátái és a jármű aktuális GPS-pozíciója közötti gömbi távolságként számítódik ki. A Miniserver helyét a Loxone Config → Miniserver settings → Location menüben állíthatja be.

Lekérdezés

A beépülő modul nem kérdez le automatikusan — csak akkor kér le adatokat, amikor a Poll Trigger bemenet felfutó élt kap. Csatlakoztassa bármely olyan jelhez, amely frissíti a járműadatokat. Gyors teszteléshez használjon nyomógombot vagy egy Weekly Timer bejegyzést; éles üzemben olyan eseményeket használjon, mint egy wallbox csatlakozása, a töltési állapot változása vagy egy jelenet aktiválása. Vegye figyelembe a járművenként napi 50 lekérés korlátot (lásd lentebb a Lekérési korlát és hibaüzenetek részt).

Engedélyezés

Az első használatkor a beépülő modulnak egyszeri engedélyezésre van szüksége a BMW fiókjával. Amikor a Poll Trigger először aktiválódik, az Engedélyezés szükséges kimenet 1-re vált, és egy rendszerüzenet jelenik meg egy engedélyezési hivatkozással. Nyissa meg a hivatkozást egy böngészőben, jelentkezzen be a BMW fiókjával, és erősítse meg — a felhasználói kód már be van ágyazva a hivatkozásba, így a BMW csak megerősítést kér. Ugyanez az üzenet tartalékként sima szövegként is megjeleníti a felhasználói kódot; csak akkor adja meg manuálisan, ha a bejelentkezési oldal valóban kéri (ritka). A sikeres bejelentkezés után a beépülő modul lekéri az adatokat, és az Engedélyezés szükséges visszatér 0-ra. A hozzáférési token ezután automatikusan frissül; új bejelentkezésre csak akkor van szükség, ha a hozzáférést visszavonják a MyBMW portálon.

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.

Lekérési korlát és hibaüzenetek↑

A BMW CarData API járművenként naponta legfeljebb 50 adatlekérést engedélyez. A számláló éjfélkor (UTC) nullázódik. Egy normál adatfrissítés 1 lekérést használ el. A beállítás utáni legelső frissítés egyszer egy vagy két további lekérést használ el a jármű modelljének felismeréséhez és az adatcsatorna előkészítéséhez — az első beállítás napján számoljon kb. 3 lekéréssel.

Ne indítson járművenként naponta kb. 45-nél több lekérdezést, hogy maradjon tartalék az első lekérdezés kéréseihez és az eseti frissítésekhez.

Rendszerüzenetek

A beépülő modul a következő helyzetekben generál rendszerüzeneteket a Loxone Configban és a Loxone Appban: Engedélyezés szükséges — lásd a fenti Engedélyezés részt. Lekérési korlát elérve — az 50 lekérés/nap kvótát túllépték; az üzenet megmutatja a hátralévő időt éjfélig (UTC), amikor a számláló nullázódik. Kapcsolódási hiba — a Miniserver nem éri el a BMW CarData API-t; ellenőrizze az internetkapcsolatot. Hiányzó Client ID — nincs Client ID konfigurálva a beépülő modul beállításaiban. A jármű nem található — a konfigurált VIN nincs hozzárendelve a BMW fiókhoz, vagy nem létezik; ellenőrizze a VIN-t és a járműjogosultságokat a MyBMW portálon.

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.

Szenzorok↑

Aktorok↑

Diagnosztikai bemenetek↑

Tulajdonságok↑