ME_CN105_ATA_WIFI – HTTP API & MQTT Topics

Home Automation Integration #

The ClimateControl module is designed for flexibility, offering native support for various platforms via MQTT and a HTTP REST API.

• Home Assistant: Experience seamless “plug-and-play” integration using the built-in Auto Discovery feature.
• Homey: Use the community developed ClimateControl app from the Homey app store.
• Other systems: The module is widely used with systems including Loxone, Nodered and other custom automation platforms. For these platforms, use either MQTT or HTTP REST API for communication.

Remote room temperature reference

The ClimateControl accepts an external temperature as room temperature reference. This can be set through the various interfaces. Make sure to set this value every 5 seconds. As a safety measure, when no external temperature has been received for some time, the ClimateControl will fall back to the wireless temperature sensor directly connected to the ClimateControl. If no wireless sensor is available, the airconditioner will start using its own internal sensor as temperature reference.

MQTT Client

ClimateControl functions as a MQTT client and requires a connection to an MQTT broker (such as Mosquitto).

• Compatibility: Supports both MQTT v5 and v3.1.1.
• Setup: Enter your broker’s URL, port and credentials via the local web interface.
• Security Note: Secure MQTT (TLS/SSL) is currently not supported.
• Topic Base: /climacontrol/HVAC_XXXXXX
• Retain: topic retain flag is enabled

Note: While alle possible commands are listed below, some might not be available on your unit.

MQTT Command Reference

Reading
Settings and status can be read from the base topic + specific topic.
For example: /climacontrol/HVAC_XXXXXX/heatpump/power

Writing
Settings can be changed using the base topic + specific topic + set.
For example: /climacontrol/HVAC_XXXXXX/heatpumpt/power/set -> on

Controls

Status / Sensors

HTTP REST API

For direct control and status monitoring, you can interface with the module via standard HTTP requests.

• Status Inquiry: Perform a GET request to: http://heatpump.local/control
• Response: Returns a JSON string containing module, heat pump, and sensor telemetry.

HTTP Command Reference