This is a plugin for the free open-source Domoticz home automation system that read one or more DDS238 ZN/S energy meters by Modbus connection (RS485 serial connection), providing the following data:
- net active energy and power (imported - exported energy)
- total active energy (imported + exported energy)
- import active energy and power
- export active energy and power
- voltage
- current
- frequency
- power factor
Below the Domoticz panel, using plugin version 1.0 (check below for the newer plugin screenshot):
It's possible to configure:
- Bitrate, by default 9600 bps
- Meter address, for example 1 (only one meter with default slave address) or 11,12 (two devices with address 11 and 12: address should be separated by comma)
- Poll interval, in seconds: in case of a long list of devices, don't use very short poll intervals!
Please note that it's possible to easily connect many DDS238 ZN/S meters to the same RS485 bus, by using a common shielded cable within 2 wires (A and B terminal blocks) to a cheap RS485/USB adaper/converter.
Below the Domoticz panel using plugin version 2.0, with two meters connected to the same bus (Modbus address 3 and 4: meter with address 4 has blank values because not connected):
By default, DDS238 ZN/S meters have slave address=1: when a meter with default address is connected to the RS485 bus, only a device will be created just to permit changing its address. Telemetry from default address meter will not be read!
To change the meter address of a new meter with default address=1, select the Change Address 1 -> 2-247 virtual device, edit the Description field writing ADDR=2 to change the meter address to 2. Address valid range is between 2 and 247.
In case you want to change the address of a meter that already has an address between 2 and 247, select the corresponding Power Factor device, edit the Description field writing ADDR=3 to change the meter address to 3. Address valid range is between 2 and 247.
Then, go to Setup -> Hardware -> DDS238 Plugin and add that address to the end of Meter addresses list. NEVER CHANGE THE Meter addresses SEQUENCE adding new devices in the middle, or you'll mix/loose previous telemetry!!
This plugin can be installed from Python Plugin Manager or Python Plugins Manager which also permit to update plugin easily or automatically.
Alternatively, it's possible to give the following commands from the linux shell:
cd ~/domoticz/plugins
git clone https://github.com/CreasolTech/domoticz-dds238
Then, in the future, to update the plugin it's possible to simply type
cd ~/domoticz/plugins/domoticz-dds238
git pull
It uses the python plugin module minimalmodbus , than can be installed by
sudo apt install pyserial
sudo pip3 install minimalmodbus
Restart Domoticz, then go to Setup -> Hardware and add the DDS238 plugin, specifying a name for that hardware and the serial port.
PLEASE NOTE THAT UPDATING THE PLUGIN from version 1.x, NEW DEVICES WILL BE CREATED because the plugin has been rewritten to use the DomoticzEx class instead of the old legacy Domoticz class: to recover data from the old ones, select old devices one-by-one (in the Utility panel), click on Replace button and select the name of the newly created device! In this way you do not loose the history.
Plugin can be easily translate in other languages: just copy and translate the rows below, and open an issue on github writing the modified lines with your translations, with the language code.
Words to translate in other languages (in double quotes):
English (en) Italian (it) YourLanguage (??)
"Power/Energy total" "Potenza/Energia totale" ""
"Power/Energy imported" "Potenza/Energia importata" ""
"Power/Energy exported" "Potenza/Energia esportata" ""
"Voltage" "Tensione" ""
"Current" "Corrente" ""
"Frequency" "Frequenza" ""
"Power Factor" "Fattore di Potenza" ""
"Power/Energy net" "Potenza/Energia netta" ""
| Register(s) | Meaning | Scale Unit | Data format | R/W |
|---|---|---|---|---|
| 0000h-0001h | total energy | 1/100 kWh | unsigned dword | R¹ |
| 0002h-0003h | reserved | unsigned dword | ||
| 0004h-0005h | reserved | unsigned dword | ||
| 0006h-0007h | reserved | unsigned dword | ||
| 0008h-0009h | export energy | 1/100 kWh | unsigned dword | R¹ |
| 000Ah-000Bh | import energy | 1/100 kWh | unsigned dword | R¹ |
| 000Ch | voltage | 1/10 V | unsigned word | R |
| 000Dh | current | 1/100 A | unsigned word | R |
| 000Eh | active power | 1 W | signed word | R |
| 000Fh | reactive power | 1 VAr | unsigned word | R |
| 0010h | power factor | 1/1000 | unsigned word | R |
| 0011h | frequency | 1/100 Hz | unsigned word | R |
| 0012h | reserved | unsigned word | ||
| 0013h | reserved | unsigned word | ||
| 0014h | reserved | unsigned word | ||
| 0015h:high | station address | 1-247 | unsigned char | R/W |
| 0015h:low | baud rate | 1-4² | unsigned char | R/W |
| 001Ah | relay³ | unsigned word | R/W |
Total, export and import energy counters can erased writing 0 in total energy registers.
Value mapping, default 1.
| Value | Baud rate |
|---|---|
| 1 | 9600 Bd |
| 2 | 4800 Bd |
| 3 | 2400 Bd |
| 4 | 1200 Bd |
In DDS238-2 ZN/SR model the relay can be switched by 0x001A register.
| Value | Relay |
|---|---|
| 0 | Off |
| 1 | On |
| Data format | Lenght | Byte order |
|---|---|---|
| char | 8 bits | |
| word | 16 bits | Big endian |
| dword | 32 bits | Big endian |
The meter does not understand the 'write sigle register' function code (06h), only the 'write multiple registers' function code (10h).
Many thanks to:
- Fernando Herrero, where I found the DDS238 information above. https://gist.github.com/alphp
Below a list of modules, produced in Europe by Creasol, designed for Domoticz to be reliable and optimized for very very low power consumption.
Our industrial and home automation modules are designed to be
- very low power (around 10mW with relays OFF)
- reliable (no disconnections)
- bus connected (no radiofrequency interference, no battery to replace).
Modules are available in two version:
- with DomBus proprietary protocol, working with Domoticz only
- with Modbus standard protocol, working with Home Assistant, OpenHAB, Node-RED
Store website - Information website
- Single-phase and three-phases, up to 36A (8kW or 22kW)
- Needs external contactor, RCCB (protection) and EV cable
- Optional power meter to measure charging power, energy, voltage and power factor
- Optional power meter to measure the power usage from the grid (not needed if already exists)
- Two max grid power thresholds can be programmed: for example, in Italy who have 6kW contractual power can drain from the grid Max (6* 1.27)=7.6kW for max 90 minutes followed by (6* 1.1)=6.6kW for another 90 minutes. The module can use ALL available power when programmed to charge at 100%.
- Works without the domotic controller (stand-alone mode), and can also work with charging current set by the domotic controller (managed mode)
DomBusTH - Compact board to be placed on a blank cover, with temperature and humidity sensor and RGW LEDs
Includes:
- temperature and relative humidity sensor
- red, green and white LEDs
- 4 I/Os configurable as analog or digital inputs, pushbuttons, counters (water, gas, S0 energy, ...), NTC temperature and ultrasonic distance sensors
- 2 ports are configured by default as open-drain output and can drive up to 200mA led strip (with dimming function) or can be connected to the external module DomRelay2 to control 2 relays; they can also be configured as analog/digital inputs, pushbuttons and distance sensors.
- analog/digital inputs
- pushbutton and UP/DOWN pushbutton
- counters (water, gas, S0 energy, ...)
- NTC temperature and ultrasonic distance sensors
- 2 ports are configured by default as open-drain output and can drive up to 200mA led strip (with dimming function) or can be connected to the external module DomRelay2 to control 2 relays.
- 2x relays SPST 5A
- 1x 10A 30V mosfet (led stripe dimming)
- 2x 0-10V analog output: each one can be configured as open-drain output to control external relay
- 2x I/O lines, configurable as analog/digital inputs, temperature/distance sensor, counter, ...
- 2x low voltage AC/DC opto-isolated inputs, 9-40V
- 1x 230V AC opto-isolated input
- 6x relays SPST 5A
- 2x relays STDT 10A
- Only 10mW power consumption with all relays OFF
- Only 500mW power consumption with all 8 relays ON !!
- 3x relays SPST 5A
- 3x 115/230Vac optoisolated inputs
- Single common for relays and AC inputs
- 5x general purpose I/O, each one configurable as analog/digital inputs, pushbutton, counter, temperature and distance sensor.
- 3x relays SPST 5A
- 3x 115/230Vac optoisolated inputs
- Single common for relays and AC inputs
- 5x general purpose I/O, each one configurable as analog/digital inputs, pushbutton, counter, temperature and distance sensor.
Each relay can toggle the existing step-relay, switching the light On/Off. The optoisolator monitors the light status. The 5 I/Os can be connected to pushbuttons to activate or deactivate one or all lights.
- 12x relays SPST 5A
- Relays are grouped in 3 blocks, with a single common per block, for easier wiring
- Only 12mW power consumption with all relays OFF
- Only 750mW power consumption with all 12 relays ON !!
- 12x low voltage inputs (analog/digital inputs, buttons, alarm sensors, counters, temperature and distance sensors, ...)
- 3x 115/230Vac optoisolated inputs
- 2x relays SPST 5A
- 1x relay SPST 10A
- In12 port can be used to send power supply to an external siren, monitoring current consumption
- 2x 5A 12V SPST relays (Normally Open contact)
- Overvoltage protection (for inductive loads, like motors)
- Overcurrent protection (for capacitive laods, like AC/DC power supply, LED bulbs, ...)
- 9-24V input voltage, with high efficiency DC/DC regulator with 5V output
- 4x SPST relays 5V with overvoltage protection
- 1x SSR output (max 40V output)
- 2x mosfet output (max 30V, 10A) for LED dimming or other DC loads
- 1x I²C interface for sensors, extended I/Os and more)
- 1x OneWire interface (DS18B20 or other 1wire sensors/devices)