Supported Traits

The following table lists all traits supported by Aqara:

Note

The table below only displays the basic information for each trait, including type, readability/writability, and whether it is reportable. For detailed definitions of each trait (such as value range, enum descriptions, etc.), please use the API spec.query.qlinkmodel.config (for qlink devices) or spec.query.specdevice.config (for matter devices) to obtain complete configuration details.

Trait Code Name Type Unit Readable Writable Reportable
CODetected Carbon Monoxide Detection State boolean ✔ ✘ ✔
ExpressedState Alarm State enum ✔ ✘ ✔
WindSetting Wind Type enum ✔ ✔ ✔
AirflowDirection Airflow Direction enum ✔ ✔ ✔
FanSpeed Fan Speed number % ✔ ✔ ✔
AirQuality Air Quality Level enum ✔ ✘ ✔
BooleanState Boolean State boolean ✔ ✘ ✔
MatterVendorID Matter Vendor ID string ✔ ✘ ✔
FreshAirMode Fresh Air Mode enum ✔ ✔ ✔
InvertedRotationAngle Inverted Rotation Angle number ° ✘ ✘ ✔
ConnectionStatus Connection Status enum ✔ ✘ ✔
ScreenBrightness Screen Brightness number % ✔ ✔ ✔
TemperatureUIDisplayMode Temperature UI Display Mode enum ✔ ✔ ✔
BatReplacementNeeded Battery Replacement Needed boolean ✔ ✘ ✔
BatQuantity Battery Quantity number ✔ ✘ ✔
Rechargeable Rechargeable boolean ✔ ✘ ✔
CircuitCurrent Circuit Current number A ✔ ✘ ✔
P2PCaptureEnabled P2P Snapshot Supported boolean ✔ ✔ ✔
MotorOperationStatus Motor Operating Status enum ✔ ✘ ✔
MotorDirectionReversed Motor Direction Reversed boolean ✔ ✔ ✔
MotorControllability Motor Controllable boolean ✔ ✘ ✔
CurrentValveState Current Valve State enum ✔ ✘ ✔
Condition Filter Remaining Life number % ✔ ✘ ✔
ChangeIndication Filter Life Status enum ✔ ✘ ✔
FilterType Filter Type enum ✔ ✘ ✔
OperationalState Device State enum ✔ ✘ ✔
CurrentFlow Current Flow number m³/h ✔ ✘ ✔
CurrentMode Current Mode enum ✔ ✘ ✔
ChangeToModeResponse Mode Switch Response enum ✔ ✘ ✔
VacuumOperationalState Robot Vacuum State enum ✔ ✘ ✔
RefrigeratorAlarm Refrigerator Alarm other ✔ ✘ ✔
EvseState EV Charger State enum ✔ ✘ ✔
EvseSupplyState EVSE State enum ✔ ✘ ✔
ChargingEnabledUntil Allowed Charging Time number A ✔ ✘ ✔
MaxChargeCurrent Max Current number A ✔ ✘ ✔
BatteryCapacity Battery Capacity number ✔ ✘ ✔
MinChargeCurrent Min Current number A ✔ ✘ ✔
SetTemperature Set Temperature number °C ✔ ✔ ✔
SetTemperatureLevel Set Temperature Level number ✔ ✔ ✔
MediaInput Media Source enum ✔ ✔ ✔
SetBack Temperature Floating Value number °C ✔ ✔ ✔
OpenAngle Opening Angle number ✔ ✘ ✔
BSSID BSSID string ✔ ✘ ✔
CurrentTemperatureCalibration Temperature Compensation number °C ✔ ✔ ✔
HeaterCoolerButtonEvent Thermostat Button Event enum ✔ ✘ ✔
HeaterCoolerPolarity Thermostat Polarity Setting enum ✔ ✔ ✔
SelfCheck Alarm Self-Check boolean ✔ ✔ ✔
FirmwareRevision Firmware Version string ✔ ✘ ✔
SerialNumber Serial Number string ✔ ✘ ✔
VendorName Vendor Name string ✔ ✘ ✔
VendorID Vendor ID string ✔ ✘ ✔
ProductName Product Name string ✔ ✘ ✔
Reachable Connection Status boolean ✔ ✘ ✔
HardwareVersion Hardware Version string ✔ ✘ ✔
Mac MAC Address string ✔ ✘ ✔
DeviceID Device ID string ✔ ✘ ✔
EndpointName Device or Card Name string ✔ ✔ ✔
OnOff On/Off State boolean ✔ ✔ ✔
CurrentLevel Current Level number % ✔ ✔ ✔
CurrentX Current X Value number ✔ ✔ ✔
CurrentY Current Y Value number ✔ ✔ ✔
ColorTemperature Color Temperature Value number ✔ ✔ ✔
ButtonEvent Button Event enum ✘ ✘ ✔
CameraActiveStatus Camera Sleep Status boolean ✔ ✔ ✔
CurrentPositionPercentage Current Position Percentage number % ✔ ✘ ✔
TargetPositionPercentage Target Position Percentage number % ✘ ✔ ✔
IRType IR Type enum ✔ ✔ ✔
IRBrand IR Brand number ✔ ✔ ✔
CurrentVoltage Voltage Value number V ✔ ✘ ✔
CurrentPower Power Value number W ✔ ✘ ✔
CumulativeEnergyConsumption Total Energy Consumption number W·h ✔ ✘ ✔
HeaterCoolerMode Heating/Cooling Mode enum ✔ ✔ ✔
HeatingTemperature Heating Temperature number °C ✔ ✔ ✔
CoolingTemperature Cooling Temperature number °C ✔ ✔ ✔
FanMode Fan Mode enum ✔ ✔ ✔
RockSetting Swing Setting enum ✔ ✔ ✔
CurrentHumidity Humidity number % ✔ ✘ ✔
CurrentPlaybackState Playback State enum ✔ ✘ ✔
PlaybackDuration Playback Duration number ms ✔ ✘ ✔
SampledPosition Playback Progress number ms ✔ ✘ ✔
PlaybackMode Playback Mode enum ✔ ✔ ✔
MediaInformation Media Information string ✔ ✘ ✔
Volume Volume number % ✔ ✔ ✔
Mute Mute boolean ✔ ✔ ✔
LockState Lock State enum ✔ ✘ ✔
DoorState Door State enum ✔ ✘ ✔
IRKey IR Command enum ✘ ✔ ✘
BatPercentRemaining Battery Percentage Remaining number % ✔ ✘ ✔
SweeperState Sweeper State enum ✔ ✘ ✔
VOCDensity VOC Density number ppb ✔ ✘ ✔
VOCQuality VOC Quality Level enum ✔ ✘ ✔
CurrentPressure Pressure number kPa ✔ ✘ ✔
PM2.5Density PM2.5 Density number ug/m³ ✔ ✘ ✔
PM2.5Level PM2.5 Level enum ✔ ✘ ✔
PM1.0Density PM1.0 Density number ug/m³ ✔ ✘ ✔
PM10Density PM10 Density number ug/m³ ✔ ✘ ✔
CO2Density CO2 Density number ppm ✔ ✘ ✔
CO2Level CO2 Level enum ✔ ✘ ✔
CurrentIlluminance Illuminance number lux ✔ ✘ ✔
ContactSensorState Contact Sensor State boolean ✔ ✘ ✔
SmokeDensity Smoke Density number OBS%/FT ✔ ✘ ✔
SmokeDetected Smoke Detection State boolean ✔ ✘ ✔
GasDensity Gas Density number %LEL ✔ ✘ ✔
GasDetected Gas Detection State boolean ✔ ✘ ✔
SleepState Sleep State enum ✔ ✘ ✔
SleepQuality Sleep Quality number ✔ ✘ ✔
OnBed On Bed State boolean ✔ ✘ ✔
SleepStage Sleep Stage enum ✔ ✘ ✔
LeakState Leak State boolean ✔ ✘ ✔
Occupancy Occupancy State boolean ✔ ✘ ✔
OccupancySensorType Occupancy Sensor Type enum ✔ ✘ ✔
MotionDetected Motion Detection enum ✘ ✘ ✔
RotationAngle Rotation Angle number ✘ ✘ ✔
RotationDirection Rotation Direction enum ✘ ✘ ✔
RotationEvent Rotation Event enum ✘ ✘ ✔
CubeEvent Cube Event enum ✘ ✘ ✔
VibrationEvent Vibration Event enum ✘ ✘ ✔
SmokeDensitydB Smoke Density dB number dB/m ✔ ✘ ✔
CurrentR Red Value number ✔ ✔ ✔
CurrentG Green Value number ✔ ✔ ✔
CurrentB Blue Value number ✔ ✔ ✔
SupportedEndpointDynamic Whether the dynamic endpoints are supported or not boolean ✔ ✘ ✔
EndpointArrayDynamic Dynamic Endpoint Array other ✔ ✘ ✔
Feed Feeding enum ✔ ✘ ✔
AttitudeDetected Attitude Detection enum ✔ ✘ ✔
TargetPlaybackState Target Playback State enum ✔ ✔ ✔
EnableRemoteControl Remote Control Enabled boolean ✔ ✔ ✔
HardwareVersionString Hardware Version (string type) string ✔ ✘ ✔
FirmwareRevisionString Firmware Version (string type) string ✔ ✘ ✔
ProductID Product ID number ✔ ✘ ✔
RemoteUnlock Remote Unlock (Aqara Private) boolean ✔ ✔ ✔
MinPINCodeLength Minimum PIN Code Length number ✔ ✘ ✔
MinRFIDCodeLength Minimum RFID Code Length number ✔ ✘ ✔
OperatingMode Operating Mode enum ✔ ✘ ✔
ActuatorEnabled Actuator Enabled boolean ✔ ✘ ✔
ReverseIdentify Reverse Identify number ✘ ✘ ✔
Hue Hue number ° ✔ ✔ ✔
Saturation Saturation number % ✔ ✔ ✔
MinHeatCoolDeadBand Min. Heating/Cooling Deadband number °C ✔ ✔ ✔
Channel Wireless Channel number ✔ ✘ ✔
ExtendedPANID Network Extended PAN ID number ✔ ✘ ✔
WindowCoveringMotorsBinding Curtain Motor Unified Control boolean ✔ ✔ ✔
CurrentRotationAngle Curtain Current Rotation Angle number ° ✔ ✔ ✔
TargetRotationAngle Curtain Target Rotation Angle number ° ✔ ✔ ✔
CurrentGarageDoorState Current Garage Door State enum ✔ ✘ ✔
TargetGarageDoorState Target Garage Door State enum ✔ ✔ ✔
HoldRotationAngle Hold Rotation Angle number ° ✘ ✘ ✔
ModeCount Number of Modes number ✔ ✘ ✔
PlaybackSampledPosition Current Media Playback Position number ms ✔ ✔ ✔
SelectedMediaOutputSource Current Playback Output Source enum ✔ ✔ ✔
LockOperation Door Lock Operation (Event Reporting) other ✘ ✘ ✔
DoorLockAlarm Door Lock Alarm (Event Reporting) other ✘ ✘ ✔
LockUserChange Door Lock User Change Reporting other ✘ ✘ ✔
ModelValue Model Value string ✔ ✘ ✔
lumi LogoCopyright © 2023 Lumi United Technology Co., Ltd. all right reserved，powered by GitbookFile Modify: 2025-11-27 12:05:49

results matching ""

    No results matching ""