The Cielo integration is in beta. To enable it for your workspaces, contact Seam support.
Overview
Cielo makes smart controllers for heating and cooling systems. The Cielo Breez range adds remote control to mini-split, window, and portable air conditioners and heat pumps, using the same infrared signals as the unit’s own remote control. The Cielo Smart Thermostat replaces a wall thermostat for central heating and cooling. Seam represents each Cielo device that heats or cools as a thermostat. You can set the device to heat, cool, or off, set heat-cool mode on a Cielo Smart Thermostat, and read the room temperature and humidity.Supported Devices
This integration supports Cielo devices that control heating or cooling: the Cielo Breez air conditioner controllers and the Cielo Smart Thermostat. Seam reports a Breez controller as a Cielo Breez device and a Smart Thermostat as a Cielo Thermostat device. Both have thecielo_thermostat device type.
A Cielo device that controls a fan-only unit has no heating or cooling mode, so it doesn’t appear in Seam.
Supported Features
We support the following features:- Configuring current thermostat settings: heat, cool, and off, plus heat-cool on Cielo Smart Thermostats
- Creating and managing climate presets
- Creating and managing thermostat schedules
- Reading the room temperature and relative humidity
can_hvac_heat, can_hvac_cool, and can_hvac_heat_cool capability flags. For more information, see Thermostat Capabilities.
Brand-Specific Restrictions
Note the following Cielo-specific restrictions:API Keys
Your users connect Cielo to Seam with an API key that they create at home.cielowigle.com. Cielo lets each key connect to only one app, and a Cielo account can create only a few keys in a 30-day period. If a key was already used anywhere else, including an earlier attempt to connect it to Seam, the user must create a new key. For details, see the Cielo Setup Guide.Heat-Cool Mode
Only the Cielo Smart Thermostat supportsheat_cool mode through Seam, with separate heating and cooling set points. A Breez controller’s automatic mode uses a single target temperature, so Seam doesn’t offer heat_cool for Breez devices, and can_hvac_heat_cool isn’t set.
If someone sets a Breez device to automatic mode in the Cielo app, Seam reports hvac_mode_setting as heat_cool with the heating and cooling set points both equal to that target temperature.
Settings on Breez Devices Are Sent, Not Confirmed
A Breez controller sends one-way infrared signals to the air conditioner. The air conditioner doesn’t report back, so thecurrent_climate_setting that Seam reports for a Breez device is the last setting sent, not a reading from the unit. For commands to arrive, the Breez controller needs a clear line of sight to the air conditioner’s infrared receiver.
Set Points
Each Cielo device accepts a fixed list of set points for each mode, usually whole degrees in the unit that the device is set to. Seam converts your Celsius or Fahrenheit set point and rounds it to the nearest value that the device accepts. Seam rejects a set point outside the device’s range with aheating_set_point_out_of_range or cooling_set_point_out_of_range error. Seam reports the range on the device as min_heating_set_point_celsius, max_heating_set_point_celsius, min_cooling_set_point_celsius, and max_cooling_set_point_celsius (or _fahrenheit).
Cielo Presets and Fan Modes
Seam doesn’t expose the presets that users create in the Cielo app. When Seam changes a set point, the device leaves any active Cielo preset, as it does when someone changes the set point in the Cielo app. To save and schedule settings, use Seam climate presets. Seam doesn’t support setting the fan mode on Cielo devices. Seam also doesn’t represent a Breez device’s dry and fan-only modes. If someone selects one of these modes in the Cielo app, Seam continues to report the last heat, cool, or off setting.Weekly Programs
Seam doesn’t support thermostat weekly programs on Cielo devices. Use thermostat schedules instead.Offline Devices
When Cielo reports that a device is offline, Seam marks the device offline and rejects commands to it until it reconnects.Update Frequency
Cielo doesn’t send webhooks, so Seam reads each Cielo account every 5 minutes. A change made in the Cielo app or on the device can take that long to appear in Seam.Device Provider Key
Seam identifies these devices with thecielo device provider key. To show only Cielo in a Connect Webview, include cielo in the accepted_providers list. For more information, see Customize the Brands to Display in Your Connect Webviews.