Skip to main content

Maskcam - 基于 Jetson Nano 的人群口罩佩戴监测

note

本文档由 AI 翻译。如您发现内容有误或有改进建议，欢迎通过页面下方的评论区，或在以下 Issue 页面中告诉我们：https://github.com/Seeed-Studio/wiki-documents/issues

简介​

由于 COVID-19 的肆虐，在许多公共场所，我们经常看到要求佩戴口罩的规定。通常会有管理人员在区域入口观察人们是否佩戴口罩。对于人类来说，这可能是一个非常简单的任务，但如果我们将其与 Jetson Nano、图像捕捉和 AI 边缘计算结合起来，这将成为一个非常有趣且具有社会价值的任务。

MaskCam 由 Berkeley Design Technology, Inc. (BDTI) 和 Tryolabs S.A. 开发，开发资金由 NVIDIA 提供。MaskCam 根据 MIT 许可证提供。有关 MaskCam 的更多信息，请参阅 BDTI 的报告。如果您有任何问题，请通过 [email protected] 联系 BDTI。

在本项目中，我们将使用 NVIDIA® Jetson Nano™ 4GB 开发套件 以及其他配件。同时，您可以选择来自 Seeed 的 A206 Carrier Board，它具有与 NVIDIA 官方载板相同的尺寸和功能设计，并且具有出色的稳定性和通用性。

准备工作​

硬件需求​

软件需求​

  • docker

  • docker-compose

  • 视频软件（显示 RTSP 流，如 VLC/QuickTime/PotPlayer）

开始使用​

Jetson Nano 设置​

  • 步骤 1. 从 Docker Hub 下载 MaskCam 容器​

sudo docker pull maskcam/maskcam-beta

  • 步骤 2. 使用命令 ifconfig 找到 Jetson Nano 的 IP 地址​

sudo ifconfig

  • 步骤 3. 使用 Docker 启动 MaskCam​

确保您的 Jetson Nano 已连接 USB 摄像头，然后在终端中输入以下命令。

sudo docker run --runtime nvidia --privileged --rm -it --env MASKCAM_DEVICE_ADDRESS=<your-jetson-ip> -p 1883:1883 -p 8080:8080 -p 8554:8554 maskcam/maskcam-beta

注意： 在此命令中，将 <your-jetson-ip> 替换为您自己的 Jetson Nano 的 IP 地址。

如果您不想使用默认输入设备，还有两种不同的命令可供选择并替换上述命令。

使用 /dev/video1 摄像头设备：

# 使用 /dev/video1 摄像头设备
sudo docker run --runtime nvidia --privileged --rm -it --env MASKCAM_INPUT=v4l2:///dev/video1 --env MASKCAM_DEVICE_ADDRESS=<your-jetson-ip> -p 1883:1883 -p 8080:8080 -p 8554:8554 maskcam/maskcam-beta

使用 CSI 摄像头设备：

# 使用 CSI 摄像头设备
sudo docker run --runtime nvidia --privileged --rm -it --env MASKCAM_INPUT=v4l2://0 --env MASKCAM_DEVICE_ADDRESS=<your-jetson-ip> -p 1883:1883 -p 8080:8080 -p 8554:8554 maskcam/maskcam-beta

  • 步骤 4. 通过 MASKCAM_DEVICE_ADDRESS 查看实时视频流​

Streaming at rtsp://aaa.bbb.ccc.ddd:8554/maskcam

注意： aaa.bbb.ccc.ddd 是您之前在 MASKCAM_DEVICE_ADDRESS 中提供的地址。

您可以将该 URL 复制粘贴到另一台计算机上的 RTSP 流媒体查看器中。在视频流中，如果您没有佩戴口罩，您的脸上会出现红色框。如果佩戴了口罩，则会出现绿色框。

MQTT 服务器设置​

除了基本功能外，此库还包括远程 服务器 的功能，这意味着您的 PC 可以从设备接收统计数据，将其存储在数据库中，并拥有基于 Web 的 GUI 前端来显示这些数据。

在本文中，所有关于服务器的演示均基于 Windows11 系统主机，您也可以通过本文找到使用 Linux 系统的说明：Maskcam。

  • 步骤 1. 在您的 PC 上安装 Docker 和 Docker-compose​

从其官方网站下载 Docker 的安装包：https://docs.docker.com/get-docker/

注意：如果安装过程中出现消息提示 WLS 2 安装不完整，请点击提示框中的链接，下载并安装 Linux 内核更新包。 然后您可以运行 docker。

  • 步骤 2. 设置构建目录​

以管理员身份运行 Windows PowerShell

移动到您将使用的驱动器的根目录，例如：

cd e:\

下载 MaskCam 仓库：

Invoke-WebRequest https://github.com/bdtinc/maskcam/archive/refs/heads/main.zip -OutFile e:\maskcam.zip

将其解压到路径 e:\maskcam：

Expand-Archive e:\maskcam.zip -DestinationPath e:\maskcam

移动到 maskcam 服务器文件夹，该文件夹包含四个容器：Mosquitto broker、后端 API、数据库和 Streamlit 前端。

cd maskcam\maskcam-main\server

然后，通过复制默认模板创建 .env 文件：

cp database.env.template database.env
cp frontend.env.template frontend.env
cp backend.env.template backend.env

打开 database.env 文件：

notepad database.env

将 <DATABASE_USER>、<DATABASE_PASSWORD> 和 <DATABASE_NAME> 字段替换为您自己的值。

  • 步骤3. 构建并运行本地服务器​

编辑完数据库环境文件后，您可以通过以下命令构建所有容器并运行它们：

sudo docker-compose up -d

接下来，打开一个网页浏览器并输入服务器 IP 地址以访问前端网页：

http://<server IP>:8501/

注意： 将 <server IP> 替换为您自己的 IP 地址。

如果您在前端页面看到 ConnectionError，请再等待几秒钟并刷新页面。后端容器可能需要一些时间来完成数据库设置。

如果您等待几秒钟并刷新页面后仍然看到 ConnectionError，请确保端口：<5432> 和 <80> 没有被占用或监听。

如果您第一次成功访问前端网页，但之后失败，目前解决问题的最佳方法是重新安装 Docker。

  • 步骤4. 将 Jetson Nano 指向您的本地服务器​

返回到您的 Jetson Nano 的终端，然后使用以下命令运行 maskcam 容器：

sudo docker run --runtime nvidia --privileged --rm -it --env MQTT_BROKER_IP=<server IP> --env MQTT_DEVICE_NAME=my-jetson-1 --env MASKCAM_DEVICE_ADDRESS=<your-jetson-ip> -p 1883:1883 -p 8080:8080 -p 8554:8554 maskcam/maskcam-beta

注意： 将 <server IP> 和 <your-jetson-ip> 替换为您自己的服务器和 Jetson Nano 的 IP 地址。

之后，您可以在网页上选择您的设备，如下所示：

最后，您可以看到 Jetson Nano 收集的数据传输到服务器。

技术支持与产品讨论​

感谢您选择我们的产品！我们致力于为您提供各种支持，以确保您使用我们的产品时体验顺畅。我们提供多个沟通渠道，以满足不同的偏好和需求。

Loading Comments...