PowerTag

External converters and image assets for Schneider Electric PowerTag wireless energy sensors used with Home Assistant and Zigbee2MQTT.

Initial public release of:

• A9MEM1560
• A9MEM1580

1. Repository Layout

PowerTag/
|-- README.md
|-- LICENSE
|-- external_converters/
|   |-- A9MEM1560.mjs
|   `-- A9MEM1580.mjs
`-- assets/
    `-- images/
        |-- zigbee2mqtt_PowerTag.png
        |-- A9MEM1560.png
        `-- A9MEM1580.png

2. Supported Devices

• A9MEM1560 - single-phase PowerTag
• A9MEM1580 - 3-phase PowerTag

Per-device icons included in this repo:

Important matching note:

• These converters currently match conservatively against GreenPower_254 plus a specific IEEE address.
• Before using either converter, replace the placeholder 0x00000000e1234abc with your own device IEEE Address.
• In Zigbee2MQTT, you can usually find this on the device About page under IEEE Address.

On Windows, Ctrl+H is the quickest way to replace the placeholder in Cursor or VS Code.

3. Quick Install

Option A: File-based install

1. Choose the correct converter:
   • external_converters/A9MEM1560.mjs
   • external_converters/A9MEM1580.mjs
2. Open the file and replace 0x00000000e1234abc with your own PowerTag IEEE Address.
3. Copy the converter into Zigbee2MQTT's external_converters folder beside its configuration.yaml.
4. Copy the matching icon into Home Assistant's www/ExternalConverter/ folder if you want the local icon path to work.
5. Restart Zigbee2MQTT.

Example PowerShell commands from the repository root:

Copy-Item ".\external_converters\A9MEM1560.mjs" "C:\path\to\zigbee2mqtt\external_converters\A9MEM1560.mjs"
Copy-Item ".\assets\images\A9MEM1560.png" "C:\path\to\home-assistant\www\ExternalConverter\A9MEM1560.png"

Replace the destination paths with your own paths. If you are installing A9MEM1580, use the matching filenames instead.

Option B: Zigbee2MQTT Dev Console

1. Open Zigbee2MQTT -> Settings -> Dev console -> External Converters.
2. Select Create new converter.
3. Use the filename:
   • A9MEM1560.mjs
   • A9MEM1580.mjs
4. Before saving, replace 0x00000000e1234abc in the code with your own PowerTag IEEE Address.
5. Paste the full converter code and save it.

Useful Windows shortcuts here:

• Ctrl+A to select all converter code
• Ctrl+C to copy
• Ctrl+V to paste
• Ctrl+H to replace the placeholder IEEE value

4. Initial Pairing Notes

• To initially connect the PowerTag to Home Assistant, use an Ikea TRADFRI range extender nearby.
• When you perform Permit join in Home Assistant, make sure only that device is selected and nearby to the PowerTag.
• This matters because it supports the Zigbee Green Power join process used by the PowerTag.

5. Reporting Behavior

• PowerTags typically send updates about every 5 seconds.
• They usually send changed values only rather than a full payload every time.
• It is normal for successive messages to contain only the attributes that changed.

6. Troubleshooting

No data after pairing

• Re-check that the correct converter file was used for the device.
• Re-check that 0x00000000e1234abc was replaced with your own IEEE Address.
• Re-run pairing with the Ikea TRADFRI range extender as the nearby selected device during Permit join.

Data stops even with decent linkquality

• A PowerTag can still stop reporting even when linkquality is above 100.
• If updates stop completely, install a Zigbee repeater closer to the PowerTag.
• The preferred fix is to keep that repeater much closer permanently.

Icon not showing in Home Assistant

• These converters use the local icon paths:
  • /local/ExternalConverter/A9MEM1560.png
  • /local/ExternalConverter/A9MEM1580.png
• Make sure the PNG files are copied into Home Assistant www/ExternalConverter/.

7. Device Notes

A9MEM1560

Notes:

• Model exposed by the converter: A9MEM1560
• Zigbee interviewed model commonly appears as GreenPower_254
• power_factor is exposed, but the current sample below still shows null

Current state example:

{
    "ac_frequency": 50.1,
    "current_phase_a": 0,
    "energy": 0.1,
    "energy_phase_a": 0.1,
    "firmware_version": "004.002.000",
    "linkquality": 120,
    "model_id": "A9MEM1560",
    "power": 0,
    "power_apparent": 0,
    "power_factor": null,
    "power_phase_a": 0,
    "produced_energy": 29.883,
    "produced_energy_phase_a": 29.883,
    "voltage_phase_a": 232.5
}

A9MEM1580

Notes:

• Model exposed by the converter: A9MEM1580
• Zigbee interviewed model commonly appears as GreenPower_254
• At the time of this release, power_factor is not working
• The power_factor value does not appear in the Zigbee payload yet
• This may need another cluster to be explored later, or a custom calculation added to the external converter

Current state example:

{
    "ac_frequency": 50,
    "current_neutral": 6.11,
    "current_phase_a": 0.6,
    "current_phase_b": 1.04,
    "current_phase_c": 6.74,
    "energy": 441.76,
    "energy_phase_a": 182.976,
    "energy_phase_b": 206.783,
    "energy_phase_c": 93.672,
    "firmware_version": "001.003.003",
    "linkquality": 123,
    "model_id": "A9MEM1580",
    "power": 1515,
    "power_apparent": 1922,
    "power_apparent_phase_a": 127,
    "power_apparent_phase_b": 225,
    "power_apparent_phase_c": 1571,
    "power_phase_a": 34,
    "power_phase_b": 110,
    "power_phase_c": 1371,
    "reactive_power": -834,
    "reactive_power_phase_a": -122,
    "reactive_power_phase_b": -196,
    "reactive_power_phase_c": -516,
    "voltage_phase_a": 242.1,
    "voltage_phase_ab": 414.4,
    "voltage_phase_b": 238.8,
    "voltage_phase_bc": 414.9,
    "voltage_phase_c": 233.2,
    "voltage_phase_ca": 407.1,
    "power_factor": null
}