AMPERE POINT Q Series and Home Assistant step-by-step guide banner with a dashboard of live charger data

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

Jan Prószyński

Esta guía le ayuda a conectar su cargador Ampere Point Q Series a Home Assistant y abrir un panel de control listo para usar. Utilizamos la integración oficial de Tuya y la integración AmperePoint instalada mediante HACS o Marketplace. La configuración estándar se realiza en la interfaz, sin editar YAML ni crear una cuenta de Tuya Developer.

Actualizado: 4 de noviembre de 2026 · Q11, Q22, Q37, Q74 · versión de referencia de la integración: 0.6.1. Las lecturas y los comandos disponibles dependen de la generación y del firmware del cargador.

1. Qué necesita

  • Un cargador Q Series vinculado a Tuya Smart o Smart Life y funcionando en la aplicación; utilice Wi-Fi de 2,4 GHz para el emparejamiento.
  • Home Assistant 2025.2.0 o posterior en un dispositivo que permanezca encendido.
  • Acceso a Internet para HA y el cargador: esta configuración de Q Series utiliza la nube de Tuya.
  • HACS o Marketplace y una cuenta de GitHub para autorizar la incorporación de un repositorio personalizado.
  • Un teléfono con la aplicación Tuya y una segunda pantalla donde mostrar el código QR.

2. Instalar Home Assistant si aún no lo tiene

Instalar Home Assistant si aún no lo tiene

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. HACS o Marketplace

En HA 2026.11 o posterior, abra Ajustes → Marketplace. Según la documentación de HA, Marketplace está integrado y asume la función de HACS.

En HA 2026.10 o anterior, abra HACS en la barra lateral. Si no está instalado, siga las instrucciones oficiales para su tipo de instalación, reinicie HA, añada la integración HACS y autorícela con GitHub.

A continuación, abra HACS o Marketplace para añadir el repositorio de AmperePoint. Los repositorios de aplicaciones/complementos de HA se encuentran en otro lugar. Documentación de Marketplace.

4. Conectar la integración oficial de Tuya

  1. En HA, abra Ajustes → Dispositivos y servicios → Añadir integración → Tuya.
  2. En Tuya Smart o Smart Life, busque Yo → Ajustes → Cuenta y seguridad → Código de usuario / User Code. Introduzca el código en HA.
  3. Escanee el código QR con la misma aplicación y cuenta a la que pertenece el cargador y confirme el inicio de sesión.
  4. Antes de continuar, compruebe que el cargador aparece entre los dispositivos de la integración Tuya. Instrucciones oficiales de Tuya.

5. Descargar AmperePoint

  1. Abra HACS → ⋮ → Repositorios personalizados. En Marketplace utilice la opción de repositorio personalizado; el botón inferior ofrece un acceso directo.
  2. Pegue la dirección completa indicada abajo, seleccione el tipo Integración / Integration y pulse Añadir.
  3. Busque TuyaExtend AmperePoint, abra su página y descargue la versión publicada actual.
  4. Reinicie Home Assistant y actualice el navegador. En una instalación Container puede reiniciar el contenedor.
  5. Descargar los archivos y añadir el dispositivo son pasos distintos. Tras el reinicio, complete la siguiente sección.

Tipo de repositorio: Integration

Abrir el repositorio en mi Home Assistant

Pegue la dirección en el campo de repositorio de HACS/Marketplace, sin añadir una ruta de archivo o carpeta. El nombre en la tienda es TuyaExtend AmperePoint; en los ajustes de HA debe buscar AmperePoint.

6. Añadir el cargador y abrir el panel

  1. Abra Ajustes → Dispositivos y servicios → Añadir integración y busque AmperePoint. Si HA ya ha añadido automáticamente una entrada para el cargador, abra esa entrada.
  2. Elija la configuración de un cargador detectado, seleccione el dispositivo correcto y asígnele un nombre. Esta configuración de Q Series utiliza la fuente Tuya.
  3. Establezca el precio de la energía y la moneda, revise el resto de ajustes y termine el asistente.
  4. Abra Ampere Point - Tuya dashboard en la barra lateral. El panel compartido se crea automáticamente; si tiene varios cargadores, seleccione el dispositivo en la cabecera.

7. Lecturas y controles

Compruebe que el panel muestra el cargador correcto y lecturas actuales. Las funciones disponibles incluyen estado, potencia, energía de la sesión, límite de corriente, inicio/parada y diagnóstico.

La disponibilidad depende del dispositivo y de los datos que proporciona Tuya. Las mediciones de fases, el contador total y el objetivo de energía solo aparecen cuando la fuente los admite.

Al cambiar el límite de corriente, el panel muestra el valor seleccionado. Después de enviar un comando, espere la confirmación del cargador. El límite de HA debe estar dentro del rango permitido por el cargador y la instalación eléctrica.

Ejemplo del panel de un cargador Ampere Point en Home Assistant
Vista de ejemplo. Las lecturas, el diseño y las funciones pueden variar según la versión y el cargador.

8. Añadir el cargador a Energía

  1. Seleccione el cargador en el panel AmperePoint y despliegue Energía en Home Assistant / Energy in Home Assistant, encima del pie de página. Allí encontrará el identificador exacto de la entidad Energía de carga / Charging energy.
  2. Añada esa entidad como dispositivo individual en los ajustes de Energía. Añada cada cargador físico una sola vez. La energía de sesión, de la última sesión y el sensor diagnóstico calculado a partir de la potencia no son fuentes adicionales de ese mismo consumo.
  3. Recorder debe registrar la entidad. El contador nuevo comienza desde cero; las estadísticas anteriores no se combinan automáticamente. Los gráficos necesitan tiempo para recoger datos. El coste de la sesión es una estimación de energía y tarifa, no un cálculo con precios históricos. Medición y migración.

9. Planificador y energía solar

El planificador integrado guarda días de la semana, varias franjas horarias y un límite de corriente por franja. Las anulaciones manuales permiten cargar durante un tiempo elegido o hasta un objetivo de energía.

HA ejecuta los comandos del planificador. Home Assistant y la conexión al cargador deben seguir disponibles también al detener la carga. Coordine el horario con la aplicación Tuya y otras automatizaciones para evitar comandos contradictorios.

Desde la versión 0.6.1, el modo FV puede ajustar la corriente al excedente solar con una fuente Tuya o entidades asignadas. En las opciones de integración, seleccione la producción FV y la potencia de red con signo o lecturas separadas de importación/exportación; compruebe las unidades y el signo de importación.

Las entradas AmperePoint Local (LAN) aún no tienen ajustes FV. El modo está desactivado de forma predeterminada; el regulador de esta versión se probó con datos sintéticos, sin probar carga FV en un cargador físico. Configuración y límites FV.

10. Resolver problemas de instalación

HACS no encuentra el repositorio o indica que falta una carpeta

Compare la dirección introducida con el campo anterior y elija Integration. Abra el repositorio en un navegador. Si el error continúa, guarde el mensaje completo, la dirección y sus versiones de HA y HACS/Marketplace. El mensaje por sí solo no determina la causa.

AmperePoint no aparece después de descargarlo

Reinicie HA y actualice el navegador. Después, busque AmperePoint en Dispositivos y servicios → Añadir integración.

El asistente no detecta el cargador

Compruebe que está conectado en la aplicación y visible en la integración oficial de Tuya en HA. Recargue Tuya si es necesario.

El panel indica configuración no válida o muestra una versión antigua

Realice una recarga completa del navegador y compruebe la versión al pie. Si persiste, envíe el error y la lista de recursos Lovelace con sus tipos. Quitar el sufijo ?v= de la URL de la tarjeta no es una solución permanente.

Faltan lecturas de fases u otros valores

La disponibilidad depende del modelo, firmware y fuente Tuya. Una lectura ausente no significa necesariamente que la instalación haya fallado.

Energía todavía no muestra un gráfico

Compruebe la entidad Charging energy y su registro en Recorder, y espere a que se generen estadísticas.

11. Actualizaciones y otras conexiones

Haga una copia de seguridad de HA antes de actualizar. Descargue la versión nueva mediante HACS o Marketplace, reinicie HA y actualice el panel. Compruebe la versión al pie. Durante una migración, conserve las entradas que funcionan y revise las automatizaciones dependientes antes de eliminarlas.

Tuya Local y Xtend Tuya pueden ser fuentes adicionales para configuraciones existentes o avanzadas. La configuración Q Series anterior solo necesita la integración oficial de Tuya y AmperePoint. El control local se explica en una guía independiente de Tuya Local. Wallbox PRIME utiliza una ruta LAN distinta; consulte la guía de conexión.

Si necesita ayuda, escriba a hello@amperepoint.com. Incluya el modelo, firmware, versiones de HA, integración y HACS/Marketplace, el paso y una captura del error completo. No envíe contraseñas, claves locales ni tokens.

Regresar al blog

Cargadores con medidor de energía

Ver todo