CV / YOLOv3
YOLOv3
reComputer R Series (CM5 + Hailo-8)
COCO-Erkennung mit YOLOv3 / YOLOv3-416 / YOLOv3-Gluon / YOLOv3-Gluon-416 auf reComputer R Series mit Hailo-8 oder Hailo-10H.
Wähle das Gerät, das du verwendest. Die Einrichtungsanleitung und Dokumentation werden entsprechend aktualisiert.
Erste Schritte
sudo docker run --rm \
--name pi5-hailo8-yolov3 \
--privileged \
--net=host \
-e PYTHONUNBUFFERED=1 \
--device /dev/hailo0:/dev/hailo0 \
-v /usr/lib/libhailort.so.4.23.0:/usr/lib/libhailort.so.4.23.0:ro \
-v /usr/lib/libhailort.so:/usr/lib/libhailort.so:ro \
ghcr.io/seeed-projects/recomputer-hailo8-cv/yolov3:latest \
python web_detection.py --model_path model/yolov3.hef --video_path video/test.mp4Modelldetails
reComputer R Series (CM5 + Hailo-8)COCO-Erkennung mit YOLOv3 / YOLOv3-416 / YOLOv3-Gluon / YOLOv3-Gluon-416 auf reComputer R Series (CM5 + Hailo-8)
Die vier YOLOv3-Varianten erkennen 80 COCO-Klassen auf Hailo-8 über HailoRT 4.23.x. Jedes HEF liefert drei rohe YOLOv3-Köpfe; der Host führt die vollständige Grid-Dekodierung (Sigmoid + Anchors + NMS) aus und zeichnet die Boxen in der MJPEG-Vorschau. Die Varianten nutzen denselben Webdienst.
Modellinformationen
| Variante | Eingabe | Enthaltenes HEF | mAP Float / Hailo-8 | FPS (Batch 1) | Parameter / Operationen | Container |
|---|---|---|---|---|---|---|
| YOLOv3 | 608×608×3 | 54.7 MB | 38.4 / 38.3 | 37.8 | 68.79M / 158.10G | yolov3 |
| YOLOv3-416 | 416×416×3 | 56.6 MB | 37.7 / 37.6 | 47.8 | 61.92M / 65.94G | yolov3_416 |
| YOLOv3-Gluon | 608×608×3 | 50.8 MB | 37.3 / 35.8 | 38.1 | 68.79M / 140.7G | yolov3_gluon |
| YOLOv3-Gluon-416 | 416×416×3 | 56.2 MB | 36.3 / 34.3 | 49.0 | 61.92M / 65.94G | yolov3_gluon_416 |
Hardware- und Host-Setup
| Board | Beschleuniger | Laufzeit | Python im Container |
|---|---|
| Board | reComputer R Series mit Raspberry Pi CM5 |
| Beschleuniger | Hailo-8 über PCIe, bereitgestellt als /dev/hailo0 |
| Laufzeit | HailoRT 4.23.x (Host und Container müssen major.minor teilen) |
| Python im Container | 3.11, aarch64 |
sudo apt update
sudo apt install hailo-all -y
sudo reboot
# Nach dem Neustart
hailortcli fw-control identify
ls /dev/hailo0
# Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh --mirror Aliyun
sudo systemctl enable docker
sudo systemctl start dockerMit Demo-Video ausführen
Wählen Sie den Befehl für die gewünschte Modellvariante.
YOLOv3
sudo docker run --rm \
--name pi5-hailo8-yolov3 \
--privileged \
--net=host \
-e PYTHONUNBUFFERED=1 \
--device /dev/hailo0:/dev/hailo0 \
-v /usr/lib/libhailort.so.4.23.0:/usr/lib/libhailort.so.4.23.0:ro \
-v /usr/lib/libhailort.so:/usr/lib/libhailort.so:ro \
ghcr.io/seeed-projects/recomputer-hailo8-cv/yolov3:latest \
python web_detection.py --model_path model/yolov3.hef --video_path video/test.mp4YOLOv3-416
sudo docker run --rm \
--name pi5-hailo8-yolov3-416 \
--privileged \
--net=host \
-e PYTHONUNBUFFERED=1 \
--device /dev/hailo0:/dev/hailo0 \
-v /usr/lib/libhailort.so.4.23.0:/usr/lib/libhailort.so.4.23.0:ro \
-v /usr/lib/libhailort.so:/usr/lib/libhailort.so:ro \
ghcr.io/seeed-projects/recomputer-hailo8-cv/yolov3_416:latest \
python web_detection.py --model_path model/yolov3_416.hef --video_path video/test.mp4YOLOv3-Gluon
sudo docker run --rm \
--name pi5-hailo8-yolov3-gluon \
--privileged \
--net=host \
-e PYTHONUNBUFFERED=1 \
--device /dev/hailo0:/dev/hailo0 \
-v /usr/lib/libhailort.so.4.23.0:/usr/lib/libhailort.so.4.23.0:ro \
-v /usr/lib/libhailort.so:/usr/lib/libhailort.so:ro \
ghcr.io/seeed-projects/recomputer-hailo8-cv/yolov3_gluon:latest \
python web_detection.py --model_path model/yolov3_gluon.hef --video_path video/test.mp4YOLOv3-Gluon-416
sudo docker run --rm \
--name pi5-hailo8-yolov3-gluon-416 \
--privileged \
--net=host \
-e PYTHONUNBUFFERED=1 \
--device /dev/hailo0:/dev/hailo0 \
-v /usr/lib/libhailort.so.4.23.0:/usr/lib/libhailort.so.4.23.0:ro \
-v /usr/lib/libhailort.so:/usr/lib/libhailort.so:ro \
ghcr.io/seeed-projects/recomputer-hailo8-cv/yolov3_gluon_416:latest \
python web_detection.py --model_path model/yolov3_gluon_416.hef --video_path video/test.mp4Öffnen Sie http://<Board_IP>:8000, um die Erkennungen zu sehen. Die mitgelieferte Datei video/test.mp4 ist der Demo-Clip für die Verifikation.
USB-Kamera-Modus
sudo docker run --rm \
--name pi5-hailo8-yolov3 \
--privileged \
--net=host \
-e PYTHONUNBUFFERED=1 \
--device /dev/hailo0:/dev/hailo0 \
--device /dev/video0:/dev/video0 \
-v /usr/lib/libhailort.so.4.23.0:/usr/lib/libhailort.so.4.23.0:ro \
-v /usr/lib/libhailort.so:/usr/lib/libhailort.so:ro \
ghcr.io/seeed-projects/recomputer-hailo8-cv/yolov3:latest \
python web_detection.py --model_path model/yolov3.hef --camera_id 0Ersetzen Sie yolov3 durch den Image- und Modellnamen einer anderen Variante, um YOLOv3-416, YOLOv3-Gluon oder YOLOv3-Gluon-416 auszuführen.
REST API
| Endpoint | Methode |
|---|---|
| YOLOv3 | POST /api/models/yolov3/predict |
| YOLOv3-416 | POST /api/models/yolov3_416/predict |
| YOLOv3-Gluon | POST /api/models/yolov3_gluon/predict |
| YOLOv3-Gluon-416 | POST /api/models/yolov3_gluon_416/predict |
curl -X POST "http://<Board_IP>:8000/api/models/yolov3/predict" \
-F "file=@test.jpg"Die predictions-Einträge enthalten COCO-Klasse, Konfidenz und Box.
Implementierungshinweise
- Die HEFs liefern drei rohe YOLOv3-Köpfe ohne On-Chip-NMS. Der Host führt Sigmoid, Anchor-Grid-Dekodierung und NMS aus.
- Die Vorverarbeitung führt Letterbox auf die HEF-Eingabegröße mit Füllung 114 durch und konvertiert BGR nach RGB; die Normalisierung ist im HEF kompiliert.
- Anchors: stride 32
[[116,90],[156,198],[373,326]], stride 16[[30,61],[62,45],[59,119]], stride 8[[10,13],[16,30],[33,23]]. - Die erste Inferenz protokolliert die Form jedes Kopfes.
Entwicklungshinweise
- Quellen:
src/rpi5_hailo8_yolov3{,_416,_gluon,_gluon_416}/ - Dockerfiles:
docker/hailo8/yolov3{,_416,_gluon,_gluon_416}.dockerfile - Container:
ghcr.io/seeed-projects/recomputer-hailo8-cv/yolov3{,_416,_gluon,_gluon_416}:latest - HEFs: Hailo Model Zoo v2.20.0 (
hailo8), sizes and SHA256 in each module'smodel/README.md
Eingaben und Ausgaben
Eingabe: Bild, Video oder USB-Kameraframe. Ausgabe: COCO-80-Klassen-Boxen, Konfidenz und MJPEG-Vorschau.