Bluetooth mesh properties

The Bluetooth® Special Interest Group (SIG) defines a list of Bluetooth mesh properties in the Bluetooth mesh device properties specification. Each property has an assigned ID and an associated Bluetooth GATT characteristic. The properties all represent values on a format defined by the associated characteristic.

Only the list of Property IDs, as specified in the Bluetooth Mesh Device Properties Specification v1.1 are defined in the API. It’s up to the application to implement property values that are compliant with the specified format.

API documentation

Header file: include/bluetooth/mesh/properties.h

group bt_mesh_property_ids

All available mesh Property IDs. See the Bluetooth mesh device properties specification for details.

Defines

BT_MESH_PROP_ID_PROHIBITED

Prohibited.

BT_MESH_PROP_ID_AVG_AMB_TEMP_IN_A_PERIOD_OF_DAY

Average ambient temperature in a period of day.

BT_MESH_PROP_ID_AVG_INPUT_CURRENT

Average input current.

BT_MESH_PROP_ID_AVG_INPUT_VOLTAGE

Average input voltage.

BT_MESH_PROP_ID_AVG_OUTPUT_CURRENT

Average output current.

BT_MESH_PROP_ID_AVG_OUTPUT_VOLTAGE

Average output voltage.

BT_MESH_PROP_ID_CENTER_BEAM_INTENSITY_AT_FULL_POWER

Center beam intensity at full power.

BT_MESH_PROP_ID_CHROMATICITY_TOLERANCE

Chromaticity tolerance.

BT_MESH_PROP_ID_COL_RENDERING_INDEX_R9

Color rendering index R9.

BT_MESH_PROP_ID_COL_RENDERING_INDEX_RA

Color rendering index RA.

BT_MESH_PROP_ID_DEV_APPEARANCE

Device appearance.

BT_MESH_PROP_ID_DEV_COUNTRY_OF_ORIGIN

Device country of origin.

BT_MESH_PROP_ID_DEV_DATE_OF_MANUFACTURE

Device date of manufacture.

BT_MESH_PROP_ID_DEV_ENERGY_USE_SINCE_TURN_ON

Device energy use since turn on.

BT_MESH_PROP_ID_DEV_FW_REVISION

Device firmware revision.

BT_MESH_PROP_ID_DEV_GLOBAL_TRADE_ITEM_NUM

Device global trade item number.

BT_MESH_PROP_ID_DEV_HW_REVISION

Device hardware revision.

BT_MESH_PROP_ID_DEV_MFR_NAME

Device manufacturer name.

BT_MESH_PROP_ID_DEV_MODEL_NUM

Device model number.

BT_MESH_PROP_ID_DEV_OP_TEMP_RANGE_SPEC

Device operating temperature range specification.

BT_MESH_PROP_ID_DEV_OP_TEMP_STAT_VALUES

Device operating temperature statistical values.

BT_MESH_PROP_ID_DEV_OVER_TEMP_EVT_STAT

Device over temperature event statistics.

BT_MESH_PROP_ID_DEV_POWER_RANGE_SPEC

Device power range specification.

BT_MESH_PROP_ID_DEV_RUNTIME_SINCE_TURN_ON

Device runtime since turn on.

BT_MESH_PROP_ID_DEV_RUNTIME_WARRANTY

Device runtime warranty.

BT_MESH_PROP_ID_DEV_SERIAL_NUM

Device serial number.

BT_MESH_PROP_ID_DEV_SW_REVISION

Device software revision.

BT_MESH_PROP_ID_DEV_UNDER_TEMP_EVT_STAT

Device under temperature event statistics.

BT_MESH_PROP_ID_INDOOR_AMB_TEMP_STAT_VALUES

Indoor ambient temperature statistical values.

BT_MESH_PROP_ID_INITIAL_CIE_1931_CHROMATICITY_COORDS

Initial CIE-1931 chromaticity coordinates.

BT_MESH_PROP_ID_INITIAL_CORRELATED_COL_TEMP

Initial correlated color temperature.

BT_MESH_PROP_ID_INITIAL_LUMINOUS_FLUX

Initial luminous flux.

BT_MESH_PROP_ID_INITIAL_PLANCKIAN_DISTANCE

Initial planckian distance.

BT_MESH_PROP_ID_INPUT_CURRENT_RANGE_SPEC

Input current range specification.

BT_MESH_PROP_ID_INPUT_CURRENT_STAT

Input current statistics.

BT_MESH_PROP_ID_INPUT_OVER_CURRENT_EVT_STAT

Input over current event statistics.

BT_MESH_PROP_ID_INPUT_OVER_RIPPLE_VOLTAGE_EVT_STAT

Input over ripple voltage event statistics.

BT_MESH_PROP_ID_INPUT_OVER_VOLTAGE_EVT_STAT

Input over voltage event statistics.

BT_MESH_PROP_ID_INPUT_UNDER_CURRENT_EVT_STAT

Input under current event statistics.

BT_MESH_PROP_ID_INPUT_UNDER_VOLTAGE_EVT_STAT

Input under voltage event statistics.

BT_MESH_PROP_ID_INPUT_VOLTAGE_RANGE_SPEC

Input voltage range specification.

BT_MESH_PROP_ID_INPUT_VOLTAGE_RIPPLE_SPEC

Input voltage ripple specification.

BT_MESH_PROP_ID_INPUT_VOLTAGE_STAT

Input voltage statistics.

BT_MESH_PROP_ID_LIGHT_CTRL_AMB_LUXLEVEL_ON

Light control ambient luxlevel on.

BT_MESH_PROP_ID_LIGHT_CTRL_AMB_LUXLEVEL_PROLONG

Light control ambient luxlevel prolong.

BT_MESH_PROP_ID_LIGHT_CTRL_AMB_LUXLEVEL_STANDBY

Light control ambient luxlevel standby.

BT_MESH_PROP_ID_LIGHT_CTRL_LIGHTNESS_ON

Light control lightness on.

BT_MESH_PROP_ID_LIGHT_CTRL_LIGHTNESS_PROLONG

Light control lightness prolong.

BT_MESH_PROP_ID_LIGHT_CTRL_LIGHTNESS_STANDBY

Light control lightness standby.

BT_MESH_PROP_ID_LIGHT_CTRL_REG_ACCURACY

Light control regulator accuracy.

BT_MESH_PROP_ID_LIGHT_CTRL_REG_KID

Light control regulator kid.

BT_MESH_PROP_ID_LIGHT_CTRL_REG_KIU

Light control regulator kiu.

BT_MESH_PROP_ID_LIGHT_CTRL_REG_KPD

Light control regulator kpd.

BT_MESH_PROP_ID_LIGHT_CTRL_REG_KPU

Light control regulator kpu.

BT_MESH_PROP_ID_LIGHT_CTRL_TIME_FADE

Light control time fade.

BT_MESH_PROP_ID_LIGHT_CTRL_TIME_FADE_ON

Light control time fade on.

BT_MESH_PROP_ID_LIGHT_CTRL_TIME_FADE_STANDBY_AUTO

Light control time fade standby auto.

BT_MESH_PROP_ID_LIGHT_CTRL_TIME_FADE_STANDBY_MANUAL

Light control time fade standby manual.

BT_MESH_PROP_ID_LIGHT_CTRL_TIME_OCCUPANCY_DELAY

Light control time occupancy delay.

BT_MESH_PROP_ID_LIGHT_CTRL_TIME_PROLONG

Light control time prolong.

BT_MESH_PROP_ID_LIGHT_CTRL_TIME_RUN_ON

Light control time run on.

BT_MESH_PROP_ID_LUMEN_MAINTENANCE_FACTOR

Lumen maintenance factor.

BT_MESH_PROP_ID_LUMINOUS_EFFICACY

Luminous efficacy.

BT_MESH_PROP_ID_LUMINOUS_ENERGY_SINCE_TURN_ON

Luminous energy since turn on.

BT_MESH_PROP_ID_LUMINOUS_EXPOSURE

Luminous exposure.

BT_MESH_PROP_ID_LUMINOUS_FLUX_RANGE

Luminous flux range.

BT_MESH_PROP_ID_MOTION_SENSED

Motion sensed.

BT_MESH_PROP_ID_MOTION_THRESHOLD

Motion threshold.

BT_MESH_PROP_ID_OPEN_CIRCUIT_EVT_STAT

Open circuit event statistics.

BT_MESH_PROP_ID_OUTDOOR_STAT_VALUES

Outdoor statistical values.

BT_MESH_PROP_ID_OUTPUT_CURRENT_RANGE

Output current range.

BT_MESH_PROP_ID_OUTPUT_CURRENT_STAT

Output current statistics.

BT_MESH_PROP_ID_OUTPUT_RIPPLE_VOLTAGE_SPEC

Output ripple voltage specification.

BT_MESH_PROP_ID_OUTPUT_VOLTAGE_RANGE

Output voltage range.

BT_MESH_PROP_ID_OUTPUT_VOLTAGE_STAT

Output voltage statistics.

BT_MESH_PROP_ID_OVER_OUTPUT_RIPPLE_VOLTAGE_EVT_STAT

Over output ripple voltage event statistics.

BT_MESH_PROP_ID_PEOPLE_COUNT

People count.

BT_MESH_PROP_ID_PRESENCE_DETECTED

Presence detected.

BT_MESH_PROP_ID_PRESENT_AMB_LIGHT_LEVEL

Present ambient light level.

BT_MESH_PROP_ID_PRESENT_AMB_TEMP

Present ambient temperature.

BT_MESH_PROP_ID_PRESENT_CIE_1931_CHROMATICITY_COORDS

Present CIE-1931 chromaticity coordinates.

BT_MESH_PROP_ID_PRESENT_CORRELATED_COL_TEMP

Present correlated color temperature.

BT_MESH_PROP_ID_PRESENT_DEV_INPUT_POWER

Present device input power.

BT_MESH_PROP_ID_PRESENT_DEV_OP_EFFICIENCY

Present device operating efficiency.

BT_MESH_PROP_ID_PRESENT_DEV_OP_TEMP

Present device operating temperature.

BT_MESH_PROP_ID_PRESENT_ILLUMINANCE

Present illuminance.

BT_MESH_PROP_ID_PRESENT_INDOOR_AMB_TEMP

Present indoor ambient temperature.

BT_MESH_PROP_ID_PRESENT_INPUT_CURRENT

Present input current.

BT_MESH_PROP_ID_PRESENT_INPUT_RIPPLE_VOLTAGE

Present input ripple voltage.

BT_MESH_PROP_ID_PRESENT_INPUT_VOLTAGE

Present input voltage.

BT_MESH_PROP_ID_PRESENT_LUMINOUS_FLUX

Present luminous flux.

BT_MESH_PROP_ID_PRESENT_OUTDOOR_AMB_TEMP

Present outdoor ambient temperature.

BT_MESH_PROP_ID_PRESENT_OUTPUT_CURRENT

Present output current.

BT_MESH_PROP_ID_PRESENT_OUTPUT_VOLTAGE

Present output voltage.

BT_MESH_PROP_ID_PRESENT_PLANCKIAN_DISTANCE

Present planckian distance.

BT_MESH_PROP_ID_PRESENT_REL_OUTPUT_RIPPLE_VOLTAGE

Present relative output ripple voltage.

BT_MESH_PROP_ID_REL_DEV_ENERGY_USE_IN_A_PERIOD_OF_DAY

Relative device energy use in a period of day.

BT_MESH_PROP_ID_REL_DEV_RUNTIME_IN_A_GENERIC_LEVEL_RANGE

Relative device runtime in a generic level range.

BT_MESH_PROP_ID_REL_EXPOSURE_TIME_IN_AN_ILLUMINANCE_RANGE

Relative exposure time in an illuminance range.

BT_MESH_PROP_ID_REL_RUNTIME_IN_A_CORRELATED_COL_TEMP_RANGE

Relative runtime in a correlated color temperature range.

BT_MESH_PROP_ID_REL_RUNTIME_IN_A_DEV_OP_TEMP_RANGE

Relative runtime in a device operating temperature range.

BT_MESH_PROP_ID_REL_RUNTIME_IN_AN_INPUT_CURRENT_RANGE

Relative runtime in an input current range.

BT_MESH_PROP_ID_REL_RUNTIME_IN_AN_INPUT_VOLTAGE_RANGE

Relative runtime in an input voltage range.

BT_MESH_PROP_ID_SHORT_CIRCUIT_EVT_STAT

Short circuit event statistics.

BT_MESH_PROP_ID_TIME_SINCE_MOTION_SENSED

Time since motion sensed.

BT_MESH_PROP_ID_TIME_SINCE_PRESENCE_DETECTED

Time since presence detected.

BT_MESH_PROP_ID_TOT_DEV_ENERGY_USE

Total device energy use.

BT_MESH_PROP_ID_TOT_DEV_OFF_ON_CYCLES

Total device off on cycles.

BT_MESH_PROP_ID_TOT_DEV_POWER_ON_CYCLES

Total device power on cycles.

BT_MESH_PROP_ID_TOT_DEV_POWER_ON_TIME

Total device power on time.

BT_MESH_PROP_ID_TOT_DEV_RUNTIME

Total device runtime.

BT_MESH_PROP_ID_TOT_LIGHT_EXPOSURE_TIME

Total light exposure time.

BT_MESH_PROP_ID_TOT_LUMINOUS_ENERGY

Total luminous energy.

BT_MESH_PROP_ID_DESIRED_AMB_TEMP

Desired ambient temperature.

BT_MESH_PROP_ID_PRECISE_TOT_DEV_ENERGY_USE

Precise Total Device Energy Use.

BT_MESH_PROP_ID_POWER_FACTOR

Power Factor.

BT_MESH_PROP_ID_SENSOR_GAIN

Sensor Gain.

BT_MESH_PROP_ID_PRECISE_PRESENT_AMB_TEMP

Precise Present Ambient Temperature.

BT_MESH_PROP_ID_PRESENT_AMB_REL_HUMIDITY

Present Ambient Relative Humidity.

BT_MESH_PROP_ID_PRESENT_AMB_CO2_CONCENTRATION

Present Ambient Carbon Dioxide Concentration.

BT_MESH_PROP_ID_PRESENT_AMB_VOC_CONCENTRATION

Present Ambient Volatile Organic Compounds Concentration.

BT_MESH_PROP_ID_PRESENT_AMB_NOISE

Present Ambient Noise.

BT_MESH_PROP_ID_ACTIVE_ENERGY_LOADSIDE

Active Energy Loadside.

BT_MESH_PROP_ID_ACTIVE_POWER_LOADSIDE

Active Power Loadside.

BT_MESH_PROP_ID_AIR_PRESSURE

Air Pressure.

BT_MESH_PROP_ID_APPARENT_ENERGY

Apparent Energy.

BT_MESH_PROP_ID_APPARENT_POWER

Apparent Power.

BT_MESH_PROP_ID_APPARENT_WIND_DIRECTION

Apparent Wind Direction.

BT_MESH_PROP_ID_APPARENT_WIND_SPEED

Apparent Wind Speed.

BT_MESH_PROP_ID_DEW_POINT

Dew Point.

BT_MESH_PROP_ID_EXTERNAL_SUPPLY_VOLTAGE

External Supply Voltage.

BT_MESH_PROP_ID_EXTERNAL_SUPPLY_VOLTAGE_FREQ

External Supply Voltage Frequency.

BT_MESH_PROP_ID_GUST_FACTOR

Gust Factor.

BT_MESH_PROP_ID_HEAT_INDEX

Heat Index.

BT_MESH_PROP_ID_LIGHT_DISTRIBUTION

Light Distribution.

BT_MESH_PROP_ID_LIGHT_SRC_CURRENT

Light Source Current.

BT_MESH_PROP_ID_LIGHT_SRC_ON_TIME_NOT_RESETTABLE

Light Source On Time Not Resettable.

BT_MESH_PROP_ID_LIGHT_SRC_ON_TIME_RESETTABLE

Light Source On Time Resettable.

BT_MESH_PROP_ID_LIGHT_SRC_OPEN_CIRCUIT_STAT

Light Source Open Circuit Statistics.

BT_MESH_PROP_ID_LIGHT_SRC_OVERALL_FAILURES_STAT

Light Source Overall Failures Statistics.

BT_MESH_PROP_ID_LIGHT_SRC_SHORT_CIRCUIT_STAT

Light Source Short Circuit Statistics.

BT_MESH_PROP_ID_LIGHT_SRC_START_COUNTER_RESETTABLE

Light Source Start Counter Resettable.

BT_MESH_PROP_ID_LIGHT_SRC_TEMP

Light Source Temperature.

BT_MESH_PROP_ID_LIGHT_SRC_THERMAL_DERATING_STAT

Light Source Thermal Derating Statistics.

BT_MESH_PROP_ID_LIGHT_SRC_THERMAL_SHUTDOWN_STAT

Light Source Thermal Shutdown Statistics.

BT_MESH_PROP_ID_LIGHT_SRC_TOTAL_POWER_ON_CYCLES

Light Source Total Power On Cycles.

BT_MESH_PROP_ID_LIGHT_SRC_VOLTAGE

Light Source Voltage.

BT_MESH_PROP_ID_LUMINAIRE_COLOR

Luminaire Color.

BT_MESH_PROP_ID_LUMINAIRE_IDENTIFICATION_NUMBER

Luminaire Identification Number.

BT_MESH_PROP_ID_LUMINAIRE_MANUFACTURER_GTIN

Luminaire Manufacturer GTIN.

BT_MESH_PROP_ID_LUMINAIRE_NOMINAL_INPUT_POWER

Luminaire Nominal Input Power.

BT_MESH_PROP_ID_LUMINAIRE_NOMINAL_MAXIMUM_AC_MAINS_VOLTAGE

Luminaire Nominal Maximum AC Mains Voltage.

BT_MESH_PROP_ID_LUMINAIRE_NOMINAL_MINIMUM_AC_MAINS_VOLTAGE

Luminaire Nominal Minimum AC Mains Voltage.

BT_MESH_PROP_ID_LUMINAIRE_POWER_AT_MINIMUM_DIM_LEVEL

Luminaire Power At Minimum Dim Level.

BT_MESH_PROP_ID_LUMINAIRE_TIME_OF_MANUFACTURE

Luminaire Time Of Manufacture.

BT_MESH_PROP_ID_MAGNETIC_DECLINATION

Magnetic Declination.

BT_MESH_PROP_ID_MAGNETIC_FLUX_DENSITY_2D

Magnetic Flux Density - 2D.

BT_MESH_PROP_ID_MAGNETIC_FLUX_DENSITY_3D

Magnetic Flux Density - 3D.

BT_MESH_PROP_ID_NOMINAL_LIGHT_OUTPUT

Nominal Light Output.

BT_MESH_PROP_ID_OVERALL_FAILURE_CONDITION

Overall Failure Condition.

BT_MESH_PROP_ID_POLLEN_CONCENTRATION

Pollen Concentration.

BT_MESH_PROP_ID_PRESENT_INDOOR_RELATIVE_HUMIDITY

Present Indoor Relative Humidity.

BT_MESH_PROP_ID_PRESENT_OUTDOOR_RELATIVE_HUMIDITY

Present Outdoor Relative Humidity.

BT_MESH_PROP_ID_PRESSURE

Pressure.

BT_MESH_PROP_ID_RAINFALL

Rainfall.

BT_MESH_PROP_ID_RATED_MEDIAN_USEFUL_LIFE_OF_LUMINAIRE

Rated Median Useful Life Of Luminaire.

BT_MESH_PROP_ID_RATED_MEDIAN_USEFUL_LIGHT_SRC_STARTS

Rated Median Useful Light Source Starts.

BT_MESH_PROP_ID_REFERENCE_TEMP

Reference Temperature.

BT_MESH_PROP_ID_TOTAL_DEVICE_STARTS

Total Device Starts.

BT_MESH_PROP_ID_TRUE_WIND_DIRECTION

True Wind Direction.

BT_MESH_PROP_ID_TRUE_WIND_SPEED

True Wind Speed.

BT_MESH_PROP_ID_UV_INDEX

UV Index.

BT_MESH_PROP_ID_WIND_CHILL

Wind Chill.

BT_MESH_PROP_ID_LIGHT_SRC_TYPE

Light Source Type.

BT_MESH_PROP_ID_LUMINAIRE_IDENTIFICATION_STRING

Luminaire Identification String.

BT_MESH_PROP_ID_OUTPUT_POWER_LIMITATION

Output Power Limitation.

BT_MESH_PROP_ID_THERMAL_DERATING

Thermal Derating.

BT_MESH_PROP_ID_OUTPUT_CURRENT_PERCENT

Output Current Percent.