Essentially, an area represents a named space. For example, a garage is a space named “Garage”. Pretty simple, eh.
An area can contain other areas, as many do. (Areas can contain devices too; that is covered in the Devices section.)
For example, the area named Duplex contains two areas; one named Unit A, the other named Unit B. Each of those areas contain other areas which represent each of the rooms of the unit.
Two areas can have the same name. An example being the names of the areas1 within each unit, e.g. both have a “Master Bedroom” and a “Garage”. When you’re looking at the web page that provides information about that garage, you will know which one it is because the area ‘trail’ (aka, breadcrumbs) shows the area the garage is in, and the area it is in, and so on until the top-level area — Areas — is reached.
Every area is in exactly one other area, with the exception of the top-level area, which is named “Areas”. Areas is not in any other area. It is the top of the hierarchy of all other areas.
Perhaps you can see where this is going. Areas serve to form a hierarchy of named spaces. The names chosen are, hopefully, intuitive.
There are three top-level areas: Duplex, Outside, and External, briefly described below.
Duplex area
The Duplex area, as you might guess, is the concrete building we live in. The duplex has within it unit A and unit B, and inside each unit are rooms, which are also treated as just another named area.
Outside area
The Outside area includes all areas outside the duplex, except any in the Internet area.
External area
The Internet area contains everything related to the internet service
Footnotes
-
No doubt, you think of the areas defined within each unit as rooms. While it makes perfect sense to do so, in the end, a room is really just another named space. Such spaces might be referred to as areas or rooms in this documentation. Either way, you will likely know exactly what is meant from the context in which it is used. ↩