# Fronius Wattpilot Binding
This binding integrates the Fronius Wattpilot EV charging stations (opens new window) through their unofficial WebSocket API, which is also used by the Fronius Solar.Wattpilot app (opens new window).
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
Thing froniuswattpilot:wattpilot:garage "Wattpilot Garage" [hostname="xxx.xxx.xxx.xxx", password="secret"]
# Item Configuration
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"}
Caught a mistake or want to contribute to the documentation? Edit this page on GitHub (opens new window)