Tyre Jam Monitor

Sistem monitoring deteksi ban tumpang tindih & berhenti menggunakan YOLOv11 + ONNX Runtime.

---

Struktur File

tyre-jam-monitor/
├── target/release/
│   └── tyre-jam-monitor.exe    ← Executable utama
├── config.json                 ← Konfigurasi kamera & parameter deteksi
└── models/
    └── yolo11n.onnx            ← Model YOLO (di folder parent)

---

Cara Menjalankan

1. Buka Terminal (PowerShell / CMD)

2. Jalankan perintah berikut:

.\tyre-jam-monitor.exe --model <path_ke_model> --config <path_ke_config>

Contoh:

.\target\release\tyre-jam-monitor.exe --model ..\models\yolo11n.onnx --config config.json

---

Opsi Command Line

Flag	Wajib	Default	Keterangan
--model / -m	✅ Ya	-	Path ke file model ONNX (.onnx)
--config / -c	❌	config.json	Path ke file konfigurasi JSON
--headless	❌	false	Jalankan tanpa preview window
--image / -i	❌	-	Test dengan gambar statis (bukan kamera)

---

Contoh Penggunaan

Menjalankan dengan kamera langsung (default)

.\tyre-jam-monitor.exe --model ..\models\yolo11n.onnx

Menjalankan tanpa window (headless mode)

.\tyre-jam-monitor.exe --model ..\models\yolo11n.onnx --headless

Test dengan gambar statis

.\tyre-jam-monitor.exe --model ..\models\yolo11n.onnx --image foto_ban.jpg

---

Konfigurasi (config.json)

{
  "cameras": [
    {
      "name": "Line_01",
      "camera_type": "usb",
      "camera_index": 0,
      "rtsp_url": "",
      "http_url": "",
      "stop_tag": "Conveyor_Stop_01"
    }
  ],
  "conveyor_plc_ip": "192.168.1.100",
  "gpu_enabled": true,
  "jam_overlap_iou": 0.1,
  "movement_threshold_pixels": 10.0,
  "jam_time_seconds": 3.0,
  "confidence_threshold": 0.25,
  "nms_iou_threshold": 0.45
}

Penjelasan Parameter

Parameter	Keterangan
cameras	Daftar kamera yang dimonitor
camera_type	Tipe kamera: usb, rtsp, atau http
camera_index	Index USB kamera (0, 1, 2, ...)
conveyor_plc_ip	IP address PLC untuk kontrol conveyor
gpu_enabled	Aktifkan GPU acceleration (CUDA/TensorRT)
jam_overlap_iou	Threshold IoU untuk deteksi tumpang tindih
movement_threshold_pixels	Batas pergerakan (pixel) untuk deteksi berhenti
jam_time_seconds	Durasi (detik) sebelum dinyatakan jam
confidence_threshold	Confidence threshold model YOLO
nms_iou_threshold	NMS IoU threshold

---

Kontrol

• Tekan ESC untuk keluar dari preview window
• Window menampilkan grid view dari semua kamera
• Bounding box hijau = normal, merah = jam terdeteksi

---

Troubleshooting

Masalah	Solusi
No device	Kamera tidak terhubung. Periksa USB atau ubah camera_index
os error 10060	PLC tidak terjangkau. Periksa koneksi jaringan ke IP PLC
Window tidak muncul	Pastikan tidak menggunakan flag --headless
Model error	Pastikan path ke file .onnx benar