Page History

...

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.

...