Bluetooth mesh properties¶
The Bluetooth 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¶
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.
-