本帖最后由 angelyangw 于 2024-2-7 08:24 编辑
北京水费信息Home Assistant集成
2024-2 更新 v1.4
实体entity id使用index命名
取消只获取当前年份的账单信息，改为获取最近6期
背景
之前想通过微信小程序抓包来实现，但发现有加密机制，暂时无法破解，后来无意中在百度搜索时找到一个web页面(正常从页面上找不到... 估计是下线了页面，但是通过url是可以访问的)，重点是这个页面涉及到的接口，不传加密信息也可以调用，so～～搞起本工程
功能
- 通过水表户号获取水费账单及历史用水量(仅限北京市)
- 支持多个水表户号
- 全程通过UI配置
接入数据
- 水表总数
- 单价
- 水费单价(第一阶梯、第二阶梯)
- 水资源费单价
- 污水处理费单价
- 当前阶梯总单价 即几个单价的总和
- 使用量
- 第一阶梯总用量
- 第一阶梯剩余
- 第二阶梯剩余
- 当前年份周期费用
- 缴费状态
- 缴费日期
- 当期总水费
- 当期水资源费
- 当前污水处理费
- 当期水费
- 当前年份周期使用量
- 当期总用水量
- 当期水表数
使用方法
安装使用HACS或手动下载安装 注意：本集成需求Home Assistant最低版本为2022.11
配置
通过UI配置，在集成-北京水费中，输入水表户号即可
更新数据
固定设置为1天更新一次
UPDATE_INTERVAL = timedelta(days=1)
传感器
- 水表总数 sensor.xxx_meter_value
- 当前水费单价 sensor.xxx_total_cost
- 水资源费 sensor.xxx_water_tax
- 污水处理费 sensor.xxx_wastwater_treatment_price
- 第一阶梯水费 sensor.xxx_first_step_price
- 第一阶梯总用量 sensor.xxx_total_usage
- 第一阶梯剩余 sensor.xxx_first_step_left
- 第二阶梯剩余 sensor.xxx_second_step_left
- 历史账单周期费用 sensor.xxx_2023_02_01_fee
- 额外属性: 缴费状态、缴费日期、总水费、水资源费、污水处理费、水费
- 历史账单周期用量 sensor.xxx_2023_02_01_usage
sensors列表:
历史账单周期费用
历史账单周期用量
TODO
- 由于未使用到第二阶梯，顾暂不处理
- 数据更新频率固定，且未考虑历史数据是否需要更新(不会...)
自定义集成教程参考：Building a Home Assistant Custom Component Part 1: Project Structure and Basics
| 
[复制链接]
发表于 2023-8-23 11:36:11
