Light Lightness models

The Light Lightness models allow remote control and configuration of dimmable lights on a mesh device.

The Light Lightness models can represent light in the following ways:

  • Actual: Lightness is represented on a perceptually uniform lightness scale.

  • Linear: Lightness is represented on a linear scale.

The relationship between the Actual and the Linear representations is the following:

Light (Linear) = (Light (Actual))2

Bindings with other states are always made to the Actual representation.

The Light Lightness models also feature their own common types, listed below. For types common to all models, see Bluetooth Mesh models.

The application can select whether to use the Actual or Linear representation. To do so, use the following options in the API at compile time:

Internally, the models always support both representations, so nodes with different representations can be used interchangeably.

Common types

This section lists the types common to the Light Lightness mesh models.

Header file: include/bluetooth/mesh/lightness.h
Light Lightness Models