[PLUGIN] 16-channel current monitoring with HDXXAXXA16GK-D

In this subforum you can show projects you have made, or you are busy with. Please create your own topic.

Moderator: leecollings

Post Reply
voyo
Posts: 40
Joined: Monday 17 February 2020 19:16
Target OS: Raspberry Pi / ODroid
Domoticz version: beta
Location: Poland
Contact:

[PLUGIN] 16-channel current monitoring with HDXXAXXA16GK-D

Post by voyo »

Hi everyone!
I've developed a Python plugin to support the HDXXAXXA16GK-D 16-channel current monitoring device from Guangzhou Huidian. This is a professional-grade current/frequency measurement module that's perfect for whole-house energy monitoring or industrial applications.


The HDXXAXXA16GK-D is a DIN-rail mounted device that measures AC current on 16 channels simultaneously with 0.01A resolution and ±1% accuracy at 50Hz. It uses Modbus RTU communication over RS485.
Actually device prime functionality is to measure frequency on circuit (Hz), beside current load (A) - but Im not using this function at all, not needed - we are all expecting to have 50Hz ;)

Core functionality of the plugin
16-channel current monitoring - Real-time measurements with 0.01A resolution
Power calculation - Estimates power consumption using configurable voltage and power factor
Flexible configuration - JSON-based setup for maximum control

Modbus TCP connectivity - Plugin requires TCP proxy/gateway (does not support direct RS485 serial, Im not using it at home anymore, only TCP )
Dynamic or static configuration - Use live voltage/PF from other Domoticz devices (like DDS238 meters) or fixed values
Automatic phase summaries - Built-in L1/L2/L3 phase totals for 3-phase installations
Robust error handling - Auto-reconnection, health monitoring, data validation

Configuration Examples

Static configuration (simple):
json

Code: Select all

[
  {"name": "Washing Machine", "voltage": 230, "pf": 0.75},
  {"name": "Heat Pump", "voltage": 400, "pf": 0.85}
]
Dynamic configuration (advanced):
json

Code: Select all

[
  {"name": "Washing Machine", "voltage_idx": 1317, "pf_idx": 1318},
  {"name": "Heat Pump", "voltage_idx": 1299, "pf_idx": 1320}
]
The dynamic approach reads live voltage and power factor from other Domoticz devices (like DDS238 meters) for higher accuracy and automatic 3-phase detection.

Use Cases
Residential: Whole-house monitoring, appliance-level tracking, solar integration
Commercial: Restaurant kitchens, office buildings, workshops
Industrial: 3-phase equipment monitoring, load balancing

Links
Plugin repository: https://github.com/voyo/Domoticz_HomePowerMonitor
Device manual: http://www.huidkj.com/xiazai/HDXXAXXA16GK-D.pdf

The plugin creates individual current/power devices for each channel plus automatic phase summaries when using dynamic configuration. It's been tested in production and includes comprehensive error handling and logging.

Questions and feedback welcome!

Has anyone else worked with similar multi-channel current monitoring devices? Would love to hear about your experiences or suggestions for improvements.
Attachments
Screenshot_20250903_134944_Brave.jpg
Screenshot_20250903_134944_Brave.jpg (362.3 KiB) Viewed 83 times
HDHK-device.jpg
HDHK-device.jpg (385.99 KiB) Viewed 83 times
circuits.jpg
circuits.jpg (379.54 KiB) Viewed 83 times
Post Reply

Who is online

Users browsing this forum: No registered users and 1 guest