Mitsubishi Electric RTI Driver v1-02

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

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, 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

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

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 Debug Logging

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

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.