Full Home Assistant Integration for Ampere Point Q Series Chargers — Step-by-Step Guide

A step-by-step guide: from installing Home Assistant, through HACS and xtend_tuya, to full charger data, the Energy dashboard and useful automations. Written so that even someone who has never used Home Assistant before can follow it.

Models: Q11, Q22, Q37, Q74  ·  updated: July 2026

Ampere Point Q Series chargers are Wi-Fi chargers built on the Tuya platform. This means they can be connected to Home Assistant, the most popular free smart home system, and used for much more than basic control in a mobile app:

• live monitoring: power, current and voltage for each phase, session energy, total energy and charging status,
• control: start and stop charging, change the current limit,
• automations: charge only during off-peak tariffs, from excess solar production or according to dynamic electricity prices,
• history and consumption statistics in the Energy dashboard, useful for reporting and cost tracking.

The integration works through the Tuya cloud, so both the charger and Home Assistant need internet access.

Table of contents

1. What you need
2. Installing Home Assistant if you do not have it yet
3. Installing HACS
4. Official Tuya integration
5. xtend_tuya add-on for more charger data
6. Full data set with Tuya developer cloud keys
7. What you get after integration and the Energy dashboard
8. Example automations
9. Common problems and fixes
10. Alternative: local control with tuya-local
11. All links in one place

1. What you need

• An Ampere Point Q Series charger added to the Smart Life app for Android or Smart Life app for iPhone and working correctly there.
• A 2.4 GHz Wi-Fi network. Tuya modules do not connect to 5 GHz networks. If your router broadcasts 2.4 GHz and 5 GHz under one network name, it is worth temporarily separating the 2.4 GHz network during pairing.
• A computer or small server for Home Assistant. It should run continuously if you want automations to work all the time. Common choices are Raspberry Pi, a mini PC or a regular Windows computer.
• A free GitHub account, needed once for HACS authorization.
• Your phone with the Smart Life app nearby, because you will scan QR codes during setup.
• About 1 to 2 hours. Most steps are simple guided setup clicks.

2. Installing Home Assistant if you do not have it yet

If Home Assistant is already running for you, go straight to section 3.

Option A: dedicated device, recommended long term

On a Raspberry Pi, mini PC or older laptop, the easiest route is Home Assistant OS. It is a complete system that handles Home Assistant, updates and backups. Official instructions for each platform are available here: home-assistant.io/installation. After installation, the dashboard is usually available in a browser at http://homeassistant.local:8123.

Option B: Windows computer using Docker

This is a good starting point for testing. Home Assistant runs in a container on your normal computer. Remember that automations work only when the computer is turned on and Docker is running.

1. Install WSL2, which Docker needs on Windows. Right-click the Start menu, open Terminal (administrator), enter wsl --install, confirm and restart the computer when it finishes. Microsoft instructions: learn.microsoft.com/pl-pl/windows/wsl/install.
2. Install Docker Desktop: docker.com/products/docker-desktop. During installation, keep the WSL 2 option enabled. After launching Docker Desktop, wait until the status shows that it is running. Creating a Docker account can be skipped.
3. Start Home Assistant. Open Terminal without administrator privileges and paste:

   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

   The first launch downloads about 1.5 GB and usually takes a few minutes.
4. Open http://localhost:8123 in your browser. If it does not load immediately, wait one or two minutes and refresh.

With the Docker option, restart Home Assistant in Docker Desktop: Containers → homeassistant → restart icon. You can also use docker restart homeassistant. The restart button may not appear in the Home Assistant menu in this setup, which is normal. You will need to restart a few times in the next steps.

First launch for both options

The welcome wizard will ask you to create a local account, choose location and set units. Save the username and password in a safe place. You can skip the list of automatically discovered devices at this stage.

3. Installing HACS

HACS, the Home Assistant Community Store, is a community add-on store. We will use it to install xtend_tuya. Official instructions are here: hacs.xyz/docs/use/download/download. Choose the tab that matches your installation.

• Home Assistant OS: add the add-on repository https://github.com/hacs/addons according to the official instructions, install and run the Get HACS add-on, then restart Home Assistant.
• Docker option: run this in Terminal:

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

After the restart, add the integration: Settings → Devices & services → Add integration, search for HACS and accept the terms. Home Assistant will show a code that you need to enter at github.com/login/device after logging into GitHub. Confirm with Authorize. After a moment, HACS will appear in the sidebar.

4. Official Tuya integration

This step connects Home Assistant with your Smart Life account.

1. Go to Settings → Devices & services → Add integration and search for Tuya.
2. The wizard will ask for your User Code. In the Smart Life app, find it under Me → Settings gear → Account and Security → User Code. Enter it exactly. Letter case matters.
3. A QR code will appear on screen. In Smart Life, use the scanner in the top-right corner of the Me tab, scan the code and confirm login on your phone.
4. After a moment, your charger should appear on the device list.

What to expect: the official Tuya integration usually exposes only one entity for the charger, often a charging switch. Full data such as power, currents, voltages, energy and detailed status appears after adding xtend_tuya in the next steps. Missing sensors at this stage are not an error.

5. xtend_tuya add-on for more charger data

xtend_tuya works alongside the official Tuya integration and adds missing entities to the same devices. Project page: github.com/azerty9971/xtend_tuya.

5.1. Download in HACS

1. Open HACS from the sidebar and search for Xtend Tuya. You can also use this direct link: open Xtend Tuya in my Home Assistant.
2. On the add-on page, click Download and confirm.
3. Restart Home Assistant.

Downloading in HACS is only the first half of the process. It copies files to disk, but it does not add the integration yet. Entities appear only after you add the integration in section 5.2. This is the most common misunderstanding in the whole setup: after download, the Download button disappears, the add-on page shows only a description, and the entity count does not grow even after restarts. If this is what you see, everything is fine. Continue with the next step.

5.2. Add the integration

1. Go to Settings → Devices & services → Add integration and search for Xtend Tuya.
2. Enter the same User Code as in section 4 and scan the QR code again with the Smart Life app.
3. After confirming the QR code, a new window called Add Tuya OpenAPI credentials will appear. Read the note below before clicking anything.

The most important tip in this guide. Do not close the Add Tuya OpenAPI credentials window with the X button. Closing it cancels the entire wizard without a clear message. The integration will not be added, even though it may look as if you completed the setup. If you do not yet have Tuya developer cloud keys, which we will get in section 6:

1. check Don't ask for OpenAPI credentials,
2. also choose country Poland and endpoint Europe. The form still requires these fields, and without them it may show an unclear validation error,
3. confirm, then click Finish in the next screen with names and areas.

OpenAPI credentials window, shown as a reference. Check the box, choose country and endpoint, then confirm. Do not close the window with the X button.

After the wizard finishes, the integration list will show Xtend Tuya. Your charger should gain several to more than twenty new entities, including voltage, current, power, energy and status sensors. If the Xtend Tuya entry is missing, the wizard was interrupted. Repeat section 5.2.

6. Full data set with Tuya developer cloud keys

This stage is optional, but recommended. Without it, some entities may be unavailable or update more slowly. We will create a free project on the Tuya developer platform and add its keys to xtend_tuya. The add-on documentation also describes the procedure here: cloud credentials guide.

6.1. Create a Tuya platform project

1. Go to platform.tuya.com and create a free account. You can use the same email address as in Smart Life.
2. Go to Cloud → Development → Create Cloud Project. Enter any project name. For Industry and Development Method, choose Smart Home. For Data Center, choose Central Europe Data Center. The data center must match the region of your Smart Life account. For Poland, this is Central Europe. The free plan allows one data center.
3. In the Authorize API Services window, accept the suggested services.
4. Link the app account: Devices → Link App Account → Add App Account, scan the QR code with Smart Life and confirm. Choose Automatic Link, so new devices can join automatically. After a moment, your charger should appear in the device list.
5. Find your project keys on the Overview tab in the Authorization Key section: Access ID / Client ID and Access Secret / Client Secret. Use the eye icon to reveal the secret.

The Client Secret works like a password for your project. Do not share it and do not paste it into public places. If needed, you can reset it on the Overview tab. After resetting it, update the key in Home Assistant.

6.2. Enable full data points with DP Instruction

By default, the Tuya cloud may expose devices in a simplified mode that hides some data points. To expose the complete set, switch the product to DP Instruction mode: Devices → All Devices → the three-dot button next to View Devices by Product → hover over the product card → pencil icon → check DP Instruction → Save Configuration. The warning shown by the platform applies only to this API project. The Smart Life app and the charger itself keep working as before. Illustrated instructions are available in the xtend_tuya documentation.

6.3. Enter the keys in Home Assistant

1. Go to Settings → Devices & services → Xtend Tuya → Configure. The same OpenAPI credentials window will open.
2. This time, uncheck Don't ask for OpenAPI credentials. Choose country Poland and endpoint Europe, then paste the Access ID and Access Secret from the Tuya project Overview tab. Confirm.
3. Restart Home Assistant and wait one or two minutes. The charger entity count should increase again. If it does not, use Reload from the three-dot menu next to the Xtend Tuya integration.

7. What you get after integration and the Energy dashboard

The exact entity list depends on the charger model, but it typically includes:

Readings	Control
charging status, instant power, current and voltage for phases L1 to L3, current session energy, total energy and error codes	start and stop charging, charging current limit, for example reducing from 16 A to 10 A, and available device modes

It is worth giving the entities clear names under Settings → Devices & services → Entities. If one item, such as a switch, appears twice, once from Tuya and once from xtend_tuya, that is normal. You can simply disable the duplicate entity you do not want to use.

Energy dashboard: go to Settings → Dashboards → Energy. In the Individual devices section, add the charger's total energy entity. After one or two hours, Home Assistant should start drawing daily and monthly consumption charts. More about the Energy dashboard: home-assistant.io/docs/energy.

8. Example automations

Automations are created under Settings → Automations & scenes → Create automation. The examples below can be pasted in YAML edit mode. Replace the entity IDs, such as sensor.… and switch.…, with your own IDs from the Entities tab. Phone notifications require the free Home Assistant Companion app.

Charge only during an off-peak tariff window, 22:00 to 06:00:

alias: Charge during off-peak tariff
trigger:
  - platform: time
    at: "22:00:00"
    id: start
  - platform: time
    at: "06:00:00"
    id: stop
action:
  - choose:
      - conditions: [{ condition: trigger, id: start }]
        sequence:
          - service: switch.turn_on
            target: { entity_id: switch.charger_switch }
      - conditions: [{ condition: trigger, id: stop }]
        sequence:
          - service: switch.turn_off
            target: { entity_id: switch.charger_switch }

Notification when charging ends:

alias: Charging finished
trigger:
  - platform: state
    entity_id: sensor.charger_status
    from: "charging"
    to: "charger_free"
action:
  - service: notify.mobile_app_your_phone
    data:
      title: "Charger"
      message: "Charging has finished."

Charging from excess solar production, if Home Assistant has a sensor for power exported to the grid:

alias: Charge from excess solar
trigger:
  - platform: numeric_state
    entity_id: sensor.grid_export_power
    above: 3000
    for: "00:05:00"
    id: start
  - platform: numeric_state
    entity_id: sensor.grid_export_power
    below: 500
    for: "00:05:00"
    id: stop
action:
  - choose:
      - conditions: [{ condition: trigger, id: start }]
        sequence:
          - service: switch.turn_on
            target: { entity_id: switch.charger_switch }
      - conditions: [{ condition: trigger, id: stop }]
        sequence:
          - service: switch.turn_off
            target: { entity_id: switch.charger_switch }

9. Common problems and fixes

Symptom	What to do
After downloading xtend_tuya in HACS, the entity count does not increase and restarts do not help.	Downloading files is not the same as adding the integration. Check whether Xtend Tuya appears under Settings → Devices & services. If it does not, complete the wizard from section 5.2.
The OpenAPI credentials window was closed with the X button and the integration disappeared.	The wizard was cancelled. Start it again and handle the window as described in section 5.2: checkbox, country, endpoint, then confirm.
The OpenAPI form shows an error such as value must be one of [...].	Even when Don't ask... is checked, you still need to choose country and endpoint. Select Poland and Europe, then confirm.
The logs show sign invalid.	The Access ID or Secret was pasted with a typo or extra space, or the wrong endpoint was selected. Copy the keys again from the project Overview tab. For Poland, the endpoint is Europe.
The logs show permission deny or code 1106.	In your Tuya platform project, check the Service API tab. IoT Core and Authorization services must be active. Use Authorize or Renew if needed.
The integration worked, but after a few months the data stopped updating.	The free IoT Core trial may have expired. On the Tuya platform, go to Cloud → project → IoT Core → Extend Trial. The extension is free. It is worth setting a calendar reminder.
The QR code from the Tuya platform does not work, or app account linking fails.	The Smart Life account and the project are probably in different data centers. Create the project in Central Europe Data Center for accounts used in Poland.
All charger entities are unavailable.	The integration works through the cloud. Check internet access and confirm that the charger is online in Smart Life. When connectivity returns, the entities should recover automatically.
The charger does not connect to Wi-Fi after changing router or password.	Make sure the 2.4 GHz Wi-Fi network is enabled and pair the charger again in Smart Life. It should then appear in Home Assistant automatically.
After a Home Assistant update, Xtend Tuya does not start.	Check HACS for a newer version of the add-on and update it. Custom integrations can be sensitive to major Home Assistant releases. Before updating Home Assistant, it is often worth waiting a few days and checking the project's issue page.
The same switch appears twice.	This is normal when xtend_tuya works alongside the official Tuya integration. Disable the duplicate entity you do not need. Do not remove the integration.
Even after all steps, the device still has only one entity.	Sometimes the Tuya product definition exposes only a limited data set. Contact us at hello@amperepoint.com with your model and a short description of the issue. We will check the product configuration on the cloud side.

10. Alternative: local control with tuya-local

If you want independence from the cloud, so control can work even without internet access, you can use tuya-local instead. It is also installed through HACS. Configuration requires the device's local key and manual data point mapping, so it is more technical and best suited for users who already feel comfortable in Home Assistant. A helpful tool for reading device data is TinyTuya.

11. All links in one place

Summary

After completing this guide, your Ampere Point Q Series charger becomes a full part of your smart home. You can see each charging session, track costs in the Energy dashboard and charge your car when electricity is cheapest or when your solar installation is producing surplus energy.

Home Assistant and Tuya platform screens change from time to time, so some buttons may move or be renamed. The overall order of the steps remains the same.

Stuck on one of the steps? Email us at hello@amperepoint.com or call +48 666 612 044, Monday to Friday, 10:00-17:00. We will be happy to help.

Looking for a charger ready to work with Home Assistant? See our Q Series chargers with energy meters.