Gree Infrared
The Gree Infrared integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] lets you control a compatible Gree air conditioner using any infrared emitter previously configured in Home Assistant. It can also keep the climate entity in sync when you have an infrared receiver set up, so the entity follows along when you use the physical Gree remote.
Because the integration communicates over infrared, it operates in a one-way, fire-and-forget fashion: commands are sent to the air conditioner but there is no feedback channel to confirm the current state. The integration therefore uses assumed states. It remembers the last known state and restores it after a restart.
Supported devices
The integration supports compatible Gree air conditioners that can be controlled via the standard Gree air conditioner infrared protocol.
Gree manufactures air conditioners sold under many brand names. Units branded Onida, Sinclair, and others use the same infrared protocol and work with this integration.
Prerequisites
This integration requires an infrared remote adapter (proxy) that is already set up in Home Assistant and provides an infrared entityAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more]. To find integrations that provide infrared entities, browse the Infrared category.
Configuration
To add the Gree Infrared device to your Home Assistant instance, use this My button:
If the above My button doesn’t work, you can also perform the following steps manually:
-
Browse to your Home Assistant instance.
-
In the bottom right corner, select the
Add Integration button. -
From the list, select Gree Infrared.
-
Follow the instructions on screen to complete the setup.
The infrared emitter entity to use for sending commands to your air conditioner. This must be an entity provided by a hardware integration (such as ESPHome) that has already been set up with an IR emitter. It is required.
The infrared receiver entity to use for receiving commands from your Gree remote. This must be an entity provided by a hardware integration (such as ESPHome) that has already been set up with an IR receiver. It is optional and keeps the climate entity in sync with the physical remote.
The operating modes your air conditioner supports. Select at least one of Cool, Heat, Dry, Fan only, and Auto. Check your remote or the manual of your unit to see which modes it has. Not all Gree models support heat. Selecting a mode your unit does not have breaks nothing. Your air conditioner simply does not respond to it.
Supported functionality
A climate entity is created for each Gree air conditioner device you set up.
-
Gree AC
- Description: Represents the Gree air conditioner and allows you to control it using infrared commands.
- Supported features: Set HVAC mode, set target temperature, and set fan mode.
Supported modes
The climate entity offers the modes you selected during setup, in addition to Off.
- Cool: Cools to a set temperature.
- Heat: Heats to a set temperature. Not all Gree air conditioner models have it.
- Dry: Dehumidify mode.
- Fan only: Fan circulation without heating or cooling.
- Auto: The unit chooses between heating and cooling automatically.
Fan speeds
- Auto: The unit selects the speed automatically.
- Low: Low fan speed.
- Medium: Medium fan speed.
- High: High fan speed.
Temperature range
Supported range: 16 °C to 30 °C in 1 °C steps.
Physical remote state tracking
If you also have an infrared receiver entity (from an IR blaster that can also listen), you can optionally select it during setup. When selected, the integration decodes signals from the physical Gree air conditioner remote and updates the climate entity to match, so the mode, fan speed, and target temperature stay in sync.
Known limitations
- The climate entity for the air conditioner uses assumed state. Home Assistant cannot verify the actual state of the unit and instead tracks the last known state.
- Even with physical remote state tracking enabled, the receiver reports what the remote sent, not what the unit is actually doing, so the two can still drift apart, for example if something blocks the line of sight.
- Changing the target temperature or the fan speed while the air conditioner is off is remembered rather than sent. It is applied with the next command that turns the unit on.
- With physical remote state tracking, commands from the remote for a mode you did not select during setup are ignored, so the entity does not switch to a mode it cannot control.
Troubleshooting
The climate entity does not update when I use the physical remote
If you use an ESPHome remote_receiver as your infrared receiver and the climate state does not update when you press buttons on the physical Gree remote, the receiver is probably splitting each command into two signals it cannot decode.
The Gree protocol sends each command as two IR frames separated by a gap of about 20.1 ms. The ESPHome remote_receiver component defaults to an idle timeout of 10 ms, which treats that gap as the end of a transmission and breaks the command into two separate signals.
To fix this, in your existing ESPHome remote_receiver configuration, set idle to about 25ms so both frames are captured as a single signal:
remote_receiver:
idle: 25ms
Removing the integration
This integration follows standard integration removal.
To remove an integration instance from Home Assistant
- Go to Settings > Devices & services and select the integration card.
- From the list of devices, select the integration instance you want to remove.
- Next to the entry, select the three dots
menu. Then, select Delete.