DTU W100 Home Assistant Configuration

Hello, I made this step-by-step guide to configuring DTU Hoimiles, I hope it helps.

This step-by-step guide works for all DTUs; in my case, it was the W100 Gen 2 DTU, just follow the steps.

Let’s go through the steps.

  1. Configure your MQTT if it’s not already configured, or install it if you don’t have it. Mine looked like this:

MQTT
http://homeassistant.local:8123/hassio/addon/core_mosquitto/info In the lower corner, Add-ons Store

Install it and go to settings.

Click the 3 dots in the upper corner Edit with yaml `

logins:

- username: Vinicius #Create your chosen username
password: 12345 # Create a password require_certificate: false
certfile: fullchain.pem
keyfile: privkey.pem
customize:

active: false
folder: mosquitto

Save this because we will need it.

In the graphical interface, the ports used by MQTT must be open in the Firewall, and I opened them in the Router as UTP TCP. I opened inbound and outbound ports 1883, 1884, 8883, 8884 so that MQTT can communicate with the programs.

Save and start MQTT.

  1. Install the Hoymiles DTU Solar: Home Assistant Add-on. There are two, one stable and one unstable.

I installed both.

Installing the Hoymiles DTU Solar: Home Assistant Add-on

Follow the step-by-step instructions in the documentation on how to install it or use the Android app Fing. After installing, go to settings >
Log in to your DTU W100 and get the IP address it is operating from >

Now set a password, as the default is admin - admin.
Suppose the password is admin password 123456
![Screenshot 2024-11-1password7 Image of a 105836|690x422

To find out the default port, do not change 10081

Hoymiles DTU Solar Adjustment: Home Assistant Add-on
Configurações.yaml in the 3 dots at the top

dtu:

host: 192.168.100.? #IP of your W100 DTU

port: 10081 # Port always open, port 10081
username: admin #Username you set on the DTU
password: 123456 #Username you set on the DTU
app: {}
app_mode_active: {}
app_mode_passive: {}
mqtt:

broker: 192.168.100.? # MQTT IP is the same as your Home Assistant

port: 1883
username: Vinicius # Name you chose in MQTT
password: 12345 # Password you chose in your MQTT

MQTT IP is the same as your HA uses EX> http://< Your IP>l:8123/

Repeat the steps installing the same add-on because one version is stable and the other is not, and I don’t know which one is working because one programmer stopped and another continued. It won’t cause a conflict, it will just be another useless addition to your HA. It’s just that one works and the other doesn’t. >
Repeat the steps above in settings and just copy and paste the configuration.yml file.

Now let’s move on to the second program.
I installed both as well because it’s the same thing with the first one, one is stable and the other doesn’t work. >
Install [hoymiles/stable at master · dmslabsbr/hoymiles · GitHub]

Screenshot 2024-11-171111111 111556|690x373

Go to settings >>>
3 top dots on how to edit settings.yml

Setings:
HOYMILES_USER: Viniciusmbs # Username used to log in to your plant
HOYMILES_PASSWORD: 12345 # Username used to log in to your plant
HOYMILES_PLANT_ID: "67??" # Final ID of your plant
Read_meter_data: true
External_MQTT_Server: true
MQTT_Host: 192.168.100.??? # Your MQTT IP address is the same as your Home Assistant IP address
MQTT_User: vinicius # Username created for your MQTT
MQTT_Pass: 123456 # Password created for your MQTT
MQTT_TLS: false
MQTT_TLS_PORT: "8883"
DEVELOPERS_MODE: false
LOG_LEVEL: INFO
LOG_TO_FILE: false
FILE_PATH: hoymiles.log

Your plant number and password are located at https://global.hoymiles.com/platform/home
The plant number is at
https://global.hoymiles.com/platform/station/view/detail?id=???? << Plant number

HOYMILES_USER: Viniciusmbs # Username used to log in. on your plant HOYMILES_PASSWORD: 12345 # Username used to log in to your plant
HOYMILES_PLANT_ID: “67??” # Final ID of your plant

Save and start the add-on.

Follow the same steps with the same add-on as the first one; copy and paste the configuration.yaml from the first one, but in this documentation:

!

To access the data:
Go to http://homeassistant.local:8123/config/integrations/integration/mqtt

http://homeassistant.local:8123/config/devices/device/187ea61d0800ff1237c5fdfbaa204453

There you will find the sensors; just create your card. I used this card.

If you did this, you

If you want to see more:

Does this work for Duracell in the USA, which is just rebranded Hoymiles ?

Yes — it works if the Duracell unit is actually a rebranded Hoymiles DTU (such as W100 / WLite / Pro series) and exposes the same local API (port 10081).

What really matters is not the brand name, but:

  1. The internal hardware must be Hoymiles.
  2. The firmware must allow local access.
  3. Port 10081 must be open and accessible.
  4. You must be able to log in locally via browser (usually admin/admin or your custom password).

If the Duracell device:

  • Has the same web interface as a Hoymiles DTU
  • Uses port 10081
  • Allows local login

Then it should work with:

  • Home Assistant
  • Hoymiles DTU Solar: Home Assistant Add-on
  • hoymiles

However, if Duracell modified the firmware and:

  • Blocked local API access
  • Changed authentication
  • Removed compatibility

Then it may not work.

To confirm, please check:

  • The exact DTU model shown in the web interface
  • If local login via IP address and port 10081 works

If you can share the exact model, I can confirm more precisely.

Here is the hardware for my setup.

I was unable to login via IP:Port, due to that I had to go down the rabbit hole of learning MODBUS/TCP and that was a pain. Now I understand it but still not a pro by no means.