MaxAir HVAC Controller Driver

Version: 1.35

Manufacturer: MaxAir

Overview

This driver gives full two-way control of a MaxAir HVAC system from an RTI panel: view zone temperatures, turn zones on/off, adjust setpoints, boost, and monitor boiler, frost, and outside-air status.

What's New in v1.35

Outside temperature source (local sensor vs. internet weather feed) is now selected in the MaxAir app itself, not in this driver's configuration.

Two new read-only status variables, Winter Active and Home Active, mirror Summer Active and Away Active for direct use in button and icon logic (added in v1.34).

Fixed: Summer Active / Winter Active and the Summer On / Summer Off events now initialise correctly on driver restart, matching the existing behaviour already used for Away and Boiler status.

CONFIGURATION

Network Connection

Network Address - IP address of the MaxAir controller. Default 192.168.0.100.

Network Port - Default 80.

Poll Interval (seconds) - How often the driver refreshes status. Minimum 10, default 30.

Request Timeout (ms) - How long to wait for a response before treating it as failed. Default 8000.

Temperature Control

Temperature Step - Amount each Up/Down press changes the setpoint. Choices: 0.5C, 1.0C, 2.0C.

Minimum / Maximum Temperature - The allowed setpoint range.

Zone Names

Enter each zone name exactly as it's configured in the MaxAir system. This name is used to match the zone and automatically labels all its variables, buttons, and events in Integration Designer. Leave unused zones blank. Up to 16 zones are supported.

Debug (hidden)

Enable Debug Logging - Reveal this via TraceViewer if you need to troubleshoot communication with the controller. Off by default.

WHAT THIS DRIVER EXPOSES

For each configured zone, the driver provides: on/off state, boost, current temperature, target setpoint, and today's min/max. System-wide, it provides boiler status, system mode (Off / Timer / CE / HW / Both), away mode, summer mode, frost control, and outside air conditions.

All variables, functions, and events are listed with plain-language descriptions directly in Integration Designer, and are automatically named using the zone names you configure.

TROUBLESHOOTING

Driver appears unresponsive

Check the comm status variable. If it shows a loss of communication, verify the Network Address and Port and that the MaxAir controller is reachable. The driver retries automatically and recovers once the controller responds again.

Wrong driver version active after deploy

The driver prints its version to TraceViewer on startup. If it doesn't match this help file, force a system file refresh in Integration Designer and re-deploy.

Outside temperature not updating

Source selection happens in the MaxAir app, not this driver. If readings are stale, check the source and sensor/weather-feed health there.

Zone variables/functions not appearing

Zone names must exactly match the names configured on the MaxAir controller (case- and space-sensitive). A zone left blank in configuration will have its variables, functions, and events hidden.

Debug logging

Reveal the hidden Debug category in Integration Designer, enable it, and watch TraceViewer for full request/response detail.