必威是什么必威是什么

雪莉

整合雪莉设备进入家庭助必威是什么理。

配置

可以通过使用此my按钮将雪莉添加到必威体育存款您的家庭助必威是什么理实例中：

雪莉可以由家庭助理自动发现。必威是什么如果发现实例，它将显示为“发现”，您可以选择立即设置它。

手动配置步骤

雪莉设备的世代

有两代设备。这两代都得到了这种集成的支持。在世代之间的实体和设备的命名中，应如何配置设备和设备有一些差异。

雪莉设备配置（第1代）

雪莉设备使用coiot与集成进行通信的协议。对于雪莉固件1.10.0或更新的coiot必须在设备设置中启用。导航到雪莉设备的本地IP地址，网络安全>>高级 - 开发人员设置并检查框启用coiot。

我们建议使用单播进行交流。要启用此功能，请输入家庭助理服务器和端口的本地IP地址必威是什么5683进入coiot peer字段和推节省按钮。这对于使用固件1.1.0或更新的雪莉运动是必须的。更改后coiot peer，需要手动重新启动雪莉设备。

集成直接与设备通信；不需要云连接。

实体命名（第1代）

集成使用设备名称命名其实体，如果设备只有一个继电器或根本没有继电器。

如果设备有多个继电器，则使用以下策略将其命名为实体：

  • 如果设备名称或者频道名称是在设备中设置的，集成将使用它们来生成实体的名称。
  • 如果设置了频道名称，则将它们用于实体名称。设备名称将不使用。
  • 如果仅设置设备名称并且设备具有多个频道，则通道号将附加到实体名称（例如，频道2）。
  • 如果未设置设备名称和频道名称，则实体名称将由设备类型，，，，设备ID和频道编号。

例子：

设备名称 频道名称 实体名称
没有设置 没有设置 Shellyswitch25-ABC123频道1
没有设置 儿童室灯泡 儿童室灯泡
厨房 没有设置 厨房频道1
卧室 圆形灯泡 圆形灯泡

名称是从设备网页设置的：

  • 设备名称可以设置在设置>>设备名称
  • 可以将单通道设备的频道名称设置为设置>>频道名称
  • 可以将多通道设备的频道名称设置为设置>>频道名称选择频道后，单击频道名称。

实体命名（第2代）

集成使用以下策略来命名其实体：

  • 如果频道名称是在设备中设置的，集成将使用它来生成实体的名称，例如厨房灯
  • 如果频道名称设置为默认值，集成将使用设备ID和默认频道名称生成实体名称，例如Shellypro4pm-9808D1D8B912 Switch_0。

二进制输入传感器

二进制输入传感器（第1代）

根据如何配置设备的按钮类型，集成将创建与这些输入相对应的二进制传感器。当按钮类型为时，未创建二进制传感器瞬间或者MORMARY_ON_RELEASE，对于这些类型，您需要使用事件进行自动化。

二进制输入传感器（第2代）

对于2代硬件，可以选择设备的输入是否连接到按钮或开关。仅当将输入模式设置为转变。当输入为类型时按钮您需要使用事件进行自动化。

事件

如果是按钮类型连接到设备的开关的瞬间或者独立开关，集成在类型下发射事件雪莉。单击使用开关时。您可以在自动化中使用这些事件。

另外，某些设备不会为按钮/开关添加实体。例如，Shelly Button1只有一个用于电池级别的实体。它没有按钮本身的实体。要根据按钮触发自动化，请使用雪莉。单击事件。

聆听事件

您可以订阅雪莉。单击事件类型输入开发人员工具/事件为了检查事件数据JSON的正确参数，要在自动化中使用。例如，雪莉。单击按下Shelly Button1时，返回事件数据JSON类似于以下内容。

事件0开火9：53是：{“事件类型”：“ Shelly.Click”，，，，“数据”：{“设备ID”：“ E09C64A22553484D80435335353537F6FCD6”，，，，“设备”：“ Shellybutton1-A4C12A45174”，，，，“渠道”：1，，，，“ click_type”：“单身的”，，，，“一代”：1}，，“起源”：“当地的”，，，，“ Time_fired”：“ 2021-04-28T08：53：12.755729+00：00”，，，，“语境”：{“ID”：“ E0F379706563AAA0C2C1FDA5174B5A0E”，，，，“ parent_id”：无效的，，，，“用户身份”：无效的}}

这一代值表示该设备是事件源的生成。

自动化

创建自动化的最简单方法是使用家庭助理自动化编辑器。必威是什么例如，设置由特定Shelly Button的双重按下触发的自动化：

  1. 在自动化的触发器部分中，将触发类型设置为设备。
  2. 在“设备下拉菜单”中。找到Shelly Button1。
  3. 在触发下拉菜单中，选择按钮双击。
  4. 设置任何条件和措施以完成您的自动化。

您还可以使用YAML创建自动化，例如：

-别名：“切换活的房间光”扳机：平台：事件事件类型：雪莉。单击event_data：设备：Shellyswitch25-aabbcc渠道：1click_type：单身的行动：服务：light.toggle目标：ENTITY_ID：light.living_room-别名：“切换活的房间灯”扳机：平台：事件事件类型：雪莉。单击event_data：设备：Shellyswitch25-aabbcc渠道：2click_type：长行动：服务：light.toggle目标：ENTITY_ID：light.lamp_living_room

click_type的可能值

雪莉输入事件 单击类型
s 单身的
SS 双倍的
SSS 三倍
l 长
sl single_long
LS long_single

2代设备使用值BTN_Down，，，，BTN_UP，，，，single_push，，，，double_push和long_push作为click_type。

并非所有设备都支持所有输入事件。您可以检查Shelly API参考网站您的设备支持哪些类型的雪莉输入事件。

设备类型（第1代）

默认情况下，雪莉设备继电器默认为家庭助理必威是什么转变实体。可以将继电器添加为光实体如果设备使用固件版本1.9.0或较新，并且设置>>设备类型值设置为光。

消费类型（第2代）

默认情况下，雪莉设备继电器默认为家庭助理必威是什么转变实体。可以将继电器添加为光实体如果消费类型值设置为灯。

光过渡

雪莉灯支持光过渡：

  • 雪莉鳞茎RGBW
  • 雪莉二人
  • 雪莉·迪默（Shelly Dimmer）
  • Shelly Dimmer 2
  • 雪莉RGBW2
  • 雪莉复古

需要固件1.11或更高版本。

该固件将过渡时间限制为5秒。

设备服务

集成提供可以通过配置按钮触发的设备服务。

OTA更新

触发设备OTA固件更新。

纽扣

  • OTA更新
    • 触发最新稳定版本的OTA更新过程
  • OTA Update Beta（默认情况下禁用）
    • 触发最新beta版本的OTA更新过程

重启

触发设备的重新启动。

纽扣

  • 重启
    • 触发重新启动

雪莉恒温散热器阀（TRV）

Shelly TRV生成了2个可用于控制设备行为的实体：气候和数字。第一个将允许指定温度，第二个温度而不是阀位置的百分比。

笔记：如果您更改阀门位置，则将禁用自动温度控制。一旦改变温度，它就会再次启用。

CoAP端口（第1代）

在某些情况下，可能需要自定义COAP端口（默认值：5683）您必威体育存款的家庭助理必威是什么实例正在听。

为了更改它，将以下键添加到您的configuration.yaml：

＃示例Configuration.yaml条目雪莉：COAP_PORT：12345

附加信息

雪莉设备依靠SNTP对于功率测量等功能。请从设备Web UI检查配置的服务器可访问。

已知问题和局限性

  • 仅支持固件1.8及以后的1个设备
  • 仅支持固件0.8及以后用于2代设备
  • 不支持1代“ Shelly 4Pro”和“ Shelly Sense”（基于旧COAP V1协议的设备）
  • 设置之前，必须通过按设备上的按钮来唤醒电池供电的设备。
  • OTA更新服务不支持电池供电的设备