SL USBIO 16x8 board

On this page:

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.

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:

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

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:

Create the /sl_usb_io directory.
```
sudo mkdir -p /sl_usb_io
```
Go to the /sl_usb_io directory.
```
cd /sl_usb_io
```
Download the StreamLabs USB-IO.zip archive.
Unzip the archive to the /sl_usb_io folder.
Clear previous builds and compile the driver:
```
sudo make clean
sudo make
```
Open an additional console window in any directory. This window will be used for the monitoring of the driver debug messages.
Run the monitoring of system messages.
```
sudo dmesg -C
sudo dmesg -w
```
Upload the driver into the kernel.
```
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:
```
usbcore: registered new interface driver sl_usb_io_driver
```
Stop the driver.
```
sudo rmmod sl_usb_io
```
Configure automatic upload at system startup. Build the kernel module.
```
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.
Place install_driver-1.sh in the same directory with sl_usb_io.ko.
Set up automatic installation using the script.
```
sudo sh install_driver.sh
```
Reboot the system.
Set access permissions using udev:
1. Create a rule file.
```
sudo touch /etc/udev/rules.d/50-slusbio.rules
```
2. Edit the file.
```
sudo nano /etc/udev/rules.d/50-slusbio.rules
```
3. Add the following text to the file:
```
SUBSYSTEM=="usbmisc", KERNEL=="sl_usb_io[0-9]", RUN+="/usr/bin/chmod a+rw $env{DEVNAME}"
```
4. Reload the udev rules.
```
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:
```
sudo ./set_sl_rule.sh
```
Reboot the system.
```
sudo reboot
```
Check device detection.
```
ls /dev/sl_usb_io*
```
Expected result:
```
/dev/sl_usb_io0
```
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.
Launch the Axxon One client.
In the Axxon One client, go to the Devices tab → Add device.
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.

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:
```
lsmod | grep sl_usb_io
```
View system messages:
```
dmesg | grep sl_usb_io
```
Check access permissions:
```
ls -la /dev/sl_usb_io0
```

Page tree

Documentation for Axxon One 2.0. Documentation for other versions of Axxon One is available too.

General information

Adding the board to Axxon One in Windows OS

Adding the board to Axxon One in Linux OS