硬件故障排查

硬件问题应分为“设备是否被宿主机识别”“容器是否能访问”“Securex NVR 是否正确使用”三层检查。

检查顺序

1. 在宿主机确认 GPU / TPU / NPU 或视频设备存在。
2. 检查 Docker devices、权限和相关运行时。
3. 在容器中确认设备节点可见。
4. 查看 Securex NVR 系统状态与检测器日志。

常见情况

Intel GPU 0% 不一定代表异常：如果视频解码未使用硬件路径、实时负载很低或检测完全运行在 Coral 上，GPU 使用率可能很低。应结合 FFmpeg 日志、媒体解码状态和检测器状态判断。

Troubleshooting Hardware

Troubleshoot hardware in three layers: whether the host sees the device, whether the container can access it, and whether Securex NVR is actually using it.

Check order

1. Confirm the GPU, TPU, NPU, or video device exists on the host.
2. Check Docker device mappings, permissions, and runtimes.
3. Confirm the device node is visible inside the container.
4. Inspect Securex NVR system status and detector logs.

Common case

An Intel GPU reading 0% is not automatically an error. If video decoding is not configured for hardware acceleration, load is very low, or all detection runs on Coral, GPU utilization can remain low. Verify with FFmpeg logs, decode status, and detector status.

Solución de problemas de hardware

Revise el hardware en tres niveles: si el host detecta el dispositivo, si el contenedor puede acceder a él y si Securex NVR realmente lo utiliza.

Orden de comprobación

1. Confirme que GPU, TPU, NPU o dispositivo de vídeo existe en el host.
2. Revise mapeos de dispositivos Docker, permisos y runtimes.
3. Confirme que el nodo es visible dentro del contenedor.
4. Revise el estado del sistema y los registros de detectores.

Caso habitual

Un 0% de GPU Intel no implica necesariamente un fallo. Si la decodificación no usa aceleración, la carga es baja o toda la detección se ejecuta en Coral, el uso puede permanecer bajo. Compruebe registros de FFmpeg, estado de decodificación y detectores.