describes the installation of the library.
More...
describes the installation of the library.
Summary
- Requirements
- Installed File Structure
- Quick Start / Installation
- Compatibility List
- Known Bugs / Issues
Requirements
Software Requirements:
-
Linux kernel >= 3.10
-
libc / glibc, standard C library (>= 2.11)
-
POSIX threads library (POSIX threads enabled libc)
-
udev >= v204
Other Requirements:
-
You must be root to install
-
If you want to have a graphical environment by using tools like SKLineScan or some of the demo applications, you need to install the Qt framework (>= 5.2)
Installed File Structure
The files will be installed in following directories:
/usr/lib/libSK91USB3-LX.so | 32 / 64 bit library |
/etc/udev/rules.d/88-skusb.rules | udev rules for USB 3.0 camera |
/usr/include/SK91USb3.h | Development header |
/usr/bin/SKLineScan | demonstration program SKLineScan ** |
/usr/local/share/sk/SKBOOT.img | boot image for USB 3.0 cameras with revision 1.xx |
/usr/local/share/sk/setup | installation script to uninstall the package |
/usr/local/share/sk/manuals/SKLineScan-LX.pdf | manual for the SKLineScan program ** |
/usr/local/share/sk/manuals/html | manual for the API interface |
/usr/local/src/sk/QT | examples with QT framework v5.2 |
/usr/local/src/sk/Eclipse | examples for eclipse |
/usr/local/src/sk/SKLineScan | sources for the SKLineScan program (needs QT framework v5.2) |
/home/(USER)/.sk/ | Created by SKLineScan for config files |
Quick Start / Installation
-
copy the file into a directory on the hard disk (you need write access to decompress). For the following steps, you need to be root!
-
go to the directory you copied the file into and install the package by typing:
$> ./SK91USB3-LX_v(VERSION).run
-
to run the configuration tool SKLineScan, use the menu (look for 'SKLineScan') or the console (type 'SKLineScan') to run it
Root privilege is not needed to run the application or to control the camera!
-
to uninstall the package, run (as root):
$> ./usr/local/share/sk/setup uninstall
NOTE: Once uninstalled, any configuration file will be lost. Consider backing up the respective configuration files!
Compatibility List
The Linux operation system is one of the most widely ported, running on a huge amount of architectures and provided over many distributions. Although we are trying to be compatible among the whole range of kernel versions and distributions, there is no guarantee that the driver is working on a specific untested combination.Below is a list of tested and succeeded platforms and distributions for the CURRENT SDK release:
Distribution | Architecture / Processor | Library Version |
/etc/<distr>-release | 'uname -i' / 'uname -m' | |
Debian 8 | amd64 / amd64 | v.1.2.0 |
Debian 8 | i386 / i386 | v.1.2.0 |
Ubuntu 15.04 / 15.10 / 16.10 | amd64 / amd64 | v.1.2.0 |
Ubuntu 15.04 / 15.10 / 16.10 | i386 / i386 | v.1.2.0 |
Mint 17.x | amd64 / amd64 | v.1.2.0 |
Mint 17.x | i386 / i386 | v.1.2.0 |
ODroid XU4 Ubuntu Mate 15.04 / 15.10 (Kernel 3.10) | armv7l / armv7l | v.1.2.0 |
Known Bugs / Issues
Please consider this section before calling for support as it lists known bugs and anomalies that might occur in this release.
-
Energy saving issues: On some systems with activated energy saving, the USB-Camera may hang once the system has entered an energy saving state.
-
USB3 issues: Sometimes the library cannot receive Data from the USB-Camera which is connected on a USB3-Port. After that occur, unlink the USB-Camera and reconnect it.
-
Threshold mode: This is a new feature in the SK91USB3-LX SDK and there may occur errors.