Page History

General information

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

Key technical specifications:

• Galvanic isolation: 1000 V for inputs/outputs.
• Connection interface: USB 2.0 (cable length up to 5 meters).
• Polling interval of alarm inputs: 250 ms for all contacts (not configurable).
• Power supply: USB port or external power supply (9-50 V, 500 mA).
• Additional features: Real-time clock and offline ROM for event logging.

Adding the board to Axxon One

...

in Windows OS

In Windows OS, you You can add the SL USBIO board to the Axxon One configuration in one of the following ways:

1. Using automatic device search (see Automatic search for see Searching, adding, configuring and removing IP devices). All available devices will be displayed in the search results.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 Image Added button. 

2. Manually. Do the Manually. To do this, you need to know the USB address of the board. The address can be determined using the WinObj utility. To obtain the USB address, 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 on the device and select .

   5. Select Properties → Details

   tab →

   6.  → Hardware IDs.

   7. Find the VID/PID values.

   8. Run the WinObj utility utility.

   9. Open the GLOBAL?? folder.

   10. Find the string with the required USB device by the PID value. 
       

...

1. 1.  You will receive two types of USB address, any of which can be used to connect the board

...

1. 1. to Axxon One, for example:

      • \\?\USB#VID_13C0&PID_0070#5&521a615&0&10#{a5dcbf10-6530-11d2-901f-00c04fb951ed}
      • \\.\GLOBALROOT\Device\USBPDO-1

To add the board, do the following:

1. 1. Click on the Add device link located at the end of the Server device list (see Searching, adding, configuring and removing IP devices).

   2. In the Add device manually section, select Vendor → StreamLabs, and Model → USBIO-16/8.

   3. In the IP address field, specify any of the received addresses.

   4. Click on the Image Removed button to add the board.

The SL USBIO board is added to Axxon One.

1. 1. In the Axxon One client, go to the Devices tab → Add device.
   2. 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 Image Added button.

The board is added to the Axxon One configuration in Windows OS. The When a board is added to the Axxon One configuration, the current state of the relay on the board is read. This state is automatically displayed in the relay switch layout.

Adding the board to Axxon One in Linux OS

To add the SL USBIO board to the Axxon One configuration in Linux OS, do the following:

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

archive and unzip the contents into one folder.

Build the driver:

4. StreamLabs USB-IO.zip archive.

5. Unzip the archive to

Open the console window in

6. the /sl_usb_io

directory

7. folder.

Rebuild
8. Clear previous builds and compile the driver
using the commands
9. :

   Code Block
   language bash
   sudo make clean sudo make

10. Open an additional console window in any directory. This window will be used for the monitoring of the driver debug message monitoringmessages.
11. Run the monitoring
using commands:
12. of system messages.
    

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

13. Run Upload the driver using into the command:kernel.
    

    Code Block
    language bash
    sudo insmod

    "pathto"

    /sl_usb_io/sl_usb_io.ko

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

    Code Block
    language bash
    usbcore: registered new interface driver sl_usb_io_driver

14. To stop Stop the driver, run the command:.
    

    Code Block
    language bash
    sudo rmmod

    "path to"/

    sl_usb_io

    /sl_usb_io.ko
15. Configure automatic upload at system startup. Build the kernel module.Build the board kernel module using the command:
    

    Code Block
    language bash
    sudo make -f Makefile

    The sl_usb_io.ko kernel module will appear appears in the folder. It You can be loaded upload and unloaded stop it manually, but it is recommended to use the we recommend using the install_driver-1.sh script to automatically load the module when the system starts. To do this, place the .
16. Place install_driver-1.sh
file
17. in the same directory
as
18. with sl_usb_io.ko
and run the command:
19. .
20. Set up automatic installation using the script.
    

    Code Block
    language bash
    sudo sh install_driver.sh

21. Reboot the system.

22. Launch the Axxon One Client.

23. Add the SL USBIO device by selecting Vendor → StreamLabs, and Model → USBIO-16/8.
24. In the IP address field, specify the path to the descriptor in the format /dev/sl_usb_io0, where 0 is the index of the first connected device. Next devices will have indexes 1, 2, and so on.
    

    Info
    title Note
    To check if the device is connected, run the command: Code Block language bash sudo ls /dev If only one device is connected, you can specify the path to the descriptor in the format /dev/sl_usb_io0.

25. Click on the Image Removed button to add the board.

The SL USBIO board is added to Axxon One in Linux OS.

...

1. Set access permissions using udev:
   1. Create a rule file
using the command:
2. 1. .

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

Open file using command:
3. 1. Edit the file.

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

   2. 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}"

   3. Reload the
rule using the command:
4. 1. udev rules.

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

...

1. 1. sudo udevadm trigger

      All /dev/sl_usb_

...

1. 1. io* devices will be granted read and write permissions

...

1. 1. for all users. * is the serial number of the device. To automate the creation of

...

1. 1. the udev rule, you can run the set_sl_rule.zip script with superuser

...

1. 1. permissions:

      Code Block
      language bash
      sudo ./set_sl_rule.sh

2. Reboot the system.

   Code Block
   language bash
   sudo reboot

3. 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.

4. Launch the Axxon One client.

5. In the Axxon One client, go to the Devices tab → Add device.
6. 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 Image Added button.

The board is added to the Axxon One configuration in Linux OS. The current state of the relay on the board is automatically displayed in the relay switch layout.

Problem diagnostics:

• Check uploaded kernel modules:

  Code Block
  language bash
  lsmod | grep sl_usb_io

• View system messages:

  Code Block
  language bash
  dmesg | grep sl_usb_io

• Check access permissions:

  Code Block
  language bash
  ls -la /dev/sl_usb_io0