aoirint/harmonica-sensor-reader

Harmonica Sensor Reader

镜像概述

Harmonica Sensor Reader是一款用于读取Arduino串口传感器数据的Docker镜像，可定期将采集到的数据通过Hasura GraphQL API上传，支持通过环境变量灵活配置参数，适用于物联网数据采集与监控场景。

核心功能

1. 读取Arduino串口设备的传感器数据
2. 按配置间隔定期上传数据至Hasura GraphQL API
3. 支持挂载本地数据目录和串口设备
4. 通过环境变量自定义串口路径、数据目录、上传间隔等参数

使用场景

1. 家庭或工业环境中的传感器数据实时采集与上传
2. 物联网设备与Hasura GraphQL服务的集成分析
3. 长期稳定的传感器数据监控与存储

配置说明

环境变量

创建.env文件配置以下参数：

env
HOST_PORT=/dev/ttyUSB0
HOST_DATA_DIR=./data
HOST_DIALOUT_GID=20
INTERVAL=300
API_URL=http://hasura:8080/v1/graphql
ADMIN_SECRET=myadminsecretkey

部署示例

Docker Run命令

bash
docker run -d \
  --name harmonica-sensor-reader \
  --device /dev/ttyUSB0:/dev/ttyUSB0 \
  -v ./data:/app/data \
  -e HOST_PORT=/dev/ttyUSB0 \
  -e HOST_DATA_DIR=./data \
  -e HOST_DIALOUT_GID=20 \
  -e INTERVAL=300 \
  -e API_URL=http://hasura:8080/v1/graphql \
  -e ADMIN_SECRET=myadminsecretkey \
  aoirint/harmonica-sensor-reader

Docker Compose配置

yaml
version: '3'
services:
  harmonica-sensor-reader:
    image: aoirint/harmonica-sensor-reader
    devices:
      - /dev/ttyUSB0:/dev/ttyUSB0
    volumes:
      - ./data:/app/data
    environment:
      - HOST_PORT=/dev/ttyUSB0
      - HOST_DATA_DIR=./data
      - HOST_DIALOUT_GID=20
      - INTERVAL=300
      - API_URL=[***]
      - ADMIN_SECRET=myadminsecretkey