IR 遥控气候设备

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

兼容设备列表正在不断增加。如果你的设备不在下列列表中，你应该提交功能请求（见常见问题）。

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

此组件要求你已经配置了 Remote Transmitter。

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

但是，当支持接收器时，你可以选择性地添加一个 Remote Receiver 组件，以便当设备通过原装遥控器操作时跟踪气候状态。

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

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

配置变量

sensor (可选，ID)：用于测量环境温度的传感器。此仅用于在前端报告当前温度。
humidity_sensor (可选，ID)：用于测量环境湿度的传感器。此仅用于在前端报告当前湿度。
supports_cool (可选，布尔值)：为此气候设备启用冷却模式设置。默认为 true。
supports_heat (可选，布尔值)：为此气候设备启用加热模式设置。默认为 true。
receiver_id (可选，ID)：如果此平台支持接收器，则为 remote_receiver 的 ID。参见：使用接收器。
Climate 中的所有其他选项。

高级选项

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

`climate_ir_lg`

header_high (可选，Time)：LG 协议中头部高电平的时间。默认为 8000us
header_low (可选，Time)：LG 协议中头部低电平的时间。默认为 4000us
bit_high (可选，Time)：LG 协议中任何比特高电平的时间。默认为 600us
bit_one_low (可选，Time)：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 (可选，布尔值)：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 (必填，字符串)：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 (可选，Switch)：夜间关闭室内机显示屏/LED，使房间完全黑暗。
turbo (可选，Switch)：最大风扇速度和最快效果。
health (可选，Switch)：通过对流过叶片的空气进行离子化，去除环境中的灰尘和细菌。
xfan (可选，Switch)：防止机器中产生过多水分而导致霉菌、霉斑和异味。关闭空调后，室内风扇将继续短时间运行，以干燥叶片。

# 气候开关的配置示例
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 (可选，布尔值)：允许你将温度以华氏度传输到空调。空调显示屏也会以华氏度显示温度。默认为 false。

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

NOTE

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

`mitsubishi`

NOTE

对于仅支持冷却模式的三菱设备，使用此组件时关闭命令可能无法工作。将 supports_heat 设为 false 以解决该问题。

set_fan_mode (可选，字符串)：选择所需或你的遥控器支持的风扇模式。默认为 3levels
- 可选值：3levels、4levels、quiet_4levels。
  - 3levels ; 低 [风扇速度 1]、中 [2]、高 [3]
  - 4levels ; 低 [1]、中低 [2]、中 [3]、高 [4]
  - quiet_4levels ; 低 [1]、中低 [2]、中 [3]、高 [4]、安静 [5]
supports_dry (可选，布尔值)：为此设备启用干燥模式设置。默认为 false。
supports_fan_only (可选，布尔值)：为此设备启用仅风扇模式设置。确认你的遥控器支持此模式。默认为 false。
horizontal_default (可选，字符串)：当空调的水平方向未设置为摆动时的默认值。默认为 middle。
- 可选值：left、middle-left、middle、middle-right、right、auto
vertical_default (可选，字符串)：当空调的垂直方向未设置为摆动时的默认值。默认为 middle。
- 可选值：down、middle-down、middle、middle-up、up、auto

NOTE

此气候 IR 组件还已知可以与一些 Stiebel Eltron 设备一起工作。已经过 Stiebel Eltron IR-Remote 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 (可选，字符串)：有四个有效型号：
- GENERIC : 温度范围从 17 到 30（默认）
- RAC-PT1411HWRU-C : 温度范围从 16 到 30；设备以摄氏度显示温度
- RAC-PT1411HWRU-F : 温度范围从 16 到 30；设备以华氏度显示温度
- RAS-2819T : 温度范围从 18 到 30；支持双数据包 IR 协议

NOTE

虽然它们在这里被标识为不同的型号，但 RAC-PT1411HWRU-C 和 RAC-PT1411HWRU-F 实际上是同一个物理型号/设备。这里分开它们仅仅是因为根据所需的测量单位使用不同的 IR 代码。这仅影响设备本身如何显示温度。
RAC-PT1411HWRU 型号支持一个 Toshiba 称之为 “Comfort Sense” 的功能。手持遥控器内置温度传感器，它会定期将此传感器的温度传输到空调。如果在此型号的配置中提供了 sensor，传感器的温度将以与原装遥控器相同的方式传输到 RAC-PT1411HWRU。温度传输的频率由分配给 sensor 的 update_interval 决定。注意 update_interval 必须少于七分钟，否则 RAC-PT1411HWRU 将回退到使用其内部温度传感器；30 秒的值似乎工作得很好。请参见 Sensor 了解更多信息。
RAS-2819T 型号使用双数据包 IR 协议，大多数命令发送一个主数据包（包含温度、模式和风扇速度），随后是一个次级数据包（包含风扇速度确认和模式特定数据）。单数据包命令用于关闭电源和摆动切换操作。
此气候 IR 组件还已知可以与 Midea MAP14HS1TBL 型号一起工作，并且可能与其他类似型号一起工作。（Midea 收购了 Toshiba 的产品线并重新品牌化。）

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

`whirlpool`

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

`whynter`

use_fahrenheit (可选，布尔值)：允许你将温度以华氏度传输到空调。空调显示屏也会以华氏度显示温度。默认为 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 (必填，字符串)：选择 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 (必填，字符串)：当空调的水平方向未设置为摆动时的默认值。可选值：left、mleft、middle、mright、right、auto
vertical_default (必填，字符串)：当空调的垂直方向未设置为摆动时的默认值。可选值：down、mdown、middle、mup、up、auto
max_temperature (必填，浮点数)：空调支持设置的最高温度。
min_temperature (必填，浮点数)：空调支持设置的最低温度。
sensor (可选，ID)：用于测量环境温度的传感器。

NOTE

heatpumpir 中的 greeyac 协议支持一个 Gree 称之为 “I-Feel” 的功能。手持遥控器内置温度传感器，它会定期将此传感器的温度传输到空调。如果在此型号的配置中提供了 sensor，传感器的温度将以与原装遥控器相同的方式传输到 greeyac 设备。温度传输的频率由分配给 sensor 的 update_interval 决定。注意 update_interval 必须少于 10 分钟，否则 greeyac 设备将回退到使用其内部温度传感器；2 分钟的值似乎工作得很好。请参见 Sensor 了解更多信息。

IR 遥控气候设备

配置变量

高级选项

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`