BlueRange Types

The BlueRange platform has a number of types for which we have implemented additional logic in the BlueRange ecosystem. As there is a wide array of possible types and use-cases, we also integrate partial support for 3rd party specifications such as the Bluetooth SIG Mesh Device Property Specification. Some types, on the other hand, are very vendor specific and will have limited support by our platform.

We have a list of BlueRange sensor types and a list of BlueRange actuator types below.

It is very important that you pick the types and units wisely and according to our specification as this will make your devices interoperable with out current and future platform features.

How to select the correct type

To pick the correct type for your sensors, do the following:

  1. Check this document and use one of our BlueRange types if it fits your use-case

  2. If there is no inbuilt BlueRange type, check the Bluetooth SIG Mesh Device Properties specification

    • Use the type from this specification in UPPERCASE_UNDERSCORE notation, e.g. PRESENT_DEVICE_OPERATING_TEMPERATURE

  3. If the above lists can still not fullfill your use-case, make sure to prefix the name of the type with your vendor name

    • e.g. EXAMPLECOMPANY_HYPERSPACE_SENSOR_MEASUREMENT

List of Supported BlueRange Sensor Types

Below is a list of our currently supported sensor types. Make sure to only use them for the use-case as specified. For a better description, take a look at the archetypes. Also take a look at the definition of the supported units.

Lighting

Type Unit Description

BRIGHTNESS

PERCENT

Brightness setting of a luminaire

Occupancy

Type Unit Description

MOTION

ON_OFF

Events generated by a Motion sensor. They are typically fired instantly to inform adjacent light sources to turn on. As they have to fire instantly, they cannot be used (without any Threshold or calculation method on top) to generate presence information.

PRESENCE

ON_OFF

Most often generated from a motion sensor together with an algorithm. Typically, a few motion events within a short timeframe will result in a detection of presence that might then be held for e.g. 20 seconds and the presence will be prolonged if further motion events are triggered. A presence event can only be fired after an evaluation period of e.g. a few seconds in which the algorithm collects enough information to determine a presence. Ideally, a person walking through a room should not generate any presence event. The thresholds and parameters of the calculation can optionally be user-configurable.

OCCUPANCY

ON_OFF

Occupancy is used to determine if a room or desk is blocked by a user. Compared to presence, this is a longer timeframe, typically in the range of one hour up to a working day. Typically, an algorithm will decide based on motion or presence events within a given timeframe that the space is now occupied by a user or by multiple users (e.g. for a meeting room). The parameters of the occupancy calculation are usually configurable as the calculation is heavily dependent on the use-case and installation location of the device.

Environmental

Type Unit Description

TEMPERATURE

CELSIUS

Ambient Room Temperature (Attention, do not use for e.g. device temperature)

HUMIDITY

PERCENT

Ambient Relative Room Humidity

CO2

PPM

Present Ambient Carbon Dioxide Concentration

AIR_PRESSURE

PASCAL

As measured by a pressure sensor

Window Blinds

Type Unit Description

SLAT_POSITION

PERCENT

Slat position

SLAT_ANGLE

PERCENT

Slat angle

STATE_NUMBER

UNKNOWN

State number

List of Supported BlueRange Actuator Types

Next, here are the supported actuators. These are used by our applications, our Portal, etc,…​. For a better description, take a look at the archetypes.

Lighting

Type Unit Description

TURN_ON_OFF

ON_OFF

Turn a luminaire on / off

TURN_ON

ON_OFF

Turning on a luminaire (e.g. through a push button)

TURN_OFF

ON_OFF

Turning off a luminaire (e.g. through a push button)

SET_DIMMING

PERCENT

Set the dimming level of a luminaire

DIM_UP

PERCENT

Increases the current brightness of a luminaire by the given percentage (not supported by all luminaires, some will dim up by a fixed value)

DIM_DOWN

PERCENT

Decreases the current brightness of a luminaire by the given percentage (not supported by all luminaires, some will dim up by a fixed value). The lamp will only dim down to a minimum supported light level and will not turn off.

Environmental

Type Unit Description

SET_CO2

PPM

Input the current CO2 concentration for internal automation

Window Blinds

Type Unit Description

REMOVE_MAN

ON_OFF

Remove manual settings

ANGLE_STEP_STOP

ON_OFF

Stepping and stopping

DRIVE_UP_DOWN

ON_OFF

Driving up and down

SET_SLAT_ANGLE

PERCENT

Absolute slat positioning

SET_SLAT_POSITION

PERCENT

Absolute slat positioning

SET_PRESENCE

ON_OFF

Binary presence

SET_USER_CONSENT_UP

ON_OFF

User consent up

SET_USER_CONSENT_DOWN

ON_OFF

User consent up

REQUEST_UP

ON_OFF

Request up

REQUEST_DOWN

ON_OFF

Request down