Products for USB Sensing and Control
Products for USB Sensing and Control

#### sales inquiries

##### quotes, distributor information, purchase orders
sales@phidgets.com

#### technical inquiries

##### support, advice, warranty, returns, misshipment
support@phidgets.com

#### website inquiries

web@phidgets.com

##### Unit 1 - 6115 4 St SE Calgary AB  T2H 2H9 Canada
Projects Dealers Terms and Conditions Discontinued Products Phidget21 Documentation

#### PHIDGETS Inc.

Unit 1 - 6115 4 St SE
Calgary AB  T2H 2H9
+1 403 282-7335

## Thumbstick Phidget

ID: HIN1100_0
Recommended for new designs: This product (or a similar replacement with a compatible form, fit and function) is estimated to be available for ten years or more.

Make a custom controller for your project with this thumbstick. Two-axis with a center pushbutton, it plugs into a VINT port.

## $20.00 Quantity Available: 757 Qty Price 5$19.00
10 $18.00 25$16.00
50 $14.00 100$13.00
250 $12.00 500$11.00
1000 $10.00 The Thumbstick Phidget provides a familiar 2-axis thumbstick similar to those on a video game controller. The stick springs back to the neutral position when released. It can also be pressed down with a click, which will register in software and can be tied to a function in your software. This Phidget connects to your computer through a VINT Hub. #### Features: • Two-axis position - vertical and horizontal position can easily be converted to angles and magnitude • Button - The thumbstick also operates as a button, adding extra functionality to your program. #### VINT Hubs This Phidget is a smart device that must be controlled by a VINT Hub. For more information about VINT, have a look at the VINT Primer. You can use a Phidget Cable to simply and easily connect the two devices. Here's a list of all of the different VINT Hubs currently available: Product Board Part Number Price Number of VINT Ports Controlled By VINT Hub Phidget$30.00 6 USB (Mini-USB)
Wireless VINT Hub
$60.00 6 Local Network (Ethernet or Wi-Fi) PhidgetSBC4$120.00 6

#### Phidget Cables

Use a Phidget cable to connect this device to the hub. You can solder multiple cables together in order to make even longer Phidget cables, but you should be aware of the effects of having long wires in your system.

Product Physical Properties
Part Number Price Cable Length
Phidget Cable 60cm
$2.00 600 mm Phidget Cable 10cm$1.50 100 mm
Phidget Cable 350cm
$3.00 3.5 m Phidget Cable 120cm$2.25 1.2 m
Phidget Cable 180cm
$2.75 1.8 m Phidget Cable 30cm$1.75 300 mm
Phidget Cable 90cm
$2.00 900 mm Phidget Cable 150cm$2.50 1.5 m

## Part 1: Setup

### Select Device

Your Phidget must be connected to a device with a VINT port using a 3-wire Phidget cable.

## Step 1: Install Phidgets Library

Before you begin using your Phidgets, you will need to install the Phidget Library.

If you're unsure which one you should get, press ⊞ WIN + Pause/Break:

3a. Select Next

## Step 1: Install Phidgets Library

3b. Read the Licence Agreement. Select Next.

## Step 1: Install Phidgets Library

3c. Choose Installation Location. Select Next.

## Step 1: Install Phidgets Library

3d. Confirm Install

## Step 1: Install Phidgets Library

3e. Wait for Installation to complete. This should only take a few moments.

## Step 1: Install Phidgets Library

3f. Installation Complete. Close installation Window.

## Step 2: Connect Devices

● Connect USB Cable to your Windows Computer

● Connect VINT Device(s)

## Step 3: Verify Connection

1. Open the Phidgets Control Panel:

## Step 3: Verify Connection

2. If connected, your Phidgets will appear in the Phidget Control Panel.

## Done!

If you're able to see and interact with your devices in the Phidget Control Panel, you're done with the Setup part of this guide.

Scroll down to Part 2: Using Your Phidget for the next step.

For more help installing in Windows (e.g. manual install, using a VM, etc.), visit this page:

## Step 1: Install Phidgets Library

Before you begin using your Phidgets, you will need to install the Phidget Library.

## Step 1: Install Phidgets Library

3a. Select Continue

## Step 1: Install Phidgets Library

3c. Here, you have the option to select the installation location. Select Install to continue.

## Step 1: Install Phidgets Library

3e. Wait for Installation to complete. This should only take a few moments.

## Step 1: Install Phidgets Library

3f. You may see a message that the extension has been blocked. Select Open Security Preferences.

## Step 1: Install Phidgets Library

3g. Beside the message for Phidgets Inc, Click Allow.

## Step 1: Install Phidgets Library

3h. Installation Complete, Click Close.

## Step 1: Install Phidgets Library

3i. To delete the installer, click Move to Trash.

## Step 2: Connect Devices

● Connect USB Cable to your Mac

● Connect VINT Device(s)

## Step 3: Verify Connection

1. Open the Phidgets Control Panel:

## Step 3: Verify Connection

2. If connected, your Phidgets will appear in the Phidget Control Panel.

## Done!

If you're able to see and interact with your devices in the Phidget Control Panel, you're done with the Setup part of this guide.

Scroll down to Part 2: Using Your Phidget for the next step.

## Step 1: Install Phidgets Library

1. First, you need to install the libusb-1.0 development libraries. For example, in Debian based distributions:

apt-get install libusb-1.0-0-dev

You’ll also need a C compiler and builder, if you don’t already have one installed.

apt-get install gcc
apt-get install make

## Step 1: Install Phidgets Library

3. Use the following commands in the location you unpacked to install the library:

./configure
make
sudo make install

## Step 1: Install Phidgets Library

4. (Optional) You can also download and unpack the following optional packages:

phidget22networkserver - Phidget Network Server, which enables the use of Phidgets over your network

phidget22admin - Admin tool to track who is connected to your Phidgets when using the network server

libphidget22extra - Required for phidget22networkserver and phidget22admin

libphidget22java - The Java libraries for Phidget22

For installation instructions for these packages, see the README file included with each one.

## Step 2: Connect Devices

● Connect USB Cable to your Linux Computer

● Connect VINT Device(s)

## Step 3: Verify Connection

1. The easiest way to verify that your libraries are working properly is to compile and run an example program. Download and unpack this C example that will detect any Phidget:

## Step 3: Verify Connection

2. Next, open the terminal in the location where you unpacked the example. Compile and run using:

gcc HelloWorld.c -o HelloWorld -lphidget22
sudo ./HelloWorld

ou should receive a “Hello” line for each Phidget channel that is discovered:

I don’t see any Phidgets show up in the HelloWorld example

You need to run it with sudo in order to be able to access USB devices. In order to use Phidgets without sudo, you need to set your udev rules. See the Advanced Information page on the final slide of this guide for details.

## Done!

If you're able to see your devices in the Hello World example, you're done with the Setup part of this guide.

Scroll down to Part 2: Using Your Phidget for the next step.

## Step 1: Install Phidgets Library

Before you begin using your Phidgets, you will need to install the Phidget Library.

If you're unsure which one you should get, press ⊞ WIN + Pause/Break:

3a. Select Next

## Step 1: Install Phidgets Library

3b. Read the Licence Agreement. Select Next.

## Step 1: Install Phidgets Library

3c. Choose Installation Location. Select Next.

## Step 1: Install Phidgets Library

3d. Select Next to confirm install.

## Step 1: Install Phidgets Library

3e. Wait for Installation to complete. This should only take a few moments.

## Step 1: Install Phidgets Library

3f. Installation Complete. Close installation Window.

## Step 2: Connect Devices

● Connect Power Jack

● Connect VINT Device(s)

● Connect Ethernet to a Router or Switch (optional)

## Step 3: Verify Connection

Choose a setup method:

## Step 3: Connect Wireless

1. When you connect the power supply to the HUB5000, the red LED should turn on.

## Step 3: Connect Wireless

2. On your mobile device, go to the Wi-Fi settings and connect to the HUB5000:

## Step 3: Connect Wireless

4. Once your device is connected to the HUB5000’s WiFi signal:

Click on the WiFi network and find an option that says “Manage router” or “Visit homepage”.

Go to your internet browser and type 192.168.100.1 in the address bar.

## Step 3: Connect Wireless

5. Create a password for your HUB5000. You'll use it to access the Configure Page from now on.

## Step 3: Connect Wireless

6. Navigate to the network page. Change the Mode to Client.

## Step 3: Connect Wireless

7. Enter your Wifi Network details and click Save & Apply. It may take a few minutes for your Phidgets to appear in the Phidget Control Panel, which we’ll check in the next step.

## Step 4: Verify Connection

1. Open the Phidgets Control Panel:

## Step 4: Verify Connection

2. If connected, your Phidgets will appear in the Phidget Control Panel.

## Done!

If you're able to see and interact with your devices in the Phidget Control Panel, you're done with the Setup part of this guide.

Scroll down to Part 2: Using Your Phidget for the next step.

For more help installing in Windows (e.g. manual install, using a VM, etc.), visit this page:

## Step 3: Connect Wireless

1. When you connect the power supply to the HUB5000, the red LED should turn on.

## Step 3: Connect Wireless

3. Create a password for your HUB5000. You'll use this password to access the Configure Page from now on.

## Step 3: Connect Wireless

4. Navigate to the network page. Change the Mode to Client.

## Step 3: Connect Wireless

5. Enter your Wifi Network details to use your Hub wirelessly and click Save & Apply. You can then disconnect the ethernet cable.

It may take a few minutes for your Phidgets to appear in the Phidget Control Panel, which we’ll check in the next step.

## Step 4: Verify Connection

1. Open the Phidgets Control Panel:

## Step 4: Verify Connection

2. If connected, your Phidgets will appear in the Phidget Control Panel.

## Done!

If you're able to see and interact with your devices in the Phidget Control Panel, you're done with the Setup part of this guide.

Scroll down to Part 2: Using Your Phidget for the next step.

For more help installing in Windows (e.g. manual install, using a VM, etc.), visit this page:

## Step 1: Install Phidgets Library

Before you begin using your Phidgets, you will need to install the Phidget Library.

## Step 1: Install Phidgets Library

3a. Select Continue

## Step 1: Install Phidgets Library

3c. Here, you have the option to select the installation location. Select Install.

## Step 1: Install Phidgets Library

3e. Wait for Installation to complete. This should only take a few moments.

## Step 1: Install Phidgets Library

3f. You may see a message that the extension has been blocked. Select Open Security Preferences.

## Step 1: Install Phidgets Library

3g. Beside the message for Phidgets Inc, Click Allow.

## Step 1: Install Phidgets Library

3h. Installation Complete, Click Close.

## Step 1: Install Phidgets Library

3i. To delete the installer, click Move to Trash.

## Step 2: Connect Devices

● Connect Power Jack

● Connect VINT Device(s)

● Connect Ethernet to a Router or Switch (optional)

## Step 3: Verify Connection

Choose a setup method:

## Step 3: Connect Wireless

1. When you connect the power supply to the HUB5000, the red LED should turn on.

## Step 3: Connect Wireless

2. On your mobile device, go to the Wi-Fi settings and connect to the HUB5000:

## Step 3: Connect Wireless

4. Once your device is connected to the HUB5000’s WiFi signal:

Click on the WiFi network and find an option that says “Manage router” or “Visit homepage”.

Go to your internet browser and type 192.168.100.1 in the address bar.

## Step 3: Connect Wireless

5. Create a password for your HUB5000. You'll use this password to access the Configure Page from now on.

## Step 3: Connect Wireless

6. Navigate to the network page. Change the Mode to Client.

## Step 3: Connect Wireless

7. Enter your Wifi Network details and click Save & Apply. It may take a few minutes for your Phidgets to appear in the Phidget Control Panel, which we’ll check in the next step.

## Step 4: Verify Connection

1. Open the Phidget Control Panel:

## Step 4: Verify Connection

2. If connected, your Phidgets will appear in the Phidget Control Panel.

## Done!

If you're able to see and interact with your devices in the Phidget Control Panel, you're done with the Setup part of this guide.

Scroll down to Part 2: Using Your Phidget for the next step.

## Step 3: Connect Wireless

1. When you connect the power supply to the HUB5000, the red LED should turn on.

## Step 3: Connect Wireless

3. Create a password for your HUB5000. You'll use this password to access the Configure Page from now on.

## Step 3: Connect Wireless

4. Navigate to the network page. Change the Mode to Client.

## Step 3: Connect Wireless

5. Enter your Wifi Network details to use your Hub wirelessly and click Save & Apply. You can then disconnect the ethernet cable.

It may take a few minutes for your Phidgets to appear in the Phidget Control Panel, which we’ll check in the next step.

## Step 4: Verify Connection

1. Open the Phidget Control Panel:

## Step 4: Verify Connection

2. If connected, your Phidgets will appear in the Phidget Control Panel.

## Done!

If you're able to see and interact with your devices in the Phidget Control Panel, you're done with the Setup part of this guide.

Scroll down to Part 2: Using Your Phidget for the next step.

## Step 1: Install Phidgets Library

1. First, you need to install the libusb-1.0 development libraries. For example, in Debian based distributions:

apt-get install libusb-1.0-0-dev

You’ll also need a C compiler and builder, if you don’t already have one installed.

apt-get install gcc
apt-get install make

## Step 1: Install Phidgets Library

3. Use the following commands in the location you unpacked to install the library:

./configure
make
sudo make install

## Step 1: Install Phidgets Library

4. (Optional) You can also download and unpack the following optional packages:

phidget22networkserver - Phidget Network Server, which enables the use of Phidgets over your network

phidget22admin - Admin tool to track who is connected to your Phidgets when using the network server

libphidget22extra - Required for phidget22networkserver and phidget22admin

libphidget22java - The Java libraries for Phidget22

For installation instructions for these packages, see the README file included with each one.

## Step 2: Connect Devices

● Connect Power Jack

● Connect VINT Device(s)

● Connect Ethernet to a Router or Switch (optional)

## Step 3: Verify Connection

Choose a setup method:

## Step 3: Connect Wireless

1. When you connect the power supply to the HUB5000, the red LED should turn on.

## Step 3: Connect Wireless

2. On your mobile device, go to the Wi-Fi settings and connect to the HUB5000:

## Step 3: Connect Wireless

4. Once your device is connected to the HUB5000’s WiFi signal:

Click on the WiFi network and find an option that says “Manage router” or “Visit homepage”.

Go to your internet browser and type 192.168.100.1 in the address bar.

## Step 3: Connect Wireless

5. Create a password for your HUB5000. You'll use this password to access the Configure Page from now on.

## Step 3: Connect Wireless

6. Navigate to the network page. Change the Mode to Client.

## Step 3: Connect Wireless

7. Enter your Wifi Network details and click Save & Apply. It may take a few minutes for your Phidgets to appear in the Phidget Control Panel, which we’ll check in the next step.

## Step 4: Verify Connection

1. The easiest way to verify that your libraries are working properly is to compile and run an example program. Download and unpack this C example that will detect any Phidget:

## Step 3: Verify Connection

2. Next, open the terminal in the location where you unpacked the example. Compile and run using:

gcc HelloWorld.c -o HelloWorld -lphidget22
sudo ./HelloWorld

ou should receive a “Hello” line for each Phidget channel that is discovered:

I don’t see any Phidgets show up in the HelloWorld example

You need to run it with sudo in order to be able to access USB devices. In order to use Phidgets without sudo, you need to set your udev rules. See the Advanced Information page on the final slide of this guide for details.

## Done!

If you're able to see your devices in the Hello World example, you're done with the Setup part of this guide.

Scroll down to Part 2: Using Your Phidget for the next step.

## Step 3: Connect Wireless

1. When you connect the power supply to the HUB5000, the red LED should turn on.

## Step 3: Connect Wireless

3. Create a password for your HUB5000. You'll use this password to access the Configure Page from now on.

## Step 3: Connect Wireless

4. Navigate to the network page. Change the Mode to Client.

## Step 3: Connect Wireless

5. Enter your Wifi Network details to use your Hub wirelessly and click Save & Apply. You can then disconnect the ethernet cable.

It may take a few minutes for your Phidgets to appear in the Phidget Control Panel, which we’ll check in the next step.

## Step 4: Verify Connection

1. The easiest way to verify that your libraries are working properly is to compile and run an example program. Download and unpack this C example that will detect any Phidget:

## Step 3: Verify Connection

2. Next, open the terminal in the location where you unpacked the example. Compile and run using:

gcc HelloWorld.c -o HelloWorld -lphidget22
sudo ./HelloWorld

ou should receive a “Hello” line for each Phidget channel that is discovered:

I don’t see any Phidgets show up in the HelloWorld example

You need to run it with sudo in order to be able to access USB devices. In order to use Phidgets without sudo, you need to set your udev rules. See the Advanced Information page on the final slide of this guide for details.

## Done!

If you're able to see your devices in the Hello World example, you're done with the Setup part of this guide.

Scroll down to Part 2: Using Your Phidget for the next step.

## Step 1: Install Phidgets Library

Before you begin using your Phidgets, you will need to install the Phidget Library.

If you're unsure which one you should get, press ⊞ WIN + Pause/Break:

3a. Select Next.

## Step 1: Install Phidgets Library

3b. Read the Licence Agreement. Select Next.

## Step 1: Install Phidgets Library

3c. Choose Installation Location. Select Next.

3d. Select Next.

## Step 1: Install Phidgets Library

3e. Wait for Installation to complete. This should only take a few moments.

## Step 1: Install Phidgets Library

3f. Installation Complete. Close installation Window.

## Step 2: Connect Devices

● Connect Power Jack

● Connect VINT Device(s)

● Connect Ethernet to a Router or Switch in the same network as your Windows PC

## Step 3: Verify Connection

1. Open the Phidgets Control Panel:

## Step 3: Verify Connection

2. If connected, your Phidgets will appear in the Phidget Control Panel.

Now that the SBC's ethernet connection is verified, it can be connected to wifi.

If you don't have a USB wifi adapter or you're planning to stay on ethernet, you can scroll down to

## Step 4: Connect Wireless

2. Create a password for your SBC. You'll use this to access the configuration page from now on.

## Step 4: Connect Wireless

3. Navigate to Network -> Wireless. Select your Network, enter the wifi password and select Add This Network.

## Step 4: Connect Wireless

4. Scroll down to your saved networks, click on your network and select Join This Network.

## Step 4: Connect Wireless

5. It should now say connected in the status column.

You can now unplug the ethernet cable.

## Done!

If you're able to see and interact with your devices in the Phidget Control Panel, you're done with the Setup part of this guide.

Scroll down to Part 2: Using Your Phidget for the next step.

For more help installing in Windows (e.g. manual install, using a VM, etc.), visit this page:

## Step 1: Install Phidgets Library

Before you begin using your Phidgets, you will need to install the Phidget Library.

## Step 1: Install Phidgets Library

3a. Select Continue

## Step 1: Install Phidgets Library

3c. Here, you have the option to select the installation location. Select Install.

## Step 1: Install Phidgets Library

3e. Wait for Installation to complete. This should only take a few moments.

## Step 1: Install Phidgets Library

3f. You may see a message that the extension has been blocked. Select Open Security Preferences.

3g. Click Allow.

## Step 1: Install Phidgets Library

3h. Installation Complete, Click Close.

## Step 1: Install Phidgets Library

3i. To delete the installer, click Move to Trash.

## Step 2: Connect Devices

● Connect Power Jack

● Connect VINT Device(s)

● Connect Ethernet to a Router or Switch in the same network as your Mac

## Step 3: Verify Connection

1. Open the Phidget Control Panel:

## Step 3: Verify Connection

2. If connected, your Phidgets will appear in the Phidget Control Panel.

Now that the SBC's ethernet connection is verified, it can be connected to wifi.

If you don't have a USB wifi adapter or you're planning to stay on ethernet, you can scroll down to

## Step 4: Connect Wireless

2. Create a password for your SBC. You will use this to access the configuration page from now on.

## Step 4: Connect Wireless

3. Navigate to Network -> Wireless. Select your Network, enter the wifi password and select Add This Network.

## Step 4: Connect Wireless

4. Scroll down to your saved networks, click on your network and select Join This Network.

## Step 4: Connect Wireless

5. It should now say connected in the status column.

You can now unplug the ethernet cable.

## Done!

If you're able to see and interact with your devices in the Phidget Control Panel, you're done with the Setup part of this guide.

Scroll down to Part 2: Using Your Phidget for the next step.

## Step 1: Install Phidgets Library

1. First, you need to install the libusb-1.0 development libraries. For example, in Debian based distributions:

apt-get install libusb-1.0-0-dev

You’ll also need a C compiler and builder, if you don’t already have one installed.

apt-get install gcc
apt-get install make

## Step 1: Install Phidgets Library

3. Use the following commands in the location you unpacked to install the library:

./configure
make
sudo make install

## Step 1: Install Phidgets Library

4. (Optional) You can also download and unpack the following optional packages:

phidget22networkserver - Phidget Network Server, which enables the use of Phidgets over your network

phidget22admin - Admin tool to track who is connected to your Phidgets when using the network server

libphidget22extra - Required for phidget22networkserver and phidget22admin

libphidget22java - The Java libraries for Phidget22

For installation instructions for these packages, see the README file included with each one.

## Step 2: Connect Devices

● Connect Power Jack

● Connect VINT Device(s)

● Connect Ethernet to a Router or Switch in the same network as your Linux machine

## Step 3: Verify Connection

1. The easiest way to verify that your libraries are working properly is to compile and run an example program. Download and unpack this C example that will detect any Phidget:

## Step 3: Verify Connection

2. Next, open the terminal in the location where you unpacked the example. Compile and run using:

gcc HelloWorld.c -o HelloWorld -lphidget22
sudo ./HelloWorld

If everything is working, you should receive a “Hello” line for each Phidget channel that is discovered:

I don’t see any Phidgets show up in the HelloWorld example

You need to run it with sudo in order to be able to access USB devices. In order to use Phidgets without sudo, you need to set your udev rules. See the Advanced Information page on the final slide of this guide for details.

Now that the SBC's ethernet connection is verified, it can be connected to wifi.

If you don't have a USB wifi adapter or you're planning to stay on ethernet, you can scroll down to

## Step 4: Connect Wireless

If you're using a terminal-only Linux machine, use the browser on your phone instead.

(If you use a phone, you need to enter the IP address your router assigned to the SBC instead of phidgetsbc.local)

## Step 4: Connect Wireless

2. Create a password for your SBC. You will use this to access the configuration page from now on.

## Step 4: Connect Wireless

3. Navigate to Network -> Wireless. Select your Network, enter the wifi password and select Add This Network.

## Step 4: Connect Wireless

4. Scroll down to your saved networks, click on your network and select Join This Network.

## Step 4: Connect Wireless

5. It should now say connected in the status column.

You can now unplug the ethernet cable.

## Step 4: Connect Wireless

6. Run the HelloWorld example again to confirm that your Phidgets are accessible over wifi.

## Done!

If you're able to see your devices in the Hello World example, you're done with the Setup part of this guide.

Scroll down to Part 2: Using Your Phidget for the next step.

## Part 2: Using Your Phidget

The 2-axis Thumbstick Phidget tracks the horizontal and vertical position of the stick between -1 and 1. The stick will snap back to the center when released. The thumbstick can also be clicked down to activate a push-button, similar to a video game controller.

### Explore Your Phidget Channels Using The Control Panel

1. Open your Control Panel, and you will find the following channels:

2. Double click on a channel to open an example program.

Expand All
Joystick Axis: Reports the tilt of the joystick (Channel 0 for up/down and channel 1 for left/right)

In your Control Panel, double click on "Joystick Axis":

Joystick Button: Reports the state of the pushbutton

In your Control Panel, double click on "Joystick Button":

## Part 4: Advanced Topics and Troubleshooting

Expand All
How do I know what channel, serial number, or hub port to use in my program?

Before you open a Phidget channel in your program, you can set these properties to specify which channel to open. You can find this information through the Control Panel.

1. Open the Control Panel and double-click on the red map pin icon:

2. The Addressing Information window will open. Here you will find all the information you need to address your Phidget in your program.

See the Phidget22 API for your language to determine exact syntax for each property.

Setting the Change Trigger and Data Interval

The Change Trigger is the minimum change in the sensor data needed to trigger a new data event. The Data Interval is the time (in ms) between data events sent out from your Phidget. You can modify one or both of these values to achieve different data outputs. You can learn more about these two properties here.

MacOS users can upgrade device firmware by double-clicking the device row in the Phidget Control Panel.

Windows users can upgrade the firmware for this device using the Phidget Control Panel as shown below.

Firmware upgrades include important bug fixes and performance improvements, but there are some situations where you may want to revert to an old version of the firmware (for instance, when an application you're using is compiled using an older version of phidget22 that doesn't recognize the new firmware).

MacOS and Linux users can downgrade using the phidget22admin tool in the terminal (see included readme for instructions).

Windows users can downgrade directly from the Phidget Control Panel if they have driver version 1.9.20220112 or newer:

Firmware Version Numbering Schema

Phidgets device firmware is represented by a 3-digit number. For firmware patch notes, see the device history section on the Specifications tab on your device's product page.

• If the digit in the 'ones' spot changes, it means there have been bug fixes or optimizations. Sometimes these changes can drastically improve the performance of the device, so you should still upgrade whenever possible. These upgrades are backwards compatible, meaning you can still use this Phidget on a computer that has Phidget22 drivers from before this firmware upgrade was released.
• If the digit in the 'tens' spot changes, it means some features were added (e.g. new API commands or events). These upgrades are also backwards compatible, in the sense that computers running old Phidget22 drivers will still be able to use the device, but they will not be able to use any of the new features this version added.
• If the digit in the 'hundreds' spot changes, it means a major change has occurred (e.g. a complete rewrite of the firmware or moving to a new architecture). These changes are not backwards compatible, so if you try to use the upgraded board on a computer with old Phidget22 drivers, it will show up as unsupported in the Control Panel and any applications build using the old libraries won't recognize it either. Sometimes, when a Phidget has a new hardware revision (e.g. 1018_2 -> 1018_3), the firmware version's hundreds digit will change because entirely new firmware was needed (usually because a change in the processor). In this case, older hardware revisions won't be able to be upgraded to the higher version number and instead continue to get bug fixes within the same major revision.
Converting to Polar Coordinates

For some applications, you may want to convert the 2-axis data of the Thumbstick Phidget into an angle and magnitude. This can be helpful if you want to use it like a video game controller. You can use the following formulas:

${\displaystyle {\text{r}}={\sqrt {x^{2}+y^{2}}}}$
${\displaystyle \phi =atan2(x,y)}$

Where r is the magnitude, ϕ is the angle, and x and y are the two axis values. Atan2 is the 2-argument arctangent function, which you can find in most math libraries. For example, in C# you could use Math.Atan2(x,y). Depending on your language, ϕ may be in radians or degrees. Since x and y range from -1.0 to 1.0, the resulting r will range from -√2 to √2, so you may also want to modify the first formula like so:

${\displaystyle {\text{r}}={\frac {\sqrt {x^{2}+y^{2}}}{\sqrt {2}}}}$

This way, your r will range from 0 to 1, which is more intuitive than -√2 to √2.

#### Product Specifications

Sensor Properties
Controlled By VINT
VoltageRatio Input Resolution 0.0021
Electrical Properties
Current Consumption (Unconfigured) 20 μA
Current Consumption Max * 1 mA
Physical Properties
Operating Temperature Min -40 °C
Operating Temperature Max 85 °C
Customs Information
American HTS Import Code 8471.80.40.00
Country of Origin CN (China)

* - Current consumption varies depending on selected data interval. See the graph below for details.

#### Product History

Date Board Revision Device Version Comment
September 2017 0104Product Release
January 2018 0105Library bug fixes
October 2021 0106ChangeTrigger now functions independently for each axis

#### Code Samples

 Choose a Language Choose a Device Serial Number: ?

#### Example Options

				Make your selections to display sample code.


#### Code Samples

Language:

APIDetailLanguageOS

#### Software Objects

Channel NameAPIChannel
Thumbstick Axis VoltageRatioInput 0 - 1
Thumbstick Button DigitalInput 0

#### API

 Choose a Language C C# / VB.NET Java JavaScript Max/MSP Python Swift Phidget Manager Networking NetworkConnection USBConnection Logging Dictionary

Back Forward
Print this API

#### Have a look at our other thumbsticks:

Product Sensor Properties
Part Number Price Controlled By
Mini Joy Stick Sensor
$5.00 VoltageRatio Input, Digital Input (5V) Thumbstick Phidget$20.00 VINT