phidgets_native 0.2.0 → 0.2.1

data/README.rdoc

@@ -167,10 +167,16 @@ by the Phidget API and/or hardware.
 ==Logging
 The phidget api has built in debug logging which can be enabled on a global basis
 for all devices. By default, logs are sent to STDOUT, but you can optionally 
-pass a path to a text file where output can alternatively be redirected. You can
-also send your own messages to the logger, if you think you have something you
-need to add.
-
+pass a path to a text file where output can alternatively be redirected. 
   PhidgetsNative.enable_logging!(:verbose)
   PhidgetsNative.log :info, "My favorite color is chartreuse"
   PhidgetsNative.disable_logging!
+Note that you can also use the log method to send your own messages to the logger,
+if you think you have something you need to add.
+
+=Changelog
+== Version 0.2.1
+- Added dual-ratiometric mode features and interfaces to the InterfaceKit
+
+== Version 0.2.0
+- First gem release, supporting all api functions of the Spatial, GPS, InterfaceKit, & AdvancedServo phidgets

data/examples/interface_kit-dualratiometric.rb

@@ -0,0 +1,50 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+
+require '%s/lib/common' % File.dirname(__FILE__)
+
+#PhidgetsNative.enable_logging! :verbose
+
+additional_attribs = [
+  %w(Digital\ Inputs input_count),
+  %w(Digital\ Outputs output_count),
+  %w(Analog\ Inputs sensor_count),
+  %w(Change\ Triggers change_triggers),
+  %w(Data\ Rates data_rates),
+  %w(Data\ Rates\ Min data_rates_min),
+  %w(Data\ Rates\ Max data_rates_max)
+]
+
+phidgets_example_for(PhidgetsNative::InterfaceKit, additional_attribs) do |ifkit|
+
+  ifkit.ratiometric = true
+  ifkit.ratiometric 6, false
+  ifkit.ratiometric 7, false
+
+  # Test sensor_raw
+  puts "Ratiometric states:"
+  ConsoleTable.new((0...ifkit.sensor_count).collect{|i| "Sensor #{i}"}).output do 
+    [(0...ifkit.sensor_count).collect{|i| ifkit.ratiometric(i).inspect } ]
+  end
+
+  puts "\nPolled Values:"
+  i = 0
+  ConsoleTable.new([
+    'Sensor Sample Rates',
+    '%-40s' % 'sensors', 
+  ]).output(:header => (i == 0), :separator => false) do |columns|
+    i+=1
+    
+    values = ifkit.sensors
+    if values
+      values[0] = '%.1f %% (RH)' % [values[0].to_f * 0.1906 - 40.2]
+      values[1] = '%.1f deg (C)' % [values[1].to_f * 0.22222 - 61.111]
+      values[2] = '%.1f deg (C)' % [values[2].to_f * 0.22222 - 61.111]
+
+      values[6] = '%.3f (V)' % [(values[6].to_f / 200 - 2.5) / 0.0681]
+      values[7] = '%.3f (V)' % [(values[7].to_f / 200 - 2.5) / 0.0681]
+    end
+
+    [ [ ifkit.sensor_sample_rates, values.inspect] ]
+  end while sleep(1)
+end

data/ext/phidgets_native/interfacekit.c

@@ -40,15 +40,20 @@ int CCONV interfacekit_on_attach(CPhidgetHandle phid, void *userptr) {
     if(ifkit_info->data_rates_min) xfree(ifkit_info->data_rates_min);
     if(ifkit_info->sensor_change_triggers) xfree(ifkit_info->sensor_change_triggers);
     if(ifkit_info->analog_sample_rates) xfree(ifkit_info->analog_sample_rates);
+    if(ifkit_info->is_ratiometric) xfree(ifkit_info->is_ratiometric);
+    if(ifkit_info->updated_since_last_ratiometric_cycle) xfree(ifkit_info->updated_since_last_ratiometric_cycle);
 
     ifkit_info->data_rates = ALLOC_N(int, ifkit_info->analog_input_count);
     ifkit_info->data_rates_max = ALLOC_N(int, ifkit_info->analog_input_count);
     ifkit_info->data_rates_min = ALLOC_N(int, ifkit_info->analog_input_count);
     ifkit_info->sensor_change_triggers = ALLOC_N(int, ifkit_info->analog_input_count);
-
     ifkit_info->analog_sample_rates = ALLOC_N(SampleRate, ifkit_info->analog_input_count); 
+    ifkit_info->is_ratiometric = ALLOC_N(bool, ifkit_info->analog_input_count); 
+    ifkit_info->updated_since_last_ratiometric_cycle = ALLOC_N(bool, ifkit_info->analog_input_count); 
 
     memset(ifkit_info->analog_sample_rates, 0, sizeof(SampleRate) * ifkit_info->analog_input_count);
+    memset(ifkit_info->is_ratiometric, 0, sizeof(bool) * ifkit_info->analog_input_count);
+    memset(ifkit_info->updated_since_last_ratiometric_cycle, 0, sizeof(bool) * ifkit_info->analog_input_count);
 
     for(int i=0;i<ifkit_info->analog_input_count;i++) {
       ifkit_info->data_rates[i] = DEFAULT_INTERFACEKIT_DATA_RATE;
@@ -61,18 +66,15 @@ int CCONV interfacekit_on_attach(CPhidgetHandle phid, void *userptr) {
     ifkit_info->is_data_rates_known = true;
   }
 
-  // If the interfacekit isn't what we expect, we need to perform a change:
-  report(interfacekit_assert_ratiometric_state( info ));
-
-  // Set the data-rate/sensor-thresholds
-  for(int i=0;i<ifkit_info->analog_input_count;i++) {
-    if (ifkit_info->data_rates[i] > 0) {
-      report(CPhidgetInterfaceKit_setSensorChangeTrigger(interfacekit, i, 0));
-      report(CPhidgetInterfaceKit_setDataRate(interfacekit, i, ifkit_info->data_rates[i]));
-    } else {
-      report(CPhidgetInterfaceKit_setDataRate(interfacekit, i, 0));
-      report(CPhidgetInterfaceKit_setSensorChangeTrigger(interfacekit, i, ifkit_info->sensor_change_triggers[i]));
-    }
+  if ( interfacekit_ratiometric_state_is_uniform(ifkit_info) ) {
+    // Set the board's ratiometric state:
+    report(interfacekit_assert_ratiometric_state( info ));
+    // Set the data-rate/sensor-thresholds
+    report(interfacekit_assert_sensor_rates(info));
+  }
+  else {
+    report(interfacekit_assert_dual_ratiometric_mode(info));
+    report(interfacekit_maximize_data_rate(info));
   }
 
   // Read in all of our initial input values:
@@ -83,7 +85,7 @@ int CCONV interfacekit_on_attach(CPhidgetHandle phid, void *userptr) {
     report(CPhidgetInterfaceKit_setOutputState(interfacekit,i, ifkit_info->digital_output_states[i]));
 
   for(int i=0; i<ifkit_info->analog_input_count; i++)
-    if (ifkit_info->rationmetric_changed_usec == 0) 
+    if (ifkit_info->ratiometric_changed_usec == 0) 
       // We only read these in if we haven't recently been changed ratiometric status: 
       report(CPhidgetInterfaceKit_getSensorValue(interfacekit,i, &ifkit_info->analog_input_states[i]));
     else
@@ -119,26 +121,18 @@ int CCONV interfacekit_on_detach(CPhidgetHandle phid, void *userptr) {
 void interfacekit_on_free(void *type_info) {
   InterfaceKitInfo *ifkit_info = type_info;
 
-  if(ifkit_info->data_rates)
-    xfree(ifkit_info->data_rates);
-  if(ifkit_info->data_rates_min)
-    xfree(ifkit_info->data_rates_min);
-  if(ifkit_info->data_rates_max)
-    xfree(ifkit_info->data_rates_max);
-  if(ifkit_info->sensor_change_triggers)
-    xfree(ifkit_info->sensor_change_triggers);
-  if (ifkit_info->digital_input_states)
-    xfree(ifkit_info->digital_input_states);
-  if (ifkit_info->digital_output_states)
-    xfree(ifkit_info->digital_output_states);
-  if (ifkit_info->analog_input_states)
-    xfree(ifkit_info->analog_input_states);
-  if(ifkit_info->digital_sample_rates) 
-    xfree(ifkit_info->digital_sample_rates);
-  if(ifkit_info->analog_sample_rates) 
-    xfree(ifkit_info->analog_sample_rates);
-  if (ifkit_info)
-    xfree(ifkit_info);
+  if(ifkit_info->is_ratiometric) xfree(ifkit_info->is_ratiometric);
+  if(ifkit_info->updated_since_last_ratiometric_cycle) xfree(ifkit_info->updated_since_last_ratiometric_cycle);
+  if(ifkit_info->data_rates) xfree(ifkit_info->data_rates);
+  if(ifkit_info->data_rates_min) xfree(ifkit_info->data_rates_min);
+  if(ifkit_info->data_rates_max) xfree(ifkit_info->data_rates_max);
+  if(ifkit_info->sensor_change_triggers) xfree(ifkit_info->sensor_change_triggers);
+  if (ifkit_info->digital_input_states) xfree(ifkit_info->digital_input_states);
+  if (ifkit_info->digital_output_states) xfree(ifkit_info->digital_output_states);
+  if (ifkit_info->analog_input_states) xfree(ifkit_info->analog_input_states);
+  if(ifkit_info->digital_sample_rates) xfree(ifkit_info->digital_sample_rates);
+  if(ifkit_info->analog_sample_rates) xfree(ifkit_info->analog_sample_rates);
+  if (ifkit_info) xfree(ifkit_info);
   return;
 }
 
@@ -158,12 +152,14 @@ int interfacekit_on_analog_change(CPhidgetInterfaceKitHandle interfacekit, void
   PhidgetInfo *info = userptr;
   InterfaceKitInfo *ifkit_info = info->type_info;
 
-  sample_tick(&ifkit_info->analog_sample_rates[index], NULL);
+  bool record_value = false;
+
+  int current_ratiometric_state = PFALSE;
 
   if (ifkit_info->analog_input_states) {
-    if (ifkit_info->rationmetric_changed_usec == 0) 
-      ifkit_info->analog_input_states[index] = sensorValue;
-    else {
+    if (ifkit_info->is_dual_ratiometric_mode && interfacekit_is_time_to_flip_ratiometric_state(info) ) {
+      report(interfacekit_flip_ratiometric_state(info));
+    } else if (ifkit_info->ratiometric_changed_usec != 0) {
       // We need to wait 50 milliseconds before accepting values after a ratiometric
       // state change. If we're in this path, it's TBD whether 50 ms has passed
       int usec_difference;
@@ -171,17 +167,31 @@ int interfacekit_on_analog_change(CPhidgetInterfaceKitHandle interfacekit, void
       gettimeofday(&now, NULL);
 
       usec_difference = ( now.tv_usec + 
-        ( (now.tv_usec < ifkit_info->rationmetric_changed_usec)  ? 1000000 : 0) -
-        ifkit_info->rationmetric_changed_usec );
-         
+        ( (now.tv_usec < ifkit_info->ratiometric_changed_usec)  ? 1000000 : 0) -
+        ifkit_info->ratiometric_changed_usec );
+
       // Did we wait long enough between a ratiometric status change:
       if ( usec_difference > INTERFACEKIT_RATIOMETRIC_RESET_USECS ) {
-        ifkit_info->rationmetric_changed_usec = 0;
-        
-        // And sure, go ahead and accepti this value:
-        ifkit_info->analog_input_states[index] = sensorValue;
+        ifkit_info->ratiometric_changed_usec = 0;
       }
     }
+
+    if (ifkit_info->ratiometric_changed_usec == 0) {
+      if (ifkit_info->is_dual_ratiometric_mode) {
+        report(CPhidgetInterfaceKit_getRatiometric(interfacekit, &current_ratiometric_state));
+
+        if ( (current_ratiometric_state == PTRUE) == ifkit_info->is_ratiometric[index] )
+          record_value = true;
+      } else
+        record_value = true;
+    }
+
+    if (record_value) {
+      ifkit_info->analog_input_states[index] = sensorValue;
+      sample_tick(&ifkit_info->analog_sample_rates[index], NULL);
+      if(ifkit_info->is_dual_ratiometric_mode)
+        ifkit_info->updated_since_last_ratiometric_cycle[index] = true;
+    }
   }
 
   return 0;
@@ -192,23 +202,134 @@ int interfacekit_assert_ratiometric_state(PhidgetInfo *info) {
   CPhidgetInterfaceKitHandle interfacekit = (CPhidgetInterfaceKitHandle) info->handle;
   int ret = 0;
 
-  int is_ratiometric_already;
-  ret = CPhidgetInterfaceKit_getRatiometric(interfacekit, &is_ratiometric_already);
-  if (ret != EPHIDGET_OK) return ret;
+  bool change_mode = false;
 
-  if (ifkit_info->is_ratiometric != (ifkit_info->is_ratiometric == PTRUE) ) {
-    ret = CPhidgetInterfaceKit_setRatiometric(interfacekit, (ifkit_info->is_ratiometric) ? PTRUE : PFALSE );
+  if (ifkit_info->is_dual_ratiometric_mode) {
+    ifkit_info->is_dual_ratiometric_mode = false;
+    change_mode = true;
+    report(interfacekit_assert_sensor_rates(info));
+  } else {
+    int is_ratiometric_already;
+    ret = CPhidgetInterfaceKit_getRatiometric(interfacekit, &is_ratiometric_already);
+    if (ret != EPHIDGET_OK) return ret;
+
+    if (ifkit_info->is_ratiometric[0] != (is_ratiometric_already == PTRUE) )
+      change_mode = true;
+  }
+
+  if (change_mode) {
+    ret = CPhidgetInterfaceKit_setRatiometric(interfacekit, (ifkit_info->is_ratiometric[0]) ? PTRUE : PFALSE );
     if (ret != EPHIDGET_OK) return ret;
 
     // Zero-out the analog struct:
     memset(ifkit_info->analog_input_states, 0, sizeof(int) * ifkit_info->analog_input_count);
 
     // We need to wait 50ms after this change before we start to read in values:
-    struct timeval now;
-    gettimeofday(&now, NULL);
+    interfacekit_stamp_ratiometric_change(ifkit_info);
+  }
+
+  return EPHIDGET_OK;
+}
+
+bool interfacekit_ratiometric_state_is_uniform(InterfaceKitInfo *ifkit_info) {
+  bool first_state = ifkit_info->is_ratiometric[0];
+
+  for(int i=1; i<ifkit_info->analog_input_count;i++)
+    if (ifkit_info->is_ratiometric[i] != first_state)
+      return false;
+
+  return true;
+}
+
+bool interfacekit_is_time_to_flip_ratiometric_state(PhidgetInfo *info) {
+  InterfaceKitInfo *ifkit_info = info->type_info;
+  CPhidgetInterfaceKitHandle interfacekit = (CPhidgetInterfaceKitHandle) info->handle;
+
+  int current_ratiometric_state = PFALSE;
+
+  report(CPhidgetInterfaceKit_getRatiometric(interfacekit, &current_ratiometric_state));
+
+  for(int i=0; i<ifkit_info->analog_input_count;i++)
+    if ( (ifkit_info->is_ratiometric[i] == (current_ratiometric_state == PTRUE)) &&   
+      (ifkit_info->updated_since_last_ratiometric_cycle[i] == false) )
+      return false;
+
+  return true;
+}
+
+// This method ensures that the sensor data rates are set to what's been requested
+// by the user. It's typically only used when initializing, and when turning on
+// a uniform ratiometric state:
+int interfacekit_assert_sensor_rates(PhidgetInfo *info) {
+  InterfaceKitInfo *ifkit_info = info->type_info;
+  CPhidgetInterfaceKitHandle interfacekit = (CPhidgetInterfaceKitHandle) info->handle;
+
+  for(int i=0;i<ifkit_info->analog_input_count;i++) {
+    if (ifkit_info->data_rates[i] > 0) {
+      report(CPhidgetInterfaceKit_setSensorChangeTrigger(interfacekit, i, 0));
+      report(CPhidgetInterfaceKit_setDataRate(interfacekit, i, ifkit_info->data_rates[i]));
+    } else {
+      report(CPhidgetInterfaceKit_setDataRate(interfacekit, i, 0));
+      report(CPhidgetInterfaceKit_setSensorChangeTrigger(interfacekit, i, ifkit_info->sensor_change_triggers[i]));
+    }
+  }
 
-    ifkit_info->rationmetric_changed_usec = (now.tv_usec == 0) ? 1 : now.tv_usec;
+  return EPHIDGET_OK;
+}
+
+int interfacekit_assert_dual_ratiometric_mode(PhidgetInfo *info) {
+  InterfaceKitInfo *ifkit_info = info->type_info;
+
+  if (!ifkit_info->is_dual_ratiometric_mode) {
+    ifkit_info->is_dual_ratiometric_mode = true;
+    memset(ifkit_info->updated_since_last_ratiometric_cycle, 0, sizeof(bool) * ifkit_info->analog_input_count);
+    return interfacekit_maximize_data_rate(info);
   }
 
   return EPHIDGET_OK;
 }
+
+int interfacekit_maximize_data_rate(PhidgetInfo *info) {
+  InterfaceKitInfo *ifkit_info = info->type_info;
+  CPhidgetInterfaceKitHandle interfacekit = (CPhidgetInterfaceKitHandle) info->handle;
+
+  for(int i=0;i<ifkit_info->analog_input_count;i++)
+    if (ifkit_info->data_rates[i] > 0) {
+      report(CPhidgetInterfaceKit_setSensorChangeTrigger(interfacekit, i, 0));
+      report(CPhidgetInterfaceKit_setDataRate(interfacekit, i, DEFAULT_INTERFACEKIT_DATA_RATE));
+    }
+
+  return EPHIDGET_OK;
+}
+
+int interfacekit_flip_ratiometric_state(PhidgetInfo *info) {
+  InterfaceKitInfo *ifkit_info = info->type_info;
+  CPhidgetInterfaceKitHandle interfacekit = (CPhidgetInterfaceKitHandle) info->handle;
+
+  int ret;
+  int current_state;
+
+  ret = CPhidgetInterfaceKit_getRatiometric(interfacekit, &current_state);
+  if (ret != EPHIDGET_OK) return ret;
+
+  ret = CPhidgetInterfaceKit_setRatiometric(interfacekit, (current_state) ? PFALSE : PTRUE );
+  if (ret != EPHIDGET_OK) return ret;
+
+  // We need to wait 50ms after this change before we start to read in values:
+  interfacekit_stamp_ratiometric_change(ifkit_info);
+
+  memset(ifkit_info->updated_since_last_ratiometric_cycle, 0, sizeof(bool) * ifkit_info->analog_input_count);
+
+  return EPHIDGET_OK;
+}
+
+// This stamps the ifkit struct with the current time. We cheat a bit to make
+// our lookup code a bit easier, by stamping the case of 0 with a 1:
+int interfacekit_stamp_ratiometric_change(InterfaceKitInfo *ifkit_info) {
+  struct timeval now;
+  gettimeofday(&now, NULL);
+
+  ifkit_info->ratiometric_changed_usec = (now.tv_usec == 0) ? 1 : now.tv_usec;
+
+  return EPHIDGET_OK;
+}

data/ext/phidgets_native/interfacekit_ruby.c

@@ -12,19 +12,47 @@ const char MSG_DATA_RATE_EXCEEDS_LIMIT[] = "provided rate exceeds allowed limit"
 const char MSG_CHANGE_TRIG_VALUE_MUST_BE_FIXNUM[] = "threshold must be a fixnum";
 const char MSG_CHANGE_TRIG_EXCEEDS_LIMIT[] = "provided threshold exceeds allowed limit";
 
+const char MSG_RATIOMETRIC_NOT_UNIFORM[] = "this action can't be performed unless all sensors are of the same ratiometric state";
+
 /* 
  * Document-class: PhidgetsNative::InterfaceKit < PhidgetsNative::Device
  *
  * This class provides functionality specific to the "InterfaceKit" device class. 
  * Primarily, this phidget reports the values of analog and digital inputs, and
  * provides interfaces for outputing to analog and digital components.
+ *
+ * *NOTE:* Unlike the native phidget libraries, this implementation supports a 
+ * "Dual Ratiometric" mode for the interface kit. This dual-mode is acheived by
+ * rapidly cycling the controller between ratiometric on and off states in the 
+ * device polling loop. The benefit to supporting mixed states is that you 
+ * can support multiple devices types on a single controller. Unfortunately, 
+ * the ramification of doing so reduces the sample rates to a small fraction
+ * (roughly 8 times per second) of the maximum data rate (roughly 125 times per
+ * second). For many applications, the sampling rates aren't so sensitive that 
+ * dual-ratiometric mode will be a problem.
+ *
+ * "Dual ratiometric" mode will automatically enable itself if you specify per-sensor
+ * ratiometric states using the ratiometric() method. Similary, uniform-ratiometric
+ * mode will automatically return at any time that all sensors return to a uniform
+ * state. If you don't intend to take advantage of this feature, simply use the
+ * ratiometric= method to set all analog inputs to the same state, and ignore the
+ * ratiometric() method.
  */
 
+/*
+ * Document-class: PhidgetsNative::InterfaceKit::RatiometricNotUniform
+ *
+ * This exception is raised when the library encounters a request that cannot be
+ * satisfied since the ratiometric state of the analog sensors are not uniform.
+ */
 void Init_phidgets_native_interfacekit(VALUE m_Phidget) {
   VALUE c_Device = rb_const_get(m_Phidget, rb_intern("Device"));
 
   VALUE c_InterfaceKit = rb_define_class_under(m_Phidget,"InterfaceKit",c_Device);
 
+  VALUE c_RatiometricNotUniform = rb_define_class_under(c_InterfaceKit, 
+    "RatiometricNotUniform", rb_eStandardError);
+
   /*
    * Document-method: new
    * call-seq:
@@ -119,6 +147,26 @@ void Init_phidgets_native_interfacekit(VALUE m_Phidget) {
    */
   rb_define_method(c_InterfaceKit, "ratiometric=", interfacekit_ratiometric_set, 1);
 
+  /*
+   * Document-method: ratiometric
+   * call-seq:
+   *   ratiometric(Fixnum index, Boolean state) -> Fixnum
+   *
+   * This method sets the ratiometric state for the analog sensor at the provided 
+   * index. Note that phidget boards only support a board-wide ratiometric state.
+   * As such, when you set the state per the sensor in this library, the library
+   * will automatically toggle the board state between ratio and non-ratio metric
+   * modes for you. As a side-effect of the toggle action, your data rate will
+   * drop substantially, and you'll not be able to adjust the data_rate and 
+   * change_trigger parameters. To re-enable the data_rate and change_trigger 
+   * features, use the ratiometric= method to set the state for the entire board.
+   * The return value for this method is simply what was specified for 
+   * the state. 
+   * For more information on how analog inputs are polled, you can read up on the
+   * Phidget {Analog Input Primer}[http://www.phidgets.com/docs/Analog_Input_Primer] 
+   */
+   rb_define_method(c_InterfaceKit, "ratiometric", interfacekit_ratiometric, -1);
+
   /*
    * Document-method: data_rates_max
    * call-seq:
@@ -256,8 +304,8 @@ VALUE interfacekit_initialize(VALUE self, VALUE serial) {
   
   InterfaceKitInfo *ifkit_info = ALLOC(InterfaceKitInfo); 
   memset(ifkit_info, 0, sizeof(InterfaceKitInfo));
-  ifkit_info->is_ratiometric = false;
   ifkit_info->is_data_rates_known = false;
+  ifkit_info->is_dual_ratiometric_mode = false;
 
   CPhidgetInterfaceKitHandle interfacekit = 0;
   ensure(CPhidgetInterfaceKit_create(&interfacekit));
@@ -339,6 +387,10 @@ VALUE interfacekit_sensor_count(VALUE self) {
 VALUE interfacekit_is_ratiometric(VALUE self) {
   InterfaceKitInfo *ifkit_info = device_type_info(self);
 
+  // If ratiometric state is not uniform, raise an exception
+  if (!interfacekit_ratiometric_state_is_uniform(ifkit_info))
+    interfacekit_raise_ratiometric_not_uniform();
+
   return (ifkit_info->is_ratiometric) ? Qtrue : Qfalse;
 }
 
@@ -346,19 +398,64 @@ VALUE interfacekit_ratiometric_set(VALUE self, VALUE is_ratiometric) {
   PhidgetInfo *info = device_info(self);
   InterfaceKitInfo *ifkit_info = device_type_info(self);
 
+  if (!info->is_attached) return Qnil;
+
+  bool is_ratiometric_bool;
+
   if (TYPE(is_ratiometric) == T_TRUE) 
-    ifkit_info->is_ratiometric = true;
+    is_ratiometric_bool = true;
   else if (TYPE(is_ratiometric) == T_FALSE)
-    ifkit_info->is_ratiometric = false;
+    is_ratiometric_bool = false;
   else
     rb_raise(rb_eTypeError, MSG_RATIOMETRIC_MUST_BE_BOOL);
 
-  if (info->is_attached)
-    ensure(interfacekit_assert_ratiometric_state( info ));
+  for(int i=0; i<ifkit_info->analog_input_count;i++)
+    ifkit_info->is_ratiometric[i] = is_ratiometric_bool;
+
+  ensure(interfacekit_assert_ratiometric_state( info ));
 
   return is_ratiometric;
 }
 
+VALUE interfacekit_ratiometric(int argc, VALUE* argv, VALUE self) {
+  VALUE index;
+  VALUE is_ratiometric;
+
+  rb_scan_args(argc, argv, "11", &index, &is_ratiometric);
+
+  if (TYPE(index) != T_FIXNUM)
+    rb_raise(rb_eTypeError, MSG_SENSOR_INDEX_MUST_BE_FIXNUM);
+
+  PhidgetInfo *info = device_info(self);
+  InterfaceKitInfo *ifkit_info = info->type_info;
+
+  int index_int = FIX2INT(index);
+  if ((ifkit_info->analog_input_count == 0) || (index_int > (ifkit_info->analog_input_count-1)))
+    rb_raise(rb_eTypeError, MSG_SENSOR_INDEX_TOO_HIGH);
+
+  VALUE ret;  
+  if(NIL_P(is_ratiometric)) {
+    // It's a get request:
+    ret = (ifkit_info->is_ratiometric[index_int]) ? Qtrue : Qfalse;
+  } else {
+    if (TYPE(is_ratiometric) == T_TRUE) 
+      ifkit_info->is_ratiometric[index_int] = true;
+    else if (TYPE(is_ratiometric) == T_FALSE)
+      ifkit_info->is_ratiometric[index_int] = false;
+    else
+      rb_raise(rb_eTypeError, MSG_RATIOMETRIC_MUST_BE_BOOL);
+
+    ret = is_ratiometric;
+
+    if (interfacekit_ratiometric_state_is_uniform(ifkit_info))
+      ensure(interfacekit_assert_ratiometric_state(info));
+    else
+      ensure(interfacekit_assert_dual_ratiometric_mode(info));
+  }
+
+  return ret;
+}
+
 VALUE interfacekit_data_rates_max(VALUE self) {
   InterfaceKitInfo *ifkit_info = device_type_info(self);
 
@@ -459,6 +556,10 @@ VALUE interfacekit_data_rate_set(VALUE self, VALUE index, VALUE rate) {
   PhidgetInfo *info = device_info(self);
   InterfaceKitInfo *ifkit_info = info->type_info;
 
+  // If ratiometric state is not uniform, raise an exception
+  if (!interfacekit_ratiometric_state_is_uniform(ifkit_info))
+    interfacekit_raise_ratiometric_not_uniform();
+
   if (TYPE(index) != T_FIXNUM)
     rb_raise(rb_eTypeError, MSG_SENSOR_INDEX_MUST_BE_FIXNUM);
 
@@ -486,6 +587,10 @@ VALUE interfacekit_change_trigger_set(VALUE self, VALUE index, VALUE rate_thresh
   PhidgetInfo *info = device_info(self);
   InterfaceKitInfo *ifkit_info = info->type_info;
 
+  // If ratiometric state is not uniform, raise an exception
+  if (!interfacekit_ratiometric_state_is_uniform(ifkit_info))
+    interfacekit_raise_ratiometric_not_uniform();
+
   if (TYPE(index) != T_FIXNUM)
     rb_raise(rb_eTypeError, MSG_SENSOR_INDEX_MUST_BE_FIXNUM);
 
@@ -509,3 +614,15 @@ VALUE interfacekit_change_trigger_set(VALUE self, VALUE index, VALUE rate_thresh
 
   return rate_thresh;
 }
+
+void interfacekit_raise_ratiometric_not_uniform() {
+  VALUE m_Phidget = rb_const_get(rb_cObject, rb_intern("PhidgetsNative"));  
+
+  VALUE c_InterfaceKit = rb_const_get(m_Phidget, rb_intern("InterfaceKit")); 
+
+  VALUE c_Exception = rb_const_get(c_InterfaceKit, rb_intern("RatiometricNotUniform"));
+
+  rb_raise(c_Exception, MSG_RATIOMETRIC_NOT_UNIFORM);
+
+  return;
+}

data/ext/phidgets_native/phidgets_native.h

@@ -142,8 +142,13 @@ typedef struct interfacekit_info {
   int digital_input_count_prior;
   int digital_output_count_prior;
 
-  bool is_ratiometric;
-  int rationmetric_changed_usec;
+  bool is_dual_ratiometric_mode;
+  bool *is_ratiometric;
+  int ratiometric_changed_usec;
+
+  // This tracks whether it's time to change the ratiometric state, for the case
+  // of a dual-mode ratiometric change:
+  bool *updated_since_last_ratiometric_cycle;
 
 
   // This flag works for all of the below properties
@@ -282,6 +287,14 @@ int CCONV interfacekit_on_detach(CPhidgetHandle phid, void *userptr);
 int interfacekit_on_digital_change(CPhidgetInterfaceKitHandle interfacekit, void *userptr, int index, int inputState);
 int interfacekit_on_analog_change(CPhidgetInterfaceKitHandle interfacekit, void *userptr, int index, int sensorValue);
 int interfacekit_assert_ratiometric_state(PhidgetInfo *info);
+bool interfacekit_ratiometric_state_is_uniform(InterfaceKitInfo *ifkit_info);
+void interfacekit_raise_ratiometric_not_uniform();
+int interfacekit_maximize_data_rate(PhidgetInfo *info);
+int interfacekit_assert_dual_ratiometric_mode(PhidgetInfo *info);
+int interfacekit_assert_sensor_rates(PhidgetInfo *info);
+int interfacekit_stamp_ratiometric_change(InterfaceKitInfo *ifkit_info);
+int interfacekit_flip_ratiometric_state(PhidgetInfo *info);
+bool interfacekit_is_time_to_flip_ratiometric_state(PhidgetInfo *info);
 VALUE interfacekit_initialize(VALUE self, VALUE serial);
 VALUE interfacekit_close(VALUE self);
 VALUE interfacekit_sensor_sample_rates(VALUE self);
@@ -291,6 +304,7 @@ VALUE interfacekit_output_count(VALUE self);
 VALUE interfacekit_sensor_count(VALUE self);
 VALUE interfacekit_is_ratiometric(VALUE self);
 VALUE interfacekit_ratiometric_set(VALUE self, VALUE is_ratiometric);
+VALUE interfacekit_ratiometric(int argc, VALUE* argv, VALUE self);
 VALUE interfacekit_data_rates_max(VALUE self);
 VALUE interfacekit_data_rates_min(VALUE self);
 VALUE interfacekit_data_rates(VALUE self);
@@ -351,7 +365,6 @@ VALUE advancedservo_engaged_set(VALUE self, VALUE index, VALUE value);
 VALUE advancedservo_is_stopped(VALUE self, VALUE index);
 VALUE advancedservo_servo_parameters_set(VALUE self, VALUE index, VALUE min_us, VALUE max_us, VALUE degrees, VALUE velocity_max);
 
-
 // Stub initializers:
 VALUE accelerometer_initialize(VALUE self, VALUE serial);
 VALUE advancedservo_initialize(VALUE self, VALUE serial);

data/phidgets_native.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
   s.name    = "phidgets_native"
-  s.version = "0.2.0"
+  s.version = "0.2.1"
   s.summary = "Native C-extension gem for the Phidgets library in ruby"
   s.author  = "Chris DeRose"
   s.description = s.summary

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: phidgets_native
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-08-27 00:00:00.000000000 Z
+date: 2013-09-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake-compiler
-  requirement: &70163161506660 !ruby/object:Gem::Requirement
+  requirement: &70329854728720 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,7 +21,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70163161506660
+  version_requirements: *70329854728720
 description: Native C-extension gem for the Phidgets library in ruby
 email: cderose@derosetechnologies.com
 executables: []
@@ -61,6 +61,7 @@ files:
 - ext/phidgets_native/extconf.rb
 - examples/advancedservo.rb
 - examples/gps.rb
+- examples/interface_kit-dualratiometric.rb
 - examples/interface_kit.rb
 - examples/list_all.rb
 - examples/spatial.rb