1016 User Guide

Getting Started

Checking the Contents

You should have received: A PhidgetCircularTouch board. A custom USB cable

Connecting the Pieces

Connect the PhidgeCircularTouch board to the computer using the included custom USB cable.

Testing Using Windows 2000 / XP / Vista / 7

Make sure you have the current version of the Phidget library installed on your PC. If you don't, follow these steps:

1. Go to the Quick Downloads section on the Windows page
2. Download and run the Phidget21 Installer (32-bit, or 64-bit, depending on your system)
3. You should see the icon on the right hand corner of the Task Bar.

Running Phidgets Sample Program

Double clicking on the icon loads the Phidget Control Panel; we will use this program to ensure that your new Phidget works properly.

The source code for the InterfaceKit-full sample program can be found in the quick downloads section on the C# Language Page. If you'd like to see examples in other languages, you can visit our Languages page.

Updating Device Firmware

If an entry in this list is red, it means the firmware for that device is out of date. Double click on the entry to be given the option of updating the firmware. If you choose not to update the firmware, you can still run the example for that device after refusing.

Double Click on the icon to activate the Phidget Control Panel and make sure that the Phidget Touch Rotation is properly attached to your PC.
Double Click on Phidget Touch Rotation in the Phidget Control Panel to bring up InterfaceKit-full and check that the box labelled Attached contains the word True. As you bring your finger closer tothe board and touch the board, tick marks will appear in the Digital In boxes. The left one shows “touch” and the right one shows “proximity”. Move your finger along the backside of the PhidgetCircularTouch and watch the numbers in the Analog box change. The numbers are only significant when both Digital In boxes are “tick marked”. Adjusting the input sensitivity with the sensitivity slider changes the number of discrete steps that will fire the on-sensor-change event.

Testing Using Mac OS X

1. Go to the Quick Downloads section on the Mac OS X page
2. Download and run the Phidget OS X Installer
3. Click on System Preferences >> Phidgets (under Other) to activate the Preference Pane
4. Make sure that the Phidget Touch Rotation is properly attached.
5. Double Click on Phidget Touch Rotation in the Phidget Preference Pane to bring up the InterfaceKit-full Sample program. This program will function in a similar way as the Windows version.

Using Linux

For a step-by-step guide on getting Phidgets running on Linux, check the Linux page.

Using Windows Mobile / CE 5.0 / CE 6.0

For a step-by-step guide on getting Phidgets running on Windows CE, check the Windows CE page.

API

We document API Calls specific to this product in this section. Functions common to all Phidgets and functions not applicable to this device are not covered here. This section is deliberately generic. For calling conventions under a specific language, refer to the associated API manual in the Quick Downloads section for that language. For exact values, refer to the device specifications.

Functions

int InputCount() [get] : Constant = 2

Returns the number of digital inputs supported. Please refer to the Device Inputs section for details on the abstractions used on the 1016.

bool InputState(int InputIndex) [get]

Returns the state of a particular digital input.

int SensorCount() [get] : Constant = 1

Returns the number of sensors (Analog Inputs) supported by this PhidgetInterfaceKit. Intrepreted together with the digital inputs, this represents the positiion of the user’s finger on the circular slider.

int SensorValue(int SensorIndex) [get]

Returns the sensed value of a particular Analog Input. Please refer to the Device Inputs section for details on the abstractions used on the 1016.

double SensorChangeTrigger (int SensorIndex) [get,set]

Returns the change trigger for an analog input. This is the ammount that an inputs must change between successive SensorChangeEvents. This is based on the 0-1000 range provided by getSensorValue. This value is by default set to 10.

Events

OnInputChange(int InputIndex, bool State) [event]

An event that is issued when the state of a digital input changes.

OnSensorChange(int SensorIndex, int SensorValue), [event]

An event that is issued when the returned value from an Analog Input varies by more than the SensorChangeTrigger property.

Product History

Date	Board Revision	Device Version	Comment