Sensibo RTI Driver v2-04

Overview

The Sensibo RTI Driver enables control of up to 8 Sensibo smart AC units (Sky, Air, and Air Pro models) via the Sensibo Cloud API. This driver provides complete control over air conditioning operations including power, mode, fan speed, temperature setpoint, swing mode, and Climate React automation.

Features

Multi-unit support - control up to 8 Sensibo pods from a single driver

Selected Unit feature - set a default active unit for quick control

Per-unit system variables with numeric suffixes (_1, _2, etc.)

Control power (on/off/toggle)

Set AC mode (cool, heat, auto, dry, fan)

Adjust fan speed (auto, low, medium, high)

Control swing mode

Set temperature setpoint

Monitor room temperature and humidity per unit

Enable/disable Climate React automation

Automatic polling for status updates

Event-driven feedback for UI updates

Setup Instructions

Step 1: Obtain API Key

1. Log in to your Sensibo account at https://home.sensibo.com

2. Navigate to https://home.sensibo.com/me/api

3. Copy your API key (it will look like a long string of letters and numbers)

Step 2: Configure Driver in Integration Designer

1. Add the Sensibo driver to your RTI project

2. Open the driver configuration settings

3. Enter your API key in the "API Key" field

4. Set "Unit Count" to the number of Sensibo units you want to control (1-8)

5. For each unit, enter the room name exactly as shown in the Sensibo app

- Unit 1 can be left blank to auto-detect the first pod found

- Units 2-8 must have room names to match the correct pod

6. Set your preferred temperature unit (Celsius or Fahrenheit)

7. Adjust poll interval if desired (minimum 60 seconds, default 90 seconds)

Step 3: Test Connection

1. Upload the configuration to your RTI processor

2. Check the "Connection_Status" variable - it should show "Connected"

3. Verify that "Pod_Name_1", "Pod_Name_2" etc. display your Sensibo device names

Multi-Unit Setup

How It Works

A single API key discovers all pods on your Sensibo account. The driver matches each configured unit to a pod by room name. Each function includes a Unit parameter to target a specific pod.

Selected Unit

Every function defaults to "Selected Unit" (value 0) which targets the currently active unit. Use the Select_Unit function to change which unit is active. This is useful for UIs where you want to control one unit at a time without specifying a unit number on every command.

The Selected Unit's state is mirrored to "Sel" prefixed variables (SelPower, SelMode, SelFan, etc.) which automatically update when the selected unit changes or when that unit's state is polled.

Direct Unit Targeting

You can also target a specific unit directly by choosing Unit 1-8 in the function parameter. This bypasses the Selected Unit and always controls that specific pod.

Configuration Settings

Licence Key

Enter your licence key for unlimited use. Without a licence key, the driver operates in trial mode for 2 hours.

API Key(Required)

Your Sensibo API key obtained from https://home.sensibo.com/me/api. This is required for the driver to communicate with your Sensibo devices.

Unit Count

Number of Sensibo units to control (1-8). Additional unit configuration categories appear when you increase this value.

Room Name(Per Unit)

The name of the room as shown in the Sensibo app. Unit 1 can be left blank to auto-detect the first pod. Units 2-8 require a room name to identify the correct pod.

Poll Interval

How often (in seconds) the driver polls the Sensibo API for status updates. Minimum value is 60 seconds, default is 90 seconds. Lower values provide more responsive updates but increase API usage.

Temperature Unit

Choose between Celsius (C) or Fahrenheit (F) for temperature display and control.

Enable Debug Logging

When enabled, the driver outputs detailed diagnostic information to RTI TraceView. Use this for troubleshooting connection or control issues.

System Functions

All functions include a Unit parameter. Default is "Selected Unit" (0). Choose Unit 1-8 to target a specific pod.

Unit Selection

Select_Unit(Unit) - Set the active unit for "Selected Unit" operations

Power Control

Power_On(Unit) - Turn the AC unit on

Power_Off(Unit) - Turn the AC unit off

Power_Toggle(Unit) - Toggle power state

Mode Control

Mode_Cool(Unit) - Set to cooling mode

Mode_Heat(Unit) - Set to heating mode

Mode_Auto(Unit) - Set to automatic mode

Mode_Dry(Unit) - Set to dehumidify mode

Mode_Fan(Unit) - Set to fan only mode

Mode_Cycle(Unit) - Cycle through available modes

Fan Control

Fan_Auto(Unit) - Set fan to automatic speed

Fan_Low(Unit) - Set fan to low speed

Fan_Medium(Unit) - Set fan to medium speed

Fan_High(Unit) - Set fan to high speed

Fan_Cycle(Unit) - Cycle through available fan speeds

Swing Control

Swing_On(Unit) - Start swing movement

Swing_Off(Unit) - Stop swing movement

Swing_Toggle(Unit) - Toggle swing state

Temperature Control

Setpoint_Up(Unit) - Increase temperature setpoint by 1 degree

Setpoint_Down(Unit) - Decrease temperature setpoint by 1 degree

Set_Temperature(Unit, Temperature) - Set specific temperature setpoint

Climate React Control

Climate_React_On(Unit) - Enable Climate React automation

Climate_React_Off(Unit) - Disable Climate React automation

Climate_React_Toggle(Unit) - Toggle Climate React state

System Control

Refresh - Force immediate status update for all units

System Variables

Variables use numeric suffixes for per-unit state (_1, _2, etc.) and "Sel" prefix for the selected unit.

Connection Status(Global)

Connection_Status - Text status ("Connected", "Disconnected", "Connecting")

Connection_IsConnected - Boolean connection state

Selected Unit(Mirrors active unit)

SelectedUnitName - Name of the currently selected unit

SelectedUnitIndex - Index of the currently selected unit (1-8)

SelPower, SelIsOn, SelMode, SelFan, SelSwing, SelSetpoint, etc.

Per-Unit Variables(suffix _1 through _8)

Pod_Name_N - Name of the Sensibo pod

Pod_ID_N - Unique identifier for the pod

Power_N - Text power state ("On", "Off")

IsOn_N - Boolean power state

Mode_N - Current mode (cool, heat, auto, dry, fan)

ModeIsCool_N, ModeIsHeat_N, ModeIsAuto_N, ModeIsDry_N, ModeIsFan_N - Boolean mode indicators

Fan_N - Current fan level (auto, low, medium, high)

FanIsAuto_N, FanIsLow_N, FanIsMedium_N, FanIsHigh_N - Boolean fan indicators

Swing_N - Current swing mode

SwingIsMoving_N - Boolean swing state

Setpoint_N - Target temperature setpoint

TempUnit_N - Temperature unit (C or F)

Temperature_N - Current room temperature

Humidity_N - Current room humidity

StatusText_N - Combined status string for display

ClimateReactEnabled_N - Boolean Climate React state

AvailableModes_N, AvailableFanLevels_N, AvailableSwingModes_N - Capability lists

SetpointMin_N, SetpointMax_N - Temperature range

System Events

Events are global - check per-unit variables to determine which unit changed.

OnPowerChanged - Fired when any unit's power state changes

OnModeChanged - Fired when any unit's AC mode changes

OnFanChanged - Fired when any unit's fan level changes

OnSetpointChanged - Fired when any unit's target temperature changes

OnTemperatureChanged - Fired when any unit's room temperature changes

OnHumidityChanged - Fired when any unit's room humidity changes

OnSwingChanged - Fired when any unit's swing mode changes

OnConnected - Fired when connection to Sensibo API is established

OnDisconnected - Fired when connection to Sensibo API is lost

OnPodDiscovered - Fired when Sensibo pods are found

OnError - Fired when an error occurs

OnClimateReactChanged - Fired when any unit's Climate React state changes

TRIAL_EXPIRED - Fired when trial period ends

Licensing

This driver is sold through the Smart Home Programming Driver Store.

Driver Store: https://shpdrivers.services/store/

Your Account: https://shpdrivers.services/store/account.html

Free Trial:

The driver operates in a 2-hour trial mode without a licence key. The trial provides full functionality and resets each time the RTI processor is rebooted.

To Purchase:

1. Create an account at https://shpdrivers.services/store/

2. Add this driver to your cart

3. Enter your RTI processor MAC address during checkout

4. Complete payment and receive your licence key by email

5. Enter the licence key in the driver configuration

Troubleshooting

Connection Issues

1. Verify API key is correct (no extra spaces)

2. Check network connectivity from RTI processor

3. Enable debug logging to see detailed connection attempts

4. Verify Sensibo cloud service is operational

Commands Not Working

1. Check Connection_Status variable shows "Connected"

2. Verify room names match exactly (case-insensitive)

3. Enable debug logging to see command execution

4. Check if trial period has expired (Licence_Status variable)

Unit Not Found

1. Ensure the room name in config matches the name shown in the Sensibo app

2. Room name matching is case-insensitive

3. Check TraceView logs for "No pod found for unit N" messages

4. Verify the Sensibo pod is online in the Sensibo app

Temperature Not Updating

1. Increase poll interval if rate limiting occurs

2. Verify Sensibo pod has active sensors

3. Check for API errors in debug logs

API Rate Limits

Sensibo's API has rate limits. The default poll interval of 90 seconds is designed to stay well within these limits. With multiple units, all pods are polled in each cycle. If you experience issues, increase the poll interval.

Support

For bug reports, technical support, or feature requests, please use the ticket system in your account at the Driver Store.

Store: https://shpdrivers.services/store/

Email: david@smarthomeprogramming.com.au

Compatibility

RTI XP-8 Processor

RTI Software Version 11.4 or higher

Sensibo Sky, Air, and Air Pro devices

Note: This driver requires an active internet connection and a valid Sensibo account. The driver communicates with Sensibo's cloud service - local network access to the Sensibo pod is not required.

Terms of Service

All drivers are provided "as is" without warranty of any kind. You use this software entirely at your own risk. A free trial is included so you can verify compatibility with your system before purchasing. Do not purchase a licence if you have not tested the driver on your hardware. For full terms including warranty disclaimer, limitation of liability, and refund policy, visit:

https://smarthomeprogramming.com.au/store/terms.html

Copyright 2026 Smart Home Programming. All rights reserved.