Updated external content (Jenkins build 2613)
openHAB Build Server
parent
92f4f28329
commit
f52c5b96df
File diff suppressed because one or more lines are too long
|
|
@ -382,7 +382,7 @@ print(str(OpenHAB.getVersion()))
|
|||
| Ping | see [openHAB Ping API](https://www.openhab.org/javadoc/latest/org/openhab/core/model/script/actions/ping) | |
|
||||
| ScriptExecution | see [openHAB ScriptExecution API](https://www.openhab.org/javadoc/latest/org/openhab/core/model/script/actions/scriptexecution) | |
|
||||
| Semantic | see [openHAB Semantic API](https://www.openhab.org/javadoc/latest/org/openhab/core/model/script/actions/semantic) | |
|
||||
| ThingAction | see [openHAB ThingAction API](https://www.openhab.org/javadoc/latest/org/openhab/core/model/script/actions/things) | |
|
||||
| Things | see [openHAB Things API](https://www.openhab.org/javadoc/latest/org/openhab/core/model/script/actions/things) | |
|
||||
| Transformation | see [openHAB Transformation API](https://www.openhab.org/javadoc/latest/org/openhab/core/model/script/actions/transformation) | |
|
||||
| Voice | see [openHAB Voice API](https://www.openhab.org/javadoc/latest/org/openhab/core/model/script/actions/voice) | |
|
||||
| NotificationAction | | e.g. NotificationAction.sendNotification("test@test.org", "Window is open") |
|
||||
|
|
|
|||
|
|
@ -0,0 +1,109 @@
|
|||
---
|
||||
id: froniuswattpilot
|
||||
label: Fronius Wattpilot
|
||||
title: Fronius Wattpilot - Bindings
|
||||
type: binding
|
||||
description: "This binding integrates the [Fronius Wattpilot EV charging stations](https://www.fronius.com/en-gb/uk/solar-energy/installers-partners/products-solutions/residential-energy-solutions/e-mobility-and-photovoltaic-residential/wattpilot-ev-charging-solution-for-homes)"
|
||||
since: 3x
|
||||
install: auto
|
||||
---
|
||||
|
||||
<!-- Attention authors: Do not edit directly. Please add your changes to the appropriate source repository -->
|
||||
|
||||
{% include base.html %}
|
||||
|
||||
# Fronius Wattpilot Binding
|
||||
|
||||
This binding integrates the [Fronius Wattpilot EV charging stations](https://www.fronius.com/en-gb/uk/solar-energy/installers-partners/products-solutions/residential-energy-solutions/e-mobility-and-photovoltaic-residential/wattpilot-ev-charging-solution-for-homes)
|
||||
through their unofficial WebSocket API, which is also used by the [Fronius Solar.Wattpilot app](https://www.fronius.com/en-gb/uk/solar-energy/installers-partners/products-solutions/residential-energy-solutions/e-mobility-and-photovoltaic-residential/wattpilot-ev-charging-solution-for-homes#anc_app).
|
||||
|
||||
It should support all Fronius Wattpilot wallboxes and has been tested with the following models:
|
||||
|
||||
- Fronius Wattpilot Home 11J
|
||||
- Fronius Wattpilot Home 22J
|
||||
|
||||
## Supported Things
|
||||
|
||||
- `wattpilot`: A Fronius Wattpilot wallbox
|
||||
|
||||
## Discovery
|
||||
|
||||
The binding implements auto-discovery of Wattpilot wallboxes through mDNS.
|
||||
|
||||
If the binding discovered a Wattpilot, it is added to the inbox.
|
||||
After adding it from the inbox, you need to configure the password for accessing the Wattpilot.
|
||||
|
||||
## Thing Configuration
|
||||
|
||||
### `wattpilot` Thing Configuration
|
||||
|
||||
| Name | Type | Description | Default | Required | Advanced |
|
||||
|-----------------|---------|---------------------------------------|---------|----------|----------|
|
||||
| hostname | text | Hostname or IP address of the device | N/A | yes | no |
|
||||
| password | text | Password to access the device | N/A | yes | no |
|
||||
|
||||
## Channels
|
||||
|
||||
| Channel | Type | Read/Write | Description |
|
||||
|------------------------------|------------------------|------------|---------------------------------------------------------------------------------------------------------|
|
||||
| control#charging-allowed | Switch | RW | Allow (`ON`) or forbid (`OFF`) charging |
|
||||
| control#charging-mode | String | RW | The mode of charging: `DEFAULT`, `ECO`, `NEXT_TRIP` |
|
||||
| control#charging-current | Number:ElectricCurrent | RW | The current to charge with |
|
||||
| control#pv-surplus-threshold | Number:Power | RW | The PV surplus power at which surplus charging starts |
|
||||
| status#charging-state | String | R | Charging state: `NO_CAR`, `CHARGING`, `READY` or `COMPLETE` |
|
||||
| status#charging-possible | Switch | R | Whether charging is currently possible, e.g. when using ECO mode, too low PV surplus can block charging |
|
||||
| status#single-phase | Switch | R | Whether the wallbox is currently charging single phase only |
|
||||
| metrics#power | Number:Power | R | Total power |
|
||||
| metrics#energy-session | Number:Energy | R | Amount of energy charged in the current/last charging session |
|
||||
| metrics#energy-total | Number:Energy | R | Amount of energy charged in total |
|
||||
| metrics#l1-power | Number:Power | R | Power of phase 1 |
|
||||
| metrics#l2-power | Number:Power | R | Power of phase 2 |
|
||||
| metrics#l3-power | Number:Power | R | Power of phase 3 |
|
||||
| metrics#l1-voltage | Number:Voltage | R | Voltage of phase 1 |
|
||||
| metrics#l2-voltage | Number:Voltage | R | Voltage of phase 2 |
|
||||
| metrics#l3-voltage | Number:Voltage | R | Voltage of phase 3 |
|
||||
| metrics#l1-current | Number:ElectricCurrent | R | Current/amperage of phase 1 |
|
||||
| metrics#l2-current | Number:ElectricCurrent | R | Current/amperage of phase 2 |
|
||||
| metrics#l3-current | Number:ElectricCurrent | R | Current/amperage of phase 3 |
|
||||
|
||||
## Full Example
|
||||
|
||||
### Thing Configuration
|
||||
|
||||
```java
|
||||
Thing froniuswattpilot:wattpilot:garage "Wattpilot Garage" [hostname="xxx.xxx.xxx.xxx", password="secret"]
|
||||
```
|
||||
|
||||
### Item Configuration
|
||||
|
||||
```java
|
||||
Group Wattpilot_Garage "Wattpilot Garage" ["Equipment"]
|
||||
|
||||
// Control
|
||||
Switch Wattpilot_Garage_Charging_Allowed "Charging Allowed" <BatteryLevel> (Wattpilot_Garage) ["Control"] {channel="froniuswattpilot:wattpilot:garage:control#charging-allowed"}
|
||||
String Wattpilot_Garage_Charging_Mode "Charging Mode" <BatteryLevel> (Wattpilot_Garage) ["Control"] {channel="froniuswattpilot:wattpilot:garage:control#charging-mode"}
|
||||
Number:ElectricCurrent Wattpilot_Garage_Charging_Current "Charging Current [%d A]" <Energy> (Wattpilot_Garage) ["Setpoint", "Current"] {channel="froniuswattpilot:wattpilot:garage:control#charging-current", unit="A"}
|
||||
Number:Power Wattpilot_Garage_PV_Surplus_Power_Threshold "PV Surplus Power Threshold [%.1f kW]" <SolarPlant> (Wattpilot_Garage) ["Setpoint", "Power"] {channel="froniuswattpilot:wattpilot:garage:control#pv-surplus-threshold", unit="kW"}
|
||||
|
||||
// Status
|
||||
Switch Wattpilot_Garage_Charging_Possible "Charging Possible" <BatteryLevel> (Wattpilot_Garage) ["Status"] {channel="froniuswattpilot:wattpilot:garage:status#charging-possible"}
|
||||
String Wattpilot_Garage_Charging_State "Charging State" <BatteryLevel> (Wattpilot_Garage) ["Status"] {channel="froniuswattpilot:wattpilot:garage:status#charging-state"}
|
||||
Switch Wattpilot_Garage_Single_Phase_Charging "Single Phase Charging" <BatteryLevel> (Wattpilot_Garage) ["Status"] {channel="froniuswattpilot:wattpilot:garage:status#single-phase"}
|
||||
|
||||
// Metrics total
|
||||
Number:Power Wattpilot_Garage_Total_Power "Total Power [%.2f kW]" <Energy> (Wattpilot_Garage) ["Measurement", "Power"] {channel="froniuswattpilot:wattpilot:garage:metrics#power", unit="kW"}
|
||||
Number:Energy Wattpilot_Garage_Charged_Energy "Charged Energy [%.2f kWh]" <Energy> (Wattpilot_Garage) ["Measurement", "Energy"] {channel="froniuswattpilot:wattpilot:garage:metrics#energy-session", unit="kWh"}
|
||||
Number:Energy Wattpilot_Garage_Total_Charged_Energy "Total Charged Energy [%.0f kWh]" <Energy> (Wattpilot_Garage) ["Measurement", "Energy"] {channel="froniuswattpilot:wattpilot:garage:metrics#energy-total", unit="kWh"}
|
||||
// Metrics phase 1
|
||||
Number:Power Wattpilot_Garage_Phase_1_Power "Phase 1 Power [%.2f kW]" <Energy> (Wattpilot_Garage) ["Measurement", "Power"] {channel="froniuswattpilot:wattpilot:garage:metrics#l1-power", unit="kW"}
|
||||
Number:ElectricPotential Wattpilot_Garage_Phase_1_Voltage "Phase 1 Voltage [%d V]" <Energy> (Wattpilot_Garage) ["Measurement", "Voltage"] {channel="froniuswattpilot:wattpilot:garage:metrics#l1-voltage", unit="V"}
|
||||
Number:ElectricCurrent Wattpilot_Garage_Phase_1_Current "Phase 1 Current [%.1f A]" <Energy> (Wattpilot_Garage) ["Measurement", "Current"] {channel="froniuswattpilot:wattpilot:garage:metrics#l1-current", unit="A"}
|
||||
// Metrics phase 2
|
||||
Number:Power Wattpilot_Garage_Phase_2_Power "Phase 2 Power [%.2f kW]" <Energy> (Wattpilot_Garage) ["Measurement", "Power"] {channel="froniuswattpilot:wattpilot:garage:metrics#l2-power", unit="kW"}
|
||||
Number:ElectricPotential Wattpilot_Garage_Phase_2_Voltage "Phase 2 Voltage [%d V]" <Energy> (Wattpilot_Garage) ["Measurement", "Voltage"] {channel="froniuswattpilot:wattpilot:garage:metrics#l2-voltage", unit="V"}
|
||||
Number:ElectricCurrent Wattpilot_Garage_Phase_2_Current "Phase 2 Current [%.1f A]" <Energy> (Wattpilot_Garage) ["Measurement", "Current"] {channel="froniuswattpilot:wattpilot:garage:metrics#l2-current", unit="A"}
|
||||
// Metrics phase 3
|
||||
Number:Power Wattpilot_Garage_Phase_3_Power "Phase 3 Power [%.2f kW]" <Energy> (Wattpilot_Garage) ["Measurement", "Power"] {channel="froniuswattpilot:wattpilot:garage:metrics#l3-power", unit="kW"}
|
||||
Number:ElectricPotential Wattpilot_Garage_Phase_3_Voltage "Phase 3 Voltage [%d V]" <Energy> (Wattpilot_Garage) ["Measurement", "Voltage"] {channel="froniuswattpilot:wattpilot:garage:metrics#l3-voltage", unit="V"}
|
||||
Number:ElectricCurrent Wattpilot_Garage_Phase_3_Current "Phase 3 Current [%.1f A]" <Energy> (Wattpilot_Garage) ["Measurement", "Current"] {channel="froniuswattpilot:wattpilot:garage:metrics#l3-current", unit="A"}
|
||||
```
|
||||
|
|
@ -0,0 +1,221 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<thing:thing-descriptions bindingId="froniuswattpilot"
|
||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||
xmlns:thing="https://openhab.org/schemas/thing-description/v1.0.0"
|
||||
xsi:schemaLocation="https://openhab.org/schemas/thing-description/v1.0.0 https://openhab.org/schemas/thing-description-1.0.0.xsd">
|
||||
|
||||
<!-- Thing Types -->
|
||||
<thing-type id="wattpilot">
|
||||
<label>Fronius Wattpilot</label>
|
||||
<description>Fronius Wattpilot wallbox</description>
|
||||
<semantic-equipment-tag>EVSE</semantic-equipment-tag>
|
||||
|
||||
<channel-groups>
|
||||
<channel-group id="control" typeId="control"/>
|
||||
<channel-group id="status" typeId="status"/>
|
||||
<channel-group id="metrics" typeId="metrics"/>
|
||||
</channel-groups>
|
||||
|
||||
<properties>
|
||||
<property name="serialNumber"/>
|
||||
<property name="firmwareVersion"/>
|
||||
<property name="thingTypeVersion">1</property>
|
||||
</properties>
|
||||
|
||||
<representation-property>hostname</representation-property>
|
||||
|
||||
<config-description>
|
||||
<parameter name="hostname" type="text" required="true">
|
||||
<context>network-address</context>
|
||||
<label>Hostname</label>
|
||||
<description>Hostname or IP address of the device</description>
|
||||
</parameter>
|
||||
<parameter name="password" type="text" required="true">
|
||||
<context>password</context>
|
||||
<label>Password</label>
|
||||
<description>Password to access the device (the same password as required by the Solar.Wattpilot app)</description>
|
||||
</parameter>
|
||||
</config-description>
|
||||
</thing-type>
|
||||
|
||||
<!-- Channel Group Types -->
|
||||
<channel-group-type id="control">
|
||||
<label>Charging Control</label>
|
||||
<channels>
|
||||
<channel id="charging-allowed" typeId="charging-allowed"/>
|
||||
<channel id="charging-mode" typeId="charging-mode"/>
|
||||
<channel id="charging-current" typeId="charging-current"/>
|
||||
<channel id="pv-surplus-threshold" typeId="pv-surplus-threshold"/>
|
||||
</channels>
|
||||
</channel-group-type>
|
||||
|
||||
<channel-group-type id="status">
|
||||
<label>Charging Status</label>
|
||||
<channels>
|
||||
<channel id="charging-state" typeId="charging-state"/>
|
||||
<channel id="charging-possible" typeId="charging-possible"/>
|
||||
<channel id="single-phase" typeId="charging-single-phase"/>
|
||||
</channels>
|
||||
</channel-group-type>
|
||||
|
||||
<channel-group-type id="metrics">
|
||||
<label>Charging Metrics</label>
|
||||
<channels>
|
||||
<channel id="power" typeId="system.electric-power">
|
||||
<label>Total Power</label>
|
||||
<description>Total charging power</description>
|
||||
</channel>
|
||||
<channel id="energy-session" typeId="system.electric-energy">
|
||||
<label>Charged Energy</label>
|
||||
<description>Energy charged in the current/last session</description>
|
||||
</channel>
|
||||
<channel id="energy-total" typeId="system.electric-energy">
|
||||
<label>Total Charged Energy</label>
|
||||
<description>Energy charged in total</description>
|
||||
</channel>
|
||||
<channel id="l1-power" typeId="system.electric-power">
|
||||
<label>Phase 1 Power</label>
|
||||
<description>Charging power on phase 1</description>
|
||||
</channel>
|
||||
<channel id="l2-power" typeId="system.electric-power">
|
||||
<label>Phase 2 Power</label>
|
||||
<description>Charging power on phase 2</description>
|
||||
</channel>
|
||||
<channel id="l3-power" typeId="system.electric-power">
|
||||
<label>Phase 3 Power</label>
|
||||
<description>Charging power on phase 3</description>
|
||||
</channel>
|
||||
<channel id="l1-voltage" typeId="system.electric-voltage">
|
||||
<label>Phase 1 Voltage</label>
|
||||
<description>Current voltage on phase 1</description>
|
||||
</channel>
|
||||
<channel id="l2-voltage" typeId="system.electric-voltage">
|
||||
<label>Phase 2 Voltage</label>
|
||||
<description>Current voltage on phase 2</description>
|
||||
</channel>
|
||||
<channel id="l3-voltage" typeId="system.electric-voltage">
|
||||
<label>Phase 3 Voltage</label>
|
||||
<description>Current voltage on phase 3</description>
|
||||
</channel>
|
||||
<channel id="l1-current" typeId="system.electric-current">
|
||||
<label>Phase 1 Current</label>
|
||||
<description>Charging current on phase 1</description>
|
||||
</channel>
|
||||
<channel id="l2-current" typeId="system.electric-current">
|
||||
<label>Phase 2 Current</label>
|
||||
<description>Charging current on phase 2</description>
|
||||
</channel>
|
||||
<channel id="l3-current" typeId="system.electric-current">
|
||||
<label>Phase 3 Current</label>
|
||||
<description>Charging current on phase 3</description>
|
||||
</channel>
|
||||
</channels>
|
||||
</channel-group-type>
|
||||
|
||||
<!-- Control Channel Types -->
|
||||
<channel-type id="charging-allowed">
|
||||
<item-type>Switch</item-type>
|
||||
<label>Charging Allowed</label>
|
||||
<description>Allow or forbid charging</description>
|
||||
<category>Battery</category>
|
||||
<tags>
|
||||
<tag>Control</tag>
|
||||
</tags>
|
||||
<state>
|
||||
<options>
|
||||
<option value="ON">Allow charging</option>
|
||||
<option value="OFF">Forbid charging</option>
|
||||
</options>
|
||||
</state>
|
||||
<autoUpdatePolicy>veto</autoUpdatePolicy>
|
||||
</channel-type>
|
||||
<channel-type id="charging-mode">
|
||||
<item-type>String</item-type>
|
||||
<label>Charging Mode</label>
|
||||
<description>The mode of charging</description>
|
||||
<category>Battery</category>
|
||||
<tags>
|
||||
<tag>Control</tag>
|
||||
<tag>Mode</tag>
|
||||
</tags>
|
||||
<state>
|
||||
<options>
|
||||
<option value="DEFAULT">Default</option>
|
||||
<option value="ECO">Eco</option>
|
||||
<option value="NEXT_TRIP">Next Trip</option>
|
||||
</options>
|
||||
</state>
|
||||
<autoUpdatePolicy>veto</autoUpdatePolicy>
|
||||
</channel-type>
|
||||
<channel-type id="charging-current">
|
||||
<item-type>Number:ElectricCurrent</item-type>
|
||||
<label>Charging Current</label>
|
||||
<description>The current to charge with</description>
|
||||
<category>Energy</category>
|
||||
<tags>
|
||||
<tag>Setpoint</tag>
|
||||
<tag>Current</tag>
|
||||
</tags>
|
||||
<state pattern="%d A" min="6" max="32" step="1"/>
|
||||
<autoUpdatePolicy>veto</autoUpdatePolicy>
|
||||
</channel-type>
|
||||
<channel-type id="pv-surplus-threshold">
|
||||
<item-type>Number:Power</item-type>
|
||||
<label>PV Surplus Power Threshold</label>
|
||||
<description>The PV Surplus power at which surplus charging starts</description>
|
||||
<category>SolarPlant</category>
|
||||
<tags>
|
||||
<tag>Setpoint</tag>
|
||||
<tag>Power</tag>
|
||||
</tags>
|
||||
<autoUpdatePolicy>veto</autoUpdatePolicy>
|
||||
</channel-type>
|
||||
<!-- Status Channel Types -->
|
||||
<channel-type id="charging-state">
|
||||
<item-type>String</item-type>
|
||||
<label>Charging State</label>
|
||||
<description>Charging State of the wallbox</description>
|
||||
<category>Battery</category>
|
||||
<tags>
|
||||
<tag>Status</tag>
|
||||
</tags>
|
||||
<state readOnly="true">
|
||||
<options>
|
||||
<option value="NO_CAR">No car connected</option>
|
||||
<option value="CHARGING">Charging</option>
|
||||
<option value="READY">Ready to charge</option>
|
||||
<option value="COMPLETE">Charging completed</option>
|
||||
</options>
|
||||
</state>
|
||||
</channel-type>
|
||||
<channel-type id="charging-possible">
|
||||
<item-type>Switch</item-type>
|
||||
<label>Charging Possible</label>
|
||||
<description>Whether charging is currently possible, e.g. when using ECO mode, too low PV surplus can block charging</description>
|
||||
<category>Battery</category>
|
||||
<tags>
|
||||
<tag>Status</tag>
|
||||
</tags>
|
||||
<state readOnly="true">
|
||||
<options>
|
||||
<option value="ON">Possible</option>
|
||||
<option value="OFF">Not Possible</option>
|
||||
</options>
|
||||
</state>
|
||||
</channel-type>
|
||||
<channel-type id="charging-single-phase">
|
||||
<item-type>Switch</item-type>
|
||||
<label>Single Phase Charging</label>
|
||||
<description>Whether the wallbox is charging single phase only</description>
|
||||
<category>Battery</category>
|
||||
<tags>
|
||||
<tag>Status</tag>
|
||||
</tags>
|
||||
<state readOnly="true">
|
||||
<options>
|
||||
<option value="ON">Single Phase</option>
|
||||
<option value="OFF">Three Phases</option>
|
||||
</options>
|
||||
</state>
|
||||
</channel-type>
|
||||
</thing:thing-descriptions>
|
||||
|
|
@ -7,7 +7,7 @@
|
|||
<bridge-type id="ip">
|
||||
<label>IP Connection</label>
|
||||
<description>This bridge represents the IP connection to the alarm system.</description>
|
||||
<semantic-equipment-tag>NetworkAppliance</semantic-equipment-tag>
|
||||
<semantic-equipment-tag>AlarmSystem</semantic-equipment-tag>
|
||||
|
||||
<channels>
|
||||
<channel id="system_status" typeId="system_status"/>
|
||||
|
|
|
|||
|
|
@ -7,7 +7,7 @@
|
|||
<bridge-type id="serial">
|
||||
<label>Serial Connection</label>
|
||||
<description>This bridge represents the serial connection to the alarm system.</description>
|
||||
<semantic-equipment-tag>NetworkAppliance</semantic-equipment-tag>
|
||||
<semantic-equipment-tag>AlarmSystem</semantic-equipment-tag>
|
||||
|
||||
<channels>
|
||||
<channel id="system_status" typeId="system_status"/>
|
||||
|
|
|
|||
Loading…
Reference in New Issue