南方电网HA集成教程：查询与管理电费统计

南方电网HA集成教程：查询与管理电费统计

china_southern_power_grid_stat项目地址:https://gitcode.com/gh_mirrors/ch/china_southern_power_grid_stat

1. 项目介绍

该项目是一个用于Home Assistant的自定义组件，允许用户获取中国南方电网（CSG）的电费统计数据。它支持以下几个功能：

• 查询广东、广西、云南、贵州、海南地区的电费数据
• 使用手机号码和密码登录
• 登录态失效后的自动重新登录
• 多个南网账户管理（每个账户独立集成）
• 单个账户下多个缴费号的数据查询
• 数据定时自动更新（默认每4小时）
• GUI配置，无需手动编辑yaml配置文件

2. 项目快速启动

首先确保你的Home Assistant环境已经安装了HACS（Home Assistant Community Store）。如果没有，按照官方文档[1]进行安装。

1. 在Home Assistant的HACS界面里，点击“Integration”类别。
2. 搜索china_southern_power_grid_stat。
3. 安装该集成并刷新页面。
4. 在Home Assistant的配置页面中，选择 integrations，然后添加新的集成。
5. 搜索并选择China Southern Power Grid。
6. 提供你的南方电网账号和密码，按照向导完成设置。

示例配置：

# configuration.yaml 或者通过HACS图形界面添加
custom_components:
  - china_southern_power_grid_stat:
      username: YOUR_PHONE_NUMBER
      password: YOUR_PASSWORD

替换YOUR_PHONE_NUMBER和YOUR_PASSWORD为你实际的南方电网账号信息。

3. 应用案例与最佳实践

查看电费余额

添加一个传感器来查看电费余额：

# configuration.yaml
sensor:
  - platform: china_southern_power_grid_stat
    entity_id: electricity_account.balance

这将在Home Assistant UI中创建一个传感器，实时显示电费余额。

监控用电量

为了监控每日用电量，你可以创建一个历史图组件：

# Lovelace卡片配置
type: 'custom:mini-graph-card'
entities:
  - sensor.your_electricity_meter_daily_consumption
title: '每日用电量'
show_state: false
line_width: 3
hours_to_show: 24

在这里，your_electricity_meter_daily_consumption应替换为实际的日用电量传感器实体ID。

4. 典型生态项目

本集成可以与其他能源监测工具如energy板块结合使用，以实现更全面的能耗分析和成本控制。此外，配合自动化规则，你可以设定提醒当电费余额低于某个阈值时发送通知。

参考资料：

1. HACS 官方安装指南

本文仅提供基本操作指导，更多详细的配置选项和高级用法可查阅项目源码仓库中的README及讨论区。

china_southern_power_grid_stat项目地址:https://gitcode.com/gh_mirrors/ch/china_southern_power_grid_stat