1# zones.json
2
3Zones are groups of fans that are set to the same values and have the same
4properties like `default_floor` and `poweron_target`. The events in
5[events.json](events.md) are then configured to operate on specific or all
6zones.
7
8## JSON Example
9
10```json
11{
12  "name": "0",
13  "poweron_target": 18000,
14  "default_floor": 18000,
15  "increase_delay": 5,
16  "decrease_interval": 30
17}
18```
19
20## Attributes
21
22### name
23
24The zone name. Required.
25
26### poweron_target
27
28The fan target value set immediately after the power state changes to on. This
29is also the ceiling unless `default_ceiling` is specified. Required.
30
31### default_floor
32
33The default fan floor value to use for the zone, if necessary. Possibly an
34action will be configured to be in charge of the floor so this isn't necessary.
35Optional.
36
37### increase_delay
38
39This throttles fan increases to the specified delay.
40
41The delay, in seconds, between fan target increases, when an action such as
42NetTargetIncrease requests an increase. All increases requested inside of this
43interval are analyzed and if the highest requested target is greater than the
44current target, this new target is set when the delay expires.
45
46Some actions may set the fan target directly, such as one that increases the
47target when a fan is removed, and this does not apply then.
48
49Optional with a default of zero, meaning increases are immediately requested.
50
51### decrease_interval
52
53This throttles fan decreases to the specified delay.
54
55The delay, in seconds, between fan target decreases, when an action such as
56NetTargetDecrease requests a decrease. All increases and decreases requested
57inside of this interval are analyzed and if the highest requested target is
58lower than the current target, this new target is set when the delay expires.
59
60Optional with a default of zero, meaning decreases are immediately requested.
61
62### default_ceiling
63
64The ceiling of the zone, i.e. the highest target that can be set.
65
66This is optional and if not specified it defaults to the `poweron_target` value.
67