Dati dell’auto BMW

Il plugin BMW CarData recupera i dati del veicolo dall'API BMW CarData e li mette a disposizione come ingressi in Loxone Config. Ogni veicolo viene configurato come dispositivo figlio separato.

Requisiti: un account BMW attivo con il veicolo ad esso associato, un Loxone Miniserver Gen.2 con accesso a Internet e un browser desktop per l'attivazione una tantum. L'interruttore dell'API CarData è disponibile solo nel portale web MyBMW all'indirizzo bmw.com/mybmw — NON è presente nell'app mobile MyBMW.

Veicoli compatibili: in genere modelli BMW dal 2017 circa in poi dotati di ConnectedDrive. L'API BMW CarData consente un massimo di 50 richieste di dati al giorno per veicolo.

Contenuto

• Configurazione
• Limite di richieste e messaggi di errore
• Sensors and Actuators
• Ingressi, uscite, proprietà

Configurazione↑

Configurazione iniziale

Segui questi passaggi in ordine:
1. In un browser desktop (l'app mobile MyBMW non offre questa funzione), apri bmw.com/mybmw e accedi con il tuo account BMW.
2. Seleziona il tuo veicolo, quindi spostati su: BMW CarData → Technical Access to BMW CarData → CarData API. Attiva 'Request access to CarData API' e accetta i termini di condivisione dei dati CarData di BMW. Il portale mostra quindi un identificativo nel formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx — copialo negli appunti.
3. In Loxone Config, aggiungi il plugin 'BMW CarData' alla periferia di rete. Apri le impostazioni del plugin tramite l'icona a forma di ingranaggio e incolla l'identificativo nel campo Client ID. (Un unico identificativo è condiviso tra tutti i veicoli configurati con questo plugin.)
4. Fai clic con il tasto destro sul plugin e aggiungi un figlio 'BMW Vehicle'. Inserisci il VIN, ovvero il numero di identificazione del veicolo di 17 caratteri. Il VIN si trova sul documento di immatricolazione del veicolo, sul bordo inferiore del parabrezza e in MyBMW → Vehicle overview quando selezioni il veicolo.
5. Collega l'ingresso Poll Trigger a un segnale che deve attivare un aggiornamento dei dati — per una prova rapida è sufficiente un pulsante o una voce del Weekly Timer; in produzione le sorgenti tipiche sono un evento di collegamento della wallbox, le variazioni dello stato di ricarica o qualsiasi altro evento di automazione. Senza un Poll Trigger collegato il plugin non recupera alcun dato.
6. Salva la configurazione nel Miniserver.
7. La prima volta che il Poll Trigger si attiva, in Loxone Config e nella Loxone App compare un messaggio di sistema con un link di autorizzazione. Apri il link in un browser, accedi con il tuo account BMW e conferma — il codice utente è già incorporato nel link, quindi BMW chiede solo la conferma.
8. Il plugin ora recupera i dati del veicolo a ogni impulso del Poll Trigger. Il token di accesso viene memorizzato sul Miniserver e aggiornato automaticamente; non devi accedere di nuovo a meno che non revochi l'accesso nel portale MyBMW.

Client ID

Il Client ID viene creato una sola volta per account BMW nel portale web MyBMW all'indirizzo bmw.com/mybmw (è necessario un browser desktop — l'app mobile MyBMW non dispone di questo menu) alla voce Vehicle overview → BMW CarData → Technical Access to BMW CarData → CarData API. L'accettazione dei termini di condivisione dei dati CarData di BMW è obbligatoria alla prima attivazione. Un unico Client ID è condiviso tra tutti i veicoli configurati con questo plugin e rimane valido finché l'accesso non viene revocato nello stesso portale.

Coordinate di casa

L'uscita Distanza da casa viene calcolata come la distanza ortodromica tra le coordinate del Miniserver e la posizione GPS attuale del veicolo. Configura la posizione del Miniserver in Loxone Config → Miniserver settings → Location.

Polling

Il plugin non esegue il polling automaticamente — recupera i dati solo quando l'ingresso Poll Trigger riceve un fronte di salita. Collegalo a qualsiasi segnale che deve aggiornare i dati del veicolo. Per una prova rapida, usa un pulsante o una voce del Weekly Timer; in produzione usa eventi come il collegamento di una wallbox, una variazione dello stato di ricarica o l'attivazione di una scena. Tieni presente il limite di 50 richieste al giorno per veicolo (vedi Limite di richieste e messaggi di errore qui sotto).

Autorizzazione

Al primo utilizzo il plugin necessita di un'autorizzazione una tantum con il tuo account BMW. Quando il Poll Trigger si attiva per la prima volta, l'uscita Autorizzazione richiesta passa a 1 e compare un messaggio di sistema con un link di autorizzazione. Apri il link in un browser, accedi con il tuo account BMW e conferma — il codice utente è già incorporato nel link, quindi BMW chiede solo la conferma. Lo stesso messaggio mostra anche il codice utente in chiaro come ripiego; inseriscilo manualmente solo se la pagina di login lo richiede (raramente). Dopo l'accesso riuscito il plugin recupera i dati e Autorizzazione richiesta torna a 0. Il token di accesso viene quindi aggiornato automaticamente; un nuovo accesso è necessario solo se l'accesso viene revocato nel portale 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.

Limite di richieste e messaggi di errore↑

L'API BMW CarData consente un massimo di 50 richieste di dati al giorno per veicolo. Il contatore si reimposta a mezzanotte UTC. Un normale aggiornamento dei dati consuma 1 richiesta. Il primissimo aggiornamento dopo la configurazione consuma una volta una o due richieste aggiuntive per rilevare il modello del veicolo e preparare il canale dati — prevedi circa 3 richieste nel giorno della configurazione iniziale.

Non attivare più di circa 45 polling al giorno per veicolo per lasciare un margine per le richieste del primo polling e gli aggiornamenti occasionali.

Messaggi di sistema

Il plugin genera messaggi di sistema in Loxone Config e nella Loxone App nelle seguenti situazioni: Autorizzazione richiesta — vedi la sezione Autorizzazione qui sopra. Limite di richieste raggiunto — la quota di 50 richieste/giorno è stata superata; il messaggio mostra il tempo che manca alla mezzanotte UTC, quando il contatore si reimposta. Errore di connessione — il Miniserver non riesce a raggiungere l'API BMW CarData; verifica la connessione Internet. Client ID mancante — nelle impostazioni del plugin non è stato configurato alcun Client ID. Veicolo non trovato — il VIN configurato non è associato all'account BMW o non esiste; verifica il VIN e i permessi del veicolo nel portale 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.

Sensori↑

Attuatori↑

Ingressi di diagnosi↑

Proprietà↑