AirZone local API binding [4.1.0.0;5.0.0.0)

Jetblack31 · September 10, 2023, 2:06pm

So I removed all Airzone Things and binding, rebooted the raspberry.
I reinstalled the binding and the Things. Now it’s ok. No errors.
It seems to work but I still have a problem with the setpoint temperature of the zones.

I make OH create the items and links.

When I go to a setpoint item, the setpoint value is either correct or NaN. When I click + or -, nothing happens on the UI nor on the Airzone System. The value doesn’t change. Sometimes the UI complains : connection error. I see nothing in the logs.
I tried to post a command to the REST API to change the setpoint : it works like a charm. The value change both in the logs and on the Airzone System.
So I don’t understand why I cannot change the setpoint value through the UI and the setpoint item.
Did I miss something ?

Thanks !
Bernard

obones · September 11, 2023, 12:33pm

For the “All zones” item, this is what I get:

It’s quite expected because those items are “write only” and never get an update.
It is, however, impossible to use the + or - buttons here as NaN is not supported by MainUI. There’s nothing that I can do here, unfortunately.

For other zones, this is what I get:

And it works just fine with the buttons.

Note however, that this value is only populated after a refresh cycle, so it’s possible to have the item for a valid zone stay at value NaN for a few seconds after creation. But once it has received an updated value, all should be fine.

In all cases, you have to make sure the item is properly linked to a channel, as it may happen that openHAB “remembers” links from previous things and does not replace them with valid values.
The link should display online as seen here:

Hope this helps

bernardlegrand955 · September 12, 2023, 5:43am

Hello @obones

It’s up and running now! I had to include stateDescription metadata for each setpoint item, with a step value of 0.5.

Big thanks for your binding! I’m all set to use it for managing my system.

One more question: Do you use HomeKit? If so, could you provide guidance on defining Thermostats using the Airzone items?

Kind regards,
Bernard

obones · September 12, 2023, 8:49am

Would you care to show me where you did that?
I’m asking because the channel should already be defined with a step value of 0.5 so maybe I missed something.

I don’t, but this should not be any different than any other HVAC based things already present in openHAB. So maybe there are explanations done with other bindings that would apply here as well.

Jetblack31 · September 12, 2023, 8:55am

Jetblack31 · September 12, 2023, 8:59am

Ok thanks. My concern is how to handle the HVAC mode.

I’ll try to create dummy items for that

Jetblack31 · September 13, 2023, 6:17am

Hi @obones

I have an issue with the all zones Thing. In my case, it is not discovered. I had to manually add it. I configured the Bridge and system number. It goes on line, however it has no channels. Did I miss something ?

EDIT: This wrning is in the logs every 20 sec

2023-09-16 14:51:42.287 [WARN ] [.handler.AirZoneAllZonesThingHandler] - No master zone data for 1

Thanks,
Bernard

obones · September 18, 2023, 8:06am

Ah well, I did not notice it at the time, but your system does not provide the master_zoneID field in its replies.
The “all zone” thing currently relies on it being available for working properly. I’ll see if I can find a workaround.

Jetblack31 · September 18, 2023, 9:10am

Hello @obones

To send a command for allZones (on/off, temperature, mode), using zone 0 works well on my install.
The only information that have to be read is the mode. The mode is indicated in every zone description. So mode can be read from the Zone 1 which is always defined in an installation.

Other option : the master Zone is the one for which the “modes” key is populated by more than 1 value

{
					"systemID":	1,
					"zoneID":	2,
					"name":	"Entr?e",
					"on":	1,
					"maxTemp":	30,
					"minTemp":	24,
					"setpoint":	25,
					"roomTemp":	24.600000381469727,
					**"modes":	[1, 4, 2, 3, 5],**

Jetblack

obones · November 23, 2023, 12:48pm

By any chance, were you able to try out version 0.2.2 posted two months ago?

Jetblack31 · November 23, 2023, 3:45pm

Hello,

Yes indeed, I installed it. Sorry not to have given a feedback yet. So far, it works perfectly !
Thank you so much !
Jetblack

johnpaul · February 25, 2026, 8:41am

Good morning,
This week I wanted to install the Airzone binding, but it doesn’t appear.
Is this a temporary error, or has it been removed from openHAB?
I have several installations with Aidoo, and I’m concerned about having to modify the integration with openHAB.
Kind regards,

obones · February 25, 2026, 9:00am

Which version of openHAB are you using?
If it’s version 5, then this behavior is expected as I have not yet had time to test the plugin with this new version of openHAB.
I’ll add this to my backlog, this should hopefully be sorted by the end of March.

johnpaul · February 25, 2026, 10:11am

My version is openHAB 4.2.2.
I have 10 Raspberry Pi devices with the same version of openHAB, and I have installed it on two of them because I have air conditioners with AIDOO from Airzone.
Now I want to add another AIDOO to openHAB on another Raspberry Pi, but the binding does not appear.

obones · March 16, 2026, 2:58pm

Just in case, I mentioned a new version with OH5 support in the Binding discussion