Alert.png

Notice: This page contains information for the legacy Phidget21 Library.

Phidget21 is out of support. Bugfixes may be considered on a case by case basis.

Phidget21 does not support VINT Phidgets, or new USB Phidgets released after 2020. We maintain a selection of legacy devices for sale that are supported in Phidget21.

We recommend that new projects be developed against the Phidget22 Library.


Click on the 2phidget22.jpg button in the menu bar to go to the Phidget22 version of this page.

Alert.png

1113 User Guide

From Phidgets Legacy Support
1113.jpg
Go to this device's product page


Getting Started

Checking the Contents

You should have received:

  • A mini-joystick sensor
  • A sensor cable

In order to test your new Phidget you will also need:

  • A PhidgetInterfaceKit 8/8/8 or PhidgetTextLCD
  • A USB cable
  • Some wires

Connecting the Pieces

  1. Connect the Mini Joystick Sensor to the Analog Input 6 and 7 on the PhidgetInterfaceKit 8/8/8 using the two sensor cables.
  2. Connect the GND terminal block on the Mini Joystick to the Digital Input Ground terminal block on the InterfaceKit. Connect the Mini Joystick’s Input terminal block to a digital input on the PhidgetInterfaceKit.
  3. Connect the PhidgetInterfaceKit to your PC using the USB cable.

1113 0 Connecting The Hardware.jpg

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 Ph.jpg icon on the right hand corner of the Task Bar.

Running Phidgets Sample Program

Double clicking on the Ph.jpg 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 Ph.jpg icon to activate the Phidget Control Panel and make sure that the Phidget InterfaceKit 8/8/8 is properly attached to your PC

1018 2 Control Panel Screen.jpg
  1. Double Click on Phidget InterfaceKit 8/8/8 in the Phidget Control Panel to bring up InterfaceKit-full and check that the box labelled Attached contains the word True.
  2. Make sure that the Ratiometric box is Ticked.
  3. As you move the joystick the sensor values will increase or decrease depending on the direction of your movement.
  4. When you press down on top of the joystick, a tick mark appears in the Digital In box. The tick mark disappears as you stop pushing down.
  5. You can adjust the input sensitivity by moving the slider pointer.
  6. Click on the Sensors button to bring up the Advanced Sensor Form.

1113 0 InterfaceKit Screen.jpg

  1. In the Advanced Sensor Form, select the 1113 - Mini Joystick Sensor[X] and [Y] from the drop down menu to get a display on each axis for your sensor.
  2. The numerical position of the axis is shown here.
  3. A representation of the current position on each axis.

1113 0 Advanced Sensor Form Screen.jpg

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 is properly attached.
  5. Double Click on in the Phidget Preference Pane to bring up the 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.

Technical Details

This miniature joystick has two axes and a push button. Each axis, up/down and left/right, has a potentiometer with a center value of approximately 500. When you move the Joystick from its center position the value will increase or decrease depending on the direction. Pressing down on the Joystick pin will make a momentary contact that can be connected to a digital input on the PhidgetInterfaceKit through the terminal blocks.

Other Interfacing Alternatives

If you want maximum accuracy, you can use the RawSensorValue property from the PhidgetInterfaceKit. To adjust a formula, substitute (SensorValue) with (RawSensorValue / 4.095) If the sensor is being interfaced to your own Analog to Digital Converter and not a Phidget device, our formulas can be modified by replacing (SensorValue) with (Vin * 200). It is important to consider the voltage reference and input voltage range of your ADC for full accuracy and range.


Each Analog Input uses a 3-pin, 0.100 inch pitch locking connector. Pictured here is a plug with the connections labelled. The connectors are commonly available - refer to the Analog Input Primer for manufacturer part numbers.

Analoginput.jpg

API

Phidget analog sensors do not have their own API- they simply output a voltage that is converted to a digital value and accessed through the "Sensor" properties and events on the PhidgetInterfaceKit API. It is not possible to programmatically identify which sensor is attached to the Analog Input. To an InterfaceKit, every sensor looks the same. Your application will need to apply formulas from this manual to the SensorValue (an integer that ranges from 0 to 1000) to convert it into the units of the quantity being measured. For example, this is how you would use a temperature sensor in a C# program:


 // set up the interfacekit object
InterfaceKit IFK = new InterfaceKit();

// link the new interfacekit object to the connected board
IFK.open("localhost", 5001);

// Get sensorvalue from analog input zero
int sensorvalue = IFK.sensors[0].Value;

// Convert sensorvalue into temperature in degrees Celsius
double roomtemp = Math.Round(((sensorvalue * 0.22222) - 61.11), 1);


See the PhidgetInterfaceKit User Guide for more information on the API and a description of our architecture.

For more code samples, find your preferred language on the Languages page.

Product History

Date Board Revision Device Version Comment
September 2003 0 N/A Product Release
August 2004 02 N/A Analog input connector changed from stereo jack to 3-pin Molex