IR Remote Climate

This climate component allows you to control compatible AC units by sending an infrared (IR) control signal, just as the unit’s handheld remote controller would.

There is a growing list of compatible units. If your unit is not listed below you should submit a feature request (see FAQ).

This component requires that you have configured a Remote Transmitter.

Due to the unidirectional nature of IR remote controllers, this component cannot determine the actual state of the device and will assume the state of the device is the latest state requested. The assumed state can be restored at boot.

However, when receiver is supported, you can optionally add a Remote Receiver component so the climate state will be tracked when it is operated with the original remote controller unit.

# Example configuration entry
remote_transmitter:
  pin: GPIOXX
  carrier_duty_percent: 50%

climate:
  - platform: REPLACEME
    name: "Living Room AC"

Configuration Variables:

• sensor (Optional, ID): The sensor that is used to measure the ambient temperature. This is only for reporting the current temperature in the frontend.
• supports_cool (Optional, boolean): Enables setting cooling mode for this climate device. Defaults to true.
• supports_heat (Optional, boolean): Enables setting heating mode for this climate device. Defaults to true.
• receiver_id (Optional, ID): The id of the remote_receiver if this platform supports receiver. see: Using a Receiver.
• All other options from Climate.

Advanced Options

• transmitter_id (Optional, ID): Manually specify the ID of the remote transmitter.

Specific configuration variables:

climate_ir_lg Climate:

• header_high (Optional, Time): time for the high part of the header for the LG protocol. Defaults to 8000us
• header_low (Optional, Time): time for the low part of the header for the LG protocol. Defaults to 4000us
• bit_high (Optional, Time): time for the high part of any bit in the LG protocol. Defaults to 600us
• bit_one_low (Optional, Time): time for the low part of a ‘1’ bit in the LG protocol. Defaults to 1600us
• bit_zero_low (Optional, Time): time for the low part of a ‘0’ bit in the LG protocol. Defaults to 550us

# Example configuration entry
climate:
  - platform: climate_ir_lg
    name: "AC"
    sensor: room_temperature
    header_high: 3265us # AC Units from LG in Brazil, for example use these timings
    header_low: 9856us

daikin_brc Climate:

The Daikin BRC remotes are used by the ceiling cassette model of Daikin heatpumps.

• use_fahrenheit (Optional, boolean): U.S. models of the Daikin BRC remote send the temperature in Fahrenheit, if your remote shows Fahrenheit and can not be changed to Celsius then set this to true. Defaults to false.

# Example configuration entry
climate:
  - platform: daikin_brc
    name: "AC"
    sensor: room_temperature
    use_fahrenheit: true

delonghi Climate:

The delonghi climate currently supports the protocol used by some Delonghi portable units, known working with Delonghi PAC WE 120HP.

daikin_arc Climate:

The Daikin ARC remotes (daikin_arc climate, daikin_arc417, daikin_arc480 protocols of Arduino-HeatpumpIR) are used by the japanese model of Daikin.

gree Climate:

• model (Required, string): GREE has a few different protocols depending on model. One of these will work for you.

  • generic
  • yan
  • yaa
  • yac
  • yac1fb9
  • yx1ff
  • yag

# Example configuration entry
climate:
  - platform: gree
    name: "AC"
    sensor: room_temperature
    model: yan

midea_ir Climate:

These air conditioners support two protocols: Midea and Coolix. Therefore, when using an IR receiver, it considers both protocols and publishes the received states.

• use_fahrenheit (Optional, boolean): Allows you to transfer the temperature to the air conditioner in degrees Fahrenheit. The air conditioner display also shows the temperature in Fahrenheit. Defaults to false.

# Example configuration entry
climate:
  - platform: midea_ir
    name: "AC"
    sensor: room_temperature
    use_fahrenheit: true

mitsubishi Climate:

• set_fan_mode (Optional, string): Select the fan modes desired or that are supported on your remote. Defaults to 3levels

  • Options are: 3levels , 4levels, quiet_4levels.

    • 3levels; Low [fan speed 1], Medium [2], High [3]
    • 4levels; Low [1], Middle [2], Medium [3], High [4]
    • quiet_4levels; Low [1], Middle [2], Medium [3], High [4], Quiet [5]

• supports_dry (Optional, boolean): Enables setting dry mode for this unit. Defaults to false.

• supports_fan_only (Optional, boolean): Enables setting fan only mode for this unit. Confirm that mode is supported on your remote. Defaults to false.

• horizontal_default (Optional, string): What to default to when the AC unit’s horizontal direction is not set to swing. Defaults to middle.

  • Options are: left, middle-left, middle, middle-right, right, auto

• vertical_default (Optional, string): What to default to when the AC unit’s vertical direction is not set to swing. Defaults to middle.

  • Options are: down, middle-down, middle, middle-up, up, auto

# Example configuration entry
climate:
  - platform: mitsubishi
    name: "Heatpump"
    set_fan_mode: "quiet_4levels"
    supports_dry: "true"
    supports_fan_only: "true"
    horizontal_default: "left"
    vertical_default: "down"

toshiba Climate:

• model (Optional, string): There are two valid models

  • GENERIC: Temperature range is from 17 to 30 (default)
  • RAC-PT1411HWRU-C: Temperature range is from 16 to 30; unit displays temperature in degrees Celsius
  • RAC-PT1411HWRU-F: Temperature range is from 16 to 30; unit displays temperature in degrees Fahrenheit

whirlpool Climate:

• model (Optional, string): There are two valid models to choose from:

  • DG11J1-3A: Temperature range is from 18 to 32 (default)
  • DG11J1-91: Temperature range is from 16 to 30

whynter Climate:

• use_fahrenheit (Optional, boolean): Allows you to transfer the temperature to the air conditioner in degrees Fahrenheit. The air conditioner display also shows the temperature in Fahrenheit. Defaults to false.

# Example configuration entry
climate:
  - platform: whynter
    name: "AC"
    sensor: room_temperature
    use_fahrenheit: true
    supports_heat: true

zhlt01 Climate:

The zhlt01 climate and protocol, based on the ZH/LT-01 remote controller, is used with many locally branded airconditioners, like: Eurom, Chigo, Tristar, Tecnomaster, Elgin, Geant, Tekno, Topair, Proma, Sumikura, JBS, Turbo Air, Nakatomy, Celestial Air, Ager, Blueway, Airlux, etc.

Using a Receiver

When using a receiver it is recommended to put the IR receiver as close as possible to the equipment’s IR receiver.

# Example configuration entry
remote_receiver:
  id: rcvr
  pin:
    number: GPIOXX
    inverted: true
    mode:
      input: true
      pullup: true
  # high 55% tolerance is recommended for some remote control units
  tolerance: 55%

climate:
  - platform: REPLACEME
    name: "Living Room AC"
    receiver_id: rcvr

Arduino-HeatpumpIR

The heatpumpir platform supports dozens of manufacturers and hundreds of AC units by utilising the Arduino-HeatpumpIR library.

This platform compiles only under arduino framework or LibreTiny, and should only be used if your AC unit is not supported by any of the other (native) platforms from above. No support can be provided for Arduino-HeatpumpIR, because it is a third party library.

This platform utilises the library’s generic one-size-fits-all API, which might not line up perfectly with all of the supported AC units. For example, some AC units have more fan speed options than what the generic API supports.

Additional configuration must be specified for this platform:

• protocol (Required, string): Choose one of Arduino-HeatpumpIR’s supported protcols: airway, aux, ballu, bgh_aud, carrier_mca, carrier_nqv, carrier_qlima_1, carrier_qlima_1, daikin, daikin_arc417, daikin_arc480, electroluxyal, fuego, fujitsu_awyz, gree, greeyaa, greeyac, greeyan, greeyap, greeyt, hisense_aud, hitachi, hyundai, ivt, midea, mitsubishi_fa, mitsubishi_fd, mitsubishi_fe, mitsubishi_heavy_fdtc, mitsubishi_heavy_zj, mitsubishi_heavy_zm, mitsubishi_heavy_zmp, mitsubishi_kj, mitsubishi_msc, mitsubishi_msy, mitsubishi_sez, nibe, panasonic_altdke, panasonic_ckp, panasonic_dke, panasonic_eke, panasonic_jke, panasonic_lke, panasonic_nke, r51m, samsung_aqv, samsung_aqv12msan, samsung_fjm, sharp, toshiba, toshiba_daiseikai, vaillantvai8, zhjg01, zhlt01
• horizontal_default (Required, string): What to default to when the AC unit’s horizontal direction is not set to swing. Options are: left, mleft, middle, mright, right, auto
• vertical_default (Required, string): What to default to when the AC unit’s vertical direction is not set to swing. Options are: down, mdown, middle, mup, up, auto
• max_temperature (Required, float): The maximum temperature that the AC unit supports being set to.
• min_temperature (Required, float): The minimum temperature that the AC unit supports being set to.
• sensor (Optional, ID): The sensor that is used to measure the ambient temperature.

See Also

• Climate Component
• Remote Receiver
• Remote Transmitter
• Sensor Component
• ballu.h , climate_ir_lg.h coolix.h , daikin.h fujitsu_general.h , gree.h , hitachi_ac344.h , midea_ir.h , mitsubishi.h , tcl112.h , yashima.h whirlpool.h