Page History

General information

The SL USBIO board is an interface device designed for integrating external sensors and actuators (relays) into video surveillance and fire alarm systems.

...

1. Using automatic device search (see Searching, adding, configuring, and removing IP devices). Do the following:
   1. In the Axxon One client, go to the Devices tab → Add device.
   2. In the Add device section:
      1. Click the Search button. Axxon One performs the search, and all available devices, including SL USBIO boards, are displayed in the Devices found (n) list.
      2. Select the found SL USBIO board.
      3. Click the button. 

2. Manually. Do the following:

   1. Open the Windows Device Manager.

   2. Go to the USB Controllers tab.

   3. Find the Stream Labs USB-IO 16|8OWDint device. If it is not listed, make sure that the board is inserted into the computer's motherboard and recognized by the system.

   4. Right-click the device.

   5. Select Properties → Details → Hardware IDs.

   6. Find the VID/PID values.

   7. Run the WinObj utility.

   8. Open the GLOBAL?? folder.

   9. Find the string with the required USB device by the PID value.
       You will receive two types of USB address, any of which can be used to connect the board to Axxon One, for example:

      • \\?\USB#VID_13C0&PID_0070#5&521a615&0&10#{a5dcbf10-6530-11d2-901f-00c04fb951ed}
      • \\.\GLOBALROOT\Device\USBPDO-1
   10. In the Axxon One client, go to the Devices tab → Add device.
   11. In the Add device manually section:
       1. In the IP address parameter, enter one of the received USB addresses.
       2. In the Device type parameter, select IP device from the drop-down list.
       3. In the Vendor parameter, select StreamLabs from the drop-down list.
       4. In the Model parameter, select USBIO-16/8 from the drop-down list.
       5. Click the button.

...

1. Create the /sl_usb_io directory.

   Code Block
   language bash
   sudo mkdir -p /sl_usb_io

2. Go to the /sl_usb_io directory.

   Code Block
   language bash
   cd /sl_usb_io

3. Download the StreamLabs USB-IO.zip archive.

4. Unzip the archive to the /sl_usb_io folder.

5. Clear previous builds and compile the driver:

   Code Block
   language bash
   sudo make clean sudo make

6. Open an additional console window in any directory. This window will be used for the monitoring of the driver debug messages.
7. Run the monitoring of system messages.
   

   Code Block
   language bash
   sudo dmesg -C sudo dmesg -w

8. Upload the driver into the kernel.
   

   Code Block
   language bash
   sudo insmod /sl_usb_io/sl_usb_io.ko

   Immediately after the driver is launched, messages about the registration of a new driver appear in the monitoring window. For example:
   

   Code Block
   language bash
   usbcore: registered new interface driver sl_usb_io_driver

9. Stop the driver.
   

   Code Block
   language bash
   sudo rmmod sl_usb_io

10. Configure automatic upload at system startup. Build the kernel module.
    

    Code Block
    language bash
    sudo make -f Makefile

    The sl_usb_io.ko kernel module appears in the folder. You can upload and stop it manually, but we recommend using the install_driver-1.sh script.
11. Place install_driver-1.sh in the same directory with sl_usb_io.ko.
12. Set up automatic installation using the script.
    

    Code Block
    language bash
    sudo sh install_driver.sh

13. Reboot the system.
14. Set access permissions using udev:
    1. Create a rule file.

       Code Block
       language bash
       sudo touch /etc/udev/rules.d/50-slusbio.rules

    2. Edit the file.

       Code Block
       language bash
       sudo nano /etc/udev/rules.d/50-slusbio.rules

    3. Add the following text to the file:

       Code Block
       language bash
       SUBSYSTEM=="usbmisc", KERNEL=="sl_usb_io[0-9]", RUN+="/usr/bin/chmod a+rw $env{DEVNAME}"

    4. Reload the udev rules.

       Code Block
       language bash
       sudo udevadm control --reload-rules sudo udevadm trigger

       All /dev/sl_usb_io* devices will be granted read and write permissions for all users. * is the serial number of the device. To automate the creation of the udev rule, you can run the set_sl_rule.zip script with superuser permissions:

       Code Block
       language bash
       sudo ./set_sl_rule.sh

15. Reboot the system.

    Code Block
    language bash
    sudo reboot

16. Check device detection.

    Code Block
    language bash
    ls /dev/sl_usb_io*

    Expected result:

    Code Block
    language bash
    /dev/sl_usb_io0

    
    

    Info
    title Note
    sl_usb_io0 is the first connected device. sl_usb_io1 is the second connected device, and so on. When only one device is connected, sl_usb_io0 is always used.

17. Launch the Axxon One client.

18. In the Axxon One client, go to the Devices tab → Add device.
19. In the Add device manually section:
    1. In the IP address parameter, enter the path to the descriptor in the form /dev/sl_usb_io*, where * is the index of the connected device.
    2. In the Device type parameter, select IP device from the drop-down list.
    3. In the Vendor parameter, select StreamLabs from the drop-down list.
    4. In the Model parameter, select USBIO-16/8 from the drop-down list.
    5. Click the button.

...