2025.3.4
首页 ▸ Integrations ▸

SmartThings

SmartThings 是一个用于连接三星或第三方设备的家庭自动化平台。

先决条件

  • 您需要一个三星账户和账户凭据。
  • 要连接设备，您需要在手机上安装 SmartThings 应用程序。

配置

要将 SmartThings integration 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

SmartThings 可以被 Home Assistant 自动发现。如果发现了实例， 它将显示为 已发现。您可以立即进行设置。

手动配置步骤

如果没有自动发现，请不要担心！您可以设置一个 手动集成条目：

支持的功能

SmartThings 将设备表示为一组功能。SmartThings 集成将这些功能映射到 Home Assistant 中的实体。单个设备可能由一个或多个实体表示。

二进制传感器

在 Home Assistant 中，每个以下 SmartThings 功能都会创建一个二进制传感器实体：

SmartThings 功能
accelerationSensor
contactSensor
filterStatus
motionSensor
presenceSensor
tamperAlert
valve
waterSensor

气候

SmartThings 气候平台允许您控制具有空调或恒温器相关功能的设备。

空调

要使 SmartThings 空调由气候实体表示，它必须具有以下所有必需功能。如果它没有所有功能，则这些功能将在 Home Assistant 中表示为单独的传感器，而不是气候实体。

SmartThings 功能 Home Assistant 中的相关气候功能
airConditionerMode（必需） hvac mode，hvac action
airConditionerFanMode（必需） fan mode
temperatureMeasurement（必需） temperature
thermostatCoolingSetpoint（必需） target temp
demandResponseLoadControl drlc_status_duration（状态属性），drlc_status_level（状态属性），drlc_status_override（状态属性），drlc_status_start（状态属性）

恒温器

要使 SmartThings 恒温器由气候实体表示，它必须具有“集合 a”或“集合 b”中的所有功能。如果它没有所有功能，则这些功能将在 Home Assistant 中表示为单独的传感器，而不是气候实体。

SmartThings 功能 Home Assistant 中的相关气候功能
thermostat（集合 a） hvac mode，hvac action，target temp high，target temp low 和 fan mode
thermostatMode（集合 b） hvac mode
thermostatHeatingSetpoint（集合 b） target temp high
temperatureMeasurement（集合 b）
thermostatOperatingState hvac action
thermostatFanMode fan mode
relativeHumidityMeasurement humidity（状态属性）

遮盖物

SmartThings 遮盖物平台允许您控制具有开/关相关功能的设备。要使设备由遮盖物实体表示，它必须具有 doorControl 或 windowShade 功能。否则，这些功能将在 Home Assistant 中表示为单独的传感器。

SmartThings 功能 Home Assistant 中的相关遮盖物功能
doorControl open 和 close
windowShade open 和 close
switchLevel position
windowShadeLevel position
battery battery_level（状态属性）

风扇

SmartThings 风扇平台允许您控制具有风扇相关功能的设备。要使 SmartThings 设备由风扇实体表示，它必须具有以下一个或多个功能，并且还必须具有 switch 功能。

SmartThings 功能 Home Assistant 中的相关风扇功能
fanSpeed speed（off，low，medium 和 high）

灯光

SmartThings 灯光平台允许您控制具有灯光相关功能的设备。要使 SmartThings 设备由灯光实体表示，它必须具有以下一个或多个功能，并且还必须具有 switch 功能。

SmartThings 功能 Home Assistant 中的相关灯光功能
switchLevel brightness 和 transition
colorControl color
colorTemperature color_temp

锁

SmartThings 锁平台允许您控制具有 lock 功能的设备，显示当前锁定状态并支持锁定和解锁命令。

传感器

SmartThings 传感器平台允许您查看具有传感器相关功能的设备。对于设备支持的每个属性（如下），都会创建一个传感器实体。

SmartThings 功能 Home Assistant 中的相关实体
activityLightingMode 活动照明模式
airConditionerMode 空调模式
airQualitySensor 空气质量
alarm 报警
audioVolume 音量
battery 电池
bodyMassIndexMeasurement 身体质量指数
bodyWeightMeasurement 体重
carbonDioxideMeasurement 二氧化碳
carbonMonoxideDetector 一氧化碳探测器
carbonMonoxideMeasurement 一氧化碳
dishwasherOperatingState 机器状态
作业状态
完成时间
dryerMode 烘干机模式
dryerOperatingState 机器状态
作业状态
完成时间
dustSensor PM10
PM2.5
energyMeter 能量
equivalentCarbonDioxideMeasurement 等效二氧化碳
formaldehydeMeasurement 甲醛
gasMeter 煤气表
煤气表热值
煤气表时间
煤气
illuminanceMeasurement 照度
infraredLevel 红外水平
mediaInputSource 媒体输入源
mediaPlaybackRepeat 媒体播放重复
mediaPlaybackShuffle 媒体播放随机
mediaPlayback 媒体播放状态
odorSensor 气味传感器
ovenMode 烤箱模式
ovenOperatingState 机器状态
作业状态
完成时间
ovenSetpoint 设定点
powerConsumptionReport 能量差异
电能
节能
功率
能量
powerMeter 功率
powerSource 电源
refrigerationSetpoint 设定点
relativeHumidityMeasurement 湿度
robotCleanerCleaningMode 清洁模式
robotCleanerMovement 运动
robotCleanerTurboMode 涡轮模式
signalStrength 链接质量
信号强度
smokeDetector 烟雾探测器
temperatureMeasurement 温度
thermostatCoolingSetpoint 冷却设定点
thermostatFanMode 风扇模式
thermostatHeatingSetpoint 加热设定点
thermostatMode 模式
thermostatOperatingState 操作状态
thermostatSetpoint 设定点
threeAxis X 坐标
Y 坐标
Z 坐标
tvChannel 电视频道
电视频道名称
tvocMeasurement 挥发性有机化合物
ultravioletIndex 紫外线指数
voltageMeasurement 电压
washerMode 洗衣机模式
washerOperatingState 机器状态
作业状态
完成时间

场景

SmartThings 场景平台允许您激活在 SmartThings 中定义的场景。对于每个 SmartThings 场景，都会创建一个场景实体。

开关

SmartThings 开关平台允许您控制具有 switch 功能的设备，这些设备尚未由更具体的平台表示。

故障排除

启用调试日志和诊断

如果启用了调试日志，集成会在日志中显示所有接收到的事件。日志捕获该设备的事件 5 秒钟，并返回一个包含设备状态和事件的 JSON 文件。 调试日志对于诊断状态更新非常有帮助，例如通过选择按钮然后物理打开设备。

删除集成

从Home Assistant中移除集成实例

  1. 前往 设置 > 设备与服务 并选择集成卡片。
  2. 从设备列表中，选择要删除的集成实例。
  3. 在条目旁边，选择三个点 菜单。然后，选择 删除。
  4. 打开 SmartThings 应用程序并从 SmartThings 中删除 Home Assistant 应用程序。