【翻译】YAML

xzhang · 发表于 2017-7-10 11:19:16

本帖最后由 xzhang 于 2017-7-29 14:58 编辑

Home Assistant使用 YAML 语法进行配置。 YAML可能需要一段时间才能习惯，但真正强大的是允许您表达复杂的配置。

对于要在Home Assistant中使用的每个组件，您可以在 configuration.yaml 文件中添加代码以指定其设置。以下示例条目指定您要将 notify 组件与 pushbullet 平台一起使用。

notify:
  platform: pushbullet
  api_key: "o.1234abcd"
  name: pushbullet

组件为某种功能提供核心逻辑（如 notify 提供发送通知）。
平台连接到一个特定的软件或硬件平台（如 pushbullet 与pushbullet.com的服务配合使用）。

YAML语法的基础是包含键值对的块集合和映射。集合中的每个项目都以连接符 - 开头，而映射的格式为 key: value 。如果指定重复键，则使用键的最后一个值。

请注意，缩进是使用YAML指定关系的重要部分。缩进的东西是嵌套在上一个层次的“内部”事物（属性）。所以在上面的例子中， platform: pushbullet 是notify 组件的一个属性（嵌套在里面）。如果您不使用固定宽度字体的编辑器，获得正确的缩进可能会很棘手。 Tabs 不允许用于缩进。约定是为每个级别的缩进使用2个空格。您可以使用 YAMLLint 检查您的YAML语法是否正确，然后将其加载到Home Assistant中，这将节省一些时间。请注意不要传入隐私内容，因为它不是Home Assistant维护的，而是一个第三方网站。

＃后面的文字是注释，被系统忽略。

下一个示例显示了一个 input_select 组件，它的选项值使用块集合。其他属性（如名称）使用映射指定。请注意，第二行只是 threat: ：同一行没有任何值。这里的 threat 是input_select的名称，它的值是嵌套在其下的一切。

input_select:
  threat:
    name: Threat level
# A collection is used for options
    options:
     - 0
     - 1
     - 2
     - 3
    initial: 0

以下示例显示了在映射中嵌套映射集合。在 Home Assistant 中，这将创建两个传感器，每个传感器使用MQTT平台，但对于 state_topic （用于MQTT传感器的属性之一）具有不同的值。

sensor:
  - platform: mqtt
    state_topic: sensor/topic
  - platform: mqtt
    state_topic: sensor2/topic

xzhang · 发表于 2017-7-10 11:19:17

自定义实体

默认情况下，您的所有设备将是可见的，并具有由其域确定的默认图标。您可以通过更改一些参数来自定义您的首页的外观和感觉。这可以通过覆盖特定实体的属性来完成。

注意：
小心不要忘记在 homeassistant: 中放置 customize ， customize_domain 和 customize_glob ，否则会失败。

homeassistant:
  name: Home
  unit_system: metric
  # etc
  customize:
    # Add an entry for each entity that you want to overwrite.
    sensor.living_room_motion:
      hidden: true
    thermostat.family_room:
      entity_picture: [img]https://example.com/images/nest.jpg[/img]
      friendly_name: Nest
    switch.wemo_switch_1:
      friendly_name: Toaster
      entity_picture: /local/toaster.jpg
    switch.wemo_switch_2:
      friendly_name: Kitchen kettle
      icon: mdi:kettle
    switch.rfxtrx_switch:
      assumed_state: false
  # Customize all entities in a domain
  customize_domain:
    light:
      icon: mdi:home
  # Customize entities matching a pattern
  customize_glob:
    "light.kitchen_*":
      icon: mdi:description

可能的值

属性	描述
friendly_name	实体名称
hidden	设置为 true 将隐藏实体
entity_picture	实体图片的URL
icon	来自MaterialDesignIcons.com.的图标，使用前缀 mdi:, 比如 mdi:home。
assumed_state	对于具有假定状态的开关，显示两个按钮（关闭，打开）而不是开关。通过将 assumed_state 设置为 false，您将获得默认的开关图标。
device_class	设置设备的类别，更改UI上显示的设备状态和图标（见下文）。