跳到主要内容

数据类型

本文档汇总 Trait / Command 参数中引用的自定义数据类型(枚举、结构体等)。

ActiveHardwareFaultsEnum32

该枚举定义 ActiveHardwareFaults Trait 的 Present Value 有效取值。

取值名称说明
0x00Unspecified未知故障
0x01Radio无线电故障
0x02Sensor传感器故障
0x03ResettableOverTemp过热保护
0x04NonResettableOverTemp过热异常
0x05PowerSource电源故障
0x06VisualDisplayFault显示故障
0x07AudioOutputFault音频输出故障
0x08UserInterfaceFault界面显示故障
0x09NonVolatileMemoryError内存故障
0x0ATamperDetected设备被拆卸/篡改
0xFFNormal无故障

ActivityDetectionModeSettingEnum32

该枚举定义 ActivityDetectionModeSetting Trait 的 Present Value 有效取值。

取值名称说明
0x01HumanPresence人体存在
0x03PersonnelLocation人员定位
0x05FallDetection跌倒侦测
0x08CeilingFallSingleTracking顶装跌倒和单人定位
0x09SleepMode睡眠
0x11GestureControl手势

AddOrUpdateThreadNetwork Command Structure

AddOrUpdateThreadNetwork Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0OperationalDatasetoctetString必选参数。

AddOrUpdateThreadNetworkResponse Command Structure

AddOrUpdateThreadNetworkResponse Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0StatusCodesuint8必选参数。

AddOrUpdateWiFiNetwork Command Structure

AddOrUpdateWiFiNetwork Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0SSIDcharacterString可选参数。
1CredentialscharacterString可选参数。
2Encryptionuint8可选参数。
3CountryDomaincharacterString可选参数。
4BindkeycharacterString可选参数。
5TimeZonecharacterString可选参数。

AddOrUpdateWiFiNetworkResponse Command Structure

AddOrUpdateWiFiNetworkResponse Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0StatusCodesuint8必选参数。

AddOrUpdateZigbeeNetwork Command Structure

AddOrUpdateZigbeeNetwork Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0Channeluint8必选参数。
1ExtendedPANIDoctetString必选参数。
2NetworkKeyoctetString必选参数。
3NetworkNamecharacterString可选参数。
4PANIDuint16必选参数。

AddOrUpdateZigbeeNetworkResponse Command Structure

AddOrUpdateZigbeeNetworkResponse Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0StatusCodesuint8必选参数。

AddressingModeEnum8

该枚举定义 NetworkInterfacesTraitPresentValueStructure 中 AddressingMode 字段有效取值。

取值名称说明
0x00DHCP通过 DHCP 动态分配 IP 地址
0x01Static静态配置 IP 地址
0x02Auto自动配置(如 IPv6 SLAAC 或链路本地地址)
0xFFUnspecified未指定或未知

AddUserDefinedEffect Command Structure

AddUserDefinedEffect Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0EffectNamecharacterString必选新增场景名称,UTF-8 字节长度不得超过 MaxEffectNameLength。
1EffectDatacharacterString必选新增场景的原始数据,编码格式应与 EffectData 规范一致。

AirflowDirectionEnum8

该枚举定义 AirflowDirection Trait 的 Present Value 有效取值。

取值名称说明
0x00ForwardForward
0x01ReverseReverse

AirQualityEnum8

该枚举定义 AirQuality Trait 的 Present Value 有效取值。

取值名称说明
0x00Unknown未知
0x01Excellent
0x02Good
0x03Fair
0x04Inferior
0x05Poor极差

AlarmErrorEnum8

该枚举定义 AlarmError Trait 的 Present Value 有效取值。

取值名称说明
0x00SUCCESS成功
0x01FAILURE失败
0x02NOT_ALLOWED不允许

AllpagesTraitPresentValueStructure

AllpagesWidgetStructure

该结构体定义 Allpages 页面 Widgets 列表元素字段布局。

结构体成员序号字段名类型是否必选说明
0WidgetIDuint16必选控件 ID。
1WidgetPositionWidgetPositionStructure必选控件位置与尺寸。
2WidgetModeenum8必选控件模式:0=Basic,1=Lighting-ColorTempControl,2=Lighting-BrightnessControl,3=Lighting-ColorControl,4=AirCondition-TemperatureControl,5=AirCondition-FanSpeed,6=WindowCovering-Operation,7=DoorLock-Operation。
3AssociatedDeviceInfoAssociatedDeviceInfoStructure必选关联设备信息。

AnomalySoundDetectedEnum8

该枚举定义 AnomalySoundDetected Trait 的 Present Value 有效取值。

取值名称说明
0x01CryDetected检测到哭声
0x02SnoreDetected检测到鼾声
0x03LoudSoundDetected检测到较大声响
0x04BabyCryDetected检测到婴儿啼哭
0x05AlarmSoundDetected检测到报警器报警音
0x06DogBarkDetected检测到宠物吠叫
0x07CoughDetected检测到咳嗽

AntiDeletionLevelSettingEnum8

该枚举定义 AntiDeletionLevelSetting Trait 的 Present Value 有效取值。

取值名称说明
0x00EnableResetAndFactory启用重置网络和恢复出厂
0x01DisableFactoryOnly仅禁用恢复出厂
0x02DisableResetAndFactory禁用重置网络和恢复出厂

AntiDeletionNotificationEnum8

该枚举定义 AntiDeletionNotification Trait 的 Present Value 有效取值。

取值名称说明
0x01Trigger触发

AntiDeletionSettingEnum8

该枚举定义 AntiDeletionSetting Trait 的 Present Value 有效取值。

取值名称说明
0x00Disable禁用
0x01Enable启用

AssociatedDeviceInfoStructure

该结构体定义 Widget 的 AssociatedDeviceInfo 字段布局。

结构体成员序号字段名类型是否必选说明
0DeviceNamecharacterString必选关联设备名称。
1DeviceTypeIDuint16必选Aqara 设备类型 ID。
2DeviceIconcharacterString必选设备图标。
3DeviceIDcharacterString必选目标设备 Device ID。
4EndPointIDuint16必选目标 Endpoint ID。
5ParentIDcharacterString可选父设备 Device ID;同一 Matter 控制器下可省略。
6ModelValuecharacterString可选非 Matter 设备的模型值;场景无需设置。

AttitudeDetectedEnum8

该枚举定义 AttitudeDetected Trait 的 Present Value 有效取值。

取值名称说明
0x00Normal正常
0x01FallDown跌倒
0x02SuspectedFall疑似跌倒

AuthenticationStatusEnum8

该枚举定义 AuthenticationStatus Trait 的 Present Value 有效取值。

取值名称说明
0x00NotAuthenticated未认证
0x01CertifiedAndValid已认证且合法
0x02NoCertificate没证书
0x03CertificateInvalid有证书但不合法

BatChargeStateEnum8

该枚举定义 BatChargeState Trait 的 Present Value 有效取值。

取值名称说明
0x00Unknown未知
0x01TheBatteryIsCharging正在充电
0x02TheBatteryIsAtFullCharge已充满电
0x03TheBatteryIsNotCharging未在充电
0x04TheBatteryIsNotChargeable不可充电

BatReplaceabilityEnum8

该枚举定义 BatReplaceability Trait 的 Present Value 有效取值。

取值名称说明
0x00Unspecified未指定
0x01NotReplaceable不可更换
0x02UserReplaceable用户可更换
0x03FactoryReplaceable工厂可更换

BindingTraitPresentValueStructure

该结构体定义 Binding Trait 的 Present Value 字段布局。

结构体成员序号字段名类型是否必选说明
0DeviceIDcharacterString必选目标设备的 Device ID。最大长度 32 字节。
1ParentIDcharacterString可选目标设备所属父设备 Device ID。若与绑定方处于同一首选 Matter 控制器,则无需设置。最大长度 32 字节。
2GroupIDuint32可选绑定目标为设备组时 SHALL 设置(Conformance: GROUP)。
3ModelValuecharacterString可选针对非 Matter 设备 SHALL 设置目标模型值(Conformance: !MATTER)。最大长度 32 字节。
4EndPointIDuint32必选目标设备的 Endpoint ID。
5DeviceTypeIDuint32必选目标设备的 Aqara Device Type ID。

BuiltInEffectsTraitPresentValueStructure

该结构体定义 BuiltInEffects Trait 的 Present Value 字段布局。

结构体成员序号字段名类型是否必选说明
0EffectIDuint8必选内置场景 ID。
1BuiltInEffectLabelIDenum8必选内置场景标签 ID。

ButtonEventEnum8

该枚举定义 ButtonEvent Trait 的 Present Value 有效取值。

取值名称说明
0x00SinglePress单击
0x01DoublePress双击
0x02LongPress长按
0x03LongPressRelease长按释放

CCAModeEnum8

该枚举定义 CCAMode Trait 的 Present Value 有效取值。

取值名称说明
0x00CCA1CCA1模式
0x01CCA1CCA2模式

ChangeIndicationEnum8

该枚举定义 ChangeIndication Trait 的 Present Value 有效取值。

取值名称说明
0x00OKOK
0x01Warming警告
0x02Critical紧急

ChangeTemperature Command Structure

ChangeTemperature Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0SetTemperaturefloat必选设置温度;默认值为 20

ChangeTemperatureLevel Command Structure

ChangeTemperatureLevel Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0SetTemperatureLeveluint8必选设置温度等级;默认值为 0

ChangeToMode Command Structure

ChangeToMode Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0CurrentModeuint16必选当前模式。

ChangeToModeResponseEnum16

该枚举定义 ChangeToModeResponse Trait 的 Present Value 有效取值。

取值名称说明
0x00Success成功
0x01UnsupportedMode不支持的模式
0x02GenericFailure一般故障
0x03InvalidInMode模式下无效
0x41Stuck被卡住
0x42DustBinMissing尘盒缺失
0x43DustBinFull尘盒已满
0x44WaterTankEmpty水箱为空
0x45WaterTankMissing水箱缺失
0x46WaterTankLidOpen水箱盖未关闭
0x47MopCleaningPadMissing拖布清洁垫缺失
0x48BatteryLow电池电量低

ChildDeviceProvisioningStateEnum8

该枚举定义 ChildDeviceProvisioningState Trait 的 Present Value 有效取值。

取值名称说明
0x00NotProvisioning未处于配网状态
0x01Provisioning处于配网状态

ClearWeekDaySchedule Command Structure

ClearWeekDaySchedule Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0WeekDayIndexuint8必选工作日索引;默认值为 1
1UserIndexuint16必选用户索引;默认值为 1

ClearYearDaySchedule Command Structure

ClearYearDaySchedule Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0YearDayIndexuint8必选年日序号;默认值为 1
1UserIndexuint16必选用户索引;默认值为 1

CO2LevelEnum8

该枚举定义 CO2Level Trait 的 Present Value 有效取值。

取值名称说明
0x00Excellent
0x01LightPollution轻度污染
0x02HeavyPollution重度污染

ColorModeEnum8

该枚举定义 ColorMode Trait 的 Present Value 有效取值。

取值名称说明
0x00HSV由 Hue 与 Saturation 决定当前颜色
0x01XY由 CurrentX 与 CurrentY 决定当前颜色
0x02ColorTemperature由色温值决定当前颜色

ColorPointRGBXYPresentValueStructure

该结构体定义 ColorPointRGBXY 的 Present Value 字段布局。

结构体成员序号字段名类型是否必选说明
0ColorPointRXuint16必选该参数表示设备当前红色原色点在 CIE xyY 色彩空间中定义的归一化色度值 x。x 与 ColorPointRX 属性满足关系:x = ColorPointRX / 65536(ColorPointRX 取值范围为 0 至 65279,含边界)。
1ColorPointRYuint16必选该参数表示设备当前红色原色点在 CIE xyY 色彩空间中定义的归一化色度值 y。y 与 ColorPointRY 属性满足关系:y = ColorPointRY / 65536(ColorPointRY 取值范围为 0 至 65279,含边界)。
2ColorPointGXuint16必选该参数表示设备当前绿色原色点在 CIE xyY 色彩空间中定义的归一化色度值 x。x 与 ColorPointGX 属性满足关系:x = ColorPointGX / 65536(ColorPointGX 取值范围为 0 至 65279,含边界)。
3ColorPointGYuint16必选该参数表示设备当前绿色原色点在 CIE xyY 色彩空间中定义的归一化色度值 y。y 与 ColorPointGY 属性满足关系:y = ColorPointGY / 65536(ColorPointGY 取值范围为 0 至 65279,含边界)。
4ColorPointBXuint16必选该参数表示设备当前蓝色原色点在 CIE xyY 色彩空间中定义的归一化色度值 x。x 与 ColorPointBX 属性满足关系:x = ColorPointBX / 65536(ColorPointBX 取值范围为 0 至 65279,含边界)。
5ColorPointBYuint16必选该参数表示设备当前蓝色原色点在 CIE xyY 色彩空间中定义的归一化色度值 y。y 与 ColorPointBY 属性满足关系:y = ColorPointBY / 65536(ColorPointBY 取值范围为 0 至 65279,含边界)。

ConfigStaticIPAddr Command Structure

ConfigStaticIPAddr Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0IPAddresscharacterString可选IP 地址,字符串(最大长度 32)。示例:192.168.1.100
1SubnetMaskcharacterString可选子网掩码,字符串(最大长度 32)。示例:255.255.255.0
2DefaultGatewaycharacterString可选默认网关,字符串(最大长度 32)。示例:192.168.1.1
3PrimaryDNScharacterString可选首选 DNS,字符串(最大长度 32)。示例:8.8.8.8
4SecondaryDNScharacterString可选备选 DNS,字符串(最大长度 32)。示例:8.8.4.4
5InterfaceNamecharacterString可选接口名称,字符串(最大长度 32)。示例:eth0。为空时表示应用于所有网络接口。
6AddressingModeenum8可选地址分配模式。0 表示切换为 DHCP 获取 IP(此时 IPAddressSubnetMaskPrimaryDNSDefaultGatewaySecondaryDNS 参数会被忽略);1 表示静态 IP 模式(可配置上述网络参数)。若该字段不存在,默认按静态 IP 模式处理。

ConfigurationVersionTraitPresentValueStructure

该结构体定义 ConfigurationVersion Trait 的 Present Value 字段布局。

结构体成员序号字段名类型是否必选说明
0ConfigurationVersionuint32必选设备配置版本号。
1ThingModelMd5characterString必选物模型 MD5 校验值。

ConnectToHomeStation Command Structure

ConnectToHomeStation Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0SSIDcharacterString必选SSID。
1CredentialscharacterString必选凭证。

ConnectToHomeStationResponse Command Structure

ConnectToHomeStationResponse Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0ConnectToHomeStationResponseenum8必选连接家庭基站反馈。

CubeEventEnum8

该枚举定义 CubeEvent Trait 的 Present Value 有效取值。

取值名称说明
0x00Flip90翻转90°
0x01Flip180翻转180°
0x02Push轻推
0x03TapTwice拿起敲两下
0x04Shake摇一摇
0x05Swing甩一下
0x06Rotate旋转
0x07TriggeredAfter1Minute静止后触动
0x0APickUpHold拿起保持

CubeWorkModeSettingEnum8

该枚举定义 CubeWorkModeSetting Trait 的 Present Value 有效取值。

取值名称说明
0x00Action Mode动作模式
0x01Scene Mode场景模式

CurOperationModeEnum8

该枚举定义 CurOperationMode Trait 的 Present Value 有效取值。

取值名称说明
0x00UnjoinedMode未入网模式
0x01NewlyJoinedMode新入网模式
0x02PollingMode仓储轮询模式
0x03UserMode用户模式
0x04DegradedMode亚健康模式
0x05RejoinMode仓储重连模式

CurrentGarageDoorStateEnum8

该枚举定义 CurrentGarageDoorState Trait 的 Present Value 有效取值。

取值名称说明
0x01Unknown未知
0x02Open打开
0x03Closed关闭
0x04Opening打开中
0x05Closing关闭中
0x06NotFullyOpen未完全打开
0x07NotFullyClosed未完全关闭

CurrentPlaybackStateEnum8

该枚举定义 CurrentPlaybackState Trait 的 Present Value 有效取值。

取值名称说明
0x00Playing播放中
0x01Paused暂停
0x02Stopped停止
0x03Buffering缓冲
0x04FastForwarding快进
0x05Rewinding快退

CurrentSafetyManagementEnum8

该枚举定义 CurrentSafetyManagement Trait 的 Present Value 有效取值。

取值名称说明
0x00CurrentNormal电流正常
0x01OverCurrentAnomaly过流异常
0x02OverCurrentProtection过流保护

CurrentValveStateEnum8

该枚举定义 CurrentValveState Trait 的 Present Value 有效取值。

取值名称说明
0x00Closed关闭
0x01Open打开
0x02Transitioning过渡

DetectionModeSettingEnum16

该枚举定义 DetectionModeSetting Trait 的 Present Value 有效取值。

取值名称说明
0x00Unconfigured未配置
0x03DoorWindowState门窗状态检测
0x05ObjectOrientation物品姿态检测

DoorLockAlarmTraitPresentValueStructure

该结构体定义 DoorLockAlarm Trait 的 Present Value 字段布局。

结构体成员序号字段名类型是否必选说明
0AlarmCodeenum8必选门锁告警类型。

DoorStateEnum8

该枚举定义 DoorState Trait 的 Present Value 有效取值。

取值名称说明
0x00DoorOpen门未关
0x01DoorClosed门已关
0x02DoorJammed门卡住
0x03DoorForcedOpen门强制打开
0x04DoorUnspecifiedError门异常
0x05DoorAjar门虚掩

EffectInfoTraitPresentValueStructure

该结构体定义 EffectInfo Trait 的 Present Value 字段布局。

结构体成员序号字段名类型是否必选说明
0EffectIDuint8必选场景 ID。
1EffectDatacharacterString必选场景数据。
2EffectNamecharacterString必选场景名称。

EndpointStructureNodeStructure

该结构体定义 EndpointStructure 嵌套子节点字段布局。

结构体成员序号字段名类型是否必选说明
0EndpointIduint16必选Endpoint ID。
1ChildEndpointslist[EndpointStructureNodeStructure]可选子 Endpoint 节点列表,用于表达嵌套层级。

EndpointStructureTraitPresentValueStructure

该结构体定义 EndpointStructure Trait 的 Present Value 字段布局。

结构体成员序号字段名类型是否必选说明
0EndpointIduint16必选根 Endpoint ID。
1ChildEndpointslist[EndpointStructureNodeStructure]可选子 Endpoint 层级结构。

EvseFaultStateEnum32

该枚举定义 EvseFaultState Trait 的 Present Value 有效取值。

取值名称说明
0x00NoError无错误
0x01MeterFailure电表故障
0x02OverVoltage过电压
0x03UnderVoltage欠电压
0x04OverCurrent过电流
0x05ContactWetFailure接触湿故障
0x06ContactDryFailure接触干故障
0x07GroundFault地面故障
0x08PowerLoss电力丢失
0x09PowerQuality电力质量
0x0APilotShortCircuit引导短路
0x0BEmergencyStop紧急停止
0x0CEVDisconnected电动车断开
0x0DWrongPowerSupply电源错误
0x0ELiveNeutralSwap火线零线交换
0x0FOverTemperature过温度
0xFFOther其他

EvseStateEnum32

该枚举定义 EvseState Trait 的 Present Value 有效取值。

取值名称说明
0x00NotPluggedIn未插入
0x01PluggedInNoDemand插入但无需求
0x02PluggedInDemand插入有需求
0x03PluggedInCharging插入充电中
0x04PluggedInDischarging插入放电中
0x05SessionEnding会话结束
0x06Fault故障

EvseSupplyStateEnum32

该枚举定义 EvseSupplyState Trait 的 Present Value 有效取值。

取值名称说明
0x00Disabled禁用
0x01ChargingEnabled允许充电
0x02DischargingEnabled允许放电
0x03DisabledError禁用错误
0x04DisabledDiagnostics禁用诊断
0x05EnabledChargingandDischarging允许充电和放电

ExpressedStateEnum8

该枚举定义 ExpressedState Trait 的 Present Value 有效取值。

取值名称说明
0x00Normal正常
0x01SmokeAlarm烟雾泄漏
0x02COAlarmCO泄漏
0x03BatteryAlert电池警告
0x04Testing测试中
0x05HardwareFault硬件错误
0x06EndOfService服务终止
0x07InterconnectSmoke互联烟雾报警
0x08InterconnectCO互联CO报警

FanModeEnum8

该枚举定义 FanMode Trait 的 Present Value 有效取值。

取值名称说明
0x00Off关闭
0x01LowSpeed低速
0x02MediumSpeed中速
0x03HighSpeed高速
0x04Auto自动
0x05Smart智能

FeedEnum8

该枚举定义 Feed Trait 的 Present Value 有效取值。

取值名称说明
0x01RemoteFeeding喂养

FilterTypeEnum8

该枚举定义 FilterType Trait 的 Present Value 有效取值。

取值名称说明
0x00HEPAHEPA
0x01Activated Carbon活性炭
0x02Photocatalytic光触媒
0x03UV紫外线

FlameDetectedEnum8

该枚举定义 FlameDetected Trait 的 Present Value 有效取值。

取值名称说明
0x01FlameDetected识别到火焰

FreshAirModeEnum8

该枚举定义 FreshAirMode Trait 的 Present Value 有效取值。

取值名称说明
0x00Manual手动
0x01Auto自动
0x02Exhaust排风
0x03HeatExchange热交换
0x04InternalCirculation内循环
0x05ExternalCirculation外循环
0x06PowerSaving省电
0x07Strong强劲
0x08FreshAir新风
0x09Bypass旁通

GestureRecognitionReportEnum16

该枚举定义 GestureRecognitionReport Trait 的 Present Value 有效取值。

取值名称说明
0x02Two
0x04Four
0x05Five
0x06Eight
0x0AGood
0x65TwoBothHands二(双手)
0x66FourBothHands四(双手)
0x67FiveBothHands五(双手)
0x68EightBothHands八(双手)

GetEffectData Command Structure

GetEffectData Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0EffectIDuint8必选待读取场景数据的场景 ID,应存在于 BuiltIn 或 UserDefined 列表中。

GetWeekDaySchedule Command Structure

GetWeekDaySchedule Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0WeekDayIndexuint8必选工作日索引;默认值为 1
1UserIndexuint16必选用户索引;默认值为 1

GetYearDaySchedule Command Structure

GetYearDaySchedule Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0YearDayIndexuint8必选年日序号;默认值为 1
1UserIndexuint16必选用户索引;默认值为 1

GoToPositionPercentage Command Structure

GoToPositionPercentage Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0PositionPercentagefloat必选开合比。
1TransitionTimeuint32可选时间。

GoToPositionRotationPercentage Command Structure

GoToPositionRotationPercentage Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0RotationPercentagefloat必选倾斜旋转百分比。

HeaterCoolerButtonEventEnum8

该枚举定义 HeaterCoolerButtonEvent Trait 的 Present Value 有效取值。

取值名称说明
0x00PowerShortPress电源短按
0x01FanSpeedShortPress风速短按
0x02TempUpShortPress温度+短按
0x03TempDownShortPress温度-短按
0x04ModeShortPress模式短按
0x10PowerMidPress电源中按
0x11FanSpeedMidPress风速中按
0x12TempUpMidPress温度+中按
0x13TempDownMidPress温度-中按
0x14ModeMidPress模式中按
0x30PowerLongPress电源长按
0x31FanSpeedLongPress风速长按
0x32TempUpLongPress温度+长按
0x33TempDownLongPress温度-长按
0x34ModeLongPress模式长按

HeaterCoolerModeEnum8

该枚举定义 HeaterCoolerMode Trait 的 Present Value 有效取值。

取值名称说明
0x00Cool制冷
0x01Heat制热
0x02Auto自动
0x03Fan送风
0x04Dry除湿
0x05Sleep睡眠
0x06FreshAir新风
0x07FloorHeat地暖
0x08HeatandFloorHeat强热
0x09FloorHeatandFreshAir地暖+新风
0x0AEmergencyHeat速热
0x0BPrecooling预冷
0x0COff关闭
0x0DManual手动
0x0EAntiFreeze防冻

HeaterCoolerPolarityEnum8

该枚举定义 HeaterCoolerPolarity Trait 的 Present Value 有效取值。

取值名称说明
0x00Forward正向(制热)
0x01Reverse反向(制冷)
0x02Bidirectional双向

HomeKitPayloadTraitPresentValueStructure

该结构体定义 HomeKitPayload Trait 的 Present Value 字段布局。

结构体成员序号字段名类型是否必选说明
0QRCodecharacterString必选配对二维码原始字符串数据。
1DigitalPairingCodecharacterString必选8 位数字配对码。

HomeStationCredentialsTraitPresentValueStructure

该结构体定义 HomeStationCredentials Trait 的 Present Value 字段布局。

结构体成员序号字段名类型是否必选说明
0SSIDcharacterString必选家庭基站 SSID。
1CredentialscharacterString必选家庭基站连接凭证。

HubConnectionStatusEnum8

该枚举定义 HubConnectionStatus Trait 的 Present Value 有效取值。

取值名称说明
0x00Disconnected断开
0x01Connected连接

HumanRecognitionReportEnum8

该枚举定义 HumanRecognitionReport Trait 的 Present Value 有效取值。

取值名称说明
0x01HumanDetected检测到人形事件

Identify Command Structure

Identify Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0IdentifyTimefloat必选设备继续自识别的剩余时间,单位为秒。值为 0 时,设备 MAY 使用默认识别时长。

IdentifyTypeEnum8

该枚举定义 IdentifyType Trait 的 Present Value 有效取值。

取值名称说明
0x00NoneNone
0x01LightLight
0x02LEDIndicatorLEDIndicator
0x03AudibleBeepAudibleBeep
0x04DisplayDisplay
0x05ActuatorActuator

InstallationOrientationConfigurationEnum16

该枚举定义 InstallationOrientationConfiguration Trait 的 Present Value 有效取值。

取值名称说明
0x00Horizontal横向
0x01Vertical竖向

InterfaceTypeEnum8

该枚举定义 NetworkInterfacesTraitPresentValueStructure 中 Type 字段有效取值。

取值名称说明
0x00Unspecified未指定
0x01WiFiWi-Fi 接口
0x02Ethernet以太网接口
0x03Cellular蜂窝网络接口
0x04ThreadThread 接口

IRKeyEnum32

该枚举定义 IRKey Trait 的 Present Value 有效取值。

取值名称说明
0x00ReservedReserved
0x01PowerPower
0x02ModeMode
0x03Temp+Temp+
0x04Temp-Temp-
0x05WindSpeedWindSpeed
0x25A5P_KEYP_KEY

IRTypeEnum8

该枚举定义 IRType Trait 的 Present Value 有效取值。

取值名称说明
0x00AirConditionerAirConditioner
0x01TVTV
0x02FanFan
0x03TVBoxTVBox
0x04ProjectorProjector
0x05SettopBoxSettopBox
0x06DVDDVD
0x07HeaterHeater
0x08AirPurifierAirPurifier
0x09SpeakerSpeaker
0x0ALightingLighting
0x0BCameraCamera
0x0CCustomizeCustomize

LEDICProtocolEnum8

该枚举定义 LEDICProtocol Trait 的 Present Value 有效取值。

取值名称说明
0x01SID单线归零码

LEDTypeEnum8

该枚举定义 LEDType Trait 的 Present Value 有效取值。

取值名称说明
0x01RGBWRGBW

LightingDynamicSceneModeEnum8

该枚举定义 LightingDynamicSceneMode Trait 的 Present Value 有效取值。

取值名称说明
0x00Breath呼吸
0x01ForwardRainbow正向彩虹
0x02WaterFlow流水
0x03Flicker闪烁
0x04Jump跳变
0x05ReverseRainbow反向彩虹
0x06Floating飘动
0x07Running跑动

LightingModeSettingEnum8

该枚举定义 LightingModeSetting Trait 的 Present Value 有效取值。

取值名称说明
0x00Level单色模式
0x01ColorTemp色温模式
0x02RGBRGB模式
0x03RGBW模式RGBW模式

LightingMusicSyncModeEnum8

该枚举定义 LightingMusicSyncMode Trait 的 Present Value 有效取值。

取值名称说明
0x00Random随机
0x01Breath呼吸
0x02Rainbow彩虹
0x03WaterFlow流水

LimitPointSettingEnum8

该枚举定义 LimitPointSetting Trait 的 Present Value 有效取值。

取值名称说明
0x00ClearLimitPoints清除限位点
0x01SetOpenLimit设置开限位点
0x02SetCloseLimit设置关限位点

LoadSafetyManagementEnum8

该枚举定义 LoadSafetyManagement Trait 的 Present Value 有效取值。

取值名称说明
0x00LoadNormal负载正常
0x01OverLoadAnomaly过载异常
0x02OverLoadProtection过载保护

LoadTypeEnum8

该枚举定义 LoadType Trait 的 Present Value 有效取值。

取值名称说明
0x00GeneralGeneral
0x01LinkableLinkable
0x02PulsedPulsed

LockDoor Command Structure

LockDoor Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0CodecharacterString可选参数。

LockOperationErrorTraitPresentValueStructure

该结构体定义 LockOperationError Trait 的 Present Value 字段布局。

结构体成员序号字段名类型是否必选说明
0LockOperationTypeenum8必选执行的门锁操作类型。
1OperationSourceenum8必选门锁操作来源。
2OperationErrorenum8必选操作失败原因。
3UserIndexuint16必选执行门锁操作的用户索引。
4FabricIDuint64必选执行门锁操作的 fabric ID。
5SourceNodeuint64必选执行门锁操作的 node ID。
6Credentialslist[Struct]可选执行门锁操作时使用的凭证列表;无凭证时可为空。

LockOperationTraitPresentValueStructure

该结构体定义 LockOperation Trait 的 Present Value 字段布局。

结构体成员序号字段名类型是否必选说明
0LockOperationTypeenum8必选执行的门锁操作类型。
1OperationSourceenum8必选门锁操作来源。
2UserSourceenum8可选UserId 与 CredentialId 的来源。省略时默认 Lock Local。
3UserIduint32可选用户唯一标识。
4CredentialIduint32可选凭证唯一标识。
5MatterVendorIduint16可选当 OperationSource 为 Remote(Matter Ecosystem) 时表示 Matter Vendor ID。
6LockPositionenum8可选门锁操作位置。

LockStateEnum8

该枚举定义 LockState Trait 的 Present Value 有效取值。

取值名称说明
0x00NotFullyLocked锁舌异常
0x01Locked已上锁
0x02Unlocked未上锁

LockUserChangeTraitPresentValueStructure

该结构体定义 LockUserChange Trait 的 Present Value 字段布局。

结构体成员序号字段名类型是否必选说明
0LockDataTypeenum8必选被变更的数据类型。
1DataOperationTypeenum8必选数据操作类型。
2OperationSourceenum8必选执行操作的来源。
3UserIndexuint16必选执行门锁操作的用户索引。
4FabricIDuint64必选执行门锁操作的 fabric ID。
5SourceNodeuint64必选执行门锁操作的 node ID。
6DataIndexuint16可选被变更项目在 LockDataType 对应列表中的索引。

MagicPairPayloadTraitPresentValueStructure

该结构体定义 MagicPairPayload Trait 的 Present Value 字段布局。

结构体成员序号字段名类型是否必选说明
0QRCodecharacterString必选配对二维码原始字符串数据。
1DigitalPairingCodecharacterString必选8 位数字配对码。

ManualPullEventEnum32

该枚举定义 ManualPullEvent Trait 的 Present Value 有效取值。

取值名称说明
0x01ManualOpen手拉打开
0x02ManualClose手拉关闭
0x03ManualStop手拉停止

MatterBindStateEnum8

该枚举定义 MatterBindState Trait 的 Present Value 有效取值。

取值名称说明
0x00UnboundUnbound
0x01BoundBound

MatterDACStateEnum8

该枚举定义 MatterDACState Trait 的 Present Value 有效取值。

取值名称说明
0x00LoadingDACLoadingDAC
0x01FailedDACFailedDAC
0x02ReadyDACReadyDAC

MatterPairingStateEnum8

该枚举定义 MatterPairingState Trait 的 Present Value 有效取值。

取值名称说明
0x00NonMatterPairingState非 Matter 配网状态
0x01MatterPairingStateMatter 配网状态
0x02LimitExceeded超出限制
0x03InvalidDAC无效设备认证证书
0x04UnderPreparation准备中

MatterPayloadTraitPresentValueStructure

该结构体定义 MatterPayload Trait 的 Present Value 字段布局。

结构体成员序号字段名类型是否必选说明
0QRCodecharacterString必选配对二维码原始字符串数据。
1DigitalPairingCodecharacterString必选11 或 21 位数字配对码。

MediaPlaybackCommand Command Structure

MediaPlaybackCommand Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0MediaTypeenum8必选媒体类型;默认值为 0
1CommandcharacterString可选命令内容。
2TitlecharacterString可选媒体名称。

MotionDetectedEnum8

该枚举定义 MotionDetected Trait 的 Present Value 有效取值。

取值名称说明
0x00Enter进入
0x01Left离开
0x02LeftIn左进
0x03RightOut右出
0x04RightIn右进
0x05LeftOut左出
0x06Access接近
0x07Away远离

MotorOperationStatusEnum8

该枚举定义 MotorOperationStatus Trait 的 Present Value 有效取值。

取值名称说明
0x00Closing关闭中
0x01Opening打开中
0x02Stopped停止
0x03ObstacleStop障碍物停止
0x04ObstacleLimitAutoRebound遇阻反弹

MotorSpeedSettingEnum8

该枚举定义 MotorSpeedSetting Trait 的 Present Value 有效取值。

取值名称说明
0x00LowSpeed低速
0x01MediumSpeed中速
0x02HighSpeed高速

MoveToColorTemperature Command Structure

MoveToColorTemperature Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0ColorTemperatureuint32必选色温。
1Timeint32可选时间。
2ExecuteIfOffboolean可选关灯时是否执行命令。

MoveToColorTemperatureBrightness Command Structure

MoveToColorTemperatureBrightness Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0ColorTemperatureuint32必选色温。
1Levelfloat必选亮度;默认值为 50
2Timeint32可选时间。
3ExecuteIfOffboolean可选关灯时是否执行命令。

MoveToHueAndSaturation Command Structure

MoveToHueAndSaturation Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0Huefloat必选Hue。
1Saturationfloat必选饱和度。
2Timeint32可选时间。
3ExecuteIfOffboolean可选关灯时是否执行命令。

MoveToHueSaturationBrightness Command Structure

MoveToHueSaturationBrightness Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0Huefloat必选Hue。
1Saturationfloat必选饱和度。
2Levelfloat必选亮度;默认值为 50
3Timeint32可选时间。
4ExecuteIfOffboolean可选关灯时是否执行命令。

MoveToXYColor Command Structure

MoveToXYColor Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0ColorXuint16必选颜色X值。
1ColorYuint16必选颜色Y值。
2Timeint32可选时间。
3ExecuteIfOffboolean可选关灯时是否执行命令。

MoveToXYColorBrightness Command Structure

MoveToXYColorBrightness Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0ColorXuint16必选颜色X值。
1ColorYuint16必选颜色Y值。
2Levelfloat必选亮度;默认值为 50
3Timeint32可选时间。
4ExecuteIfOffboolean可选关灯时是否执行命令。

NetworkInterfacesTraitPresentValueStructure

该结构体定义 NetworkInterfaces Trait 的 Present Value 字段布局。

结构体成员序号字段名类型是否必选说明
0NamecharacterString可选网络接口的人类可读或系统级标识(如 eth0wlan0),用于在设备操作系统内唯一标识该接口并用于配置或诊断引用。
1IsOperationalboolean必选指示该网络接口当前是否可正常收发数据。通常需同时满足链路可用、已分配 IP 地址、路由可达等条件。
2OffPremiseServicesReachableIPv4boolean可选指示设备是否可通过该接口使用 IPv4 访问外部(网外)服务(如云端地址);true 表示具备 IPv4 外网连通性。
3OffPremiseServicesReachableIPv6boolean可选指示设备是否可通过该接口使用 IPv6 访问外部(网外)服务;true 表示具备 IPv6 外网连通性。
4HardwareAddresscharacterString必选MAC 地址字符串,最大长度 24。应为 48 位 IEEE MAC 或 64 位 IEEE MAC(EUI-64),采用大端/显示顺序(左侧为高位字节),示例:00:1A:2B:3C:4D:5E00:1A:2B:FF:FE:3C:4D:5E
5IPv4Addresseslist[characterString]可选IPv4 地址列表,元素类型为字符串(最大长度 16),示例:192.168.2.235
6IPv6Addresseslist[characterString]可选IPv6 地址列表,元素类型为字符串(最大长度 40),示例:2001:DB8:0:0:8:800:200C:417A
7TypeInterfaceTypeEnum8必选接口类型。
8RSSIint8可选接收信号强度指示值(dBm),通常为负值(如 -30)。
9AddressingModeAddressingModeEnum8可选指示该接口当前 IP 地址配置模式。
10SSIDcharacterString可选当前连接 Wi-Fi 的网络名称(Service Set Identifier)。示例:Home_2.4G
11BSSIDcharacterString可选当前连接接入点(AP)的 BSSID(MAC 地址)。示例:34:AB:37:12:CD:EF
12RouterMACcharacterString可选当前上联网关/路由器的 MAC 地址。示例:9C:3D:CF:AA:BB:CC
13Channeluint8可选当前 Wi-Fi 工作信道(Chanel/Channel)。示例:1611149
14SubnetMaskcharacterString可选子网掩码/前缀信息,字符串(最大长度 32)。IPv4 场景填子网掩码(示例:255.255.255.0);IPv6 场景建议填前缀长度表示(示例:64),未知或不适用可留空。
15DefaultGatewaycharacterString可选默认网关地址,字符串(最大长度 32)。可填 IPv4 或 IPv6 网关地址,示例:192.168.1.1fe80::1
16PrimaryDNScharacterString可选首选 DNS,字符串(最大长度 32)。可填 IPv4 或 IPv6 DNS 地址,示例:8.8.8.82001:4860:4860::8888
17SecondaryDNScharacterString可选备选 DNS,字符串(最大长度 32)。可填 IPv4 或 IPv6 DNS 地址,示例:8.8.4.42001:4860:4860::8844

NightLightModeEnum8

该枚举定义 NightLightMode Trait 的 Present Value 有效取值。

取值名称说明
0x00Off常关
0x01On常开
0x02Auto自动感应

ObjectOrientationStateEnum8

该枚举定义 ObjectOrientationState Trait 的 Present Value 有效取值。

取值名称说明
0x01HorizontalUp水平朝上
0x02HorizontalDown水平朝下
0x03Vertical垂直
0x04Tilted倾斜

ObstacleLimitSensitivityEnum8

该枚举定义 ObstacleLimitSensitivity Trait 的 Present Value 有效取值。

取值名称说明
0x00Low
0x01MediumLow较低
0x02Medium中等
0x03MediumHigh较高
0x04High

OccupancySensorTypeEnum8

该枚举定义 OccupancySensorType Trait 的 Present Value 有效取值。

取值名称说明
0x00PIR被动红外
0x01Ultrasonic超声波
0x02PIRAndUltrasonic红外和超声波
0x03PhysicalContact物理接触
0x04Radar雷达
0x05Vision视觉

OperatingModeEnum8

该枚举定义 OperatingMode Trait 的 Present Value 有效取值。

取值名称说明
0x00NormalNormal
0x01VacationVacation
0x02PrivacyPrivacy
0x03NoRemoteLockUnlockNoRemoteLockUnlock
0x04PassagePassage

OperationalErrorEnum16

该枚举定义 OperationalError Trait 的 Present Value 有效取值。

取值名称说明
0x00NoError无错误
0x01UnableToStartOrResume无法开始或恢复
0x02UnableToCompleteOperation无法完成操作
0x03CommandInvalidInState状态下命令无效

OperationalStateEnum16

该枚举定义 OperationalState Trait 的 Present Value 有效取值。

取值名称说明
0x00Stopped停止
0x01Running运行中
0x02Paused暂停
0x03Error错误

OutputNodeModeEnum32

该枚举定义 OutputNodeMode Trait 的 Present Value 有效取值。

取值名称说明
0x00WetMode湿节点模式
0x01DryPulseNormallyClosed干节点脉冲常闭模式
0x02DryPulseNormallyOpen干节点脉冲常开模式
0x03DryToggleMode干节点通断模式

OutputSwitchingTypeEnum8

该枚举定义 OutputSwitchingType Trait 的 Present Value 有效取值。

取值名称说明
0x01NonResettableSwitch不可回弹开关
0x02MomentaryPushSwitch可回弹开关
0x03ActiveLowCloseRelay低电平闭合继电器
0x04InsertCardOnMode插卡通电模式
0x05InsertCardOffMode插卡断电模式

OverCurrentResponseSettingEnum8

该枚举定义 OverCurrentResponseSetting Trait 的 Present Value 有效取值。

取值名称说明
0x00ShutdownSingle关断单个
0x01ShutdownAll关断全部

PackageRecognitionReportEnum8

该枚举定义 PackageRecognitionReport Trait 的 Present Value 有效取值。

取值名称说明
0x01PackageAppeared包裹出现
0x02PackageDisappeared包裹消失

PanTiltDirectionControl Command Structure

PanTiltDirectionControl Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0Directionuint8必选方向。

PetRecognitionReportEnum16

该枚举定义 PetRecognitionReport Trait 的 Present Value 有效取值。

取值名称说明
0x01CatDetected检测到猫
0x02DogDetected检测到狗
0x03CatOrDogDetected检测到猫狗

PlaybackModeEnum8

该枚举定义 PlaybackMode Trait 的 Present Value 有效取值。

取值名称说明
0x00ShuffleShuffle
0x01OrderOrder
0x02SingleCycleSingleCycle
0x03AllCycleAllCycle

PM2.5LevelEnum8

该枚举定义 PM2.5Level Trait 的 Present Value 有效取值。

取值名称说明
0x00UnknownUnknown
0x01Excellent
0x02Good良好
0x03Fair一般
0x04Inferior
0x05Poor极差

PowerModeEnum8

该枚举定义 PowerMode Trait 的 Present Value 有效取值。

取值名称说明
0x00Unknown未知
0x01Mains市电
0x02Battery电池
0x03DCSource直流电源
0x04ACSource交流电源

PreOperationModeEnum8

该枚举定义 PreOperationMode Trait 的 Present Value 有效取值。

取值名称说明
0x00UnjoinedMode未入网模式
0x01NewlyJoinedMode新入网模式
0x02PollingMode仓储轮询模式
0x03UserMode用户模式
0x04DegradedMode亚健康模式
0x05RejoinMode仓储重连模式

PresenceConfigurationTraitPresentValueStructure

该结构体定义 PresenceConfiguration Trait 的 Present Value 字段布局。

结构体成员序号字段名类型是否必选说明
0HubListlist[characterString]必选网关的 Device ID 列表。
1EventsStruct可选事件配置,包含 DeviceID 和 ResList。
2StatesStruct可选状态配置,包含 DeviceID 和 ResList。
3EntriescharacterString可选入口配置。
4Configuint32可选配置项,例如 DetDuration、UnKnownDuration。

PresenceEnum8

该枚举定义 Presence Trait 的 Present Value 有效取值。

取值名称说明
0x00Unknown未知
0x01NoHumanDetected未检测到人
0x02HumanDetected检测到人

PresetTraitPresentValueStructure

该结构体定义 Preset Trait 的 Present Value 字段布局。

结构体成员序号字段名类型是否必选说明
0PresetHandlecharacterString必选预设句柄。
1PresetScenarioenum8必选预设场景:1=Occupied,2=Unoccupied,3=Sleep,4=Wake,5=Vacation,6=GoingToSleep;7–254=Reserved。
2NamecharacterString可选预设名称;若为 null 则省略该字段。
3CoolingSetpointfloat可选制冷设定温度,默认 26。
4HeatingSetpointfloat可选制热设定温度,默认 20。
5BuiltInboolean必选是否为内置预设,默认 false。

PreviewEffect Command Structure

PreviewEffect Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0EffectDatacharacterString必选待预览场景的原始数据。编码格式应与新增/更新用户自定义场景一致。

PreviewTransition Command Structure

PreviewTransition Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0OnTransitionTimeuint16必选开灯过渡时间,单位为 100 毫秒。示例:10 表示 1 秒。
1OffTransitionTimeuint16必选关灯过渡时间,单位为 100 毫秒。示例:10 表示 1 秒。
2DimmingCurvaturefloat必选预览使用的调光曲线幂值。值越大,低亮区停留越久。
3InitialBrightnessuint8必选预览使用的初始亮度百分比,取值范围与 InitialBrightness Trait 约束一致。

Reboot Command Structure

Reboot Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0RebootTypeenum8必选重启方式。
1Delayuint32可选延迟时长;默认值为 0

RebootReasonEnum8

该枚举定义 RebootReason Trait 的 Present Value 有效取值。

取值名称说明
0x00Unspecified未知
0x01PowerOnReboot上电重启
0x02BrownOutReset低压复位
0x03SoftwareWatchdogReset软件看门狗复位
0x04HardwareWatchdogReset硬件看门狗复位
0x05SoftwareUpdateCompleted软件更新完成
0x06SoftwareReset软件重启

RemoveUserDefinedEffect Command Structure

RemoveUserDefinedEffect Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0EffectIDuint8必选待删除场景 ID。应为已存在且可删除的 UserDefined 场景。

ResetModeEnum8

该枚举定义 ResetMode Trait 的 Present Value 有效取值。

取值名称说明
0x01FactoryReset恢复出厂
0x02NetworkReset只重置网络
0x03ConfigurationsReset只重置配置
0x04PSWReset只重置设备密码

RingtonePlayIndexEnum32

该枚举定义 RingtonePlayIndex Trait 的 Present Value 有效取值。

取值名称说明
0x00PoliceCar1警车音1
0x01PoliceCar2警车音2
0x02SafetyAccident安全事故音
0x03MissileCountdown导弹倒计时
0x04GhostSound鬼叫声
0x05SniperRifle狙击枪
0x06IntenseBattle激战声
0x07AirRaidSiren空袭警报
0x08DogBark狗叫声
0x0ADoorbell门铃音
0x0BKnock敲门音
0x0CFunny搞笑音
0x0DAlarmClock闹钟音
0x0EArming布防声
0x0FDisarming撤防声
0x14MiMixMiMix
0x15EnthusiasticEnthusiastic
0x16GuitarClassicGuitarClassic
0x17IceWorldPianoIceWorldPiano
0x18LeisureTimeLeisureTime
0x19ChildhoodChildhood
0x1AMorningStreamIetMorningStreamIet
0x1BMusixBoxMusixBox
0x1COrangeOrange
0x2710DefaultRingtone默认铃声

RingtonePlayStatusEnum8

该枚举定义 RingtonePlayStatus Trait 的 Present Value 有效取值。

取值名称说明
0x00Stopped停止
0x01Playing播放

RockSettingEnum8

该枚举定义 RockSetting Trait 的 Present Value 有效取值。

取值名称说明
0x00Off关闭
0x01RockLeftRight左右
0x02RockUpDown上下
0x03RockRound循环
0x04Swing扫风
0x05FixedDirection固定
0x15Fixed固定风向

RotationControl Command Structure

RotationControl Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0Directionenum8必选方向。

RotationDirectionEnum8

该枚举定义 RotationDirection Trait 的 Present Value 有效取值。

取值名称说明
0x00ClockwiseClockwise
0x01CounterClockwiseCounterClockwise

RotationEventEnum8

该枚举定义 RotationEvent Trait 的 Present Value 有效取值。

取值名称说明
0x00Rotate旋转
0x01HoldToRotate按住旋转
0x02InvertedRotate反面旋转

SelectedMediaOutputSourceEnum8

该枚举定义 SelectedMediaOutputSource Trait 的 Present Value 有效取值。

取值名称说明
0x00Internal内置
0x01Bluetooth蓝牙
0x02Aux辅助
0x03SPDIFSPDIF
0x04Coaxial同轴
0x05Audio1音频1
0x06Audio2音频2
0x07Audio3音频3
0x08AV1AV1
0x09AV2AV2
0x0AAV3AV3
0x0BHDMI1HDMI1
0x0CHDMI2HDMI2
0x0DHDMI3HDMI3
0x0EOther其他

SelectedSourceEnum8

该枚举定义 SelectedSource Trait 的 Present Value 有效取值。

取值名称说明
0x00InternalInternal
0x01BluetoothBluetooth
0x02ExternalExternal

SelectInput Command Structure

SelectInput Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0MediaInputuint8必选输入源;默认值为 0

SendIRCode Command Structure

SendIRCode Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0Modeenum8必选模式。
1BrandIduint32必选品牌DI。
2RemoteIduint32必选遥控器ID。
3IRCodecharacterString可选红外压缩码。
4IRCodeLengthuint16可选红外原始数据长度。
5ACKeycharacterString可选空调状态数据。
6Frequencyuint32必选红外发射频率。

SetActivePreset Command Structure

SetActivePreset Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0PresetHandlecharacterString必选预设操作。

SetBrightness Command Structure

SetBrightness Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0Levelfloat必选目标亮度百分比。
1Timeint32可选过渡时长;为空时由设备按默认策略执行。
2ExecuteIfOffboolean可选关灯状态下是否仍执行本命令(不改变开关联动语义)。

SetBrightnessWithOnOff Command Structure

SetBrightnessWithOnOff Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0Levelfloat必选目标亮度百分比。
1Timeint32可选过渡时长;为空时由设备按默认策略执行。

SetWeekDaySchedule Command Structure

SetWeekDaySchedule Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0WeekDayIndexuint8必选工作日索引;默认值为 1
1UserIndexuint16必选用户索引;默认值为 1
2DaysMaskenum8必选日期掩码。
3StartHouruint8必选开始小时;默认值为 0
4StartMinuteuint8必选开始分钟;默认值为 0
5EndHouruint8必选结束小时;默认值为 0
6EndMinuteuint8必选结束分钟;默认值为 0

SetYearDaySchedule Command Structure

SetYearDaySchedule Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0YearDayIndexuint8必选年日序号;默认值为 1
1UserIndexuint16必选用户索引;默认值为 1
2LocalStartTimeuint64必选本地开始时间。
3LocalEndTimeuint64必选本地结束时间。

SleepStageEnum8

该枚举定义 SleepStage Trait 的 Present Value 有效取值。

取值名称说明
0x00LightSleepLightSleep
0x01DeepSleepDeepSleep
0x02REMREM

SleepStateEnum8

该枚举定义 SleepState Trait 的 Present Value 有效取值。

取值名称说明
0x00Unknown未知
0x01Awake清醒
0x02Sleep入睡

SmokeChamberContaminationEnum8

该枚举定义 SmokeChamberContamination Trait 的 Present Value 有效取值。

取值名称说明
0x00Normal监测正常
0x01Contaminated烟室污染

SmokeStateEnum8

该枚举定义 SmokeState Trait 的 Present Value 有效取值。

取值名称说明
0x00Normal正常
0x01Warning警告
0x02Critical严重

StartEffect Command Structure

StartEffect Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0EffectIDenum8必选待启动场景 ID,应为设备当前支持的 BuiltIn 或 UserDefined 场景。

StartUpOnOffEnum8

该枚举定义 StartUpOnOff Trait 的 Present Value 有效取值。

取值名称说明
0x00Off上电关闭
0x01On上电开启
0x02Toggle上电反转
0x03Hold上电记忆

StartUpXYColorTraitPresentValueStructure

StateOfLowBatEnum8

该枚举定义 StateOfLowBat Trait 的 Present Value 有效取值。

取值名称说明
0x00False电量充足
0x01True低电量
0x02Critical电量耗尽

StationaryStateEnum8

该枚举定义 StationaryState Trait 的 Present Value 有效取值。

取值名称说明
0x00InMotion运动中
0x01Stationary静止

StepBrightness Command Structure

StepBrightness Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0Sizefloat必选亮度步进增量,正值上调、负值下调。
1Timeint32可选过渡时长;为空时由设备按默认策略执行。
2ExecuteIfOffboolean可选关灯状态下是否仍执行本命令(不改变开关联动语义)。

StepBrightnessWithOnOff Command Structure

StepBrightnessWithOnOff Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0Sizefloat必选亮度步进增量,正值上调、负值下调。
1Timeint32可选过渡时长;为空时由设备按默认策略执行。

StepColorTemperature Command Structure

StepColorTemperature Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0Sizeint32必选增量值。
1Timeint32可选时间。
2ExecuteIfOffboolean可选关灯时是否执行命令。

StepPosition Command Structure

StepPosition Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0Sizefloat必选增量值。
1Timeint32可选时间。

SweeperStateEnum8

该枚举定义 SweeperState Trait 的 Present Value 有效取值。

取值名称说明
0x00Cleaning清扫中
0x01Paused暂停
0x02NotCleaning未清扫

TargetGarageDoorStateEnum8

该枚举定义 TargetGarageDoorState Trait 的 Present Value 有效取值。

取值名称说明
0x00Closed关闭
0x01Open打开

TargetPlaybackStateEnum8

该枚举定义 TargetPlaybackState Trait 的 Present Value 有效取值。

取值名称说明
0x00Play播放
0x01Pause暂停
0x02Stop停止
0x03StartOver重播
0x04FastForward快进
0x05Rewind快退
0x06Previous上一首
0x07Next下一首
0x08PlaySpecificList播放指定歌单

TemperatureSafetyManagementEnum8

该枚举定义 TemperatureSafetyManagement Trait 的 Present Value 有效取值。

取值名称说明
0x00TempNormal温度正常
0x01OverTempAnomaly过温异常
0x02OverTempProtection过温保护
0x0BUnderTempAnomaly低温异常

TemperatureUIDisplayModeEnum8

该枚举定义 TemperatureUIDisplayMode Trait 的 Present Value 有效取值。

取值名称说明
0x00Celsius摄氏度
0x01Fahrenheit华氏度

ThreadDiagnosticsTraitPresentValueStructure

该结构体定义 ThreadDiagnostics Trait 的 Present Value 字段布局。

结构体成员序号字段名类型是否必选说明
0Channeluint8必选The Thread network radio channel。
1ExtendedPANIDuint64必选The Thread network extended PAN identifier。
2NetworkKeyoctetString必选The Thread network key。
3NetworkNamecharacterString必选The Thread network name。
4PANIDuint16必选The Thread network PAN identifier。
5PSKcoctetString必选The Thread network pre-shared key for the Commissioner。
6ActiveTimeStampuint64必选Active timestamp。
7SecurityPolicycharacterString必选Security policy。
8OperationalDatasetoctetString必选Thread Network Parameters dataset。
9RSSIint8可选RSSI for the Thread network client in dBm。
10LQIuint8可选Link quality indicator。
11BorderAgentIDoctetString可选Identifier of an active Thread network Border Agent。
12MeshLocalPrefixcharacterString可选Prefix of all interfaces reachable within the same Thread network。
13CommissionerCredentialcharacterString可选UTF-8 Commissioner Credential, 6 to 255 characters。
14VersioncharacterString可选OpenThread Version。
15Roleuint8可选Thread Role bit mask。

TopFaceChangedEnum8

该枚举定义 TopFaceChanged Trait 的 Present Value 有效取值。

取值名称说明
0x00Face 1 Up第1面朝上
0x01Face 2 Up第2面朝上
0x02Face 3 Up第3面朝上
0x03Face 4 Up第4面朝上
0x04Face 5 Up第5面朝上
0x05Face 6 Up第6面朝上

TopFaceEnum8

该枚举定义 TopFace Trait 的 Present Value 有效取值。

取值名称说明
0x00Face 1 Up第1面朝上
0x01Face 2 Up第2面朝上
0x02Face 3 Up第3面朝上
0x03Face 4 Up第4面朝上
0x04Face 5 Up第5面朝上
0x05Face 6 Up第6面朝上

TriggerWarning Command Structure

TriggerWarning Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0Warningenum8必选警告。

TriggerZigbeeNetworkInfoUpload Command Structure

TriggerZigbeeNetworkInfoUpload Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0InstallCodecharacterString必选安装代码。
1MACcharacterString必选MAC地址。

UnboltDoor Command Structure

UnboltDoor Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0CodecharacterString可选编码。

UnlockDoor Command Structure

UnlockDoor Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0CodecharacterString可选解锁密钥。

UpdateUserDefinedEffect Command Structure

UpdateUserDefinedEffect Command 的参数结构体。

结构体成员序号字段名类型是否必选说明
0EffectIDuint8必选待更新场景 ID。应为已存在 UserDefined 场景。
1EffectDatacharacterString必选更新后的场景数据,编码格式应与 EffectData 规范一致。

UserDefinedEffectsTraitPresentValueStructure

该结构体定义 UserDefinedEffects Trait 的 Present Value 字段布局。

结构体成员序号字段名类型是否必选说明
0EffectIDuint8必选用户自定义场景 ID。
1EffectNamecharacterString必选场景名称。

VacuumOperationalErrorEnum16

该枚举定义 VacuumOperationalError Trait 的 Present Value 有效取值。

取值名称说明
0x00NoError无错误
0x01UnableToStartOrResume无法开始或恢复
0x02UnableToCompleteOperation无法完成操作
0x03CommandInvalidInState状态下命令无效
0x40FailedToFindChargingDock未能找到充电座
0x41Stuck被卡住
0x42DustBinMissing尘盒缺失
0x43DustBinFull尘盒已满
0x44WaterTankEmpty水箱为空
0x45WaterTankMissing水箱缺失
0x46WaterTankLidOpen水箱盖未关闭
0x47MopCleaningPadMissing拖布清洁垫缺失

VacuumOperationalStateEnum16

该枚举定义 VacuumOperationalState Trait 的 Present Value 有效取值。

取值名称说明
0x00Stopped停止
0x01Running运行中
0x02Paused暂停
0x03Error错误
0x40SeekingCharger寻找充电器
0x41Charging充电中
0x42Docked停靠

VehicleDetectedEnum8

该枚举定义 VehicleDetected Trait 的 Present Value 有效取值。

取值名称说明
0x01VehicleDetected识别到车辆

VibrationEventEnum8

该枚举定义 VibrationEvent Trait 的 Present Value 有效取值。

取值名称说明
0x00ThreeKnocks三击
0x01Move移动
0x02Vibrate震动
0x03Tilt倾斜
0x04FreeFall跌落

VOCQualityEnum8

该枚举定义 VOCQuality Trait 的 Present Value 有效取值。

取值名称说明
0x00Unknown未知
0x01Excellent
0x02Good良好
0x03Fair一般
0x04Inferior
0x05Poor极差

VoiceLanguageEnum8

该枚举定义 VoiceLanguage Trait 的 Present Value 有效取值。

取值名称说明
0x01Chinese中文
0x02English英文
0x03Cantonese粤语
0x04Spanish西班牙语
0x05Russian俄语
0x06Korean韩语
0x07PortugueseBR巴西语
0x08German德语
0x09French法语
0x0AItalian意大利语
0x0BJapanese日语
0x0CPolish波兰语
0x0DCzech捷克语
0x0ESlovak斯洛伐克语
0x0FTurkish土耳其语
0x10Hungarian匈牙利语
0x11Dutch荷兰语
0x12Greek希腊语
0x13Arabic阿拉伯语

VoltageSafetyManagementEnum8

该枚举定义 VoltageSafetyManagement Trait 的 Present Value 有效取值。

取值名称说明
0x00VoltageNormal电压正常
0x01OverVoltageAnomaly过压异常
0x02OverVoltageProtection过压保护
0x03UnderVoltageProtection欠压保护

WhitePointXYPresentValueStructure

该结构体定义 WhitePointXY 的 Present Value 字段布局。

结构体成员序号字段名类型是否必选说明
0WhitePointXuint16必选该参数表示设备当前白点在 CIE xyY 色彩空间中定义的归一化色度值 x。x 与 WhitePointX 属性满足关系:x = WhitePointX / 65536(WhitePointX 取值范围为 0 至 65279,含边界)。
1WhitePointYuint16必选该参数表示设备当前白点在 CIE xyY 色彩空间中定义的归一化色度值 y。y 与 WhitePointY 属性满足关系:y = WhitePointY / 65536(WhitePointY 取值范围为 0 至 65279,含边界)。

WidgetPositionStructure

该结构体定义 Widget 的 WidgetPosition 字段布局。

结构体成员序号字段名类型是否必选说明
0xuint16必选控件 X 坐标。
1yuint16必选控件 Y 坐标。
2widthuint16必选控件宽度。
3heightuint16必选控件高度。

WiFiDiagnosticsTraitPresentValueStructure

该结构体定义 WiFiDiagnostics Trait 的 Present Value 字段布局。

结构体成员序号字段名类型是否必选说明
0BSSIDcharacterString必选The Wi-Fi BSSID。
1Encryptionuint8可选0: No Encryption;1: WEP;2: WPA;3: WPA/WPA2;4: WPA2;5: WPA3。
2Versionuint8可选The Wi-Fi Version:0:a,1:b,2:g,3:n,4:ac,5:ax
3Channeluint8必选The Wi-Fi network Channel。
4RSSIint8必选RSSI for the WiFi network client in dBm。
5NetworkNamecharacterString必选The Wi-Fi network name。
6IPV4AddresscharacterString可选IPV4 Address。
7IPV6AddresscharacterString可选IPV6 Address。
8SubnetMaskcharacterString可选Subnet mask。
9GatewaycharacterString可选Gateway address。
10DNScharacterString可选DNS server。
11AlternateDNScharacterString可选Backup DNS server。

WindowCoveringCategoryEnum8

该枚举定义 WindowCoveringCategory Trait 的 Present Value 有效取值。

取值名称说明
0x00RollerShade卷帘
0x01RollerShade2Motor双层卷帘
0x02RollerShadeExterior室外卷帘
0x03RollerShadeExterior2Motor双层室外卷帘
0x04Drapery窗帘
0x05Awning遮阳篷
0x06Shutter百叶帘
0x07TiltBlindTiltOnly仅倾斜百叶帘
0x08TiltBlindLiftAndTilt倾斜和升降百叶帘
0x09ProjectorScreen投影屏幕
0xFFUnknown未知

WindowCoveringOpenOrientationEnum8

该枚举定义 WindowCoveringOpenOrientation Trait 的 Present Value 有效取值。

取值名称说明
0x00LeftRight左右双开
0x01LeftToRight从左向右
0x02RightToLeft从右向左
0x03Up从下向上
0x04Horizontal左右开合
0x05Vertical上下开合

WindowCoveringTypeEnum8

该枚举定义 WindowCoveringType Trait 的 Present Value 有效取值。

取值名称说明
0x00RollerShade卷帘
0x01VenetianBlind百叶帘
0x02ShangrilaBlind香格里拉百叶帘
0x03ZebraBlind斑马帘
0x04Curtain开合帘
0x05VerticalVenetianBlind梦幻帘
0x1FRomanShade罗马帘
0x20BalloonShade气球帘
0x21WovenWood编织木帘
0x22PleatedShade褶皱帘
0x23CellularShade蜂巢帘
0x24LayeredShade分层帘
0x25LayeredShade2D2D分层帘
0x26SheerShade透光帘
0x27TiltOnlyInteriorBlind仅倾斜室内百叶帘
0x28InteriorBlind室内百叶帘
0x29VerticalBlindStripCurtain垂直百叶帘条形窗帘
0x2AInteriorVenetianBlind室内威尼斯百叶帘
0x2BExteriorVenetianBlind室外威尼斯百叶帘
0x2CLateralLeftCurtain左侧滑动窗帘
0x2DLateralRightCurtain右侧滑动窗帘
0x2ECentralCurtain中央窗帘
0x2FRollerShutter卷帘门
0x30ExteriorVerticalScreen室外垂直遮阳帘
0x31AwningTerracePatio露台遮阳篷
0x32AwningVerticalScreen垂直遮阳篷
0x33TiltOnlyPergola仅倾斜凉亭
0x34SwingingShutter摆动百叶帘
0x35SlidingShutter滑动百叶帘
0xFFUnknown未知

WindSettingEnum8

该枚举定义 WindSetting Trait 的 Present Value 有效取值。

取值名称说明
0x00Normal正常
0x01Sleep睡眠
0x02Natural自然

ZigbeeDiagnosticsTraitPresentValueStructure

该结构体定义 ZigbeeDiagnostics Trait 的 Present Value 字段布局。

结构体成员序号字段名类型是否必选说明
0Channeluint8必选Zigbee radio channel。
1ExtendedPANIDuint64必选Zigbee extended PAN identifier。
2NetworkKeyoctetString必选Zigbee network key。
3NetworkNamecharacterString必选Zigbee network name。
4PANIDuint16必选Zigbee PAN identifier。
5RSSIint8可选RSSI for the Zigbee network client in dBm。
6LQIuint8可选Link quality indicator。