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. The 4x4 and 16x8 boards are supported.

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 can add the board to the Axxon One configuration in one of the following ways:

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 isn't listed, you must check the physical connection of the board to the computer (make sure that the board is inserted into the computer's motherboard and recognized by the system).

      Note
      title Attention!
      If the board isn't displayed in the device manager, you must install the driver manually. To do this, you must download the archive and select the folder with the x64 driver or the w2k folder in the device manager if you use the 32 bit Windows OS (Windows 2000, Windows XP).

   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.

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

Adding the board to Axxon One in Linux OS

To add the 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 the StreamLabs USB-IO.ziprar 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 the set_sl_rule.zip script  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.

...