开源项目教程：lovelace-xiaomi-vacuum-card

开源项目教程：lovelace-xiaomi-vacuum-card

lovelace-xiaomi-vacuum-cardSimple card for various robot vacuums in Home Assistant's Lovelace UI项目地址:https://gitcode.com/gh_mirrors/lo/lovelace-xiaomi-vacuum-card

1. 项目的目录结构及介绍

项目的目录结构如下：

lovelace-xiaomi-vacuum-card/
├── examples/
│   └── img/
├── CHANGELOG.md
├── LICENSE
├── README.md
├── hacs.json
├── tracker.json
└── xiaomi-vacuum-card.js

• examples/：包含示例图片的目录。
• CHANGELOG.md：记录项目版本变更的日志文件。
• LICENSE：项目的许可证文件，采用MIT许可证。
• README.md：项目的说明文档。
• hacs.json：HACS（Home Assistant Community Store）的配置文件。
• tracker.json：项目跟踪信息文件。
• xiaomi-vacuum-card.js：项目的主要启动文件。

2. 项目的启动文件介绍

项目的启动文件是 xiaomi-vacuum-card.js。这个文件是用于在Home Assistant的Lovelace UI中显示和控制小米扫地机器人的自定义卡片。

3. 项目的配置文件介绍

项目的配置文件主要包括以下几个部分：

3.1. HACS配置

hacs.json 文件用于HACS的配置，包含了项目的名称、描述、类别等信息。

3.2. 自定义卡片配置

在Home Assistant的配置文件中，可以通过以下方式添加自定义卡片：

lovelace:
  resources:
    - url: /hacsfiles/lovelace-xiaomi-vacuum-card/xiaomi-vacuum-card.js
      type: module

3.3. 自定义卡片详细配置

自定义卡片的详细配置可以在Home Assistant的Lovelace UI中进行，也可以通过YAML进行手动配置。以下是一个示例配置：

type: custom:xiaomi-vacuum-card
entity: vacuum.my_xiaomi_vacuum
name: 我的小米扫地机器人
attributes:
  main_brush:
    label: '主刷:'
    unit: '小时'
  side_brush:
    label: '边刷:'
    unit: '小时'
  filter:
    label: '过滤器:'
    unit: '小时'
  sensor:
    label: '传感器:'
    unit: '小时'
buttons:
  start:
    label: 开始
  pause:
    label: 暂停
  stop:
    label: 停止

通过以上配置，可以在Home Assistant的Lovelace UI中显示和控制小米扫地机器人。

---

以上是 lovelace-xiaomi-vacuum-card 项目的详细教程，希望对你有所帮助。

lovelace-xiaomi-vacuum-cardSimple card for various robot vacuums in Home Assistant's Lovelace UI项目地址:https://gitcode.com/gh_mirrors/lo/lovelace-xiaomi-vacuum-card