ADS

ADS（自动化设备规范）描述了一个设备独立和现场总线独立的接口，用于在运行 TwinCAT 的 Beckhoff 自动化设备与实现该接口的其他设备之间进行通信。

当前，Home Assistant 支持以下设备类型：

• 二进制传感器
• 灯光
• 传感器
• 开关
• 遮阳帘
• 选择
• 阀门

配置

要启用 ADS，请将以下行添加到您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中。 在更改了configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件后，重启 Home Assistant 以应用更改。 该集成现在显示在集成页面的 设置 > 设备与服务 下。其实体在集成卡片上以及实体标签上列出。

# 示例 configuration.yaml 条目
ads:
  device: "127.0.0.1.1.1"
  port: 801

操作

ADS 集成将注册 write_by_name 操作，允许您向 ADS 设备上的变量写入值。

{
    "adsvar": ".myvariable",
    "adstype": "int",
    "value": 123
}

操作参数：

• adsvar: ADS 设备上变量的名称。要访问 TwinCAT2 上的全局变量，使用前导点 .myvariable，对于 TwinCAT3，使用 GBL.myvariable。
• adstype: 指定变量的类型。使用以下之一：int、byte、uint、bool
• value: 将写入变量的值。

二进制传感器

ads 二进制传感器平台可用于监控 ADS 设备上的布尔值。

要使用您的 ADS 设备，您首先需要设置您的 ADS 中心，然后将以下内容添加到您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中：

# 示例 configuration.yaml 条目
binary_sensor:
  - platform: ads
    adsvar: .boolean1

灯光

ads 灯光平台允许您控制连接的 ADS 灯光。

要使用您的 ADS 设备，您首先需要设置您的 ADS 中心，然后将以下内容添加到您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中：

# 示例 configuration.yaml 条目
light:
  - platform: ads
    adsvar: GVL.enable_light
    adsvar_brightness: GVL.brightness

传感器

ads 传感器平台允许读取 ADS 设备上数字变量的值。变量可以是 BOOL、BYTE、INT、UINT、SINT、USINT、DINT、UDINT、WORD、DWORD、REAL 或 LREAL 类型。

要使用您的 ADS 设备，您首先需要设置您的 ADS 中心，然后将以下内容添加到您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中：

# 示例 configuration.yaml 条目
sensor:
  - platform: ads
    adsvar: GVL.temperature
    unit_of_measurement: "°C"
    adstype: int

因子可以用于实现固定小数。例如，如果要显示两个小数的固定小数值，则将因子设置为 100。变量值 123 将显示为 1.23。

开关

ads 开关平台访问连接的 ADS 设备上的布尔变量。变量通过其名称进行标识。

要使用您的 ADS 设备，您首先需要设置您的 ADS 中心，然后将以下内容添加到您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中：

# 示例 configuration.yaml 条目
switch:
  - platform: ads
    adsvar: .global_bool

遮阳帘

ads 遮阳帘平台允许您控制连接的 ADS 遮阳帘。

要使用您的 ADS 设备，您首先需要设置您的 ADS 中心，然后将以下内容添加到您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中：

# 示例 configuration.yaml 条目
cover:
  - platform: ads
    name: 主卧窗帘
    adsvar: covers.master_bed_room_is_closed
    adsvar_open: covers.master_bed_room_open
    adsvar_close: covers.master_bed_room_close
    adsvar_stop: covers.master_bed_room_stop
    device_class: curtain

选择

ads 选择实体访问连接的 ADS 设备上的 ENUM（整数）变量。变量通过其名称进行标识。您必须在 TwinCAT PLC 中设置相应的 ENUM。建议从 0 开始使用显式值。

TYPE E_SampleA :
(
    e1 := 0,
    e2 := 1,
    e3 := 2, 
);
END_TYPE

阀门

ads 阀门实体访问连接的 ADS 设备上的布尔变量。变量通过其名称进行标识。

要使用您的 ADS 设备，您首先需要设置您的 ADS 中心，然后将以下内容添加到您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中：

# 示例 configuration.yaml 条目
select:
  - platform: ads
    adsvar: MAIN.eMyEnum
    options:
      - "关"
      - "设置"
      - "自动"
      - "手动"
      - "访客"
      - "错误"
valve:
  - platform: ads
    adsvar: MAIN.bValveControl