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

Previous page Setting up Tibbo relay/loop boards  Configuring Tracking objects Next page

On this page:




General information

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

Adding the board to Axxon One

You can add the SL USBIO board to Axxon One in one of the following ways:

  1. Using automatic device search (see Automatic search for IP devices). All available devices will be displayed in the search results.

  2. 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 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 Properties → Details tab → Hardware IDs.

    5. Find the VID/PID values.

    6. Run the WinObj utility.

    7. Open the GLOBAL?? folder.

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

As a result, 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

To add the board, do the following:

    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 button to add the board.

The SL USBIO board is added to Axxon One.

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 Axxon One in Linux OS, do the following:

  1. Download the archive and unzip the contents into one folder.

  2. Build the driver:

    1. Open the console window in the /sl_usb_io directory.

    2. Rebuild the driver using the commands:

      make clean
make
    3. Open an additional console window in any directory. This window will be used for the driver debug message monitoring.
    4. Run the monitoring using commands:
      sudo dmesg -C
sudo dmesg -w
    5. Run the driver using the command:
      sudo insmod "path to"/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:
      usbcore: registered new interface driver sl_usb_io_driver
    6. To stop the driver, run the command:
      sudo rmmod "path to"/sl_usb_io/sl_usb_io.ko
  3. Build the board kernel module using the command:
    make -f Makefile
  4. The sl_usb_io.ko kernel module will appear in the folder. It can be loaded and unloaded manually, but it is recommended to use the install_driver-1.sh script to automatically load the module when the system starts. To do this, place the install_driver-1.sh file in the same directory as sl_usb_io.ko and run the command:
    sudo sh install_driver.sh
  5. Reboot the system.

  6. Launch the Axxon One Client.

  7. Add the SL USBIO device by selecting Vendor → StreamLabs, and Model → USBIO-16/8.
  8. 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.

    Note

    • To check if the device is connected, run the command:
      sudo ls /dev
    • If only one device is connected, you can specify the path to the descriptor in the format /dev/sl_usb_io0.
  9. Click on the button to add the board.

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

You can also create an udev rule to automatically assign permissions. To do this:

  1. Create a rule file using the command:
    sudo touch /etc/udev/rules.d/50-slusbio.rules
  2. Open file using command:
    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 rule using the command:
    sudo udevadm control --reload-rules

As a result, all /dev/sl_usb_ioX files (X corresponds to the order number) will automatically receive read and write permissions.

Note

To automate the creation of an udev rule, you can run the script with superuser rights:

sudo ./set_sl_rule.sh
  • No labels