scadaguru/pysmtreader

pysmtreader（基于Python的SMT读取工具）

这是一个Python应用程序，用于轮询智能电表数据，使用Smart Meter Texas（https://www.smartmetertexas.com%EF%BC%89%E7%9A%84%E6%9C%AA%E5%85%AC%E5%BC%80API%E5%AE%9E%E7%8E%B0%E5%8A%9F%E8%83%BD%E3%80%82%E7%89%B9%E5%88%AB%E6%84%9F%E8%B0%A2https://github.com/keatontaylor/smartmetertexas-api%EF%BC%8C%E6%B2%A1%E6%9C%89%E4%BB%96%E7%9A%84%E6%96%87%E6%A1%A3%EF%BC%8C%E6%9C%AC%E5%B7%A5%E5%85%B7%E6%97%A0%E6%B3%95%E5%AE%9E%E7%8E%B0%E3%80%82

核心功能

• 按配置间隔（每小时一次，最多每小时两次，受Smart Meter Texas限制）轮询电表数据。
• 将读取到的数据发送到Home Assistant平台，便于用户监控用电情况。

使用场景

• 智能家居用户需要实时或定期获取电表数据，集成到Home Assistant进行用电分析和监控。

配置说明

需更新默认的config.yaml文件，替换以下字段的值：

• username：Smart Meter Texas账号用户名
• password：Smart Meter Texas账号密码
• esiid：电表ESIID（可从电费账单或Smart Meter Texas账户获取）
• meter_number：电表编号（同上）
• base_url（Home Assistant部分）：Home Assistant的URL/IP（无末尾斜杠）
• access_token（Home Assistant部分）：Home Assistant访问令牌

配置文件示例：

yaml
logs:
    level: debug # debug, info(default), warning, error, critical
    log_file_name: pysmt # 无扩展名，日志扩展名自动添加

health_check:
    log_info_line_at: 30 # 分钟数，0表示禁用

smartmetertexas: # smartmetertexas.com
    base_url: [***]
    username: _REPLACE_ # 替换为你的Smart Meter Texas用户名
    password: _REPLACE_ # 替换为你的Smart Meter Texas密码
    esiid: _REPLACE_ # 替换为你的ESIID
    meter_number: _REPLACE_ # 替换为你的电表编号
    poll_interval_minutes: 60 # 0表示禁用，不要低于30分钟（Smart Meter Texas限制每小时最多两次读取）
    wait_interval_before_ondemand_read_minutes:5
    force_first_read: False # True则立即读取，否则按轮询间隔

home_assistant: # Home Assistant访问详情
    base_url: _REPLACE_ # 你的Home Assistant URL/IP，如[***]
    access_token: _REPLACE_ # 你的Home Assistant访问令牌
    ha_entity: sensor.smt_reading # 要创建的Home Assistant实体名称

部署方式

Docker运行

执行命令：

bash
docker run -d -v ${PWD}/:/config scadaguru/pysmtreader

Docker Compose配置

yaml
version: "3"
services:
    pysmtreader:
        container_name: pysmtreader
        image: scadaguru/pysmtreader
        volumes:
            - ./:/config
        restart: unless-stopped

发送到Home Assistant的数据

包含以下字段：

• current_state：最新读取值
• prev_state：上一次读取值
• difference：最新与上一次的差值（若每小时轮询则为每小时用电量）
• unit_of_measurement：单位（KW）
• odrusage：Smart Meter Texas提供的总用量（可能为前一天至今的总量）
• last_timestamp：最后读取时间（格式：2020-05-27 14:30:01.674）