bramgerritsen/powercalc-measure

灯光功耗测量工具镜像

概述

本Docker镜像提供了一个轻量级实用工具，专注于测量各类照明设备的功耗。通过实时采集、记录照明设备的电力使用数据，帮助用户精准掌握照明系统能耗情况，为节能策略制定和用电管理提供数据支撑。

核心功能与特性

• 实时功耗监测：支持对接电力监测硬件，实时采集电压、电流及功率数据
• 数据记录与导出：自动将监测数据保存为结构化文件（如CSV格式），便于后续分析
• 设备兼容性：适配主流照明设备类型（LED灯、荧光灯、白炽灯等）
• 轻量级设计：镜像体积小巧，资源占用低，可在嵌入式设备及服务器环境稳定运行
• 灵活配置：支持自定义采样频率、数据存储路径及输出格式

使用场景与适用范围

• 家庭照明管理：监控家庭灯具实时功耗，优化照明使用习惯
• 办公场所节能：分析办公室照明系统能耗分布，制定节能方案
• 实验室研究：记录不同照明设备功耗特性，支持照明技术研发测试
• 智能建筑集成：作为智能建筑能源管理系统子模块，提供照明能耗数据

使用方法与配置说明

基本使用命令

启动容器并挂载本地目录以持久化数据（默认配置下实时显示并保存数据至/data目录）：

bash
docker run -d --name light-power-monitor \
  --device=/dev/ttyUSB0:/dev/ttyUSB0 \  # 根据实际电力监测设备接口调整
  -v $(pwd)/local-data:/data \          # 挂载本地目录存储监测数据
  light-power-monitor:latest

环境变量配置

通过环境变量自定义工具行为，常用参数如下：

示例：设置采样间隔10秒，JSON格式输出：

bash
docker run -d --name light-power-monitor \
  --device=/dev/ttyUSB0:/dev/ttyUSB0 \
  -v $(pwd)/local-data:/data \
  -e SAMPLING_INTERVAL=10 \
  -e OUTPUT_FORMAT=json \
  light-power-monitor:latest

数据访问与分析

• 实时日志查看：docker logs -f light-power-monitor
• 数据文件路径：挂载目录下文件命名格式为power_log_YYYYMMDD.<format>
• CSV数据字段：包含timestamp（时间戳）、voltage（电压/V）、current（电流/A）、power（功率/W）、device_id（设备标识）

docker-compose配置示例

创建docker-compose.yml文件实现快速部署：

yaml
version: '3'
services:
  light-monitor:
    image: light-power-monitor:latest
    container_name: light-power-monitor
    devices:
      - /dev/ttyUSB0:/dev/ttyUSB0
    volumes:
      - ./monitor-data:/data
    environment:
      - SAMPLING_INTERVAL=3
      - OUTPUT_FORMAT=csv
      - DEVICE_MODEL=LED-100W
    restart: unless-stopped

启动服务：docker-compose up -d