ualex73/s0pcm-reader

S0PCM-Reader Docker镜像

镜像概述

本镜像提供S0PCM-Reader应用的Docker部署方案。该Python应用可读取S0PCM-2或S0PCM-5脉冲计数模块的数据，并通过MQTT协议将总计数、每日计数和昨日计数发送至Home Assistant等智能家居系统。支持的架构包括：amd64（Intel/AMD系统）、arm32v6（树莓派1/2）、arm64v8（树莓派3及以上）。

核心功能

• 读取S0PCM-2/S0PCM-5模块的脉冲数据
• 计算并存储总计数、每日计数和昨日计数
• 通过MQTT协议发送计数数据至智能家居平台
• 支持多架构部署
• 可自定义MQTT主题和设备配置

使用场景

• 水、电、气表等脉冲式计量设备的数据采集
• 智能家居系统（如Home Assistant）的能源/资源使用监控
• 家庭或小型商业场所的能耗统计

配置说明

脉冲单位转换

S0PCM-Reader仅计数脉冲，需根据计量设备的脉冲规则设置单位。例如，荷兰Itron水表每升水发送1个脉冲，则measurement.yaml中需以升为单位记录数据（1立方米=1000升）。

初始计数配置

1. 停止S0PCM-Reader容器
2. 打开<config>/measurement.yaml文件
3. 找到对应输入（如M1对应1），修改total值（例：370689升=370立方米）：

   yaml
   1:
       total: 370689
   

4. 保存文件并重启容器

MQTT主题

数据将通过以下MQTT主题发布：

<basetopic>/X/total
<basetopic>/X/today
<basetopic>/X/yesterday

• <basetopic>可在配置文件中设置（默认：s0pcm-reader）
• X为输入编号，名称可在measurement.yaml中配置

卷挂载

• /config：存储配置文件、计数数据和日志

部署示例

Docker Run命令

bash
docker run [-d] \
    --name=s0pcm \
    -v /etc/localtime:/etc/localtime:ro \
    -v /docker/config:/config \
    --device /dev/ttyACM0:/dev/ttyACM0 \
    ualex73/s0pcm-reader:latest

Docker Compose配置

yaml
version: '3'

services:
  s0pcm:
    container_name: s0pcm
    image: ualex73/s0pcm-reader:latest
    restart: unless-stopped
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - /docker/s0pcm:/config
      - /dev:/dev
    devices:
      - /dev/serial/by-id/usb-Arduino_LLC_Arduino_Leonardo-if00:/dev/serial/by-id/usb-Arduino_LLC_Arduino_Leonardo-if00