openhab-addons/bundles/org.openhab.binding.smaenergymeter/README.md
Łukasz Dywicki 3c0eb946f1
[smaenergymeter] Fix handling of broadcast frames (#11718)
* Fix handling of broadcast frames for SMA meter #11497.

Added support for multiple meters in single multicast group #3429.

Signed-off-by: Łukasz Dywicki <luke@code-house.org>
Co-authored-by: Leo Siepel <leosiepel@gmail.com>
2024-05-10 17:25:48 +02:00

56 lines
2.1 KiB
Markdown

# SMA Energy Meter Binding
This Binding is used to display the measured values of a SMA Energy Meter device.
It shows purchased and grid feed-in power and energy.
## Supported Things
This Binding supports SMA Energy Meter devices.
## Discovery
The Energy Meter is discovered by receiving data on the default multicast IP address.
## Binding Configuration
No binding configuration required.
## Thing Configuration
Usually no manual configuration is required, as the multicast IP address and the port remain on their factory set values.
Optionally, a refresh interval (in seconds) can be defined.
| Parameter | Name | Description | Required | Default |
|------------------|-----------------|---------------------------------------|----------|-----------------|
| `serialNumber` | Serial number | Serial number of a meter. | yes | |
| `mcastGroup` | Multicast Group | Multicast group used by meter. | yes | 239.12.255.254 |
| `port` | Port | Port number used by meter. | no | 9522 |
| `pollingPeriod` | Polling Period | Polling period used to readout meter. | no | 30 |
The polling period parameter is used to trigger readout of meter. In case if two consecutive readout attempts fail thing will report offline status.
## Channels
| Channel | Description |
|-------------|------------------------|
| powerIn | Purchased power |
| powerInL1 | Purchased power L3 |
| powerInL2 | Purchased power L2 |
| powerInL3 | Purchased power L3 |
| powerOut | Grid feed-in power |
| powerOutL1 | Grid feed-in power L1 |
| powerOutL2 | Grid feed-in power L2 |
| powerOutL3 | Grid feed-in power L3 |
| energyIn | Purchased energy |
| energyInL1 | Purchased energy L1 |
| energyInL2 | Purchased energy L2 |
| energyInL3 | Purchased energy L3 |
| energyOut | Grid feed-in energy |
| energyOutL1 | Grid feed-in energy L1 |
| energyOutL2 | Grid feed-in energy L2 |
| energyOutL3 | Grid feed-in energy L3 |
## Full example
N/A