Integración domótica Renault / Dacia, gratuita y de código abierto
Coches eléctricos e híbridos enchufables Renault y Dacia: batería, carga, preacondicionamiento.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Siga sus coches eléctricos e híbridos enchufables Renault y Dacia en Gladys: batería, autonomía, carga, preacondicionamiento, kilometraje y, si lo desea, la posición. La integración usa la nube de las aplicaciones MY Renault / MY Dacia, como la aplicación oficial y la integración de Home Assistant.
Sin relación con Renault ni Dacia. Desarrollada sin el hardware: sus comentarios son bienvenidos.
Requisitos
- Gladys 5.1.0 o posterior.
- Un coche vinculado a una cuenta MY Renault o MY Dacia, visible en la aplicación oficial y con sus servicios conectados activos: Zoe, Megane E-Tech, Scenic E-Tech, Renault 5, Renault 4, Twingo Electric, Master E-Tech, Dacia Spring, Captur y Megane híbridos enchufables… Los coches híbridos y de gasolina de la cuenta también aparecen, con lo que la nube da para ellos (kilometraje, autonomía de combustible).
- El correo electrónico y la contraseña de la cuenta.
Configuración
En Gladys, Integraciones → Renault / Dacia → Configuración:
| Campo | Qué introducir |
|---|---|
| País de la cuenta | El país y el idioma de su aplicación (p. ej. «España — Español»). Determinan los servidores de la cuenta. |
| Correo electrónico | El correo de la cuenta. |
| Contraseña | Su contraseña. Solo sirve para iniciar sesión: la sesión abierta se conserva después en el almacenamiento de la integración. |
| Cuenta (opcional) | Vacío: los coches de todas las cuentas de la persona. Para usar solo una, introduzca el identificador que da «Probar la conexión». |
| Idioma de los nombres | El idioma de los nombres de las funciones (francés por defecto). Gladys conserva un nombre una vez creado el dispositivo. |
| Actualización | Frecuencia de lectura de la nube: cada 10, 15 (por defecto), 30 o 60 minutos. |
| Posición GPS | Desactivada por defecto. Activada: se lee y muestra la última posición enviada por el coche. |
Guarde y pulse Probar la conexión: el resultado muestra los coches de la cuenta o indica en rojo lo que falla. Abra después la pestaña Descubrimiento y añada sus coches.
Verificación en dos pasos
Algunas cuentas piden un código enviado por correo en cada nuevo inicio de sesión. La página de configuración muestra entonces «Su cuenta pide un código enviado por correo»:
- pulse Enviar el código de verificación: el resultado indica la dirección (enmascarada) a la que se envió;
- en los minutos siguientes, pulse Introducir el código y escriba el código del correo.
La cuenta reconoce después esta instalación durante unos 30 días y la sesión se conserva: no se pide ningún código en cada reinicio. Un código incorrecto puede introducirse de nuevo; uno demasiado antiguo necesita un nuevo Enviar el código de verificación.
Dispositivos
Un dispositivo por coche, con el nombre del modelo y la matrícula (p. ej. «Renault Zoe (AB-123-CD)»). Cada coche recibe las funciones que ofrece su modelo:
| Función | Significado |
|---|---|
| Nivel de batería | Estado de carga, en %. |
| Autonomía | Autonomía eléctrica estimada por el coche, en km. |
| Estado de la carga | Cargando, enchufado, esperando al cargador, desenchufado (estados de punto de recarga de Gladys). |
| Enchufado | 1 cuando hay un cable conectado. |
| Carga | 1 mientras el coche carga. Un comando en los modelos cuya aplicación puede iniciar la carga (y detenerla en algunos). |
| Potencia de carga | En kW, durante la carga (modelos que la indican). |
| Tiempo de carga restante | En minutos, durante la carga (modelos que lo indican). |
| Temperatura de la batería | En °C (modelos que la indican). |
| Modo de carga | Carga inmediata o programada, un comando (modelos que lo ofrecen, p. ej. Zoe, Captur y Megane híbridos enchufables). |
| Preacondicionamiento | 1 mientras el coche calienta o enfría el habitáculo. Un comando: encendido lo inicia, apagado lo detiene. |
| Temperatura de preacondicionamiento | La temperatura enviada con el próximo preacondicionamiento (de 15 a 25 °C, 21 °C por defecto), guardada por la integración. |
| Temperatura exterior / interior | En °C (modelos que la indican). |
| Kilometraje | En km. |
| Autonomía de combustible | En km (híbridos). |
| Bloqueado / puerta o portón abierto | Los pocos modelos que indican sus cierres (sin bloqueo a distancia: la nube no lo ofrece). |
| Posición GPS | «latitud, longitud», solo cuando la posición GPS está activada. |
Un comando aceptado por la nube no es un comando ejecutado por el coche. El coche lo ejecuta por su cuenta, a menudo uno o dos minutos después. La integración mantiene el valor solicitado diez minutos como máximo, vuelve a leer el coche dos y seis minutos después del comando y publica lo que indica el coche. Si el coche nunca lo indica, vuelve el estado real y el widget muestra «No confirmada por el coche».
Iniciar una carga en el Renault 5, el Renault 4, los Scenic, Megane y Master E-Tech y el Alpine A290 desactiva los programas de carga, como hace la aplicación oficial: vuelva a activarlos en la aplicación si los usa. Estos modelos no pueden detener una carga a distancia: deténgala desde el cargador o el coche.
Widget
Mi Renault / Dacia (elija el vehículo en sus ajustes): batería y autonomía, una lista de estados (carga, modo de carga, preacondicionamiento, cierres, última actualización) y hasta cuatro botones, con el nombre de lo que hace una pulsación ahora: preacondicionar (pide confirmación) o detenerlo, iniciar o detener la carga, cargar ahora o usar el horario, actualizar. Un comando muestra «Solicitado, esperando al coche» hasta que el coche lo indique.
Disparador de escena
Carga terminada: el coche ha dejado de cargar y sigue enchufado (carga completa, o detenida por el coche o el cargador). Filtro opcional: el vehículo. Variables: nivel de batería (%) y autonomía (km). Una carga detenida desde Gladys no lo dispara.
Enchufado, desenchufado, batería por debajo de un umbral: use las funciones del dispositivo en un disparador «cambio de estado de un dispositivo», ya lo hacen.
Acciones de escena
- Actualizar un Renault / Dacia: lee ahora el estado que el coche envió a la nube (sin despertarlo) y da el nivel de batería, la autonomía, enchufado y cargando a las siguientes acciones.
- Preacondicionar un Renault / Dacia: inicia el preacondicionamiento a la temperatura de la acción (de 15 a 25 °C; vacío: la temperatura de preacondicionamiento del vehículo). Salida: la temperatura enviada.
La carga (Carga) y el modo de carga son funciones del dispositivo: una escena los ajusta con «Controlar un dispositivo».
Ejemplos de escenas
- Coche templado a las 7:30 entre semana: a las 7:15, de lunes a viernes, «Preacondicionar un Renault / Dacia» a 21 °C.
- Cargar en horas valle: a las 22:00, si Enchufado vale 1, poner el Modo de carga en Inmediata; a las 6:00, volver a Programada.
- Recordatorio para enchufar: a las 20:00, «Actualizar un Renault / Dacia» y, si la salida nivel de batería es menor que 30 y enchufado es falso, enviar el mensaje «Recuerde enchufar el coche».
- Carga terminada: enviar el mensaje «El Zoe está cargado ({{triggerEvent.data.battery_level}} %)».
Actualizaciones y cuota de la nube
La integración lee la nube con su propio temporizador (no depende del sondeo de Gladys). Cada lectura devuelve el último estado que el coche envió a la nube: nunca despierta el coche. Un coche envía su estado al apagarse, mientras carga y después de un comando; aparcado y dormido, puede pasar horas sin noticias, sea cual sea la actualización elegida.
Una lectura cuesta una llamada por cada punto de acceso que ofrece el coche (batería, kilometraje, climatización, modo de carga, cierres, posición: de 1 a 6). Como Home Assistant, la integración se mantiene por debajo de 60 llamadas por hora y por cuenta: con varios coches, las lecturas se espacian más allá de la actualización elegida si hace falta. Cuando la nube responde «cuota alcanzada», las lecturas se detienen 15 minutos. Un valor que no cambia se envía de nuevo a Gladys cada 12 horas, para que nunca parezca caducado.
Privacidad y datos guardados
- La contraseña se queda en la configuración de Gladys; solo sirve para iniciar sesión.
- La sesión (token de inicio de sesión, identificador de la cuenta, identificadores de esta
instalación tras una verificación en dos pasos) y las temperaturas de preacondicionamiento se
guardan en el volumen
/datade la integración, en un archivo que solo ella puede leer. Nada de ello, ni el correo, aparece en los registros. - La posición GPS está desactivada por defecto; desactivada, nunca se lee.
- La integración solo habla con la nube de Renault (Gigya para el inicio de sesión, Kamereon para los coches).
Solución de problemas
- «La cuenta ha rechazado el inicio de sesión»: revise el país, el correo y la contraseña (los de la aplicación) y guarde. La integración no vuelve a intentarlo por sí sola, para no bloquear la cuenta.
- «Su cuenta pide un código enviado por correo»: vea Verificación en dos pasos.
- «El servicio de inicio de sesión rechaza la conexión por ahora»: demasiados intentos; espere unas horas y guarde de nuevo.
- Falta un coche: compruebe que aparece en la aplicación oficial con la misma cuenta y el mismo país; con varias cuentas, vacíe el campo Cuenta.
- Falta una función: el modelo no la ofrece o nunca envió el valor. La nube responde «prohibido» o «no encontrado» para lo que un modelo no tiene; ese punto de acceso deja entonces de leerse.
- «El modo de privacidad del coche está activado»: desactívelo en el coche.
- Valores antiguos: el coche no ha enviado su estado desde entonces (dormido, sin cobertura donde está aparcado). La fila «Última actualización» del widget da la fecha del último estado.
- Más detalles: ponga
LOG_LEVEL=debugen el contenedor.
Límites
- Desarrollada sin coche ni cuenta, a partir del protocolo y de las respuestas reales reunidas por
renault-api: sus comentarios son bienvenidos en el foro o en las incidencias. - Sin bloqueo, bocina ni ráfagas de luces a distancia: la nube no ofrece el bloqueo, y la bocina y las luces se han dejado de lado (un botón del panel se pulsa fácilmente por error).
- Sin edición de los programas de carga, sin límite de carga, sin historial de cargas.
- Los comandos pasan por la nube de Renault: si falla, nada funciona, y puede cambiar sin aviso.
- La posición se publica como texto; sin distancia al domicilio.
Créditos
El protocolo, la tabla de puntos de acceso por modelo y los datos de prueba vienen de
hacf-fr/renault-api (MIT), la biblioteca de la
integración renault de Home Assistant, cuyo comportamiento (cuota, puntos de acceso rechazados
según el modelo) se ha seguido.
Parámetros de configuración
Estos son los parámetros que Renault / Dacia te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Antes de empezar | section | No | Esta integración inicia sesión en su cuenta MY Renault o MY Dacia, como la aplicación oficial, y lee el estado que sus coches enviaron a la nube (nunca los despierta). Si su cuenta pide un código enviado por correo: guarde, pulse «Enviar el código de verificación» y luego «Introducir el código». Sin relación con Renault ni Dacia. |
| País de la cuenta | select | Sí | El país y el idioma de su aplicación MY Renault / MY Dacia: determinan los servidores de la cuenta. |
| Correo electrónico | string | Sí | La dirección de correo de su cuenta MY Renault o MY Dacia. |
| Contraseña | secret | Sí | Solo sirve para iniciar sesión: la sesión abierta se conserva después en el almacenamiento de la integración. |
| Cuenta (opcional) | string | No | Vacío: los coches de todas las cuentas de la persona. Para usar solo una, introduzca el identificador que da «Probar la conexión». |
| Idioma de los nombres | select | No | Idioma de los nombres de las funciones de los nuevos dispositivos (Gladys conserva un nombre una vez creado el dispositivo). |
| Actualización | select | No | Frecuencia de lectura de la nube. Nunca despierta el coche; con varios coches se alarga para respetar la cuota de la nube. |
| Posición GPS | boolean | No | Desactivada por defecto (privacidad). Activada: se lee y muestra en Gladys la última posición enviada por el coche. |
Cómo instalar Renault / Dacia en Gladys
- En Gladys, abre Integraciones: Renault / Dacia 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/guim31/gladys-renault:1.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/guim31/gladys-renault.
Renault / Dacia requiere Gladys >=5.1.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
Renault / Dacia 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 guim31, no el equipo principal de Gladys.
- Explorar todas las integraciones externas
- Descubrir las integraciones nativas incluidas en Gladys
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación