Entities
You can expect these entities, although names will vary based on your home name (here "Home"), installed devices (in this example "aroTHERM plus" and "Hydraulic Station"), or the naming of your heating zones (in this case "Zone 1"):
Sample Entities
| Entity | Unit | Class | Sample |
|---|---|---|---|
| Home Outdoor Temperature | °C | temperature | 10.3 |
| Home System Water Pressure | bar | pressure | 1.8 |
| Home Firmware Version | 0357.40.33 | ||
| Home Zone 1 (Circuit 0) Desired Temperature | °C | temperature | 22.0 |
| Home Zone 1 (Circuit 0) Current Temperature | °C | temperature | 22.4 |
| Home Zone 1 (Circuit 0) Humidity | % | humidity | 41.0 |
| Home Zone 1 (Circuit 0) Heating Operating Mode | Time Controlled | ||
| Home Zone 1 (Circuit 0) Heating State | Idle | ||
| Home Zone 1 (Circuit 0) Current Special Function | None | ||
| Home Circuit 0 State | STANDBY | ||
| Home Circuit 0 Current Flow Temperature | °C | temperature | 21.0 |
| Home Circuit 0 Heating Curve | 1.19 | ||
| Home Domestic Hot Water 0 Tank Temperature | °C | temperature | 48.0 |
| Home Domestic Hot Water 0 Setpoint | °C | temperature | 52.0 |
| Home Domestic Hot Water 0 Operation Mode | Time Controlled | ||
| Home Domestic Hot Water 0 Current Special Function | Regular | ||
| Home Heating Energy Efficiency | 3.6 | ||
| Home Device 0 aroTHERM plus Heating Energy Efficiency | 3.6 | ||
| Home Device 0 aroTHERM plus Consumed Electrical Energy Domestic Hot Water | Wh | energy | 2000.0 |
| Home Device 0 aroTHERM plus Consumed Electrical Energy Heating | Wh | energy | 12000.0 |
| Home Device 0 aroTHERM plus Earned Environment Energy Domestic Hot Water | Wh | energy | 4000.0 |
| Home Device 0 aroTHERM plus Earned Environment Energy Heating | Wh | energy | 33000.0 |
| Home Device 0 aroTHERM plus Heat Generated Heating | Wh | energy | 45000.0 |
| Home Device 0 aroTHERM plus Heat Generated Domestic Hot Water | Wh | energy | 6000.0 |
| Home Device 1 Hydraulic Station Heating Energy Efficiency | unknown | ||
| Home Device 1 Hydraulic Station Consumed Electrical Energy Domestic Hot Water | Wh | energy | 0.0 |
| Home Device 1 Hydraulic Station Consumed Electrical Energy Heating | Wh | energy | 0.0 |
| Home Trouble Codes | problem | off | |
| Home Online Status | connectivity | on | |
| Home Firmware Update Required | update | off | |
| Home Firmware Update Enabled | on | ||
| Home Circuit 0 Cooling Allowed | off | ||
| Home Zone 1 (Circuit 0) Climate | auto | ||
| Home Away Mode Start Date | unknown | ||
| Home Away Mode End Date | unknown | ||
| Home Holiday Duration Remaining | d | 0 | |
| Home Zone 1 (Circuit 0) Quick Veto Duration | h | unavailable | |
| Home Domestic Hot Water 0 | Time Controlled | ||
| Home Zone 1 (Circuit 0) Heating Schedule | on | ||
| Home Domestic Hot Water 0 Schedule | on | ||
| Home Away Mode | off | ||
| Home Domestic Hot Water 0 Boost | off |
Climate Entities
Home Assistant's built-in climate modes differ from Vaillant's. The following table shows the mapping for zones:
| Home Assistant Mode | Home Assistant Preset | Vaillant Mode |
|---|---|---|
| Off | No Preset | Off |
| Auto | No Preset | Time Controlled Mode |
| Auto | Eco Preset | Eco mode |
| Heat / Cool | No Preset | Manual Mode |
| Auto Heat / Cool |
Away Preset | Away Mode |
| Auto Heat / Cool |
Boost Preset | Quick Veto Mode |
| Auto Heat / Cool |
Sleep Preset | Off |
| Home Assistant Mode | Home Assistant Preset | Vaillant Mode |
|---|---|---|
| Off | No Preset | Off |
| Auto | No Preset | Auto Mode |
| Auto | Home Preset | Day Mode |
| Auto | Eco Preset | Night Mode |
Ambisense Room Thermostats
There are separate climate entities for Ambisense room thermostats (only supported on VRC700 controllers):
| Home Assistant Mode | Home Assistant Preset | Vaillant Mode |
|---|---|---|
| Off | No Preset | Off |
| Auto | No Preset | Auto Mode |
| Heat / Cool | No Preset | Manual Mode |
| Auto Heat / Cool |
Boost Preset | Quick Veto Mode |
Calendar Entities
Each zone and water heater has a calendar for changing the heating schedule. Water heaters also have a calendar for the circulation pump.
In each calendar, you can:
- Create new time slots (set a target temperature as the event summary)
- Update existing time slots by changing start time, end time, weekdays, or the target temperature in the event summary
- Delete time slots on a specific weekday
Note
Make sure to select weekly repetition whenever you create, update, or delete events.
Individual events can't be edited, only the whole weekly schedule.
Extra State Attributes
Some entities come with extra state attributes for debugging and advanced usage. Your attributes may be different, depending on your devices.
Home Sensor
continuous_heating_start_setpoint: -26
alternative_point: -21
heating_circuit_bivalence_point: 0
dhw_bivalence_point: -7
automatic_cooling_on_off: false
adaptive_heating_curve: true
dhw_maximum_loading_time: 60
dhw_hysteresis: 3
dhw_flow_setpoint_offset: 25
continuous_heating_room_setpoint: 20
hybrid_control_strategy: BIVALENCE_POINT
max_flow_setpoint_hp_error: 25
dhw_maximum_temperature: 80
maximum_preheating_time: 0
paralell_tank_loading_allowed: false
outdoor_temperature: 8.019531
system_water_pressure: 1.6
outdoor_temperature_average24h: 9.707031
controller_type: VRC720
system_scheme: 8
backup_heater_type: CONDENSING
backup_heater_allowed_for: DHW_AND_HEATING
module_configuration_v_r71: 3
energy_provide_power_cut_behavior: DISABLE_HEATPUMP_AND_BACKUP_HEATER
Control Error Binary Sensor
diagnostic_trouble_codes:
- serial_number:
article_number: '0020260962'
codes: [ ]
- serial_number:
article_number: '0010021118'
codes: [ ]
- serial_number:
article_number: '0010023609'
codes: [ ]
- serial_number:
article_number: '0020260914'
codes: [ ]
Climate Entity
hvac_modes: off, heat_cool, auto
min_temp: 7
max_temp: 35
preset_modes: boost, none, away, sleep
current_temperature: 21.5
temperature: 0
current_humidity: 53
preset_mode: none
time_program_heating:
extra_fields: { }
monday:
- extra_fields: { }
start_time: 420
end_time: 1290
setpoint: 21
tuesday:
- extra_fields: { }
start_time: 420
end_time: 1290
setpoint: 21
wednesday:
- extra_fields: { }
start_time: 420
end_time: 1290
setpoint: 21
thursday:
- extra_fields: { }
start_time: 420
end_time: 1290
setpoint: 21
friday:
- extra_fields: { }
start_time: 420
end_time: 1290
setpoint: 21
saturday:
- extra_fields: { }
start_time: 420
end_time: 1290
setpoint: 21
sunday:
- extra_fields: { }
start_time: 420
end_time: 1290
setpoint: 21
meta_info:
min_slots_per_day: 0
max_slots_per_day: 12
setpoint_required_per_slot: true
quick_veto_start_date_time: null
quick_veto_end_date_time: null
Circuit State Sensor
room_temperature_control_mode: THERMOSTAT_FUNCTION
cooling_flow_temperature_minimum_setpoint: 20
heating_circuit_type: DIRECT_HEATING_CIRCUIT
heating_circuit_flow_setpoint: 0
heating_circuit_flow_setpoint_excess_offset: 0
heat_demand_limited_by_outside_temperature: 19
Domestic Hot Water Entity
min_temp: 35
max_temp: 70
operation_list: Manual, Time Controlled, Off, Cylinder Boost
current_temperature: 44
temperature: 50
target_temp_high: null
target_temp_low: null
operation_mode: Time Controlled
time_program_dhw:
extra_fields: { }
monday:
- extra_fields: { }
start_time: 330
end_time: 1260
tuesday:
- extra_fields: { }
start_time: 330
end_time: 1260
wednesday:
- extra_fields: { }
start_time: 330
end_time: 1260
thursday:
- extra_fields: { }
start_time: 330
end_time: 1260
friday:
- extra_fields: { }
start_time: 330
end_time: 1260
saturday:
- extra_fields: { }
start_time: 450
end_time: 1260
sunday:
- extra_fields: { }
start_time: 450
end_time: 1260
meta_info:
min_slots_per_day: 0
max_slots_per_day: 3
setpoint_required_per_slot: false
time_program_circulation_pump:
extra_fields: { }
monday: [ ]
tuesday: [ ]
wednesday: [ ]
thursday: [ ]
friday: [ ]
saturday: [ ]
sunday: [ ]
meta_info:
min_slots_per_day: 0
max_slots_per_day: 3
setpoint_required_per_slot: false