红外远程温控

此温控组件允许您通过发送红外（IR）控制信号来控制兼容的空调设备，就像设备的手持遥控器一样。

兼容设备列表不断增长。如果您的设备未在下面列出，应提交功能请求（请参阅 FAQ）。

支持的设备	平台名称	支持接收器
Ballu	`ballu`	yes
Coolix	`coolix`	yes
Daikin	`daikin`	yes
Daikin ARC	`daikin_arc`	yes
Daikin BRC	`daikin_brc`	yes
Delonghi	`delonghi`	yes
Emmeti	`emmeti`	yes
Fujitsu General	`fujitsu_general`	yes
GREE	`gree`
Hitachi	`hitachi_ac344`, `hitachi_ac424`	yes
LG	`climate_ir_lg`	yes
Midea	`midea_ir`	yes
Mitsubishi	`mitsubishi`	yes
Noblex	`noblex`	yes
Electrolux, TCL, Fuego	`tcl112`	yes
Toshiba	`toshiba`	yes
Whirlpool	`whirlpool`	yes
Yashima	`yashima`
Whynter	`whynter`	yes
ZH/LT-01	`zhlt01`	yes
Arduino-HeatpumpIR library	`heatpumpir`

此组件需要您已配置远程发射器。

由于 IR 遥控器的单向性质，此组件无法确定设备的实际状态，并将假设设备状态为最新请求的状态。假设的状态可以在启动时恢复。

但是，当支持接收器时，您可以选择添加远程接收器组件，这样当使用原始遥控器操作时，温控状态将被跟踪。

# 示例配置条目
remote_transmitter:
  pin: GPIOXX
  carrier_duty_percent: 50%

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

配置变量

sensor (可选, ID): 用于测量环境温度的传感器。这仅用于在前端报告当前温度。
humidity_sensor (可选, ID): 用于测量环境湿度的传感器。这仅用于在前端报告当前湿度。
supports_cool (可选, boolean): 为此温控设备启用制冷模式设置。默认为 true。
supports_heat (可选, boolean): 为此温控设备启用制热模式设置。默认为 true。
receiver_id (可选, ID): 如果此平台支持接收器，则为 remote_receiver 的 ID。请参阅：使用接收器。
Climate 的所有其他选项。

高级选项

transmitter_id (可选, ID): 手动指定远程发射器的 ID。

`climate_ir_lg`

header_high (可选, 时间): LG 协议报头高电平部分的时间。默认为 8000us
header_low (可选, 时间): LG 协议报头低电平部分的时间。默认为 4000us
bit_high (可选, 时间): LG 协议中任何位的高电平部分时间。默认为 600us
bit_one_low (可选, 时间): LG 协议中 ‘1’ 位的低电平部分时间。默认为 1600us
bit_zero_low (可选, 时间): LG 协议中 ‘0’ 位的低电平部分时间。默认为 550us

# 示例配置条目
climate:
  - platform: climate_ir_lg
    name: "AC"
    sensor: room_temperature
    header_high: 3265us # 例如巴西的 LG 空调使用这些时序
    header_low: 9856us

`daikin_brc`

Daikin BRC 遥控器用于 Daikin 吸顶式热泵。

use_fahrenheit (可选, boolean): Daikin BRC 遥控器的美国型号以华氏度发送温度，如果您的遥控器显示华氏度且无法更改为摄氏度，请将此设置为 true。默认为 false。

# 示例配置条目
climate:
  - platform: daikin_brc
    name: "AC"
    sensor: room_temperature
    use_fahrenheit: true

`delonghi`

delonghi 温控目前支持某些 Delonghi 便携式设备使用的协议，已知可与 Delonghi PAC WE 120HP 配合使用。

`daikin_arc`

Daikin ARC 遥控器（daikin_arc 温控，Arduino-HeatpumpIR 的 daikin_arc417、daikin_arc480 协议）用于 Daikin 的日本型号。

`gree`

model (必填, string): GREE 根据型号有不同的协议。以下之一可能适合您：
- generic
- yan
- yaa
- yac
- yac1fb9
- yx1ff
- yag

# 仅供温控的示例配置条目
climate:
  - platform: gree
    name: "AC"
    id: my_gree_ac
    sensor: room_temperature
    model: yan

型号 yan、yaa、yac 和 yac1fb9 支持一些额外功能，可以通过开关控制：

gree_id (必填, ID): 指定这些开关应属于的 gree 温控的 ID。
light (可选, 开关): 夜间关闭室内机显示/LED 以实现完全黑暗。
turbo (可选, 开关): 最大风扇速度和最快效果。
health (可选, 开关): 通过电离流过叶片的空气来去除环境中的灰尘和细菌。
xfan (可选, 开关): 防止机器内部因过多水分导致霉菌、霉变和异味。关闭空调后，室内风扇将继续运行一小段时间，以干燥叶片。

# 温控开关的示例配置条目
switch:
  - platform: gree
    gree_id: my_gree_ac
    light:
      name: "AC Lights"
    turbo:
      name: "AC Turbo"
    health:
      name: "AC Health"
    xfan:
      name: "AC X-Fan"

`midea_ir`

这些空调支持两种协议：Midea 和 Coolix。因此，在使用 IR 接收器时，它会考虑两种协议并发布接收到的状态。

use_fahrenheit (可选, boolean): 允许您以华氏度将温度传输到空调。空调显示屏也以华氏度显示温度。默认为 false。

# 示例配置条目
climate:
  - platform: midea_ir
    name: "AC"
    sensor: room_temperature
    use_fahrenheit: true

NOTE

请参阅发送 Midea 以发送自定义命令，包括 Follow Me 模式。
如果您正在寻找与 Midea 型号 MAP14HS1TBL 或类似型号的兼容性，请参阅下面的 Toshiba。

`mitsubishi`

NOTE

当将此组件与仅支持制冷模式的三菱机组一起使用时，关闭命令可能不起作用。将 supports_heat 设置为 false 可解决此问题。

set_fan_mode (可选, string): 选择所需的风扇模式或遥控器上支持的模式。默认为 3levels
- 选项有：3levels、4levels、quiet_4levels。
  - 3levels：低 [风扇速度 1]、中 [2]、高 [3]
  - 4levels：低 [1]、中低 [2]、中 [3]、高 [4]
  - quiet_4levels：低 [1]、中低 [2]、中 [3]、高 [4]、静音 [5]
supports_dry (可选, boolean): 为此设备启用除湿模式设置。默认为 false。
supports_fan_only (可选, boolean): 为此设备启用仅风扇模式设置。确认您的遥控器支持此模式。默认为 false。
horizontal_default (可选, string): 当空调机组的水平方向未设置为摆风时默认的方向。默认为 middle。
- 选项有：left、middle-left、middle、middle-right、right、auto
vertical_default (可选, string): 当空调机组的垂直方向未设置为摆风时默认的方向。默认为 middle。
- 选项有：down、middle-down、middle、middle-up、up、auto

NOTE

此红外温控组件也已知适用于某些 Stiebel Eltron 机组。已通过 Stiebel Eltron 红外遥控 KM07F 和机组 ACW 25 i 进行测试

# 示例配置条目
climate:
  - platform: mitsubishi
    name: "Heatpump"
    set_fan_mode: "quiet_4levels"
    supports_dry: "true"
    supports_fan_only: "true"
    horizontal_default: "left"
    vertical_default: "down"

`toshiba`

model (可选, string): 有四个有效型号：
- GENERIC：温度范围为 17 到 30（默认）
- RAC-PT1411HWRU-C：温度范围为 16 到 30；机组以摄氏度显示温度
- RAC-PT1411HWRU-F：温度范围为 16 到 30；机组以华氏度显示温度
- RAS-2819T：温度范围为 18 到 30；支持双包红外协议

NOTE

虽然在这里它们被标识为单独的型号，但 RAC-PT1411HWRU-C 和 RAC-PT1411HWRU-F 实际上是相同的物理型号/机组。它们在这里分开只是因为根据所需的测量单位使用不同的红外代码。这仅影响机组本身显示温度的方式。
RAC-PT1411HWRU 型号支持东芝称为”Comfort Sense”的功能。手持遥控器内置温度传感器，它会定期将此传感器的温度传输到空调机组。如果在此型号的配置中提供了 sensor，传感器的温度将以与原始遥控器相同的方式传输到 RAC-PT1411HWRU。传输温度的频率由分配给 sensor 的 update_interval 决定。请注意，update_interval 必须少于七分钟，否则 RAC-PT1411HWRU 将恢复使用其内部温度传感器；30 秒的值似乎效果不错。请参阅 Sensor 获取更多信息。
RAS-2819T 型号使用双包红外协议，大多数命令发送一个主包（包含温度、模式和风扇速度），后跟一个辅助包（包含风扇速度确认和特定模式数据）。单包命令用于关机和摆风切换操作。
此红外温控组件也已知适用于 Midea 型号 MAP14HS1TBL，可能也适用于其他类似型号。（Midea 收购了东芝的产品线并重新品牌化。）

# RAS-2819T 的示例配置条目
climate:
  - platform: toshiba
    name: "Toshiba AC"
    model: RAS-2819T
    sensor: room_temperature

`whirlpool`

model (可选, string): 有两个有效型号可供选择：
- DG11J1-3A：温度范围为 18 到 32（默认）
- DG11J1-91：温度范围为 16 到 30

`whynter`

use_fahrenheit (可选, boolean): 允许您以华氏度将温度传输到空调。空调显示屏也以华氏度显示温度。默认为 false。

# 示例配置条目
climate:
  - platform: whynter
    name: "AC"
    sensor: room_temperature
    use_fahrenheit: true
    supports_heat: true

`zhlt01`

zhlt01 温控和协议基于 ZH/LT-01 遥控器，用于许多本地品牌的空调，如：Eurom、Chigo、Tristar、Tecnomaster、Elgin、Geant、Tekno、Topair、Proma、Sumikura、JBS、Turbo Air、Nakatomy、Celestial Air、Ager、Blueway、Airlux 等。

使用接收器

NOTE

这仅受部分温控设备支持，请参阅页面顶部的表格中的”支持接收器”列。

可选地，某些平台可以监听温控设备通过红外发送的数据来更新其状态（例如设备处于什么模式）。通过设置 remote_receiver 并将其 ID 传递给温控平台，您可以启用此模式。

使用接收器时，建议将 IR 接收器放置在尽可能靠近设备的 IR 接收器的位置。

# 示例配置条目
remote_receiver:
  id: rcvr
  pin:
    number: GPIOXX
    inverted: true
    mode:
      input: true
      pullup: true
  # 对于某些遥控设备，建议使用 55% 的高容差
  tolerance: 55%

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

Arduino-HeatpumpIR

heatpumpir 平台通过利用 Arduino-HeatpumpIR 库支持数十个制造商和数百个空调机组。

此平台适用于 arduino 框架和 ESP-IDF（在 ESP32 上），仅当您的空调机组不受上述其他（原生）平台支持时才应使用。无法为 Arduino-HeatpumpIR 提供支持，因为它是第三方库。

此平台利用库的通用万能 API，可能与所有支持的空调机组并不完美匹配。例如，某些空调机组的风扇速度选项比通用 API 支持的要多。

此平台需要指定额外配置：

protocol (必填, string): 选择 Arduino-HeatpumpIR 支持的协议之一：

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, philco_phs32, r51m, samsung_aqv, samsung_aqv12msan, samsung_fjm, sharp, toshiba, toshiba_daiseikai, vaillantvai8, zhjg01, zhlt01
horizontal_default (必填, string): 当空调机组的水平方向未设置为摆风时默认的方向。选项有：left、mleft、middle、mright、right、auto
vertical_default (必填, string): 当空调机组的垂直方向未设置为摆风时默认的方向。选项有：down、mdown、middle、mup、up、auto
max_temperature (必填, float): 空调机组支持设置的最高温度。
min_temperature (必填, float): 空调机组支持设置的最低温度。
sensor (可选, ID): 用于测量环境温度的传感器。

NOTE

heatpumpir 中的 greeyac 协议支持 Gree 称为”I-Feel”的功能。手持遥控器内置温度传感器，它会定期将此传感器的温度传输到空调机组。如果在此型号的配置中提供了 sensor，传感器的温度将以与原始遥控器相同的方式传输到 greeyac 设备。传输温度的频率由分配给 sensor 的 update_interval 决定。请注意，update_interval 必须少于 10 分钟，否则 greeyac 设备将恢复使用其内部温度传感器；2 分钟的值似乎效果不错。请参阅 Sensor 获取更多信息。

红外远程温控

配置变量

高级选项

climate_ir_lg

daikin_brc

delonghi

daikin_arc

gree

midea_ir

mitsubishi

toshiba

whirlpool

whynter

zhlt01

使用接收器

Arduino-HeatpumpIR

另见

`climate_ir_lg`

`daikin_brc`

`delonghi`

`daikin_arc`

`gree`

`midea_ir`

`mitsubishi`

`toshiba`

`whirlpool`

`whynter`

`zhlt01`