System requirements¶
| Item | Specification |
|---|---|
| Platform | ctrlX OS app (a snap), installed with the ctrlX OS App Manager |
| ctrlX OS | 4.x. Tested on ctrlX OS 4.6 |
| Devices | ctrlX CORE X3 (arm64); ctrlX CORE X5, ctrlX CORE X7, ctrlX IPC and ctrlX CORE virtual (amd64) |
| Cameras | GenICam / GigE Vision industrial cameras, USB / UVC cameras, RTSP and HTTP streams |
| Cameras per device | One Camera Connector licence per connected camera |
| Models | .onnx exported from InSiSo Model Bench; for the Hailo-8 module, a .zip with the .hef, metadata.json and dgqp.npz |
| Accelerators (optional) | Hailo-8 M.2 module on a ctrlX CORE; NVIDIA GPU on a ctrlX IPC with the NVIDIA extension |
| Browser | Any current browser, through the ctrlX OS web interface |
| Cloud connection | Not required. Pictures, models and results stay on the device |
Which snap¶
Pick the snap by the device's processor and by whether it has an NVIDIA GPU. A snap installs only on the architecture it was built for.
| Snap | Devices | Carries |
|---|---|---|
ctrlx-insiso-vision-detector_<version>_arm64.snap |
ctrlX CORE X3 | Hailo-8 support |
ctrlx-insiso-vision-detector_<version>_amd64.snap |
ctrlX CORE X5, ctrlX CORE X7, ctrlX CORE virtual, ctrlX IPC without the NVIDIA extension | Hailo-8 support |
ctrlx-insiso-vision-detector_<version>+nvidia_amd64.snap |
ctrlX IPC with the NVIDIA extension | Hailo-8 support and the NVIDIA GPU runtime, about 3.2 GB |
The two amd64 snaps are the same app. The NVIDIA snap's version ends in +nvidia, for example 4.7.21+nvidia. Installing one over the other is an update: settings, cameras and models are kept.
On a ctrlX IPC with an NVIDIA GPU, the amd64 snap runs .onnx models on the CPU.
Version numbers¶
The first number of the version is the ctrlX OS major version the app is built for: 4.x.x runs on ctrlX OS 4.x. The other two numbers count releases, for example 4.7.22 for a fix and 4.8.0 for a new function.
Test builds before 4.7.18 had higher numbers, up to 7.2.17. They are all older than 4.7.18.
The NVIDIA snap adds +nvidia to the version: 4.7.21+nvidia is 4.7.21 with the NVIDIA GPU runtime.
Accelerators¶
Hailo-8. A .hef model runs on the Hailo-8 M.2 module. The Hailo runtime (HailoRT) must be the same version as the module's driver, which comes with ctrlX OS. All three snaps carry HailoRT 4.23.0; the arm64 snap also carries 4.24.0. On a device with another driver version, .hef models do not load, and Diagnostics shows the driver version.
NVIDIA GPU. On a ctrlX IPC with the NVIDIA extension (NVIDIA RTX 2000 Ada Generation), an .onnx model runs on the GPU with the same file. This needs the +nvidia snap. It carries NVIDIA's driver files for every NVIDIA driver from 535 to 580 that Ubuntu 24.04 has shipped. It uses the one that matches the device's driver. On a driver version it does not carry, the model runs on the CPU and Diagnostics shows the version.
Without an accelerator, .onnx models run on the CPU.