Integración domótica BYD, gratuita y de código abierto
Su BYD en Gladys: batería, autonomía, carga, cierre, clima, neumáticos y escenas.
Publicado por William-De71
- Dispositivos
- Versión 0.1.0
- Requiere Gladys >=5.1.1
- ★ 0
Presentación
Esta integración lleva sus coches BYD a Gladys a través de la nube de la app BYD internacional (no la app para China): batería, autonomía, carga, cierre, puertas, ventanillas, climatización, presión de neumáticos, alertas y posición. Con el PIN de control remoto de la app, Gladys también puede cerrar y abrir el coche, encender o apagar el clima, hacer destellar las luces y lanzar «localizar coche».
BYD no publica ninguna API: la integración habla el protocolo de la app, a partir de la biblioteca libre pyBYD (usada por la integración de Home Assistant). BYD puede cambiarlo en cualquier momento.
Requisitos previos
- Gladys Assistant 5.1.1 o posterior.
- Un coche BYD conectado a la app BYD, y el correo electrónico y la contraseña de la cuenta de la app.
- Recomendado: una segunda cuenta BYD con la que se comparta el coche (se comparte desde la app). La app puede cerrar la sesión de su teléfono cuando Gladys inicia sesión con la misma cuenta.
- Para los comandos: el PIN de control remoto de 6 cifras definido en la app BYD por la cuenta que usa Gladys (una cuenta compartida define el suyo).
Configuración
| Campo | Función |
|---|---|
| Correo electrónico | La cuenta de la app BYD. |
| Contraseña | Su contraseña, guardada como secreto. |
| País de la cuenta | Código de dos letras del país donde se creó la cuenta (ES, MX, AR…): elige el servidor. |
| PIN de control remoto | Las 6 cifras de la app. Vacío: solo lectura. |
| Intervalo de lectura | 5 a 480 minutos (15 por defecto). Cada lectura despierta el coche y gasta algo de batería. |
| Temperatura del clima | 15 a 31 °C, pedida al encender el clima desde Gladys. |
| Duración del clima | 10, 15, 20, 25 o 30 minutos. |
| Radio de la vivienda | Por debajo de esta distancia a una vivienda de Gladys (con posición), el coche está en casa. |
| Idioma de los textos | Idioma de los nombres, estados y resúmenes de escenas. |
Guarde y haga clic en Probar la conexión: lista los coches de la cuenta.
Uso
Dispositivos
En Descubrir, añada sus coches. Cada coche ofrece las funcionalidades que informa: batería, autonomía eléctrica (y combustible para los híbridos enchufables), cuentakilómetros, cable de carga, estado de la carga, tiempo hasta carga completa, temperatura interior, cierre, puertas y maletero, ventanillas, climatización, presión de los cuatro neumáticos (en bar), alertas y distancia de casa. Vuelva a escanear tras un primer trayecto si falta una funcionalidad.
El cierre y el clima son comandos: necesitan el PIN. Un comando se envía en segundo plano; el coche responde en menos de un minuto y se vuelve a leer 30 segundos después.
Widget de panel
El widget Coche BYD muestra la foto del modelo, la batería, la autonomía, el cierre, las aperturas, la carga, la temperatura interior, el clima, la posición, las alertas y la antigüedad de los datos, con botones para cerrar o abrir, encender o apagar el clima, destellar las luces y abrir el mapa.
Escenas
Disparadores: cerrado o abierto, cerrado pero abierto, carga iniciada o detenida, cable enchufado o desenchufado, llegada o salida de casa, testigo de alerta encendido, problema de cuenta. Acciones: enviar un comando (espera al coche), leer el estado del coche.
- Cuando el coche llega a casa → enviar «Enchufa el coche: {{triggerEvent.data.battery_level}} %».
- Cuando el coche está cerrado pero abierto → enviar {{triggerEvent.data.summary}}.
- Cada día laborable a las 7:40 → enviar el comando «Encender la climatización».
Transporte
Todo pasa por la nube de BYD de su región (insignia nube). Un punto naranja significa que BYD ve el coche sin conexión: los valores pueden ser antiguos.
Solución de problemas
- Inicio de sesión rechazado: compruebe el correo, la contraseña y el país. Tras un rechazo, la integración espera 15 minutos (luego 30, hasta 4 horas) antes de reintentar, para que BYD no bloquee la cuenta; guardar la configuración reintenta de inmediato.
- PIN rechazado: todos los comandos se detienen hasta que cambie el PIN en la configuración. Varios PIN erróneos bloquean el control remoto del coche durante el día.
- Se cerró la sesión de su teléfono: use una segunda cuenta con la que se comparta el coche.
- Valores antiguos, «coche sin conexión»: el coche no tiene red móvil (aparcamiento subterráneo) o duerme profundamente; los comandos pueden fallar hasta que se reconecte.
- Falta un valor o parece erróneo: haga clic en Diagnóstico en la configuración y copie las líneas que empiezan por «BYD diagnostic» de la pestaña Registros en una issue de GitHub (VIN, matrícula y posición se omiten).
Parámetros de configuración
Estos son los parámetros que BYD te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| 1. Cuenta BYD | section | No | Gladys lee sus coches a través de la nube de la app BYD (la app internacional, no la de China), con la cuenta de la app. Consejo: la app BYD puede cerrar la sesión de su teléfono cuando Gladys inicia sesión con la misma cuenta; cree una segunda cuenta, compártale el coche desde la app e introduzca esa cuenta aquí. |
| Correo electrónico | string | Sí | |
| Contraseña | secret | Sí | |
| País de la cuenta | string | Sí | Código de dos letras del país donde se creó la cuenta (ES, MX, AR…): elige el servidor de BYD. |
| 2. Control remoto (opcional) | section | No | Para cerrar, abrir, encender el clima o hacer destellar las luces desde Gladys, introduzca el PIN de control remoto de 6 cifras definido en la app BYD (una cuenta compartida define el suyo). Sin él, Gladys solo lee. Un PIN rechazado detiene los comandos hasta que lo cambie aquí: varios PIN erróneos bloquean el control remoto del coche durante el día. |
| PIN de control remoto | secret | No | |
| Opciones | section | No | |
| Intervalo de lectura (min) | number | No | Entre 5 y 480 minutos. Cada lectura despierta el coche y gasta algo de batería: no baje de 15 minutos sin motivo. |
| Temperatura del clima (°C) | number | No | Se pide al encender el clima desde Gladys, de 15 a 31 °C. |
| Duración del clima | select | No | |
| Radio de la vivienda (m) | number | No | Un coche más cerca que este valor de una vivienda de Gladys (con su posición indicada) está en casa: distancia y escenas de llegada/salida. |
| Idioma de los textos | select | No | Idioma de los nombres de dispositivos, del estado de carga, de las alertas y de los resúmenes de escenas. Automático: el idioma de su panel. |
Cómo instalar BYD en Gladys
- En Gladys, abre Integraciones: BYD 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/william-de71/gladys-byd:0.1.0), 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/William-De71/gladys-byd.
BYD requiere Gladys >=5.1.1. 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
BYD 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 William-De71, 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