Integración completa de Home Assistant para cargadores Ampere Point Q Series — Guía paso a paso

Una guía paso a paso: desde instalar Home Assistant, pasando por HACS y xtend_tuya, hasta obtener datos completos del cargador, el panel de Energía y automatizaciones útiles. Escrita para que incluso alguien que nunca haya usado Home Assistant pueda seguirla.

Modelos: Q11, Q22, Q37, Q74  ·  actualizado: julio 2026

Los cargadores Ampere Point Q Series son cargadores Wi-Fi basados en la plataforma Tuya. Esto significa que pueden conectarse a Home Assistant, el sistema de hogar inteligente gratuito más popular, y usarse para mucho más que el control básico en una app móvil:

• monitoreo en vivo: potencia, corriente y voltaje por cada fase, energía de la sesión, energía total y estado de carga,
• control: iniciar y detener la carga, cambiar el límite de corriente,
• automatizaciones: cargar solo durante tarifas fuera de pico, con exceso de producción solar o según precios dinámicos de electricidad,
• historial y estadísticas de consumo en el panel de Energía, útil para reportes y seguimiento de costos.

La integración funciona a través de la nube de Tuya, por lo que tanto el cargador como Home Assistant necesitan acceso a internet.

Tabla de contenidos

1. Lo que necesitas
2. Instalando Home Assistant si aún no lo tienes
3. Instalando HACS
4. Integración oficial de Tuya
5. Complemento xtend_tuya para más datos del cargador
6. Conjunto completo de datos con claves de la nube de desarrolladores Tuya
7. Lo que obtienes tras la integración y el panel de Energía
8. Ejemplos de automatizaciones
9. Problemas comunes y soluciones
10. Alternativa: control local con tuya-local
11. Todos los enlaces en un solo lugar

1. Lo que necesitas

• Un cargador Ampere Point Q Series agregado a la app Smart Life para Android o app Smart Life para iPhone y que funcione correctamente allí.
• Una red Wi-Fi de 2.4 GHz. Los módulos Tuya no se conectan a redes de 5 GHz. Si tu router emite 2.4 GHz y 5 GHz bajo un mismo nombre de red, vale la pena separar temporalmente la red de 2.4 GHz durante el emparejamiento.
• Una computadora o servidor pequeño para Home Assistant. Debe estar encendido continuamente si quieres que las automatizaciones funcionen todo el tiempo. Las opciones comunes son Raspberry Pi, un mini PC o una computadora Windows regular.
• Una cuenta gratuita de GitHub, necesaria una vez para la autorización de HACS.
• Tu teléfono con la app Smart Life cerca, porque escanearás códigos QR durante la configuración.
• Aproximadamente de 1 a 2 horas. La mayoría de los pasos son clics guiados simples.

2. Instalando Home Assistant si aún no lo tienes

Si ya tienes Home Assistant funcionando, ve directamente a la sección 3.

Opción A: dispositivo dedicado, recomendado a largo plazo

En una Raspberry Pi, mini PC o laptop antigua, la ruta más sencilla es Home Assistant OS. Es un sistema completo que maneja Home Assistant, actualizaciones y copias de seguridad. Las instrucciones oficiales para cada plataforma están disponibles aquí: home-assistant.io/installation. Después de la instalación, el panel de control suele estar disponible en un navegador en http://homeassistant.local:8123.

Opción B: computadora con Windows usando Docker

Este es un buen punto de partida para pruebas. Home Assistant se ejecuta en un contenedor en tu computadora normal. Recuerda que las automatizaciones solo funcionan cuando la computadora está encendida y Docker está en ejecución.

1. Instala WSL2, que Docker necesita en Windows. Haz clic derecho en el menú Inicio, abre Terminal (administrador), ingresa wsl --install, confirma y reinicia el equipo cuando termine. Instrucciones de Microsoft: learn.microsoft.com/pl-pl/windows/wsl/install.
2. Instala Docker Desktop: docker.com/products/docker-desktop. Durante la instalación, mantén habilitada la opción WSL 2. Después de iniciar Docker Desktop, espera hasta que el estado indique que está en ejecución. Puedes omitir la creación de una cuenta Docker.
3. Inicia Home Assistant. Abre la Terminal sin privilegios de administrador y pega:

   mkdir C:\HomeAssistant\config
   docker run -d --name homeassistant --restart=unless-stopped -e TZ=Europe/Warsaw -v "C:\HomeAssistant\config:/config" -p 8123:8123 ghcr.io/home-assistant/home-assistant:stable

   El primer inicio descarga aproximadamente 1.5 GB y usualmente toma unos minutos.
4. Abrir http://localhost:8123 en tu navegador. Si no carga inmediatamente, espera uno o dos minutos y actualiza.

Con la opción Docker, reinicia Home Assistant en Docker Desktop: Contenedores → homeassistant → icono de reinicio. También puedes usar docker restart homeassistant. El botón de reinicio puede no aparecer en el menú de Home Assistant en esta configuración, lo cual es normal. Necesitarás reiniciar varias veces en los siguientes pasos.

Primer inicio para ambas opciones

El asistente de bienvenida te pedirá crear una cuenta local, elegir la ubicación y configurar las unidades. Guarda el nombre de usuario y la contraseña en un lugar seguro. Puedes omitir la lista de dispositivos descubiertos automáticamente en esta etapa.

3. Instalando HACS

HACS, la Tienda Comunitaria de Home Assistant, es una tienda de complementos comunitaria. La usaremos para instalar xtend_tuya. Las instrucciones oficiales están aquí: hacs.xyz/docs/use/download/download. Elige la pestaña que coincida con tu instalación.

• Home Assistant OS: añade el repositorio de complementos https://github.com/hacs/addons según las instrucciones oficiales, instala y ejecuta el complemento Get HACS, luego reinicia Home Assistant.
• Opción Docker: ejecuta esto en Terminal:

  docker exec homeassistant bash -c "wget -O - https://get.hacs.xyz | bash -"
  docker restart homeassistant

Después del reinicio, agrega la integración: Configuración → Dispositivos y servicios → Agregar integración, busca HACS y acepta los términos. Home Assistant mostrará un código que debes ingresar en github.com/login/device después de iniciar sesión en GitHub. Confirma con Autorizar. Después de un momento, HACS aparecerá en la barra lateral.

4. Integración oficial de Tuya

Este paso conecta Home Assistant con tu cuenta de Smart Life.

1. Ve a Configuración → Dispositivos y servicios → Agregar integración y busca Tuya.
2. El asistente te pedirá tu Código de Usuario. En la app Smart Life, encuéntralo en Yo → Configuración (engranaje) → Cuenta y Seguridad → Código de Usuario. Introdúcelo exactamente. Las mayúsculas y minúsculas importan.
3. Aparecerá un código QR en pantalla. En Smart Life, usa el escáner en la esquina superior derecha de la pestaña Yo, escanea el código y confirma el inicio de sesión en tu teléfono.
4. Después de un momento, tu cargador debería aparecer en la lista de dispositivos.

Qué esperar: la integración oficial de Tuya generalmente expone solo una entidad para el cargador, a menudo un interruptor de carga. Los datos completos como potencia, corrientes, voltajes, energía y estado detallado aparecen después de agregar xtend_tuya en los siguientes pasos. La ausencia de sensores en esta etapa no es un error.

5. complemento xtend_tuya para más datos del cargador

xtend_tuya funciona junto con la integración oficial de Tuya y añade entidades faltantes a los mismos dispositivos. Página del proyecto: github.com/azerty9971/xtend_tuya.

5.1. Descargar en HACS

1. Abre HACS desde la barra lateral y busca Xtend Tuya. También puedes usar este enlace directo: abrir Xtend Tuya en mi Home Assistant.
2. En la página del complemento, haz clic en Descargar y confirma.
3. Reinicia Home Assistant.

Descargar en HACS es solo la primera mitad del proceso. Copia archivos al disco, pero aún no añade la integración. Las entidades aparecen solo después de agregar la integración en la sección 5.2. Esta es la confusión más común en toda la configuración: después de la descarga, el botón Descargar desaparece, la página del complemento muestra solo una descripción y el conteo de entidades no aumenta ni siquiera después de reinicios. Si esto es lo que ves, todo está bien. Continúa con el siguiente paso.

5.2. Añadir la integración

1. Ve a Configuración → Dispositivos y servicios → Añadir integración y busca Xtend Tuya.
2. Ingresa el mismo Código de Usuario que en la sección 4 y escanea el código QR nuevamente con la app Smart Life.
3. Después de confirmar el código QR, aparecerá una nueva ventana llamada Añadir credenciales OpenAPI de Tuya. Lee la nota abajo antes de hacer clic en algo.

El consejo más importante de esta guía. No cierres la ventana Añadir credenciales OpenAPI de Tuya con el botón X. Cerrarla cancela todo el asistente sin un mensaje claro. La integración no se añadirá, aunque parezca que completaste la configuración. Si aún no tienes claves de la nube de desarrolladores Tuya, que obtendremos en la sección 6:

1. marca No pedir credenciales OpenAPI,
2. también elige país Polonia y punto final Europa. El formulario aún requiere estos campos, y sin ellos puede mostrar un error de validación poco claro,
3. confirma, luego haz clic en Finalizar en la siguiente pantalla con nombres y áreas.

Ventana de credenciales OpenAPI, mostrada como referencia. Marca la casilla, elige país y punto final, luego confirma. No cierres la ventana con el botón X.

Después de que el asistente termine, la lista de integraciones mostrará Xtend Tuya. Tu cargador debería obtener varias, hasta más de veinte nuevas entidades, incluyendo sensores de voltaje, corriente, potencia, energía y estado. Si falta la entrada Xtend Tuya, el asistente fue interrumpido. Repite la sección 5.2.

6. Conjunto completo de datos con claves de la nube de desarrolladores Tuya

Esta etapa es opcional, pero recomendada. Sin ella, algunas entidades pueden no estar disponibles o actualizarse más lentamente. Crearemos un proyecto gratuito en la plataforma de desarrolladores Tuya y añadiremos sus claves a xtend_tuya. La documentación del complemento también describe el procedimiento aquí: guía de credenciales en la nube.

6.1. Crear un proyecto en la plataforma Tuya

1. Ve a platform.tuya.com y crea una cuenta gratuita. Puedes usar la misma dirección de correo electrónico que en Smart Life.
2. Ve a Cloud → Desarrollo → Crear proyecto en la nube. Ingresa cualquier nombre para el proyecto. Para Industria y Método de desarrollo, elige Hogar inteligente. Para Centro de datos, elige Centro de datos de Europa Central. El centro de datos debe coincidir con la región de tu cuenta Smart Life. Para Polonia, es Europa Central. El plan gratuito permite un centro de datos.
3. En la ventana Autorizar servicios API, acepta los servicios sugeridos.
4. Vincula la cuenta de la app: Dispositivos → Vincular cuenta de la app → Añadir cuenta de la app, escanea el código QR con Smart Life y confirma. Elige Vinculación automática, para que los nuevos dispositivos puedan unirse automáticamente. Después de un momento, tu cargador debería aparecer en la lista de dispositivos.
5. Encuentra las claves de tu proyecto en la pestaña Resumen en la sección Clave de autorización: Access ID / Client ID y Access Secret / Client Secret. Usa el icono de ojo para revelar el secreto.

El Client Secret funciona como una contraseña para tu proyecto. No lo compartas ni lo pegues en lugares públicos. Si es necesario, puedes restablecerlo en la pestaña Resumen. Después de restablecerlo, actualiza la clave en Home Assistant.

6.2. Habilitar todos los puntos de datos con DP Instruction

Por defecto, la nube de Tuya puede exponer dispositivos en un modo simplificado que oculta algunos puntos de datos. Para exponer el conjunto completo, cambia el producto al modo DP Instruction: Dispositivos → Todos los dispositivos → el botón de tres puntos junto a Ver dispositivos por producto → pasa el cursor sobre la tarjeta del producto → icono de lápiz → marca DP Instruction → Guardar configuración. La advertencia mostrada por la plataforma se aplica solo a este proyecto API. La app Smart Life y el cargador siguen funcionando como antes. Hay instrucciones ilustradas disponibles en la documentación de xtend_tuya.

6.3. Introducir las claves en Home Assistant

1. Ve a Configuración → Dispositivos y servicios → Xtend Tuya → Configurar. Se abrirá la misma ventana de credenciales OpenAPI.
2. Esta vez, desmarca No pedir credenciales OpenAPI. Elige el país Polonia y el punto final Europa, luego pega el Access ID y Access Secret desde la pestaña Resumen del proyecto Tuya. Confirma.
3. Reinicia Home Assistant y espera uno o dos minutos. El recuento de entidades del cargador debería aumentar de nuevo. Si no es así, usa Recargar desde el menú de tres puntos junto a la integración Xtend Tuya.

7. Lo que obtienes después de la integración y el panel de energía

La lista exacta de entidades depende del modelo del cargador, pero normalmente incluye:

Lecturas	Control
estado de carga, potencia instantánea, corriente y voltaje para las fases L1 a L3, energía de la sesión actual, energía total y códigos de error	iniciar y detener la carga, límite de corriente de carga, por ejemplo reducir de 16 A a 10 A, y modos de dispositivo disponibles

Vale la pena dar nombres claros a las entidades en Configuración → Dispositivos y servicios → Entidades. Si un elemento, como un interruptor, aparece dos veces, una vez desde Tuya y otra desde xtend_tuya, eso es normal. Simplemente puedes desactivar la entidad duplicada que no quieras usar.

Panel de energía: vaya a Configuración → Paneles → Energía. En la sección Dispositivos individuales, agregue la entidad de energía total del cargador. Después de una o dos horas, Home Assistant debería comenzar a mostrar gráficos de consumo diario y mensual. Más sobre el panel de energía: home-assistant.io/docs/energy.

8. Ejemplos de automatizaciones

Las automatizaciones se crean en Configuración → Automatizaciones y escenas → Crear automatización. Los ejemplos a continuación pueden pegarse en modo edición YAML. Reemplace los IDs de entidad, como sensor.… y switch.…, con sus propios IDs de la pestaña Entidades. Las notificaciones al teléfono requieren la aplicación gratuita Home Assistant Companion.

Cargar solo durante una ventana de tarifa valle, de 22:00 a 06:00:

alias: Cargar durante tarifa valle
disparador:
  - plataforma: time
    a las: "22:00:00"
    id: start
  - plataforma: time
    a las: "06:00:00"
    id: stop
acción:
  - elegir:
      - condiciones: [{ condition: trigger, id: start }]
        secuencia:
          - servicio: switch.turn_on
            objetivo: { entity_id: switch.charger_switch }
      - condiciones: [{ condition: trigger, id: stop }]
        secuencia:
          - servicio: switch.turn_off
            objetivo: { entity_id: switch.charger_switch }

Notificación cuando termina la carga:

alias: Carga terminada
disparador:
  - plataforma: state
    entity_id: sensor.charger_status
    de: "charging"
    a: "charger_free"
acción:
  - servicio: notify.mobile_app_your_phone
    data:
      título: "Cargador"
      mensaje: "La carga ha terminado."

Cargando con exceso de producción solar, si Home Assistant tiene un sensor para la energía exportada a la red:

alias: Cargar con exceso de solar
disparador:
  - plataforma: numeric_state
    entity_id: sensor.grid_export_power
    por encima de: 3000
    durante: "00:05:00"
    id: start
  - plataforma: numeric_state
    entity_id: sensor.grid_export_power
    por debajo de: 500
    durante: "00:05:00"
    id: stop
acción:
  - elegir:
      - condiciones: [{ condition: trigger, id: start }]
        secuencia:
          - servicio: switch.turn_on
            objetivo: { entity_id: switch.charger_switch }
      - condiciones: [{ condition: trigger, id: stop }]
        secuencia:
          - servicio: switch.turn_off
            objetivo: { entity_id: switch.charger_switch }

9. Problemas comunes y soluciones

Síntoma	Qué hacer
Después de descargar xtend_tuya en HACS, el conteo de entidades no aumenta y reiniciar no ayuda.	Descargar archivos no es lo mismo que agregar la integración. Verifique si Xtend Tuya aparece bajo Configuración → Dispositivos y servicios. Si no aparece, complete el asistente de la sección 5.2.
La ventana de credenciales OpenAPI se cerró con el botón X y la integración desapareció.	El asistente fue cancelado. Inícielo de nuevo y maneje la ventana como se describe en la sección 5.2: casilla de verificación, país, endpoint, luego confirme.
El formulario OpenAPI muestra un error como el valor debe ser uno de [...].	Incluso cuando No preguntar... está marcado, aún debe elegir el país y el endpoint. Seleccione Polonia y Europa, luego confirme.
Los registros muestran sign invalid.	El ID de acceso o el secreto se pegaron con un error tipográfico o espacio extra, o se seleccionó el endpoint incorrecto. Copie las claves nuevamente desde la pestaña de Resumen del proyecto. Para Polonia, el endpoint es Europa.
Los registros muestran permission deny o código 1106.	En tu proyecto de la plataforma Tuya, revisa la pestaña Service API. Los servicios IoT Core y Authorization deben estar activos. Usa Autorizar o Renovar si es necesario.
La integración funcionaba, pero después de unos meses los datos dejaron de actualizarse.	La prueba gratuita de IoT Core puede haber expirado. En la plataforma Tuya, ve a Cloud → project → IoT Core → Extend Trial. La extensión es gratuita. Vale la pena poner un recordatorio en el calendario.
El código QR de la plataforma Tuya no funciona o falla el enlace de la cuenta en la app.	La cuenta de Smart Life y el proyecto probablemente estén en diferentes centros de datos. Crea el proyecto en el Centro de Datos de Europa Central para cuentas usadas en Polonia.
Todas las entidades del cargador están no disponibles.	La integración funciona a través de la nube. Verifica el acceso a internet y confirma que el cargador esté en línea en Smart Life. Cuando la conectividad regrese, las entidades deberían recuperarse automáticamente.
El cargador no se conecta al Wi-Fi después de cambiar el router o la contraseña.	Asegúrate de que la red Wi-Fi de 2.4 GHz esté habilitada y vuelve a emparejar el cargador en Smart Life. Luego debería aparecer automáticamente en Home Assistant.
Después de una actualización de Home Assistant, Xtend Tuya no se inicia.	Revisa HACS para una versión más reciente del complemento y actualízalo. Las integraciones personalizadas pueden ser sensibles a las grandes actualizaciones de Home Assistant. Antes de actualizar Home Assistant, a menudo vale la pena esperar unos días y revisar la página de problemas del proyecto.
El mismo interruptor aparece dos veces.	Esto es normal cuando xtend_tuya funciona junto con la integración oficial de Tuya. Desactiva la entidad duplicada que no necesites. No elimines la integración.
Incluso después de todos los pasos, el dispositivo sigue teniendo solo una entidad.	A veces, la definición del producto Tuya solo expone un conjunto limitado de datos. Contáctanos en hello@amperepoint.com con tu modelo y una breve descripción del problema. Revisaremos la configuración del producto en el lado de la nube.

10. Alternativa: control local con tuya-local

Si quieres independencia de la nube, para que el control funcione incluso sin acceso a internet, puedes usar tuya-local en su lugar. También se instala a través de HACS. La configuración requiere la clave local del dispositivo y el mapeo manual de puntos de datos, por lo que es más técnico y está mejor dirigido a usuarios que ya se sienten cómodos con Home Assistant. Una herramienta útil para leer datos del dispositivo es TinyTuya.

11. Todos los enlaces en un solo lugar

Resumen

Después de completar esta guía, tu cargador Ampere Point Q Series se convierte en una parte completa de tu hogar inteligente. Puedes ver cada sesión de carga, seguir los costos en el panel de Energía y cargar tu coche cuando la electricidad sea más barata o cuando tu instalación solar produzca energía excedente.

Las pantallas de Home Assistant y la plataforma Tuya cambian de vez en cuando, por lo que algunos botones pueden moverse o cambiar de nombre. El orden general de los pasos sigue siendo el mismo.

¿Atascado en uno de los pasos? Envíanos un correo electrónico a hello@amperepoint.com o llama al +48 666 612 044, de lunes a viernes, de 10:00 a 17:00. Estaremos encantados de ayudarte.

¿Buscas un cargador listo para funcionar con Home Assistant? Consulta nuestros cargadores de la serie Q con medidores de energía.