This model is used to characterize each data point, whether it is a measurement, a state, its associated quantity, the position of this point in relation to the equipment and the resource it handles. This data model is standardized and therefore uniform across all implemented Linksper BOS.
This model is made of 5 Definitions. Below the definitions are shown are two combinations as examples:
Common rules:
- Unlike the equipment data model where an asset can be associated with only one equipmentType, a point can be here associated with one Node from several Definitions, creating a combination
- PointType: describes the type of points such as a command, a measure, an effective command....
- Dimension: describes the physical dimension (Temperature) where where a unit can be associated as well as a point purpose (Light On Only...)
- A data point will always be associated with at least a PointType
- Position defines where the data point is located within a system (not its exact position relatively to a building)
- Component is used to describe a subpart of an equipment (The fan of an AHU for example)
Each of the Node can have one or many Qualifiers (also known as SourceTags), they are used to bring additional information to a datapoint and specify a certain pointType or Dimension. For example, one of the most used qualifier is "SetpointType" used with the "Setpoint" pointType. It is an enumeration describing the type of Setpoint: global, occupiedHeating, unoccupiedCooling...
The entire list of Nodes for PointType, Dimension, Position, Resource, Component definitions and their respective qualifiers is available below using a JSON format and can be integrated into a third party application through a script
Point combination examples
Measures and states
Below are listed the most common measures and states found on buildings system and to be executed on a Linksper system. The right columns describe the combination of tags to identify data points.
Comfort & IoT
Description | pointType | dimension | position | component | resource | Additional qualifiers | Units and Enumerations |
Read a zone temperature | Measure | Temperature | Zone | -- | Air | -- | °C |
Read a zone CO2 level | Measure | Concentration | Zone | -- | Air | concentrationType="CO2" | ppm |
Read a zone TVOC level | Measure | Concentration | Zone | -- | Air | concentrationType="TVOC" | µg/m3 |
Read the number of people entering a zone | Measure | Count | Entering | -- | People | -- | |
Read the number of people leaving a zone | Measure | Count | Leaving | -- | People | -- | |
Read the instant number of people in a zone | Measure | Count | Zone | -- | People | -- | |
Read an instant presence of people | State | Presence | Zone | -- | People | false="Unoccupied" ; true="Occupied" | |
Read illuminance (luminosity) of a zone | Measure | Illuminance | Zone | -- | Electricity | ||
Read HVAC Mode (Heating, Cooling...) | Effective Command | HVAC Mode | -- | -- | Air | Site specific enumeration |
HVAC
Description | pointType | dimension | position | component | resource | Additional qualifiers | Units and Enumerations |
Read exhaust flowrate | Measure | Flowrate | Exhaust | Fan | Air | -- | m3/hr |
Read supply fan effective command | Effective Command | Percentage | Exhaust | Fan | Air | -- | % |
Read filter differential pressure default | Default | Boolean | -- | Filter | Air | defaultType="Threshold" | false="Normal" ; true="Default" |
Read filter default | Default | Boolean | -- | Filter | Air | defaultType="Threshold" | false="Normal" ; true="Default" |
Read fresh air temperature | Measure | Temperature | Fresh Air | -- | Air | °C | |
Read exhaust pressure | Measure | Pressure | Exhaust | -- | Air | Pa | |
Read return air temperature | Measure | Temperature | Return | -- | Air | °C |
Metering
Description | pointType | dimension | position | component | resource | Additional qualifiers | Units and Enumerations |
Read active energy index (a value which always increases) for Cooling | Meter | Energy | -- | Electricity | energyType="Active" phaseType="Undefined" electricityType="Three-phase" re2020Usage="Cooling" | kWh | |
Read relative active energy for Cooling | Measure | Energy | -- | Electricity | energyType="Active" phaseType="Undefined" electricityType="Three-phase" re2020Usage="Cooling" | kWh | |
Read active power phase A (or 1) for Lift | Measure | Power | -- | -- | Electricity | powerType="Active" phaseType="A" electricityType="Three-phase" re2020Usage="Lift" | kW |
Read reactive power phase B (or 2) related to Heating | Measure | Power | -- | -- | Electricity | powerType="Reactive" phaseType="B" electricityType="Three-phase" re2020Usage="Heating" | Kvar |
Read current between phase A & B (or 1&2) related to heating | Measure | Current | -- | -- | Electricity | phaseType="AB" electricityType="Three-phase" re2020Usage="Heating" | A |
Read voltage between phase A & B (or 1&2) related to heating | Measure | Voltage | -- | -- | Electricity | phaseType="AB" electricityType="Three-phase" re2020Usage="Heating" | A |
Read water meter volume index | Meter | Volume | -- | -- | Water | waterType="Domestic Cold" | m3 |
Power
Description | pointType | dimension | position | component | resource | Additional qualifiers | Units and Enumerations |
Read a default synthesis of a panel | Default | Boolean | -- | -- | Electricity | defaultType="Synthesis" acquisitionType="Digital Input" | |
Read global switch position of a panel | State | Position | -- | Global Switch | Electricity |
⠀
Commands
Below are listed the most common actions to be executed on a Linksper system. The right columns describe the combination of tags to identify data points.
Units and enumerations can be adapted to the site location and to its systems (these described below are the ones by default). Please read first the data points to learn their effective units on site (by API, on the external database sharing etc.)
Comfort
Action | pointType | dimension | position | component | resource | Additional qualifiers | Units and Enumerations |
Switch on/off a light | Command | Light Control | -- | Light | Electricity | -- | Off / On (false / true) |
Dim a single light | Command | Percentage | -- | Light | Electricity | commandFunction="Dimming" writeRange="Single" | % |
Dim a group of lights under a single command point | Command | Percentage | -- | Light | Electricity | commandFunction="Dimming" writeRange="Group" | % |
Change unoccupied heating temperature setpoint | Setpoint | Temperature | -- | -- | Air | setpointType="Unoccupied Heating" | °C |
Change a temperature offset setpoint (+-3°C for example) | Setpoint Offset | Temperature | Zone | -- | Air | setpointType="Offset" | °C |
Change HVAC Mode of a terminal unit | Command | HVAC Mode | -- | -- | Air | Personalized | |
Change illuminance setpoint | Command | Illuminance | -- | -- | Electricity | lx | |
Change HVAC Mode (Heating, Cooling...) | Command | HVAC Mode | -- | -- | Air | Site specific enumeration |
HVAC
Action | pointType | dimension | position | component | resource | Additional qualifiers | Units and Enumerations |
Change temperature setpoint for comfort mode | Setpoint | Temperature | -- | -- | Air | setpointType="Comfort" | °C |
Change pressure setpoint for reduced mode | Setpoint | Pressure | -- | -- | Air | setpointType="Reduced" pressureType="Differential" | Pa |
Change flowrate setpoint for reduced mode | Setpoint | Flowrate | -- | -- | Air | m3/hr |
⠀