Skip to content

HomeAssistant integration for EcoStruxure gateways; SmartLink, PowerTag Link and Panel Servers.

License

Notifications You must be signed in to change notification settings

Breina/PowerTagGateway

Repository files navigation

EcoStruxure PowerTag Link Gateway

hacs_badge GitHub Actions Workflow Status GitHub Actions Workflow Status

An integration to fully integrate Schneider's PowerTag ecosystem into Home Assistant. This will enable monitor electric circuits in great detail.

Features

  • Current: per phase and rated current
  • Voltage: per phase, total and rated voltage
  • Power: active, apparent and power factor
  • Energy: partial (resettable) and total
  • Demand: active power, maximum active power (resettable) and timestamp of maximum active power
  • Environment: Temperature, humidity and CO2
  • Alarm: current state and its reasons
  • Diagnostics: gateway status, LQI, RSSI, packet loss, connectivity status

Overview of a PowerTag device Example of a specific sensor

Compatibility

Gateways

  • A9XMWA20: Acti 9 Smartlink SI D
  • A9XMWD20: Acti9 PowerTag Link
  • A9XMWD100: Acti9 PowerTag Link HD
  • PAS400: EcoStruxure Panel Server - entry - 110-277 VAC/DC
  • PAS600: EcoStruxure Panel Server - universal - 110-277 VAC/DC
  • PAS600L: EcoStruxure Panel Server - universal - 24 VDC
  • PAS800: EcoStruxure Panel Server - advanced datalogger - 110-277 VAC/DC
  • PAS800L: EcoStruxure Panel Server - advanced datalogger - 24 VDC
  • PAS800P: EcoStruxure Panel Server - advanced datalogger - PEO

Wireless Devices

  • All PowerTags
  • Acti9 Active
  • All environment sensors (not HeatTag)

Further integrations

If there's something you're missing, please create a GitHub issue.

Installation

Preparation

It is assumed that you have configured your gateway and all of its powertags.

A hard requirement for this integration to work is the modbus TCP service to be enabled, which it is by default. To check whether this is the case, open the device's configuration webpage through navigating to its IP address in your web browser.

Check that the MODBUS TCP service is enabled. Its port is set to 502 by default, if you diverge from this, please keep your port number in mind for later.

To make your life easier later, it's also recommended to enable the DISCOVERY service, its port doesn't matter.

PowerTag Link

  1. Navigate to SETTINGS > IP NETWORK SERVICES
  2. Enable Modbus TCP
  3. Optional: Enable Discovery
  4. Save

The IP services configuration

The IP services configuration

SmartLink

Follow the same steps as for PowerTag Link.

Important

In addition, SmartLink users need to configure the modbus addresses of their wireless devices from 150 upwards to 169 without skipping one.

Panel Server

  1. Navigate to Settings > Network communication > Services
  2. Enable Modbus TCP/IP
  3. Save > Save
  4. Optional: activate discovery
    1. Navigate to Settings > Network communication > Ethernet
    2. Under Switched port settings, disable IPv6 activation. The library perform DPWS discovery does not currently support IPv6. If you need this, you can not use discovery and will need to enter the device's IP address manually. GitHub issue
    3. Save > Save & apply configuration
    4. Navigate to Settings > Network communication > DPWS
    5. Enable DPWS Activation
    6. Save > Save

The modbus service configuration

The modbus service configuration

The DPWS service configuration

The DPWS service configuration

Installation

HACS

Note

This integration requires HACS to be installed

  1. Open HACS
  2. + EXPLORE & DOWNLOAD REPOSITORIES
  3. Find EcoStruxure PowerTag Link Gateway in this list
  4. DOWNLOAD THIS REPOSITORY WITH HACS
  5. DOWNLOAD
  6. Restart Home Assistant (Settings > System > RESTART)

Integration

  1. Navigate to the integrations page: Settings > Devices & Services
  2. + ADD INTEGRATION
  3. Select PowerTag Link Gateway in this selection window
  4. Search the network? If the DISCOVERY service is enabled, the Discover automatically option can be checked. Otherwise, move on to the next step.
    1. If the discovery was successful, the next step will present you with the gateways which were discovered. Select one or choose to set the host address manually.
  5. Enter the host address (without http://) and the modbus TCP port (default 502) of your gateway.
  6. If successful, you can now select to which areas the new devices belong. All entities are now created.

Adding to the energy dashboard

Monitor individual devices

  1. Navigate to the energy configuration page: Settings > Dashboards > Energy
  2. Depending on where you added your PowerTags, press ADD DEVICE or ADD_SOLAR_PRODUCTION.
  3. Select the PowerTag entity you want to add (ends with 'total energy')
  4. SAVE