El perfil oficial del dispositivo AmperePoint Q Series ha sido aceptado en el repositorio principal tuya-local. Esto proporciona a Home Assistant una conexión directa en la red local con los cargadores compatibles, por lo que las lecturas y comandos rutinarios no tienen que pasar por la nube de Tuya.
Disponibilidad: el perfil AmperePoint se ha fusionado en el repositorio principal de tuya-local, pero no está incluido en la versión estable 2026.7.2. Antes de instalar, revise HACS para una versión posterior cuyas notas incluyan PR #5595.
¿Qué cambia la integración local?
Una vez configurado, Home Assistant se comunica con el cargador a través de su LAN. tuya-local reconoce las variantes compatibles de Q Series usando sus identificadores de producto Tuya y los puntos de datos realmente expuestos por el dispositivo. Dependiendo del firmware del cargador y los puntos de datos disponibles, el perfil puede proporcionar:
- estado de carga y conexión del vehículo,
- control de inicio y parada, límite de corriente y modo de carga,
- potencia en vivo, energía de sesión y energía total,
- temperatura, fallos y diagnósticos,
- datos de energía objetivo y programación cuando los suministra el cargador,
- mediciones de fase como entidades diagnósticas opcionales.
El perfil contiene los identificadores de producto de la cuenta de fabricante Tuya de AmperePoint, incluidos productos antiguos que seguimos soportando. Intencionalmente es un solo perfil AmperePoint Q Series en lugar de un conjunto de perfiles basados en sufijos de modelos comerciales. Los puntos de datos reales determinan qué entidades opcionales aparecen.
Antes de comenzar
- Home Assistant con HACS instalado,
- una versión de tuya-local posterior a 2026.7.2 que incluya el PR #5595,
- un cargador AmperePoint Q Series ya agregado a la aplicación oficial Smart Life o Tuya Smart,
- Home Assistant y el cargador en la misma LAN, o en redes enrutadas que permitan la comunicación entre ellos,
- acceso a su router si el descubrimiento automático de IP no encuentra el cargador.
Recomendado: cree una reserva DHCP para el cargador. Se admite el descubrimiento automático, pero un arrendamiento fijo evita problemas después de reiniciar el router.
¿Necesita una cuenta de desarrollador Tuya?
No para la configuración recomendada. El flujo de configuración actual de tuya-local puede autorizar el acceso con un código de usuario y un código QR desde la aplicación Smart Life o Tuya Smart. Recupera el ID del dispositivo y la clave local e intenta descubrir el cargador en la LAN. La documentación de tuya-local indica explícitamente que este método no requiere una cuenta propia en la Plataforma de Desarrolladores Tuya IoT.
La configuración asistida por la nube usa Tuya solo durante la incorporación para recuperar las credenciales del dispositivo. Después de la configuración, las lecturas rutinarias y comandos se intercambian localmente. El cargador puede mantener su propia conexión a Tuya; instalar tuya-local no bloquea automáticamente el acceso a Internet.
1. Instalar o actualizar tuya-local
- Abre HACS → Integraciones en Home Assistant.
- Busca Tuya Local desde
make-all/tuya-local. - Si no está listado, añade
https://github.com/make-all/tuya-localcomo un repositorio personalizado de HACS en la categoría Integración. - Instala tuya-local o actualízalo a una versión que contenga el perfil AmperePoint.
- Reinicia Home Assistant. Descargar archivos de integración Python en HACS no los carga hasta que Home Assistant se reinicia.
2. Añadir el cargador sin una cuenta de desarrollador
- Ve a Configuración → Dispositivos y servicios → Integraciones.
- Selecciona Añadir integración, busca Tuya Local y comienza la configuración.
- Elige la configuración de dispositivo SmartLife asistida por la nube. El flujo recuperará el ID de dispositivo y la clave local e intentará encontrar la dirección IP del dispositivo.
- En Smart Life o Tuya Smart, abre Yo → Configuración → Cuenta y Seguridad → Código de Usuario. Las etiquetas pueden variar ligeramente entre versiones de la app y idiomas.
- Ingresa el código de usuario en tuya-local. Home Assistant mostrará un código QR.
- Escanea el código QR con el escáner en la misma cuenta Smart Life o Tuya Smart que contiene el cargador, luego aprueba el inicio de sesión.
- Regresa a Home Assistant y selecciona el cargador de la lista de dispositivos de tu cuenta.
- Verifica el ID de dispositivo y la clave local completados automáticamente. Si no se encuentra una dirección IP, ingresa la dirección que aparece en la lista de clientes DHCP de tu router.
- Comienza con la versión del protocolo configurada en auto.
- Selecciona el perfil de dispositivo cargador EV. Una coincidencia exitosa debería mostrar el fabricante AmperePoint y el modelo Q Series.
Si agregas varios cargadores desde la misma cuenta Tuya, el token de autorización de corta duración normalmente puede reutilizarse hasta que Home Assistant se reinicie. Cada cargador recibe su propia entrada de configuración y entidades.
Seguridad: nunca publiques tu ID de dispositivo, clave local, código de usuario o código QR. Volver a emparejar el cargador en la aplicación del proveedor cambia su clave local, por lo que la entrada de tuya-local debe configurarse nuevamente.
Alternativa avanzada: Plataforma de Desarrolladores Tuya y TinyTuya
Esta ruta no es necesaria para una instalación normal de tuya-local. Puede ser útil para la recuperación manual de credenciales, diagnóstico de puntos de datos o TinyTuya.
- Crea una cuenta en la Plataforma de Desarrolladores Tuya y abre Nube → Desarrollo.
- Crea un proyecto en la nube usando el método de desarrollo Smart Home.
- Selecciona el centro de datos que sirve a la región configurada en tu cuenta Smart Life o Tuya Smart. Una región incorrecta es una causa común de lista de dispositivos vacía.
- Si se solicita, autoriza los servicios básicos de la API Smart Home requeridos por el asistente del proyecto.
- Abre Dispositivos → Vincular cuenta de la app Tuya → Agregar cuenta de app, escanea el código QR con la app que contiene el cargador y aprueba el enlace.
- Encuentra el cargador en la lista de dispositivos y guarda su ID de dispositivo.
- Usa Nube → Explorador API → Gestión de dispositivos → Consultar detalles de dispositivos en lote para obtener la
local_key. - Lee la dirección IP desde tu router e ingresa el host, ID de dispositivo y Clave Local en la configuración manual de tuya-local. Comienza con el protocolo auto.
Los derechos gratuitos de proyectos en la nube de Tuya y su duración pueden cambiar. Si la API no devuelve una Clave Local, usa el flujo QR recomendado. TinyTuya también puede usar el ID de acceso del proyecto, el secreto de acceso, un ID de dispositivo y la región correcta para recuperar dispositivos y escanear la LAN. Trata todos estos valores como credenciales.
3. Revisa las entidades y prueba la conexión
Abre la página del dispositivo en Home Assistant. El conjunto exacto de entidades depende del firmware del cargador y los puntos de datos. Las mediciones opcionales solo se crean cuando el cargador realmente las suministra.
- Confirma que el dispositivo esté disponible y que las lecturas básicas se actualicen.
- Sin vehículo conectado, prueba el límite de corriente y el control de inicio/parada. La entidad correspondiente debería confirmar el nuevo valor después de unos segundos.
- Reinicia Home Assistant y verifica que el cargador vuelva a estar en línea sin necesidad de configurarlo de nuevo.
- Si algo falla, revisa Configuración → Sistema → Registros y busca
tuya_localantes de eliminar la entrada de integración.
4. Usa las entidades locales con el panel de AmperePoint
tuya-local y TuyaExtend AmperePoint tienen roles diferentes. tuya-local se comunica con el cargador a través de la LAN y crea entidades en Home Assistant. Nuestra integración AmperePoint organiza esos valores en una interfaz enfocada en vehículos eléctricos con un panel, planificador semanal, anulaciones manuales, vista previa de la siguiente acción y confirmación de comandos.
Agrega o edita una entrada de integración de AmperePoint y selecciona las entidades tuya-local como su fuente. El panel se describe en nuestra guía complementaria: Panel y planificador de carga AmperePoint Q Series en Home Assistant.
Solución de problemas
Falta el perfil de AmperePoint
Verifica la versión instalada de tuya-local. La versión estable 2026.7.2 aún no contiene el perfil; necesitas una versión posterior que incluya el PR #5595. Un perfil presente en GitHub main la rama no está presente automáticamente en la versión descargada por HACS.
El cargador no aparece listado tras la autorización por QR
Escanea el código QR con la misma cuenta oficial de Smart Life o Tuya Smart que posee el cargador. Una app con marca OEM puede no funcionar con este proceso. Para la ruta de la Plataforma de Desarrolladores, verifica la región de la app, el centro de datos del proyecto y el enlace de la cuenta de la app.
El descubrimiento automático no puede encontrar la dirección IP
Introduce la dirección desde la lista DHCP de tu router. El descubrimiento puede verse afectado por VLANs, redes de invitados, aislamiento de clientes Wi-Fi, múltiples subredes, una app Tuya abierta u otra integración local conectada al cargador. Crea una reserva DHCP en lugar de dejar una dirección cambiante.
El cargador no está disponible
Revisa la conexión entre Home Assistant y el cargador, confirma que la dirección IP no haya cambiado y asegúrate de que ninguna otra integración local esté manteniendo una conexión paralela. Cierra la app Tuya, recarga la entrada de la integración y verifica las reglas del firewall LAN.
Las lecturas funcionan pero los comandos fallan
Verifica la clave local y la versión del protocolo. Una clave incorrecta a veces permite un descubrimiento limitado pero impide el control. Si auto es inestable, prueba la versión del protocolo identificada por tuya-local y consulta la documentación del proyecto.
Dejó de funcionar después de que el cargador se emparejó de nuevo
Esto es normal: Tuya genera una nueva clave local cuando un dispositivo se vuelve a emparejar. Reconfigura la entrada de tuya-local con la clave actual.
Actualizaciones y soporte
El perfil AmperePoint forma parte del proyecto tuya-local original, por lo que las futuras correcciones pueden llegar a los usuarios mediante actualizaciones normales de HACS. Mantendremos la compatibilidad con las variantes Q Series soportadas. Si un cargador no es reconocido o falta una entidad disponible en la app Tuya, repórtalo en el rastreador de incidencias de AmperePoint. Incluye la versión de tuya-local y el firmware del cargador, pero nunca incluyas un ID de dispositivo, clave local ni datos de inicio de sesión.
Referencias técnicas
- Perfil AmperePoint — PR #5595 de tuya-local
- Instalación y configuración de tuya-local
- Recuperación manual del ID del dispositivo y la clave local
- Documentación del proyecto en la nube Tuya Smart Home
- Vincular una cuenta de la app a un proyecto Tuya
- TuyaExtend AmperePoint en GitHub
tuya-local y Home Assistant son proyectos comunitarios y no son propiedad de AmperePoint. El trabajo en una instalación eléctrica debe ser realizado por una persona debidamente cualificada. Un límite de corriente por software no reemplaza un cableado correctamente diseñado, la protección ni las instrucciones de seguridad del fabricante.
