个人家庭用电量查询-基于Docker和Homeassistant

2023-10-18 16:30
文章标签 查询 docker 个人 家庭 homeassistant 用电量

本文主要是介绍个人家庭用电量查询-基于Docker和Homeassistant，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

mini-graph-card

本应用可以帮助你将国网的电费、用电量数据接入homeassistant，实现实时追踪家庭用电量情况；并且可以将每日用电量保存到数据库，历史有迹可循。具体提供两类数据：

  1. 在homeassistant以实体显示：

    实体entity_id说明
    sensor.last_electricity_usage最近一天用电量，单位KWH、度。属性含present_date（查询电量代表的日期）
    sensor.electricity_charge_balance预付费显示电费余额，反之显示上月应交电费，单位元
    sensor.yearly_electricity_usage今年总用电量，单位KWH、度。
    sensor.yearly_electricity_charge今年总用电费用，单位元

  2. 可选，近三十天每日用电量数据（mongodb数据库），例如：

在这里插入图片描述

一、适用范围

  1. 适用于除南方电网覆盖省份外的用户。即除广东、广西、云南、贵州、海南等省份的用户外，均可使用本应用获取电力、电费数据。

  2. 不管是通过哪种哪种安装的homeassistant，只要可以运行python，有约1G硬盘空间和500M运行内存，都可以采用本仓库部署。

本镜像支持架构：

  • linux/amd64：适用于 x86-64（amd64）架构的 Linux 系统，例如windows电脑。
  • linux/arm64：适用于 ARMv8 架构的 Linux 系统，例如树莓派，N1盒子。
  • linux/arm/v7：适用于 ARMv7 架构的 Linux 系统，例如玩客云。
  • 其他架构移步github仓库自行build。

二、实现流程

通过python的selenium包获取国家电网的数据，通过homeassistant的提供的REST API将采用POST请求将实体状态更新到homeassistant。

三、安装

1）方法一（推荐）：docker镜像部署，速度快

  1. 安装docker和homeassistant，Homeassistant极简安装法。

  2. 创建项目文件夹

   mkdir sgcc_electricitycd sgcc_electricity
  1. 创建环境变量文件
   vim .env

参考以下文件编写.env文件

# 以下项都需要修改
# 国网登录信息
PHONE_NUMBER="xxx" # 修改为自己的登录账号
PASSWORD="xxxx" # 修改为自己的登录密码# 数据库配置
ENABLE_DATABASE_STORAGE=True # or False 不启用数据库储存每日用电量数据。
# 数据库可以填已有的mongodb数据库
MONGO_URL="mongodb://USERNAME:PASSWORD@mongo-for-sgcc:27017/" # 数据库地址 修改USERNAME PASSWORD和mongo-for-sgcc和mongo容器名称一致 
DB_NAME="homeassistant" # 数据库名，默认为homeassistant
# COLLECTION_NAME默认为electricity_daily_usage_{国网用户id}，不支持修改。# homeassistant配置
HASS_URL="http://localhost:8123/" # 改为你的localhost为你的homeassistant地址HASS_TOKEN="eyxxxxx" # homeassistant的长期令牌# selenium运行参数
JOB_START_TIME="07:00" # 任务开始时间，24小时制，例如"07:00”则为每天早上7点执行，第一次启动程序如果时间晚于早上7点则会立即执行一次。## 其他默认参数
DRIVER_IMPLICITY_WAIT_TIME=60 # 浏览器默认等待时间，秒。
RETRY_TIMES_LIMIT=5 # 登录重试次数
LOGIN_EXPECTED_TIME=60 # 登录超时时间，秒
RETRY_WAIT_TIME_OFFSET_UNIT=10 
FIRST_SLEEP_TIME=10 # 第一次运行等待时间，秒# 日志级别
LOG_LEVEL="INFO" # 例如“DUBUG”可以查看出错情况
  1. 编写docker-compose.yml文件
version: "3"services:app:env_file:- .envdepends_on:- mongoimage: renhai/sgcc_electricity:latest # armv7 32架构的镜像为armv7-latestcontainer_name: sgcc_electricitynetworks:sgcc_network:environment:- SET_CONTAINER_TIMEZONE=true- CONTAINER_TIMEZONE=Asia/Shanghairestart: unless-stoppedcommand: python3 main.py# 默认将近30天数据写入mongo数据库，方便查询mongo:image: mongo:4.4.18restart: alwayscontainer_name: mongo-for-sgccnetworks:sgcc_network:environment:MONGO_INITDB_ROOT_USERNAME: USERNAME # 修改为自己的用户名MONGO_INITDB_ROOT_PASSWORD: PASSWORD # 修改为自己的密码MONGODB_DATABASE: "homeassistant" # 修改为自己的数据库名,和.env中的数据库名一致CONTAINER_TIMEZONE: Asia/Shanghaivolumes:- ./db:/data/dbnetworks:sgcc_network:

  1. 运行

    docker compose up --build 
# 或者后台运行
docker compose up -d --build


### 2）方法二：本地自行构建容器1. 克隆仓库```bashgit clone https://github.com/renhaiidea/sgcc_electricity.gitcd sgcc_electricity

  1. 参考example.env编写.env文件

    cp example.env ./env

  2. 查阅docker-compose文件，默认不需要修改

  3. 运行

    docker compose up --build 
# 或者后台运行
docker compose up -d --build

3）方法三，不安装docker，安装python环境后直接运行：

克隆仓库之后,参考Dockerfile的命令，自行配置安装chrome浏览器和selenium浏览器驱动，安装mongodb，将example.env文件复制为.env文件到scripts文件夹下，到然后运行mian.py文件。

四、配置与使用

1）第一次运行需要创建并填写.env文件，按文件说明进行填写。

2）（可选）修改实体

填写homeassistant的配置文件

由于采用REST API方式创建sensor，没有做实体注册，无法在webui里编辑。如果需要，你可以在configuration.yaml下增加如下配置后重启HA，这样你就可在webUI编辑对应的实体了，这样含有_entity后缀的实体就可以进行修改了。

  • 如果你有一个户号，参照以下配置：
# Example configuration.yaml entry
# 文件中只能有一个template
template:# 参考文档： https://www.home-assistant.io/integrations/template- trigger:- platform: eventevent_type: "state_changed"event_data:entity_id: sensor.electricity_charge_balancesensor:- name: electricity_charge_balance_entityunique_id: electricity_charge_balance_entitystate: "{{ states('sensor.electricity_charge_balance') }}"state_class: measurementunit_of_measurement: "CNY"device_class: monetary- trigger:- platform: eventevent_type: "state_changed"event_data:entity_id: sensor.last_electricity_usagesensor:- name: 最近一天用电量unique_id: last_electricity_usage_entitystate: "{{ states('sensor.last_electricity_usage') }}"attributes:present_date: "{{ state_attr('sensor.last_electricity_usage', 'present_date') }}"last_updated: "{{ state_attr('sensor.last_electricity_usage', 'last_updated') }}"state_class: totalunit_of_measurement: "kWh"device_class: energy- trigger:- platform: eventevent_type: "state_changed"event_data:entity_id: sensor.yearly_electricity_usagesensor:- name: yearly_electricity_usage_entityunique_id: yearly_electricity_usage_entitystate: "{{ states('sensor.yearly_electricity_usage') }}"state_class: total_increasingunit_of_measurement: "kWh"device_class: energy- trigger:- platform: eventevent_type: "state_changed"event_data:entity_id: sensor.yearly_electricity_chargesensor:- name: yearly_electricity_charge_entityunique_id: yearly_electricity_charge_entitystate: "{{ states('sensor.yearly_electricity_charge') }}"state_class: total_increasingunit_of_measurement: "CNY"device_class: monetary

  • 如果你有多个户号，每个户号参照configuration.yaml配置。

    **注：如果你有一个户号，在HA里就是以上实体名；**如果你有多个户号，实体名称还要加 “_户号”后缀，举例:sensor.last_electricity_usage_1234567890

❗️进行自定义操作之后，请使用带entity的实体。比如使用sensor.last_electricity_usage_entity_1234567890而不是sensor.last_electricity_usage_1234567890。

3）（可选）ha内数据展示

结合mini-graph-card 和mushroom实现效果：

image-20230731111757106.png 
type: custom:mini-graph-card
entities:- entity: sensor.last_electricity_usage_entityname: 国网每日用电量aggregate_func: firstshow_state: trueshow_points: true
group_by: date
hour24: true
hours_to_show: 240

4）（可选）配合用电阶梯，实现实时电价。

image-20230729172257731

具体操作：

修改homeassistant.yml文件然后重启或重载配置文件，注意当前阶梯中的sensor.yearly_electricity_usage_entity要根据你的实际情况修改：

# 文件中只能有一个sensor
sensor:# 实时电价- platform: template #平台名称sensors: #传感器列表real_time_electricity_price: #实体名称：只能用小写，下划线unique_id: "real_time_electricity_price" #UID（必须）friendly_name:  '实时电价' #在前端显示的传感器昵称（可选)unit_of_measurement: "CNY/kWh" #传感器数值的单位（可选）icon_template: mdi:currency-jpy #默认图标value_template: > #定义一个获取传感器状态的模板（必须）下面的6和22是指6点和22点，"1""2""3"是指阶梯123，6个价格分别是3个阶梯的峰谷价格{% if now().strftime("%H")| int >= 6 and now().strftime("%H")|int < 22 and states("sensor.current_ladder")=="1" %}0.617{%elif now().strftime("%H")| int >= 6 and now().strftime("%H")|int < 22 and states("sensor.current_ladder")=="2" %}0.677{%elif now().strftime("%H")| int >= 6 and now().strftime("%H")|int < 22 and states("sensor.current_ladder")=="3" %}0.977{% elif states("sensor.current_ladder")=="1" %}0.307{% elif states("sensor.current_ladder")=="2" %}0.337{% elif states("sensor.current_ladder")=="3" %}0.487{% endif %}# 当前阶梯- platform: templatesensors:current_ladder:unique_id: "current_ladder"friendly_name:  '当前阶梯'unit_of_measurement: "级"icon_template: mdi:elevation-risevalue_template: > #这里是上海的三个阶梯数值，第2阶梯3120，第三阶梯4800{% if states("sensor.yearly_electricity_usage_entity") | float <= 3120 %}1{% elif states("sensor.yearly_electricity_usage_entity") | float >3120 and states("sensor.yearly_electricity_usage_entity") | float <= 4800 %}2{% else %}3{% endif %}

可以在能源面板进行配置，对可以统计电量的设备实现分阶梯计算用电量。

tip：打开ha>仪表盘>能源>添加用电数据>实时电价实体-选择real_time_electricity_price。

image-20230731111953612.png

5）电量通知

可以使用homeassistant内置通知或者其他通知服务，比如pushdeer。

写在最后

原作者：https://github.com/louisslee/sgcc_electricity，原始README_origin.md。

有人同步过：https://github.com/liantianji/sgcc_electricity

我的自定义部分包括：

增加的部分：

  • 增加近30天每日电量写入数据库（默认mongodb），其他数据库请自行配置。
  • 将间歇执行设置为定时执行: JOB_START_TIME，24小时制，例如"07:00”则为每天早上7点执行，第一次启动程序如果时间晚于早上7点则会立即执行一次。
  • 给last_daily_usage增加present_date，用来确定更新的是哪一天的电量。一般查询的日期会晚一到两天。
  • 对configuration.yaml中自定义实体部分修改。

TO-DO

  • 增加多种执行方式
  • 添加默认推送服务
  • 添加多数据库支持
  • 。。。

这篇关于个人家庭用电量查询-基于Docker和Homeassistant的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/233792。

相关文章

MyBatis模糊查询报错：ParserException: not supported.pos 问题解决

MyBatis模糊查询报错：ParserException: not supported.pos 问题解决

《MyBatis模糊查询报错：ParserException:notsupported.pos问题解决》本文主要介绍了MyBatis模糊查询报错：ParserException:notsuppo... 目录问题描述问题根源错误SQL解析逻辑深层原因分析三种解决方案方案一：使用CONCAT函数（推荐）方案二：
阅读更多...
MySQL 中的 JSON 查询案例详解

MySQL 中的 JSON 查询案例详解

《MySQL中的JSON查询案例详解》：本文主要介绍MySQL的JSON查询的相关知识,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧... 目录mysql 的 jsON 路径格式基本结构路径组件详解特殊语法元素实际示例简单路径复杂路径简写操作符注意MySQL 的 J
阅读更多...
Go语言开发实现查询IP信息的MCP服务器

Go语言开发实现查询IP信息的MCP服务器

《Go语言开发实现查询IP信息的MCP服务器》随着MCP的快速普及和广泛应用,MCP服务器也层出不穷,本文将详细介绍如何在Go语言中使用go-mcp库来开发一个查询IP信息的MCP... 目录前言mcp-ip-geo 服务器目录结构说明查询 IP 信息功能实现工具实现工具管理查询单个 IP 信息工具的实现服
阅读更多...
Windows Docker端口占用错误及解决方案总结

Windows Docker端口占用错误及解决方案总结

《WindowsDocker端口占用错误及解决方案总结》在Windows环境下使用Docker容器时,端口占用错误是开发和运维中常见且棘手的问题,本文将深入剖析该问题的成因,介绍如何通过查看端口分配... 目录引言Windows docker 端口占用错误及解决方案汇总端口冲突形成原因解析诊断当前端口情况解
阅读更多...
MySQL索引的优化之LIKE模糊查询功能实现

MySQL索引的优化之LIKE模糊查询功能实现

《MySQL索引的优化之LIKE模糊查询功能实现》：本文主要介绍MySQL索引的优化之LIKE模糊查询功能实现,本文通过示例代码给大家介绍的非常详细,感兴趣的朋友一起看看吧... 目录一、前缀匹配优化二、后缀匹配优化三、中间匹配优化四、覆盖索引优化五、减少查询范围六、避免通配符开头七、使用外部搜索引擎八、分
阅读更多...
SQL表间关联查询实例详解

SQL表间关联查询实例详解

《SQL表间关联查询实例详解》本文主要讲解SQL语句中常用的表间关联查询方式,包括：左连接（leftjoin）、右连接（rightjoin）、全连接（fulljoin）、内连接（innerjoin）、... 目录简介样例准备左外连接右外连接全外连接内连接交叉连接自然连接简介本文主要讲解SQL语句中常用的表
阅读更多...
MySQL高级查询之JOIN、子查询、窗口函数实际案例

MySQL高级查询之JOIN、子查询、窗口函数实际案例

《MySQL高级查询之JOIN、子查询、窗口函数实际案例》：本文主要介绍MySQL高级查询之JOIN、子查询、窗口函数实际案例的相关资料,JOIN用于多表关联查询,子查询用于数据筛选和过滤,窗口函... 目录前言1. JOIN（连接查询）1.1 内连接（INNER JOIN）1.2 左连接（LEFT JOI
阅读更多...
MySQL 中查询 VARCHAR 类型 JSON 数据的问题记录

MySQL 中查询 VARCHAR 类型 JSON 数据的问题记录

《MySQL中查询VARCHAR类型JSON数据的问题记录》在数据库设计中,有时我们会将JSON数据存储在VARCHAR或TEXT类型字段中,本文将详细介绍如何在MySQL中有效查询存储为V... 目录一、问题背景二、mysql jsON 函数2.1 常用 JSON 函数三、查询示例3.1 基本查询3.2
阅读更多...
MySQL中的交叉连接、自然连接和内连接查询详解

MySQL中的交叉连接、自然连接和内连接查询详解

《MySQL中的交叉连接、自然连接和内连接查询详解》：本文主要介绍MySQL中的交叉连接、自然连接和内连接查询,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、引入二、交php叉连接（cross join）三、自然连接（naturalandroid join）四
阅读更多...
mysql的基础语句和外键查询及其语句详解(推荐)

mysql的基础语句和外键查询及其语句详解(推荐)

《mysql的基础语句和外键查询及其语句详解(推荐)》：本文主要介绍mysql的基础语句和外键查询及其语句详解(推荐),本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋... 目录一、mysql 基础语句1. 数据库操作 创建数据库2. 表操作 创建表3. CRUD 操作二、外键
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2