Skip to content

Installation

Install the app

  1. Open the ctrlX OS web interface of the device and sign in.
  2. Switch the device to Service mode. Apps can only be installed in Service mode.
  3. Go to Settings ▸ Apps & Licenses.
  4. Install InSiSo Visual Detector from the ctrlX Store, or choose Install from file. A file that does not come from the ctrlX Store installs only when the device allows installation from an unknown source. Pick the .snap for the device (see Which snap):

    • ctrlX CORE X3: the _arm64.snap.
    • ctrlX IPC with the NVIDIA extension: the +nvidia_amd64.snap.
    • Every other device: the _amd64.snap.
  5. Switch the device back to Operating mode.

The app starts by itself. InSiSo Visual Detector appears in the ctrlX OS sidebar.

Sign in

The app uses your ctrlX OS user. There is no second account and no login form. Open a page of InSiSo Visual Detector from the ctrlX OS sidebar while you are signed in to ctrlX OS: the sidebar link carries your ctrlX OS sign-in to the app, and the app's own links keep it for twelve hours. Every sidebar click starts them again.

If ctrlX OS cannot vouch for you, the app shows its own login and says why the ctrlX OS sign-in did not work. Open the page from the ctrlX OS sidebar, not from a bookmark or a typed address. If the login still appears, log out of ctrlX OS, log in again, and open the page from the sidebar.

Activate the licences

  1. Buy the licences in the ctrlX Store, or start a trial.
  2. Install them on the device in Settings ▸ Apps & Licenses.
  3. Open InSiSo Visual Detector ▸ Diagnostics. The Licence card lists every function as unlocked or names the licence it needs.

The app takes its licence seats by itself at start-up, and retries until the licence service answers. See Licensing for what each licence unlocks.

Interfaces

The app reaches the ctrlX Data Layer, the licence service, cameras and accelerators through snap interfaces. Most connect by themselves. If one is not connected, the app says so: Diagnostics names the Data Layer and the licence service, and the GPU and Hailo cards name their own.

On a device where you have a shell, connect a missing interface and restart the app:

sudo snap connect ctrlx-insiso-vision-detector:licensing-service
sudo snap connect ctrlx-insiso-vision-detector:datalayer rexroth-automationcore:datalayer
sudo snap restart ctrlx-insiso-vision-detector
Interface Needed for
licensing-service Every licensed function
datalayer Publishing to the ctrlX Data Layer, and Data Layer commands
camera USB / UVC cameras
hailo-0 A .hef model on the Hailo-8 module: sudo snap connect ctrlx-insiso-vision-detector:hailo-0 rexroth-arch02-hw:hailo-0
removable-media Detection History, saved pictures or recordings on a USB drive
opengl, gpu-2404 The NVIDIA GPU on a ctrlX IPC, with the +nvidia snap

network and network-bind connect by themselves. GigE Vision cameras need nothing extra.

Update

  1. Install the new .snap over the old one, as above.
  2. Reboot the device once. This frees any licence seats the previous version still held.

Models, settings, colours, calibration, saved pictures and the detection history are kept. After the reboot the app connects its cameras and detects with no button pressed.

To change between the amd64 snap and the +nvidia snap, install the other one the same way. It is an update, and everything above is kept.

Uninstall

Remove the app in Settings ▸ Apps & Licenses. Download what you want to keep first: the history from Detection History, saved pictures from Camera Connector, and the diagnostics from Diagnostics.