Instruction for installing and using the icsneoAPI shared library for Linux

• Install the libFTDI shared library, version 0.18. This is an open source FTDI driver that sits above libusb. You can either
  download and install the compiled library using the software center on your Linux installation, or download and build it from here:
  
  http://www.intra2net.com/en/developer/libftdi/download.php

    *** Note: you will need to have root access to perform the following actions ***

• Copy the shared library to /usr/local/lib:

  cp libicsneoAPI.so.0.1.3 /usr/local/lib

   

• Change directory to /usr/lib:

  cd /usr/lib

   

• Make a symbolic link to the shared library:

  ln -s /usr/local/lib/libicsneoAPI.so.0.1.3 libicsneoAPI.so

Setting USB Device permissions

Most systems will require a change to the permissions on USB devices for your
applications to access the ports. This version of the icsneoAPI for Linux was developed using Ubuntu Linux, version 10.4.1,
Linux kernel version 2.6.32-24-generic.

Your system should have a similar configuration for changing the permissions on the USB ports:

- I had to modify the following file:

/lib/udev/rules.d/50-udev-default.rule (you will need to have root access to modify this file)

- Find the entry:

# libusb devices nodes
SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_device", MODE="0664"

- Change the "0664" to "0666".

Using the icsneoAPI Shared Library to Write Applications

• The file icsneoLinuxAPI.h contains prototypes for the icsneoAPI functions supported. The LinuxAPIHelp.pdf
  describes each of the API functions.
  
• A sample C++ project (GeneralTestProject) is provided inside the tar file. It was a created using the codelite v2.5.2.4031. 
  It shows basic functionality for using a neoVI device and the API.
  
• Your project will need to include the following files. They can be found in the directory "Include_files" in the tar file:

  - icsneoLinuxAPI.h

  - icsnVC40.h
  
  - icsSpyData.h
  
  - icsSpyDataCommon.h
  
  - icsSpyDataCStyle.h
  

• Your project will need link the following libraries:
  
  - rt (run-time library for Linux)
  
  - icsneoAPI (symbolic link should be located at /usr/lib/libicsneoAPI.so)