BMW CarData

El plugin BMW CarData obtiene los datos del vehículo desde la API de BMW CarData y los proporciona como entradas en Loxone Config. Cada vehículo se configura como un dispositivo secundario independiente.

Requisitos: una cuenta BMW activa con el vehículo asignado a ella, un Loxone Miniserver Gen.2 con acceso a internet y un navegador de escritorio para la activación única. El interruptor de la CarData API solo está disponible en el portal web de MyBMW en bmw.com/mybmw — NO está presente en la aplicación móvil de MyBMW.

Vehículos compatibles: normalmente modelos BMW a partir de aproximadamente 2017 con equipamiento ConnectedDrive. La API de BMW CarData permite un máximo de 50 solicitudes de datos al día por vehículo.

Contenido

• Configuración
• Límite de solicitudes y mensajes de error
• Sensors and Actuators
• Entradas, salidas y propiedades

Configuración↑

Configuración inicial

Siga estos pasos en orden:
1. En un navegador de escritorio (la aplicación móvil de MyBMW no ofrece esta función), abra bmw.com/mybmw e inicie sesión con su cuenta BMW.
2. Seleccione su vehículo y luego navegue a: BMW CarData → Technical Access to BMW CarData → CarData API. Active 'Request access to CarData API' y acepte los términos de uso compartido de datos de CarData de BMW. A continuación, el portal muestra un identificador con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx — cópielo al portapapeles.
3. En Loxone Config, añada el plugin 'BMW CarData' a la periferia de red. Abra los ajustes del plugin mediante su icono de engranaje y pegue el identificador en el campo Client ID. (Un mismo identificador se comparte entre todos los vehículos configurados bajo este plugin.)
4. Haga clic con el botón derecho en el plugin y añada un secundario 'BMW Vehicle'. Introduzca el VIN — el número de identificación del vehículo de 17 caracteres. El VIN se encuentra en el documento de matriculación del vehículo, en el borde inferior del parabrisas y en MyBMW → Vehicle overview cuando selecciona el vehículo.
5. Conecte la entrada Poll Trigger a una señal que deba activar una actualización de datos — para una prueba rápida basta con un pulsador o una entrada del Weekly Timer; en producción, las fuentes habituales son un evento de conexión de wallbox, cambios en el estado de carga o cualquier otro evento de automatización. Sin un Poll Trigger conectado, el plugin no obtiene ningún dato.
6. Guarde la configuración en el Miniserver.
7. La primera vez que se dispara el Poll Trigger, aparece un mensaje del sistema en Loxone Config y en la Loxone App con un enlace de autorización. Abra el enlace en un navegador, inicie sesión con su cuenta BMW y confirme — el código de usuario ya está incluido en el enlace, por lo que BMW solo pide la confirmación.
8. A partir de ahora, el plugin obtiene los datos del vehículo con cada pulso del Poll Trigger. El token de acceso se almacena en el Miniserver y se renueva automáticamente; no tiene que volver a iniciar sesión salvo que revoque el acceso en el portal de MyBMW.

Client ID

El Client ID se crea una sola vez por cuenta BMW en el portal web de MyBMW en bmw.com/mybmw (se requiere un navegador de escritorio — la aplicación móvil de MyBMW no dispone de este menú) en Vehicle overview → BMW CarData → Technical Access to BMW CarData → CarData API. Aceptar los términos de uso compartido de datos de CarData de BMW es obligatorio en la primera activación. Un mismo Client ID se comparte entre todos los vehículos configurados bajo este plugin y sigue siendo válido hasta que se revoque el acceso en el mismo portal.

Coordenadas del domicilio

La salida Distancia al domicilio se calcula como la distancia de círculo máximo entre las coordenadas del Miniserver y la posición GPS actual del vehículo. Configure la ubicación del Miniserver en Loxone Config → Miniserver settings → Location.

Sondeo

El plugin no realiza sondeos automáticamente — solo obtiene datos cuando la entrada Poll Trigger recibe un flanco ascendente. Conéctela a cualquier señal que deba actualizar los datos del vehículo. Para una prueba rápida, utilice un pulsador o una entrada del Weekly Timer; en producción, utilice eventos como la conexión de una wallbox, un cambio en el estado de carga o la activación de una escena. Tenga en cuenta el límite de 50 solicitudes al día por vehículo (consulte Límite de solicitudes y mensajes de error más abajo).

Autorización

En el primer uso, el plugin necesita una autorización única con su cuenta BMW. Cuando el Poll Trigger se dispara por primera vez, la salida Authorization Required pasa a 1 y aparece un mensaje del sistema con un enlace de autorización. Abra el enlace en un navegador, inicie sesión con su cuenta BMW y confirme — el código de usuario ya está incluido en el enlace, por lo que BMW solo pide la confirmación. El mismo mensaje también muestra el código de usuario en texto sin formato como alternativa; introdúzcalo manualmente solo si la página de inicio de sesión lo solicita (algo poco frecuente). Tras iniciar sesión correctamente, el plugin obtiene los datos y Authorization Required vuelve a 0. A continuación, el token de acceso se renueva automáticamente; solo es necesario volver a iniciar sesión si se revoca el acceso en el portal de 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.

Límite de solicitudes y mensajes de error↑

La API de BMW CarData permite un máximo de 50 solicitudes de datos al día por vehículo. El contador se restablece a medianoche UTC. Una actualización de datos normal consume 1 solicitud. La primera actualización tras la configuración consume una o dos solicitudes adicionales una sola vez para detectar el modelo del vehículo y preparar el canal de datos — prevea unas 3 solicitudes el día de la configuración inicial.

No active más de unos 45 sondeos al día por vehículo para dejar margen a las solicitudes del primer sondeo y a las actualizaciones puntuales.

Mensajes del sistema

El plugin genera mensajes del sistema en Loxone Config y la Loxone App en las siguientes situaciones: Authorization Required — consulte la sección Autorización más arriba. Rate Limit Reached — se ha superado la cuota de 50 solicitudes/día; el mensaje muestra el tiempo restante hasta la medianoche UTC en que se restablece el contador. Connection Error — el Miniserver no puede acceder a la API de BMW CarData; compruebe la conexión a internet. Client ID Missing — no se ha configurado ningún Client ID en los ajustes del plugin. Vehicle Not Found — el VIN configurado no está asignado a la cuenta BMW o no existe; compruebe el VIN y los permisos del vehículo en el portal de 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.

Sensores↑

Actuadores↑

Entradas de diagnóstico↑

Propiedades↑