phidgets 0.0.5 → 0.1.0

data/History.txt

@@ -1,7 +1,15 @@
+== 0.1.0 2013-10-19
+  * Complete re-write as native C extension
+
+== 0.0.6 2011-01-11
+  * Added skeleton classes for all the phidget types. This will at least allow the Manager class to see them
+  * Check library version when loading the gem and print a warning if the version may cause problems
+  * Updated library interface to conform to versions 2.1.6 and 2.1.7. Future versions should maintain backward compatability with at least 2.1.6
+
 == 0.0.5 2010-10-28
   * Added Manager class
   * Added phidget executable
-  * Fixed a few bugs in the RFID class, but it is still untested.
+  * Fixed a few bugs in the RFID class, but it is still untested
 
 == 0.0.4 2010-09-10
   * Updated for compatability with Ruby 1.9
@@ -15,7 +23,7 @@
 == 0.0.2 2010-05-12
   * Rewrote using DL/Importable
   * Added some documentation
-  * Added support for Servo class.
+  * Added support for Servo class
   
 == 0.0.1 2009-03-27
   * Initial release

data/README.rdoc

@@ -1,6 +1,6 @@
 = phidgets
 
-* http://phidgets.rubyforge.org
+* https://github.com/csdehaan/phidgets
 
 == DESCRIPTION:
 
@@ -9,35 +9,51 @@ This gem provides a ruby interface to the phidgets library.
 
 == FEATURES/PROBLEMS:
 
-* This gem uses DL to call the c functions in the Phidgets shared library, so the library must be installed and working.
+* This gem compiles a c extension for the phidget library, so the library must be installed and the development files must be located
+  in a place that the compiler can find them. For windows the DevKit is required.
 * The gem has been tested to work on both Linux and Windows.
-* Not all the devices have been implemented, and not all of the devices that have been implemented have been fully tested.
-* The gem will attempt to guess the name of the phidgets library based on the platform it is run on (Linux, Windows or OS X).
-  If it guesses incorrectly please leave a message to let me know what your platform sets for Config::CONFIG['target_os'] and
-  what is the name of the phidgets library.
+* Tested with Phidget Library version 2.1.8.20130618
+* Callbacks do not work on Ruby versions earlier than 1.9. This is because native threads are required for them to work.
 
 == SYNOPSIS:
 
   require 'phidgets'
 
   begin
-    ik = Phidgets::InterfaceKit.new(-1,2000)
+    ik = Phidgets::InterfaceKit.new
+    ik.open -1
+    ik.wait_for_attachment
 
-    puts "Device Name     = #{ik.getDeviceName}"
-    puts "Serial Number   = #{ik.getSerialNumber}"
-    puts "Device Version  = #{ik.getDeviceVersion}"
+    puts "Device Name     = #{ik.device_name}"
+    puts "Serial Number   = #{ik.serial_number}"
+    puts "Device Version  = #{ik.device_version}"
 
     ik.close
 
-  rescue Phidgets::Exception => e
-    puts "Phidgets Error (#{e.code}). #{e}"
+  rescue Phidgets::Error => e
+    puts e
   end
 
 
-  The gem now installs a command line program that will list all phidgets devices that are attached, as well as allowing any
-  valid method for a given phidget type to be called. For example:
+  # Or using callbacks:
+
+  ik = Phidgets::InterfaceKit.new
+  ik.on_attach { |phid|
+    puts "Device Name     = #{phid.device_name}"
+    puts "Serial Number   = #{phid.serial_number}"
+    puts "Device Version  = #{phid.device_version}"
+  }
+
+  ik.open -1
+  sleep 5
+  ik.close
+
+
+  # The gem also installs a command line program that will list all phidget devices that are attached, as well as allowing any
+  # valid method for a given phidget type to be called. For example:
   
-  To list all phidgets attached to the local computer:
+  # To list all phidgets attached to the local computer:
+
     => phidget list
        ----------------------------------------------------------------------
        | SerialNumber          | Device Name                                |
@@ -46,7 +62,8 @@ This gem provides a ruby interface to the phidgets library.
        | 88103                 | Phidget InterfaceKit 0/0/4                 |
        ----------------------------------------------------------------------
 
-  To list all phidgets attached to a remote computer:
+  # To list all phidgets attached to a remote computer:
+
     => phidget 192.168.100.67 list
        ----------------------------------------------------------------------
        | SerialNumber          | Device Name                                |
@@ -54,16 +71,21 @@ This gem provides a ruby interface to the phidgets library.
        | 73782                 | Phidget InterfaceKit 0/0/8                 |
        ----------------------------------------------------------------------
 
-  To call a method for a specific local phidget:
+  # To call a method for a specific local phidget:
     => phidget 73723 setOutputState 0 1
     
-  To call a method for a specific remote phidget:
+  # To call a method for a specific remote phidget:
     => phidget 192.168.100.67:73782 setOuputState 2 0
 
 
 == REQUIREMENTS:
 
 * The Phidgets library (http://www.phidgets.com/)
+* For Windows the ruby DevKit is required
+* The development header file and library must be placed in a location where the compiler can find them.
+  For Linux this should be done when running "make install" for the Phidget Library. For Windows the files
+  need to be copied from the install directory (\\Program Files\\Phidgets). phidget21.h can be copied to
+  RUBY_DIR\\include\\ruby-1.9.1. phidget21.lib can be copied to RUBY_DIR\\lib.
 
 == INSTALL:
 
@@ -86,3 +108,4 @@ GNU General Public License for more details.
 You should have received a copy of the GNU General Public License
 along with this program; if not, write to the Free Software
 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+

data/Rakefile

@@ -1,20 +1,31 @@
-require 'rubygems'
-gem 'hoe', '>= 2.1.0'
-require 'hoe'
-require 'fileutils'
-require './lib/phidgets'
-
-Hoe.plugin :newgem
-
-# Generate all the Rake tasks
-# Run 'rake -T' to see list of generated tasks (from gem root directory)
-$hoe = Hoe.spec 'phidgets' do
-  self.developer 'Craig DeHaan', 'craig.s.dehaan@gmail.com'
-  self.post_install_message = 'PostInstall.txt'
-  self.rubyforge_name       = self.name
-
-end
-
-require 'newgem/tasks'
-Dir['tasks/**/*.rake'].each { |t| load t }
-
+# -*- ruby -*-
+
+require 'rubygems'
+require 'rake/extensiontask'
+require 'rake/packagetask'
+require 'rdoc/task'
+
+spec = Gem::Specification.load('phidgets.gemspec')
+
+Rake::ExtensionTask.new 'phidgets', spec
+
+Gem::PackageTask.new(spec) do |pkg|
+  
+
+end
+
+RDOC_FILES = FileList["README.rdoc", "ext/phidgets/*.c", "lib/phidgets/*.rb"]
+
+Rake::RDocTask.new do |rd|
+  rd.main = "README.rdoc"
+  rd.rdoc_dir = "doc/site/api"
+  rd.rdoc_files.include(RDOC_FILES)
+end
+
+Rake::RDocTask.new(:ri) do |rd|
+  rd.main = "README.rdoc"
+  rd.rdoc_dir = "doc/ri"
+  rd.options << "--ri-system"
+  rd.rdoc_files.include(RDOC_FILES)
+end
+

data/bin/phidget

@@ -12,27 +12,25 @@ def usage
   $stdout.puts
   $stdout.puts '  Examples:'
   $stdout.puts '    phidget list'
-  $stdout.puts '    phidget -1 setOutputState 0 1'
-  $stdout.puts '    phidget 34619 getDeviceName'
+  $stdout.puts '    phidget -1 set_output_state 0 1'
+  $stdout.puts '    phidget 34619 device_name'
 end
 
 begin
-  list = false
-  host = nil
-  id = nil
+  args = {:port => 5001, :password => ''}
 
   case ARGV[0]
   when /^(-1|\d+)$/
-    id = $1.to_i
+    args[:serial_number] = $1.to_i
   when /^(\w|.+):(-1|\d+)$/
-    host = $1
-    id = $2.to_i
+    args[:address] = $1
+    args[:serial_number] = $2.to_i
   when /^list$/i
-    list = true
+    args[:list] = true
   when /^(\w|.+)$/
     if ARGV[1].downcase == 'list'
-      list = true
-      host = $1
+      args[:list] = true
+      args[:address] = $1
     else
       raise "Invalid Arguments."
     end
@@ -41,58 +39,45 @@ begin
   end
 
   manager = Phidgets::Manager.new
+  manager.open(args)
 
-  if host
-    manager.openRemoteIP(host)
-  else
-    manager.open
-  end
+  # give the manager some time to find the devices
+  args[:address] ? sleep(2) : sleep(1)
 
-  devices = manager.getAttachedDevices
+  devices = manager.attached_devices
   manager.close
 
-  if devices.count == 0
-    $stdout.puts
-    $stdout.puts 'There are no phidgets attached.'
-    $stdout.puts
+  if devices.size == 0
+    $stdout.puts "\nThere are no phidgets attached.\n\n"
     exit
   end
 
-  if list
-    $stdout.puts
-    $stdout.puts "----------------------------------------------------------------------"
+  if args[:list]
+    $stdout.puts "\n----------------------------------------------------------------------"
     $stdout.puts "| SerialNumber          | Device Name                                |"
     $stdout.puts "----------------------------------------------------------------------"
     devices.each_pair { |serial,phidget|
+      phidget.open(args)
+      phidget.wait_for_attachment(2000)
       d_str = "| #{serial}"
-      d_str += " " * (24 - d_str.length)
-      d_str += "| #{phidget.getDeviceName}"
+      d_str += " " * (24 - d_str.length) + "| #{phidget.device_name}"
       d_str += " " * (69 - d_str.length) + "|"
       $stdout.puts d_str
+      phidget.close
     }
-    $stdout.puts "----------------------------------------------------------------------"
-    $stdout.puts
+    $stdout.puts "----------------------------------------------------------------------\n"
   
   else
-    phidget = id==-1 ? devices.first[1] :  devices[id]
-
-    $stdout.puts case ARGV.count
-    when 2
-      phidget.send(ARGV[1])
-    when 3
-      phidget.send(ARGV[1], ARGV[2])
-    when 4
-      phidget.send(ARGV[1], ARGV[2], ARGV[3])
-    else
-      raise "Invalid Arguments."
-    end
+    phidget = args[:serial_number] > 0 ? devices[args[:serial_number]] : devices.values[0]
+    args[:serial_number] = devices.keys[0] unless args[:serial_number] > 0
+    phidget.open(args)
+    phidget.wait_for_attachment(2000)
+    $stdout.puts eval("phidget.#{ARGV[1]}(#{ARGV[2..-1].join(',')})")
+    phidget.close
   end
 
 rescue SystemExit
 rescue Exception => e
-  $stdout.puts "#{e}\n#{e.backtrace.join("\n")}"
-  $stdout.puts
-  usage
-  $stdout.puts
+  $stdout.puts "#{e}\n#{e.backtrace.join("\n")}\n#{usage}\n"
 end
 

data/ext/phidgets/extconf.rb

@@ -0,0 +1,14 @@
+require 'mkmf'
+
+HEADER_DIRS = [ '/Library/Frameworks/Phidget21.framework/Headers' ]
+
+find_header 'phidget21.h', *HEADER_DIRS
+find_library 'libphidget21', 'CPhidget_getLibraryVersion', '/usr/lib/'
+have_framework('Phidget21') unless RUBY_VERSION < '1.9.0' 
+have_library('phidget21') 
+dir_config("phidgets")
+
+$CFLAGS += ' -DPH_CALLBACK' unless RUBY_VERSION < '1.9.0'
+
+create_makefile("phidgets")
+

data/ext/phidgets/phidgets.c

@@ -0,0 +1,272 @@
+
+#include "phidgets.h"
+
+
+VALUE ph_errors[PHIDGET_ERROR_CODE_COUNT+1];
+
+VALUE ph_get_library_version(VALUE self);
+VALUE ph_enable_logging(VALUE self, VALUE level, VALUE output_file);
+VALUE ph_disable_logging(VALUE self);
+VALUE ph_log(VALUE self, VALUE level, VALUE msg_id, VALUE message);
+
+
+
+void Init_phidgets() {
+  VALUE ph_module = rb_define_module("Phidgets");
+  VALUE ph_error;
+  VALUE ph_common;
+
+  rb_define_const(ph_module, "NOTATTACHED", INT2FIX(PHIDGET_NOTATTACHED));
+  rb_define_const(ph_module, "ATTACHED", INT2FIX(PHIDGET_ATTACHED));
+
+  rb_define_const(ph_module, "CLASS_ACCELEROMETER", INT2FIX(PHIDCLASS_ACCELEROMETER));
+  rb_define_const(ph_module, "CLASS_ADVANCEDSERVO", INT2FIX(PHIDCLASS_ADVANCEDSERVO));
+  rb_define_const(ph_module, "CLASS_ANALOG", INT2FIX(PHIDCLASS_ANALOG));
+  rb_define_const(ph_module, "CLASS_BRIDGE", INT2FIX(PHIDCLASS_BRIDGE));
+  rb_define_const(ph_module, "CLASS_ENCODER", INT2FIX(PHIDCLASS_ENCODER));
+  rb_define_const(ph_module, "CLASS_FREQUENCYCOUNTER", INT2FIX(PHIDCLASS_FREQUENCYCOUNTER));
+  rb_define_const(ph_module, "CLASS_GPS", INT2FIX(PHIDCLASS_GPS));
+  rb_define_const(ph_module, "CLASS_INTERFACEKIT", INT2FIX(PHIDCLASS_INTERFACEKIT));
+  rb_define_const(ph_module, "CLASS_IR", INT2FIX(PHIDCLASS_IR));
+  rb_define_const(ph_module, "CLASS_LED", INT2FIX(PHIDCLASS_LED));
+  rb_define_const(ph_module, "CLASS_MOTORCONTROL", INT2FIX(PHIDCLASS_MOTORCONTROL));
+  rb_define_const(ph_module, "CLASS_PHSENSOR", INT2FIX(PHIDCLASS_PHSENSOR));
+  rb_define_const(ph_module, "CLASS_RFID", INT2FIX(PHIDCLASS_RFID));
+  rb_define_const(ph_module, "CLASS_SERVO", INT2FIX(PHIDCLASS_SERVO));
+  rb_define_const(ph_module, "CLASS_SPATIAL", INT2FIX(PHIDCLASS_SPATIAL));
+  rb_define_const(ph_module, "CLASS_STEPPER", INT2FIX(PHIDCLASS_STEPPER));
+  rb_define_const(ph_module, "CLASS_TEMPERATURESENSOR", INT2FIX(PHIDCLASS_TEMPERATURESENSOR));
+  rb_define_const(ph_module, "CLASS_TEXTLCD", INT2FIX(PHIDCLASS_TEXTLCD));
+  rb_define_const(ph_module, "CLASS_TEXTLED", INT2FIX(PHIDCLASS_TEXTLED));
+  rb_define_const(ph_module, "CLASS_WEIGHTSENSOR", INT2FIX(PHIDCLASS_WEIGHTSENSOR));
+
+  rb_define_const(ph_module, "ID_ACCELEROMETER_3AXIS", INT2FIX(PHIDID_ACCELEROMETER_3AXIS));
+  rb_define_const(ph_module, "ID_ADVANCEDSERVO_1MOTOR", INT2FIX(PHIDID_ADVANCEDSERVO_1MOTOR));
+  rb_define_const(ph_module, "ID_ADVANCEDSERVO_8MOTOR", INT2FIX(PHIDID_ADVANCEDSERVO_8MOTOR));
+  rb_define_const(ph_module, "ID_ANALOG_4OUTPUT", INT2FIX(PHIDID_ANALOG_4OUTPUT));
+  rb_define_const(ph_module, "ID_BIPOLAR_STEPPER_1MOTOR", INT2FIX(PHIDID_BIPOLAR_STEPPER_1MOTOR));
+  rb_define_const(ph_module, "ID_BRIDGE_4INPUT", INT2FIX(PHIDID_BRIDGE_4INPUT));
+  rb_define_const(ph_module, "ID_ENCODER_1ENCODER_1INPUT", INT2FIX(PHIDID_ENCODER_1ENCODER_1INPUT));
+  rb_define_const(ph_module, "ID_ENCODER_HS_1ENCODER", INT2FIX(PHIDID_ENCODER_HS_1ENCODER));
+  rb_define_const(ph_module, "ID_ENCODER_HS_4ENCODER_4INPUT", INT2FIX(PHIDID_ENCODER_HS_4ENCODER_4INPUT));
+  rb_define_const(ph_module, "ID_FREQUENCYCOUNTER_2INPUT", INT2FIX(PHIDID_FREQUENCYCOUNTER_2INPUT));
+  rb_define_const(ph_module, "ID_GPS", INT2FIX(PHIDID_GPS));
+  rb_define_const(ph_module, "ID_INTERFACEKIT_0_0_4", INT2FIX(PHIDID_INTERFACEKIT_0_0_4));
+  rb_define_const(ph_module, "ID_INTERFACEKIT_0_0_8", INT2FIX(PHIDID_INTERFACEKIT_0_0_8));
+  rb_define_const(ph_module, "ID_INTERFACEKIT_0_16_16", INT2FIX(PHIDID_INTERFACEKIT_0_16_16));
+  rb_define_const(ph_module, "ID_INTERFACEKIT_2_2_2", INT2FIX(PHIDID_INTERFACEKIT_2_2_2));
+  rb_define_const(ph_module, "ID_INTERFACEKIT_8_8_8", INT2FIX(PHIDID_INTERFACEKIT_8_8_8));
+  rb_define_const(ph_module, "ID_INTERFACEKIT_8_8_8_w_LCD", INT2FIX(PHIDID_INTERFACEKIT_8_8_8_w_LCD));
+  rb_define_const(ph_module, "ID_IR", INT2FIX(PHIDID_IR));
+  rb_define_const(ph_module, "ID_LED_64_ADV", INT2FIX(PHIDID_LED_64_ADV));
+  rb_define_const(ph_module, "ID_LINEAR_TOUCH", INT2FIX(PHIDID_LINEAR_TOUCH));
+  rb_define_const(ph_module, "ID_MOTORCONTROL_1MOTOR", INT2FIX(PHIDID_MOTORCONTROL_1MOTOR));
+  rb_define_const(ph_module, "ID_MOTORCONTROL_HC_2MOTOR", INT2FIX(PHIDID_MOTORCONTROL_HC_2MOTOR));
+  rb_define_const(ph_module, "ID_RFID_2OUTPUT", INT2FIX(PHIDID_RFID_2OUTPUT));
+  rb_define_const(ph_module, "ID_RFID_2OUTPUT_READ_WRITE", INT2FIX(PHIDID_RFID_2OUTPUT_READ_WRITE));
+  rb_define_const(ph_module, "ID_ROTARY_TOUCH", INT2FIX(PHIDID_ROTARY_TOUCH));
+  rb_define_const(ph_module, "ID_SPATIAL_ACCEL_3AXIS", INT2FIX(PHIDID_SPATIAL_ACCEL_3AXIS));
+  rb_define_const(ph_module, "ID_SPATIAL_ACCEL_GYRO_COMPASS", INT2FIX(PHIDID_SPATIAL_ACCEL_GYRO_COMPASS));
+  rb_define_const(ph_module, "ID_TEMPERATURESENSOR", INT2FIX(PHIDID_TEMPERATURESENSOR));
+  rb_define_const(ph_module, "ID_TEMPERATURESENSOR_4", INT2FIX(PHIDID_TEMPERATURESENSOR_4));
+  rb_define_const(ph_module, "ID_TEMPERATURESENSOR_IR", INT2FIX(PHIDID_TEMPERATURESENSOR_IR));
+  rb_define_const(ph_module, "ID_TEXTLCD_2x20_w_8_8_8", INT2FIX(PHIDID_TEXTLCD_2x20_w_8_8_8));
+  rb_define_const(ph_module, "ID_TEXTLCD_ADAPTER", INT2FIX(PHIDID_TEXTLCD_ADAPTER));
+  rb_define_const(ph_module, "ID_UNIPOLAR_STEPPER_4MOTOR", INT2FIX(PHIDID_UNIPOLAR_STEPPER_4MOTOR));
+  rb_define_const(ph_module, "ID_ACCELEROMETER_2AXIS", INT2FIX(PHIDID_ACCELEROMETER_2AXIS));
+  rb_define_const(ph_module, "ID_INTERFACEKIT_0_8_8_w_LCD", INT2FIX(PHIDID_INTERFACEKIT_0_8_8_w_LCD));
+  rb_define_const(ph_module, "ID_INTERFACEKIT_4_8_8", INT2FIX(PHIDID_INTERFACEKIT_4_8_8));
+  rb_define_const(ph_module, "ID_LED_64", INT2FIX(PHIDID_LED_64));
+  rb_define_const(ph_module, "ID_MOTORCONTROL_LV_2MOTOR_4INPUT", INT2FIX(PHIDID_MOTORCONTROL_LV_2MOTOR_4INPUT));
+  rb_define_const(ph_module, "ID_PHSENSOR", INT2FIX(PHIDID_PHSENSOR));
+  rb_define_const(ph_module, "ID_RFID", INT2FIX(PHIDID_RFID));
+  rb_define_const(ph_module, "ID_SERVO_1MOTOR", INT2FIX(PHIDID_SERVO_1MOTOR));
+  rb_define_const(ph_module, "ID_SERVO_1MOTOR_OLD", INT2FIX(PHIDID_SERVO_1MOTOR_OLD));
+  rb_define_const(ph_module, "ID_SERVO_4MOTOR", INT2FIX(PHIDID_SERVO_4MOTOR));
+  rb_define_const(ph_module, "ID_SERVO_4MOTOR_OLD", INT2FIX(PHIDID_SERVO_4MOTOR_OLD));
+  rb_define_const(ph_module, "ID_TEXTLCD_2x20", INT2FIX(PHIDID_TEXTLCD_2x20));
+  rb_define_const(ph_module, "ID_TEXTLCD_2x20_w_0_8_8", INT2FIX(PHIDID_TEXTLCD_2x20_w_0_8_8));
+  rb_define_const(ph_module, "ID_TEXTLED_1x8", INT2FIX(PHIDID_TEXTLED_1x8));
+  rb_define_const(ph_module, "ID_TEXTLED_4x8", INT2FIX(PHIDID_TEXTLED_4x8));
+  rb_define_const(ph_module, "ID_WEIGHTSENSOR", INT2FIX(PHIDID_WEIGHTSENSOR));
+  rb_define_const(ph_module, "ID_FIRMWARE_UPGRADE", INT2FIX(PHIDID_FIRMWARE_UPGRADE));
+
+  rb_define_const(ph_module, "LOG_CRITICAL", INT2FIX(PHIDGET_LOG_CRITICAL));
+  rb_define_const(ph_module, "LOG_ERROR", INT2FIX(PHIDGET_LOG_ERROR));
+  rb_define_const(ph_module, "LOG_WARNING", INT2FIX(PHIDGET_LOG_WARNING));
+  rb_define_const(ph_module, "LOG_DEBUG", INT2FIX(PHIDGET_LOG_DEBUG));
+  rb_define_const(ph_module, "LOG_INFO", INT2FIX(PHIDGET_LOG_INFO));
+  rb_define_const(ph_module, "LOG_VERBOSE", INT2FIX(PHIDGET_LOG_VERBOSE));
+
+  ph_error = rb_define_class_under(ph_module, "Error", rb_eStandardError);
+  ph_errors[EPHIDGET_NOTFOUND] = rb_define_class_under(ph_error, "NotFound", ph_error);
+  ph_errors[EPHIDGET_NOMEMORY] = rb_define_class_under(ph_error, "NoMemory", ph_error);
+  ph_errors[EPHIDGET_UNEXPECTED] = rb_define_class_under(ph_error, "Unexpected", ph_error);
+  ph_errors[EPHIDGET_INVALIDARG] = rb_define_class_under(ph_error, "InvalidArg", ph_error);
+  ph_errors[EPHIDGET_NOTATTACHED] = rb_define_class_under(ph_error, "NotAttached", ph_error);
+  ph_errors[EPHIDGET_INTERRUPTED] = rb_define_class_under(ph_error, "Interrupted", ph_error);
+  ph_errors[EPHIDGET_INVALID] = rb_define_class_under(ph_error, "Invalid", ph_error);
+  ph_errors[EPHIDGET_NETWORK] = rb_define_class_under(ph_error, "Network", ph_error);
+  ph_errors[EPHIDGET_UNKNOWNVAL] = rb_define_class_under(ph_error, "UnknownVal", ph_error);
+  ph_errors[EPHIDGET_BADPASSWORD] = rb_define_class_under(ph_error, "BadPassword", ph_error);
+  ph_errors[EPHIDGET_UNSUPPORTED] = rb_define_class_under(ph_error, "Unsupported", ph_error);
+  ph_errors[EPHIDGET_DUPLICATE] = rb_define_class_under(ph_error, "Duplicate", ph_error);
+  ph_errors[EPHIDGET_TIMEOUT] = rb_define_class_under(ph_error, "Timeout", ph_error);
+  ph_errors[EPHIDGET_OUTOFBOUNDS] = rb_define_class_under(ph_error, "OutOfBounds", ph_error);
+  ph_errors[EPHIDGET_EVENT] = rb_define_class_under(ph_error, "Event", ph_error);
+  ph_errors[EPHIDGET_NETWORK_NOTCONNECTED] = rb_define_class_under(ph_error, "NetworkNotConnected", ph_error);
+  ph_errors[EPHIDGET_WRONGDEVICE] = rb_define_class_under(ph_error, "WrongDevice", ph_error);
+  ph_errors[EPHIDGET_CLOSED] = rb_define_class_under(ph_error, "Closed", ph_error);
+  ph_errors[EPHIDGET_BADVERSION] = rb_define_class_under(ph_error, "BadVersion", ph_error);
+  ph_errors[EPHIDGET_NOTIMPLEMENTED] = rb_define_class_under(ph_error, "NotImplemented", ph_error);
+
+  /*
+   * Document-method: getLibraryVersion
+   * call-seq: getLibraryVersion -> version
+   *
+   * Gets the library version. This contains a version number and a build date.
+   */
+  rb_define_singleton_method(ph_module, "getLibraryVersion", ph_get_library_version, 0);
+
+  /*
+   * Document-method: library_version
+   * call-seq: library_version -> version
+   *
+   * Gets the library version. This contains a version number and a build date.
+   */
+  rb_define_singleton_method(ph_module, "library_version", ph_get_library_version, 0);
+
+  /*
+   * Document-method: enableLogging
+   * call-seq: enableLogging(log_level, output_file)
+   *
+   * Enables logging.
+   */
+  rb_define_singleton_method(ph_module, "enableLogging", ph_enable_logging, 2);
+
+  /*
+   * Document-method: enable_logging
+   * call-seq: enable_logging(log_level, output_file)
+   *
+   * Enables logging.
+   */
+  rb_define_singleton_method(ph_module, "enable_logging", ph_enable_logging, 2);
+
+  /*
+   * Document-method: disableLogging
+   * call-seq: disableLogging
+   *
+   * Disables logging.
+   */
+  rb_define_singleton_method(ph_module, "disableLogging", ph_disable_logging, 0);
+
+  /*
+   * Document-method: disable_logging
+   * call-seq: disable_logging
+   *
+   * Disables logging.
+   */
+  rb_define_singleton_method(ph_module, "disable_logging", ph_disable_logging, 0);
+
+  /*
+   * Document-method: log
+   * call-seq: log(log_level, msg_id, msg)
+   *
+   * Appends a message to the log.
+   */
+  rb_define_singleton_method(ph_module, "log", ph_log, 3);
+
+  Init_phidgets_dictionary(ph_module);
+  Init_phidgets_manager(ph_module);
+  ph_common = Init_phidgets_common(ph_module);
+  Init_phidgets_accel(ph_module, ph_common);
+  Init_phidgets_advservo(ph_module, ph_common);
+  Init_phidgets_analog(ph_module, ph_common);
+  Init_phidgets_bridge(ph_module, ph_common);
+  Init_phidgets_encoder(ph_module, ph_common);
+  Init_phidgets_freq(ph_module, ph_common);
+  Init_phidgets_gps(ph_module, ph_common);
+  Init_phidgets_ifkit(ph_module, ph_common);
+  Init_phidgets_ir(ph_module, ph_common);
+  Init_phidgets_led(ph_module, ph_common);
+  Init_phidgets_motor_control(ph_module, ph_common);
+  Init_phidgets_phsensor(ph_module, ph_common);
+  Init_phidgets_rfid(ph_module, ph_common);
+  Init_phidgets_servo(ph_module, ph_common);
+  Init_phidgets_spatial(ph_module, ph_common);
+  Init_phidgets_stepper(ph_module, ph_common);
+  Init_phidgets_temp(ph_module, ph_common);
+  Init_phidgets_textlcd(ph_module, ph_common);
+  Init_phidgets_textled(ph_module, ph_common);
+  Init_phidgets_weight(ph_module, ph_common);
+}
+
+
+ph_data_t *get_ph_data(VALUE self) {
+  ph_data_t *ph;
+  Data_Get_Struct(self, ph_data_t, ph);
+  return ph;
+}
+
+CPhidgetHandle get_ph_handle(VALUE self) {
+  ph_data_t *ph = get_ph_data(self);
+  return ph->handle;
+}
+
+void ph_raise(int err_code) {
+  if(err_code > EPHIDGET_OK && err_code < PHIDGET_ERROR_CODE_COUNT) {
+    const char *err_description;
+    CPhidget_getErrorDescription(err_code, &err_description);
+    rb_raise(ph_errors[err_code], err_description);
+  }
+  if(err_code == EPHIDGET_NOTIMPLEMENTED) {
+    rb_raise(ph_errors[EPHIDGET_NOTIMPLEMENTED], "This functionality has not been implemented yet");
+  }
+}
+
+VALUE ph_get_library_version(VALUE self) {
+  const char *lib_version;
+  ph_raise(CPhidget_getLibraryVersion(&lib_version));
+  return rb_str_new2(lib_version);
+}
+
+VALUE ph_enable_logging(VALUE self, VALUE level, VALUE output_file) {
+  ph_raise(CPhidget_enableLogging(FIX2INT(level), StringValueCStr(output_file)));
+  return Qnil;
+}
+
+VALUE ph_disable_logging(VALUE self) {
+  ph_raise(CPhidget_disableLogging());
+  return Qnil;
+}
+
+VALUE ph_log(VALUE self, VALUE level, VALUE msg_id, VALUE message) {
+  ph_raise(CPhidget_log(FIX2INT(level), StringValueCStr(msg_id), StringValueCStr(message)));
+  return Qnil;
+}
+
+
+#ifdef PH_CALLBACK
+void ph_callback_thread(ph_callback_data_t *callback_data) {
+  while(! callback_data->exit) {
+    rb_thread_blocking_region(wait_for_callback, (void *)callback_data, cancel_wait_for_callback, (void *)callback_data);
+    if(TYPE(callback_data->callback) != T_NIL) rb_funcall(callback_data->callback, rb_intern("call"), 1, callback_data->phidget);
+    callback_data->called = false;
+  };
+}
+
+VALUE wait_for_callback(void *arg) {
+  ph_callback_data_t *callback_data = (ph_callback_data_t *)arg;
+  while(! callback_data->exit) {
+    usleep(PH_CALLBACK_POLLING_INTERVAL);
+    if(callback_data->called) return Qnil;
+  };
+  return Qnil;
+}
+
+void cancel_wait_for_callback(void *arg) {
+  ph_callback_data_t *callback_data = (ph_callback_data_t *)arg;
+  callback_data->exit = true;
+}
+#endif
+

data/ext/phidgets/phidgets.h

@@ -0,0 +1,82 @@
+#include <stdio.h>
+#include <stdbool.h>
+#include <math.h>
+#include <time.h>
+#include <unistd.h>
+
+#include <ruby.h>
+#include <phidget21.h>
+
+#ifndef _PHIDGETS_EXT_
+#define _PHIDGETS_EXT_
+
+
+#define PH_CALLBACK_POLLING_INTERVAL   100000
+#define EPHIDGET_NOTIMPLEMENTED        PHIDGET_ERROR_CODE_COUNT
+
+
+#ifdef PH_CALLBACK
+typedef struct ph_callback_data {
+  volatile bool called;
+  volatile bool exit;
+  VALUE phidget;
+  VALUE callback;
+} ph_callback_data_t;
+
+void ph_callback_thread(ph_callback_data_t *callback_data);
+VALUE wait_for_callback(void *arg);
+void cancel_wait_for_callback(void *arg);
+#endif
+
+
+typedef struct ph_data {
+  CPhidgetHandle handle;
+#ifdef PH_CALLBACK
+  ph_callback_data_t attach_callback;
+  ph_callback_data_t detach_callback;
+  ph_callback_data_t server_connect_callback;
+  ph_callback_data_t server_disconnect_callback;
+  ph_callback_data_t dev_callback_1;
+  ph_callback_data_t dev_callback_2;
+  ph_callback_data_t dev_callback_3;
+  ph_callback_data_t dev_callback_4;
+  ph_callback_data_t dev_callback_5;
+  ph_callback_data_t dev_callback_6;
+  ph_callback_data_t dev_callback_7;
+  ph_callback_data_t dev_callback_8;
+#endif
+} ph_data_t;
+
+
+void Init_phidgets();
+VALUE Init_phidgets_dictionary(VALUE ph_module);
+VALUE Init_phidgets_manager(VALUE ph_module);
+VALUE Init_phidgets_common(VALUE ph_module);
+VALUE Init_phidgets_accel(VALUE ph_module, VALUE ph_common);
+VALUE Init_phidgets_advservo(VALUE ph_module, VALUE ph_common);
+VALUE Init_phidgets_analog(VALUE ph_module, VALUE ph_common);
+VALUE Init_phidgets_bridge(VALUE ph_module, VALUE ph_common);
+VALUE Init_phidgets_encoder(VALUE ph_module, VALUE ph_common);
+VALUE Init_phidgets_freq(VALUE ph_module, VALUE ph_common);
+VALUE Init_phidgets_gps(VALUE ph_module, VALUE ph_common);
+VALUE Init_phidgets_ifkit(VALUE ph_module, VALUE ph_common);
+VALUE Init_phidgets_ir(VALUE ph_module, VALUE ph_common);
+VALUE Init_phidgets_led(VALUE ph_module, VALUE ph_common);
+VALUE Init_phidgets_motor_control(VALUE ph_module, VALUE ph_common);
+VALUE Init_phidgets_phsensor(VALUE ph_module, VALUE ph_common);
+VALUE Init_phidgets_rfid(VALUE ph_module, VALUE ph_common);
+VALUE Init_phidgets_servo(VALUE ph_module, VALUE ph_common);
+VALUE Init_phidgets_spatial(VALUE ph_module, VALUE ph_common);
+VALUE Init_phidgets_stepper(VALUE ph_module, VALUE ph_common);
+VALUE Init_phidgets_temp(VALUE ph_module, VALUE ph_common);
+VALUE Init_phidgets_textlcd(VALUE ph_module, VALUE ph_common);
+VALUE Init_phidgets_textled(VALUE ph_module, VALUE ph_common);
+VALUE Init_phidgets_weight(VALUE ph_module, VALUE ph_common);
+
+
+ph_data_t *get_ph_data(VALUE self);
+CPhidgetHandle get_ph_handle(VALUE self);
+void ph_raise(int err_code);
+
+#endif
+