OS - Linux

Phidgets can run on Linux directly using USB, or remotely over a network using the Phidget Webservice.

You need kernel version 2.6 or later.

Getting Started (Libraries and Drivers)

Linux does not have a graphical user interface to check your Phidget, but it does have a complete API for many languages.

For any language, you will need the basic Phidget Libraries for Linux:

• Phidget Libraries

Installing

To install the libraries, follow these steps:

1. Download libusb-0.1 and its development libraries
   • Try apt-cache search libusb in a terminal to find current packages
   • Or install from source, which includes the libusb development libraries
2. Unpack and install the Phidget Libraries for Linux (download above)
   • From the main libraries directory, run:

     ./configure

     make

     sudo make install

   • This will compile phidget21.h and place the library into your gcc path

Checking

To confirm that the libraries were installed correctly, you can use the Phidget C Examples:

• Phidget C Examples

To compile and run the basic example for checking your installation:

1. Unpack the Phidget C Examples (download above)
2. Compile and run the HelloWorld.c example:

     gcc HelloWorld.c -o HelloWorld -lphidget21
     sudo ./HelloWorld

(The sudo is needed for USB access for now)

The program will simply print out basic information for any device you plug in, and print a message upon unplugging the device. For example, starting the program, plugging in an Interface Kit Phidget, unplugging the Interface Kit, and pressing Enter displays:

   $ sudo ./HelloWorld 
   
   Opening...
   Press Enter to end

   Hello to Device Phidget InterfaceKit 8/8/8, Serial Number: 37299
   Goodbye Device Phidget InterfaceKit 8/8/8, Serial Number: 37299

   Closing...

Programming Languages

Now that you have the basic libraries installed, you can pick your language and begin programming!

If you are not using the webservice (discussed below) to control a Phidget over a network, your next step will be to delve into the use of your specific language. Each page has its own set of specific libraries, code examples, and setup instructions.

On Linux, we recommend the following languages:

• C/C++
• Java
• Python
• C# (Using Mono)
• Flash AS3

You can also use these languages, but they do not support event driven code, and must use logic code only:

• MATLAB

Webservice

The Phidget Webservice allows you to remotely control a Phidget over a network.
Before using these webservice drivers, it may help to learn about how the Phidget Webservice works.

• Linux Phidgets Webservice libraries
• The Webservice on Linux uses avahi

Common Problems and Solutions

None yet, yay!

Maybe talk about udev rules?