This is the multi-page printable view of this section. Click here to print.
Local network integration
- 1: Discovery
- 2: Query
- 3: Control
- 4: Documents & Tools
1 - Discovery
Discover Local Device Command
Send IASD
to UDP Broadcast 255.255.255.255:12107
An expected iZone bridge response would be like ASPort_12107,Mac_[bridge_ID],IP_[bridge_IPAddr],...
If the response is:
- ASPort_12107,Mac_xxxxxxxxx,IP_xxx.xxx.xxx.xxx
- ASPort_12107,Mac_xxxxxxxxx,IP_xxx.xxx.xxx.xxx,iZone, …
Then this device only supports the original API, which is described in this document
If the response is:
- ASPort_12107,Mac_xxxxxxxxx,IP_xxx.xxx.xxx.xxx,iZoneV2, …
Then this device also supprts the new API, described below. The support for the original API is maintained.
Example response:
ASPort_12107,Mac_XXXXXXXXX,IP_xxx.xxx.xxx.xxx,iZoneV2,iLight,iDrate,iPower,Split
Where:
- XXXXXXXXXX - is a 9-digit unique system ID number
- iZone - iZone air con support API v1 (described in in this document)
- iZoneV2 - iZone air con support API v2
- iLight - lighting system, garage doors etc
- iDrate - irrigation system,
- iPower - monitoring system (power, air quality, solar diverter)
- Split - split system air con
If a device does not support one of the above systems, the corresponding string will be replaced by “X” or missing
2 - Query
Query Local Device States Command
HTTP Request.
POST http://[bridge_IPAddr]/iZoneRequestV2
Request Body JSON:
{
"iZoneV2Request": {
"Type": 1,
"No": 0,
"No1": 0
}
}
An example of response would be like:
{
"AirStreamDeviceUId": string_deviceID,
"DeviceType": "ASH",
"SystemV2": datagram_systemsettings
}
where:
- string_deviceID is 9-digits bridgeID get in discovery
- datagram_systemsetting is datagram of an iZone device.
Refer to Reference the detail datagram of different types of iZone components.
3 - Control
Control Local Device Command
HTTP Request.
POST http://[bridge_IPAddr]/iZoneCommandV2
Request Body JSON:
{
"SysOn":type_syson
}
where:
- type_syson is target value of command.
An expected response would be like:
OK
Refer to Reference the detail control actions dictionary of different types of iZone device control.
4 - Documents & Tools
iZone API Document v2
iZone Local API Test Example
- Import this test example script iZoneExample.postman.json to Postman API Tools. Change IP address to your own testing system’s IP before start testing.