import logging from esphome.core import CORE, Define import esphome.config_validation as cv import esphome.codegen as cg from esphome.components import climate, uart, sensor, binary_sensor, text_sensor from esphome import automation from esphome.automation import maybe_simple_id from esphome.const import ( CONF_CUSTOM_FAN_MODES, CONF_CUSTOM_PRESETS, CONF_DATA, CONF_ID, CONF_INTERNAL, CONF_OPTIMISTIC, CONF_PERIOD, CONF_POSITION, CONF_SUPPORTED_MODES, CONF_SUPPORTED_SWING_MODES, CONF_SUPPORTED_PRESETS, CONF_TIMEOUT, CONF_UART_ID, UNIT_CELSIUS, UNIT_PERCENT, ICON_POWER, ICON_THERMOMETER, DEVICE_CLASS_TEMPERATURE, DEVICE_CLASS_POWER_FACTOR, STATE_CLASS_MEASUREMENT, __version__ ) from esphome.components.climate import ( ClimateMode, ClimatePreset, ClimateSwingMode, ) AUX_AC_FIRMWARE_VERSION = '0.3.1' AC_PACKET_TIMEOUT_MIN = 150 AC_PACKET_TIMEOUT_MAX = 600 AC_POWER_LIMIT_MIN = 30 AC_POWER_LIMIT_MAX = 100 _LOGGER = logging.getLogger(__name__) CODEOWNERS = ["@GrKoR"] DEPENDENCIES = ["climate", "uart"] AUTO_LOAD = ["sensor", "binary_sensor", "text_sensor"] CONF_SHOW_ACTION = "show_action" CONF_INDOOR_TEMPERATURE = "indoor_temperature" CONF_OUTDOOR_TEMPERATURE = "outdoor_temperature" ICON_OUTDOOR_TEMPERATURE = "mdi:home-thermometer-outline" CONF_INBOUND_TEMPERATURE = "inbound_temperature" ICON_INBOUND_TEMPERATURE = "mdi:thermometer-plus" CONF_OUTBOUND_TEMPERATURE = "outbound_temperature" ICON_OUTBOUND_TEMPERATURE = "mdi:thermometer-minus" CONF_COMPRESSOR_TEMPERATURE = "compressor_temperature" ICON_COMPRESSOR_TEMPERATURE = "mdi:thermometer-lines" CONF_DISPLAY_STATE = "display_state" CONF_INVERTER_POWER = "inverter_power" CONF_INVERTER_POWER_DEPRICATED = "invertor_power" CONF_DEFROST_STATE = "defrost_state" ICON_DEFROST = "mdi:snowflake-melt" CONF_DISPLAY_INVERTED = "display_inverted" ICON_DISPLAY = "mdi:clock-digital" CONF_PRESET_REPORTER = "preset_reporter" ICON_PRESET_REPORTER = "mdi:format-list-group" CONF_VLOUVER_STATE = "vlouver_state" ICON_VLOUVER_STATE = "mdi:compare-vertical" CONF_LIMIT = "limit" CONF_INVERTER_POWER_LIMIT_VALUE = "inverter_power_limit_value" ICON_INVERTER_POWER_LIMIT_VALUE = "mdi:meter-electric-outline" CONF_INVERTER_POWER_LIMIT_STATE = "inverter_power_limit_state" ICON_INVERTER_POWER_LIMIT_STATE = "mdi:meter-electric-outline" aux_ac_ns = cg.esphome_ns.namespace("aux_ac") AirCon = aux_ac_ns.class_("AirCon", climate.Climate, cg.Component) Capabilities = aux_ac_ns.namespace("Constants") # Display actions AirConDisplayOffAction = aux_ac_ns.class_("AirConDisplayOffAction", automation.Action) AirConDisplayOnAction = aux_ac_ns.class_("AirConDisplayOnAction", automation.Action) # test packet action AirConSendTestPacketAction = aux_ac_ns.class_( "AirConSendTestPacketAction", automation.Action ) # vertical louvers actions AirConVLouverSwingAction = aux_ac_ns.class_( "AirConVLouverSwingAction", automation.Action ) AirConVLouverStopAction = aux_ac_ns.class_("AirConVLouverStopAction", automation.Action) AirConVLouverTopAction = aux_ac_ns.class_("AirConVLouverTopAction", automation.Action) AirConVLouverMiddleAboveAction = aux_ac_ns.class_( "AirConVLouverMiddleAboveAction", automation.Action ) AirConVLouverMiddleAction = aux_ac_ns.class_( "AirConVLouverMiddleAction", automation.Action ) AirConVLouverMiddleBelowAction = aux_ac_ns.class_( "AirConVLouverMiddleBelowAction", automation.Action ) AirConVLouverBottomAction = aux_ac_ns.class_( "AirConVLouverBottomAction", automation.Action ) AirConVLouverSetAction = aux_ac_ns.class_( "AirConVLouverSetAction", automation.Action ) # power limitation actions AirConPowerLimitationOffAction = aux_ac_ns.class_( "AirConPowerLimitationOffAction", automation.Action ) AirConPowerLimitationOnAction = aux_ac_ns.class_( "AirConPowerLimitationOnAction", automation.Action ) def use_new_api(): esphome_current_version = tuple(map(int, __version__.split('.'))) esphome_bc_version = tuple(map(int, "2025.11.0".split('.'))) return esphome_current_version >= esphome_bc_version def validate_packet_timeout(value): minV = AC_PACKET_TIMEOUT_MIN maxV = AC_PACKET_TIMEOUT_MAX if value in range(minV, maxV+1): return cv.Schema(cv.uint32_t)(value) raise cv.Invalid(f"Timeout should be in range: {minV}..{maxV}.") def validate_power_limit_range(value): minV = AC_POWER_LIMIT_MIN maxV = AC_POWER_LIMIT_MAX if value in range(minV, maxV+1): return cv.Schema(cv.uint32_t)(value) raise cv.Invalid(f"Power limit should be in range: {minV}..{maxV}") ALLOWED_CLIMATE_MODES = { "HEAT_COOL": ClimateMode.CLIMATE_MODE_HEAT_COOL, "COOL": ClimateMode.CLIMATE_MODE_COOL, "HEAT": ClimateMode.CLIMATE_MODE_HEAT, "DRY": ClimateMode.CLIMATE_MODE_DRY, "FAN_ONLY": ClimateMode.CLIMATE_MODE_FAN_ONLY, } validate_modes = cv.enum(ALLOWED_CLIMATE_MODES, upper=True) ALLOWED_CLIMATE_PRESETS = { "SLEEP": ClimatePreset.CLIMATE_PRESET_SLEEP, } validate_presets = cv.enum(ALLOWED_CLIMATE_PRESETS, upper=True) ALLOWED_CLIMATE_SWING_MODES = { "BOTH": ClimateSwingMode.CLIMATE_SWING_BOTH, "VERTICAL": ClimateSwingMode.CLIMATE_SWING_VERTICAL, "HORIZONTAL": ClimateSwingMode.CLIMATE_SWING_HORIZONTAL, } validate_swing_modes = cv.enum(ALLOWED_CLIMATE_SWING_MODES, upper=True) CUSTOM_FAN_MODES = { "MUTE": Capabilities.MUTE, "TURBO": Capabilities.TURBO, } validate_custom_fan_modes = cv.enum(CUSTOM_FAN_MODES, upper=True) CUSTOM_PRESETS = { "CLEAN": Capabilities.CLEAN, "HEALTH": Capabilities.HEALTH, "ANTIFUNGUS": Capabilities.ANTIFUNGUS, } validate_custom_presets = cv.enum(CUSTOM_PRESETS, upper=True) def validate_raw_data(value): if isinstance(value, list): return cv.Schema([cv.hex_uint8_t])(value) raise cv.Invalid("data must be a list of bytes") def output_info(config): _LOGGER.info("AUX_AC firmware version: %s", AUX_AC_FIRMWARE_VERSION) return config CONFIG_SCHEMA = cv.All( climate.climate_schema(climate.Climate).extend( { cv.GenerateID(): cv.declare_id(AirCon), cv.Optional(CONF_PERIOD, default="7s"): cv.time_period, cv.Optional(CONF_SHOW_ACTION, default="true"): cv.boolean, cv.Optional(CONF_DISPLAY_INVERTED, default="false"): cv.boolean, cv.Optional(CONF_TIMEOUT, default=AC_PACKET_TIMEOUT_MIN): validate_packet_timeout, cv.Optional(CONF_OPTIMISTIC, default="true"): cv.boolean, cv.Optional(CONF_INVERTER_POWER_DEPRICATED): cv.invalid( "The name of sensor was changed in v.0.2.9 from 'invertor_power' to 'inverter_power'. Update your config please." ), cv.Optional(CONF_INVERTER_POWER): sensor.sensor_schema( unit_of_measurement=UNIT_PERCENT, icon=ICON_POWER, accuracy_decimals=0, device_class=DEVICE_CLASS_POWER_FACTOR, state_class=STATE_CLASS_MEASUREMENT, ).extend( { cv.Optional(CONF_INTERNAL, default="true"): cv.boolean, } ), cv.Optional(CONF_INDOOR_TEMPERATURE): sensor.sensor_schema( unit_of_measurement=UNIT_CELSIUS, icon=ICON_THERMOMETER, accuracy_decimals=1, device_class=DEVICE_CLASS_TEMPERATURE, state_class=STATE_CLASS_MEASUREMENT, ).extend( { cv.Optional(CONF_INTERNAL, default="true"): cv.boolean, } ), cv.Optional(CONF_OUTDOOR_TEMPERATURE): sensor.sensor_schema( unit_of_measurement=UNIT_CELSIUS, icon=ICON_OUTDOOR_TEMPERATURE, accuracy_decimals=0, device_class=DEVICE_CLASS_TEMPERATURE, state_class=STATE_CLASS_MEASUREMENT, ).extend( { cv.Optional(CONF_INTERNAL, default="true"): cv.boolean, } ), cv.Optional(CONF_INBOUND_TEMPERATURE): sensor.sensor_schema( unit_of_measurement=UNIT_CELSIUS, icon=ICON_INBOUND_TEMPERATURE, accuracy_decimals=0, device_class=DEVICE_CLASS_TEMPERATURE, state_class=STATE_CLASS_MEASUREMENT, ).extend( { cv.Optional(CONF_INTERNAL, default="true"): cv.boolean, } ), cv.Optional(CONF_OUTBOUND_TEMPERATURE): sensor.sensor_schema( unit_of_measurement=UNIT_CELSIUS, icon=ICON_OUTBOUND_TEMPERATURE, accuracy_decimals=0, device_class=DEVICE_CLASS_TEMPERATURE, state_class=STATE_CLASS_MEASUREMENT, ).extend( { cv.Optional(CONF_INTERNAL, default="true"): cv.boolean, } ), cv.Optional(CONF_COMPRESSOR_TEMPERATURE): sensor.sensor_schema( unit_of_measurement=UNIT_CELSIUS, icon=ICON_COMPRESSOR_TEMPERATURE, accuracy_decimals=0, device_class=DEVICE_CLASS_TEMPERATURE, state_class=STATE_CLASS_MEASUREMENT, ).extend( { cv.Optional(CONF_INTERNAL, default="true"): cv.boolean, } ), cv.Optional(CONF_VLOUVER_STATE): sensor.sensor_schema( icon=ICON_VLOUVER_STATE, accuracy_decimals=0, ).extend( { cv.Optional(CONF_INTERNAL, default="true"): cv.boolean, } ), cv.Optional(CONF_DISPLAY_STATE): binary_sensor.binary_sensor_schema( icon=ICON_DISPLAY, ).extend( { cv.Optional(CONF_INTERNAL, default="true"): cv.boolean, } ), cv.Optional(CONF_DEFROST_STATE): binary_sensor.binary_sensor_schema( icon=ICON_DEFROST, ).extend( { cv.Optional(CONF_INTERNAL, default="true"): cv.boolean, } ), cv.Optional(CONF_PRESET_REPORTER): text_sensor.text_sensor_schema( icon=ICON_PRESET_REPORTER, ).extend( { cv.Optional(CONF_INTERNAL, default="true"): cv.boolean, } ), cv.Optional(CONF_INVERTER_POWER_LIMIT_VALUE): sensor.sensor_schema( unit_of_measurement=UNIT_PERCENT, icon=ICON_INVERTER_POWER_LIMIT_VALUE, accuracy_decimals=0, device_class=DEVICE_CLASS_POWER_FACTOR, state_class=STATE_CLASS_MEASUREMENT, ).extend( { cv.Optional(CONF_INTERNAL, default="true"): cv.boolean, } ), cv.Optional(CONF_INVERTER_POWER_LIMIT_STATE): binary_sensor.binary_sensor_schema( icon=ICON_INVERTER_POWER_LIMIT_STATE, ).extend( { cv.Optional(CONF_INTERNAL, default="true"): cv.boolean, } ), cv.Optional(CONF_SUPPORTED_MODES): cv.ensure_list(validate_modes), cv.Optional(CONF_SUPPORTED_SWING_MODES): cv.ensure_list( validate_swing_modes ), cv.Optional(CONF_SUPPORTED_PRESETS): cv.ensure_list(validate_presets), cv.Optional(CONF_CUSTOM_PRESETS): cv.ensure_list(validate_custom_presets), cv.Optional(CONF_CUSTOM_FAN_MODES): cv.ensure_list( validate_custom_fan_modes ), } ) .extend(uart.UART_DEVICE_SCHEMA) .extend(cv.COMPONENT_SCHEMA), output_info, ) async def to_code(config): CORE.add_define( Define("AUX_AC_FIRMWARE_VERSION", '"'+AUX_AC_FIRMWARE_VERSION+'"') ) CORE.add_define( Define("AUX_AC_PACKET_TIMEOUT_MIN", AC_PACKET_TIMEOUT_MIN) ) CORE.add_define( Define("AUX_AC_PACKET_TIMEOUT_MAX", AC_PACKET_TIMEOUT_MAX) ) CORE.add_define( Define("AUX_AC_MIN_INVERTER_POWER_LIMIT", AC_POWER_LIMIT_MIN) ) CORE.add_define( Define("AUX_AC_MAX_INVERTER_POWER_LIMIT", AC_POWER_LIMIT_MAX) ) var = cg.new_Pvariable(config[CONF_ID]) await cg.register_component(var, config) await climate.register_climate(var, config) parent = await cg.get_variable(config[CONF_UART_ID]) cg.add(var.initAC(parent)) if CONF_INDOOR_TEMPERATURE in config: conf = config[CONF_INDOOR_TEMPERATURE] sens = await sensor.new_sensor(conf) cg.add(var.set_indoor_temperature_sensor(sens)) if CONF_OUTDOOR_TEMPERATURE in config: conf = config[CONF_OUTDOOR_TEMPERATURE] sens = await sensor.new_sensor(conf) cg.add(var.set_outdoor_temperature_sensor(sens)) if CONF_OUTBOUND_TEMPERATURE in config: conf = config[CONF_OUTBOUND_TEMPERATURE] sens = await sensor.new_sensor(conf) cg.add(var.set_outbound_temperature_sensor(sens)) if CONF_INBOUND_TEMPERATURE in config: conf = config[CONF_INBOUND_TEMPERATURE] sens = await sensor.new_sensor(conf) cg.add(var.set_inbound_temperature_sensor(sens)) if CONF_COMPRESSOR_TEMPERATURE in config: conf = config[CONF_COMPRESSOR_TEMPERATURE] sens = await sensor.new_sensor(conf) cg.add(var.set_compressor_temperature_sensor(sens)) if CONF_VLOUVER_STATE in config: conf = config[CONF_VLOUVER_STATE] sens = await sensor.new_sensor(conf) cg.add(var.set_vlouver_state_sensor(sens)) if CONF_DISPLAY_STATE in config: conf = config[CONF_DISPLAY_STATE] sens = await binary_sensor.new_binary_sensor(conf) cg.add(var.set_display_sensor(sens)) if CONF_DEFROST_STATE in config: conf = config[CONF_DEFROST_STATE] sens = await binary_sensor.new_binary_sensor(conf) cg.add(var.set_defrost_state(sens)) if CONF_INVERTER_POWER in config: conf = config[CONF_INVERTER_POWER] sens = await sensor.new_sensor(conf) cg.add(var.set_inverter_power_sensor(sens)) if CONF_PRESET_REPORTER in config: conf = config[CONF_PRESET_REPORTER] sens = await text_sensor.new_text_sensor(conf) cg.add(var.set_preset_reporter_sensor(sens)) if CONF_INVERTER_POWER_LIMIT_VALUE in config: conf = config[CONF_INVERTER_POWER_LIMIT_VALUE] sens = await sensor.new_sensor(conf) cg.add(var.set_inverter_power_limit_value_sensor(sens)) if CONF_INVERTER_POWER_LIMIT_STATE in config: conf = config[CONF_INVERTER_POWER_LIMIT_STATE] sens = await binary_sensor.new_binary_sensor(conf) cg.add(var.set_inverter_power_limit_state_sensor(sens)) cg.add(var.set_period(config[CONF_PERIOD].total_milliseconds)) cg.add(var.set_show_action(config[CONF_SHOW_ACTION])) cg.add(var.set_display_inverted(config[CONF_DISPLAY_INVERTED])) cg.add(var.set_packet_timeout(config[CONF_TIMEOUT])) cg.add(var.set_optimistic(config[CONF_OPTIMISTIC])) if CONF_SUPPORTED_MODES in config: cg.add(var.set_supported_modes(config[CONF_SUPPORTED_MODES])) if CONF_SUPPORTED_SWING_MODES in config: cg.add(var.set_supported_swing_modes(config[CONF_SUPPORTED_SWING_MODES])) if CONF_SUPPORTED_PRESETS in config: cg.add(var.set_supported_presets(config[CONF_SUPPORTED_PRESETS])) if use_new_api(): if CONF_CUSTOM_PRESETS in config: presets = config[CONF_CUSTOM_PRESETS] c_str_presets = [cg.RawExpression(f"aux_ac::Constants::{p}.c_str()") for p in presets] cg.add(var.set_custom_presets(c_str_presets)) if CONF_CUSTOM_FAN_MODES in config: fan_modes = config[CONF_CUSTOM_FAN_MODES] c_str_fan_modes = [cg.RawExpression(f"aux_ac::Constants::{p}.c_str()") for p in fan_modes] cg.add(var.set_custom_fan_modes(c_str_fan_modes)) else: if CONF_CUSTOM_PRESETS in config: cg.add(var.set_custom_presets(config[CONF_CUSTOM_PRESETS])) if CONF_CUSTOM_FAN_MODES in config: cg.add(var.set_custom_fan_modes(config[CONF_CUSTOM_FAN_MODES])) DISPLAY_ACTION_SCHEMA = maybe_simple_id( { cv.Required(CONF_ID): cv.use_id(AirCon), } ) @automation.register_action( "aux_ac.display_off", AirConDisplayOffAction, DISPLAY_ACTION_SCHEMA ) async def display_off_to_code(config, action_id, template_arg, args): paren = await cg.get_variable(config[CONF_ID]) return cg.new_Pvariable(action_id, template_arg, paren) @automation.register_action( "aux_ac.display_on", AirConDisplayOnAction, DISPLAY_ACTION_SCHEMA ) async def display_on_to_code(config, action_id, template_arg, args): paren = await cg.get_variable(config[CONF_ID]) return cg.new_Pvariable(action_id, template_arg, paren) VLOUVER_ACTION_SCHEMA = maybe_simple_id( { cv.Required(CONF_ID): cv.use_id(AirCon), } ) @automation.register_action( "aux_ac.vlouver_stop", AirConVLouverStopAction, VLOUVER_ACTION_SCHEMA ) async def vlouver_stop_to_code(config, action_id, template_arg, args): paren = await cg.get_variable(config[CONF_ID]) return cg.new_Pvariable(action_id, template_arg, paren) @automation.register_action( "aux_ac.vlouver_swing", AirConVLouverSwingAction, VLOUVER_ACTION_SCHEMA ) async def vlouver_swing_to_code(config, action_id, template_arg, args): paren = await cg.get_variable(config[CONF_ID]) return cg.new_Pvariable(action_id, template_arg, paren) @automation.register_action( "aux_ac.vlouver_top", AirConVLouverTopAction, VLOUVER_ACTION_SCHEMA ) async def vlouver_top_to_code(config, action_id, template_arg, args): paren = await cg.get_variable(config[CONF_ID]) return cg.new_Pvariable(action_id, template_arg, paren) @automation.register_action( "aux_ac.vlouver_middle_above", AirConVLouverMiddleAboveAction, VLOUVER_ACTION_SCHEMA ) async def vlouver_middle_above_to_code(config, action_id, template_arg, args): paren = await cg.get_variable(config[CONF_ID]) return cg.new_Pvariable(action_id, template_arg, paren) @automation.register_action( "aux_ac.vlouver_middle", AirConVLouverMiddleAction, VLOUVER_ACTION_SCHEMA ) async def vlouver_middle_to_code(config, action_id, template_arg, args): paren = await cg.get_variable(config[CONF_ID]) return cg.new_Pvariable(action_id, template_arg, paren) @automation.register_action( "aux_ac.vlouver_middle_below", AirConVLouverMiddleBelowAction, VLOUVER_ACTION_SCHEMA ) async def vlouver_middle_below_to_code(config, action_id, template_arg, args): paren = await cg.get_variable(config[CONF_ID]) return cg.new_Pvariable(action_id, template_arg, paren) @automation.register_action( "aux_ac.vlouver_bottom", AirConVLouverBottomAction, VLOUVER_ACTION_SCHEMA ) async def vlouver_bottom_to_code(config, action_id, template_arg, args): paren = await cg.get_variable(config[CONF_ID]) return cg.new_Pvariable(action_id, template_arg, paren) VLOUVER_SET_ACTION_SCHEMA = cv.Schema( { cv.Required(CONF_ID): cv.use_id(AirCon), cv.Required(CONF_POSITION): cv.templatable(cv.int_range(0, 6)), } ) @automation.register_action( "aux_ac.vlouver_set", AirConVLouverSetAction, VLOUVER_SET_ACTION_SCHEMA ) async def vlouver_set_to_code(config, action_id, template_arg, args): paren = await cg.get_variable(config[CONF_ID]) var = cg.new_Pvariable(action_id, template_arg, paren) template_ = await cg.templatable(config[CONF_POSITION], args, int) cg.add(var.set_value(template_)) return var POWER_LIMITATION_OFF_ACTION_SCHEMA = maybe_simple_id( { cv.Required(CONF_ID): cv.use_id(AirCon), } ) @automation.register_action( "aux_ac.power_limit_off", AirConPowerLimitationOffAction, POWER_LIMITATION_OFF_ACTION_SCHEMA ) async def power_limit_off_to_code(config, action_id, template_arg, args): paren = await cg.get_variable(config[CONF_ID]) return cg.new_Pvariable(action_id, template_arg, paren) POWER_LIMITATION_ON_ACTION_SCHEMA = cv.Schema( { cv.Required(CONF_ID): cv.use_id(AirCon), cv.Optional(CONF_LIMIT, default=AC_POWER_LIMIT_MIN): validate_power_limit_range, } ) @automation.register_action( "aux_ac.power_limit_on", AirConPowerLimitationOnAction, POWER_LIMITATION_ON_ACTION_SCHEMA ) async def power_limit_on_to_code(config, action_id, template_arg, args): paren = await cg.get_variable(config[CONF_ID]) var = cg.new_Pvariable(action_id, template_arg, paren) template_ = await cg.templatable(config[CONF_LIMIT], args, int) cg.add(var.set_value(template_)) return var # ********************************************************************************************************* # ВАЖНО! Только для инженеров! # Вызывайте метод aux_ac.send_packet только если понимаете, что делаете! Он не проверяет данные, а передаёт # кондиционеру всё как есть. Какой эффект получится от передачи кондиционеру рандомных байт, никто не знает. # Вы действуете на свой страх и риск. # ********************************************************************************************************* SEND_TEST_PACKET_ACTION_SCHEMA = maybe_simple_id( { cv.Required(CONF_ID): cv.use_id(AirCon), cv.Required(CONF_DATA): cv.templatable(validate_raw_data), } ) @automation.register_action( "aux_ac.send_packet", AirConSendTestPacketAction, SEND_TEST_PACKET_ACTION_SCHEMA ) async def send_packet_to_code(config, action_id, template_arg, args): paren = await cg.get_variable(config[CONF_ID]) var = cg.new_Pvariable(action_id, template_arg, paren) data = config[CONF_DATA] if isinstance(data, bytes): data = list(data) if cg.is_template(data): templ = await cg.templatable(data, args, cg.std_vector.template(cg.uint8)) cg.add(var.set_data_template(templ)) else: cg.add(var.set_data_static(data)) return var