kdsmith/egauge2pvo

eGauge和APS ECU数据上传工具镜像

镜像概述

本Docker镜像提供数据上传功能，可将本地eGauge能源监控设备与APS ECU控制单元收集的数据自动同步至PVOutput光伏数据平台和mLab云数据库，实现本地设备数据与云端服务的集成管理。

核心功能与特性

• 多源数据采集：支持eGauge能源监控设备和APS ECU控制单元的本地数据接入
• 多平台同步：实现数据向PVOutput（光伏系统分析平台）和mLab（MongoDB云数据库）的双向上传
• 自动化运行：配置后可定时执行数据上传任务，减少人工操作需求
• 容器化部署：基于Docker封装，环境依赖简化，便于在各类系统中快速部署

使用场景与适用范围

• 光伏系统监控：需将eGauge采集的发电数据上传至PVOutput进行性能分析
• 工业设备管理：通过APS ECU收集的设备运行数据需存储至mLab进行长期趋势分析
• 分布式能源监控：集中管理多个本地设备数据并同步至云端的场景

使用方法与配置说明

环境变量配置

使用前需配置以下环境变量：

Docker Run部署示例

bash
docker run -d \
  --name data-uploader \
  -e EGAUGE_IP="192.168.1.10" \
  -e EGAUGE_API_KEY="eg-abc12345" \
  -e APS_ECU_SERIAL_PORT="/dev/ttyUSB0" \
  -e APS_BAUDRATE="9600" \
  -e PVOUTPUT_API_KEY="pvo-xyz789" \
  -e PVOUTPUT_SYSTEM_ID="12345" \
  -e MLAB_URI="mongodb://user:pass@ds012345.mlab.com:12345/energydb" \
  -e SYNC_INTERVAL="5" \
  --device=/dev/ttyUSB0 \
  your-image-name:latest

Docker Compose配置示例

yaml
version: '3'
services:
  data-uploader:
    image: your-image-name:latest
    container_name: data-uploader
    environment:
      - EGAUGE_IP=192.168.1.10
      - EGAUGE_API_KEY=eg-abc12345
      - APS_ECU_SERIAL_PORT=/dev/ttyUSB0
      - APS_BAUDRATE=9600
      - PVOUTPUT_API_KEY=pvo-xyz789
      - PVOUTPUT_SYSTEM_ID=12345
      - MLAB_URI=mongodb://user:pass@ds012345.mlab.com:12345/energydb
      - SYNC_INTERVAL=5
    devices:
      - /dev/ttyUSB0:/dev/ttyUSB0
    restart: unless-stopped

注意事项

1. 确保eGauge设备与容器网络连通，可通过ping测试IP可达性
2. APS ECU若使用串行连接，需通过--device参数映射宿主机串口设备
3. PVOutput和mLab的访问凭证需提前在对应平台申请并配置正确权限
4. 首次运行建议通过docker logs data-uploader检查数据同步状态