Hi Scott
Coffee purchased for you. As for the code this is info on the API from the Advantageair documentation:
Important Information
This API is not part of the product purchase and thus comes without any kind of support and without any kind of warranty.
Advantage Air reserve the right to change the API at any time. We will however try and give you advance notice of any changes.
This is the API documentation for the MyPlace system by Advantage Air, this allows third parties to connect and control the airconditioning functions of a MyPlace system within a simple home network.
The Wall Mounted Touch Screen must have the latest versions of the following apps (Apps by Advantage Air) from the Google Play Store:
Android 4 Tablet: AAConfig, AAService and MyPlace.
Android 6 Tablet: TapTap To Wake, AAService and MyPlace.
This API is compatible with MyAir5 and above - after updating the apps as above.
This API does support MyAir+ (up to 4 aircons joined together in one system).
Terminology:
Aircon - one air conditioning unit and associated zones.
Zone - on a ducted aircon a zone is a vent or multiple vents to which the airflow is controlled via a motor.
System - a system is a collection of air conditioners - currently we support up to 4 aircons.
Wall Mounted Touch Screen - the wired android tablet on the wall that controls the system.
1) Connectivity
The Wall Mounted Touch Screen needs to be connected and have a reliable WiFi connection to the router.
We suggest that the router is connected to the internet to allow Google Play Store updates.
2) Discovery
We do not provide a method for discovering the IP address of the Wall Mounted Touch Screen. For the rest of the document we will use 10.0.0.10 as the Wall Mounted Touch Screen IP address.
We suggest that you configure the router to provide the Wall Mounted Touch Screen with a "static" IP address.
3) Read aircon data
Tip: The following commands can be tested using any standard browser.
To get the system data as a single JSON file - use a http GET command on port 2025.
http://10.0.0.10:2025/getSystemData
Here is a heavily edited response to show the relevant data:
{"aircons": { "ac1": { "info": { "constant1":1, - Readonly - Constant zone 1 - the system will decide if this zone needs to be automatically opened to protect the ductwork (0 - disabled) "constant2":2, - Readonly - Constant zone 2 - the system will decide if this zone needs to be automatically opened to protect the ductwork (0 - disabled) "constant3":0, - Readonly - Constant zone 3 - the system will decide if this zone needs to be automatically opened to protect the ductwork (0 - disabled) "countDownToOff": 0, - Number of minutes before the aircon unit switches off (0 - disabled, max 720 minutes) "countDownToOn": 0, - Number of minutes before the aircon unit switches on (0 - disabled, max 720 minutes) "fan": "high", - Fan speed - can be "low", "medium" or "high". Note some aircon units also support "auto". "freshAirStatus": "none", - Fresh Air status - can be set to "on" or "off". Note: not many aircon units have this fitted. "mode": "heat", - Mode - can be "heat", "cool" or "vent". Note some aircon units support "dry". "myZone": 0, - MyZone settings - can be set to any zone that has a temperature sensor (0 - disabled) see Extra information below for more information. "name": "AirconHome", - Name of aircon - max 12 displayed characters "setTemp": 24.0, - Set temperature of the aircon unit (min 16 - max 32) - this will show the MyZone set temperature if a MyZone is set. "state": "on" - Aircon unit state - whether the unit is "on" or "off". }, "zones": { "z01": { "name": "FREEGGVFUX", - Name of zone - max 12 displayed characters "setTemp": 25.0, - Set temperature of the zone (min 16 - max 32) - only valid when Zone type > 0. "state": "open", - State of the zone - can be "open" or "close". Note: that the "type": 0, - Readonly - Zone type - 0 means percentage (use value to change), any other number means it's temperature control, use setTemp. "value": 20 - Percentage value of zone (min 5 - max 100, increments of 5)- only valid when Zone type = 0. } } }},"system":{ "name":"MyPlaceSystem", - Name of system - max 12 displayed characters "needsUpdate":false, - If true, you need to prompt user to update the apps on the Wall Mounted Touch Screen "noOfAircons":1 - Number of aircon units - this can be 0-4.}}
4) Sending a command to a single aircon
Tip: The following commands can be tested using any standard browser.
The set command uses a subset of the JSON structure from the getSystem command. However each command can only target one aircon unit. If you have multiple aircons you will have to send one command message per aircon.
Note: Receive a valid change request, we transmit empty "{}" until the state change is confirmed by our hardware and reflected in the json, this can take up to 4 seconds.
Example aircon unit commands:
To set the first aircon (ac1) state on or off use the following:
http://10.0.0.10:2025/setAircon?json={"ac1":{"info":{"state":"on"}}}http://10.0.0.10:2025/setAircon?json={"ac1":{"info":{"state":"off"}}}
To set the second aircon (ac2) mode to heating (heat) use the following:
http://10.0.0.10:2025/setAircon?json={"ac2":{"info":{"mode":"heat"}}}
You can also combine messages, so to set aircon ac1 to state=on and mode=cool
http://10.0.0.10:2025/setAircon?json={"ac1":{"info":{"state":"on","mode":"cool"}}}
Example zone commands:
To set the first aircon (ac1), second zone (z2) state to open.
http://10.0.0.10:2025/setAircon?json={ac1:{"zones":{"z2":{"state":"open"}}}}
To set the third aircon (ac3), tenth zone (z10) value to 80%.
http://10.0.0.10:2025/setAircon?json={ac1:{"zones":{"z10":{"value":80}}}}
To set the second aircon (ac2), eighth zone (z8) value to 24 degrees.
http://10.0.0.10:2025/setAircon?json={ac2:{"zones":{"z8":{"setTemp":24}}}}
Example aircon unit and zone commands:
For a combination of settings you can use the one command
http://10.0.0.10:2025/setAircon?json={ac1:{"info":{"state":"on","mode":"cool"},"zones":{"z10":{"value":80}}}}}
5) Extra information
i) MyZone - temperature control can be setup by the installer on most units in two modes - MyZone or Return Air mode. Unfortunately you can't change this setting dynamically and each has their own advantages and disadvantages.
{"info": {"myZone": 0}} - Return Air mode the aircon unit makes decisions based on the temperature of the air returning to the unit, so the bias is on the air returning to the Return Air Grill.
{"info": {"myZone": 1-10}} - In MyZone mode the aircon unit makes decisions based on the temperature of the MyZone, the bias is on the MyZone temperature.
If MyZone is enabled, one zone must be set as the MyZone, this zone cannot be closed and is fixed at 100% open all the time. The MyZone can only be set to a zone with a temperature sensor