phidgets-ffi 0.0.3

data/.gitignore

@@ -0,0 +1,3 @@
+pkg/*
+*.gem
+.bundle

data/Gemfile

@@ -0,0 +1,4 @@
+source :gemcutter
+
+# Specify your gem's dependencies in phidgets-ffi.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,9 @@
+Copyright (c) 2011, Kelley Reynolds
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+Neither the name of the Inside Systems, Inc. nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.rdoc

@@ -0,0 +1,59 @@
+=Phidgets-FFI
+
+This is a set of FFI bindings for the Phidgets21 library. Like every library, it only
+supports the devices that I needed it to but it supports them completely. There is a
+manager instance that lists attached devices, callbacks function perfectly, and there
+are a set of idiomatic bindings that take the FFI and make it more accessible. Raw FFI
+examples are in examples/ffi and the idiomatic versions are in examples/.
+
+==Quick Start
+
+To access the manager and see your attached devices:
+
+  Phidgets::Manager.new do |manager|
+    puts manager.devices.inspect
+  end
+  
+  [{
+    :type=>"PhidgetServo",
+    :label=>"",
+    :device_id=>:servo_1motor,
+    :serial_number=>12345,
+    :name=>"Phidget Servo Controller 1-motor",
+    :device_class=>:servo,
+    :version=>313
+  }]
+
+To access that servo controller and do something with the servo:
+
+  Phidgets::ServoController.new(12345) do |controller|
+    servo = controller.servos[0]
+
+    controller.on_change do |servo, position, data|
+      print "Moving servo #{servo.index} to #{position}\n"
+    end
+  
+    max = servo.max
+    10.times do
+      servo.position = rand(max)
+      sleep 1
+    end
+    servo.engaged = false
+  end
+
+==Logging
+
+Logging can be accomplished by either accessing the C library directly or using the idiomatic method.
+There are additional examples of each in the examples/ directory.
+
+  Phidgets::Log.enable(:verbose, nil)
+  Phidgets::Log.info('identifier', 'message')
+  Phidgets::Log.error('identifier', 'message')
+  Phidgets::Log.disable
+
+==Notes
+
+Again, note that not every device is here. I'm more than happy to add support for it
+but I'll need a test device to make sure it works ;)
+
+PS. I'm serious, contact me if you want my mailing address.

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/examples/ffi/dictionary.rb

@@ -0,0 +1,59 @@
+require 'rubygems'
+require 'phidgets-ffi'
+
+include Phidgets::FFI
+Phidgets::Log.enable(:verbose)
+
+pattern = ".*"
+key_listener = FFI::MemoryPointer.new(:pointer)
+
+KeyChangedHandler = Proc.new { |dict, obj_ptr, key, value, reason|
+  print "Keychange { #{key} => #{value}, reason => '#{reason}'}\n"
+}
+ErrorHandler = Proc.new { |dict, obj_ptr, code, reason|
+  print "Error (#{code}): #{reason} \n"
+}
+ServerConnectedHandler = Proc.new { |dict, obj_ptr|
+  print "Server connected\n"
+  CPhidgetDictionary_set_OnKeyChange_Handler(dict, key_listener, pattern, KeyChangedHandler, nil);
+}
+ServerDisconnectedHandler = Proc.new { |dict, obj_ptr|
+  print "Server disconnected\n"
+  CPhidgetDictionary_remove_OnKeyChange_Handler(key_listener.get_pointer(0))
+}
+
+ptr = FFI::MemoryPointer.new(:pointer)
+CPhidgetDictionary.create(ptr)
+dictionary = ptr.get_pointer(0)
+CPhidget_set_OnServerConnect_Handler(dictionary, ServerConnectedHandler, nil)
+CPhidget_set_OnServerDisconnect_Handler(dictionary, ServerDisconnectedHandler, nil)
+CPhidget_set_OnError_Handler(dictionary, ErrorHandler, nil)
+
+server_status = FFI::MemoryPointer.new(:int)
+address = FFI::MemoryPointer.new(:string)
+port = FFI::MemoryPointer.new(:int)
+result = CPhidgetDictionary_openRemoteIP(dictionary, "Mactop.local", 5001, nil);
+while server_status.get_int(0) != 1
+  CPhidgetDictionary_getServerStatus(dictionary, server_status)
+end
+print "Attached to server\n"
+
+CPhidgetDictionary_getServerAddress(dictionary, address, port)
+printf "Address: %s -- Port: %i \n", address.get_pointer(0).read_string, port.get_int(0)
+
+#	Set some keys
+sleep 1
+CPhidgetDictionary_addKey(dictionary, "TEST1", "1234", 1)
+CPhidgetDictionary_addKey(dictionary, "TEST2", "5678", 1);
+CPhidgetDictionary_addKey(dictionary, "TEST3", "9012", 0);
+CPhidgetDictionary_addKey(dictionary, "TEST4", "3456", 1);
+sleep 2
+puts "Delete the 4th key...."
+sleep 1
+CPhidgetDictionary_removeKey(dictionary, "TEST4")
+sleep 2
+puts "Press any key to end"
+$stdin.getc
+CPhidgetDictionary_close(dictionary);
+CPhidgetDictionary_delete(dictionary);
+sleep 10

data/examples/ffi/interface_kit.rb

@@ -0,0 +1,44 @@
+require 'rubygems'
+require 'phidgets-ffi'
+
+def device_name_for(device)
+  ptr = FFI::MemoryPointer.new(:string, 1)
+  CPhidget_getDeviceName(device, ptr)
+  strPtr = ptr.get_pointer(0)
+  strPtr.null? ? nil : strPtr.read_string
+end
+
+def serial_number_for(device)
+  ptr = FFI::MemoryPointer.new(:int, 1)
+  CPhidget_getSerialNumber(device, ptr)
+  ptr.get_int(0)
+end
+
+include Phidgets::FFI
+
+ifkit = FFI::MemoryPointer.new(:pointer, 1)
+if !(res = CPhidgetInterfaceKit_create(ifkit))
+  $stderr.puts "Unable to create interface kit"
+  exit!(res)
+else
+  ifkit = ifkit.get_pointer(0)
+end
+
+# Create an attachment and detachment handler
+AttachHandler = Proc.new { |device, ptr|
+  print "Device attached: #{device_name_for(device)} (#{serial_number_for(device)})\n"
+}
+CPhidget_set_OnAttach_Handler(ifkit, AttachHandler, nil)
+DetachHandler = Proc.new { |device, ptr|
+  print "Device detached: #{device_name_for(device)} (#{serial_number_for(device)})\n"
+}
+CPhidget_set_OnDetach_Handler(ifkit, DetachHandler, nil)
+
+CPhidget_open(ifkit, -1)
+CPhidget_waitForAttachment(ifkit, 10000)
+
+print "You have 20 seconds to attach/detach the interface kit. It should activate the callback handlers\n"
+sleep 20
+
+CPhidget_close(ifkit)
+CPhidget_delete(ifkit)

data/examples/ffi/library_version.rb

@@ -0,0 +1,11 @@
+require 'rubygems'
+require 'phidgets-ffi'
+
+ptr = FFI::MemoryPointer.new(:string, 1)
+if !(res = Phidgets::FFI::CPhidget_getLibraryVersion(ptr))
+  $stderr.puts "Unable to get library version"
+  exit!(res)
+else
+  puts ptr.get_pointer(0).read_string
+end
+

data/examples/ffi/log.rb

@@ -0,0 +1,11 @@
+require 'rubygems'
+require 'phidgets-ffi'
+
+include Phidgets::FFI
+
+# Will print a line or two to stdout
+Log.enableLogging(:verbose, nil)
+Log.log(:info, 'identifier', 'arbitrary message')
+Log.log(:info, 'identifier', 'arbitrary with a string: %s', "foo")
+Log.log(:info, 'identifier', 'arbitrary with an integer: %i', 123)
+Log.log(:info, 'identifier', 'arbitrary with an integer: %10.2e', 123.123)

data/examples/ffi/manager.rb

@@ -0,0 +1,35 @@
+require 'rubygems'
+require 'phidgets-ffi'
+
+include Phidgets::FFI
+ptr = FFI::MemoryPointer.new(:pointer, 1)
+CPhidgetManager.create(ptr)
+manager = ptr.get_pointer(0)
+CPhidgetManager.open(manager)
+
+sleep(1)
+devices_ptr, count = FFI::MemoryPointer.new(:pointer, 1), FFI::MemoryPointer.new(:int)
+CPhidgetManager.getAttachedDevices(manager, devices_ptr, count)
+devices = devices_ptr.get_array_of_pointer(0, count.get_int(0))
+
+ptr1 = FFI::MemoryPointer.new(:string)
+ptr2 = FFI::MemoryPointer.new(:int)
+devices.each_with_index do |device, i|
+  device = device.get_pointer(0)
+
+  Common.getDeviceName(device, ptr1)
+  name =  ptr1.get_pointer(0).read_string
+
+  Common.getSerialNumber(device, ptr2)
+  serial_number = ptr2.get_int(0)
+  
+  Common.getDeviceVersion(device, ptr2)
+  version = ptr2.get_int(0)
+  
+  print "Device #{i+1}: #{name} v#{version} - Serial Number #{serial_number}\n"
+end
+
+CPhidgetManager.freeAttachedDevicesArray(devices_ptr.get_pointer(0))
+
+CPhidgetManager.close(manager)
+CPhidgetManager.delete(manager)

data/examples/ffi/servo.rb

@@ -0,0 +1,67 @@
+require 'rubygems'
+require 'phidgets-ffi'
+
+include Phidgets::FFI
+
+f = FFI::MemoryPointer.new(:pointer, 1)
+if !(res = Phidgets::FFI::CPhidgetServo.create(f))
+  $stderr.puts "Unable to create servo"
+  exit!(res)
+else
+  servo = f.get_pointer(0)
+end
+f = nil
+def device_name_for(device)
+  ptr = FFI::MemoryPointer.new(:string, 1)
+  CPhidget_getDeviceName(device, ptr)
+  strPtr = ptr.get_pointer(0)
+  strPtr.null? ? nil : strPtr.read_string
+end
+
+def serial_number_for(device)
+  ptr = FFI::MemoryPointer.new(:int, 1)
+  CPhidget_getSerialNumber(device, ptr)
+  ptr.get_int(0)
+end
+
+# Create an attachment and detachment handler
+AttachHandler = Proc.new { |device, ptr|
+  print "Device attached: #{device_name_for(device)} (#{serial_number_for(device)})\n"
+  tmp = FFI::MemoryPointer.new(:double)
+  CPhidgetServo_getPositionMax(device, 0, tmp)
+  print "Max: #{tmp.get_double(0)}\n"
+  CPhidgetServo_getPositionMin(device, 0, tmp)
+  print "Min: #{tmp.get_double(0)}\n"
+}
+CPhidget_set_OnAttach_Handler(servo, AttachHandler, nil)
+DetachHandler = Proc.new { |device, ptr|
+  print "Device detached: #{device_name_for(device)} (#{serial_number_for(device)})\n"
+}
+CPhidget_set_OnDetach_Handler(servo, DetachHandler, nil)
+
+PositionChangeHandler = Proc.new { |device, ptr, index, position|
+  print "Moving motor #{index} to #{position}\n"
+}
+CPhidgetServo_set_OnPositionChange_Handler(servo, PositionChangeHandler, nil)
+
+CPhidget_open(servo, -1)
+CPhidget_waitForAttachment(servo, 10000)
+
+ptr = FFI::MemoryPointer.new(:int)
+exit! if CPhidgetServo_getEngaged(servo, 0, ptr) != 0
+#CPhidgetServo_setEngaged(servo, 0, 1)
+
+CPhidgetServo_getServoType(servo, 0, ptr)
+print "Servo Type: #{ServoType[ptr.get_int(0)]}\n"
+
+tmp = FFI::MemoryPointer.new(:double)
+CPhidgetServo_getPositionMax(servo, 0, tmp)
+max = tmp.get_double(0)
+10.times do
+  CPhidgetServo_setPosition(servo, 0, rand(max))
+  sleep 1
+end
+
+CPhidgetServo_setEngaged(servo, 0, 0)
+CPhidget_close(servo)
+CPhidget_delete(servo)

data/examples/interface_kit.rb

@@ -0,0 +1,20 @@
+require 'rubygems'
+require 'phidgets-ffi'
+
+puts "Library Version: #{Phidgets::FFI.library_version}"
+Phidgets::InterfaceKit.new(-1) do |ifkit|
+  puts "Device attributes: #{ifkit.attributes.inspect}"
+
+  ifkit.on_output_change do |output, state, obj|
+    print "Output #{output.index} has changed to #{state}\n"
+  end
+
+  ifkit.wait_for_attachment
+  ifkit.outputs[0].state = true
+  ifkit.outputs[0].state = false
+  
+  puts ifkit.sensors[0].inspect
+  ifkit.sensors[0].rate = 64
+  ifkit.sensors[0].trigger = 20
+  puts ifkit.sensors[0].inspect
+end

data/examples/log.rb

@@ -0,0 +1,9 @@
+require 'rubygems'
+require 'phidgets-ffi'
+
+# Will print a line or two to stdout
+Phidgets::Log.enable(:verbose)
+Phidgets::Log.info('identifier', 'arbitrary message')
+Phidgets::Log.warning('identifier', 'arbitrary with a string: %s', "foo")
+Phidgets::Log.error('identifier', 'arbitrary with an integer: %i', 123)
+Phidgets::Log.verbose('identifier', 'arbitrary with an integer: %10.2e', 123.123)

data/examples/manager.rb

@@ -0,0 +1,17 @@
+require 'rubygems'
+require 'phidgets-ffi'
+
+Phidgets::Manager.new do |manager|
+  puts manager.devices.inspect
+
+  manager.on_attach do |device_ptr|
+    puts "Attaching #{device_ptr}"
+  end
+
+  manager.on_detach do |device_ptr|
+    puts "Detaching #{device_ptr}"
+  end
+  
+  puts "You have 20 seconds to plug/unplug USB devices and watch the callbacks execute"
+  sleep 20
+end

data/examples/servo.rb

@@ -0,0 +1,36 @@
+require 'rubygems'
+require 'phidgets-ffi'
+
+puts "Library Version: #{Phidgets::FFI.library_version}"
+Phidgets::ServoController.new(-1) do |controller|
+  puts "Device Attributes: #{controller.attributes.inspect}"
+  servo = controller.servos[0]
+  puts "Current Type: #{servo.type}"
+  puts "Default Min/Max: #{servo.min}/#{servo.max}"
+  puts "Device Name: #{controller.name}"
+  puts "Device Type: #{controller.type}"
+  puts "Device SN: #{controller.serial_number}"
+  puts "Device Version: #{controller.version}"
+
+  puts "Device Label: #{controller.label}"
+  controller.on_change do |servo, position, obj|
+    print "Moving servo #{servo.index} to #{position}\n"
+  end
+  
+  controller.on_detach do |obj, data|
+    print "Detached #{obj.type}\n"
+  end
+
+  controller.on_attach do |obj, data|
+    print "Attached #{obj.type}\n"
+  end
+
+  max = servo.max
+  10.times do
+    controller.wait_for_attachment
+    servo.position = rand(max)
+    sleep 0.5
+  end
+  servo.engaged = false
+end
+

data/lib/phidgets-ffi.rb

@@ -0,0 +1,17 @@
+require 'ffi'
+require 'phidgets-ffi/phidgets-ffi'
+require 'phidgets-ffi/ffi/core_ext'
+require 'phidgets-ffi/ffi/constants'
+require 'phidgets-ffi/ffi/common'
+require 'phidgets-ffi/ffi/dictionary'
+require 'phidgets-ffi/ffi/manager'
+require 'phidgets-ffi/ffi/log'
+require 'phidgets-ffi/ffi/servo'
+require 'phidgets-ffi/ffi/interface_kit'
+
+require 'phidgets-ffi/common'
+require 'phidgets-ffi/log'
+require 'phidgets-ffi/error'
+require 'phidgets-ffi/manager'
+require 'phidgets-ffi/servo'
+require 'phidgets-ffi/interface_kit'

data/lib/phidgets-ffi/common.rb

@@ -0,0 +1,222 @@
+module Phidgets
+  module FFI
+    def self.library_version
+      ptr = ::FFI::MemoryPointer.new(:string)
+      Phidgets::FFI::Common.getLibraryVersion(ptr)
+      strPtr = ptr.get_pointer(0)
+      strPtr.null? ? nil : strPtr.read_string
+    end
+
+    def self.error_description(code)
+      ptr = ::FFI::MemoryPointer.new(:string)
+      Phidgets::FFI::Common.getErrorDescription(code, ptr)
+      strPtr = ptr.get_pointer(0)
+      strPtr.null? ? nil : strPtr.read_string
+    end
+  end
+
+  module Utility
+    private
+    def object_for(obj_ptr)
+      (obj_ptr.null? ? nil : ObjectSpace._id2ref(obj_ptr.get_uint(0)))
+    end
+
+    def pointer_for(obj)
+      ::FFI::MemoryPointer.new(:uint).write_uint(obj.object_id)
+    end
+  end
+
+  module Common
+    include Utility
+
+    def create
+      ptr = ::FFI::MemoryPointer.new(:pointer, 1)
+      self.class::Klass.create(ptr)        
+      @handle = ptr.get_pointer(0)
+      true
+    end
+
+    def open(serial_number=-1)
+      Phidgets::FFI::Common.open(@handle, serial_number)
+      true
+    end
+    
+    def open_label(str)
+      Phidgets::FFI::Common.openLabel(@handle, str)
+      true
+    end
+    
+    def close
+      Phidgets::FFI::Common.close(@handle)
+      true
+    end
+
+    def delete
+      Phidgets::FFI::Common.delete(@handle)
+      true
+    end
+    
+    def wait_for_attachment(milliseconds=10000)
+      Phidgets::FFI::Common.waitForAttachment(@handle, milliseconds)
+      true
+    end
+    
+    def self.name(handle)
+      ptr = ::FFI::MemoryPointer.new(:string)
+      Phidgets::FFI::Common.getDeviceName(handle, ptr)
+      strPtr = ptr.get_pointer(0)
+      strPtr.null? ? nil : strPtr.read_string
+    end
+    def name; Common.name(@handle); end
+
+    def self.serial_number(handle)
+      ptr = ::FFI::MemoryPointer.new(:int)
+      Phidgets::FFI::Common.getSerialNumber(handle, ptr)
+      ptr.get_int(0)
+    end
+    def serial_number; Common.serial_number(@handle); end
+
+    def self.version(handle)
+      ptr = ::FFI::MemoryPointer.new(:int)
+      Phidgets::FFI::Common.getDeviceVersion(handle, ptr)
+      ptr.get_int(0)
+    end
+    def version; Common.version(@handle); end
+
+    def attached?
+      ptr = ::FFI::MemoryPointer.new(:int)
+      Phidgets::FFI::Common.getDeviceStatus(@handle, ptr)
+      (ptr.get_int(0) == 0) ? false : true
+    end
+    
+    def detached?
+      !attached?
+    end
+
+    def self.type(handle)
+      ptr = ::FFI::MemoryPointer.new(:string)
+      Phidgets::FFI::Common.getDeviceType(handle, ptr)
+      strPtr = ptr.get_pointer(0)
+      strPtr.null? ? nil : strPtr.read_string
+    end
+    def type; Common.type(@handle); end
+
+    def self.label(handle)
+      ptr = ::FFI::MemoryPointer.new(:string)
+      Phidgets::FFI::Common.getDeviceLabel(handle, ptr)
+      strPtr = ptr.get_pointer(0)
+      strPtr.null? ? nil : strPtr.read_string
+    end
+    def label; Common.label(@handle); end
+
+    def label=(new_label)
+      Phidgets::FFI::Common.setDeviceLabel(@handle, new_label)
+      new_label
+    end
+    
+    def server_id
+      ptr = ::FFI::MemoryPointer.new(:string)
+      Phidgets::FFI::Common.getServerID(@handle, ptr)
+      strPtr = ptr.get_pointer(0)
+      strPtr.null? ? nil : strPtr.read_string
+    end
+    
+    def server_address
+      str_ptr, int_ptr = ::FFI::MemoryPointer.new(:string), ::FFI::MemoryPointer.new(:int)
+      Phidgets::FFI::Common.getServerID(@handle, str_ptr, int_ptr)
+      strPtr = str_ptr.get_pointer(0)
+      address = (strPtr.null? ? nil : strPtr.read_string)
+      port = int_ptr.get_int(0)
+      [address, port]
+    end
+    
+    def server_status
+      ptr = ::FFI::MemoryPointer.new(:int)
+      Phidgets::FFI::Common.getServerStatus(@handle, ptr)
+      ptr.get_int(0)
+    end
+    
+    def self.device_id(handle)
+      ptr = ::FFI::MemoryPointer.new(:int)
+      Phidgets::FFI::Common.getDeviceID(handle, ptr)
+      Phidgets::FFI::DeviceID[ptr.get_int(0)]
+    end
+    def device_id; Common.device_id(@handle); end
+    
+    def self.device_class(handle)
+      ptr = ::FFI::MemoryPointer.new(:int)
+      Phidgets::FFI::Common.getDeviceClass(handle, ptr)
+      Phidgets::FFI::DeviceClass[ptr.get_int(0)]
+    end
+    def device_class; Common.device_class(@handle); end
+    
+    def on_attach(obj=nil, &block)
+      @on_attach_obj = obj
+      @on_attach = Proc.new { |handle, obj_ptr|
+        yield self, object_for(obj_ptr)
+      }
+      Phidgets::FFI::Common.set_OnAttach_Handler(@handle, @on_attach, pointer_for(obj))
+    end
+
+    def on_detach(obj=nil, &block)
+      @on_detach_obj = obj
+      @on_detach = Proc.new { |handle, obj_ptr|
+        yield self, object_for(obj_ptr)
+      }
+      Phidgets::FFI::Common.set_OnDetach_Handler(@handle, @on_detach, pointer_for(obj))
+    end
+
+    def on_server_connect(obj=nil, &block)
+      @on_server_connect_obj = obj
+      @on_server_connect = Proc.new { |handle, obj_ptr|
+        yield self, object_for(obj_ptr)
+      }
+      Phidgets::FFI::Common.set_OnServerConnect_Handler(@handle, @on_server_connect, pointer_for(obj))
+    end
+
+    def on_server_disconnect(obj=nil, &block)
+      @on_server_disconnect_obj = obj
+      @on_server_disconnect = Proc.new { |handle, obj_ptr|
+        yield self, object_for(obj_ptr)
+      }
+      Phidgets::FFI::Common.set_OnServerDisconnect_Handler(@handle, @on_server_disconnect, pointer_for(obj))
+    end
+
+    def on_error(obj=nil, &block)
+      @on_error_obj = obj
+      @on_error = Proc.new { |handle, obj_ptr, code, description|
+        yield self, object_for(obj_ptr), code, description
+      }
+      Phidgets::FFI::Common.set_OnError_Handler(@handle, @on_error, pointer_for(obj))
+    end
+
+    def on_sleep(obj=nil, &block)
+      @on_sleep_obj = obj
+      @on_sleep = Proc.new { |obj_ptr|
+        yield object_for(obj_ptr)
+      }
+      Phidgets::FFI::Common.set_OnWillSleep_Handler(@on_sleep, pointer_for(obj))
+    end
+
+    def on_wake(obj=nil, &block)
+      @on_wake_obj = obj
+      @on_wake = Proc.new { |obj_ptr|
+        yield object_for(obj_ptr)
+      }
+      Phidgets::FFI::Common.set_OnWakeup_Handler(@on_wake, pointer_for(obj))
+    end
+    
+    def self.attributes(handle)
+      {
+        :type => type(handle),
+        :name => name(handle),
+        :serial_number => serial_number(handle),
+        :version => version(handle),
+        :label => label(handle),
+        :device_class => device_class(handle),
+        :device_id => device_id(handle),
+      }
+    end
+    def attributes; Common.attributes(@handle); end
+  end
+end