ATAG One API

Introduction

Get diagnostic data from your ATAG One thermostat controller with just one simple command.

A typical message looks like this:

{
    deviceId: "6808-1401-3109_15-30-001-123",
    latestReportTime: "2015-12-15 13:46:44",
    deviceIP: "10.0.100.50",
    burningHours: 283.91,
    roomTemperature: 19.9,
    outsideTemperature: 4.4,
    dhwSetpoint: 60.0,
    dhwWaterTemperature: 46.8,
    chSetpoint: 42.3,
    chWaterTemperature: 46.6,
    chWaterPressure: 1.6,
    chReturnTemperature: 40.3,
    targetTemperature: 20.0,
    dhwWaterTemp: 46.8,
    dhwWaterPres: 0.0,
    ...
}

Quick start

First, install Java [ Windows / Debian / Raspberry Pi ].

$ sudo apt-get update && sudo apt-get -y install default-jdk

$ sudo apt-get update && sudo apt-get -y install oracle-java8-jdk

When successfully installed, java -version should display something like this:

$ java -version
java version "1.8.0_60"
Java(TM) SE Runtime Environment (build 1.8.0_60-b27)
Java HotSpot(TM) 64-Bit Server VM (build 25.60-b23, mixed mode)

To show diagnostic data of the thermostat found in the local network:

1. Download atag-one.jar from the GitHub Releases page
2. Open a terminal
3. navigate to the Downloads folder
4. Start atag-one.jar without arguments

$ cd ~/Downloads/
$ java -jar atag-one.jar
{
    deviceId: "6808-1401-3109_15-30-001-123",
    latestReportTime: "2015-12-15 13:46:44",
    deviceIP: "10.0.100.50",
    burningHours: 283.91,
    roomTemperature: 19.9,
    outsideTemperature: 4.4,
    dhwSetpoint: 60.0,
    dhwWaterTemperature: 46.8,
    chSetpoint: 42.3,
    chWaterTemperature: 46.6,
    chWaterPressure: 1.6,
    chReturnTemperature: 40.3,
    targetTemperature: 20.0,
    dhwWaterTemp: 46.8,
    dhwWaterPres: 0.0,
    ...
}

Advanced

atag-one.jar has two modes of operation; i.e. Local and Remote.

When in local mode, it finds the thermostat in the local network automatically and connects directly to it. When in remote mode, it connects to the ATAG One portal.

Local Mode

Connect to the ATAG One thermostat on your local network and get diagnostic data:

$ java -jar atag-one.jar

Set the target room temperature to 20.5 degrees celsius:
In case of success the response shows the current room temperature, e.g. 18.6.

$ java -jar atag-one.jar --set 20.5
18.6

Remote Mode

Get diagnostic data via the ATAG One internet portal, using the portal credentials:

$ java -jar atag-one.jar --email user@gmail.com --password p6ssw0rd

Set the target room temperature to 20.5 degrees celsius via the ATAG One internet portal:
In case of success the response shows the current room temperature, e.g. 18.6.

$ java -jar atag-one.jar --email user@gmail.com --password p6ssw0rd --set 20.5
18.6

Support or Contact

Having trouble?
Check the project wiki, Contact me, or file an issue on GitHub.

Disclaimer

All of the trademarks used are the property of their respective owners.
This project is not affiliated with Atag, the manufacturer of the ATAG One thermostat.
The software is provided "as is", without warranty of any kind.