LogoLogo
Software DownloadsDatasheetsRequest Support
  • Axsun Knowledge Base
  • OCT Product Configurations
  • Essential Information Guide
  • Getting Started Guides
    • SS-OCT Laser Engine
    • Integrated Engine (Laser & DAQ)
      • Making Connections
      • Installing Software
      • Operating the Integrated Engine
  • Reference Manuals
    • Dimensions
    • Electrical Interfaces & Connectors
    • Environmental Requirements
    • SS-OCT Laser Engine
      • Advanced Laser Engine Features
      • Laser Accessories
      • Laser Test Report
      • Frequently Asked Questions
      • Laser Troubleshooting
    • Ethernet/PCIe DAQ Board
      • Architecture & Interface Background
      • Basic Operation
      • Advanced DAQ Features
      • FPGA Register Reference
      • Frequently Asked Questions
      • DAQ Troubleshooting
    • Camera Link DAQ Board
  • How-Tos
    • Upgrading Board Firmware
    • Upgrading FPGA Bitstreams
    • Using AxsunOCTControl.dll in C++
    • Operating a Variable Delay Line
    • Using the Interface Board
    • Installing the PCIe Device Driver
  • Using Bus Power for the PCIe DAQ
  • Software Tools
    • OCT Host
    • Hardware Control Tool
    • Image Capture Tool
  • API References
    • AxsunOCTControl (.NET)
      • Using the Control.NET API
      • AxsunOCTControl Function Reference
    • AxsunOCTControl_LW (light-weight)
      • Using the Control_LW API
      • AxsunOCTControl_LW Function Reference
    • AxsunOCTCapture
      • Using the Capture API
      • Linux Installation
      • AxsunOCTCapture Function Reference
  • Other
    • Software Downloads
    • Datasheets
    • References
    • Contact Excelitas For Help
      • Tech Support Request Form
Powered by GitBook

© 2025 Excelitas Technologies

On this page
  • libstdc++.so.6 (required)
  • TurboJPEG 3.x (optional)
  • libpcap (optional)
  • Windriver PCIe driver (optional)

Was this helpful?

  1. API References
  2. AxsunOCTCapture

Linux Installation

AxsunOCTCapture library (libaxsunoctcapture.so) and dependency installation instructions.

PreviousUsing the Capture APINextSoftware Downloads

Last updated 1 year ago

Was this helpful?

NOTE: The following instructions are specific to Ubuntu 18.04. Installation on other Linux distributions will have the same dependency requirements but possibly with different commands (e.g. package managers, etc.).

libstdc++.so.6 (required)

is required, which is packaged with GCC 9.1 (or a newer version if you prefer). GCC 9 can be installed on Ubuntu 18.04 using:

sudo add-apt-repository ppa:ubuntu-toolchain-r/test
sudo apt update
sudo apt install g++-9

TurboJPEG 3.x (optional)

This dependency is for retrieving JPEG compressed data transmitted from the Ethernet DAQ or loaded from a saved data file. It is not needed when capturing data via the PCIe interface, because this interface does not support JPEG compression. Download the latest version (64 bit) of libjpeg-turbo from and build from source or install using the package manager. For example, on x64 Debian/Ubuntu-based distributions:

wget https://sourceforge.net/projects/libjpeg-turbo/files/3.0.1/libjpeg-turbo-official_3.0.1_amd64.deb
sudo dpkg -i libjpeg-turbo-official_3.0.1_amd64.deb

This will copy files to /opt/libjpeg-turbo/. The library file libturbojpeg.so must be in your linker search path, so create a symlink using:

sudo ln -s /opt/libjpeg-turbo/lib64/libturbojpeg.so /usr/lib/x86_64-linux-gnu/

libpcap (optional)

This dependency is for data capture from the DAQ via Gigabit Ethernet interface. It is not needed when capturing via the PCIe interface.

sudo apt-get install libpcap-dev

Windriver PCIe driver (optional)

Prerequisite: you must have GCC and make installed on your system. If you installed GCC 9 via the ppa according to the instructions above, you may need to "update-alternatives":

sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-9 100 --slave /usr/bin/g++ g++ /usr/bin/g++-9 --slave /usr/bin/gcov gcov /usr/bin/gcov-9
sudo apt install make
tar xvzf WD1600LNX86_64.tar.gz    # extract archive
cd WD1600LNX86_64/redist/         # change to 'redist' directory
./configure                       # configure makefile
sudo make install                 # build and install    

Create a symlink from the library file (libwdapi1600.so) to a location in the linker's search path. Use an absolute path to the library file:

sudo ln -s /<abs_path>/WD1600LNX86_64/lib/libwdapi1600.so /usr/lib/x86_64-linux-gnu/

Load the kernel driver module and change its permissions:

cd ../util                        # change to 'util' directory
sudo ./wdreg windrvr1600          # load the kernel module with wdreg script
sudo chmod go+w /dev/windrvr1600  # change permissions on the loaded device

Copy the license file windrvrlicense.txt (provided by Excelitas-Axsun) to /etc/axsun/

# from a directory containing the license file...
sudo mkdir /etc/axsun                    # create 'axsun' directory in /etc
sudo cp windrvrlicense.txt /etc/axsun/   # copy license file

NOTE: Remember to which is connected to your Ethernet DAQ using a static (Manual) IPv4 Address of 192.168.10.1 and a Netmask of 255.255.255.0

NOTE: libpcap requires elevated privileges to the socket for capturing network traffic. Run applications as root using sudo ./<application_name> or for the application using sudo setcap cap_net_raw,cap_net_admin=eip <application_name> Otherwise you will get an error "Failed to setup packet capture. (socket: Operation no permitted)" when selecting the Ethernet interface.

This dependency is for data capture from the DAQ via PCIe interface. It is not needed when capturing via the Ethernet interface. An additional license is required to use the PCIe interface on Linux OS. Please to inquire about pricing. These instructions are for .

Copy the archive (e.g. WD1600LNX86_64.tar.gz) to your desired installation directory and execute the following commands to extract, build, and install the kernel driver and associated shared library:

NOTE: Loading the kernel module and changing permissions needs to be repeated after every system reboot. If desired, this process can be scripted to execute automatically using the systemd utility as discussed .

Symbol version GLIBCXX_3.4.26
https://sourceforge.net/projects/libjpeg-turbo/files/
set the file capabilities
contact us
Windriver version 1600
here
configure the network adapter
downloaded