This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Local network integration

Use your local area network (LAN) to integrate with an iZone system.

1 - Discovery

Make requests to discover local iZone devices.

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

Make requests to query local iZone device states.

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

Make requests to control local iZone device.

Control Local Device Command

HTTP Request.

POST http://[bridge_IPAddr]/iZoneCommandV2

Request Body JSON:

{
  "SysOn":type_syson
}

where:

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

Latest released documents & testing 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.

iZone API Document v1