Sensibo RTI Driver v2-44

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. The driver also includes a self-hosted Web Object thermostat UI that can be embedded into any RTI panel page or opened from a phone, tablet, or desktop browser on the local network.

Features

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

Multi-source workspace items - "Add To Existing Driver" lets you place each unit in its own room with auto-wiring tags

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

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

Standard RTI thermostat button tags (Stat *) for template auto-binding

Reversed-state feedback tags so mode/fan buttons highlight when active

Built-in Web Object thermostat UI (no cloud server required)

Half-circle tick-mark arc with cool-to-heat colour gradient

Tap to drag setpoint on the arc; +/- step buttons for fine adjustment

Settings drawer with Status, Device Info, Accent Colour, Background, Shadow Box, Inactive Text

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. The Add Workspace Item dialog will show Source Name "Sensibo" and Type "Climate"

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)

8. (Optional) Configure the Web Object - enable it and choose a port (default 8090)

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

4. (Optional) Open http://[processor_ip]:8090/ in a browser to test the Web Object

Web Object Thermostat UI

The driver hosts a complete thermostat UI directly on the RTI processor - no cloud server required. The UI shows a half-circle tick-mark dial with cool-to-heat colour gradient, draggable temperature setpoint, mode and fan dropdowns, climate-react toggle, and power button.

Web Object URL Format

http://[processor_ip]:[port]/?unit=1 - First configured unit

http://[processor_ip]:[port]/?unit=2 - Second configured unit

http://[processor_ip]:[port]/?unit=N - Nth configured unit

Adding the Web Object in Integration Designer

1. In your RTI page, add a Web Object element

2. Set the URL to http://[processor_ip]:[port]/?unit=1 (replace with your processor's IP address and chosen port, e.g. http://192.168.1.50:8090/?unit=1)

3. Size and position the Web Object as desired

4. Each unit can have its own Web Object element by changing the unit parameter

Default Port

The Web Object server listens on port 8090 by default. If port 8090 is already used by another driver on the processor, change the port in the driver's "Web Server Port" config setting. Common conflicts: TraceView debug ports usually live in 12500-12520.

Local Network Only

The Web Object only accepts connections from the local network. It is not exposed to the internet. The driver itself reaches the Sensibo cloud over HTTPS for state updates - that path is independent of the Web Object.

Settings Drawer (in Web Object)

The Web Object includes a settings drawer for appearance customisation. Tap the room name in the top-left of the UI to open a menu - this lists each configured unit (when more than one) and a Settings entry that opens the drawer. Settings persist per-device in the browser's local storage, so each phone, iPad, or panel can have its own appearance.

Status

Live indicators for connection state and licence state.

Device Info

Read-only details about the unit currently displayed: room name, pod ID, mode, fan, setpoint, room temperature, humidity, climate-react state, poll interval, driver version.

Accent Colour

Highlight colour applied to the dial handle and inactive-state highlights. 11 preset swatches plus a hex input and native colour picker for custom values.

Background

Page background colour, applied as a radial gradient. Use this to make the Web Object blend with the surrounding RTI page background. 11 preset dark swatches plus hex input and native picker.

Shadow Box

Slider 0-100 that adds a vignette overlay around the page edges for depth.

Inactive Text Colour

Colour used for muted labels (SET TEMP, current temp/humidity readout, dropdown labels, range labels). 8 preset muted swatches.

Reset to Defaults

Restores all appearance settings to the original values.

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. These mirror variables are the primary targets for thermostat template binding.

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. Required for cloud communication.

Unit Count

Number of Sensibo units to control (1-8).

Room Name(Per Unit)

The name of the room as shown in the Sensibo app. Unit 1 can be left blank to auto-detect.

Poll Interval

How often (in seconds) the driver polls Sensibo for status updates. Minimum 60s, default 90s.

Temperature Unit

Choose Celsius (C) or Fahrenheit (F).

Enable Web Object

Master switch for the local Web Object server. Default ON.

Web Server Port

TCP port the Web Object listens on (default 8090, valid 1024-65535). Choose a port that isn't used by another RTI driver on the processor.

Enable Debug Logging

Verbose diagnostic output to RTI TraceView. Use for troubleshooting.

Debug Console Port

TCP port for the live JS eval console. 0 = disabled (default). Set to e.g. 12517 to enable, then telnet [processor_ip]:[port] from any LAN machine. Type any JavaScript expression and press Enter to evaluate it in the driver's runtime context. Useful for inspecting state (g_acStates[0]), forcing commands (SensiboAPI.setPower(0,true)), and live debugging without redeploying. WARNING: full eval() access - LAN-only, do not enable on internet-exposed processors.

Standard Thermostat Tags

The driver exports both legacy ("Sel *") and standard RTI thermostat ("Stat *") button tags. When you tag a button with a Stat name in the Tag Editor, IDesign auto-wires the matching function (to the Macro slot) and the matching boolean state variable (to the Reversed slot for active-state feedback).

Function Tags (Macro slot)

Stat Off - Power Off function

Stat Cool - Mode Cool function

Stat Heat - Mode Heat function

Stat Auto - Mode Auto function

Stat Fan On - Mode Fan function (fan-only mode)

Stat Fan Auto - Fan Auto function

Stat Fan Cycle - Fan Cycle function

Stat Setpoint Up - Setpoint Up function (also legacy "Temp Up")

Stat Setpoint Down - Setpoint Down function (also legacy "Temp Down")

Reversed-State Variable Tags (Reversed slot)

Stat Cool - SelModeIsCool boolean - highlights button when cooling

Stat Heat - SelModeIsHeat boolean

Stat Auto - SelModeIsAuto boolean

Stat Dry - SelModeIsDry boolean

Stat Fan On - SelModeIsFan boolean

Stat Fan Auto - SelFanIsAuto boolean

Stat Fan Low - SelFanIsLow boolean

Stat Fan Medium - SelFanIsMedium boolean

Stat Fan High - SelFanIsHigh boolean

Stat Power - SelIsOn boolean (also legacy "Sel Is On")

Text Tags (Variable slot)

Stat Setpoint - SelSetpoint integer

Stat Mode - SelMode text

Stat Operating State - SelMode text

Stat Fan State - SelFan text

Stat Temp In - SelTemperature text (indoor temperature reading)

Stat Temp Out - SelTemperature text (Sensibo does not report outdoor; same as indoor)

Stat Humidity - SelHumidity text

Stat Off Reversed Highlight

There is no dedicated "Power Is Off" boolean. To highlight the Stat Off button when the unit is off, bind SelIsOn to its Reversed slot and tick the Inverted option in the Tag Editor.

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 (Stat Off)

Power_Toggle(Unit) - Toggle power state

Mode Control

Mode_Cool(Unit) - Cool mode (Stat Cool)

Mode_Heat(Unit) - Heat mode (Stat Heat)

Mode_Auto(Unit) - Auto mode (Stat Auto)

Mode_Dry(Unit) - Dehumidify mode

Mode_Fan(Unit) - Fan-only mode (Stat Fan On)

Mode_Cycle(Unit) - Cycle through available modes

Fan Control

Fan_Auto(Unit) - Fan auto (Stat Fan Auto)

Fan_Low(Unit) - Fan low

Fan_Medium(Unit) - Fan medium

Fan_High(Unit) - Fan high

Fan_Cycle(Unit) - Cycle fan speeds (Stat Fan Cycle)

Swing Control

Swing_On(Unit) - Start swing

Swing_Off(Unit) - Stop swing

Swing_Toggle(Unit) - Toggle swing

Temperature Control

Setpoint_Up(Unit) - +1 degree (Stat Setpoint Up)

Setpoint_Down(Unit) - -1 degree (Stat Setpoint Down)

Set_Temperature(Unit, Temperature) - Set specific setpoint

Climate React Control

Climate_React_On(Unit)

Climate_React_Off(Unit)

Climate_React_Toggle(Unit)

System Control

Refresh - Force immediate status update for all units

System Variables

Variables use numeric suffixes for per-unit state (_1 through _8) and "Sel" prefix for the selected unit mirror. Stat * tags listed above bind to the Sel mirror variants.

Connection Status(Global)

Connection_Status - "Connected", "Disconnected", "Connecting"

Connection_IsConnected - Boolean

Selected Unit Mirrors

SelectedUnitName, SelectedUnitIndex

SelPower, SelIsOn, SelMode, SelFan, SelSwing

SelSetpoint, SelTemperature, SelHumidity, SelTempUnit

SelStatusText, SelClimateReactEnabled

SelModeIsCool, SelModeIsHeat, SelModeIsAuto, SelModeIsDry, SelModeIsFan

SelFanIsAuto, SelFanIsLow, SelFanIsMedium, SelFanIsHigh

Per-Unit Variables(suffix _1 through _8)

Pod_Name_N, Pod_ID_N

Power_N, IsOn_N

Mode_N, ModeIsCool_N, ModeIsHeat_N, ModeIsAuto_N, ModeIsDry_N, ModeIsFan_N

Fan_N, FanIsAuto_N, FanIsLow_N, FanIsMedium_N, FanIsHigh_N

Swing_N, SwingIsMoving_N

Setpoint_N, SetpointMin_N, SetpointMax_N, TempUnit_N

Temperature_N, Humidity_N, StatusText_N

ClimateReactEnabled_N

AvailableModes_N, AvailableFanLevels_N, AvailableSwingModes_N

System Events

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

OnPowerChanged - Any unit's power state changes

OnModeChanged - AC mode changes

OnFanChanged - Fan level changes

OnSetpointChanged - Target temperature changes

OnTemperatureChanged - Room temperature changes

OnHumidityChanged - Room humidity changes

OnSwingChanged - Swing mode changes

OnConnected - Sensibo cloud connection established

OnDisconnected - Cloud connection lost

OnPodDiscovered - Pods found and matched to units

OnError - Error during cloud communication

OnClimateReactChanged - Climate React state changes

TRIAL_EXPIRED - 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 to home.sensibo.com

3. Enable debug logging to see detailed connection attempts

4. Verify Sensibo cloud service is operational

Web Object Won't Load

1. Verify the URL matches the processor IP and configured port

2. Confirm "Enable Web Object" is set to true in driver config

3. If you see ERR_INVALID_HTTP_RESPONSE, another driver may be using the same port. Change the Web Server Port to an unused value (try 8091, 12517, 9090)

4. Check the TraceView log for "WebServer: listening on port N" at startup

5. Make sure the device viewing the Web Object is on the same local network

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

Buttons Not Auto-Wiring with Stat Tags

1. Verify the button tag matches the Stat name exactly (case and spacing)

2. Re-tag a button to force IDesign to refresh its bindings

3. Confirm the driver instance is the active source for the button

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 429 errors, 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 over HTTPS - local network access to the Sensibo pod is not required. The Web Object UI is hosted on the RTI processor itself and is reachable from any browser on the same local network.

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.