Mitsubishi Electric RTI Driver v1-13

Overview

The Mitsubishi Electric RTI Driver enables local network control of up to 8 Mitsubishi Electric air conditioning units via the ECHONET Lite protocol. This driver communicates directly with the AC unit's WiFi interface (MAC-578/568/588) over your local network - no cloud service or internet connection required.

Features

Local control via ECHONET Lite protocol (no cloud dependency)

Multi-unit support - control up to 8 AC units 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

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/vane 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, 1-5)

Control vertical vane position (auto, swing, positions 1-5)

Set temperature setpoint (16-31 degrees C)

Monitor room temperature per unit

Fault detection and reporting

Automatic polling for status updates

Event-driven feedback for UI updates

Prerequisites

Before using this driver, you must enable ECHONET Lite on your Mitsubishi AC unit:

1. Open the Mitsubishi WiFi Control app on your phone/tablet

2. Select your AC unit

3. Tap Edit Unit (or the settings/pencil icon)

4. Go to Advanced Settings

5. Set "ECHONET Lite" to Yes

6. Note the IP address of the WiFi interface

Important: The AC unit and RTI processor must be on the same local network subnet. A static IP address (via DHCP reservation) is strongly recommended for the AC unit.

Setup Instructions

Step 1: Enable ECHONET Lite

Follow the Prerequisites section above to enable ECHONET Lite on each AC unit you wish to control.

Step 2: Configure Driver in Integration Designer

1. Add the Mitsubishi Electric driver to your RTI project. The Add Workspace Item dialog will show Source Name "Mitsubishi Electric AC" and Type "Climate"

2. Open the driver configuration settings

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

4. For each unit, enter:

- IP Address: The IP address of the AC unit's WiFi interface

- Room Name: A display name for the unit (e.g. "Living Room")

5. Adjust the poll interval if desired (default 10 seconds, range 5-60)

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

7. Enable Debug Logging if troubleshooting is needed

Step 3: Test Connection

1. Upload the configuration to your RTI processor

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

3. Verify room temperature reads back correctly

4. Test Power On/Off to confirm communication is working

5. (Optional) Open http://[processor_ip]:8091/ 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 with prominent ROOM TEMP readout below, mode and fan and vane dropdowns, 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:8091/?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 8091 by default. If port 8091 is already used by another driver on the processor (the Sensibo driver uses 8090, for example), 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 AC unit over local UDP - no external traffic at all.

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, IP address, mode, fan, vane, setpoint, room temperature, fault 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 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

The driver sends ECHONET Lite UDP packets to each AC unit's IP address on port 3610. Each function includes a Unit parameter to target a specific AC unit.

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 AC unit.

Multi-Source Workspace Items

The driver advertises up to 8 source instances. In Integration Designer's Add Workspace Item dialog, select the driver and choose which unit (1-8) the workspace item should auto-bind to. Use this to place a unit-specific Web Object or thermostat template in each room - tagged buttons automatically wire to the correct unit's variables and functions.

Configuration Settings

Licence Key

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

Unit Count

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

Poll Interval (seconds)

How often the driver polls each unit for status updates (5-60 seconds, default 10). Lower values provide faster feedback but increase network traffic.

IP Address(Per Unit)

The IP address of the Mitsubishi AC WiFi interface. Use a static DHCP reservation for reliability.

Room Name(Per Unit)

A display name for the unit (e.g. "Living Room", "Master Bedroom"). This name appears in Integration Designer function parameter lists.

Enable Web Object

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

Web Server Port

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

Enable Debug Logging

When enabled, the driver outputs detailed ECHONET Lite packet data and state changes to RTI TraceView. Use this for troubleshooting.

Debug Console Port

TCP port for the live JS eval console. 0 = disabled (default). Set to e.g. 12516 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 (MitsubishiAPI.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 *", "Mode *", "Fan Spd*") 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 Power - Power Toggle 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 Low - Fan Speed 1 function

Stat Fan Medium - Fan Speed 3 function

Stat Fan High - Fan Speed 5 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 - SelFanIs1 boolean

Stat Fan Medium - SelFanIs3 boolean

Stat Fan High - SelFanIs5 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 (Mitsubishi does not report outdoor; same as indoor)

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.

Note about Fan Speeds

Mitsubishi units support 5 discrete fan speeds. The Stat Fan Low/Medium/High tags map to speeds 1/3/5 to give thermostat templates a 3-position low-medium-high feedback. Fan Speeds 2 and 4 retain their legacy "Fan Spd2" / "Fan Spd4" tags and are available via the Web Object's full picker.

System Functions

All functions include a Unit parameter to target a specific AC unit (1-8).

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 modes (cool > heat > auto > dry > fan)

Fan Control

Fan_Auto(Unit) - Set fan to automatic speed

Fan_1(Unit) through Fan_5(Unit) - Set fan to speed 1-5

Fan_Cycle(Unit) - Cycle through fan speeds (auto > 1 > 2 > 3 > 4 > 5)

Vane Control

Vane_Auto(Unit) - Set vane to automatic position

Vane_Swing(Unit) - Set vane to swing mode

Vane_1(Unit) through Vane_5(Unit) - Set vane to position 1-5

Temperature Control

Setpoint_Up(Unit) - Increase temperature by 1 degree (holdable)

Setpoint_Down(Unit) - Decrease temperature by 1 degree (holdable)

Set_Temperature(Unit, Temperature) - Set specific temperature (16-31)

System Control

Refresh - Force immediate status update for all units

System Variables

Variables use numeric suffixes for per-unit state (_1, _2, etc.).

Connection Status(Global)

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

Connection_IsConnected - Boolean connection state

Licence_Status - Licence state ("Licensed", "Trial", "Expired")

Per-Unit Variables(suffix _1 through _8)

IP_N - IP address of the AC unit

RoomName_N - Display name for the unit

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 speed (auto, 1-5)

FanIsAuto_N, FanIs1_N through FanIs5_N - Boolean fan speed indicators

VaneV_N - Current vane position (auto, swing, 1-5)

Setpoint_N - Target temperature (integer)

Temperature_N - Current room temperature

HasFault_N - Boolean fault status

StatusText_N - Combined status string (e.g. "ON | COOL | 24°C")

System Events

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 speed changes

OnSetpointChanged - Fired when any unit's target temperature changes

OnVaneChanged - Fired when any unit's vane position changes

OnTemperatureChanged - Fired when any unit's room temperature changes

OnConnected - Fired when connection to an AC unit is established

OnDisconnected - Fired when connection to an AC unit is lost

OnError - Fired when a communication error occurs

OnFaultDetected - Fired when the AC unit reports a fault

TRIAL_EXPIRED - Fired when trial period ends

Compatible Hardware

Supported WiFi Interfaces:

MAC-578IF-E (tested)

MAC-568IF-E

MAC-588IF-E

Supported AC Models:

Any Mitsubishi Electric split system with a compatible WiFi interface and ECHONET Lite support, including:

MSZ-AP series

MSZ-EF series

MSZ-GE series

MSZ-GL series

MSZ-LN series

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

No Connection

1. Verify ECHONET Lite is enabled in the Mitsubishi WiFi Control app

2. Check the IP address is correct and reachable from the RTI processor

3. Ensure both devices are on the same subnet

4. Check firewall rules are not blocking UDP port 3610

5. Try power cycling the AC unit's WiFi interface

Commands Not Working

1. Check Connection_Status shows "Connected"

2. Ensure the AC unit is powered on at the isolator

3. Enable debug logging to see ECHONET Lite packet exchange

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

Incorrect Temperature

1. Allow time for the unit to report its initial state

2. Temperature readings are in Celsius only (ECHONET Lite standard)

3. Check for fault status - a faulty sensor may report incorrect values

Multiple Units

Each unit requires its own IP address. Ensure all units have ECHONET Lite enabled individually.

Technical Notes

Protocol: ECHONET Lite over UDP port 3610

Communication: Direct local network, no cloud dependency

Polling: Configurable 5-60 second interval per unit

ECHONET Lite Air Conditioner class: 0x0130

Temperature range: 16-31 degrees C

Fan speeds: Auto + 5 discrete levels

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

Mitsubishi Electric AC units with ECHONET Lite enabled WiFi interface

Note: This driver communicates locally via ECHONET Lite. No internet connection or cloud account is required. The AC unit's WiFi interface must be on the same local network as the RTI processor.

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.