matthewjsporter/sump-level-sensor

Raspbian Sump Level Sensor 镜像文档

镜像概述

本镜像基于Raspbian系统构建，已预先安装sump-level-sensor工具，专门用于污水坑（sump pit）液位的监测与管理。适用于需要实时监控液位状态、防止溢出的场景，可直接部署在树莓派等ARM架构设备上。

核心功能与特性

• 预装工具：集成sump-level-sensor工具，无需额外安装配置
• 系统基础：基于官方Raspbian镜像，兼容性强，支持树莓派等ARM设备
• 液位监测：实时采集污水坑液位数据，支持阈值告警（需工具自身配置）
• 轻量部署：镜像体积优化，适合资源受限的嵌入式环境

使用场景

• 家庭/地下室污水坑液位监控
• 小型排水系统液位管理
• 工业场所简易液位监测节点
• 树莓派嵌入式液位监测项目

使用方法

基本运行命令

bash
docker run -d --name sump-level-monitor --device /dev/ttyUSB0 docker.xuanyuan.run/raspbian-sump-level-sensor

说明：--device /dev/ttyUSB0用于挂载传感器连接的串口设备，具体设备路径需根据实际硬件连接调整

配置参数说明

sump-level-sensor工具的配置通常通过工具自身的配置文件或命令行参数实现，常见配置项包括：

• 传感器类型（如超声波、浮球开关等）
• 采样频率（如每5秒采样一次）
• 告警阈值（高液位告警线）
• 数据输出方式（如串口、网络接口）

数据持久化（可选）

如需保存监测日志，可挂载本地目录：

bash
docker run -d --name sump-level-monitor \
  --device /dev/ttyUSB0 \
  -v /path/to/local/logs:/var/log/sump-level-sensor \
  docker.xuanyuan.run/raspbian-sump-level-sensor

查看运行状态

bash
# 查看容器日志
docker logs sump-level-monitor

# 进入容器调试
docker exec -it sump-level-monitor /bin/bash

注意事项

• 确保宿主机已启用串口功能（树莓派需在raspi-config中开启UART）
• 根据传感器类型调整设备挂载参数（如I2C传感器可能需要挂载/dev/i2c-1）
• 镜像仅包含基础工具，高级功能（如远程数据推送）需通过工具配置或额外脚本实现