Climate are representations of KNX HVAC/Climate controls.
xknxis the XKNX object.
nameis the name of the object.
group_address_temperatureKNX address of current room temperature. DPT 9.001
group_address_target_temperatureKNX address for setting the target temperature if setpoint shift is not supported. DPT 9.001
group_address_target_temperature_stateKNX address for reading the target temperature from the KNX bus. Used in for setpoint_shift calculations as base temperature. DPT 9.001
group_address_setpoint_shiftKNX address to set setpoint_shift (base temperature deviation). DPT 6.010 or DPT 9.002
group_address_setpoint_shift_stateKNX address to read current setpoint_shift. DPT 6.010 or DPT 9.002
setpoint_shift_modeSetpointShiftMode Enum for setpoint_shift payload encoding. When
Noneit is inferred from first incoming payload. Default:
setpoint_shift_maxMaximum value for setpoint_shift.
setpoint_shift_minMinimum value for setpoint_shift.
temperature_stepSet the multiplier for setpoint_shift calculations when DPT 6.010 is used.
group_address_on_offKNX address for turning climate device on or off. DPT 1
group_address_on_off_stateKNX address for reading the on/off state. DPT 1
on_off_invertInvert on/off. Default:
group_address_active_stateKNX address for reading if the climate device is currently active. DPT 1
group_address_command_value_stateKNX address for reading the current command value / valve position in %. DPT 5.001
sync_statedefines if and how often the value should be actively read from the bus. If
Falseno GroupValueRead telegrams will be sent to its group address. Defaults to
max_tempMaximum value for target temperature.
min_tempMinimum value for target temperature.
modeClimateMode instance for this climate device
group_address_operation_modeKNX address for operation mode. DPT 20.102
group_address_operation_mode_stateKNX address for operation mode status. DPT 20.102
group_address_operation_mode_protectionKNX address for switching on/off frost/heat protection mode. DPT 1
group_address_operation_mode_nightKNX address for switching on/off night nmode. DPT 1
group_address_operation_mode_comfortKNX address for switching on/off comfort mode. DPT 1
group_address_operation_mode_standbyKNX address for switching on/off standby mode. DPT 1
group_address_controller_statusKNX address for controller status.
group_address_controller_status_stateKNX address for controller status state.
group_address_controller_modeKNX address for controller mode. DPT 20.105
group_address_controller_mode_stateKNX address for controller mode status. DPT 20.105
group_address_heat_coolKNX address for switching heating / cooling mode. DPT 1
group_address_heat_cool_stateKNX address for reading heating / cooling mode. DPT 1
operation_modesOverrides the supported operation modes.
controller_modesOverrides the supported controller modes.
device_updated_cbawaitable callback for each update.
group_address_operation_mode_standby are not necessary if
group_address_operation_mode was specified. When one of these is set
True, the others will be set
False. When one of these is set
Night will be set as supported. If
group_address_operation_mode_standby is omitted,
Standby is set when the other 3 are set to
False. If only a subset of operation modes shall be used a list of supported modes may be passed to
climate_mode = ClimateMode(xknx, 'TestClimateMode', group_address_operation_mode='', group_address_operation_mode_state='', group_address_operation_mode_protection=None, group_address_operation_mode_night=None, group_address_operation_mode_comfort=None, group_address_controller_status=None, group_address_controller_status_state=None, group_address_controller_mode=None, group_address_controller_mode_state=None, operation_modes=None, controller_modes=None, device_updated_cb=None) climate = Climate( xknx, 'TestClimate', group_address_temperature='', group_address_target_temperature='', group_address_target_temperature_state='', group_address_setpoint_shift='', group_address_setpoint_shift_state='', temperature_step=0.1, setpoint_shift_max=6, setpoint_shift_min=-6, group_address_on_off='', group_address_on_off_state='', on_off_invert=False, min_temp=18, max_temp=26, mode=climate_mode, device_updated_cb=None) # Set target temperature to 23 degrees. Works with setpoint_shift too. await climate.set_target_temperature(23) # Set new setpoint shift value. await climate.set_setpoint_shift(1) # Reading climate device await climate.sync(wait_for_result=True) print("Current temperature: ", climate.temperature) # Shutdown the Climate and the underlying ClimateMode! climate.shutdown()
climate_setpoint_shift = Climate( xknx, 'TestClimateSPS', group_address_temperature='1/2/2', group_address_target_temperature_state='1/2/5', group_address_setpoint_shift='1/2/3', group_address_setpoint_shift_state='1/2/4' ) climate_target_temp = Climate( xknx, 'TestClimateTT', group_address_temperature='2/2/2', group_address_target_temperature='2/2/3', group_address_target_temperature_state='2/2/4' )