Integración domótica Nissan Connect, gratuita y de código abierto

Batería, autonomía, carga y clima de su Nissan eléctrico (Leaf, Ariya…).
Esta integración lleva su coche eléctrico Nissan a Gladys a través de la nube NissanConnect Services — el mismo servicio que la app móvil de Nissan. Ve la batería, la autonomía, la carga y el clima, puede encender el clima o la carga, y usar todo ello en escenas y en el panel.
Antes de empezar
- Gladys 5.3 o posterior.
- Una cuenta NissanConnect Services (Europa), con su coche activado en la app móvil. Si la app muestra su coche y su batería, esta integración también puede.
- La integración funciona solo a través de la nube de Nissan: nunca habla con el coche en su red local, y necesita acceso a internet.
Nissan no ofrece una API pública. La integración habla el mismo lenguaje que la app oficial, que Nissan puede cambiar sin aviso. No todos los modelos responden a todas las peticiones: un LEAF, por ejemplo, no da el estado del cierre de las puertas.
Configuración
Abra Integraciones → Nissan Connect → Configuración.
| Campo | Qué poner |
|---|---|
| Usuario NissanConnect (e-mail) | El e-mail con el que inicia sesión en la app NissanConnect Services. |
| Contraseña NissanConnect | Su contraseña. Gladys la guarda como secreto; nunca se escribe en los registros. |
| Intervalo de actualización (s) | Con qué frecuencia Gladys lee lo último que el coche envió a la nube de Nissan. Por defecto 900 (15 min), mínimo 300. No despierta el coche. |
| Intervalo de activación del coche (min) | Con qué frecuencia se pide al propio coche que envíe datos nuevos. Por defecto 0 = solo a petición. Cada activación consume la batería de 12 V: si la activa, elija un valor alto (por ejemplo 240). |
| Unidad de distancia | Kilómetros o millas, para la autonomía y el odómetro. |
| Temperatura del clima (°C) | Temperatura del habitáculo usada cuando se enciende el clima sin indicar una (16 a 30 °C). |
Luego haga clic en Probar la conexión: la respuesta lista los coches encontrados en su cuenta.
Añadir su coche
Abra Integraciones → Nissan Connect → Descubrimiento y cree el coche. Un dispositivo Gladys por coche de la cuenta, con el apodo elegido en la app.
Si cambia más tarde la unidad de distancia, vuelva a Descubrimiento y actualice el coche, para que su autonomía y su odómetro muestren la nueva unidad.
Qué muestra el dispositivo coche
| Función | Descripción | Control |
|---|---|---|
| Batería | Nivel de carga, en %. | — |
| Autonomía | Autonomía estimada, en km o millas. | — |
| Enchufado | Si el cable de carga está conectado. | — |
| Cargando | Si el coche está cargando. | Iniciar / detener |
| Clima | Si el clima (precalentamiento / preenfriamiento) está en marcha. | Encender / apagar |
| Temperatura del clima | Temperatura pedida para el próximo encendido del clima. | 16 a 30 °C |
| Temperatura del habitáculo | Temperatura dentro del coche, cuando el coche la informa. | — |
| Odómetro | Distancia total, en km o millas. | — |
| Cerrado | Si las puertas están cerradas, cuando el coche lo informa. | — |
El coche ejecuta las órdenes a distancia un poco después: Gladys muestra al momento el estado pedido, y vuelve a leer el coche unos 90 segundos después para confirmarlo.
La insignia de transporte del dispositivo indica lo recientes que son los datos:
- Nube: la última lectura funcionó.
- Inaccesible: la nube de Nissan no respondió en la última lectura.
- Nube con un punto naranja: la nube responde, pero el coche no ha enviado nada desde hace más de 24 horas (en reposo, en un garaje subterráneo, sin cobertura). Use Despertar un coche.
¿Leer o despertar?
- Una lectura pregunta a la nube de Nissan lo último que el coche informó. No cuesta nada y ocurre en cada intervalo de actualización.
- Una activación pide al propio coche que envíe datos nuevos. Pasa por la red móvil y consume la batería de 12 V. Los nuevos datos llegan a Gladys unos minutos después.
Despierte el coche con el botón Despertar un coche, el botón Actualizar del widget, la acción de escena Leer el estado de un Nissan (con «Despertar el coche antes»), o automáticamente con el intervalo de activación del coche.
Botones de la pantalla de configuración
- Probar la conexión: inicia sesión y lista los coches de la cuenta.
- Despertar un coche: pide al coche elegido que envíe datos nuevos (batería y posición).
- Identificar un coche (luces intermitentes): el coche hace parpadear sus luces, útil en un aparcamiento.
Escenas
Disparadores
- Un Nissan empieza o deja de cargar — filtros: el coche, el evento (carga iniciada, carga detenida).
- Un Nissan se enchufa o desenchufa — filtros: el coche, el evento (enchufado, desenchufado).
Ambos dan a la escena estas variables: el nombre del coche, el evento, el nivel de batería (%) y la autonomía. Se detectan en la siguiente lectura del coche, es decir con un retraso de hasta el intervalo de actualización, no al segundo exacto. Nunca se activan en la primera lectura tras el arranque de Gladys.
Para un umbral («batería por debajo del 20 %»), use el disparador estándar estado de un dispositivo de Gladys sobre la función Batería.
Acciones
- Encender o apagar el clima de un Nissan — el coche, encender o apagar, y una temperatura opcional. Salida: orden aceptada.
- Iniciar o detener la carga de un Nissan — el coche debe estar enchufado. Salida: orden aceptada.
- Leer el estado de un Nissan — lee el coche ahora, despertándolo antes si lo desea. Salidas: batería (%), autonomía, enchufado, cargando — úselas en las acciones siguientes («si batería < 30, envíame un mensaje»).
- Hacer parpadear las luces de un Nissan — solo luces, o luces y claxon. Salida: orden aceptada.
Un rechazo de Nissan no detiene la escena: la salida orden aceptada vale entonces falso, y puede comprobarla en una condición.
Ejemplos:
- Cada día laborable a las 7:40, encender el clima a 21 °C.
- Cuando el coche se desenchufa y su batería está por debajo del 50 %, enviar un mensaje.
- Cuando el coche deja de cargar, leer el estado y anunciar la autonomía.
Widget del panel
Añada el widget Coche Nissan a un panel. Ajustes:
- Coche: el coche que se muestra (el primero de la cuenta si se deja vacío).
- Mostrar el botón del mapa: añade un botón que abre la última posición del coche en OpenStreetMap. Desactivado por defecto: déjelo desactivado en un panel que otros puedan ver.
El widget muestra la batería y la autonomía en directo, si el coche está enchufado y cargando (con el tiempo restante), el clima, las puertas y la hora de los últimos datos del coche. Sus botones: Actualizar (despierta el coche), Encender / Apagar clima, Iniciar / Detener carga (solo si está enchufado), y el mapa. Los botones de clima y de carga piden una confirmación.
Solución de problemas
| Síntoma | Qué hacer |
|---|---|
| «Nissan ha rechazado el usuario o la contraseña» | Compruébelos iniciando sesión en la app NissanConnect Services, y vuelva a escribirlos en Gladys. |
| «Conectado, pero esta cuenta NissanConnect no tiene ningún coche» | Active primero el coche en la app móvil, luego Probar la conexión de nuevo. |
| Los valores nunca cambian | El coche no ha informado nada nuevo: use Despertar un coche y espere unos minutos. |
| Una función queda vacía (habitáculo, cerrado) | Su modelo no la envía a la nube de Nissan. |
| Se rechaza una orden | El coche puede estar en reposo, sin cobertura, o no admitirla (control de carga en algunos modelos). |
| «NissanConnect Services inaccesible» | La nube de Nissan está caída o ha cambiado: inténtelo más tarde y compruebe si hay una actualización de la integración. |
Los registros de la integración (Integraciones → Nissan Connect → Registros) nunca contienen su contraseña ni sus tokens; las líneas de error nombran la petición y el VIN del coche.
Privacidad
- Su usuario y su contraseña solo se envían al servidor de identidad de Nissan, por HTTPS.
- Los tokens de acceso permanecen en memoria, nunca en disco.
- La posición del coche solo se usa para el botón opcional del mapa del widget.
- La integración nunca cierra ni abre las puertas y nunca pide el PIN del coche.
Parámetros de configuración
Estos son los parámetros que Nissan Connect te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Primeros pasos | section | No | Esta integración usa la nube NissanConnect Services (Europa), la misma que la app móvil: indique el usuario y la contraseña de esa app. Su coche debe estar activado primero en la app. Nissan no ofrece una API pública: la integración habla el lenguaje de la app, que Nissan puede cambiar sin aviso. |
| Usuario NissanConnect (e-mail) | string | Sí | La dirección de e-mail con la que inicia sesión en la app NissanConnect Services. |
| Contraseña NissanConnect | secret | Sí | Gladys lo guarda como secreto, nunca se escribe en los registros. |
| Intervalo de actualización (s) | number | No | Con qué frecuencia, en segundos, Gladys lee lo último que su coche envió a la nube de Nissan. No despierta el coche. |
| Intervalo de activación del coche (min) | number | No | Cada cuántos minutos se pide al propio coche que envíe datos nuevos. Cada activación consume la batería de 12 V: deje 0 (solo a petición) o un valor alto como 240. |
| Unidad de distancia | select | No | Unidad de la autonomía y del odómetro. Cambiarla después requiere actualizar el coche desde la pantalla Descubrimiento. |
| Temperatura del clima (°C) | number | No | Temperatura del habitáculo pedida cuando se enciende el clima sin indicar una (16 a 30 °C). |
Cómo instalar Nissan Connect en Gladys
- En Gladys, abre Integraciones: Nissan Connect aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/prohand/gladys-nissanconnect:0.0.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/prohand/gladys-nissanconnect.
Nissan Connect requiere Gladys >=5.3.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Nissan Connect es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene prohand, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación