NanoDet-RepVGG-a1-640

reComputer R Series (CM5 + Hailo-8) で NanoDet-RepVGG-a1-640 を実行

nanodet_repvgg_a1_640 は HailoRT を介して Hailo-8 上で COCO 80 クラスの物体検出を行います。nanodet_repvgg と同じベース（base/nanodet.yaml）ですが、より大きい RepVGG-A1 バックボーンと 640x640 入力で精度を高めます。NMS はチップ上で実行され（Hailo HPP、meta_arch=yolov8）、ホストは NMS 後のテンソルのみを解析します。

このページは、PCIe Hailo-8 アクセラレータを搭載した reComputer R Series (CM5 + Hailo-8) を対象とします。

モデル情報

精度は Hailo Model Zoo の参照値であり、CM5 上で測定したベンチマークではありません。

ハードウェアとホストの設定

ホストに Hailo-8 パッケージをインストールし、コンテナ起動前にドライバーとデバイスの準備を確認してください：

sudo apt update
sudo apt install hailort hailort-pcie-driver python3-hailort
sudo reboot

# After reboot
hailortcli --version
hailortcli fw-control identify
ls -l /dev/hailo0

このイメージが想定する HailoRT バージョンは 4.23.x です。

デモ動画で実行

sudo docker run --rm \
  --name cm5-hailo8-nanodet-repvgg-a1-640 \
  --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/nanodet_repvgg_a1_640:latest \
  python web_detection.py --model_path model/nanodet_repvgg_a1_640.hef --video_path video/test.mp4

http://<Board_IP>:8000 を開いて Web プレビューを確認します。

USB カメラモード

sudo docker run --rm \
  --name cm5-hailo8-nanodet-repvgg-a1-640 \
  --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/nanodet_repvgg_a1_640:latest \
  python web_detection.py --model_path model/nanodet_repvgg_a1_640.hef --camera_id 0

REST API

予測エンドポイント：

POST http://<Board_IP>:8000/api/models/nanodet_repvgg_a1_640/predict

画像リクエストの例：

curl -X POST "http://<Board_IP>:8000/api/models/nanodet_repvgg_a1_640/predict" \
  -F "file=@test.jpg"

実装上の注意

• ベース（base/nanodet.yaml）とチップ上 NMS（HPP）後処理は nanodet_repvgg と同じです。バックボーン（RepVGG-A1）と入力サイズ（640x640）のみが異なります。
• HEF は NMS をチップ上で実行します（device_pre_post_layers: nms=true, hpp=true、meta_arch=yolov8）。アプリは NMS 後のテンソルのみを解析するため、nms_thresh は無視されます（API 互換性のためだけに存在）。
• NMS 後の行は [ymin, xmin, ymax, xmax, score] で、640x640 の letterbox 入力に対して [0,1] に正規化されます。アプリがピクセル座標への変換と letterbox の補正を行います。
• normalize_in_net + チップ上の input_conversion(bgr_to_rgb)：アプリは黒（0）で letterbox を行い、生の uint8 BGR ピクセルを入力します。手動正規化も cvtColor も行いません。
• HailoRT は NMS vstream をクラスごとの可変長リスト（NMS-by-score）で返します。パーサーは object/dense 形式にも対応します。初回推論で生の型と形状を記録し、実機検証を可能にします。
• クラス対応：cls_id（0..79）は標準 COCO 80 クラス一覧に直接対応します。
• 既定値：信頼度 0.25、IOU 0.45（NMS はチップ上のため IOU は無効）。Model Zoo 評価は 0.05 / 0.6 を使用します。信頼度スライダーを下げると検出を多く確認できます。

開発上の注意

• ソースモジュール: src/rpi5_hailo8_nanodet_repvgg_a1_640/
• Dockerfile: docker/hailo8/nanodet_repvgg_a1_640.dockerfile
• コンテナ: ghcr.io/seeed-projects/recomputer-hailo8-cv/nanodet_repvgg_a1_640:latest
• モジュールは HailoRT 4.23 VStreams API と Hailo-8 専用 HEF を使用します。
• ファミリー：nanodet（バリアント：nanodet_repvgg / nanodet_repvgg_a12 / nanodet_repvgg_a1_640）。これは nanodet_repvgg_a1_640 ビルドです。