Zones

Zones represent a geographic grouping of resources such as lights and locks.

Zones are configured in the configuration file:

{
    "zones": [
        {"id":"lounge", "name":"Lounge Room", "parent":"living", "temperature":"sensor.lounge-temperature"},
        {"id":"kitchen", "name":"Kitchen", "parent":"living"},
        {"id":"bedroom", "name":"Bedroom"},
        {"id":"living", "name":"Living Area"}
    ]
}

Fields

id

Required

Unique ID or key for this zone.

name

Required

Display name for the zone.

parent

A zone heirarchy will be set up if parents are defined.

Presence in parent zones is controlled by the child zones (presence in 1 or more child zones = presence in parent zone).

temperature

Reference to a value that represents the temperature for this zone.

In the format value_key:field, eg: sensor.hallway:temperature.

humidity

Reference to a value that represents the humidity for this zone.

In the format value_key:field, eg: sensor.hallway:humidity.

luminescence

Reference to a value that represents the luminescence for this zone.

In the format value_key:field, eg: sensor.hallway:luminescence.

Zone Instance Members

Instances of lights, locks, etc can be placed in a zone by setting the zoneId option.

For example:

{
    {class: 'light', id: 'hallway', type: 'hue', options: {zoneId:'hallway', groupId:9, hub:'main'}},
    {class: 'sensor', id: 'hallway', type: 'ninja', options: {zoneId:'hallway', bridge:'main', deviceName:'hallway'}},
}

Presence

Zone presence can be automatically controlled by placing motion or presence sensors in the zone.

If a zone heirarchy is defined, presence is also controlled by child zones.