跳到主要内容

功能点代码

下表汇总了 Aqara 支持的全部功能点代码（trait code）：

trait_codetrait_name
CODetected一氧化碳检测状态
ExpressedState报警器状态
WindSetting风类型
AirflowDirection风向
FanSpeed风速
AirQuality空气质量等级
BooleanState布尔状态
FreshAirMode新风模式
InvertedRotationAngle倒置旋转角度
ScreenBrightness屏幕亮度
TemperatureUIDisplayMode温度用户界面显示模式
BatReplacementNeeded是否需要更换电池
BatQuantity电池数量
Rechargeable是否可充电
CircuitCurrent电路电流
P2PCaptureEnabled是否支持P2P抓图
MotorOperationStatus电机运行状态
MotorDirectionReversed电机方向反转
MotorControllability电机是否可控制
CurrentValveState当前阀门状态
Condition滤芯剩余寿命
ChangeIndication滤芯寿命状态
FilterType滤芯类型
OperationalState设备状态
CurrentFlow当前流量
CurrentMode当前模式
ChangeToModeResponse模式切换反馈
VacuumOperationalState扫地机器人状态
RefrigeratorAlarm冰箱报警
EvseState充电枪状态
EvseSupplyState充电桩状态
ChargingEnabledUntil允许继续充电时间
MaxChargeCurrent最大电流
BatteryCapacity电池容量
MinChargeCurrent最小电流
SetTemperature设置温度
SetTemperatureLevel设置温度等级
MediaInput播放源
SetBack温度浮动
OpenAngle开合角度
BSSIDBSSID
CurrentTemperatureCalibration温度补偿
HeaterCoolerButtonEvent温控按键事件
HeaterCoolerPolarity温控器极性设置
SelfCheck报警器自检
FirmwareRevision固件版本
SerialNumber序列号
VendorName厂商名
VendorID厂商ID
ProductName产品名称
Reachable连接状态
HardwareVersion硬件版本
MacMac地址
DeviceID设备ID
EndpointName设备或卡片名称
OnOff开关状态
CurrentLevel当前等级
CurrentXX值
CurrentYY值
ColorTemperature色温值
ButtonEvent按钮事件
CameraActiveStatus摄像头休眠状态
CurrentPositionPercentage当前位置百分比
TargetPositionPercentage目标位置百分比
IRType红外类型
IRBrand红外品牌
CurrentVoltage电压值
CurrentPower功率值
CumulativeEnergyConsumption累计耗电量
HeaterCoolerMode制热制冷模式
HeatingTemperature制热温度
CoolingTemperature制冷温度
FanMode风扇模式
RockSetting摆风
CurrentHumidity湿度
CurrentPlaybackState播放状态
PlaybackDuration时长
SampledPosition播放进度
PlaybackMode播放模式
MediaInformation媒体信息
Volume音量
Mute静音
LockState锁状态
DoorState门状态
IRKey红外指令
BatPercentRemaining电量百分比
SweeperState扫地状态
VOCDensityVOC浓度
VOCQualityVOC等级
CurrentPressure压力
PM2.5DensityPM2.5浓度
PM2.5LevelPM2.5等级
PM1.0DensityPM1.0浓度
PM10DensityPM10浓度
CO2DensityCO2浓度
CO2LevelCO2等级
CurrentIlluminance光照度
ContactSensorState接触状态
SmokeDensity烟雾浓度
SmokeDetected烟雾检测状态
GasDensity气体浓度
GasDetected气体检测状态
SleepState睡眠状态
SleepQuality睡眠质量
OnBed在床状态
SleepStage睡眠阶段
LeakState泄漏状态
Occupancy存在状态
OccupancySensorType存在传感类型
MotionDetected移动侦测
RotationAngle旋转角度
RotationDirection旋转方向
RotationEvent旋转事件
CubeEvent魔方事件
VibrationEvent动静贴事件
SmokeDensitydB烟雾浓度dB
CurrentR红色值
CurrentG绿色值
CurrentB蓝色值
SupportedEndpointDynamic支持动态模式
EndpointArrayDynamic节点动态数组
Feed喂食
AttitudeDetected姿态检测
TargetPlaybackState目标播放状态
EnableRemoteControl远程控制使能
HardwareVersionString指定节点硬件的版本号
FirmwareRevisionString固件版本号
ProductID产品ID
MinPINCodeLength最小PINCode长度
MinRFIDCodeLength最小RFID长度
OperatingMode操作模式
ActuatorEnabled执行器启用
ReverseIdentify反向识别
HueHue
Saturation饱和度
MinHeatCoolDeadBand制冷制热温度最小死区
Channel无线信道
ExtendedPANID网络ExtendedPANID
WindowCoveringMotorsBinding窗帘电机绑定为统一总控
CurrentRotationAngle窗帘的当前旋转角度
TargetRotationAngle窗帘的目标旋转角度
CurrentGarageDoorState当前（车库）门状态
TargetGarageDoorState目标（车库）门状态
HoldRotationAngle按住旋转角度
ModeCount模式数量
PlaybackSampledPosition当前媒体播放位置
SelectedMediaOutputSource当前播放输出源
LockOperation门锁操作（事件）上报
DoorLockAlarm门锁报警（事件）上报
LockUserChange门锁用户变更上报
ModelValue模型值
EndpointCount指示当前 Device 所包含的 Endpoint 数量
EndpointStructure描述当前 Device 所用配置实例中 Endpoint 的
EndpointDeviceTypes描述当前 Device 所有配置实例中各 Endpoint
EndpointDynamicCount指示当前 Device 支持的动态 Endpoint 配置实
EndpointArray描述当前 Device 所包含 Endpoint 的所有可能
EndpointFunctions节点功能
SelectedEndpointDynamic表示 EndpointArray 的数组索引，指示当前选中的
PartNumber部件编号
BLVersion指定 Bootloader 版本
ManufacturerChipID标识制造商芯片 ID
SupportedMatterRoles指示设备支持的 Matter 角色，如 Thread Bor
HubConnectionStatus指示设备与中央 Hub 的连接状态，用于判断设备当前是否已连
DeviceXCode表示设备的 device type X code
MatterSpecificationVersionMatter规范的版本号
MCUVersion指定 MCU 版本
ConfigurationFlag指示配置状态
RadarVersion指定雷达模块版本
ConfigurationVersion用于存储设备的 ConfigurationVersion 和
ChipTemperature指示设备测得的当前温度
Location地区
EndpointTag该属性的当前值应为命名空间内语义标签的 ID
EndpointApplianceType描述当前家电类型（如 Light、Fan、Air Condi
EndpointRoom描述 Endpoint 所在房间的 ID，字符串格式，最大长
EndpointVisibility描述当前 Device 所包含全部 Endpoint 的可见
EndpointIcon描述当前图标 ID
EndpointStatistics描述设备是否可纳入统计功能
EndpointRoomName描述 Endpoint 所在房间名称，字符串格式，最大长度
VoiceLanguage用于语音提示和语音反馈的语言
EnergySavingEnable启用或禁用节能模式
CurrentSensitivityLevel指示当前所选通用配置灵敏度等级
TransmissionPowerSetting用于设置设备发射功率的专用特征
HubArkTechEnable用于启用或禁用 Aqara Ark Technology 下
BeepEnable启用或禁用设备操作的声音反馈提示音
NightLightMode设置夜灯模式
OutputInterlockFlag当两个属性的取值相同时，表示这两个属性对应的状态处于互锁关系
ActivityDetectionModeSetting指定设备用于检测和识别特定活动或状态的当前工作模式，例如人体
TimeZone该属性用于设置并上报设备所在时区（如中国标准时间为 "GMT
NumberOfSensitivityLevelIsSupported支持的灵敏度级别数量
PollingTime设置设备与网络通信的轮询时间间隔
InstallationOrientationConfiguration安装方向配置
DetectionModeSetting指示设备当前检测模式设置，决定设备将监测并上报的事件或状态类
LightingModeSetting定义灯具的工作模式
ResetMode支持执行包括出厂重置、重置网络配置在内的操作
MagicPairPayload提供 MagicPair 入网所需的配对信息
SupportedEcosystem指示设备支持的生态（如 Aqara Hub M3 支持 Aq
MatterPayload提供 Matter 配网所需的配对信息
HomeKitPayload提供 HomeKit 配网所需的配对信息
BoundEcosystem指示设备已绑定的生态
BatReplacementDescription该特征应提供面向用户的电池描述
BatChargeState指示电池充电状态
BatReplaceability该特征应指示电池是否可更换
PowerMode指示设备的供电模式
WiredPresent指示是否检测到有线电源（电源适配器）
StateOfLowBat指示电池是否处于低电量状态
LoadSafetyManagement一种监控电气或机械负载的安全机制
VoltageSafetyManagement一种安全机制，用于监控电源电压，在过电压或欠电压异常期间进行
CurrentSafetyManagement一种监控设备电流的安全机制，在过电流异常期间触发保护
OverCurrentResponseSetting该配置设置过流保护的作用范围
TemperatureSafetyManagement监控设备温度的安全机制，在发生超温异常时触发保护措施
RebootCount当前值应尽可能准确地指示设备已重启的次数
RebootReason当前值应指示设备最近一次启动的原因
UpTimeUpTime 特征应尽可能准确地指示自节点上次重启以来经过的
NetworkInterfaces该特征描述设备支持的网络接口
AntiDeletionSetting用于设置防止误删的功能
AntiDeletionLevelSetting反删除级别设置控制设备运行期间复位网络和出厂复位按钮操作的权
ActiveHardwareFaults硬件错误
DebugInfo设备运行期间的调试信息
FreeMemory指示设备当前可用内存大小，单位为千字节（KB）
AntiDeletionNotification为集线器上的子设备启用AntiDeletion功能后，如果子
RoutingAgingCountThreshold设备数据包路由的老化计数阈值设置
PreOperationMode表示设备先前的 Zigbee 网络连接状态
NWKRetransmissionCount指示数据包传输期间网络层的重传次数
ZigbeeTotalMessageInOneHour指示 1 小时内发送的 Zigbee 消息总数
ZigbeeCoordMac用于表示 Zigbee 协调器的 MAC 地址
APSRetransmissionCountZigBee APS 层在数据包未收到确认时尝试的自动重传次
ZigbeeResentMessageInOneHour表示一小时内重发的 Zigbee 消息数量
PANID当前值指示 Zigbee 网络 PAN ID
ZigbeeExtendedPANID表示Zigbee网络的64位扩展标识符的字符串
ZigbeeGeneralDiagnostics子设备自诊断信息的通用报告渠道
MessageTransmissionFailureCountThreshold设备数据包传输失败的阈值计数设置
EnableNWKACK切换在网络通信中启用网络层确认的选项
ZigbeeKeySeqNumber表示 Zigbee 协调器当前使用的 network key
LQI指示 Thread 网络的 Link Quality Ind
ZigbeeFrameCounterZigBee 帧计数器为每条数据帧附加的唯一递增值，用于防止
CCAMode指示设备的 CCA 状态
ZigbeeNextHopMac定义下一跳设备的 Zigbee MAC 地址
EnableAPSACK切换在网络通信中启用 APS 确认的选项
MACRetransmissionCount指示数据包传输期间 MAC 层的重传次数
ZigbeeFailedMessageInOneHour表示一小时内发送失败的 Zigbee 消息数量
ZigbeeNeighborTableInfo提供 Zigbee 设备的网络拓扑信息
CurOperationMode表示设备当前的 Zigbee 网络连接状态
ZigbeeAvgSuccessfulResendCount指示 Zigbee 消息成功重发的平均次数
ZigbeeCoordNetworkKey用于表示 Zigbee 协调器的网络密钥
LanAccessAddress路由器在家庭局域网（LAN）中为设备分配的 IP 地址（通常
RemoteProxyAccessEnable远程代理访问启用开关
InternetAccessAddress云服务平台为设备分配的公网访问地址（通常为域名或 NAT 映
IdentifyType指定向用户呈现标识的方式
IdentifyTime指示设备将继续进行自标识的剩余时长（秒）
HomeStationCredentialsHome Station Credentials信息
WiFiChannelWi-Fi 信道，如 2.4GHz 频段信道 1–14 或
ChildDeviceProvisioningState供网关上报子设备（如 Zigbee 设备、Matter 设备
ZigbeeDiagnostics提供 Zigbee 网络的诊断信息
ZigbeeAuthRandcodeZigbee 3.0 设备连接云端进行认证时，由云端下发的随
ZigbeeAuthRandcodeResponseZigbee 3.0 设备与云端认证时返回的 Confirm
WiFiDiagnostics提供 Wi‑Fi 网络的诊断信息
MagicPairKeychain用于 MagicPair 网络配网密钥链
SupportedNetwork指示设备入网（MagicPair）所支持的网络协议
SlaveAddress总线上为设备作为从机分配的地址，用于主从通信寻址
ThreadDiagnostics提供 Thread 网络的诊断信息
AuthenticationStatus指示设备认证状态，反映是否已通过认证及证书是否有效
WiFiRSSI测量Wi-Fi连接信号强度的指标，以dBm为单位，范围从-1
CurrentTemperature指示当前温度
PackageRecognitionReport当包裹投递、取走或状态发生变化时自动上报事件
FaceIDReport与特定面部相关联的唯一标识符，用于面部识别或身份验证
HoldTime无人判定延时
ActivityDetected指示在空间被占用期间是否检测到任何人为活动
PresenceConfiguration用于配置有无人软传感相关设置
PresencePresence 用于检测监测区域内是否有人
HumanRecognitionReport上报在定义检测区域内是否检测到人形
TripTime指示电机行程时间，即从完全打开到完全关闭（或相反）所需的时间
BindingBinding表示端点与一个或多个其他本地或远程 Endpo
SupportedBindingDeviceTypes指示该控制器端点可绑定的设备类型列表
SupportedBindingFunctions指示该控制器端点可绑定并控制的 Function 功能列表
LocalControlDisabled描述按钮是否禁用关联的本地设备控制功能（如继电器控制）
OutputSwitchingType定义连接到设备的外部开关类型
OutputNodeMode定义输出节点的工作模式
StartUpOnOff定义设备上电时一组自定义配置参数的启动行为（例如恢复用户自定
Preset预设
PresetTypes预设类型
ActivePresetHandle主动预设句柄
NumberOfPresets预设数量
AntiFreezeTemperature防冻保护温度设置通常指触发防冻机制的阈值（例如 5°C）
TiltAngleDeviation指示当前运动期间 Tilt 角度的实际变化量（偏移）
StationaryState该特征的当前值应以枚举形式指示目标当前是否静止
InitialTiltAngle指示设备校准期间建立的初始倾斜角，表示校准方向（例如朝上）与
EventReportInterval指示设备连续事件上报之间的时间间隔，单位为秒
ObjectOrientationEnable启用或禁用物体朝向监测功能
StationaryTiltAngle指示物体运动后静止时的倾斜角
PeakTiltAngle指示从唤醒到静止期间记录的最大倾斜角
ObjectMotionDetectionEnable启用或禁用物体移动检测功能
ObjectOrientationState指示设备检测到的物体当前空间朝向
CubeWorkModeSetting启用 Magic Cube 设备多种操作模式设置，增强体验与
TopFace指示魔方控制器当前朝上的面，用于定义设备状态
TopFaceChanged表示设备“朝上面”已变更。用户翻转设备（如魔方控制器）时触发
HoldRotationInterval某个按住旋转事件对应的旋转所用时长，即旋转间隔时长
RotationInterval某个旋转事件对应的旋转所用时长，即旋转间隔时长
BinaryOutputPVBinaryOutputPV保存二进制输出的命令或实际开/关
AnalogInputPVAnalogInputPV传达模拟输入通道的实时实时值及其工
LoginState描述媒体服务的登录状态
SelectedSource指示或设置当前所选媒体输出源（如内置扬声器、Bluetoot
FlameDetected使设备识别监控区域内的明火或火焰特征
OperationalErrorOperationalError 指设备或系统无法执行其预期
BridgeDeviceID表示此桥接节点所连接的 Bridge 设备的 DeviceI
MultiStateInputPVMultiStateInputPV 提供当前枚举状态，以及人
PulseDuration定义脉冲负载的脉冲持续时间
LoadType描述连接到开关的负载类型
ThemeID主题ID
Allpages所有页面
MaxPageNum最大页面数量
ScreenWidth屏幕宽度
DataVersion数据版本
ThemeVersion主题版本
ScreenHeight屏幕高度
EnableIndicator指示灯使能
HeartRate实时测量每分钟心跳次数
MultiStateOutputPVMultiStateOutputPV 包含请求或当前活动的枚
WaterFreezeDetectorWaterFreezeDetector
StepValue指示或设置步进增量（如音量调节）
LockOperationError门锁操作因各种原因失败时，门锁将发出 LockOperati
SupportedRemoteFeatures支持的远程特性
NumberOfCredentialsSupportedPerUser每用户可支持凭证数
NumberOfTotalUsersSupported门锁总用户量
NumberOfYearDaySchedulesSupportedPerUser每用户可支持年日程数
NumberOfPINUsersSupportedPIN用户量
RemoteControlWithAuthCode远程控制（带授权码）-绿米私有
RemoteUnlock远程解锁--绿米私有
NumberOfRFIDUsersSupportedRFID用户量
NumberOfWeekDaySchedulesSupportedPerUser每用户可支持周日程数
VacuumOperationalErrorVacuumOperationalError 指设备或系统无
DefaultOpenDurationDefaultOpenDuration 表示若 OpenDu
RemainingDurationRemainingDuration 指阀在自动关闭之前将继续
SamplingInterval定义数据采样时间间隔
CameraRTSPURL指示摄像头的 RTSP（Real Time Streamin
P2PCaptureStatusP2P动态趣图状态开关
CameraRTSPEnable指示摄像头 RTSP（Real Time Streaming
GestureRecognitionReport使设备通过视觉传感器识别特定用户手势
BreathingMonitoringBreathingMonitoring
BreathingRate实时测量每分钟呼吸次数
CharStringValuePV指示 CharacterString Value Objec
VehicleIDVehicleID 为每辆电动汽车（EV）分配的唯一标识符
EvseFaultStateEvseFaultState 表示电动汽车供电设备（EVSE
BuiltInEffects该 Trait 包含设备支持的全部内置效果列表
MaxUserDefinedEffects指示窗饰设备可支持的用户自定义场景最大数量
CurrentEffectID指示窗饰设备当前激活场景的 EffectID
EffectInfo该 Trait 提供效果信息列表，每项包含 EffectID
MaxEffectNameLength指示窗饰设备用户自定义场景中 EffectName 字段允许
UserDefinedEffects该 Trait 包含设备当前存储的全部用户自定义效果列表
OnTransitionTime指示同端点 On/Off Cluster 接收到 On
OffTransitionTime指示同端点 On/Off Cluster 接收到 Off
ColorModeColorMode trait 用于表示照明设备当前所工作的
WhitePointXY定义白点在 CIE 1931 色度空间中的 X、Y 坐标，用
LEDICQuantity指示调光驱动器 IC 的数量
ColorRGBColorRGB表示RGB颜色空间中的RGB颜色值
ColorXYColorXY 表示 CIE 1931 色彩空间中的 x 与
StartUpXYColorColorXY表示CIE xyY颜色空间中的x和y值，包含C
LightingMusicSyncMode确定启用后灯光如何随音乐响应（如随机效果、呼吸过渡、彩虹流动
StartUpColorTemperature设置设备上电且灯开启时应用的默认色温
LightingDynamicSceneMode支持动态灯光效果（如彩虹流动、呼吸渐变、闪烁等），并提供“正
LightingMusicSyncEnable使灯光颜色与亮度随音乐节奏同步变化，实现动态视听效果
ColorPointRGBXY定义 RGB 三基色在 CIE 1931 色度空间中的坐标点
LEDICProtocol指示 LED 的 IC 协议
LEDType指示 LED 灯珠类型
MotorSpeedPercentage定义电机运行速度百分比，范围为 1（最低速）至 100（最高
WindowCoveringCategory由窗帘类设备上报，用于将窗饰设备划分为大类
UnconfiguredTravelControlPermission用于指示窗帘电机设备未配置行程时是否允许控制
LimitPointSetting用于配置窗帘电机限位点，具体设置全开或全关限位位置
ObstacleLimitMarkingBlockTime障碍物限位标记功能被禁用的时长（秒）
MotorSpeedSetting定义电机运行速度档位，范围为 1（最低速）至 2（最高速）
ManualPullStartStopEnabled启用允许用户通过拉动手动启停窗帘/窗饰移动的功能
ObstacleLimitSensitivity指窗帘电机遇到障碍物时的灵敏度设置
TravelConfigured指示窗帘电机行程（运动范围）是否已配置
WindowCoveringType标识窗饰产品类型（如卷帘、百叶窗、窗帘等）
ObstacleLimitAutoReboundEnable启用后，窗帘电机遇障碍物时反转方向，防止损坏
ManualPullEvent跟踪或发出由窗饰设备手动拉动交互触发的事件
WindowCoveringOpenOrientation标识自动控制的实际窗饰开启方向
ManualPullStartEnabled启用允许用户通过拉动手动启动窗帘/窗饰移动的功能
LimitPointCount表示为窗帘类电机配置的限位点（或行程限位）数量
TargetPositionRotationPercentageTargetPositionRotationPercenta
CurrentPositionRotationPercentageCurrentPositionRotationPercent
ManualPullStopEnabled启用允许用户通过拉动手动停止窗帘/窗饰移动的功能
ObstacleLimitMarkingEnable启用或禁用电机遇阻时标记限位点（开或关）的功能
ManualPullAdaptiveSpeedEnabled允许在手动拉力操作期间进行自适应速度调整，提供基于拉力的可变
DurationOccupiedWithinOneWeek表示 occupancy 传感器在一周内（从周一 00:00
DurationOccupiedWithinOneDay表示 occupancy 传感器在一天内检测到被占用的总时长
FireProductIdentification消防识别码
SmokeChamberContamination指示烟腔污染状态
AlarmError报警错误
SmokeState烟雾状态
AlarmsEnabled报警使能
ContaminationState报警器污染
EnableHeartbeatIndicator心跳指示灯控制
AnalogOutputPVAnalogOutputPV携带模拟输出对象的指令值或实际值
PetRecognitionReport使智能设备准确识别宠物类型
AnomalySoundDetected该功能使设备能够智能识别环境中的异常声音
RingtonePlayVolume指示播放铃声或音乐的音量等级
RingtonePlayIndex指示待播放铃声或音乐的索引
RingtonePlayStatus指示铃声或音乐当前播放状态
RingtonePlayDuration指示铃声或音乐播放时长
BridgedNodeList表示添加到此 Bridge Node 的桥接节点 Devic
SupportedHubCapability该属性以位掩码形式上报网关作为智能家居中枢所具备的核心功能特
MatterBridgeSupported指示当前网关版本是否支持 Matter Bridge 功能
MatterDACState指示 Matter 设备认证证书（DAC）的就绪状态
MatterOnboardingPayload提供 Matter 配网所需的入网信息
MatterManufacturerList提供设备已绑定的 Matter 生态系统（fabric）列表
MatterBindState指示设备的 Matter 绑定状态
MatterPairingState指示当前 Matter 配对状态或错误原因
MatterPairingSwitch写入 true 时在网桥上启动 Matter 配对模式；若未
BinaryInputPVBinaryInputPV报告离散输入的瞬时逻辑状态，并可选
VehicleDetected使设备识别监控区域内的车辆

SupportedEndpointDynamic​

指示当前 Device 实例是否支持动态配置。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✘✔

EndpointCount​

指示当前 Device 所包含的 Endpoint 数量。

参数​

名称类型默认值可读可写可上报
当前值int32✔✘✔
最大值int3265279.0✔✘✘
最小值int322.0✔✘✘
步长uint321.0✔✘✘

EndpointStructure​

描述当前 Device 所用配置实例中 Endpoint 的层级结构（嵌套关系）。

参数​

名称类型默认值可读可写可上报
当前值EndpointStructureTraitPresentValueStructure✔✘✔

EndpointDeviceTypes​

描述当前 Device 所有配置实例中各 Endpoint 的 Device Type，与 EndpointArray 或 EndpointArrayDynamic 配合使用。

参数​

名称类型默认值可读可写可上报
当前值list✔✘✔

EndpointDynamicCount​

指示当前 Device 支持的动态 Endpoint 配置实例数量。默认值为 1。

参数​

名称类型默认值可读可写可上报
当前值int32✔✘✔
最大值int3265279.0✔✘✘
最小值int320.0✔✘✘
步长uint321.0✔✘✘

EndpointArrayDynamic​

描述当前 Device 实例使用的 Endpoint 组合。与 EndpointArray 互斥（同一时刻仅其一有效）。

参数​

名称类型默认值可读可写可上报
当前值list✔✘✔

EndpointArray​

描述当前 Device 所包含 Endpoint 的所有可能组合。与 SupportedEndpointDynamic、EndpointDynamicCount 和 SelectedEndpointDynamic 配合使用。

参数​

名称类型默认值可读可写可上报
当前值list✔✘✔

EndpointFunctions​

该 Trait 用于「节点功能」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值list✔✘✔

SelectedEndpointDynamic​

表示 EndpointArray 的数组索引，指示当前选中的 Device Endpoint 配置实例。

参数​

名称类型默认值可读可写可上报
当前值int32✔✔✔
最大值int3265279.0✔✘✘
最小值int320.0✔✘✘
步长uint321.0✔✘✘

ProductName​

指定节点型号的可读（可显示）名称，例如厂商分配的型号（或其他标识符）。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

PartNumber​

该 Trait 用于「部件编号」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

BLVersion​

指定 Bootloader 版本。最大长度为 64 字节的 UTF-8 字符。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

ManufacturerChipID​

标识制造商芯片 ID。

参数​

名称类型默认值可读可写可上报
当前值uint16✔✘✔
最大值uint1665535.0✔✘✘
最小值uint160.0✔✘✘
步长uint321.0✔✘✘

SupportedMatterRoles​

指示设备支持的 Matter 角色，如 Thread Border Router、Matter Controller、Matter Commissioner、Matter Bridge。每一位代表一种角色。

参数​

名称类型默认值可读可写可上报
当前值uint8✔✘✔
最大值uint8255.0✔✘✘
最小值uint80.0✔✘✘
步长uint321.0✔✘✘

HardwareVersionString​

指定节点硬件的版本号。其取值含义及版本编号规则由厂商定义。该属性用于提供比 HardwareVersion 属性更便于用户理解的取值。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

HubConnectionStatus​

指示设备与中央 Hub 的连接状态，用于判断设备当前是否已连接中央 Hub。

参数​

名称类型默认值可读可写可上报
当前值HubConnectionStatusEnum80✔✘✔
支持的值list[HubConnectionStatusEnum8]✔✘✘
默认值uint80✔✔✘

DeviceXCode​

表示设备的 device type X code。

参数​

名称类型默认值可读可写可上报
当前值uint16✔✘✔
最大值uint1665535.0✔✘✘
最小值uint160.0✔✘✘
步长uint321.0✔✘✘

MatterSpecificationVersion​

该 Trait 用于「Matter规范的版本号」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

VendorName​

该 Trait 用于「厂商名」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

FirmwareRevisionString​

该 Trait 用于「固件版本号」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

DeviceID​

表示设备的唯一标识符。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

VendorID​

该 Trait 用于「厂商ID」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

MCUVersion​

指定 MCU 版本。（当前值：String(64)，默认 null）

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

ProductID​

指定厂商分配的唯一标识该节点具体产品的数字 ID。

参数​

名称类型默认值可读可写可上报
当前值uint16✔✘✔
最大值uint1665535.0✔✘✘
最小值uint160.0✔✘✘
步长uint321.0✔✘✘

ConfigurationFlag​

指示配置状态。标志设为 1 时，设备需先配置方可正常使用。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✘✔

ModelValue​

AIOT 模型值，例如 lumi.gateway.cn01

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

HardwareVersion​

指定节点硬件的版本号。其取值含义及版本编号规则由厂商定义。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

Mac​

指定设备的 MAC 地址。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

RadarVersion​

指定雷达模块版本。（当前值：String(64)，默认 null）

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

SerialNumber​

该 Trait 用于「序列号」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

ConfigurationVersion​

用于存储设备的 ConfigurationVersion 和物模型 MD5。每次 App 直连设备并构建新物模型时，将该特征与云端物模型比对，再决定更新物模型或上报新的特征值。

参数​

名称类型默认值可读可写可上报
当前值ConfigurationVersionTraitPresentValueStructure✔✔✔

Reachable​

指示设备是否可达。0：Offline，1：Online。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✘✔

FirmwareRevision​

包含在此节点上运行的软件的当前版本号。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

ChipTemperature​

指示设备测得的当前温度。

参数​

名称类型默认值可读可写可上报
当前值float0✔✘✔
最大值float1000.0✔✘✘
最小值float-50.0✔✘✘
步长uint320.01✔✘✘
默认值float0✔✔✘

Location​

该 Trait 用于「地区」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

EndpointTag​

该属性的当前值应为命名空间内语义标签的 ID。0 表示“聚合”能力，N（N > 0）指定第 N 个通道的能力。

参数​

名称类型默认值可读可写可上报
当前值uint16✔✘✔
最大值uint1665535.0✔✘✘
最小值uint160.0✔✘✘
步长uint321.0✔✘✘

EndpointName​

描述 Endpoint 名称，字符串格式，最大长度 32。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✔✔

EndpointApplianceType​

描述当前家电类型（如 Light、Fan、Air Conditioner 等）。可选类型列表因 Device Type 而异。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✔✔
支持的值list[characterString]✔✘✘

EndpointRoom​

描述 Endpoint 所在房间的 ID，字符串格式，最大长度 32 字节。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✔✔

EndpointVisibility​

描述当前 Device 所包含全部 Endpoint 的可见性。0：Invisible，1：Visible。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✘✔

EndpointIcon​

描述当前图标 ID。可选图标列表因 Device Type 而异，厂商不可自定义。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✔✔

EndpointStatistics​

描述设备是否可纳入统计功能。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✔✔

EndpointRoomName​

描述 Endpoint 所在房间名称，字符串格式，最大长度 128 字节。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✔✔

VoiceLanguage​

用于语音提示和语音反馈的语言。

参数​

名称类型默认值可读可写可上报
当前值VoiceLanguageEnum81✔✔✔
支持的值list[VoiceLanguageEnum8]✔✘✘
默认值uint81✔✔✘

EnergySavingEnable​

启用或禁用节能模式。启用后，座温、水温等维持最低水平以降低能耗。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✔✔

CurrentSensitivityLevel​

指示当前所选通用配置灵敏度等级。

参数​

名称类型默认值可读可写可上报
当前值uint8✔✔✔
最大值uint8255.0✔✘✘
最小值uint80.0✔✘✘
步长uint321.0✔✘✘

TransmissionPowerSetting​

用于设置设备发射功率的专用特征。

参数​

名称类型默认值可读可写可上报
当前值float✔✔✔
最大值float10.0✔✘✘
最小值float-32.0✔✘✘
步长uint321.0✔✘✘

HubArkTechEnable​

用于启用或禁用 Aqara Ark Technology 下代理网关的本地容灾能力。启用后，若网关故障或断电，且网关下部分 Zigbee 设备可充当代理网关，则由代理网关负责执行部分基础本地自动化、场景和设备组。

参数​

名称类型默认值可读可写可上报
当前值boolean1✔✔✔
默认值boolean1✔✔✘

BeepEnable​

启用或禁用设备操作的声音反馈提示音。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✔✔

NightLightMode​

设置夜灯模式。Auto 模式下，设备根据环境光自动开关夜灯。

参数​

名称类型默认值可读可写可上报
当前值NightLightModeEnum8✔✔✔
支持的值list[NightLightModeEnum8]✔✘✘

OutputInterlockFlag​

当两个属性的取值相同时，表示这两个属性对应的状态处于互锁关系。

参数​

名称类型默认值可读可写可上报
当前值uint80✔✔✔
最大值uint8255.0✔✘✘
最小值uint80.0✔✘✘
步长uint321.0✔✘✘
默认值uint80✔✔✘

ActivityDetectionModeSetting​

指定设备用于检测和识别特定活动或状态的当前工作模式，例如人体存在检测、跌倒检测、睡眠监测或手势识别。

参数​

名称类型默认值可读可写可上报
当前值ActivityDetectionModeSettingEnum321✔✔✔
支持的值list[ActivityDetectionModeSettingEnum32]✔✘✘
默认值uint321✔✔✘

TimeZone​

该属性用于设置并上报设备所在时区（如中国标准时间为 "GMT+8"）。正确的时区配置确保设备系统时间、定时任务（如定时器）及日志时间戳与用户实际地理时间一致，是所有时间相关功能准确运行的基础。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✔✔

NumberOfSensitivityLevelIsSupported​

该 Trait 用于「支持的灵敏度级别数量」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值uint8✔✔✔
最大值uint8255.0✔✘✘
最小值uint80.0✔✘✘
步长uint321.0✔✘✘

PollingTime​

设置设备与网络通信的轮询时间间隔。

参数​

名称类型默认值可读可写可上报
当前值uint320✔✔✔
最大值uint32250000.0✔✘✘
最小值uint320.0✔✘✘
步长uint32250.0✔✘✘
默认值uint320✔✔✘

InstallationOrientationConfiguration​

该 Trait 用于「安装方向配置」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值InstallationOrientationConfigurationEnum160✔✔✔
支持的值list[InstallationOrientationConfigurationEnum16]✔✘✘
默认值uint160✔✔✘

DetectionModeSetting​

指示设备当前检测模式设置，决定设备将监测并上报的事件或状态类型。此为可配置参数，可在不同检测场景间切换。

参数​

名称类型默认值可读可写可上报
当前值DetectionModeSettingEnum160✔✔✔
支持的值list[DetectionModeSettingEnum16]✔✘✘
默认值uint160✔✔✘

LightingModeSetting​

定义灯具的工作模式。

LightingModeSetting trait 用于设置或查询照明设备的当前工作模式。该模式决定了设备所开放的控制能力范围，包括开关控制、亮度调节、色温调节以及颜色设置等功能的可用性。目前支持的模式有四种，分别为：单色模式（Level）、色温模式（ColorTemp）、RGB模式（RGB）和RGBW模式（RGBW模式）。不同模式下，设备对外提供的数据点和可执行操作有所区别。

具体来说，当灯设备处于单色模式时，其仅支持开关状态控制和亮度调节控制，不支持色温控制，也不支持任何颜色设置，这种模式适用于仅需调光功能的单色温灯具。当设备处于色温模式时，其在开关和亮度控制之外，额外支持色温调节，能够实现从暖白到冷白的平滑变化，但依旧不支持RGB或RGBW颜色设置，适用于双色温灯具。当设备切换到RGB模式时，除了开关、亮度和色温控制（色温可通过RGB通道混合模拟）之外，还支持RGB全彩颜色设置，可自由调节任意色彩，但不支持独立白光通道。当设备处于RGBW模式时，则在RGB模式的基础上进一步增加了独立的白色通道，支持RGBW四通道颜色设置，能够同时呈现鲜艳彩色和纯正白光，满足更丰富的照明场景需求。

需要特别强调的是，工作模式的设定并非软件层面的任意切换，通常需要结合灯具的物理接线方案和实际的部署情况来确定。例如，若灯具仅连接了冷暖白光LED，则不应设置为RGB模式或RGBW模式；若灯具带有RGB+W独立引脚，则可设置为RGBW模式。模式一旦修改，设备的物模型配置将同步进行动态更新——在新的工作模式下不支持的数据点会被自动隐藏，不再出现在物模型中，而新模式下支持的数据点则会按需展现。这种机制确保了客户端能够正确识别当前设备的能力范围，避免下发无效指令。因此，在修改该模式之前，必须充分确认硬件是否支持目标模式，且模式变更应慎重进行，不应随意更改，以免导致设备控制功能异常或客户端界面与实际能力不匹配。

参数​

名称类型默认值可读可写可上报
当前值LightingModeSettingEnum80✔✔✔
支持的值list[LightingModeSettingEnum8]✔✘✘
默认值uint80✔✔✘

ResetMode​

支持执行包括出厂重置、重置网络配置在内的操作。

参数​

名称类型默认值可读可写可上报
当前值ResetModeEnum8✔✔✔
支持的值list[ResetModeEnum8]✔✘✘

MagicPairPayload​

提供 MagicPair 入网所需的配对信息。值为结构体，包含：QRCode（配对二维码原始字符串）和 DigitalPairingCode（8 位数字配对码）。设备未绑定时，读取该载荷可能激活 MagicPair 配网窗口一段时间（默认 10 分钟）。

参数​

名称类型默认值可读可写可上报
当前值MagicPairPayloadTraitPresentValueStructure✔✘✔

SupportedEcosystem​

指示设备支持的生态（如 Aqara Hub M3 支持 Aqara Home、Apple HomeKit 和 Matter）。值为位掩码：bit0 = Aqara Home，bit1 = Apple HomeKit，bit2 = Matter，bit3 = Aqara Studio，bit4–7 保留。

参数​

名称类型默认值可读可写可上报
当前值uint8✔✘✘
最大值uint8255.0✔✘✘
最小值uint80.0✔✘✘
步长uint321.0✔✘✘

MatterPayload​

提供 Matter 配网所需的配对信息。值为结构体，包含：QRCode（配对二维码原始字符串）和 DigitalPairingCode（11 位或 21 位数字配对码）。设备未绑定时，读取该载荷可能激活 Matter 配网窗口一段时间（默认 10 分钟）。

参数​

名称类型默认值可读可写可上报
当前值MatterPayloadTraitPresentValueStructure✔✘✔

HomeKitPayload​

提供 HomeKit 配网所需的配对信息。值为结构体，包含：QRCode（配对二维码原始字符串）和 DigitalPairingCode（8 位数字配对码）。设备未绑定时，读取该载荷可能激活 HomeKit 配网窗口一段时间（默认 10 分钟）。

参数​

名称类型默认值可读可写可上报
当前值HomeKitPayloadTraitPresentValueStructure✔✘✔

BoundEcosystem​

指示设备已绑定的生态。值为位掩码：bit0 = Aqara Home，bit1 = Apple HomeKit，bit2 = Matter，bit3 = Aqara Studio，bit4–7 保留（应为 0）。例如值 0x03 表示同时绑定 Aqara Home 和 HomeKit。

参数​

名称类型默认值可读可写可上报
当前值uint8✔✘✘
最大值uint8255.0✔✘✘
最小值uint80.0✔✘✘
步长uint321.0✔✘✘

CurrentVoltage​

指示当前测得的电源电压值。单位：伏特（V）。

参数​

名称类型默认值可读可写可上报
当前值float✔✘✔
最大值float500.0✔✘✘
最小值float0.0✔✘✘
步长uint320.01✔✘✘

CircuitCurrent​

流经特定电路或电路部分的电流，通常用于测量电流负载。

参数​

名称类型默认值可读可写可上报
当前值float0✔✘✔
最大值float10000.0✔✘✘
最小值float0.0✔✘✘
步长uint320.001✔✘✘
默认值float0✔✔✘

CumulativeEnergyConsumption​

该 Trait 用于「累计耗电量」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值float✔✘✔
最大值float1.0E8✔✘✘
最小值float0.0✔✘✘
步长uint320.1✔✘✘

CurrentPower​

指示当前实时功耗。单位：瓦特（W）。

参数​

名称类型默认值可读可写可上报
当前值float✔✘✔
最大值float5000.0✔✘✘
最小值float0.0✔✘✘
步长uint320.1✔✘✘

BatReplacementDescription​

该特征应提供面向用户的电池描述。

参数​

名称类型默认值可读可写可上报
当前值string32✔✘✔
支持的值list[characterString]✔✘✘

BatChargeState​

指示电池充电状态。0：Unknown，1：Charging，2：Full charge，3：Not charging，4：Not chargeable。

参数​

名称类型默认值可读可写可上报
当前值BatChargeStateEnum8✔✘✔
支持的值list[BatChargeStateEnum8]✔✘✘

BatReplaceability​

该特征应指示电池是否可更换。

参数​

名称类型默认值可读可写可上报
当前值BatReplaceabilityEnum8✔✘✔
支持的值list[BatReplaceabilityEnum8]✔✘✘

PowerMode​

指示设备的供电模式。0：未知，1：市电，2：电池，3：直流电源。

参数​

名称类型默认值可读可写可上报
当前值PowerModeEnum8✔✘✔
支持的值list[PowerModeEnum8]✔✘✘

BatPercentRemaining​

指示剩余电池电量百分比。

参数​

名称类型默认值可读可写可上报
当前值float50✔✘✔
最大值float100.0✔✘✘
最小值float0.0✔✘✘
步长uint320.1✔✘✘
默认值float50✔✔✘

WiredPresent​

指示是否检测到有线电源（电源适配器）。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✔✔

Rechargeable​

该特征应指示电池是否可充电。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✘✔

StateOfLowBat​

指示电池是否处于低电量状态。0：正常，1：低电量，2：严重不足。

参数​

名称类型默认值可读可写可上报
当前值StateOfLowBatEnum8✔✘✔
支持的值list[StateOfLowBatEnum8]✔✘✘

BatReplacementNeeded​

该特征应指示电池是否需要更换。

参数​

名称类型默认值可读可写可上报
当前值boolean0✔✘✔
默认值boolean0✔✔✘

BatQuantity​

该特征应指示电池源中可由用户或工厂维护的独立电池单元或电池组数量。

参数​

名称类型默认值可读可写可上报
当前值uint8✔✘✔
最大值uint8255.0✔✘✘
最小值uint80.0✔✘✘
步长uint321.0✔✘✘

LoadSafetyManagement​

一种监控电气或机械负载的安全机制。

参数​

名称类型默认值可读可写可上报
当前值LoadSafetyManagementEnum80✔✘✔
支持的值list[LoadSafetyManagementEnum8]✔✘✘
默认值uint80✔✔✘

VoltageSafetyManagement​

一种安全机制，用于监控电源电压，在过电压或欠电压异常期间进行保护。

参数​

名称类型默认值可读可写可上报
当前值VoltageSafetyManagementEnum80✔✘✔
支持的值list[VoltageSafetyManagementEnum8]✔✘✘
默认值uint80✔✔✘

CurrentSafetyManagement​

一种监控设备电流的安全机制，在过电流异常期间触发保护。

参数​

名称类型默认值可读可写可上报
当前值CurrentSafetyManagementEnum80✔✘✔
支持的值list[CurrentSafetyManagementEnum8]✔✘✘
默认值uint80✔✔✘

OverCurrentResponseSetting​

该配置设置过流保护的作用范围。

参数​

名称类型默认值可读可写可上报
当前值OverCurrentResponseSettingEnum8✔✔✔
支持的值list[OverCurrentResponseSettingEnum8]✔✘✘

TemperatureSafetyManagement​

监控设备温度的安全机制，在发生超温异常时触发保护措施。

参数​

名称类型默认值可读可写可上报
当前值TemperatureSafetyManagementEnum80✔✘✔
支持的值list[TemperatureSafetyManagementEnum8]✔✘✘
默认值uint80✔✔✘

RebootCount​

当前值应尽可能准确地指示设备已重启的次数。每次设备重启时应递增。设备从低功耗或睡眠状态唤醒时不应递增。仅在设备出厂重置时应重置为 0。

参数​

名称类型默认值可读可写可上报
当前值uint32✔✘✔
最大值uint1665535.0✔✘✘
最小值uint160.0✔✘✘
步长uint321.0✔✘✘

RebootReason​

当前值应指示设备最近一次启动的原因。

参数​

名称类型默认值可读可写可上报
当前值RebootReasonEnum8✔✘✔
支持的值list[RebootReasonEnum8]✔✘✘

UpTime​

UpTime 特征应尽可能准确地指示自节点上次重启以来经过的时间长度（秒）。

参数​

名称类型默认值可读可写可上报
当前值uint320✔✘✔
最大值uint324.2949673E9✔✘✘
最小值uint320.0✔✘✘
步长uint321.0✔✘✘
默认值uint320✔✔✘

NetworkInterfaces​

该特征描述设备支持的网络接口。

参数​

名称类型默认值可读可写可上报
当前值list[NetworkInterfacesTraitPresentValueStructure]✔✘✔

AntiDeletionSetting​

用于设置防止误删的功能。

参数​

名称类型默认值可读可写可上报
当前值AntiDeletionSettingEnum80✔✔✔
支持的值list[AntiDeletionSettingEnum8]✔✘✘
默认值uint80✔✔✘

AntiDeletionLevelSetting​

反删除级别设置控制设备运行期间复位网络和出厂复位按钮操作的权限，防止意外数据丢失。

参数​

名称类型默认值可读可写可上报
当前值AntiDeletionLevelSettingEnum80✔✔✔
支持的值list[AntiDeletionLevelSettingEnum8]✔✘✘
默认值uint80✔✔✘

ActiveHardwareFaults​

硬件错误

参数​

名称类型默认值可读可写可上报
当前值ActiveHardwareFaultsEnum32255✔✘✔
支持的值list[ActiveHardwareFaultsEnum32]✔✘✘
默认值uint32255✔✔✘

DebugInfo​

设备运行期间的调试信息。数据类型为字符串，最大长度为 1024 字节。

参数​

名称类型默认值可读可写可上报
当前值characterString✘✘✔

FreeMemory​

指示设备当前可用内存大小，单位为千字节（KB）。

参数​

名称类型默认值可读可写可上报
当前值uint32✔✘✔
最大值uint324.2949673E9✔✘✘
最小值uint320.0✔✘✘
步长uint321.0✔✘✘

AntiDeletionNotification​

为集线器上的子设备启用AntiDeletion功能后，如果子设备执行重置/删除操作，将触发通知报告。

参数​

名称类型默认值可读可写可上报
当前值AntiDeletionNotificationEnum8✘✘✔
支持的值list[AntiDeletionNotificationEnum8]✔✘✘

RoutingAgingCountThreshold​

设备数据包路由的老化计数阈值设置。

参数​

名称类型默认值可读可写可上报
当前值uint85✔✔✔
最大值uint820.0✔✘✘
最小值uint83.0✔✘✘
步长uint321.0✔✘✘
默认值uint85✔✔✘

PreOperationMode​

表示设备先前的 Zigbee 网络连接状态。

参数​

名称类型默认值可读可写可上报
当前值PreOperationModeEnum8✔✘✔
支持的值list[PreOperationModeEnum8]✔✘✘

NWKRetransmissionCount​

指示数据包传输期间网络层的重传次数。

参数​

名称类型默认值可读可写可上报
当前值uint83✔✔✔
最大值uint820.0✔✘✘
最小值uint83.0✔✘✘
步长uint321.0✔✘✘
默认值uint83✔✔✘

ZigbeeTotalMessageInOneHour​

指示 1 小时内发送的 Zigbee 消息总数。

参数​

名称类型默认值可读可写可上报
当前值uint32✔✘✔
最大值uint324.2949673E9✔✘✘
最小值uint320.0✔✘✘
步长uint321.0✔✘✘

ZigbeeCoordMac​

用于表示 Zigbee 协调器的 MAC 地址。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

APSRetransmissionCount​

ZigBee APS 层在数据包未收到确认时尝试的自动重传次数。

参数​

名称类型默认值可读可写可上报
当前值uint83✔✔✔
最大值uint820.0✔✘✘
最小值uint83.0✔✘✘
步长uint321.0✔✘✘
默认值uint83✔✔✘

ZigbeeResentMessageInOneHour​

表示一小时内重发的 Zigbee 消息数量。

参数​

名称类型默认值可读可写可上报
当前值uint32✔✘✔
最大值uint324.2949673E9✔✘✘
最小值uint320.0✔✘✘
步长uint321.0✔✘✘

PANID​

当前值指示 Zigbee 网络 PAN ID。

参数​

名称类型默认值可读可写可上报
当前值uint16✔✘✔
最大值uint1665534.0✔✘✘
最小值uint160.0✔✘✘
步长uint321.0✔✘✘

ZigbeeExtendedPANID​

表示Zigbee网络的64位扩展标识符的字符串。它与16位PAN ID一起用于唯一标识网络，通常表示为16个字符的十六进制字符串（例如“00124B0001234567” ）。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

ZigbeeGeneralDiagnostics​

子设备自诊断信息的通用报告渠道。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

MessageTransmissionFailureCountThreshold​

设备数据包传输失败的阈值计数设置。

参数​

名称类型默认值可读可写可上报
当前值uint810✔✔✔
最大值uint820.0✔✘✘
最小值uint83.0✔✘✘
步长uint321.0✔✘✘
默认值uint810✔✔✘

EnableNWKACK​

切换在网络通信中启用网络层确认的选项。

参数​

名称类型默认值可读可写可上报
当前值boolean0✔✔✔
默认值boolean0✔✔✘

RebootReason​

当前值应指示设备最近一次启动的原因。

参数​

名称类型默认值可读可写可上报
当前值RebootReasonEnum8✔✘✔
支持的值list[RebootReasonEnum8]✔✘✘

ZigbeeKeySeqNumber​

表示 Zigbee 协调器当前使用的 network key 序列号，用于标识密钥版本。Magic Pair 入网过程中，网关向云端或 App 上报该属性，入网设备必须获取该序列号并在本地配置，以确保与协调器使用相同 network key 的安全通信。默认值为 0。

参数​

名称类型默认值可读可写可上报
当前值uint80✔✘✔
最大值uint8255.0✔✘✘
最小值uint80.0✔✘✘
步长uint321.0✔✘✘
默认值uint80✔✔✘

LQI​

指示 Thread 网络的 Link Quality Indicator（LQI），反映 Thread 设备间 RF 链路质量。范围：0–255。

参数​

名称类型默认值可读可写可上报
当前值uint8✔✘✔
最大值uint8255.0✔✘✘
最小值uint80.0✔✘✘
步长uint321.0✔✘✘

ZigbeeFrameCounter​

ZigBee 帧计数器为每条数据帧附加的唯一递增值，用于防止重放攻击并保障通信安全。

参数​

名称类型默认值可读可写可上报
当前值uint32✔✘✔
最大值uint324.2949673E9✔✘✘
最小值uint320.0✔✘✘
步长uint321.0✔✘✘

Channel​

当前值指示 Zigbee 网络信道号。

参数​

名称类型默认值可读可写可上报
当前值uint16✔✘✔
最大值uint1665535.0✔✘✘
最小值uint160.0✔✘✘
步长uint321.0✔✘✘

CCAMode​

指示设备的 CCA 状态。

参数​

名称类型默认值可读可写可上报
当前值CCAModeEnum8✔✘✔
支持的值list[CCAModeEnum8]✔✘✘

ZigbeeNextHopMac​

定义下一跳设备的 Zigbee MAC 地址。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

EnableAPSACK​

切换在网络通信中启用 APS 确认的选项。

参数​

名称类型默认值可读可写可上报
当前值boolean0✔✔✔
默认值boolean0✔✔✘

MACRetransmissionCount​

指示数据包传输期间 MAC 层的重传次数。

参数​

名称类型默认值可读可写可上报
当前值uint83✔✔✔
最大值uint814.0✔✘✘
最小值uint83.0✔✘✘
步长uint321.0✔✘✘
默认值uint83✔✔✘

ZigbeeFailedMessageInOneHour​

表示一小时内发送失败的 Zigbee 消息数量。

参数​

名称类型默认值可读可写可上报
当前值uint32✔✘✔
最大值uint324.2949673E9✔✘✘
最小值uint320.0✔✘✘
步长uint321.0✔✘✘

ZigbeeNeighborTableInfo​

提供 Zigbee 设备的网络拓扑信息。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

CurOperationMode​

表示设备当前的 Zigbee 网络连接状态。

参数​

名称类型默认值可读可写可上报
当前值CurOperationModeEnum8✔✘✔
支持的值list[CurOperationModeEnum8]✔✘✘

ZigbeeAvgSuccessfulResendCount​

指示 Zigbee 消息成功重发的平均次数。

参数​

名称类型默认值可读可写可上报
当前值uint32✔✘✔
最大值uint324.2949673E9✔✘✘
最小值uint320.0✔✘✘
步长uint321.0✔✘✘

ZigbeeCoordNetworkKey​

用于表示 Zigbee 协调器的网络密钥。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

LanAccessAddress​

路由器在家庭局域网（LAN）中为设备分配的 IP 地址（通常通过 DHCP）。同一网络上的其他设备（如手机 App、电脑）凭此地址在本地以低时延发现并通信。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

RemoteProxyAccessEnable​

远程代理访问启用开关。该属性用于启用或禁用设备通过互联网云端代理被远程访问的能力。启用后，授权用户可通过安全云端隧道远程控制设备；禁用后，设备仅可在局域网（LAN）内访问。

参数​

名称类型默认值可读可写可上报
当前值boolean0✔✔✔
默认值boolean0✔✔✘

InternetAccessAddress​

云服务平台为设备分配的公网访问地址（通常为域名或 NAT 映射地址）。远程管理服务凭此地址定位并连接该设备，反映设备在广域网（WAN）中的逻辑位置。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

IdentifyType​

指定向用户呈现标识的方式。取值：0 = 无，1 = 灯光，2 = LED 指示灯，3 = 声音提示，4 = 显示屏（屏幕可见），5 = 执行器（如窗帘或继电器动作），6–255 = 保留。

参数​

名称类型默认值可读可写可上报
当前值IdentifyTypeEnum8✔✔✔
支持的值list[IdentifyTypeEnum8]✔✘✘

ReverseIdentify​

触发时（通过设备上的本地操作，如按键或触屏交互），设备向所有已连接的客户端工具（如手机 App、Web 应用或桌面软件）发送信号，以在该工具中定位并识别对应设备。用户可通过物理操作设备，快速在工具中找到该设备。

参数​

名称类型默认值可读可写可上报
当前值uint8✘✘✔
最大值uint8255.0✔✘✘
最小值uint80.0✔✘✘
步长uint321.0✔✘✘

IdentifyTime​

指示设备将继续进行自标识的剩余时长（秒）。取值范围为 0 至 10，步长 0.1，单位为秒（s）。当值为 0 时，使用默认剩余时长。

参数​

名称类型默认值可读可写可上报
当前值float✔✘✔
最大值float10.0✔✘✘
最小值float0.0✔✘✘
步长uint320.1✔✘✘

HomeStationCredentials​

Home Station Credentials信息

参数​

名称类型默认值可读可写可上报
当前值HomeStationCredentialsTraitPresentValueStructure✔✘✔

WiFiChannel​

Wi-Fi 信道，如 2.4GHz 频段信道 1–14 或 5GHz 频段信道 149、153、157、161、165 等。

参数​

名称类型默认值可读可写可上报
当前值uint16✔✘✔
最大值uint16165.0✔✘✘
最小值uint161.0✔✘✘
步长uint321.0✔✘✘

ChildDeviceProvisioningState​

供网关上报子设备（如 Zigbee 设备、Matter 设备等）配网窗口状态。网关为某类子设备开放网络时上报“进入配网状态”；关闭该类子设备配网窗口时上报“退出配网状态”。上层应用据此实时感知网关是否处于允许添加某类子设备的状态，以引导用户操作或显示配网进度。

参数​

名称类型默认值可读可写可上报
当前值ChildDeviceProvisioningStateEnum80✔✘✔
支持的值list[ChildDeviceProvisioningStateEnum8]✔✘✘
默认值uint80✔✔✘

ZigbeeDiagnostics​

提供 Zigbee 网络的诊断信息。包括无线电信道、extended PAN ID、network key、network name、PAN ID、RSSI（如可用）及 LQI（链路质量指示）。

参数​

名称类型默认值可读可写可上报
当前值ZigbeeDiagnosticsTraitPresentValueStructure✔✘✔

ZigbeeAuthRandcode​

Zigbee 3.0 设备连接云端进行认证时，由云端下发的随机数。

参数​

名称类型默认值可读可写可上报
当前值characterString✘✔✘

ZigbeeAuthRandcodeResponse​

Zigbee 3.0 设备与云端认证时返回的 Confirm 结果。

参数​

名称类型默认值可读可写可上报
当前值characterString✘✘✔

WiFiDiagnostics​

提供 Wi‑Fi 网络的诊断信息。包括 BSSID、加密类型、Wi‑Fi 版本、信道、RSSI、网络名称、IPv4 地址、IPv6 地址、子网掩码、网关、DNS 及备用 DNS（字段因可用性而异）。

参数​

名称类型默认值可读可写可上报
当前值WiFiDiagnosticsTraitPresentValueStructure✔✘✔

MagicPairKeychain​

用于 MagicPair 网络配网密钥链。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

SupportedNetwork​

指示设备入网（MagicPair）所支持的网络协议。值为位掩码：bit0=Wi‑Fi，bit1=Thread，bit2=Ethernet，bit3=Zigbee，bit4=BLE，bit5=BLE Endpoint，bit6=Wi‑Fi Endpoint，bit7=Limited Home Station 的 Wi‑Fi Endpoint。不包含用于配对的 BLE。

参数​

名称类型默认值可读可写可上报
当前值uint8✔✘✘
最大值uint8255.0✔✘✘
最小值uint80.0✔✘✘
步长uint321.0✔✘✘

SlaveAddress​

总线上为设备作为从机分配的地址，用于主从通信寻址。

参数​

名称类型默认值可读可写可上报
当前值uint8255✔✔✔
最大值uint8255.0✔✘✘
最小值uint81.0✔✘✘
步长uint321.0✔✘✘
默认值uint8255✔✔✘

ThreadDiagnostics​

提供 Thread 网络的诊断信息。包括信道、extended PAN ID、network key、network name、PAN ID、PSKc、active timestamp、security policy、operational dataset、RSSI、LQI、border agent ID、mesh local prefix、commissioner credential、OpenThread 版本及角色（border router、leader、router、end device、sleepy end device、router‑eligible end device）。

参数​

名称类型默认值可读可写可上报
当前值ThreadDiagnosticsTraitPresentValueStructure✔✘✔

AuthenticationStatus​

指示设备认证状态，反映是否已通过认证及证书是否有效。

参数​

名称类型默认值可读可写可上报
当前值AuthenticationStatusEnum80✔✘✔
支持的值list[AuthenticationStatusEnum8]✔✘✘
默认值uint80✔✔✘

WiFiRSSI​

测量Wi-Fi连接信号强度的指标，以dBm为单位，范围从-100 dBm （非常弱）到0 dBm （最强）。

参数​

名称类型默认值可读可写可上报
当前值int8✔✘✔
最大值int80.0✔✘✘
最小值int8-100.0✔✘✘
步长uint321.0✔✘✘

CurrentTemperature​

指示当前温度。

参数​

名称类型默认值可读可写可上报
当前值float26✔✘✔
最大值float100.0✔✘✘
最小值float-50.0✔✘✘
步长uint320.01✔✘✘
默认值float26✔✔✘

SetTemperatureLevel​

etTemperatureLevel 允许用户将温度调节至预设档位。Parameter Supported Values 表示支持的档位列表。

参数​

名称类型默认值可读可写可上报
当前值uint80✔✔✔
最大值uint8255.0✔✘✘
最小值uint80.0✔✘✘
步长uint321.0✔✘✘
支持的值list[characterString]✔✘✘
默认值uint80✔✔✘

SetTemperature​

SetTemperature 允许用户指定和调整设备或系统的目标温度。

参数​

名称类型默认值可读可写可上报
当前值float20✔✔✔
最大值float100.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float20✔✔✘

PackageRecognitionReport​

当包裹投递、取走或状态发生变化时自动上报事件。

参数​

名称类型默认值可读可写可上报
当前值PackageRecognitionReportEnum8✘✘✔
支持的值list[PackageRecognitionReportEnum8]✔✘✘

FaceIDReport​

与特定面部相关联的唯一标识符，用于面部识别或身份验证。

参数​

名称类型默认值可读可写可上报
当前值uint64✘✘✔
最大值uint641.8446744E19✔✘✘
最小值uint640.0✔✘✘
步长uint321.0✔✘✘

HoldTime​

无人判定延时

参数​

名称类型默认值可读可写可上报
当前值uint161✔✔✔
最小值uint161.0✔✘✘
默认值uint161✔✔✘

ActivityDetected​

指示在空间被占用期间是否检测到任何人为活动。

参数​

名称类型默认值可读可写可上报
当前值boolean0✘✘✔
默认值boolean0✔✔✘

PresenceConfiguration​

用于配置有无人软传感相关设置。

参数​

名称类型默认值可读可写可上报
当前值PresenceConfigurationTraitPresentValueStructure✔✔✔

Presence​

Presence 用于检测监测区域内是否有人。

参数​

名称类型默认值可读可写可上报
当前值PresenceEnum80✔✘✔
支持的值list[PresenceEnum8]✔✘✘
默认值uint80✔✔✘

HumanRecognitionReport​

上报在定义检测区域内是否检测到人形。

参数​

名称类型默认值可读可写可上报
当前值HumanRecognitionReportEnum8✘✘✔
支持的值list[HumanRecognitionReportEnum8]✔✘✘

AirQuality​

AirQuality表示空气质量等级.

参数​

名称类型默认值可读可写可上报
当前值AirQualityEnum80✔✘✔
支持的值list[AirQualityEnum8]✔✘✘
默认值uint80✔✔✘

VOCQuality​

指示挥发性有机化合物（VOC）空气质量等级。值：0 = 未知，1 = 优，2 = 良，3 = 中，4 = 较差，5 = 差。

参数​

名称类型默认值可读可写可上报
当前值VOCQualityEnum8✔✘✔
支持的值list[VOCQualityEnum8]✔✘✘

VOCDensity​

该 Trait 用于「VOC浓度」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值float1✔✘✔
最大值float9999.0✔✘✘
最小值float1.0✔✘✘
步长uint321.0✔✘✘
默认值float1✔✔✘

AttitudeDetected​

该 Trait 用于「姿态检测」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值AttitudeDetectedEnum8✔✘✔
支持的值list[AttitudeDetectedEnum8]✔✘✘

TripTime​

指示电机行程时间，即从完全打开到完全关闭（或相反）所需的时间（秒）。取值范围为 1 至 300 秒，默认 10 秒。

参数​

名称类型默认值可读可写可上报
当前值float✔✘✔
最大值float300.0✔✘✘
最小值float1.0✔✘✘
步长uint321.0✔✘✘

TargetPositionPercentage​

该 Trait 用于「目标位置百分比」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值float50✔✔✔
最大值float100.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float50✔✔✘

CurrentPositionPercentage​

以 0% 至 100% 的百分比标识实际位置，默认步进 1%。

参数​

名称类型默认值可读可写可上报
当前值float50✔✘✔
最大值float100.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float50✔✔✘

Binding​

Binding表示端点与一个或多个其他本地或远程 Endpoint持久关系。

参数​

名称类型默认值可读可写可上报
当前值list[BindingTraitPresentValueStructure]✔✔✔

SupportedBindingDeviceTypes​

指示该控制器端点可绑定的设备类型列表。

参数​

名称类型默认值可读可写可上报
当前值list✔✘✔

SupportedBindingFunctions​

指示该控制器端点可绑定并控制的 Function 功能列表。

参数​

名称类型默认值可读可写可上报
当前值list✔✘✔

Feed​

该 Trait 用于「喂食」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值FeedEnum8✔✘✔
支持的值list[FeedEnum8]✔✘✘

LocalControlDisabled​

描述按钮是否禁用关联的本地设备控制功能（如继电器控制）。若禁用，点击按钮无法开启或关闭本地执行器。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✔✔

ButtonEvent​

该 Trait 用于「按钮事件」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值ButtonEventEnum8✘✘✔
支持的值list[ButtonEventEnum8]✔✘✘

OutputSwitchingType​

定义连接到设备的外部开关类型。

参数​

名称类型默认值可读可写可上报
当前值OutputSwitchingTypeEnum8✔✔✔
支持的值list[OutputSwitchingTypeEnum8]✔✘✘

OnOff​

写入时开启或关闭摄像机设备。读取表示当前电源状态。取值：false = 关闭，true = 开启。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✔✔

OutputInterlockFlag​

当两个属性的取值相同时，表示这两个属性对应的状态处于互锁关系。

参数​

名称类型默认值可读可写可上报
当前值uint80✔✔✔
最大值uint8255.0✔✘✘
最小值uint80.0✔✘✘
步长uint321.0✔✘✘
默认值uint80✔✔✘

OutputNodeMode​

定义输出节点的工作模式。

参数​

名称类型默认值可读可写可上报
当前值OutputNodeModeEnum32✔✔✔
支持的值list[OutputNodeModeEnum32]✔✘✘

StartUpOnOff​

定义设备上电时一组自定义配置参数的启动行为（例如恢复用户自定义配置）。可能覆盖默认 OnOff 行为。

参数​

名称类型默认值可读可写可上报
当前值StartUpOnOffEnum8✔✔✔
支持的值list[StartUpOnOffEnum8]✔✘✘

IRKey​

该 Trait 用于「红外指令」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值IRKeyEnum32✘✔✘
支持的值list[IRKeyEnum32]✔✘✘

IRType​

定义 IR 遥控器的设备类型。

参数​

名称类型默认值可读可写可上报
当前值IRTypeEnum8✔✔✔
支持的值list[IRTypeEnum8]✔✘✘

CoolingTemperature​

指示制冷温度。

参数​

名称类型默认值可读可写可上报
当前值float26✔✔✔
最大值float100.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float26✔✔✘

CurrentHumidity​

该 Trait 用于「湿度」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值float50✔✘✔
最大值float100.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float50✔✔✘

CurrentTemperature​

指示当前温度。

参数​

名称类型默认值可读可写可上报
当前值float26✔✘✔
最大值float100.0✔✘✘
最小值float-50.0✔✘✘
步长uint320.01✔✘✘
默认值float26✔✔✘

Preset​

该 Trait 用于「预设」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值list[PresetTraitPresentValueStructure]✔✔✔

SetBack​

表示温控器温度浮动范围

参数​

名称类型默认值可读可写可上报
当前值float✔✔✔
最大值float25.5✔✘✘
最小值float0.0✔✘✘
步长uint320.1✔✘✘

PresetTypes​

该 Trait 用于「预设类型」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值list✔✔✔

HeaterCoolerMode​

该 Trait 用于「制热制冷模式」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值HeaterCoolerModeEnum8✔✔✔
支持的值list[HeaterCoolerModeEnum8]✔✘✘

ActivePresetHandle​

该 Trait 用于「主动预设句柄」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值characterStringnull✔✔✔
默认值characterStringnull✔✔✘

HeatingTemperature​

指示加热温度。

参数​

名称类型默认值可读可写可上报
当前值float18✔✔✔
最大值float100.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float18✔✔✘

NumberOfPresets​

该 Trait 用于「预设数量」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值uint80✔✔✔
最小值uint80.0✔✘✘
默认值uint80✔✔✘

HeaterCoolerButtonEvent​

温控器或气候控制设备上按钮交互触发的事件。

参数​

名称类型默认值可读可写可上报
当前值HeaterCoolerButtonEventEnum8✔✘✔
支持的值list[HeaterCoolerButtonEventEnum8]✔✘✘

MinHeatCoolDeadBand​

指示自动模式下制热与制冷温度之间的最小差值。

参数​

名称类型默认值可读可写可上报
当前值float2✔✔✔
最大值float2.5✔✘✘
最小值float0.0✔✘✘
步长uint320.1✔✘✘
默认值float2✔✔✘

CurrentTemperatureCalibration​

用于本地温度读数的补偿/校准偏移。写入正值或负值可修正传感器偏差。

规格映射说明：对应 Matter LocalTemperatureCalibration；value = temperature in Celsius * 10。当前 Function 规格源（HeaterCooler）尚未给出独立 Trait ID 定义，以下参数按总表与映射约定整理。

参数​

名称类型默认值可读可写可上报
当前值number✔✔✔

TemperatureUIDisplayMode​

该特征应指定温控器内置屏幕显示温度的单位。

参数​

名称类型默认值可读可写可上报
当前值TemperatureUIDisplayModeEnum80✔✔✔
支持的值list[TemperatureUIDisplayModeEnum8]✔✘✘
默认值uint80✔✔✘

AntiFreezeTemperature​

防冻保护温度设置通常指触发防冻机制的阈值（例如 5°C）。

参数​

名称类型默认值可读可写可上报
当前值float5✔✔✔
最大值float15.0✔✘✘
最小值float5.0✔✘✘
步长uint320.5✔✘✘
默认值float5✔✔✘

HeaterCoolerPolarity​

指定极性配置，用于确定系统控制制冷还是制热。

参数​

名称类型默认值可读可写可上报
当前值HeaterCoolerPolarityEnum82✔✔✔
支持的值list[HeaterCoolerPolarityEnum8]✔✘✘
默认值uint82✔✔✘

TiltAngleDeviation​

指示当前运动期间 Tilt 角度的实际变化量（偏移）。

参数​

名称类型默认值可读可写可上报
当前值float✔✘✔
最大值float180.0✔✘✘
最小值float-180.0✔✘✘
步长uint320.01✔✘✘

StationaryState​

该特征的当前值应以枚举形式指示目标当前是否静止。取值 0 表示目标处于运动状态，取值 1 表示目标静止。

参数​

名称类型默认值可读可写可上报
当前值StationaryStateEnum81✔✘✔
支持的值list[StationaryStateEnum8]✔✘✘
默认值uint81✔✔✘

InitialTiltAngle​

指示设备校准期间建立的初始倾斜角，表示校准方向（例如朝上）与最近轴正方向之间的夹角。

参数​

名称类型默认值可读可写可上报
当前值float✔✘✔
最大值float180.0✔✘✘
最小值float-180.0✔✘✘
步长uint320.01✔✘✘

EventReportInterval​

指示设备连续事件上报之间的时间间隔，单位为秒。例如，值为 60 表示设备每 60 秒上报一次事件。该间隔决定设备向网关或云端发送事件数据的频率。

参数​

名称类型默认值可读可写可上报
当前值uint3260✔✔✔
最大值uint32300.0✔✘✘
最小值uint325.0✔✘✘
步长uint321.0✔✘✘
默认值uint3260✔✔✘

ObjectOrientationEnable​

启用或禁用物体朝向监测功能。设为 True 时，设备主动监测并上报物体朝向变化；设为 False 时禁用朝向监测。

参数​

名称类型默认值可读可写可上报
当前值boolean1✔✔✔
默认值boolean1✔✔✘

StationaryTiltAngle​

指示物体运动后静止时的倾斜角。

参数​

名称类型默认值可读可写可上报
当前值float✔✘✔
最大值float180.0✔✘✘
最小值float-180.0✔✘✘
步长uint320.01✔✘✘

PeakTiltAngle​

指示从唤醒到静止期间记录的最大倾斜角。

参数​

名称类型默认值可读可写可上报
当前值float✔✘✔
最大值float180.0✔✘✘
最小值float-180.0✔✘✘
步长uint320.01✔✘✘

ObjectMotionDetectionEnable​

启用或禁用物体移动检测功能。True 表示启用（将检测物体移动），False 表示禁用。

参数​

名称类型默认值可读可写可上报
当前值boolean1✔✔✔
默认值boolean1✔✔✘

ObjectOrientationState​

指示设备检测到的物体当前空间朝向。值为枚举，表示物体相对参考平面的姿态，可能状态如下：

1 – Horizontal Up（物体朝上，如平放在桌面正面朝上）

2 – Horizontal Down（物体朝下，如平放在桌面正面朝下）

3 – Vertical（物体竖直，如垂直于地面）

4 – Tilted（物体倾斜，不属于水平或竖直分类）

参数​

名称类型默认值可读可写可上报
当前值ObjectOrientationStateEnum8✔✘✔
支持的值list[ObjectOrientationStateEnum8]✔✘✘

VibrationEvent​

该 Trait 用于「动静贴事件」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值VibrationEventEnum8✘✘✔
支持的值list[VibrationEventEnum8]✔✘✘

CubeWorkModeSetting​

启用 Magic Cube 设备多种操作模式设置，增强体验与交互。

参数​

名称类型默认值可读可写可上报
当前值CubeWorkModeSettingEnum80✔✔✔
支持的值list[CubeWorkModeSettingEnum8]✔✘✘
默认值uint80✔✔✘

TopFace​

指示魔方控制器当前朝上的面，用于定义设备状态。

参数​

名称类型默认值可读可写可上报
当前值TopFaceEnum8✔✘✔
支持的值list[TopFaceEnum8]✔✘✘

CubeEvent​

该 Trait 用于「魔方事件」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值CubeEventEnum8✘✘✔
支持的值list[CubeEventEnum8]✔✘✘

TopFaceChanged​

表示设备“朝上面”已变更。用户翻转设备（如魔方控制器）时触发。

参数​

名称类型默认值可读可写可上报
当前值TopFaceChangedEnum8✘✘✔
支持的值list[TopFaceChangedEnum8]✔✘✘

HoldRotationInterval​

某个按住旋转事件对应的旋转所用时长，即旋转间隔时长

参数​

名称类型默认值可读可写可上报
当前值uint16✘✘✔
最大值uint1665535.0✔✘✘
最小值uint161.0✔✘✘
步长uint321.0✔✘✘

RotationEvent​

描述旋钮事件类型：Rotate、Hold to rotate 或 Inverted rotate。取值：0 = Rotate，1 = Hold to rotate，2 = Inverted Rotate。

参数​

名称类型默认值可读可写可上报
当前值RotationEventEnum8✘✘✔
支持的值list[RotationEventEnum8]✔✘✘

RotationDirection​

描述旋转方向。取值：0 = Clockwise（顺时针），1 = Counterclockwise（逆时针）。

参数​

名称类型默认值可读可写可上报
当前值RotationDirectionEnum8✘✘✔
支持的值list[RotationDirectionEnum8]✔✘✘

InvertedRotationAngle​

倒置旋转的角度

参数​

名称类型默认值可读可写可上报
当前值float0✘✘✔
最大值float3600.0✔✘✘
最小值float-3600.0✔✘✘
步长uint321.0✔✘✘
默认值float0✔✔✘

RotationAngle​

该 Trait 用于「旋转角度」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值float0✘✘✔
最大值float3600.0✔✘✘
最小值float-3600.0✔✘✘
步长uint321.0✔✘✘
默认值float0✔✔✘

RotationInterval​

某个旋转事件对应的旋转所用时长，即旋转间隔时长

参数​

名称类型默认值可读可写可上报
当前值uint16✘✘✔
最大值uint1665535.0✔✘✘
最小值uint161.0✔✘✘
步长uint321.0✔✘✘

HoldRotationAngle​

该 Trait 用于「按住旋转角度」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值float0✘✘✔
最大值float3600.0✔✘✘
最小值float-3600.0✔✘✘
步长uint321.0✔✘✘
默认值float0✔✔✘

BinaryOutputPV​

BinaryOutputPV保存二进制输出的命令或实际开/关状态。

参数​

名称类型默认值可读可写可上报
当前值boolean0✔✔✔
默认值boolean0✔✔✘

AnalogInputPV​

AnalogInputPV传达模拟输入通道的实时实时值及其工程元数据。

参数​

名称类型默认值可读可写可上报
当前值float✔✘✔

TargetPlaybackState​

该 Trait 用于「目标播放状态」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值TargetPlaybackStateEnum8✔✔✔
支持的值list[TargetPlaybackStateEnum8]✔✘✘

MediaInformation​

描述媒体信息（标题、艺术家等）。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

PlaybackDuration​

指示播放时长，单位为 ms。

参数​

名称类型默认值可读可写可上报
当前值float✔✘✔
最大值float7200000.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘

CurrentPlaybackState​

描述当前播放状态。

参数​

名称类型默认值可读可写可上报
当前值CurrentPlaybackStateEnum8✔✘✔
支持的值list[CurrentPlaybackStateEnum8]✔✘✘

PlaybackMode​

描述当前播放模式。

参数​

名称类型默认值可读可写可上报
当前值PlaybackModeEnum8✔✔✔
支持的值list[PlaybackModeEnum8]✔✘✘

SampledPosition​

指示或设置媒体当前播放位置。值为毫秒（ms）时间偏移，范围 0 至总播放时长。写入时，设备跳转至该位置。

参数​

名称类型默认值可读可写可上报
当前值float✔✘✔
最大值float7200000.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘

LoginState​

描述媒体服务的登录状态。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

PlaybackSampledPosition​

设置并查询当前播放位置。

参数​

名称类型默认值可读可写可上报
当前值uint64✔✔✔
最大值uint644.294967295E9✔✘✘
最小值uint640.0✔✘✘
步长uint321.0✔✘✘

SelectedMediaOutputSource​

描述所选媒体输出源。

参数​

名称类型默认值可读可写可上报
当前值SelectedMediaOutputSourceEnum8✔✔✔
支持的值list[SelectedMediaOutputSourceEnum8]✔✘✘

SelectedSource​

指示或设置当前所选媒体输出源（如内置扬声器、Bluetooth、AUX、HDMI 等）。取值：0 = Internal，1 = Bluetooth，2 = Aux，3 = SPDIF，4 = Coaxial，5–7 = Audio 1–3，8–10 = AV1–3，11–13 = HDMI1–3，14 = Other。

参数​

名称类型默认值可读可写可上报
当前值SelectedSourceEnum8✔✔✔
支持的值list[SelectedSourceEnum8]✔✘✘

MediaInput​

MediaInput 提供可用输入源列表，并提供选择与重命名命令。

参数​

名称类型默认值可读可写可上报
当前值enum8✔✔✔

FlameDetected​

使设备识别监控区域内的明火或火焰特征。检测到疑似火焰时，自动触发并上报事件。

参数​

名称类型默认值可读可写可上报
当前值FlameDetectedEnum8✘✘✔
支持的值list[FlameDetectedEnum8]✔✘✘

OperationalError​

OperationalError 指设备或系统无法执行其预期 functi

参数​

名称类型默认值可读可写可上报
当前值OperationalErrorEnum160✔✘✔
支持的值list[OperationalErrorEnum16]✔✘✘
默认值uint160✔✔✘

OperationalState​

OperationalState 指设备的当前功能状态或工况，指示其活动或空闲状态。It defin

参数​

名称类型默认值可读可写可上报
当前值OperationalStateEnum160✔✘✔
支持的值list[OperationalStateEnum16]✔✘✘
默认值uint160✔✔✘

RefrigeratorAlarm​

RefrigeratorAlarm 指当前冰箱报警状态。

参数​

名称类型默认值可读可写可上报
当前值list✔✘✔

CurrentMode​

CurrentMode 表示设备当前的工作状态或设置，取值来自预定义选项集。

参数​

名称类型默认值可读可写可上报
当前值enum80✔✘✔
默认值enum80✔✔✘

ChangeToModeResponse​

ChangeToModeResponse是一个响应消息或状态，指示将设备切换到特定模式的请求的结果。

参数​

名称类型默认值可读可写可上报
当前值ChangeToModeResponseEnum160✔✘✔
支持的值list[ChangeToModeResponseEnum16]✔✘✘
默认值uint160✔✔✘

BridgeDeviceID​

表示此桥接节点所连接的 Bridge 设备的 DeviceID。String(32)。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✔✔

MultiStateInputPV​

MultiStateInputPV 提供当前枚举状态，以及人类可读的状态标签和可选描述文本。

参数​

名称类型默认值可读可写可上报
当前值uint32✔✘✔

PulseDuration​

定义脉冲负载的脉冲持续时间。

参数​

名称类型默认值可读可写可上报
当前值uint16✔✔✔
最大值uint1665535.0✔✘✘
最小值uint160.0✔✘✘
步长uint321.0✔✘✘

LoadType​

描述连接到开关的负载类型。0：General，1：Linkable，2：Pulsed。

参数​

名称类型默认值可读可写可上报
当前值LoadTypeEnum8✔✔✔
支持的值list[LoadTypeEnum8]✔✘✘

ThemeID​

该 Trait 用于「主题ID」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值uint161✔✘✔
最小值uint161.0✔✘✘
默认值uint161✔✔✘

Allpages​

该 Trait 用于「所有页面」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值list[AllpagesTraitPresentValueStructure]✔✔✔

MaxPageNum​

该 Trait 用于「最大页面数量」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值uint161✔✘✔
默认值uint161✔✔✘

ScreenWidth​

该 Trait 用于「屏幕宽度」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值uint16240✔✘✔
默认值uint16240✔✔✘

DataVersion​

该 Trait 用于「数据版本」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值uint640✔✘✔
默认值uint640✔✔✘

ThemeVersion​

主题版本

参数​

名称类型默认值可读可写可上报
当前值uint161✔✘✔
最大值uint1699999.0✔✘✘
最小值uint161.0✔✘✘
步长uint321.0✔✘✘
默认值uint161✔✔✘

ScreenHeight​

该 Trait 用于「屏幕高度」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值uint16240✔✘✔
默认值uint16240✔✔✘

EnableIndicator​

该 Trait 用于「指示灯使能」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值tlv✔✔✔

StartUpOnOff​

定义设备上电时一组自定义配置参数的启动行为（例如恢复用户自定义配置）。可能覆盖默认 OnOff 行为。

参数​

名称类型默认值可读可写可上报
当前值StartUpOnOffEnum8✔✔✔
支持的值list[StartUpOnOffEnum8]✔✘✘

Condition​

表示滤芯剩余寿命，单位为百分比%

参数​

名称类型默认值可读可写可上报
当前值float100✔✘✔
最大值float100.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float100✔✔✘

ChangeIndication​

ChangeIndication 定义了滤芯寿命的状态.

参数​

名称类型默认值可读可写可上报
当前值ChangeIndicationEnum80✔✘✔
支持的值list[ChangeIndicationEnum8]✔✘✘
默认值uint80✔✔✘

FilterType​

FilterType 定义了滤芯类型.

参数​

名称类型默认值可读可写可上报
当前值FilterTypeEnum8✔✘✔
支持的值list[FilterTypeEnum8]✔✘✘

WindSetting​

WindSetting 定义了风的类型.

参数​

名称类型默认值可读可写可上报
当前值WindSettingEnum80✔✔✔
支持的值list[WindSettingEnum8]✔✘✘
默认值uint80✔✔✘

AirflowDirection​

irflowDirection 定义了风向.

参数​

名称类型默认值可读可写可上报
当前值AirflowDirectionEnum80✔✔✔
支持的值list[AirflowDirectionEnum8]✔✘✘
默认值uint80✔✔✘

FanMode​

FanMode 定义了风扇的模式.

参数​

名称类型默认值可读可写可上报
当前值FanModeEnum8✔✔✔
支持的值list[FanModeEnum8]✔✘✘

FanSpeed​

anSpeed表示风速百分比。

参数​

名称类型默认值可读可写可上报
当前值uint8✔✔✔
最大值uint8100.0✔✘✘
最小值uint80.0✔✘✘
步长uint321.0✔✘✘

RockSetting​

定义摆风/摇头模式。

参数​

名称类型默认值可读可写可上报
当前值RockSettingEnum80✔✔✔
支持的值list[RockSettingEnum8]✔✘✘
默认值uint80✔✔✘

HeartRate​

实时测量每分钟心跳次数。

参数​

名称类型默认值可读可写可上报
当前值float0✔✘✔
最大值float300.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float0✔✔✘

CurrentPressure​

该 Trait 用于「压力」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值float101✔✘✔
最大值float200000.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float101✔✔✘

MultiStateOutputPV​

MultiStateOutputPV 包含请求或当前活动的枚举输出状态。

参数​

名称类型默认值可读可写可上报
当前值uint32✔✔✔

ContactSensorState​

该 Trait 用于「接触状态」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✘✔

OpenAngle​

门窗开合角度

参数​

名称类型默认值可读可写可上报
当前值float0✔✘✔
最大值float360.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float0✔✔✘

Volume​

指示或设置摄像头设备扬声器音量（如双向语音）。值通常为百分比（0 至 100）或设备定义的数值范围。

参数​

名称类型默认值可读可写可上报
当前值float50✔✔✔
最大值float100.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float50✔✔✘

WaterFreezeDetector​

注意：WaterFreezeDetector 在规格源中是 Function（水冻结探测器），不是独立 Trait。该 Function 仅包含 Trait BooleanState。

用于检测管道或环境中是否存在结冰风险，并在达到阈值时上报水冻结相关事件。布尔状态通过 BooleanState 表示。

StepValue​

指示或设置步进增量（如音量调节）。写入时定义单步变化量（如音量）。单位与范围因设备而异。

参数​

名称类型默认值可读可写可上报
当前值float✔✔✔
最大值float100.0✔✘✘
最小值float1.0✔✘✘
步长uint3210.0✔✘✘

Mute​

指示扬声器静音状态。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✔✔

LockOperation​

当设备通过任何支持的方式成功解锁/上锁时，记录并上报锁操作事件。提供解锁/上锁操作的详细上下文，包括来源（例如 Matter 生态系统或本地方式）、用户身份及使用的具体凭据。

参数​

名称类型默认值可读可写可上报
当前值LockOperationTraitPresentValueStructure✘✘✔

LockOperationError​

门锁操作因各种原因失败时，门锁将发出 LockOperationError 事件。

参数​

名称类型默认值可读可写可上报
当前值LockOperationErrorTraitPresentValueStructure✘✘✔

SupportedRemoteFeatures​

该 Trait 用于「支持的远程特性」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✘

NumberOfCredentialsSupportedPerUser​

该 Trait 用于「每用户可支持凭证数」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值uint80✔✘✔
默认值uint80✔✔✘

NumberOfTotalUsersSupported​

该 Trait 用于「门锁总用户量」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值uint160✔✘✔
默认值uint160✔✔✘

DoorState​

该 Trait 用于「门状态」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值DoorStateEnum8✔✘✔
支持的值list[DoorStateEnum8]✔✘✘

NumberOfYearDaySchedulesSupportedPerUser​

该 Trait 用于「每用户可支持年日程数」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值uint80✔✘✔
默认值uint80✔✔✘

LockState​

该 Trait 用于「锁状态」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值LockStateEnum8✔✘✔
支持的值list[LockStateEnum8]✔✘✘

EnableRemoteControl​

该 Trait 用于「远程控制使能」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✔✔

NumberOfPINUsersSupported​

该 Trait 用于「PIN用户量」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值uint160✔✘✔
默认值uint160✔✔✘

LockUserChange​

门锁用户、日程或凭证发生变更时，门锁将发出 LockUserChange 事件。

参数​

名称类型默认值可读可写可上报
当前值LockUserChangeTraitPresentValueStructure✘✘✔

RemoteControlWithAuthCode​

该 Trait 用于「远程控制（带授权码）-绿米私有」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值characterString✘✔✘

DoorLockAlarm​

门锁在出现关键状态时可发送多种告警。

参数​

名称类型默认值可读可写可上报
当前值DoorLockAlarmTraitPresentValueStructure✘✘✔

RemoteUnlock​

该 Trait 用于「远程解锁--绿米私有」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✔✔

NumberOfRFIDUsersSupported​

该 Trait 用于「RFID用户量」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值uint160✔✘✔
默认值uint160✔✔✘

NumberOfWeekDaySchedulesSupportedPerUser​

该 Trait 用于「每用户可支持周日程数」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值uint80✔✘✔
默认值uint80✔✔✘

CO2Level​

以定性指数指示二氧化碳浓度水平。取值：0 = Excellent（正常/低 CO2），1 = Light Pollution（CO2 轻度升高），2 = Heavy Pollution（CO2 浓度高）。

参数​

名称类型默认值可读可写可上报
当前值CO2LevelEnum8✔✘✔
支持的值list[CO2LevelEnum8]✔✘✘

CO2Density​

该 Trait 用于「CO2浓度」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值float0✔✘✔
最大值float9999.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float0✔✔✘

VacuumOperationalError​

VacuumOperationalError 指设备或系统无法执行预期功能时遇到的特定错误类型。

参数​

名称类型默认值可读可写可上报
当前值VacuumOperationalErrorEnum160✔✘✔
支持的值list[VacuumOperationalErrorEnum16]✔✘✘
默认值uint160✔✔✘

VacuumOperationalState​

VacuumOperationalState 指吸尘设备当前的运行状态或模式。

参数​

名称类型默认值可读可写可上报
当前值VacuumOperationalStateEnum160✔✘✔
支持的值list[VacuumOperationalStateEnum16]✔✘✘
默认值uint160✔✔✘

CurrentValveState​

CurrentValveState 表示阀门当前的工作状态。

参数​

名称类型默认值可读可写可上报
当前值CurrentValveStateEnum8✔✘✔
支持的值list[CurrentValveStateEnum8]✔✘✘

DefaultOpenDuration​

DefaultOpenDuration 表示若 OpenDuration 字段未指定时，阀门保持开启的默认时长（秒）。

参数​

名称类型默认值可读可写可上报
当前值float1✔✔✔
最大值float100000.0✔✘✘
最小值float1.0✔✘✘
步长uint321.0✔✘✘
默认值float1✔✔✘

RemainingDuration​

RemainingDuration 指阀在自动关闭之前将继续运行的剩余时

参数​

名称类型默认值可读可写可上报
当前值float0✔✔✔
最大值float100000.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float0✔✔✘
是否为空booleanFalse✔✔✔

ScreenBrightness​

控制屏幕亮度级别的特质，值范围为1%到100%。

参数​

名称类型默认值可读可写可上报
当前值float50✔✔✔
最大值float100.0✔✘✘
最小值float1.0✔✘✘
步长uint321.0✔✘✘
默认值float50✔✔✘

SamplingInterval​

定义数据采样时间间隔。

参数​

名称类型默认值可读可写可上报
当前值float5✔✔✔
最大值float3600.0✔✘✘
最小值float0.5✔✘✘
步长uint320.1✔✘✘
默认值float5✔✔✘

CurrentIlluminance​

该 Trait 用于「光照度」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值float50✔✘✔
最大值float100000.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float50✔✔✘

CameraActiveStatus​

该 Trait 用于「摄像头休眠状态」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✔✔

CameraRTSPURL​

指示摄像头的 RTSP（Real Time Streaming Protocol）URL，用于通过 RTSP 协议访问实时视频流。该属性返回 JSON 对象，键为分辨率标识（如 "360p"、"720p"、"1080p"、"4mp"），值为对应完整 RTSP URL 字符串。示例格式如下：{"360p": "rtsp://192.168.1.109:8554/360p","720p": "rtsp://192.168.1.109:8554/720p","1080p": "rtsp://192.168.1.109:8554/1080p","4mp": "rtsp://192.168.1.109:8554/4mp"}

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

P2PCaptureStatus​

P2P动态趣图状态开关

参数​

名称类型默认值可读可写可上报
当前值boolean✔✔✔

CameraRTSPEnable​

指示摄像头 RTSP（Real Time Streaming Protocol）启用开关配置。启用时允许通过 RTSP 协议访问实时视频流；禁用时禁止 RTSP 访问。

参数​

名称类型默认值可读可写可上报
当前值boolean0✔✔✔
默认值boolean0✔✔✘

P2PCaptureEnabled​

指示摄像头是否启用 P2P（peer-to-peer）抓拍功能。

参数​

名称类型默认值可读可写可上报
当前值boolean1✔✘✔
默认值boolean1✔✔✘

CurrentSensitivityLevel​

指示当前所选通用配置灵敏度等级。

参数​

名称类型默认值可读可写可上报
当前值uint8✔✔✔
最大值uint8255.0✔✘✘
最小值uint80.0✔✘✘
步长uint321.0✔✘✘

GasDensity​

该 Trait 用于「气体浓度」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值float0✔✘✔
最大值float100.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float0✔✔✘

SelfCheck​

便于执行自检以验证设备功能是否正常。

参数​

名称类型默认值可读可写可上报
当前值boolean0✔✔✔
默认值boolean0✔✔✘

Mute​

指示扬声器静音状态。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✔✔

GasDetected​

该 Trait 用于「气体检测状态」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✘✔

GestureRecognitionReport​

使设备通过视觉传感器识别特定用户手势。检测到预定义手势动作时，自动上报对应手势事件。

参数​

名称类型默认值可读可写可上报
当前值GestureRecognitionReportEnum16✘✘✔
支持的值list[GestureRecognitionReportEnum16]✔✘✘

BreathingMonitoring​

注意：BreathingMonitoring 在规格源中是 Function（呼吸监测），不是独立 Trait。该 Function 仅包含 Trait BreathingRate。

利用传感器持续或周期性测量用户呼吸频率与模式，支持健康监测。实时呼吸频率见 BreathingRate。

BreathingRate​

实时测量每分钟呼吸次数。

参数​

名称类型默认值可读可写可上报
当前值float0✔✘✔
最大值float60.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float0✔✔✘

CharStringValuePV​

指示 CharacterString Value Object 的当前值。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✔✔

SweeperState​

该 Trait 用于「扫地状态」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值SweeperStateEnum8✔✘✔
支持的值list[SweeperStateEnum8]✔✘✘

EvseSupplyState​

EvseSupplyState 表示电动汽车供电设备（EVSE）的当前供电状态。

参数​

名称类型默认值可读可写可上报
当前值EvseSupplyStateEnum32✔✘✔
支持的值list[EvseSupplyStateEnum32]✔✘✘

MinChargeCurrent​

MinChargeCurrent 指电动汽车可充电的最低电流等级。

参数​

名称类型默认值可读可写可上报
当前值float0✔✘✔
最大值float10000.0✔✘✘
最小值float0.0✔✘✘
步长uint320.001✔✘✘
默认值float0✔✔✘

EvseState​

EVSEState 表示电动汽车供电设备（EVSE）的当前状态。

参数​

名称类型默认值可读可写可上报
当前值EvseStateEnum32✔✘✔
支持的值list[EvseStateEnum32]✔✘✘

ChargingEnabledUntil​

ChargingEnabledUntil指允许电动汽车（ EV ）或设备的充电过程持续

参数​

名称类型默认值可读可写可上报
当前值float6✔✘✔
最大值float10000.0✔✘✘
最小值float0.0✔✘✘
步长uint320.001✔✘✘
默认值float6✔✔✘
是否为空booleanFalse✔✘✔

BatteryCapacity​

BatteryCapacity是指电池可以存储的电能总量，通常以千瓦时（

参数​

名称类型默认值可读可写可上报
当前值float0✔✘✔
最大值float10000.0✔✘✘
最小值float0.0✔✘✘
步长uint320.001✔✘✘
默认值float0✔✔✘

VehicleID​

VehicleID 为每辆电动汽车（EV）分配的唯一标识符。

参数​

名称类型默认值可读可写可上报
当前值string32✔✘✔

EvseFaultState​

EvseFaultState 表示电动汽车供电设备（EVSE）的当前故障状态。

参数​

名称类型默认值可读可写可上报
当前值EvseFaultStateEnum32✔✘✔
支持的值list[EvseFaultStateEnum32]✔✘✘

BatPercentRemaining​

指示剩余电池电量百分比。

参数​

名称类型默认值可读可写可上报
当前值float50✔✘✔
最大值float100.0✔✘✘
最小值float0.0✔✘✘
步长uint320.1✔✘✘
默认值float50✔✔✘

MaxChargeCurrent​

MaxChargeCurrent 指电动汽车可充电的最高电流等级。

参数​

名称类型默认值可读可写可上报
当前值float0✔✘✔
最大值float10000.0✔✘✘
最小值float0.0✔✘✘
步长uint320.001✔✘✘
默认值float0✔✔✘

CurrentFlow​

CurrentFlow表示当前流量值，单位为 m³/h。

参数​

名称类型默认值可读可写可上报
当前值float0✔✘✔
最大值float65535.0✔✘✘
最小值float0.0✔✘✘
步长uint320.01✔✘✘
默认值float0✔✔✘

ExpressedState​

ExpressedState 定义了报警器的状态.

参数​

名称类型默认值可读可写可上报
当前值ExpressedStateEnum80✔✘✔
支持的值list[ExpressedStateEnum8]✔✘✘
默认值uint80✔✔✘

CODetected​

表示是否探测到一氧化碳泄漏.

参数​

名称类型默认值可读可写可上报
当前值boolean0✔✘✔
默认值boolean0✔✔✘

BuiltInEffects​

该 Trait 包含设备支持的全部内置效果列表。每项包含 EffectID（0x00-0x7F）与 BuiltInEffectLabelID。

空列表表示当前无内置效果；为空值（Null）表示该信息当前不可用。

参数​

名称类型默认值可读可写可上报
当前值list[BuiltInEffectsTraitPresentValueStructure]✔✘✔
是否为空booleanFalse✔✘✔

MaxUserDefinedEffects​

该 Trait 指示设备可支持的用户自定义效果最大数量。

当效果数量达到上限时，新增用户自定义效果操作应返回容量相关错误。

参数​

名称类型默认值可读可写可上报
当前值uint8✔✘✔
最大值uint832.0✔✘✘
最小值uint81.0✔✘✘
步长uint321.0✔✘✘

CurrentEffectID​

该 Trait 指示当前激活效果的 EffectID；为空时表示当前没有激活效果。

该值可用于界面高亮当前生效效果，并作为后续查询、切换或停止逻辑的上下文。

参数​

名称类型默认值可读可写可上报
当前值uint8✔✘✔
是否为空booleanFalse✔✘✔

EffectInfo​

该 Trait 提供效果信息列表，每项包含 EffectID、EffectData 与 EffectName，用于维护、展示与同步效果详情。

此 Trait 由云端维护，设备不上报。

EffectData 的编码应与效果写入/预览命令保持一致，以便客户端在读取后可直接展示、备份或复用。

参数​

名称类型默认值可读可写可上报
当前值list[EffectInfoTraitPresentValueStructure]✔✘✔

MaxEffectNameLength​

指示窗饰设备用户自定义场景中 EffectName 字段允许的最大字节长度。该值按设备固定，范围为 1–32。

参数​

名称类型默认值可读可写可上报
当前值uint8✔✘✔
最大值uint832.0✔✘✘
最小值uint81.0✔✘✘
步长uint321.0✔✘✘

UserDefinedEffects​

该 Trait 包含设备当前存储的全部用户自定义效果列表。每项包含 EffectID（0x80-0xFE）与 EffectName。

空列表表示当前没有用户自定义效果；为空值（Null）表示该信息当前不可用（例如设备初始化中或数据暂不可读取）。

参数​

名称类型默认值可读可写可上报
当前值list[UserDefinedEffectsTraitPresentValueStructure]✔✘✔

OnTransitionTime​

该 Trait 用于指示同端点 On/Off Cluster 接收到 On 命令时的亮度过渡时长。

其语义为：设备应在该时长内将 CurrentLevel 从设备允许的最小亮度逐步过渡到最大亮度。

该值单位为 0.1 s（十分之一秒）。例如，取值 10 表示 1.0 s 的开灯过渡时长。

当本 Trait 未实现，或 Present Value 为空值（null）时，设备应回退使用 OnOffTransitionTime 的配置。

参数​

名称类型默认值可读可写可上报
当前值int320✔✔✔
最大值int324.294967295E9✔✘✘
最小值int321.0✔✘✘
步长uint321.0✔✘✘
默认值int320✔✔✘

CurrentLevel​

该 Trait 表示当前亮度等级，是 Level Control 的核心状态值。

在 Matter 侧（灯类设备）通常使用 1-254 的等级区间；Aqara 侧使用百分比语义，映射示例为 1%≈1、50%≈127、100%≈254。

参数​

名称类型默认值可读可写可上报
当前值float50✔✔✔
最大值float100.0✔✘✘
最小值float1.0✔✘✘
步长uint321.0✔✘✘
默认值float50✔✔✘
最大实际值float✔✘✘
最小实际值float✔✘✘

OffTransitionTime​

该 Trait 用于指示同端点 On/Off Cluster 接收到 Off 命令时的亮度过渡时长。

其语义为：设备应在该时长内将 CurrentLevel 从最大亮度逐步过渡到设备允许的最小亮度（通常对应关灯状态）。

该值单位为 0.1 s（十分之一秒）。例如，取值 10 表示 1.0 s 的关灯过渡时长。

当本 Trait 未实现，或 Present Value 为空值（null）时，设备应回退使用 OnOffTransitionTime 的配置。

参数​

名称类型默认值可读可写可上报
当前值int320✔✔✔
最大值int324.294967295E9✔✘✘
最小值int321.0✔✘✘
步长uint321.0✔✘✘
默认值int320✔✔✘

CurrentY​

该 Trait 表示 CIE 1931 色度坐标 y 分量。

关系式为：y = CurrentY / 65536，且 CurrentY 有效范围为 0-65279。

参数​

名称类型默认值可读可写可上报
当前值uint16✔✔✔
最大值uint1665279.0✔✘✘
最小值uint160.0✔✘✘
步长uint321.0✔✘✘

ColorMode​

ColorMode trait 用于表示照明设备当前所工作的颜色空间，即设备当前用于接收和上报颜色数据时所采用的颜色编码格式或坐标体系，支持读和上报，不支持写。其取值为 Hue 颜色、XY 颜色、色温和 RGB 颜色四种，其中 Hue 颜色表示基于色调（Hue）的颜色描述方式，通常配合饱和度和明度使用，适合直观的色彩选择；XY 颜色表示基于 CIE 1931 色度坐标的精确颜色描述方式，具有设备无关性，适用于专业色彩管理场景；色温表示基于色温值（微导度 取值为 1000000 / 开尔文色温值）描述白光颜色，用于调节白光的冷暖感；RGB 颜色表示基于红绿蓝三基色分量描述彩色光，是最常见的全彩控制方式。需要说明的是，ColorMode 与 LightingModeSetting 是两个不同层次的 trait：LightingModeSetting 决定了设备所支持的功能集合（如是否支持色温、是否支持颜色等），影响物模型数据点的暴露，而 ColorMode 仅决定了当前颜色数据的具体编码格式，两者相互独立但共同影响设备的颜色控制行为。特别地，当该灯设备是被桥接在网关下的子设备时，网关会自动识别子设备实际所支持的颜色空间，并更新该子设备的物模型数据。因此，外部系统（如 App 或 AI 控制）要控制灯的颜色时，应依据设备的物模型中包含的 trait 和 command（例如是否包含色温控制、RGB 控制或 XY 控制等命令）来判断可发送哪些具体的颜色控制命令，而网关会自动处理颜色空间的适配、最终控制子设备。

参数​

名称类型默认值可读可写可上报
当前值ColorModeEnum8✔✘✔
支持的值list[ColorModeEnum8]✔✘✘

WhitePointXY​

定义白点在 CIE 1931 色度空间中的 X、Y 坐标，用于描述设备白点基准。

参数​

名称类型默认值可读可写可上报
当前值WhitePointXYPresentValueStructure✔✘✔

ColorTemperature​

该 Trait 用于色温值的访问与上报。

实现中常使用 Kelvin 与 Mired 互转：Mired = 1000000 / Kelvin。

参数​

名称类型默认值可读可写可上报
当前值uint32270✔✔✔
最大值uint32370.0✔✘✘
最小值uint32153.0✔✘✘
步长uint321.0✔✘✘
默认值uint32270✔✔✘

LEDICQuantity​

指示调光驱动器 IC 的数量。

参数​

名称类型默认值可读可写可上报
当前值uint16✔✔✔
最大值uint1665535.0✔✘✘
最小值uint160.0✔✘✘
步长uint321.0✔✘✘

ColorRGB​

ColorRGB表示RGB颜色空间中的RGB颜色值。

参数​

名称类型默认值可读可写可上报
当前值uint320✔✔✔
最大值uint321.6777215E7✔✘✘
最小值uint320.0✔✘✘
步长uint321.0✔✘✘
默认值uint320✔✔✘

ColorXY​

ColorXY 表示 CIE 1931 色彩空间中的 x 与 y。

映射关系为：前两个字节对应 CurrentX，后两个字节对应 CurrentY；其中 x = CurrentX / 65536、y = CurrentY / 65536。

参数​

名称类型默认值可读可写可上报
当前值uint320✔✔✔
最大值uint324.2949673E9✔✘✘
最小值uint320.0✔✘✘
步长uint321.0✔✘✘
默认值uint320✔✔✘

Hue​

包含光源的当前色调值，以度为单位（ 0-360 ）。

与 Matter CurrentHue 互转关系为：Hue(deg) = CurrentHue * 360 / 254。

参数​

名称类型默认值可读可写可上报
当前值float✔✔✔
最大值float360.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘

StartUpXYColor​

ColorXY表示CIE xyY颜色空间中的x和y值，包含ColorX和ColorY元素，其中x = ColorX/65535 ，其中y = ColorY/65535。

参数​

名称类型默认值可读可写可上报
当前值StartUpXYColorTraitPresentValueStructure0✔✔✔
最大值uint324.2949673E9✔✘✘
最小值uint320.0✔✘✘
步长uint321.0✔✘✘
默认值StartUpXYColorTraitPresentValueStructure0✔✔✘

LightingMusicSyncMode​

确定启用后灯光如何随音乐响应（如随机效果、呼吸过渡、彩虹流动或水波纹等）。

参数​

名称类型默认值可读可写可上报
当前值LightingMusicSyncModeEnum80✔✔✔
支持的值list[LightingMusicSyncModeEnum8]✔✘✘
默认值uint80✔✔✘

StartUpColorTemperature​

设置设备上电且灯开启时应用的默认色温。

参数​

名称类型默认值可读可写可上报
当前值uint32270✔✔✔
最大值uint32370.0✔✘✘
最小值uint32153.0✔✘✘
步长uint321.0✔✘✘
默认值uint32270✔✔✘

LightingDynamicSceneMode​

支持动态灯光效果（如彩虹流动、呼吸渐变、闪烁等），并提供“正向彩虹”或“瀑布”等预设场景，呈现丰富的视觉体验。

参数​

名称类型默认值可读可写可上报
当前值LightingDynamicSceneModeEnum80✔✔✔
支持的值list[LightingDynamicSceneModeEnum8]✔✘✘
默认值uint80✔✔✘

Saturation​

包含光源当前饱和度。

与 Matter CurrentSaturation 互转关系为：Saturation(0~1) = CurrentSaturation / 254，在 Aqara 百分比视图中可按 0-100% 展示。

参数​

名称类型默认值可读可写可上报
当前值float50✔✔✔
最大值float100.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float50✔✔✘

CurrentG​

该 Trait 用于「绿色值」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值int32✔✔✔
最大值int32255.0✔✘✘
最小值int320.0✔✘✘
步长uint321.0✔✘✘

CurrentB​

该 Trait 用于「蓝色值」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值int32✔✔✔
最大值int32255.0✔✘✘
最小值int320.0✔✘✘
步长uint321.0✔✘✘

LightingMusicSyncEnable​

使灯光颜色与亮度随音乐节奏同步变化，实现动态视听效果。

参数​

名称类型默认值可读可写可上报
当前值boolean0✔✔✔
默认值boolean0✔✔✘

CurrentX​

该 Trait 表示 CIE 1931 色度坐标 x 分量。

关系式为：x = CurrentX / 65536，且 CurrentX 有效范围为 0-65279。

参数​

名称类型默认值可读可写可上报
当前值uint16✔✔✔
最大值uint1665279.0✔✘✘
最小值uint160.0✔✘✘
步长uint321.0✔✘✘

ColorPointRGBXY​

定义 RGB 三基色在 CIE 1931 色度空间中的坐标点（R/G/B 各包含 X、Y），用于描述设备色域边界。

参数​

名称类型默认值可读可写可上报
当前值ColorPointRGBXYPresentValueStructure✔✘✔

LEDICProtocol​

指示 LED 的 IC 协议。

参数​

名称类型默认值可读可写可上报
当前值LEDICProtocolEnum8✔✔✔
支持的值list[LEDICProtocolEnum8]✔✘✘

LEDType​

指示 LED 灯珠类型。

参数​

名称类型默认值可读可写可上报
当前值LEDTypeEnum8✔✔✔
支持的值list[LEDTypeEnum8]✔✘✘

CurrentR​

该 Trait 用于「红色值」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值int32✔✔✔
最大值int32255.0✔✘✘
最小值int320.0✔✘✘
步长uint321.0✔✘✘

MotorSpeedPercentage​

定义电机运行速度百分比，范围为 1（最低速）至 100（最高速）。

参数​

名称类型默认值可读可写可上报
当前值float50✔✔✔
最大值float100.0✔✘✘
最小值float1.0✔✘✘
步长uint321.0✔✘✘
默认值float50✔✔✘

WindowCoveringCategory​

由窗帘类设备上报，用于将窗饰设备划分为大类。

参数​

名称类型默认值可读可写可上报
当前值WindowCoveringCategoryEnum80✔✘✔
支持的值list[WindowCoveringCategoryEnum8]✔✘✘
默认值uint80✔✔✘

WindowCoveringMotorsBinding​

指示窗帘类设备的多个电机是否逻辑绑定以实现统一控制。值：false = 独立控制，true = 统一主控。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✔✔

UnconfiguredTravelControlPermission​

用于指示窗帘电机设备未配置行程时是否允许控制。

参数​

名称类型默认值可读可写可上报
当前值boolean1✔✘✔
默认值boolean1✔✔✘

LimitPointSetting​

用于配置窗帘电机限位点，具体设置全开或全关限位位置。

参数​

名称类型默认值可读可写可上报
当前值LimitPointSettingEnum8✔✔✔
支持的值list[LimitPointSettingEnum8]✔✘✘

ObstacleLimitMarkingBlockTime​

障碍物限位标记功能被禁用的时长（秒）。

参数​

名称类型默认值可读可写可上报
当前值uint8255✔✔✔
最大值uint8255.0✔✘✘
最小值uint810.0✔✘✘
步长uint321.0✔✘✘
默认值uint8255✔✔✘

MotorSpeedSetting​

定义电机运行速度档位，范围为 1（最低速）至 2（最高速）。

参数​

名称类型默认值可读可写可上报
当前值MotorSpeedSettingEnum81✔✔✔
支持的值list[MotorSpeedSettingEnum8]✔✘✘
默认值uint81✔✔✘

ManualPullStartStopEnabled​

启用允许用户通过拉动手动启停窗帘/窗饰移动的功能。

参数​

名称类型默认值可读可写可上报
当前值boolean1✔✔✔
默认值boolean1✔✔✘

CurrentRotationAngle​

当前值指示窗饰设备当前的旋转角度，范围为 -90 度至 90 度。

参数​

名称类型默认值可读可写可上报
当前值float✔✘✔
最大值float90.0✔✘✘
最小值float-90.0✔✘✘
步长uint321.0✔✘✘

ObstacleLimitSensitivity​

指窗帘电机遇到障碍物时的灵敏度设置。

参数​

名称类型默认值可读可写可上报
当前值ObstacleLimitSensitivityEnum82✔✔✔
支持的值list[ObstacleLimitSensitivityEnum8]✔✘✘
默认值uint82✔✔✘

TripTime​

指示电机行程时间，即从完全打开到完全关闭（或相反）所需的时间（秒）。取值范围为 1 至 300 秒，默认 10 秒。

参数​

名称类型默认值可读可写可上报
当前值float✔✘✔
最大值float300.0✔✘✘
最小值float1.0✔✘✘
步长uint321.0✔✘✘

TravelConfigured​

指示窗帘电机行程（运动范围）是否已配置。

参数​

名称类型默认值可读可写可上报
当前值boolean0✔✘✔
默认值boolean0✔✔✘

CurrentPositionPercentage​

以 0% 至 100% 的百分比标识实际位置，默认步进 1%。

参数​

名称类型默认值可读可写可上报
当前值float50✔✘✔
最大值float100.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float50✔✔✘

MotorControllability​

指示电机当前是否可控。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✘✔

MotorDirectionReversed​

指定电机运行方向是否反转，影响窗饰设备的开合方式。

参数​

名称类型默认值可读可写可上报
当前值boolean0✔✔✔
默认值boolean0✔✔✘

WindowCoveringType​

标识窗饰产品类型（如卷帘、百叶窗、窗帘等）。值为支持值列表中定义的枚举（0 = Roller Shade，1 = Venetian Blind，… 255 = Unknown）。

参数​

名称类型默认值可读可写可上报
当前值WindowCoveringTypeEnum80✔✔✔
支持的值list[WindowCoveringTypeEnum8]✔✘✘
默认值uint80✔✔✘

ObstacleLimitAutoReboundEnable​

启用后，窗帘电机遇障碍物时反转方向，防止损坏。

参数​

名称类型默认值可读可写可上报
当前值boolean1✔✔✔
默认值boolean1✔✔✘

ManualPullEvent​

跟踪或发出由窗饰设备手动拉动交互触发的事件。

参数​

名称类型默认值可读可写可上报
当前值ManualPullEventEnum32✘✘✔
支持的值list[ManualPullEventEnum32]✔✘✘

TargetPositionPercentage​

该 Trait 用于「目标位置百分比」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值float50✔✔✔
最大值float100.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float50✔✔✘

TargetRotationAngle​

当前值指定窗饰设备的目标旋转角度，范围为 -90 度至 90 度。

参数​

名称类型默认值可读可写可上报
当前值float✔✔✔
最大值float90.0✔✘✘
最小值float-90.0✔✘✘
步长uint321.0✔✘✘

WindowCoveringOpenOrientation​

标识自动控制的实际窗饰开启方向。

参数​

名称类型默认值可读可写可上报
当前值WindowCoveringOpenOrientationEnum8✔✔✔
支持的值list[WindowCoveringOpenOrientationEnum8]✔✘✘

MotorOperationStatus​

指示电机当前运行状态。

参数​

名称类型默认值可读可写可上报
当前值MotorOperationStatusEnum82✔✘✔
支持的值list[MotorOperationStatusEnum8]✔✘✘
默认值uint82✔✔✘

ManualPullStartEnabled​

启用允许用户通过拉动手动启动窗帘/窗饰移动的功能。

参数​

名称类型默认值可读可写可上报
当前值boolean1✔✔✔
默认值boolean1✔✔✘

LimitPointCount​

表示为窗帘类电机配置的限位点（或行程限位）数量。

参数​

名称类型默认值可读可写可上报
当前值uint80✔✘✔
最大值uint82.0✔✘✘
最小值uint80.0✔✘✘
步长uint321.0✔✘✘
默认值uint80✔✔✘

TargetPositionRotationPercentage​

TargetPositionRotationPercentage 特征的当前值以百分比表示窗饰设备俯仰将要到达或正在移动的目标位置（单位 1%）。

参数​

名称类型默认值可读可写可上报
当前值float0✔✔✔
最大值float100.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float0✔✔✘

CurrentPositionRotationPercentage​

CurrentPositionRotationPercentage 特征的当前值以百分比表示实际俯仰/旋转位置，范围为 0% 至 100%，默认步进为 1%。

参数​

名称类型默认值可读可写可上报
当前值float0✔✘✔
最大值float100.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float0✔✔✘

ManualPullStopEnabled​

启用允许用户通过拉动手动停止窗帘/窗饰移动的功能。

参数​

名称类型默认值可读可写可上报
当前值boolean1✔✔✔
默认值boolean1✔✔✘

ObstacleLimitMarkingEnable​

启用或禁用电机遇阻时标记限位点（开或关）的功能。

参数​

名称类型默认值可读可写可上报
当前值boolean1✔✔✔
默认值boolean1✔✔✘

ManualPullAdaptiveSpeedEnabled​

允许在手动拉力操作期间进行自适应速度调整，提供基于拉力的可变速度响应。

参数​

名称类型默认值可读可写可上报
当前值boolean0✔✔✔
默认值boolean0✔✔✘

HoldTime​

无人判定延时

参数​

名称类型默认值可读可写可上报
当前值uint161✔✔✔
最小值uint161.0✔✘✘
默认值uint161✔✔✘

DurationOccupiedWithinOneWeek​

表示 occupancy 传感器在一周内（从周一 00:00:00 起算的自然周）检测到被占用的总时长，单位为毫秒。

参数​

名称类型默认值可读可写可上报
当前值float✔✘✔
最大值float6.048E8✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘

Occupancy​

该 Trait 用于「存在状态」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✘✔

DurationOccupiedWithinOneDay​

表示 occupancy 传感器在一天内检测到被占用的总时长，单位为毫秒。

参数​

名称类型默认值可读可写可上报
当前值float✔✘✔
最大值float8.64E7✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘

OccupancySensorType​

指定占用传感器类型（如 PIR、超声波、雷达、视觉等）。

参数​

名称类型默认值可读可写可上报
当前值OccupancySensorTypeEnum8✔✘✔
支持的值list[OccupancySensorTypeEnum8]✔✘✘

BooleanState​

BooleanState描述如何在设备的上下文中使用布尔值（可能在智能家居系统中）来表示统计信息

参数​

名称类型默认值可读可写可上报
当前值boolean0✔✘✔
默认值boolean0✔✔✘

ExpressedState​

ExpressedState 定义了报警器的状态.

参数​

名称类型默认值可读可写可上报
当前值ExpressedStateEnum80✔✘✔
支持的值list[ExpressedStateEnum8]✔✘✘
默认值uint80✔✔✘

FireProductIdentification​

该 Trait 用于「消防识别码」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

SmokeDensitydB​

该 Trait 用于「烟雾浓度dB」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值float0✔✘✔
最大值float10.0✔✘✘
最小值float0.0✔✘✘
步长uint320.001✔✘✘
默认值float0✔✔✘

SmokeChamberContamination​

指示烟腔污染状态。该 Trait 使用枚举表示灰尘或颗粒物积聚遮挡光路造成的不同污染等级。非零值表示需要维护，值越高可能表示污染越严重。

参数​

名称类型默认值可读可写可上报
当前值SmokeChamberContaminationEnum80✔✘✔
支持的值list[SmokeChamberContaminationEnum8]✔✘✘
默认值uint80✔✔✘

AlarmError​

该 Trait 用于「报警错误」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值AlarmErrorEnum8✔✔✔
支持的值list[AlarmErrorEnum8]✔✘✘

SelfCheck​

便于执行自检以验证设备功能是否正常。

参数​

名称类型默认值可读可写可上报
当前值boolean0✔✔✔
默认值boolean0✔✔✘

SmokeState​

该 Trait 用于「烟雾状态」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值SmokeStateEnum8✔✘✔
支持的值list[SmokeStateEnum8]✔✘✘

AlarmsEnabled​

该 Trait 用于「报警使能」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✔✔

ContaminationState​

该 Trait 用于「报警器污染」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✔✔

Mute​

指示扬声器静音状态。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✔✔

SmokeDensity​

该 Trait 用于「烟雾浓度」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值float0✔✘✔
最大值float5.0✔✘✘
最小值float0.0✔✘✘
步长uint320.001✔✘✘
默认值float0✔✔✘

SmokeDetected​

该 Trait 用于「烟雾检测状态」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✘✔

EnableHeartbeatIndicator​

该 Trait 用于「心跳指示灯控制」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值boolean1✔✔✔
默认值boolean1✔✔✘

FreshAirMode​

该特征定义新风模式。

参数​

名称类型默认值可读可写可上报
当前值FreshAirModeEnum80✔✔✔
支持的值list[FreshAirModeEnum8]✔✘✘
默认值uint80✔✔✘

AnalogOutputPV​

AnalogOutputPV携带模拟输出对象的指令值或实际值。

参数​

名称类型默认值可读可写可上报
当前值float✔✔✔

MotionDetected​

该 Trait 用于「移动侦测」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值MotionDetectedEnum8✘✘✔
支持的值list[MotionDetectedEnum8]✔✘✘

PetRecognitionReport​

使智能设备准确识别宠物类型。检测到猫、狗或两者时，自动上报具体类型。

参数​

名称类型默认值可读可写可上报
当前值PetRecognitionReportEnum16✘✘✔
支持的值list[PetRecognitionReportEnum16]✔✘✘

PM1.0Density​

该 Trait 用于「PM1.0浓度」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值float0✔✘✔
最大值float65535.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float0✔✔✘

PM2.5Density​

该 Trait 用于「PM2.5浓度」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值float0✔✘✔
最大值float1000.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float0✔✔✘

PM2.5Level​

该 Trait 用于「PM2.5等级」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值PM2.5LevelEnum8✔✘✔
支持的值list[PM2.5LevelEnum8]✔✘✘

PM10Density​

该 Trait 用于「PM10浓度」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值float0✔✘✔
最大值float65535.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float0✔✔✘

AnomalySoundDetected​

该功能使设备能够智能识别环境中的异常声音。例如，检测到符合婴儿哭声特征的事件时将上报哭声事件。

参数​

名称类型默认值可读可写可上报
当前值AnomalySoundDetectedEnum8✘✘✔
支持的值list[AnomalySoundDetectedEnum8]✔✘✘

RingtonePlayVolume​

指示播放铃声或音乐的音量等级。取值范围为 0（静音）至 100（最大音量）。

参数​

名称类型默认值可读可写可上报
当前值float50✔✔✔
最大值float100.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float50✔✔✘

RingtonePlayIndex​

指示待播放铃声或音乐的索引。该特征允许从预定义列表中选择特定音轨，每个索引对应唯一的铃声或音乐标识符。该值为映射到音频文件的枚举。

参数​

名称类型默认值可读可写可上报
当前值RingtonePlayIndexEnum32✔✔✔
支持的值list[RingtonePlayIndexEnum32]✔✘✘

RingtonePlayStatus​

指示铃声或音乐当前播放状态。值 0 通常表示停止或空闲，1 表示播放中。允许查询和控制当前是否正在播放音频。

参数​

名称类型默认值可读可写可上报
当前值RingtonePlayStatusEnum80✔✔✔
支持的值list[RingtonePlayStatusEnum8]✔✘✘
默认值uint80✔✔✘

RingtonePlayDuration​

指示铃声或音乐播放时长。值表示播放时间（秒）。值为 0 表示播放一次（单次播放）；大于 0 表示播放指定秒数。

参数​

名称类型默认值可读可写可上报
当前值uint320✔✔✔
最大值uint324.294967295E9✔✘✘
最小值uint320.0✔✘✘
步长uint321.0✔✘✘
默认值uint320✔✔✘

BridgedNodeList​

表示添加到此 Bridge Node 的桥接节点 Device ID 列表。字符串数组。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

SupportedHubCapability​

该属性以位掩码形式上报网关作为智能家居中枢所具备的核心功能特性。每一位代表一项特定能力（如本地自动化、数据存储、AI 支持）。上层应用据此发现并适配设备高级功能，实现差异化体验。

bit 0：支持网关基础功能（支持创建网关集群等）

bit 1：具备本地自动化模块 ha_driven

bit 2：支持网关本地数据存储功能 NAS

bit 3：支持 SAAS

bit 4：支持本地 AI

bit 5：支持局域网 APP 控制

bit 6：支持运行 Aqara Studio

bit 7：支持 Aqara Studio 逻辑功能块

bit 8 至 31：保留

参数​

名称类型默认值可读可写可上报
当前值uint32✔✘✔
最大值uint324.294967295E9✔✘✘
最小值uint320.0✔✘✘
步长uint321.0✔✘✘

MatterBridgeSupported​

指示当前网关版本是否支持 Matter Bridge 功能。若为 true，App 可在设备详情中显示"Start Matter Journey"入口和"Bind Matter"选项；若为 false，则隐藏此类入口。值：false = 不支持，true = 支持。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✘✔

MatterDACState​

指示 Matter 设备认证证书（DAC）的就绪状态。0：正在获取 DAC；1：DAC 获取失败；2：DAC 已就绪。

参数​

名称类型默认值可读可写可上报
当前值MatterDACStateEnum8✔✘✔
支持的值list[MatterDACStateEnum8]✔✘✘

MatterOnboardingPayload​

提供 Matter 配网所需的入网信息。值为 JSON 对象，包含 onboarding payload 字符串和手动配对码。示例：{"onboarding_payload":"MT:AR7A0OEP01C26Y2SQ10","manual_pairing_code":"0118-064-9202"}。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

MatterManufacturerList​

提供设备已绑定的 Matter 生态系统（fabric）列表。值为 JSON 数组，每个对象包含：vendor_id（十进制整数）、Manufacturer（显示名称字符串）、fabric（共享信任域标识符）、node_id（设备标识符字符串）。示例格式：{"list":[{"vendor_id":24582,"Manufacturer":"Google","fabric":"10001","node_id":"10001"}, ...]}。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

MatterBindState​

指示设备的 Matter 绑定状态。0：尚未绑定任何 Matter 生态；1：已成功绑定至少一个 Matter 生态。

参数​

名称类型默认值可读可写可上报
当前值MatterBindStateEnum8✔✘✔
支持的值list[MatterBindStateEnum8]✔✘✘

MatterPairingState​

指示当前 Matter 配对状态或错误原因。可能取值：0x00 = 未处于配对模式；0x01 = 正常配对模式激活；0x02 = 超出设备绑定上限（最多 10 个），请移除部分生态后重试；0x03 = 设备证书无效，请稍后重试；0x04 = 准备中，请稍后重试。

参数​

名称类型默认值可读可写可上报
当前值MatterPairingStateEnum8✔✘✔
支持的值list[MatterPairingStateEnum8]✔✘✘

MatterPairingSwitch​

写入 true 时在网桥上启动 Matter 配对模式；若未完成，10 分钟后自动退出配对。写入 false 时立即禁用配对。读取表示配对模式当前是否激活。取值：true = 进入配对，false = 关闭/禁用配对。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✔✔

TargetGarageDoorState​

该 Trait 用于「目标（车库）门状态」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值TargetGarageDoorStateEnum8✔✔✔
支持的值list[TargetGarageDoorStateEnum8]✔✘✘

CurrentGarageDoorState​

描述车库门当前状态。取值：1=Unknown，2=Open，3=Closed，4=Opening，5=Closing，6=Not Fully Open，7=Not Fully Closed。

参数​

名称类型默认值可读可写可上报
当前值CurrentGarageDoorStateEnum8✔✘✔
支持的值list[CurrentGarageDoorStateEnum8]✔✘✘

SleepQuality​

定义睡眠质量，取值范围 0 至 100。

参数​

名称类型默认值可读可写可上报
当前值float0✔✘✔
最大值float100.0✔✘✘
最小值float0.0✔✘✘
步长uint321.0✔✘✘
默认值float0✔✔✘

SleepStage​

定义睡眠阶段。

参数​

名称类型默认值可读可写可上报
当前值SleepStageEnum8✔✘✔
支持的值list[SleepStageEnum8]✔✘✘

SleepState​

该 Trait 用于「睡眠状态」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值SleepStateEnum8✔✘✔
支持的值list[SleepStateEnum8]✔✘✘

OnBed​

定义在床状态。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✘✔

BinaryInputPV​

BinaryInputPV报告离散输入的瞬时逻辑状态，并可选择描述极性反转。

参数​

名称类型默认值可读可写可上报
当前值boolean0✔✘✔
默认值boolean0✔✔✘

LeakState​

该 Trait 用于「泄漏状态」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✘✔

VehicleDetected​

使设备识别监控区域内的车辆。观察到车辆进入、移动或停放时，自动上报车辆检测事件。

参数​

名称类型默认值可读可写可上报
当前值VehicleDetectedEnum8✘✘✔
支持的值list[VehicleDetectedEnum8]✔✘✘

BSSID​

BSSID 应指示节点当前所连接 Wi-Fi 网络的 BSSID。

参数​

名称类型默认值可读可写可上报
当前值characterString✔✘✔

IRBrand​

指示红外设备（如空调、电视）的品牌标识。

规格源中对应 Trait 代码为 IRBrandId。

参数​

名称类型默认值可读可写可上报
当前值uint320✔✔✔
最大值uint324.294967295E9✔✘✘
最小值uint320.0✔✘✘
步长uint321.0✔✘✘
默认值uint320✔✔✘

MinPINCodeLength​

该 Trait 用于「最小PINCode长度」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值uint8✔✘✔
最大值uint8255.0✔✘✘
最小值uint80.0✔✘✘
步长uint321.0✔✘✘

MinRFIDCodeLength​

该 Trait 用于「最小RFID长度」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值uint8✔✘✔
最大值uint8255.0✔✘✘
最小值uint80.0✔✘✘
步长uint321.0✔✘✘

OperatingMode​

该 Trait 用于「操作模式」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值OperatingModeEnum8✔✘✔
支持的值list[OperatingModeEnum8]✔✘✘

ActuatorEnabled​

该 Trait 用于「执行器启用」相关数据的访问与上报。

参数​

名称类型默认值可读可写可上报
当前值boolean✔✘✔

ExtendedPANID​

当前值为 64 位唯一标识符，用于标识 Thread 网络中的个人区域网络（PAN）。它与 PANID 配合使用以区分不同网络。每个网络具有唯一的 ExtendedPANID，所有加入该网络的节点必须使用相同的 ExtendedPANID 才能相互通信。

参数​

名称类型默认值可读可写可上报
当前值uint64✔✘✔
最大值uint641.8446744073709552E19✔✘✘
最小值uint640.0✔✘✘
步长uint321.0✔✘✘

ModeCount​

描述设备支持的模式数量。格式：int。

参数​

名称类型默认值可读可写可上报
当前值int32✔✘✔
最大值int324.294967295E9✔✘✘
最小值int320.0✔✘✘
步长uint321.0✔✘✘