Battery State Card for Home Assistant 使用教程

Battery State Card for Home Assistant 使用教程

battery-state-cardBattery state card for Home Assistant项目地址:https://gitcode.com/gh_mirrors/ba/battery-state-card

1. 项目介绍

Battery State Card 是一个为 Home Assistant 设计的自定义卡片，用于显示和管理多个设备的电池状态。该卡片允许用户自定义电池状态的显示方式，包括颜色、名称、排序等，并且支持自动添加和管理电池传感器。

项目地址：GitHub - maxwroc/battery-state-card

2. 项目快速启动

2.1 安装

首先，确保你已经安装了 Home Assistant。然后，你可以通过以下步骤安装 Battery State Card：

1. 打开 Home Assistant 的 configuration.yaml 文件。
2. 添加以下代码以安装 Battery State Card：

lovelace:
  resources:
    - url: /local/battery-state-card.js
      type: module

3. 下载 battery-state-card.js 文件并将其放置在 Home Assistant 的 www 目录下。

2.2 配置

在 ui-lovelace.yaml 文件中添加以下配置以使用 Battery State Card：

type: 'custom:battery-state-card'
title: "Battery Levels"
sort: "state"
entities:
  - sensor.bathroom_motion_battery_level
  - sensor.bedroom_balcony_battery_level
  - entity: sensor.bedroom_motion_battery_level
    name: "Bedroom motion sensor"

2.3 启动

保存配置文件后，重启 Home Assistant。你将在 Lovelace UI 中看到一个新的卡片，显示所有配置的电池传感器的状态。

3. 应用案例和最佳实践

3.1 自定义名称和颜色

你可以通过 bulk_rename 属性来批量重命名传感器，并通过 custom_colors 属性来设置电池状态的颜色阈值。

type: 'custom:battery-state-card'
title: "Custom Battery Levels"
sort: "state"
bulk_rename:
  - from: "Battery Level"
    to: "sensor"
custom_colors:
  - value: 100
    color: "green"
  - value: 50
    color: "orange"
  - value: 20
    color: "red"
entities:
  - sensor.bathroom_motion_battery_level
  - sensor.bedroom_balcony_battery_level

3.2 自动添加和管理传感器

通过 filter 属性，你可以自动添加符合条件的电池传感器。

type: 'custom:battery-state-card'
title: "Auto Battery Levels"
sort: "state"
filter:
  include:
    - name: entity_id
      value: "*_battery_level"

4. 典型生态项目

4.1 Home Assistant

Battery State Card 是 Home Assistant 生态系统中的一个重要组件，用于增强用户界面的功能。Home Assistant 是一个开源的家庭自动化平台，支持多种设备和传感器。

4.2 Node.js

Battery State Card 的开发和测试依赖于 Node.js。你可以使用 npm 命令来运行测试和编译项目。

npm install
npm run test

4.3 GitHub

项目托管在 GitHub 上，你可以通过 GitHub 的 Issues 和 Pull Requests 功能来参与项目的开发和维护。

---

通过以上步骤，你可以快速上手并使用 Battery State Card 来管理你的 Home Assistant 中的电池传感器。

battery-state-cardBattery state card for Home Assistant项目地址:https://gitcode.com/gh_mirrors/ba/battery-state-card