FoR SMartServer 3.3 and prior releases, the LOCATIONS widget is called the Map Widget.
Info |
---|
For SmartServer 3.4 - 3.6 releases, see Defining Contexts (Release 3.4 - 3.6). For SmartServer 3.3 and prior releases, see Defining Contexts (Release 3.3 and Prior). |
You can create contexts to organize devices within the SmartServer IoT to mirror their locations within the physical site to facilitate effective system planning and navigation. A context is a digital representation of a real world region, area, or space. You will use the CMS Planning widget (introduced in SmartServer 2.8) to view, create, organize, edit, and delete contexts. Other CMS widgets use the context information to organize your devices by the contexts you define. For example, you can organize sequence of operations, dashboards, and connections by contexts. See the SmartServer IoT Node-RED Tutorial for a getting started tutorial on creating a sequence of operation and applying it to a context within the system.
For each context you create, you select a context type which can be a region, campus, building, floor, room, or area. A campus may be a region, such as Northern California, a site such as the Olympic Village, or a campus such as the University of California. An area may, for example, be an area in a campus, such as a parking lot or street, or an area on a floor such as a VAV zone. An area can also be created within a region. You can associate other system entities such as datapoints, devices and users with these contexts to provide a physical location reference to these entities. For example, you can use contexts to identify select specific devices or user interfaces such as the following:
...
- Id – identifier used to build the context hierarchy (e.g., floor in Parent Id contains the value of the building id, building refers to campus, and campus refers to world).
- Name – name of the context.
- Description – (optional) description of the context.
- Image – (optional) image file.
- Image Type – if an image file is supplied, then this column defines the file type.
- True North Angle – (optional) specifies true north angle - project north angle. That is, if the project north angle is oriented straight up, and with that orientation true north is 90 degrees, then the angle to true north is 90 (90 - 0). The default true north angle is 0 degrees. This value may be fractional. For the building context, this field is not used for calculations.
- Image Latitude / Image Longitude – (optional) defined the real-world location of the base point in latitude and longitude coordinates. For the building context, this field is not used for calculations.
- Base Point X / Base Point Y – (optional) reference for measuring distances and positioning contexts and devices in relation to the drawing. The base point is specified as the pixel x,y coordinates of the starting point of the drawing coordinate system. The default base point is 0, 0 representing the upper-left point, which is the first point in the image. For the building context, this field is not used for calculations.
- Drawing Scale – (optional) specifies the number of pixels per linear meter (number of pixels / linear meters). The default is 3 pixels per meter. This value may be fractional. For the building context, this field is not used for calculations.
- Location – (optional) defines the points of the context polygon. For a room and area on a floor, it is represented by x, y points on a drawing. For all other context types, it is represented by latitude and longitude.
- Type – defines the type of context (e.g., world, region, campus, building, floor, room, or area).
- Enabled – defines context availability. Devices cannot be assigned to disabled contexts. Currently, all the contexts enabled by default and are not configurable.
- Custom Fields – (optional) tag/value pairs. There are two reserved tags:
- color – for the color of rooms and areas on floors
- floor number – for floors
- Parent Id – identifier used to build the context hierarchy (e.g., floor in Parent Id contains the value of the building id, building refers to campus, and campus refers to world).
...