Light CTL models

The Color-Tunable Light (CTL) models allow remote control and configuration of CTLs on a mesh device.

The Light CTL models can represent the lightness states on a linear or preceptually uniform lightness scale. See Light Lightness models for details.

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

Common types

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

Header file: include/bluetooth/mesh/light_ctl.h
group bt_mesh_light_ctl

API for the Light CTL models.

Defines

BT_MESH_LIGHT_TEMP_RANGE_MIN

Minimum permitted Temperature level

BT_MESH_LIGHT_TEMP_RANGE_MAX

Maximum permitted Temperature level

struct bt_mesh_light_ctl
#include <light_ctl.h>

All Light CTL parameters

Public Members

uint16_t light

Light level

uint16_t temp

Temperature level

int16_t delta_uv

Delta UV level

struct bt_mesh_light_temp
#include <light_ctl.h>

Temperature subset of Light CTL parameters.

Public Members

uint16_t temp

Temperature level

int16_t delta_uv

Delta UV level

struct bt_mesh_light_ctl_set
#include <light_ctl.h>

Light CTL set message parameters.

Public Members

struct bt_mesh_light_ctl params

CTL set parameters

const struct bt_mesh_model_transition *transition

Transition time parameters for the state change.

struct bt_mesh_light_ctl_status
#include <light_ctl.h>

Light CTL status message parameters.

Public Members

uint16_t current_light

Current light level

uint16_t current_temp

Current Temperature level

uint16_t target_light

Target light level

uint16_t target_temp

Target Temperature level

int32_t remaining_time

Remaining time for the state change (ms).

struct bt_mesh_light_temp_set
#include <light_ctl.h>

Light CTL Temperature set message parameters.

Public Members

struct bt_mesh_light_temp params

CTL Temperature set parameters

const struct bt_mesh_model_transition *transition

Transition time parameters for the state change.

struct bt_mesh_light_temp_status
#include <light_ctl.h>

Light CTL Temperature status message parameters.

Public Members

struct bt_mesh_light_temp current

Current Temperature set parameters

struct bt_mesh_light_temp target

Target Temperature set parameters

int32_t remaining_time

Remaining time for the state change (ms).

struct bt_mesh_light_temp_range
#include <light_ctl.h>

Light CTL range parameters.

Public Members

uint16_t min

Minimum range value

uint16_t max

Maximum range value

struct bt_mesh_light_temp_range_status
#include <light_ctl.h>

Light CTL range status message parameters.

Public Members

enum bt_mesh_model_status status_code

Range set status code

struct bt_mesh_light_temp_range range

Range set parameters