Phidgets Support - User contributions [en]

Terms and Conditions

2026-09-11T15:22:52Z

Lmpacent: /* Payment Terms */

[[Category:Linked From Website]]

==Product Warranty==

All Phidgets products are warranted to be free of defects in material or workmanship under normal use and service for a period of one year from the date of shipment. This warranty does not include damage resulting from accident or misuse. The warranty is also void if the product is modified. This warranty is in lieu of all other warranties expressed or implied including the implied warranties of merchantability of fitness for a particular purpose, whether arising by law, custom or conduct, and the rights and remedies provided under this warranty are exclusive and in lieu of any other rights or remedies. In no event shall Phidgets Incorporated be liable for consequential damages.

If you believe that your product is defective while still under warranty, {{ContactUs|contact us}}. Once the support desk confirms that the product is defective, we will replace your defective product free of charge.

==Shipping==
===Last Call at 12:00PM===
Orders received before 12:00 PM Mountain Time (GMT-07:00) Monday to Friday will be shipped the same day.

Orders containing cut-to-length parts may not ship on the same day due to the additional processing time associated with these orders.

===Shipping Costs===
Shipping costs are calculated at checkout and presented for your review before you confirm your order. If multiple shipping options are available for your destination, all options will be listed so you can choose the one that best suits your needs.

If you have your own UPS or FedEx account, you can use it at checkout and be billed directly by the carrier. This gives you access to a wider range of shipping options.

Note that a $5.00 handling charge is added to all orders that are under $50.00.

===Shipping in Canada===
We offer the following services:
* '''UPS Express Saver'''. 1 - 3 business days.
* '''UPS Expedited'''. 2 - 5 business days. Available for packages over 3 lbs.
* '''UPS Standard'''. 3 - 5 business days ground delivery.

===Shipping to the United States===
We offer the following services:
* '''UPS Express Saver'''. 1 - 3 business days.
* '''UPS Expedited'''. 2 - 5 business days. Available for packages over 3 lbs.
* '''UPS Standard'''. 3 - 5 business days ground delivery.

Effective May 2, 2025, orders shipped to the United States will incur additional duties, tariffs, and brokerage fees, regardless of the order value. For more details, visit our guide about [[U.S._Tariffs | U.S. Tariffs]].

===International Shipments===
We offer the following services:
* '''UPS Worldwide Express Saver'''. 1 - 3 business days.
* '''UPS Worldwide Expedited'''. 2 - 5 business days. Available for packages over 3 lbs.

====European Union====
Effective July 1, 2021, the European Union (EU) updated its Value Added Tax (VAT) regulations. All shipments to EU countries now require formal customs clearance and are subject to VAT based on the destination country.

For goods with an intrinsic value up to €150, VAT must be collected at the time of purchase. This means for orders under $200 USD, we require prepayment of VAT and brokerage fees at checkout to ensure fast, hassle-free delivery.

For orders over $200 USD, we provide the option to prepay all applicable import fees (including VAT and brokerage). If you choose this option, the quoted amount is guaranteed — there will be no additional charges upon delivery.

We use UPS® Global Checkout to collect import fees and taxes based on your product's HS Code and Country of Origin. There is a fee associated with the UPS® Global Checkout service. At Phidgets Inc., we continually monitor and negotiate all fees to ensure our customers receive the best deal possible.

Customs policies vary by country, so we recommend contacting your local customs office for more information.

====Other Countries====
International shipments may be subject to import duties, taxes, and brokerage fees upon arrival in your country. These charges are determined by your local customs authorities and are the responsibility of the recipient.

At checkout, we provide the option to prepay these fees. If you choose this option, the quoted amount is guaranteed — there will be no additional charges upon delivery.

We use UPS® Global Checkout to collect import fees and taxes based on your product's HS Code and Country of Origin. There is a fee associated with the UPS® Global Checkout service. At Phidgets Inc., we continually monitor and negotiate all fees to ensure our customers receive the best deal possible.

Customs policies vary by country, so we recommend contacting your local customs office for more information.

===Tracking Your Order===
You can track your shipment using the tracking number sent to you by email when your order was shipped.

===Refunds on Late Deliveries===

Normally, UPS will offer a service guarantee refund when their deliveries arrive late. However, for companies that apply for shipping discounts, this refund does not apply. Phidgets Inc. has applied for such discounts in order to keep shipping costs down and regrettably cannot offer compensation for late shipments.

===Damaged or Lost Shipment===

'''Shipping on our UPS account''' - Report all damaged or lost shipments to support@phidgets.com and include your order number. According to UPS, in order to be considered lost, a package must be undelivered 24 hours after the expected delivery date and time. Before contacting us, check your shipment status at ups.ca.

Damaged or lost items will be replaced at no charge (including shipping costs).

'''Shipping on your UPS account''' - You must notify your local UPS office. If they confirm that they have lost your shipment, you must repurchase the lost or damaged products from Phidgets and file a claim with your local UPS in order to get reimbursed.

===Refused/Missed Delivery===
If no one is available to accept the package upon delivery, UPS will attempt redelivery two more times, as per their standard procedure. If all delivery attempts fail, UPS will hold the package for 5 days before returning it to us. In such cases, we will issue a refund for your order minus the cost of shipping (both directions) and a flat $50 fee, up to the total value of the package. This policy applies both to deliveries that failed due to no one being present and to packages that were refused at the delivery address.

===Incoterms===

We use the following Incoterms depending on the shipping and payment arrangement:

* '''FCA (Free Carrier):''' Used when shipping on the customer’s carrier account. Risk and responsibility transfer to the customer once the goods are handed over to the carrier at our facility.

* '''DDP (Delivered Duty Paid):''' Used when the customer chooses to pre-pay import fees and taxes at checkout. We handle all import fees and deliver the goods to the destination address.

* '''DAP (Delivered at Place):''' Used when the customer opts to pay import fees and taxes upon delivery. We deliver the goods, but the customer is responsible for paying any import fees directly to the carrier.

==Product Returns==
===All Returns Must Be Authorized===
Before returning a package {{ContactUs|contact us}} and ask for a Return Merchandise Authorization or RMA number. Once you have received it, put the RMA number on the outside of the packaging as well as the packing slip so that it is possible for us to track what the package is supposed to be. Any merchandise returned without an RMA number clearly visible on the packaging will be charged an administrative fee of $25.00 or the value of the returned product, whichever is less ''if we are able to determine what it is''. In the event we are unable to determine what the package is, it will be refused and returned to the sender.

===Unopened Product===
Phidgets accepts returns of unopened products within 30 days of the date of purchase. To initiate a return, please contact us by phone or email to obtain an RMA number. Products must be shipped back to Phidgets Inc. prepaid. A refund will be issued to your credit card once we receive and inspect the returned items. The refund excludes the cost of shipping as well as any duties or brokerage charges incurred.

Returns received after 30 days are subject to a restocking fee of 25% of the package's value (minimum $5.00, maximum $500).

We do '''not''' accept returns beyond 90 days from the date of purchase.

===Cut to Length===
Unfortunately we cannot accept returns on any items which are cut to custom lengths. This includes: cable, wire, roller chain, linear shaft, rotary shaft, and t-slot extrusions.

===We Shipped the Wrong/Incomplete Product===
{{ContactUs|Contact us}}. We will get the correct product sent to you immediately, and will pay all shipping charges.

==Payment Terms==
We accept credit cards, PayPal, and Wire Transfers.

{| style="border:1px solid darkgray;" cellpadding="7px;"
|-style="background: #d1d1d1" align=center
! Payment Method|| Terms
|-
|style="background: #f0f0f0" align=center|Credit Cards
|style="background: #f0f0f0" align=left|Visa, MasterCard, American Express (for order in CAD only)
|-
|style="background: #f0f0f0" align=center|PayPal
|style="background: #f0f0f0" align=left|PayPal is accepted. There are no extra fees for using PayPal
|-
|style="background: #f0f0f0" align=center|Wire Transfers
|style="background: #f0f0f0" align=left|Wire transfers are only accepted for orders over $200.00 USD (excluding shipping charges). There is a $25.00 USD charge for wire transfers under $500.00 USD. Any fees charged by the sending bank are your responsibility.<br />Please make sure that the amount sent to us covers both our invoice and your bank fees. Products are not shipped until the money is deposited in our bank account. We recommend that you e-mail sales@phidgets.com with the amount of the transfer and the invoice you are paying. <br />Any order for which payment is not received within 15 days, will be canceled.
|}
===Sales Tax===
Applicable state, provincial, or country sales tax will be charged where required, unless a valid exemption or resale certificate has been submitted to and approved by Phidgets Inc.

To apply for tax-exempt status, please email the following to [mailto:sales@phidgets.com sales@phidgets.com]:
* Your Phidgets customer account name or the email address associated with your account
* A PDF copy of your tax exemption or resale certificate, including the organization name and any applicable ID numbers

If an order is placed before your exemption status has been reviewed and approved, applicable taxes will be charged.

All taxes collected are remitted to the appropriate governing authorities in accordance with applicable laws and regulations.

==Security and Privacy==
Phidgets Inc. pledges a safe and worry-free shopping experience. If you are using the current version of Internet Explorer, on the checkout page where you enter your credit card information, you will notice a a locked padlock icon on the top bar your browser window. If you are using Mozilla Firefox, you will notice a locked padlock icon in the bottom right corner of your browser window. If this icon does not appear, please contact us directly to complete your purchase. These icons tell you that the page you are on is secure. We use Secure Sockets Layer (SSL 128-bit) technology with a digital certificate by GeoTrust, Inc. for Internet security to protect your personal information. This encryption makes it impossible for anyone to read your information in transit. We do not store your credit information and it is deleted once it has been securely transmitted to Moneris for processing.

We use your e-mail address to let you know your shipment's tracking number. Your phone number is required by the Courier Company. We do not sell, rent or give any of your personal information to any unrelated third parties with the exception of Moneris for authorizing credit card payments and the Courier company to let them know where to deliver the shipment and how to contact you if there is any problems.

{{ContactUs|Contact us}} if you have any questions or concerns about our Security and Privacy policy.

Phidgets Inc. uses various Google Analytics tools such as conversion tracking in order to improve the effectiveness of the website. These statistics are completely anonymous.

==Holidays==
Phidgets, Inc. will be closed on the following days. During these times, the site will still be accessible and orders can be placed, but they will not ship until the next business day.

{| style="border:1px solid darkgray;" cellpadding="7px;"
|-style="background: #d1d1d1" align=center
! style="text-align:center;"| Holiday
! style="text-align:center;"| Description
! style="text-align:center;"| 2026
! style="text-align:center;"| 2027
|-
|style="background: #f0f0f0" align=center| Alberta Family Day
|style="background: #f0f0f0" align=center| Third Monday in February
|style="background: #f0f0f0" align=center| Feb 16
|style="background: #f0f0f0" align=center| Feb 15
|-
|style="background: #f0f0f0" align=center| Good Friday
|style="background: #f0f0f0" align=center| Friday before Easter Sunday
|style="background: #f0f0f0" align=center| Apr 3
|style="background: #f0f0f0" align=center| Mar 26
|-
|style="background: #f0f0f0" align=center| Victoria Day
|style="background: #f0f0f0" align=center| Monday before May 25
|style="background: #f0f0f0" align=center| May 18
|style="background: #f0f0f0" align=center| May 24
|-
|style="background: #f0f0f0" align=center| Canada Day
|style="background: #f0f0f0" align=center| First day of July (or nearest business day)
|style="background: #f0f0f0" align=center| Jul 1
|style="background: #f0f0f0" align=center| Jul 1
|-
|style="background: #f0f0f0" align=center| Civic Holiday
|style="background: #f0f0f0" align=center| First Monday in August
|style="background: #f0f0f0" align=center| Aug 3
|style="background: #f0f0f0" align=center| Aug 2
|-
|style="background: #f0f0f0" align=center| Labour Day
|style="background: #f0f0f0" align=center| First Monday in September
|style="background: #f0f0f0" align=center| Sept 7
|style="background: #f0f0f0" align=center| Sept 6
|-
|style="background: #f0f0f0" align=center| Thanksgiving
|style="background: #f0f0f0" align=center| Second Monday in October
|style="background: #f0f0f0" align=center| Oct 12
|style="background: #f0f0f0" align=center| Oct 11
|-
|style="background: #f0f0f0" align=center| Remembrance Day
|style="background: #f0f0f0" align=center| November 11 (or nearest business day)
|style="background: #f0f0f0" align=center| Nov 11
|style="background: #f0f0f0" align=center| Nov 11
|-
|style="background: #f0f0f0" align=center| Christmas and New Years
|style="background: #f0f0f0" align=center| Varies
|style="background: #f0f0f0" align=center| TBA
|style="background: #f0f0f0" align=center| TBA
|-
|}

File:Phidgets logo circle small.png

2026-09-02T21:58:08Z

Lmpacent:

File:Phidgets-HexLogo-Wide-Medium.png

2026-08-31T18:04:21Z

Lmpacent:

File:Phidgets-HexLogo-Icon-Medium circle.png

2026-08-31T17:22:06Z

Lmpacent:

Draw-Wire Sensor Guide

2026-07-31T18:49:53Z

Lmpacent: /* Which Draw-Wire Sensor Should I Use? */

{{#seo:|description=What is a draw-wire sensor? Learn what a draw-wire sensor is, how they work, and how you can use them with Phidgets.}}
__TOC__
[[Category:IntroGuide]]
[[Image:Drawwire_intro.jpg|400px|link=https://cdn.phidgets.com/docs/images/7/73/Drawwire_intro.jpg|thumb|<center>Draw-wire encoder ([https://www.phidgets.com/?prodid=1260 ENC4118_0])</center>]]
==What Is a Draw-Wire Sensor?==
Draw-wire sensors provide an accurate and cost-effective method of measuring an object's linear position and/or speed.

As the draw-wire is pulled from the housing, a digital signal is generated which provides precise information about the length of the extended draw-wire.
<br><br>
===Example - Length Measurement===
[[File:drawwire_example.webm|600px|center]]
<center>''The [https://www.phidgets.com/?prodid=1260 ENC4118] is used with an [https://www.phidgets.com/?prodid=959 Quadrature Encoder Phidget] and a [https://www.phidgets.com/?tier=2&catid=64&pcid=57 VINT Hub Phidget] (offscreen) to measure length. The results are displayed on a [https://www.phidgets.com/?prodid=963 Graphic LCD Phidget]</center>
<br><br>
==Which Draw-Wire Sensor Should I Use?==
Phidgets Inc. currently offers three types of draw-wire sensors:<br><br>
{| style="margin:auto;width:85%;"
|-
! Product ID !! !! Draw-Wire Length !! Resolution !! Max Pull Speed !! Max Wire Load !! Index Signal
|-
| [https://www.phidgets.com/?prodid=1260 ENC4118_0] || || 1m || 10µm || 300mm/s || 500g || Yes ||[[Image:ENC4118_0.jpg|200px|link=https://cdn.phidgets.com/docs/images/8/84/ENC4118_0.jpg]]
|-
| [https://www.phidgets.com/?prodid=1261 ENC4119_0] || || 3m || 20µm || 300mm/s || 500g || Yes ||[[Image:ENC4119_0.jpg|200px|link=https://cdn.phidgets.com/docs/images/7/73/ENC4119_0.jpg]]
|-
| [https://www.phidgets.com/?prodid=1396 ENC4129_0] || || 5m || 10µm || 300mm/s || 500g || Yes ||[[Image:ENC4129_0.jpg|200px|link=https://cdn.phidgets.com/docs/images/a/a3/ENC4129_0.jpg]]
|}

==How Do I Get Data From My Draw-Wire Sensor?==
All draw-wire sensors sold by Phidgets Inc. connect directly to our [https://www.phidgets.com/?tier=1&catid=4&pcid=2 encoder interfaces].

[[Image:Enc1000_drawwire_connected.jpg|600px|link=https://cdn.phidgets.com/docs/images/7/77/Enc1000_drawwire_connected.jpg|center]]

The encoder interface will monitor the output of the draw-wire sensor and update your software with an easy-to-use encoder count value.

There are also encoder interfaces built into many of our [https://www.phidgets.com/?tier=1&catid=71&pcid=15 Motor Controllers]. If your project includes a motor controller, the onboard encoder interface is a great option for our draw-wire sensors.

===Converting Encoder Count to Length===
[[Image:Drawwire_resolution.png|400px|link=https://cdn.phidgets.com/docs/images/f/f2/Drawwire_resolution.png|thumb|<center>Resolution Specification for the [https://www.phidgets.com/?prodid=1260#Tab_Specifications ENC4118_0]</center>]]
To convert from encoder pulses to length, use the '''resolution''' specification that is provided on the product page of your draw-wire sensor.

This value can be found on the ''Specifications'' tab and is presented as '''micrometers per pulse.''' For more information, review the example code below.
<br><br><br>
====Example Code====
The code below is derived from the [https://www.phidgets.com/?view=code_samples Phidget Code Sample Generator]. It shows how to convert position data from an encoder interface into a length measurement.

Click on your preferred programming language to view the code example.
<tabber>
Python=<syntaxhighlight lang=python>
from Phidget22.Phidget import *
from Phidget22.Devices.Encoder import *
import time

def onPositionChange(self, positionChange, timeChange, indexTriggered):
resolution = 10E-6 #The ENC4118_0 has a resolution of 10um/pulse, replace with your product's resolution
meters = self.getPosition() * resolution
print("Length: " + str(round(meters, 3)) + " m")

def main():
encoder0 = Encoder()

encoder0.setOnPositionChangeHandler(onPositionChange)

encoder0.openWaitForAttachment(5000)

time.sleep(5)

encoder0.close()

main()
</syntaxhighlight>
|-|
Java=<syntaxhighlight lang=java>
import com.phidget22.*;
import java.lang.InterruptedException;

public class Java_Example {

public static void main(String[] args) throws Exception {
Encoder encoder0 = new Encoder();

encoder0.addPositionChangeListener(new EncoderPositionChangeListener() {
public void onPositionChange(EncoderPositionChangeEvent e) {
try {
Encoder evChannel = (Encoder) e.getSource();
double resolution = 10E-6; //The ENC4118_0 has a resolution of 10um/pulse, replace with your product's resolution
double meters = evChannel.getPosition() * resolution;
System.out.println("Length: " + Math.round(meters * 1000.0) / 1000.0 + " m");
} catch (PhidgetException ex) {
ex.printStackTrace();
System.out.println("PhidgetException " + ex.getErrorCode() + " (" + ex.getDescription() + "): " + ex.getDetail());
}
}
});

encoder0.open(5000);

Thread.sleep(5000);

encoder0.close();
}
}
</syntaxhighlight>
|-|
C#=<syntaxhighlight lang=cSharp>
using System;
using Phidget22;

namespace ConsoleApplication
{
class Program
{

private static void Encoder0_PositionChange(object sender, Phidget22.Events.EncoderPositionChangeEventArgs e)
{
Phidget22.Encoder evChannel = (Phidget22.Encoder)sender;
double resolution = 10E-6; //The ENC4118_0 has a resolution of 10um/pulse, replace with your product's resolution
double meters = evChannel.Position * resolution;
Console.WriteLine("Length: " + Math.Round(meters, 3) + " m ");
}

static void Main(string[] args)
{
Encoder encoder0 = new Encoder();

encoder0.PositionChange += Encoder0_PositionChange;

encoder0.Open(5000);

System.Threading.Thread.Sleep(10000);

encoder0.Close();
}
}
}
</syntaxhighlight>
|-|
C=<syntaxhighlight lang=c>
#include <phidget22.h>
#include <stdio.h>
/* Determine if we are on Windows of Unix */
#ifdef WIN32
#include <windows.h>
#else
#include <unistd.h>
#define Sleep(x) usleep((x) * 1000)
#endif

static void CCONV onPositionChange(PhidgetEncoderHandle ch, void * ctx, int positionChange, double timeChange, int indexTriggered) {
int64_t position;
double resolution = 10E-6; //The ENC4118_0 has a resolution of 10um/pulse, replace with your product's resolution
PhidgetEncoder_getPosition(ch, &position);
double meters = resolution * position;
printf("Length: %.3f\n m", meters);
printf("----------\n");
}

int main() {
PhidgetEncoderHandle encoder0;

PhidgetEncoder_create(&encoder0);

PhidgetEncoder_setOnPositionChangeHandler(encoder0, onPositionChange, NULL);

Phidget_openWaitForAttachment((PhidgetHandle)encoder0, 5000);

Sleep(5000);

Phidget_close((PhidgetHandle)encoder0);

PhidgetEncoder_delete(&encoder0);
}
</syntaxhighlight>
</tabber>
====Speed Calculations====
If you are interested in calculating the speed of your draw-wire sensor, a simple Python example is provided below.

In order to implement more accurate speed calculations, review the [https://www.phidgets.com/?view=articles&article=EncoderVelocity Encoder Velocity: A Common Miscalculation] guide for more information.

<syntaxhighlight lang=python>
from Phidget22.Phidget import *
from Phidget22.Devices.Encoder import *
import time

def onPositionChange(self, positionChange, timeChange, indexTriggered):
resolution = 10E-6 #The ENC4118_0 has a resolution of 10um/pulse, replace with your product's resolution
speed = (positionChange * resolution) / (timeChange/1000.0)
print("Speed: " + str(round(speed, 3)) + " m/s")

def main():
encoder0 = Encoder()

encoder0.setOnPositionChangeHandler(onPositionChange)

encoder0.openWaitForAttachment(5000)

time.sleep(5000)

encoder0.close()

main()
</syntaxhighlight>

==Installation and Mounting==
M5 mounting holes are available on the back of the housing and on the end of the draw wire. For more information, view the mechanical drawings for your product which can be found on the product page under the ''Specifications'' tab.

<gallery mode="packed">
File:ENC4118_0_MountingHoles2.jpg | link=/images/7/79/ENC4118_0_MountingHoles2.jpg
File:ENC4118_0_MountingHoles.jpg | link=/images/3/35/ENC4118_0_MountingHoles.jpg
File:ENC4119_0_MountingHoles.jpg | link=/images/0/0b/ENC4119_0_MountingHoles.jpg
</gallery>

File:ENC4129 0.jpg

2026-07-31T18:48:59Z

Lmpacent:

Language - C

2026-06-11T21:08:33Z

Lmpacent: /* C Libraries */

{{#seo:|description=Learn how to use Phidget USB devices with C and C++.}}
[[Category:Language]]

== Get Started ==
With the Phidget22 library, it's easy to create C or C++ applications that work with Phidget devices.

== C Libraries ==
If you've installed the Phidget drivers for [[OS - Windows|Windows]], [[OS - macOS|macOS]], or [[OS - Linux|Linux]], then you already have the files you need for your C project.

==== Windows Considerations ====
When adding directories for your project dependencies, add
<syntaxhighlight>
C:/Program Files/Phidgets/Phidget22
</syntaxhighlight>
And for the linker, you can add
<syntaxhighlight>
C:/Program Files/Phidgets/Phidget22/phidget22.lib}} #(for 64-bit systems)
C:/Program Files/Phidgets/Phidget22/x86/phidget22.lib}} #(for 32-bit systems)
</syntaxhighlight>

====macOS Considerations====
Legacy Phidgets running a HID USB stack require a driver extension (macOS 10.15 and newer) or a kernel extension (macOS 10.14 and earlier). During development, we recommend downloading the appropriate [https://www.phidgets.com/docs/OS_-_macOS#Quick_Downloads package] which will install the extension. When deploying applications, review the README in the [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip macOS Development Files] for information about bundling the extension with your application.

=====Determining USB Stack=====
To determine which USB stack your device is running, navigate to the product page and then to the specification tab, and look for the ''USB Stack'' specification. If you are using a VINT device, navigate to the product page for the VINT Hub you are using.

[[Image:Javascript_networkserver_webusb_spec.png|center|600px|link=https://cdn.phidgets.com/docs/images/8/80/Javascript_networkserver_webusb_spec.png]]

====Linux Considerations====
Linux restricts access to USB devices to the root user.

To run your C application as a regular user, you'll need to [{{SERVER}}/docs/OS_-_Linux#Setting_udev_Rules set up udev rules] on your system.

=== Library Files ===
If you would like to manually manage the Phidget22 library files, you can download them [https://cdn.phidgets.com/downloads/phidget22/libraries/windows/Phidget22-windevel.zip here].

== Development Environment Configuration ==

=== GCC ===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
|
The most common tool for C development is GCC, whether used in the command line or through an IDE. GCC is packaged with many other IDEs and packages, so you may already have it installed.

{{hiddenh4|Windows}}
We recommend installing [https://www.cygwin.com/ Cygwin] or [https://sourceforge.net/projects/mingw/ MinGW], ensuring you select all gcc packages when prompted by the installer.

To compile your code, go to the folder where your code is and open the command prompt by typing 'cmd' in the address bar.

The specific command you will use depends on your compiler of choice:
<syntaxhighlight lang=bash>
#Cygwin x86:
gcc example.c -o example -I"/cygdrive/c/Program Files/Phidgets/Phidget22"-L"/cygdrive/c/Program Files/Phidgets/Phidget22/x86" -lphidget22

#Cygwin x64:
gcc example.c -o example -I"/cygdrive/c/Program Files/Phidgets/Phidget22" -L"/cygdrive/c/Program Files/Phidgets/Phidget22" -lphidget22

#MinGW:
gcc example.c -o example -I"C:/Program Files/Phidgets/Phidget22" -L"C:/Program Files/Phidgets/Phidget22/x86" -lphidget22
</syntaxhighlight>

After running the commands above for either Cygwin or MinGW, an executable file called example.exe will be created. Enter the following command to run the program:
<syntaxhighlight lang=bash>
./example.exe
</syntaxhighlight>
{{hiddenh4|MacOS}}
If you don't already have gcc installed, you can get it by installing [https://developer.apple.com/xcode/ Xcode].

To compile the program, enter the following command in the terminal, substituting "example" for the name of your C file:
<syntaxhighlight lang=bash>
gcc example.c -o example -F /Library/Frameworks -framework Phidget22 -I /Library/Frameworks/Phidget22.framework/Headers
</syntaxhighlight>
Finally, run the program by entering the following command in the terminal:
<syntaxhighlight lang=bash>
./example
</syntaxhighlight>
Success! The project is now running with Phidgets.

{{hiddenh4|Linux}}
On Linux, gcc is installed through the package manager:
<syntaxhighlight lang=bash>
apt-get install gcc
</syntaxhighlight>
To compile the program, enter the following command in the terminal, substituting "example" for the name of your C file:
<syntaxhighlight lang=bash>
gcc example.c -o example -lphidget22
</syntaxhighlight>
After compiling, you can run the program by entering the following command in the terminal:
<syntaxhighlight lang=bash>
./example
</syntaxhighlight>
Success! The project is now running with Phidgets.
|-
|}

=== Visual Studio ===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
| If you want to jump right into a pre-configured project, you can download one on our [https://www.phidgets.com/?view=code_samples&lang=C Code Sample Generator] page. || [[Image:Language_C_VSProject.jpg|center|link=https://cdn.phidgets.com/docs/images/f/f1/Language_C_VSProject.jpg|350px]]
|-
| To configure a new project, follow these steps. ||
|-
| First, create a new Win32 Console Application: || [[Image:Language_C_VS_step1.jpg|center|link=https://cdn.phidgets.com/docs/images/a/a1/Language_C_VS_step1.jpg|350px]]
|-
| If you are using a 64-bit machine, select x64, otherwise, select x86: || [[Image:Language_C_VS_step2.jpg|center|link=https://cdn.phidgets.com/docs/images/6/6b/Language_C_VS_step2.jpg|350px]]
|-
| Next, right click on the source folder and click New Item: || [[Image:Language_C_VS_step3.jpg|center|link=https://cdn.phidgets.com/docs/images/e/e1/Language_C_VS_step3.jpg|350px]]
|-
| Give the source file a name and click Add: || [[Image:Language_C_VS_step4.jpg|center|link=https://cdn.phidgets.com/docs/images/e/e5/Language_C_VS_step4.jpg|350px]]
|-
| Right click your project and access its properties: || [[Image:Language_C_VS_step5.jpg|center|link=https://cdn.phidgets.com/docs/images/1/1e/Language_C_VS_step5.jpg|350px]]
|-
| Go to Configuration Properties -> C/C++ -> General and add this to the additional include directories:
<syntaxhighlight>
C:\Program Files\Phidgets\Phidget22
</syntaxhighlight>
|| [[Image:Language_C_VS_step6.jpg|center|link=https://cdn.phidgets.com/docs/images/d/d3/Language_C_VS_step6.jpg|350px]]
|-
| Go to Configuration Properties -> Linker -> Input and add the appropriate line to additional dependencies:
<syntaxhighlight>
C:\Program Files\Phidgets\Phidget22\phidget22.lib #(for 64-bit systems)
C:\Program Files\Phidgets\Phidget22\x86\phidget22.lib #(for 32-bit systems)
</syntaxhighlight>
|| [[Image:Language_C_VS_step7.jpg|center|link=https://cdn.phidgets.com/docs/images/0/09/Language_C_VS_step7.jpg|350px]]
|-
| Lastly, include the Phidget library at the beginning of your program:
<syntaxhighlight lang=bash>
#include < phidget22.h >
</syntaxhighlight>
||
|-
|}

=== PhidgetSBC Web Interface ===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+'''Instructions'''
|<center>{{#ev:youtube|2hTlVexctqY|rel=0}}</center>
|}

== Example Code ==
Navigate to our [https://www.phidgets.com/?view=code_samples&lang=C Code Sample Generator] to view and download code samples that are tailored to your specific device.

[[Image:Language_c_codesample2.png|center|600px|link=]]

===Phidget Programming Basics===
{{PhidgetProgrammingBasicsLink}}

==API==
[{{SERVER}}/?view=api&lang=C Phidget22 API]

Terms and Conditions

2026-05-06T18:30:50Z

Lmpacent: /* Sales Tax */

[[Category:Linked From Website]]

==Product Warranty==

All Phidgets products are warranted to be free of defects in material or workmanship under normal use and service for a period of one year from the date of shipment. This warranty does not include damage resulting from accident or misuse. The warranty is also void if the product is modified. This warranty is in lieu of all other warranties expressed or implied including the implied warranties of merchantability of fitness for a particular purpose, whether arising by law, custom or conduct, and the rights and remedies provided under this warranty are exclusive and in lieu of any other rights or remedies. In no event shall Phidgets Incorporated be liable for consequential damages.

If you believe that your product is defective while still under warranty, {{ContactUs|contact us}}. Once the support desk confirms that the product is defective, we will replace your defective product free of charge.

==Shipping==
===Last Call at 12:00PM===
Orders received before 12:00 PM Mountain Time (GMT-07:00) Monday to Friday will be shipped the same day.

Orders containing cut-to-length parts may not ship on the same day due to the additional processing time associated with these orders.

===Shipping Costs===
Shipping costs are calculated at checkout and presented for your review before you confirm your order. If multiple shipping options are available for your destination, all options will be listed so you can choose the one that best suits your needs.

If you have your own UPS or FedEx account, you can use it at checkout and be billed directly by the carrier. This gives you access to a wider range of shipping options.

Note that a $5.00 handling charge is added to all orders that are under $50.00.

===Shipping in Canada===
We offer the following services:
* '''UPS Express Saver'''. 1 - 3 business days.
* '''UPS Expedited'''. 2 - 5 business days. Available for packages over 3 lbs.
* '''UPS Standard'''. 3 - 5 business days ground delivery.

===Shipping to the United States===
We offer the following services:
* '''UPS Express Saver'''. 1 - 3 business days.
* '''UPS Expedited'''. 2 - 5 business days. Available for packages over 3 lbs.
* '''UPS Standard'''. 3 - 5 business days ground delivery.

Effective May 2, 2025, orders shipped to the United States will incur additional duties, tariffs, and brokerage fees, regardless of the order value. For more details, visit our guide about [[U.S._Tariffs | U.S. Tariffs]].

===International Shipments===
We offer the following services:
* '''UPS Worldwide Express Saver'''. 1 - 3 business days.
* '''UPS Worldwide Expedited'''. 2 - 5 business days. Available for packages over 3 lbs.

====European Union====
Effective July 1, 2021, the European Union (EU) updated its Value Added Tax (VAT) regulations. All shipments to EU countries now require formal customs clearance and are subject to VAT based on the destination country.

For goods with an intrinsic value up to €150, VAT must be collected at the time of purchase. This means for orders under $200 USD, we require prepayment of VAT and brokerage fees at checkout to ensure fast, hassle-free delivery.

For orders over $200 USD, we provide the option to prepay all applicable import fees (including VAT and brokerage). If you choose this option, the quoted amount is guaranteed — there will be no additional charges upon delivery.

We use UPS® Global Checkout to collect import fees and taxes based on your product's HS Code and Country of Origin. There is a fee associated with the UPS® Global Checkout service. At Phidgets Inc., we continually monitor and negotiate all fees to ensure our customers receive the best deal possible.

Customs policies vary by country, so we recommend contacting your local customs office for more information.

====Other Countries====
International shipments may be subject to import duties, taxes, and brokerage fees upon arrival in your country. These charges are determined by your local customs authorities and are the responsibility of the recipient.

At checkout, we provide the option to prepay these fees. If you choose this option, the quoted amount is guaranteed — there will be no additional charges upon delivery.

We use UPS® Global Checkout to collect import fees and taxes based on your product's HS Code and Country of Origin. There is a fee associated with the UPS® Global Checkout service. At Phidgets Inc., we continually monitor and negotiate all fees to ensure our customers receive the best deal possible.

Customs policies vary by country, so we recommend contacting your local customs office for more information.

===Tracking Your Order===
You can track your shipment using the tracking number sent to you by email when your order was shipped.

===Refunds on Late Deliveries===

Normally, UPS will offer a service guarantee refund when their deliveries arrive late. However, for companies that apply for shipping discounts, this refund does not apply. Phidgets Inc. has applied for such discounts in order to keep shipping costs down and regrettably cannot offer compensation for late shipments.

===Damaged or Lost Shipment===

'''Shipping on our UPS account''' - Report all damaged or lost shipments to support@phidgets.com and include your order number. According to UPS, in order to be considered lost, a package must be undelivered 24 hours after the expected delivery date and time. Before contacting us, check your shipment status at ups.ca.

Damaged or lost items will be replaced at no charge (including shipping costs).

'''Shipping on your UPS account''' - You must notify your local UPS office. If they confirm that they have lost your shipment, you must repurchase the lost or damaged products from Phidgets and file a claim with your local UPS in order to get reimbursed.

===Refused/Missed Delivery===
If no one is available to accept the package upon delivery, UPS will attempt redelivery two more times, as per their standard procedure. If all delivery attempts fail, UPS will hold the package for 5 days before returning it to us. In such cases, we will issue a refund for your order minus the cost of shipping (both directions) and a flat $50 fee, up to the total value of the package. This policy applies both to deliveries that failed due to no one being present and to packages that were refused at the delivery address.

===Incoterms===

We use the following Incoterms depending on the shipping and payment arrangement:

* '''FCA (Free Carrier):''' Used when shipping on the customer’s carrier account. Risk and responsibility transfer to the customer once the goods are handed over to the carrier at our facility.

* '''DDP (Delivered Duty Paid):''' Used when the customer chooses to pre-pay import fees and taxes at checkout. We handle all import fees and deliver the goods to the destination address.

* '''DAP (Delivered at Place):''' Used when the customer opts to pay import fees and taxes upon delivery. We deliver the goods, but the customer is responsible for paying any import fees directly to the carrier.

==Product Returns==
===All Returns Must Be Authorized===
Before returning a package {{ContactUs|contact us}} and ask for a Return Merchandise Authorization or RMA number. Once you have received it, put the RMA number on the outside of the packaging as well as the packing slip so that it is possible for us to track what the package is supposed to be. Any merchandise returned without an RMA number clearly visible on the packaging will be charged an administrative fee of $25.00 or the value of the returned product, whichever is less ''if we are able to determine what it is''. In the event we are unable to determine what the package is, it will be refused and returned to the sender.

===Unopened Product===
Phidgets accepts returns of unopened products within 30 days of the date of purchase. To initiate a return, please contact us by phone or email to obtain an RMA number. Products must be shipped back to Phidgets Inc. prepaid. A refund will be issued to your credit card once we receive and inspect the returned items. The refund excludes the cost of shipping as well as any duties or brokerage charges incurred.

Returns received after 30 days are subject to a restocking fee of 25% of the package's value (minimum $5.00, maximum $500).

We do '''not''' accept returns beyond 90 days from the date of purchase.

===Cut to Length===
Unfortunately we cannot accept returns on any items which are cut to custom lengths. This includes: cable, wire, roller chain, linear shaft, rotary shaft, and t-slot extrusions.

===We Shipped the Wrong/Incomplete Product===
{{ContactUs|Contact us}}. We will get the correct product sent to you immediately, and will pay all shipping charges.

==Payment Terms==
We accept credit cards, PayPal, and Wire Transfers.

{| style="border:1px solid darkgray;" cellpadding="7px;"
|-style="background: #d1d1d1" align=center
! Payment Method|| Terms
|-
|style="background: #f0f0f0" align=center|Credit Cards
|style="background: #f0f0f0" align=left|Visa, MasterCard, American Express (for order in CAD only)
|-
|style="background: #f0f0f0" align=center|PayPal
|style="background: #f0f0f0" align=left|PayPal is accepted. There are no extra fees for using PayPal
|-
|style="background: #f0f0f0" align=center|Wire Transfers
|style="background: #f0f0f0" align=left|Wire transfers are only accepted for orders over $200.00 USD (excluding shipping charges). There is a $25.00 USD charge for wire transfers under $500.00 USD. Any fees charged by the sending bank are your responsibility.<br />Please make sure that the amount sent to us covers both our invoice and your bank fees. Products are not shipped until the money is deposited in our bank account. We recommend that you e-mail orders@phidgets.com with the amount of the transfer and the invoice you are paying. <br />Any order for which payment is not received within 15 days, will be canceled.
|}
===Sales Tax===
Applicable state, provincial, or country sales tax will be charged where required, unless a valid exemption or resale certificate has been submitted to and approved by Phidgets Inc.

To apply for tax-exempt status, please email the following to [mailto:sales@phidgets.com sales@phidgets.com]:
* Your Phidgets customer account name or the email address associated with your account
* A PDF copy of your tax exemption or resale certificate, including the organization name and any applicable ID numbers

If an order is placed before your exemption status has been reviewed and approved, applicable taxes will be charged.

All taxes collected are remitted to the appropriate governing authorities in accordance with applicable laws and regulations.

==Security and Privacy==
Phidgets Inc. pledges a safe and worry-free shopping experience. If you are using the current version of Internet Explorer, on the checkout page where you enter your credit card information, you will notice a a locked padlock icon on the top bar your browser window. If you are using Mozilla Firefox, you will notice a locked padlock icon in the bottom right corner of your browser window. If this icon does not appear, please contact us directly to complete your purchase. These icons tell you that the page you are on is secure. We use Secure Sockets Layer (SSL 128-bit) technology with a digital certificate by GeoTrust, Inc. for Internet security to protect your personal information. This encryption makes it impossible for anyone to read your information in transit. We do not store your credit information and it is deleted once it has been securely transmitted to Moneris for processing.

We use your e-mail address to let you know your shipment's tracking number. Your phone number is required by the Courier Company. We do not sell, rent or give any of your personal information to any unrelated third parties with the exception of Moneris for authorizing credit card payments and the Courier company to let them know where to deliver the shipment and how to contact you if there is any problems.

{{ContactUs|Contact us}} if you have any questions or concerns about our Security and Privacy policy.

Phidgets Inc. uses various Google Analytics tools such as conversion tracking in order to improve the effectiveness of the website. These statistics are completely anonymous.

==Holidays==
Phidgets, Inc. will be closed on the following days. During these times, the site will still be accessible and orders can be placed, but they will not ship until the next business day.

{| style="border:1px solid darkgray;" cellpadding="7px;"
|-style="background: #d1d1d1" align=center
! style="text-align:center;"| Holiday
! style="text-align:center;"| Description
! style="text-align:center;"| 2026
! style="text-align:center;"| 2027
|-
|style="background: #f0f0f0" align=center| Alberta Family Day
|style="background: #f0f0f0" align=center| Third Monday in February
|style="background: #f0f0f0" align=center| Feb 16
|style="background: #f0f0f0" align=center| Feb 15
|-
|style="background: #f0f0f0" align=center| Good Friday
|style="background: #f0f0f0" align=center| Friday before Easter Sunday
|style="background: #f0f0f0" align=center| Apr 3
|style="background: #f0f0f0" align=center| Mar 26
|-
|style="background: #f0f0f0" align=center| Victoria Day
|style="background: #f0f0f0" align=center| Monday before May 25
|style="background: #f0f0f0" align=center| May 18
|style="background: #f0f0f0" align=center| May 24
|-
|style="background: #f0f0f0" align=center| Canada Day
|style="background: #f0f0f0" align=center| First day of July (or nearest business day)
|style="background: #f0f0f0" align=center| Jul 1
|style="background: #f0f0f0" align=center| Jul 1
|-
|style="background: #f0f0f0" align=center| Civic Holiday
|style="background: #f0f0f0" align=center| First Monday in August
|style="background: #f0f0f0" align=center| Aug 3
|style="background: #f0f0f0" align=center| Aug 2
|-
|style="background: #f0f0f0" align=center| Labour Day
|style="background: #f0f0f0" align=center| First Monday in September
|style="background: #f0f0f0" align=center| Sept 7
|style="background: #f0f0f0" align=center| Sept 6
|-
|style="background: #f0f0f0" align=center| Thanksgiving
|style="background: #f0f0f0" align=center| Second Monday in October
|style="background: #f0f0f0" align=center| Oct 12
|style="background: #f0f0f0" align=center| Oct 11
|-
|style="background: #f0f0f0" align=center| Remembrance Day
|style="background: #f0f0f0" align=center| November 11 (or nearest business day)
|style="background: #f0f0f0" align=center| Nov 11
|style="background: #f0f0f0" align=center| Nov 11
|-
|style="background: #f0f0f0" align=center| Christmas and New Years
|style="background: #f0f0f0" align=center| Varies
|style="background: #f0f0f0" align=center| TBA
|style="background: #f0f0f0" align=center| TBA
|-
|}

Terms and Conditions

2026-05-06T18:29:44Z

Lmpacent: /* Sales Tax */

[[Category:Linked From Website]]

==Product Warranty==

All Phidgets products are warranted to be free of defects in material or workmanship under normal use and service for a period of one year from the date of shipment. This warranty does not include damage resulting from accident or misuse. The warranty is also void if the product is modified. This warranty is in lieu of all other warranties expressed or implied including the implied warranties of merchantability of fitness for a particular purpose, whether arising by law, custom or conduct, and the rights and remedies provided under this warranty are exclusive and in lieu of any other rights or remedies. In no event shall Phidgets Incorporated be liable for consequential damages.

If you believe that your product is defective while still under warranty, {{ContactUs|contact us}}. Once the support desk confirms that the product is defective, we will replace your defective product free of charge.

==Shipping==
===Last Call at 12:00PM===
Orders received before 12:00 PM Mountain Time (GMT-07:00) Monday to Friday will be shipped the same day.

Orders containing cut-to-length parts may not ship on the same day due to the additional processing time associated with these orders.

===Shipping Costs===
Shipping costs are calculated at checkout and presented for your review before you confirm your order. If multiple shipping options are available for your destination, all options will be listed so you can choose the one that best suits your needs.

If you have your own UPS or FedEx account, you can use it at checkout and be billed directly by the carrier. This gives you access to a wider range of shipping options.

Note that a $5.00 handling charge is added to all orders that are under $50.00.

===Shipping in Canada===
We offer the following services:
* '''UPS Express Saver'''. 1 - 3 business days.
* '''UPS Expedited'''. 2 - 5 business days. Available for packages over 3 lbs.
* '''UPS Standard'''. 3 - 5 business days ground delivery.

===Shipping to the United States===
We offer the following services:
* '''UPS Express Saver'''. 1 - 3 business days.
* '''UPS Expedited'''. 2 - 5 business days. Available for packages over 3 lbs.
* '''UPS Standard'''. 3 - 5 business days ground delivery.

Effective May 2, 2025, orders shipped to the United States will incur additional duties, tariffs, and brokerage fees, regardless of the order value. For more details, visit our guide about [[U.S._Tariffs | U.S. Tariffs]].

===International Shipments===
We offer the following services:
* '''UPS Worldwide Express Saver'''. 1 - 3 business days.
* '''UPS Worldwide Expedited'''. 2 - 5 business days. Available for packages over 3 lbs.

====European Union====
Effective July 1, 2021, the European Union (EU) updated its Value Added Tax (VAT) regulations. All shipments to EU countries now require formal customs clearance and are subject to VAT based on the destination country.

For goods with an intrinsic value up to €150, VAT must be collected at the time of purchase. This means for orders under $200 USD, we require prepayment of VAT and brokerage fees at checkout to ensure fast, hassle-free delivery.

For orders over $200 USD, we provide the option to prepay all applicable import fees (including VAT and brokerage). If you choose this option, the quoted amount is guaranteed — there will be no additional charges upon delivery.

We use UPS® Global Checkout to collect import fees and taxes based on your product's HS Code and Country of Origin. There is a fee associated with the UPS® Global Checkout service. At Phidgets Inc., we continually monitor and negotiate all fees to ensure our customers receive the best deal possible.

Customs policies vary by country, so we recommend contacting your local customs office for more information.

====Other Countries====
International shipments may be subject to import duties, taxes, and brokerage fees upon arrival in your country. These charges are determined by your local customs authorities and are the responsibility of the recipient.

At checkout, we provide the option to prepay these fees. If you choose this option, the quoted amount is guaranteed — there will be no additional charges upon delivery.

We use UPS® Global Checkout to collect import fees and taxes based on your product's HS Code and Country of Origin. There is a fee associated with the UPS® Global Checkout service. At Phidgets Inc., we continually monitor and negotiate all fees to ensure our customers receive the best deal possible.

Customs policies vary by country, so we recommend contacting your local customs office for more information.

===Tracking Your Order===
You can track your shipment using the tracking number sent to you by email when your order was shipped.

===Refunds on Late Deliveries===

Normally, UPS will offer a service guarantee refund when their deliveries arrive late. However, for companies that apply for shipping discounts, this refund does not apply. Phidgets Inc. has applied for such discounts in order to keep shipping costs down and regrettably cannot offer compensation for late shipments.

===Damaged or Lost Shipment===

'''Shipping on our UPS account''' - Report all damaged or lost shipments to support@phidgets.com and include your order number. According to UPS, in order to be considered lost, a package must be undelivered 24 hours after the expected delivery date and time. Before contacting us, check your shipment status at ups.ca.

Damaged or lost items will be replaced at no charge (including shipping costs).

'''Shipping on your UPS account''' - You must notify your local UPS office. If they confirm that they have lost your shipment, you must repurchase the lost or damaged products from Phidgets and file a claim with your local UPS in order to get reimbursed.

===Refused/Missed Delivery===
If no one is available to accept the package upon delivery, UPS will attempt redelivery two more times, as per their standard procedure. If all delivery attempts fail, UPS will hold the package for 5 days before returning it to us. In such cases, we will issue a refund for your order minus the cost of shipping (both directions) and a flat $50 fee, up to the total value of the package. This policy applies both to deliveries that failed due to no one being present and to packages that were refused at the delivery address.

===Incoterms===

We use the following Incoterms depending on the shipping and payment arrangement:

* '''FCA (Free Carrier):''' Used when shipping on the customer’s carrier account. Risk and responsibility transfer to the customer once the goods are handed over to the carrier at our facility.

* '''DDP (Delivered Duty Paid):''' Used when the customer chooses to pre-pay import fees and taxes at checkout. We handle all import fees and deliver the goods to the destination address.

* '''DAP (Delivered at Place):''' Used when the customer opts to pay import fees and taxes upon delivery. We deliver the goods, but the customer is responsible for paying any import fees directly to the carrier.

==Product Returns==
===All Returns Must Be Authorized===
Before returning a package {{ContactUs|contact us}} and ask for a Return Merchandise Authorization or RMA number. Once you have received it, put the RMA number on the outside of the packaging as well as the packing slip so that it is possible for us to track what the package is supposed to be. Any merchandise returned without an RMA number clearly visible on the packaging will be charged an administrative fee of $25.00 or the value of the returned product, whichever is less ''if we are able to determine what it is''. In the event we are unable to determine what the package is, it will be refused and returned to the sender.

===Unopened Product===
Phidgets accepts returns of unopened products within 30 days of the date of purchase. To initiate a return, please contact us by phone or email to obtain an RMA number. Products must be shipped back to Phidgets Inc. prepaid. A refund will be issued to your credit card once we receive and inspect the returned items. The refund excludes the cost of shipping as well as any duties or brokerage charges incurred.

Returns received after 30 days are subject to a restocking fee of 25% of the package's value (minimum $5.00, maximum $500).

We do '''not''' accept returns beyond 90 days from the date of purchase.

===Cut to Length===
Unfortunately we cannot accept returns on any items which are cut to custom lengths. This includes: cable, wire, roller chain, linear shaft, rotary shaft, and t-slot extrusions.

===We Shipped the Wrong/Incomplete Product===
{{ContactUs|Contact us}}. We will get the correct product sent to you immediately, and will pay all shipping charges.

==Payment Terms==
We accept credit cards, PayPal, and Wire Transfers.

{| style="border:1px solid darkgray;" cellpadding="7px;"
|-style="background: #d1d1d1" align=center
! Payment Method|| Terms
|-
|style="background: #f0f0f0" align=center|Credit Cards
|style="background: #f0f0f0" align=left|Visa, MasterCard, American Express (for order in CAD only)
|-
|style="background: #f0f0f0" align=center|PayPal
|style="background: #f0f0f0" align=left|PayPal is accepted. There are no extra fees for using PayPal
|-
|style="background: #f0f0f0" align=center|Wire Transfers
|style="background: #f0f0f0" align=left|Wire transfers are only accepted for orders over $200.00 USD (excluding shipping charges). There is a $25.00 USD charge for wire transfers under $500.00 USD. Any fees charged by the sending bank are your responsibility.<br />Please make sure that the amount sent to us covers both our invoice and your bank fees. Products are not shipped until the money is deposited in our bank account. We recommend that you e-mail orders@phidgets.com with the amount of the transfer and the invoice you are paying. <br />Any order for which payment is not received within 15 days, will be canceled.
|}
===Sales Tax===
Applicable state, provincial, or country sales tax will be charged when required, unless a valid exemption or resale certificate has been submitted to and approved by Phidgets Inc.

To apply for tax-exempt status, please email the following to [mailto:sales@phidgets.com sales@phidgets.com]:
* Your Phidgets customer account name or the email address associated with your account
* A PDF copy of your tax exemption or resale certificate, including the organization name and any applicable ID numbers

If an order is placed before your exemption status has been reviewed and approved, applicable taxes will be charged.

All taxes collected are remitted to the appropriate governing authorities in accordance with applicable laws and regulations.

==Security and Privacy==
Phidgets Inc. pledges a safe and worry-free shopping experience. If you are using the current version of Internet Explorer, on the checkout page where you enter your credit card information, you will notice a a locked padlock icon on the top bar your browser window. If you are using Mozilla Firefox, you will notice a locked padlock icon in the bottom right corner of your browser window. If this icon does not appear, please contact us directly to complete your purchase. These icons tell you that the page you are on is secure. We use Secure Sockets Layer (SSL 128-bit) technology with a digital certificate by GeoTrust, Inc. for Internet security to protect your personal information. This encryption makes it impossible for anyone to read your information in transit. We do not store your credit information and it is deleted once it has been securely transmitted to Moneris for processing.

We use your e-mail address to let you know your shipment's tracking number. Your phone number is required by the Courier Company. We do not sell, rent or give any of your personal information to any unrelated third parties with the exception of Moneris for authorizing credit card payments and the Courier company to let them know where to deliver the shipment and how to contact you if there is any problems.

{{ContactUs|Contact us}} if you have any questions or concerns about our Security and Privacy policy.

Phidgets Inc. uses various Google Analytics tools such as conversion tracking in order to improve the effectiveness of the website. These statistics are completely anonymous.

==Holidays==
Phidgets, Inc. will be closed on the following days. During these times, the site will still be accessible and orders can be placed, but they will not ship until the next business day.

{| style="border:1px solid darkgray;" cellpadding="7px;"
|-style="background: #d1d1d1" align=center
! style="text-align:center;"| Holiday
! style="text-align:center;"| Description
! style="text-align:center;"| 2026
! style="text-align:center;"| 2027
|-
|style="background: #f0f0f0" align=center| Alberta Family Day
|style="background: #f0f0f0" align=center| Third Monday in February
|style="background: #f0f0f0" align=center| Feb 16
|style="background: #f0f0f0" align=center| Feb 15
|-
|style="background: #f0f0f0" align=center| Good Friday
|style="background: #f0f0f0" align=center| Friday before Easter Sunday
|style="background: #f0f0f0" align=center| Apr 3
|style="background: #f0f0f0" align=center| Mar 26
|-
|style="background: #f0f0f0" align=center| Victoria Day
|style="background: #f0f0f0" align=center| Monday before May 25
|style="background: #f0f0f0" align=center| May 18
|style="background: #f0f0f0" align=center| May 24
|-
|style="background: #f0f0f0" align=center| Canada Day
|style="background: #f0f0f0" align=center| First day of July (or nearest business day)
|style="background: #f0f0f0" align=center| Jul 1
|style="background: #f0f0f0" align=center| Jul 1
|-
|style="background: #f0f0f0" align=center| Civic Holiday
|style="background: #f0f0f0" align=center| First Monday in August
|style="background: #f0f0f0" align=center| Aug 3
|style="background: #f0f0f0" align=center| Aug 2
|-
|style="background: #f0f0f0" align=center| Labour Day
|style="background: #f0f0f0" align=center| First Monday in September
|style="background: #f0f0f0" align=center| Sept 7
|style="background: #f0f0f0" align=center| Sept 6
|-
|style="background: #f0f0f0" align=center| Thanksgiving
|style="background: #f0f0f0" align=center| Second Monday in October
|style="background: #f0f0f0" align=center| Oct 12
|style="background: #f0f0f0" align=center| Oct 11
|-
|style="background: #f0f0f0" align=center| Remembrance Day
|style="background: #f0f0f0" align=center| November 11 (or nearest business day)
|style="background: #f0f0f0" align=center| Nov 11
|style="background: #f0f0f0" align=center| Nov 11
|-
|style="background: #f0f0f0" align=center| Christmas and New Years
|style="background: #f0f0f0" align=center| Varies
|style="background: #f0f0f0" align=center| TBA
|style="background: #f0f0f0" align=center| TBA
|-
|}

Terms and Conditions

2026-05-06T18:28:50Z

Lmpacent: /* Sales Tax */

[[Category:Linked From Website]]

==Product Warranty==

All Phidgets products are warranted to be free of defects in material or workmanship under normal use and service for a period of one year from the date of shipment. This warranty does not include damage resulting from accident or misuse. The warranty is also void if the product is modified. This warranty is in lieu of all other warranties expressed or implied including the implied warranties of merchantability of fitness for a particular purpose, whether arising by law, custom or conduct, and the rights and remedies provided under this warranty are exclusive and in lieu of any other rights or remedies. In no event shall Phidgets Incorporated be liable for consequential damages.

If you believe that your product is defective while still under warranty, {{ContactUs|contact us}}. Once the support desk confirms that the product is defective, we will replace your defective product free of charge.

==Shipping==
===Last Call at 12:00PM===
Orders received before 12:00 PM Mountain Time (GMT-07:00) Monday to Friday will be shipped the same day.

Orders containing cut-to-length parts may not ship on the same day due to the additional processing time associated with these orders.

===Shipping Costs===
Shipping costs are calculated at checkout and presented for your review before you confirm your order. If multiple shipping options are available for your destination, all options will be listed so you can choose the one that best suits your needs.

If you have your own UPS or FedEx account, you can use it at checkout and be billed directly by the carrier. This gives you access to a wider range of shipping options.

Note that a $5.00 handling charge is added to all orders that are under $50.00.

===Shipping in Canada===
We offer the following services:
* '''UPS Express Saver'''. 1 - 3 business days.
* '''UPS Expedited'''. 2 - 5 business days. Available for packages over 3 lbs.
* '''UPS Standard'''. 3 - 5 business days ground delivery.

===Shipping to the United States===
We offer the following services:
* '''UPS Express Saver'''. 1 - 3 business days.
* '''UPS Expedited'''. 2 - 5 business days. Available for packages over 3 lbs.
* '''UPS Standard'''. 3 - 5 business days ground delivery.

Effective May 2, 2025, orders shipped to the United States will incur additional duties, tariffs, and brokerage fees, regardless of the order value. For more details, visit our guide about [[U.S._Tariffs | U.S. Tariffs]].

===International Shipments===
We offer the following services:
* '''UPS Worldwide Express Saver'''. 1 - 3 business days.
* '''UPS Worldwide Expedited'''. 2 - 5 business days. Available for packages over 3 lbs.

====European Union====
Effective July 1, 2021, the European Union (EU) updated its Value Added Tax (VAT) regulations. All shipments to EU countries now require formal customs clearance and are subject to VAT based on the destination country.

For goods with an intrinsic value up to €150, VAT must be collected at the time of purchase. This means for orders under $200 USD, we require prepayment of VAT and brokerage fees at checkout to ensure fast, hassle-free delivery.

For orders over $200 USD, we provide the option to prepay all applicable import fees (including VAT and brokerage). If you choose this option, the quoted amount is guaranteed — there will be no additional charges upon delivery.

We use UPS® Global Checkout to collect import fees and taxes based on your product's HS Code and Country of Origin. There is a fee associated with the UPS® Global Checkout service. At Phidgets Inc., we continually monitor and negotiate all fees to ensure our customers receive the best deal possible.

Customs policies vary by country, so we recommend contacting your local customs office for more information.

====Other Countries====
International shipments may be subject to import duties, taxes, and brokerage fees upon arrival in your country. These charges are determined by your local customs authorities and are the responsibility of the recipient.

At checkout, we provide the option to prepay these fees. If you choose this option, the quoted amount is guaranteed — there will be no additional charges upon delivery.

We use UPS® Global Checkout to collect import fees and taxes based on your product's HS Code and Country of Origin. There is a fee associated with the UPS® Global Checkout service. At Phidgets Inc., we continually monitor and negotiate all fees to ensure our customers receive the best deal possible.

Customs policies vary by country, so we recommend contacting your local customs office for more information.

===Tracking Your Order===
You can track your shipment using the tracking number sent to you by email when your order was shipped.

===Refunds on Late Deliveries===

Normally, UPS will offer a service guarantee refund when their deliveries arrive late. However, for companies that apply for shipping discounts, this refund does not apply. Phidgets Inc. has applied for such discounts in order to keep shipping costs down and regrettably cannot offer compensation for late shipments.

===Damaged or Lost Shipment===

'''Shipping on our UPS account''' - Report all damaged or lost shipments to support@phidgets.com and include your order number. According to UPS, in order to be considered lost, a package must be undelivered 24 hours after the expected delivery date and time. Before contacting us, check your shipment status at ups.ca.

Damaged or lost items will be replaced at no charge (including shipping costs).

'''Shipping on your UPS account''' - You must notify your local UPS office. If they confirm that they have lost your shipment, you must repurchase the lost or damaged products from Phidgets and file a claim with your local UPS in order to get reimbursed.

===Refused/Missed Delivery===
If no one is available to accept the package upon delivery, UPS will attempt redelivery two more times, as per their standard procedure. If all delivery attempts fail, UPS will hold the package for 5 days before returning it to us. In such cases, we will issue a refund for your order minus the cost of shipping (both directions) and a flat $50 fee, up to the total value of the package. This policy applies both to deliveries that failed due to no one being present and to packages that were refused at the delivery address.

===Incoterms===

We use the following Incoterms depending on the shipping and payment arrangement:

* '''FCA (Free Carrier):''' Used when shipping on the customer’s carrier account. Risk and responsibility transfer to the customer once the goods are handed over to the carrier at our facility.

* '''DDP (Delivered Duty Paid):''' Used when the customer chooses to pre-pay import fees and taxes at checkout. We handle all import fees and deliver the goods to the destination address.

* '''DAP (Delivered at Place):''' Used when the customer opts to pay import fees and taxes upon delivery. We deliver the goods, but the customer is responsible for paying any import fees directly to the carrier.

==Product Returns==
===All Returns Must Be Authorized===
Before returning a package {{ContactUs|contact us}} and ask for a Return Merchandise Authorization or RMA number. Once you have received it, put the RMA number on the outside of the packaging as well as the packing slip so that it is possible for us to track what the package is supposed to be. Any merchandise returned without an RMA number clearly visible on the packaging will be charged an administrative fee of $25.00 or the value of the returned product, whichever is less ''if we are able to determine what it is''. In the event we are unable to determine what the package is, it will be refused and returned to the sender.

===Unopened Product===
Phidgets accepts returns of unopened products within 30 days of the date of purchase. To initiate a return, please contact us by phone or email to obtain an RMA number. Products must be shipped back to Phidgets Inc. prepaid. A refund will be issued to your credit card once we receive and inspect the returned items. The refund excludes the cost of shipping as well as any duties or brokerage charges incurred.

Returns received after 30 days are subject to a restocking fee of 25% of the package's value (minimum $5.00, maximum $500).

We do '''not''' accept returns beyond 90 days from the date of purchase.

===Cut to Length===
Unfortunately we cannot accept returns on any items which are cut to custom lengths. This includes: cable, wire, roller chain, linear shaft, rotary shaft, and t-slot extrusions.

===We Shipped the Wrong/Incomplete Product===
{{ContactUs|Contact us}}. We will get the correct product sent to you immediately, and will pay all shipping charges.

==Payment Terms==
We accept credit cards, PayPal, and Wire Transfers.

{| style="border:1px solid darkgray;" cellpadding="7px;"
|-style="background: #d1d1d1" align=center
! Payment Method|| Terms
|-
|style="background: #f0f0f0" align=center|Credit Cards
|style="background: #f0f0f0" align=left|Visa, MasterCard, American Express (for order in CAD only)
|-
|style="background: #f0f0f0" align=center|PayPal
|style="background: #f0f0f0" align=left|PayPal is accepted. There are no extra fees for using PayPal
|-
|style="background: #f0f0f0" align=center|Wire Transfers
|style="background: #f0f0f0" align=left|Wire transfers are only accepted for orders over $200.00 USD (excluding shipping charges). There is a $25.00 USD charge for wire transfers under $500.00 USD. Any fees charged by the sending bank are your responsibility.<br />Please make sure that the amount sent to us covers both our invoice and your bank fees. Products are not shipped until the money is deposited in our bank account. We recommend that you e-mail orders@phidgets.com with the amount of the transfer and the invoice you are paying. <br />Any order for which payment is not received within 15 days, will be canceled.
|}
===Sales Tax===
Applicable state, provincial, or country sales tax will be charged where required, unless a valid exemption or resale certificate has been submitted to and approved by Phidgets Inc.

To apply for tax-exempt status, please email the following to [mailto:sales@phidgets.com sales@phidgets.com]:
* Your Phidgets customer account name or the email address associated with your account
* A PDF copy of your tax exemption or resale certificate, including the organization name and any applicable ID numbers

If an order is placed before your exemption status has been reviewed and approved, applicable taxes will be charged.

All taxes collected are remitted to the appropriate governing authorities in accordance with applicable laws and regulations.

==Security and Privacy==
Phidgets Inc. pledges a safe and worry-free shopping experience. If you are using the current version of Internet Explorer, on the checkout page where you enter your credit card information, you will notice a a locked padlock icon on the top bar your browser window. If you are using Mozilla Firefox, you will notice a locked padlock icon in the bottom right corner of your browser window. If this icon does not appear, please contact us directly to complete your purchase. These icons tell you that the page you are on is secure. We use Secure Sockets Layer (SSL 128-bit) technology with a digital certificate by GeoTrust, Inc. for Internet security to protect your personal information. This encryption makes it impossible for anyone to read your information in transit. We do not store your credit information and it is deleted once it has been securely transmitted to Moneris for processing.

We use your e-mail address to let you know your shipment's tracking number. Your phone number is required by the Courier Company. We do not sell, rent or give any of your personal information to any unrelated third parties with the exception of Moneris for authorizing credit card payments and the Courier company to let them know where to deliver the shipment and how to contact you if there is any problems.

{{ContactUs|Contact us}} if you have any questions or concerns about our Security and Privacy policy.

Phidgets Inc. uses various Google Analytics tools such as conversion tracking in order to improve the effectiveness of the website. These statistics are completely anonymous.

==Holidays==
Phidgets, Inc. will be closed on the following days. During these times, the site will still be accessible and orders can be placed, but they will not ship until the next business day.

{| style="border:1px solid darkgray;" cellpadding="7px;"
|-style="background: #d1d1d1" align=center
! style="text-align:center;"| Holiday
! style="text-align:center;"| Description
! style="text-align:center;"| 2026
! style="text-align:center;"| 2027
|-
|style="background: #f0f0f0" align=center| Alberta Family Day
|style="background: #f0f0f0" align=center| Third Monday in February
|style="background: #f0f0f0" align=center| Feb 16
|style="background: #f0f0f0" align=center| Feb 15
|-
|style="background: #f0f0f0" align=center| Good Friday
|style="background: #f0f0f0" align=center| Friday before Easter Sunday
|style="background: #f0f0f0" align=center| Apr 3
|style="background: #f0f0f0" align=center| Mar 26
|-
|style="background: #f0f0f0" align=center| Victoria Day
|style="background: #f0f0f0" align=center| Monday before May 25
|style="background: #f0f0f0" align=center| May 18
|style="background: #f0f0f0" align=center| May 24
|-
|style="background: #f0f0f0" align=center| Canada Day
|style="background: #f0f0f0" align=center| First day of July (or nearest business day)
|style="background: #f0f0f0" align=center| Jul 1
|style="background: #f0f0f0" align=center| Jul 1
|-
|style="background: #f0f0f0" align=center| Civic Holiday
|style="background: #f0f0f0" align=center| First Monday in August
|style="background: #f0f0f0" align=center| Aug 3
|style="background: #f0f0f0" align=center| Aug 2
|-
|style="background: #f0f0f0" align=center| Labour Day
|style="background: #f0f0f0" align=center| First Monday in September
|style="background: #f0f0f0" align=center| Sept 7
|style="background: #f0f0f0" align=center| Sept 6
|-
|style="background: #f0f0f0" align=center| Thanksgiving
|style="background: #f0f0f0" align=center| Second Monday in October
|style="background: #f0f0f0" align=center| Oct 12
|style="background: #f0f0f0" align=center| Oct 11
|-
|style="background: #f0f0f0" align=center| Remembrance Day
|style="background: #f0f0f0" align=center| November 11 (or nearest business day)
|style="background: #f0f0f0" align=center| Nov 11
|style="background: #f0f0f0" align=center| Nov 11
|-
|style="background: #f0f0f0" align=center| Christmas and New Years
|style="background: #f0f0f0" align=center| Varies
|style="background: #f0f0f0" align=center| TBA
|style="background: #f0f0f0" align=center| TBA
|-
|}

Terms and Conditions

2026-05-01T17:15:56Z

Lmpacent: /* Payment Terms */

[[Category:Linked From Website]]

==Product Warranty==

All Phidgets products are warranted to be free of defects in material or workmanship under normal use and service for a period of one year from the date of shipment. This warranty does not include damage resulting from accident or misuse. The warranty is also void if the product is modified. This warranty is in lieu of all other warranties expressed or implied including the implied warranties of merchantability of fitness for a particular purpose, whether arising by law, custom or conduct, and the rights and remedies provided under this warranty are exclusive and in lieu of any other rights or remedies. In no event shall Phidgets Incorporated be liable for consequential damages.

If you believe that your product is defective while still under warranty, {{ContactUs|contact us}}. Once the support desk confirms that the product is defective, we will replace your defective product free of charge.

==Shipping==
===Last Call at 12:00PM===
Orders received before 12:00 PM Mountain Time (GMT-07:00) Monday to Friday will be shipped the same day.

Orders containing cut-to-length parts may not ship on the same day due to the additional processing time associated with these orders.

===Shipping Costs===
Shipping costs are calculated at checkout and presented for your review before you confirm your order. If multiple shipping options are available for your destination, all options will be listed so you can choose the one that best suits your needs.

If you have your own UPS or FedEx account, you can use it at checkout and be billed directly by the carrier. This gives you access to a wider range of shipping options.

Note that a $5.00 handling charge is added to all orders that are under $50.00.

===Shipping in Canada===
We offer the following services:
* '''UPS Express Saver'''. 1 - 3 business days.
* '''UPS Expedited'''. 2 - 5 business days. Available for packages over 3 lbs.
* '''UPS Standard'''. 3 - 5 business days ground delivery.

===Shipping to the United States===
We offer the following services:
* '''UPS Express Saver'''. 1 - 3 business days.
* '''UPS Expedited'''. 2 - 5 business days. Available for packages over 3 lbs.
* '''UPS Standard'''. 3 - 5 business days ground delivery.

Effective May 2, 2025, orders shipped to the United States will incur additional duties, tariffs, and brokerage fees, regardless of the order value. For more details, visit our guide about [[U.S._Tariffs | U.S. Tariffs]].

===International Shipments===
We offer the following services:
* '''UPS Worldwide Express Saver'''. 1 - 3 business days.
* '''UPS Worldwide Expedited'''. 2 - 5 business days. Available for packages over 3 lbs.

====European Union====
Effective July 1, 2021, the European Union (EU) updated its Value Added Tax (VAT) regulations. All shipments to EU countries now require formal customs clearance and are subject to VAT based on the destination country.

For goods with an intrinsic value up to €150, VAT must be collected at the time of purchase. This means for orders under $200 USD, we require prepayment of VAT and brokerage fees at checkout to ensure fast, hassle-free delivery.

For orders over $200 USD, we provide the option to prepay all applicable import fees (including VAT and brokerage). If you choose this option, the quoted amount is guaranteed — there will be no additional charges upon delivery.

We use UPS® Global Checkout to collect import fees and taxes based on your product's HS Code and Country of Origin. There is a fee associated with the UPS® Global Checkout service. At Phidgets Inc., we continually monitor and negotiate all fees to ensure our customers receive the best deal possible.

Customs policies vary by country, so we recommend contacting your local customs office for more information.

====Other Countries====
International shipments may be subject to import duties, taxes, and brokerage fees upon arrival in your country. These charges are determined by your local customs authorities and are the responsibility of the recipient.

At checkout, we provide the option to prepay these fees. If you choose this option, the quoted amount is guaranteed — there will be no additional charges upon delivery.

We use UPS® Global Checkout to collect import fees and taxes based on your product's HS Code and Country of Origin. There is a fee associated with the UPS® Global Checkout service. At Phidgets Inc., we continually monitor and negotiate all fees to ensure our customers receive the best deal possible.

Customs policies vary by country, so we recommend contacting your local customs office for more information.

===Tracking Your Order===
You can track your shipment using the tracking number sent to you by email when your order was shipped.

===Refunds on Late Deliveries===

Normally, UPS will offer a service guarantee refund when their deliveries arrive late. However, for companies that apply for shipping discounts, this refund does not apply. Phidgets Inc. has applied for such discounts in order to keep shipping costs down and regrettably cannot offer compensation for late shipments.

===Damaged or Lost Shipment===

'''Shipping on our UPS account''' - Report all damaged or lost shipments to support@phidgets.com and include your order number. According to UPS, in order to be considered lost, a package must be undelivered 24 hours after the expected delivery date and time. Before contacting us, check your shipment status at ups.ca.

Damaged or lost items will be replaced at no charge (including shipping costs).

'''Shipping on your UPS account''' - You must notify your local UPS office. If they confirm that they have lost your shipment, you must repurchase the lost or damaged products from Phidgets and file a claim with your local UPS in order to get reimbursed.

===Refused/Missed Delivery===
If no one is available to accept the package upon delivery, UPS will attempt redelivery two more times, as per their standard procedure. If all delivery attempts fail, UPS will hold the package for 5 days before returning it to us. In such cases, we will issue a refund for your order minus the cost of shipping (both directions) and a flat $50 fee, up to the total value of the package. This policy applies both to deliveries that failed due to no one being present and to packages that were refused at the delivery address.

===Incoterms===

We use the following Incoterms depending on the shipping and payment arrangement:

* '''FCA (Free Carrier):''' Used when shipping on the customer’s carrier account. Risk and responsibility transfer to the customer once the goods are handed over to the carrier at our facility.

* '''DDP (Delivered Duty Paid):''' Used when the customer chooses to pre-pay import fees and taxes at checkout. We handle all import fees and deliver the goods to the destination address.

* '''DAP (Delivered at Place):''' Used when the customer opts to pay import fees and taxes upon delivery. We deliver the goods, but the customer is responsible for paying any import fees directly to the carrier.

==Product Returns==
===All Returns Must Be Authorized===
Before returning a package {{ContactUs|contact us}} and ask for a Return Merchandise Authorization or RMA number. Once you have received it, put the RMA number on the outside of the packaging as well as the packing slip so that it is possible for us to track what the package is supposed to be. Any merchandise returned without an RMA number clearly visible on the packaging will be charged an administrative fee of $25.00 or the value of the returned product, whichever is less ''if we are able to determine what it is''. In the event we are unable to determine what the package is, it will be refused and returned to the sender.

===Unopened Product===
Phidgets accepts returns of unopened products within 30 days of the date of purchase. To initiate a return, please contact us by phone or email to obtain an RMA number. Products must be shipped back to Phidgets Inc. prepaid. A refund will be issued to your credit card once we receive and inspect the returned items. The refund excludes the cost of shipping as well as any duties or brokerage charges incurred.

Returns received after 30 days are subject to a restocking fee of 25% of the package's value (minimum $5.00, maximum $500).

We do '''not''' accept returns beyond 90 days from the date of purchase.

===Cut to Length===
Unfortunately we cannot accept returns on any items which are cut to custom lengths. This includes: cable, wire, roller chain, linear shaft, rotary shaft, and t-slot extrusions.

===We Shipped the Wrong/Incomplete Product===
{{ContactUs|Contact us}}. We will get the correct product sent to you immediately, and will pay all shipping charges.

==Payment Terms==
We accept credit cards, PayPal, and Wire Transfers.

{| style="border:1px solid darkgray;" cellpadding="7px;"
|-style="background: #d1d1d1" align=center
! Payment Method|| Terms
|-
|style="background: #f0f0f0" align=center|Credit Cards
|style="background: #f0f0f0" align=left|Visa, MasterCard, American Express (for order in CAD only)
|-
|style="background: #f0f0f0" align=center|PayPal
|style="background: #f0f0f0" align=left|PayPal is accepted. There are no extra fees for using PayPal
|-
|style="background: #f0f0f0" align=center|Wire Transfers
|style="background: #f0f0f0" align=left|Wire transfers are only accepted for orders over $200.00 USD (excluding shipping charges). There is a $25.00 USD charge for wire transfers under $500.00 USD. Any fees charged by the sending bank are your responsibility.<br />Please make sure that the amount sent to us covers both our invoice and your bank fees. Products are not shipped until the money is deposited in our bank account. We recommend that you e-mail orders@phidgets.com with the amount of the transfer and the invoice you are paying. <br />Any order for which payment is not received within 15 days, will be canceled.
|}
===Sales Tax===
All orders will be subject to applicable state, provincial, or country sales tax, unless a valid exemption or resale certificate has been submitted to and approved by Phidgets Inc.

To apply for tax-exempt status, please email the following to [mailto:sales@phidgets.com sales@phidgets.com]:
* Your Phidgets customer account name or the email address associated with your account
* A PDF copy of your tax exemption or resale certificate, including the organization name and any applicable ID numbers

If an order is placed before your exemption status has been reviewed and approved, applicable taxes will be charged.

All taxes collected are remitted to the appropriate governing authorities in accordance with applicable laws and regulations.

==Security and Privacy==
Phidgets Inc. pledges a safe and worry-free shopping experience. If you are using the current version of Internet Explorer, on the checkout page where you enter your credit card information, you will notice a a locked padlock icon on the top bar your browser window. If you are using Mozilla Firefox, you will notice a locked padlock icon in the bottom right corner of your browser window. If this icon does not appear, please contact us directly to complete your purchase. These icons tell you that the page you are on is secure. We use Secure Sockets Layer (SSL 128-bit) technology with a digital certificate by GeoTrust, Inc. for Internet security to protect your personal information. This encryption makes it impossible for anyone to read your information in transit. We do not store your credit information and it is deleted once it has been securely transmitted to Moneris for processing.

We use your e-mail address to let you know your shipment's tracking number. Your phone number is required by the Courier Company. We do not sell, rent or give any of your personal information to any unrelated third parties with the exception of Moneris for authorizing credit card payments and the Courier company to let them know where to deliver the shipment and how to contact you if there is any problems.

{{ContactUs|Contact us}} if you have any questions or concerns about our Security and Privacy policy.

Phidgets Inc. uses various Google Analytics tools such as conversion tracking in order to improve the effectiveness of the website. These statistics are completely anonymous.

==Holidays==
Phidgets, Inc. will be closed on the following days. During these times, the site will still be accessible and orders can be placed, but they will not ship until the next business day.

{| style="border:1px solid darkgray;" cellpadding="7px;"
|-style="background: #d1d1d1" align=center
! style="text-align:center;"| Holiday
! style="text-align:center;"| Description
! style="text-align:center;"| 2026
! style="text-align:center;"| 2027
|-
|style="background: #f0f0f0" align=center| Alberta Family Day
|style="background: #f0f0f0" align=center| Third Monday in February
|style="background: #f0f0f0" align=center| Feb 16
|style="background: #f0f0f0" align=center| Feb 15
|-
|style="background: #f0f0f0" align=center| Good Friday
|style="background: #f0f0f0" align=center| Friday before Easter Sunday
|style="background: #f0f0f0" align=center| Apr 3
|style="background: #f0f0f0" align=center| Mar 26
|-
|style="background: #f0f0f0" align=center| Victoria Day
|style="background: #f0f0f0" align=center| Monday before May 25
|style="background: #f0f0f0" align=center| May 18
|style="background: #f0f0f0" align=center| May 24
|-
|style="background: #f0f0f0" align=center| Canada Day
|style="background: #f0f0f0" align=center| First day of July (or nearest business day)
|style="background: #f0f0f0" align=center| Jul 1
|style="background: #f0f0f0" align=center| Jul 1
|-
|style="background: #f0f0f0" align=center| Civic Holiday
|style="background: #f0f0f0" align=center| First Monday in August
|style="background: #f0f0f0" align=center| Aug 3
|style="background: #f0f0f0" align=center| Aug 2
|-
|style="background: #f0f0f0" align=center| Labour Day
|style="background: #f0f0f0" align=center| First Monday in September
|style="background: #f0f0f0" align=center| Sept 7
|style="background: #f0f0f0" align=center| Sept 6
|-
|style="background: #f0f0f0" align=center| Thanksgiving
|style="background: #f0f0f0" align=center| Second Monday in October
|style="background: #f0f0f0" align=center| Oct 12
|style="background: #f0f0f0" align=center| Oct 11
|-
|style="background: #f0f0f0" align=center| Remembrance Day
|style="background: #f0f0f0" align=center| November 11 (or nearest business day)
|style="background: #f0f0f0" align=center| Nov 11
|style="background: #f0f0f0" align=center| Nov 11
|-
|style="background: #f0f0f0" align=center| Christmas and New Years
|style="background: #f0f0f0" align=center| Varies
|style="background: #f0f0f0" align=center| TBA
|style="background: #f0f0f0" align=center| TBA
|-
|}

OS - macOS

2026-04-21T15:12:15Z

Lmpacent: /* Quick Downloads */

<metadesc>Communicate over USB with sensors, controllers, and relays with Phidgets! Program in macOS using a wide variety of programming languages.</metadesc>
[[Category:OS]]

==Quick Downloads==
Our libraries support macOS 10.11 and newer.
* [https://cdn.phidgets.com/downloads/phidget22/tools/macos/Phidget22ControlPanel.dmg Phidget22 Control Panel (for macOS 10.15 and newer)]
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22.dmg Phidget22 Installer (for macOS 10.14 and earlier)]

===Other Resources===
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip macOS Development Files]
* [{{SERVER}}/downloads/phidget22/libraries/macos/Phidget22/ Previous Releases]

==Getting Started with macOS==
===Install===
To get started, download the appropriate [[#Quick Downloads|package]] for your machine from the list above. This will install the Phidget Control Panel and the Phidget Network Server. These are powerful tools that will help you develop your Phidget applications.

===Phidget Control Panel===
After downloading, drag the application into your Applications folder:
[[Image:Macos_standalone_install.png|link=https://cdn.phidgets.com/docs/images/c/c8/Macos_applications_controlpanel.png|center|600px]]

You can then find the application in the Applications folder by searching for ''Phidget Control Panel''.
[[Image:Macos_applications_controlpanel.png|link=https://cdn.phidgets.com/docs/images/c/c8/Macos_applications_controlpanel.png|600px|center]]

When you open the application for the first time, you will see the following notice:
[[Image:Macos_install_extension.png|link=https://cdn.phidgets.com/docs/images/9/9e/Macos_install_extension.png|300px|center]]

Follow the link in the pop-up, or navigate to ''System Settings > General > Login Items & Extensions > Extensions'', and give permissions:
[[Image:Macos_install_extension_permission.png|link=https://cdn.phidgets.com/docs/images/a/ac/Macos_install_extension_permission.png|600px|center]]
<center>''Note: The driver extension is only required for legacy USB Phidgets running a HID USB stack. Refer to your product’s specifications page for information about its USB stack.''</center>

After running the application, you will see all the Phidgets that are plugged into your machine, as well as any Phidgets that are on your network.
[[Image:Os_macos_controlpanel.png|600px|link=https://cdn.phidgets.com/docs/images/a/a1/Os_macos_controlpanel.png|center]]

Click on the arrow beside a device to expand it so that you can see all available channels. Double-click on one of these channels to open up a window that lets you interact with it.

[[File:Os_macos_controlpanel_example.png‎|link=https://cdn.phidgets.com/docs/images/3/37/Os_macos_controlpanel_example.png|center|600px]]

The Phidget Control Panel can be used for testing devices, updating firmware, enabling a Phidget Network Server, and more. Visit the [[Phidget Control Panel|Phidget Control Panel page]] for more information.

===Programming===
When you are ready to develop your own applications, visit our [{{SERVER}}/docs/Programming_Resources programming resources page] and select your programming language to get started.

==Software License==
By downloading the installer and/or development files, you agree to adhere to the terms of the [{{SERVER}}/documentation/Licenses/Phidgets_EULA.pdf Phidgets End User License Agreement]. The Phidget libraries and development files are covered by the The 3-Clause BSD License.

Terms and Conditions

2026-04-15T16:12:13Z

Lmpacent: /* Security and Privacy */

[[Category:Linked From Website]]

==Product Warranty==

All Phidgets products are warranted to be free of defects in material or workmanship under normal use and service for a period of one year from the date of shipment. This warranty does not include damage resulting from accident or misuse. The warranty is also void if the product is modified. This warranty is in lieu of all other warranties expressed or implied including the implied warranties of merchantability of fitness for a particular purpose, whether arising by law, custom or conduct, and the rights and remedies provided under this warranty are exclusive and in lieu of any other rights or remedies. In no event shall Phidgets Incorporated be liable for consequential damages.

If you believe that your product is defective while still under warranty, {{ContactUs|contact us}}. Once the support desk confirms that the product is defective, we will replace your defective product free of charge.

==Shipping==
===Last Call at 12:00PM===
Orders received before 12:00 PM Mountain Time (GMT-07:00) Monday to Friday will be shipped the same day.

Orders containing cut-to-length parts may not ship on the same day due to the additional processing time associated with these orders.

===Shipping Costs===
Shipping costs are calculated at checkout and presented for your review before you confirm your order. If multiple shipping options are available for your destination, all options will be listed so you can choose the one that best suits your needs.

If you have your own UPS or FedEx account, you can use it at checkout and be billed directly by the carrier. This gives you access to a wider range of shipping options.

Note that a $5.00 handling charge is added to all orders that are under $50.00.

===Shipping in Canada===
We offer the following services:
* '''UPS Express Saver'''. 1 - 3 business days.
* '''UPS Expedited'''. 2 - 5 business days. Available for packages over 3 lbs.
* '''UPS Standard'''. 3 - 5 business days ground delivery.

===Shipping to the United States===
We offer the following services:
* '''UPS Express Saver'''. 1 - 3 business days.
* '''UPS Expedited'''. 2 - 5 business days. Available for packages over 3 lbs.
* '''UPS Standard'''. 3 - 5 business days ground delivery.

Effective May 2, 2025, orders shipped to the United States will incur additional duties, tariffs, and brokerage fees, regardless of the order value. For more details, visit our guide about [[U.S._Tariffs | U.S. Tariffs]].

===International Shipments===
We offer the following services:
* '''UPS Worldwide Express Saver'''. 1 - 3 business days.
* '''UPS Worldwide Expedited'''. 2 - 5 business days. Available for packages over 3 lbs.

====European Union====
Effective July 1, 2021, the European Union (EU) updated its Value Added Tax (VAT) regulations. All shipments to EU countries now require formal customs clearance and are subject to VAT based on the destination country.

For goods with an intrinsic value up to €150, VAT must be collected at the time of purchase. This means for orders under $200 USD, we require prepayment of VAT and brokerage fees at checkout to ensure fast, hassle-free delivery.

For orders over $200 USD, we provide the option to prepay all applicable import fees (including VAT and brokerage). If you choose this option, the quoted amount is guaranteed — there will be no additional charges upon delivery.

We use UPS® Global Checkout to collect import fees and taxes based on your product's HS Code and Country of Origin. There is a fee associated with the UPS® Global Checkout service. At Phidgets Inc., we continually monitor and negotiate all fees to ensure our customers receive the best deal possible.

Customs policies vary by country, so we recommend contacting your local customs office for more information.

====Other Countries====
International shipments may be subject to import duties, taxes, and brokerage fees upon arrival in your country. These charges are determined by your local customs authorities and are the responsibility of the recipient.

At checkout, we provide the option to prepay these fees. If you choose this option, the quoted amount is guaranteed — there will be no additional charges upon delivery.

We use UPS® Global Checkout to collect import fees and taxes based on your product's HS Code and Country of Origin. There is a fee associated with the UPS® Global Checkout service. At Phidgets Inc., we continually monitor and negotiate all fees to ensure our customers receive the best deal possible.

Customs policies vary by country, so we recommend contacting your local customs office for more information.

===Tracking Your Order===
You can track your shipment using the tracking number sent to you by email when your order was shipped.

===Refunds on Late Deliveries===

Normally, UPS will offer a service guarantee refund when their deliveries arrive late. However, for companies that apply for shipping discounts, this refund does not apply. Phidgets Inc. has applied for such discounts in order to keep shipping costs down and regrettably cannot offer compensation for late shipments.

===Damaged or Lost Shipment===

'''Shipping on our UPS account''' - Report all damaged or lost shipments to support@phidgets.com and include your order number. According to UPS, in order to be considered lost, a package must be undelivered 24 hours after the expected delivery date and time. Before contacting us, check your shipment status at ups.ca.

Damaged or lost items will be replaced at no charge (including shipping costs).

'''Shipping on your UPS account''' - You must notify your local UPS office. If they confirm that they have lost your shipment, you must repurchase the lost or damaged products from Phidgets and file a claim with your local UPS in order to get reimbursed.

===Refused/Missed Delivery===
If no one is available to accept the package upon delivery, UPS will attempt redelivery two more times, as per their standard procedure. If all delivery attempts fail, UPS will hold the package for 5 days before returning it to us. In such cases, we will issue a refund for your order minus the cost of shipping (both directions) and a flat $50 fee, up to the total value of the package. This policy applies both to deliveries that failed due to no one being present and to packages that were refused at the delivery address.

===Incoterms===

We use the following Incoterms depending on the shipping and payment arrangement:

* '''FCA (Free Carrier):''' Used when shipping on the customer’s carrier account. Risk and responsibility transfer to the customer once the goods are handed over to the carrier at our facility.

* '''DDP (Delivered Duty Paid):''' Used when the customer chooses to pre-pay import fees and taxes at checkout. We handle all import fees and deliver the goods to the destination address.

* '''DAP (Delivered at Place):''' Used when the customer opts to pay import fees and taxes upon delivery. We deliver the goods, but the customer is responsible for paying any import fees directly to the carrier.

==Product Returns==
===All Returns Must Be Authorized===
Before returning a package {{ContactUs|contact us}} and ask for a Return Merchandise Authorization or RMA number. Once you have received it, put the RMA number on the outside of the packaging as well as the packing slip so that it is possible for us to track what the package is supposed to be. Any merchandise returned without an RMA number clearly visible on the packaging will be charged an administrative fee of $25.00 or the value of the returned product, whichever is less ''if we are able to determine what it is''. In the event we are unable to determine what the package is, it will be refused and returned to the sender.

===Unopened Product===
Phidgets accepts returns of unopened products within 30 days of the date of purchase. To initiate a return, please contact us by phone or email to obtain an RMA number. Products must be shipped back to Phidgets Inc. prepaid. A refund will be issued to your credit card once we receive and inspect the returned items. The refund excludes the cost of shipping as well as any duties or brokerage charges incurred.

Returns received after 30 days are subject to a restocking fee of 25% of the package's value (minimum $5.00, maximum $500).

We do '''not''' accept returns beyond 90 days from the date of purchase.

===Cut to Length===
Unfortunately we cannot accept returns on any items which are cut to custom lengths. This includes: cable, wire, roller chain, linear shaft, rotary shaft, and t-slot extrusions.

===We Shipped the Wrong/Incomplete Product===
{{ContactUs|Contact us}}. We will get the correct product sent to you immediately, and will pay all shipping charges.

==Payment Terms==
We accept credit cards, PayPal, and Wire Transfers.

{| style="border:1px solid darkgray;" cellpadding="7px;"
|-style="background: #d1d1d1" align=center
! Payment Method|| Terms
|-
|style="background: #f0f0f0" align=center|Credit Cards
|style="background: #f0f0f0" align=left|Visa, MasterCard, American Express (for order in CAD only)
|-
|style="background: #f0f0f0" align=center|PayPal
|style="background: #f0f0f0" align=left|PayPal is accepted. There are no extra fees for using PayPal
|-
|style="background: #f0f0f0" align=center|Wire Transfers
|style="background: #f0f0f0" align=left|Wire transfers are only accepted for orders over $200.00 USD (excluding shipping charges). There is a $25.00 USD charge for wire transfers under $500.00 USD. Any fees charged by the sending bank are your responsibility.<br />Please make sure that the amount sent to us covers both our invoice and your bank fees. Products are not shipped until the money is deposited in our bank account. We recommend that you e-mail orders@phidgets.com with the amount of the transfer and the invoice you are paying. <br />Any order for which payment is not received within 15 days, will be canceled.
|}

==Security and Privacy==
Phidgets Inc. pledges a safe and worry-free shopping experience. If you are using the current version of Internet Explorer, on the checkout page where you enter your credit card information, you will notice a a locked padlock icon on the top bar your browser window. If you are using Mozilla Firefox, you will notice a locked padlock icon in the bottom right corner of your browser window. If this icon does not appear, please contact us directly to complete your purchase. These icons tell you that the page you are on is secure. We use Secure Sockets Layer (SSL 128-bit) technology with a digital certificate by GeoTrust, Inc. for Internet security to protect your personal information. This encryption makes it impossible for anyone to read your information in transit. We do not store your credit information and it is deleted once it has been securely transmitted to Moneris for processing.

We use your e-mail address to let you know your shipment's tracking number. Your phone number is required by the Courier Company. We do not sell, rent or give any of your personal information to any unrelated third parties with the exception of Moneris for authorizing credit card payments and the Courier company to let them know where to deliver the shipment and how to contact you if there is any problems.

{{ContactUs|Contact us}} if you have any questions or concerns about our Security and Privacy policy.

Phidgets Inc. uses various Google Analytics tools such as conversion tracking in order to improve the effectiveness of the website. These statistics are completely anonymous.

==Holidays==
Phidgets, Inc. will be closed on the following days. During these times, the site will still be accessible and orders can be placed, but they will not ship until the next business day.

{| style="border:1px solid darkgray;" cellpadding="7px;"
|-style="background: #d1d1d1" align=center
! style="text-align:center;"| Holiday
! style="text-align:center;"| Description
! style="text-align:center;"| 2026
! style="text-align:center;"| 2027
|-
|style="background: #f0f0f0" align=center| Alberta Family Day
|style="background: #f0f0f0" align=center| Third Monday in February
|style="background: #f0f0f0" align=center| Feb 16
|style="background: #f0f0f0" align=center| Feb 15
|-
|style="background: #f0f0f0" align=center| Good Friday
|style="background: #f0f0f0" align=center| Friday before Easter Sunday
|style="background: #f0f0f0" align=center| Apr 3
|style="background: #f0f0f0" align=center| Mar 26
|-
|style="background: #f0f0f0" align=center| Victoria Day
|style="background: #f0f0f0" align=center| Monday before May 25
|style="background: #f0f0f0" align=center| May 18
|style="background: #f0f0f0" align=center| May 24
|-
|style="background: #f0f0f0" align=center| Canada Day
|style="background: #f0f0f0" align=center| First day of July (or nearest business day)
|style="background: #f0f0f0" align=center| Jul 1
|style="background: #f0f0f0" align=center| Jul 1
|-
|style="background: #f0f0f0" align=center| Civic Holiday
|style="background: #f0f0f0" align=center| First Monday in August
|style="background: #f0f0f0" align=center| Aug 3
|style="background: #f0f0f0" align=center| Aug 2
|-
|style="background: #f0f0f0" align=center| Labour Day
|style="background: #f0f0f0" align=center| First Monday in September
|style="background: #f0f0f0" align=center| Sept 7
|style="background: #f0f0f0" align=center| Sept 6
|-
|style="background: #f0f0f0" align=center| Thanksgiving
|style="background: #f0f0f0" align=center| Second Monday in October
|style="background: #f0f0f0" align=center| Oct 12
|style="background: #f0f0f0" align=center| Oct 11
|-
|style="background: #f0f0f0" align=center| Remembrance Day
|style="background: #f0f0f0" align=center| November 11 (or nearest business day)
|style="background: #f0f0f0" align=center| Nov 11
|style="background: #f0f0f0" align=center| Nov 11
|-
|style="background: #f0f0f0" align=center| Christmas and New Years
|style="background: #f0f0f0" align=center| Varies
|style="background: #f0f0f0" align=center| TBA
|style="background: #f0f0f0" align=center| TBA
|-
|}

Terms and Conditions

2026-04-15T16:11:33Z

Lmpacent: /* Security and Privacy */

[[Category:Linked From Website]]

==Product Warranty==

All Phidgets products are warranted to be free of defects in material or workmanship under normal use and service for a period of one year from the date of shipment. This warranty does not include damage resulting from accident or misuse. The warranty is also void if the product is modified. This warranty is in lieu of all other warranties expressed or implied including the implied warranties of merchantability of fitness for a particular purpose, whether arising by law, custom or conduct, and the rights and remedies provided under this warranty are exclusive and in lieu of any other rights or remedies. In no event shall Phidgets Incorporated be liable for consequential damages.

If you believe that your product is defective while still under warranty, {{ContactUs|contact us}}. Once the support desk confirms that the product is defective, we will replace your defective product free of charge.

==Shipping==
===Last Call at 12:00PM===
Orders received before 12:00 PM Mountain Time (GMT-07:00) Monday to Friday will be shipped the same day.

Orders containing cut-to-length parts may not ship on the same day due to the additional processing time associated with these orders.

===Shipping Costs===
Shipping costs are calculated at checkout and presented for your review before you confirm your order. If multiple shipping options are available for your destination, all options will be listed so you can choose the one that best suits your needs.

If you have your own UPS or FedEx account, you can use it at checkout and be billed directly by the carrier. This gives you access to a wider range of shipping options.

Note that a $5.00 handling charge is added to all orders that are under $50.00.

===Shipping in Canada===
We offer the following services:
* '''UPS Express Saver'''. 1 - 3 business days.
* '''UPS Expedited'''. 2 - 5 business days. Available for packages over 3 lbs.
* '''UPS Standard'''. 3 - 5 business days ground delivery.

===Shipping to the United States===
We offer the following services:
* '''UPS Express Saver'''. 1 - 3 business days.
* '''UPS Expedited'''. 2 - 5 business days. Available for packages over 3 lbs.
* '''UPS Standard'''. 3 - 5 business days ground delivery.

Effective May 2, 2025, orders shipped to the United States will incur additional duties, tariffs, and brokerage fees, regardless of the order value. For more details, visit our guide about [[U.S._Tariffs | U.S. Tariffs]].

===International Shipments===
We offer the following services:
* '''UPS Worldwide Express Saver'''. 1 - 3 business days.
* '''UPS Worldwide Expedited'''. 2 - 5 business days. Available for packages over 3 lbs.

====European Union====
Effective July 1, 2021, the European Union (EU) updated its Value Added Tax (VAT) regulations. All shipments to EU countries now require formal customs clearance and are subject to VAT based on the destination country.

For goods with an intrinsic value up to €150, VAT must be collected at the time of purchase. This means for orders under $200 USD, we require prepayment of VAT and brokerage fees at checkout to ensure fast, hassle-free delivery.

For orders over $200 USD, we provide the option to prepay all applicable import fees (including VAT and brokerage). If you choose this option, the quoted amount is guaranteed — there will be no additional charges upon delivery.

We use UPS® Global Checkout to collect import fees and taxes based on your product's HS Code and Country of Origin. There is a fee associated with the UPS® Global Checkout service. At Phidgets Inc., we continually monitor and negotiate all fees to ensure our customers receive the best deal possible.

Customs policies vary by country, so we recommend contacting your local customs office for more information.

====Other Countries====
International shipments may be subject to import duties, taxes, and brokerage fees upon arrival in your country. These charges are determined by your local customs authorities and are the responsibility of the recipient.

At checkout, we provide the option to prepay these fees. If you choose this option, the quoted amount is guaranteed — there will be no additional charges upon delivery.

We use UPS® Global Checkout to collect import fees and taxes based on your product's HS Code and Country of Origin. There is a fee associated with the UPS® Global Checkout service. At Phidgets Inc., we continually monitor and negotiate all fees to ensure our customers receive the best deal possible.

Customs policies vary by country, so we recommend contacting your local customs office for more information.

===Tracking Your Order===
You can track your shipment using the tracking number sent to you by email when your order was shipped.

===Refunds on Late Deliveries===

Normally, UPS will offer a service guarantee refund when their deliveries arrive late. However, for companies that apply for shipping discounts, this refund does not apply. Phidgets Inc. has applied for such discounts in order to keep shipping costs down and regrettably cannot offer compensation for late shipments.

===Damaged or Lost Shipment===

'''Shipping on our UPS account''' - Report all damaged or lost shipments to support@phidgets.com and include your order number. According to UPS, in order to be considered lost, a package must be undelivered 24 hours after the expected delivery date and time. Before contacting us, check your shipment status at ups.ca.

Damaged or lost items will be replaced at no charge (including shipping costs).

'''Shipping on your UPS account''' - You must notify your local UPS office. If they confirm that they have lost your shipment, you must repurchase the lost or damaged products from Phidgets and file a claim with your local UPS in order to get reimbursed.

===Refused/Missed Delivery===
If no one is available to accept the package upon delivery, UPS will attempt redelivery two more times, as per their standard procedure. If all delivery attempts fail, UPS will hold the package for 5 days before returning it to us. In such cases, we will issue a refund for your order minus the cost of shipping (both directions) and a flat $50 fee, up to the total value of the package. This policy applies both to deliveries that failed due to no one being present and to packages that were refused at the delivery address.

===Incoterms===

We use the following Incoterms depending on the shipping and payment arrangement:

* '''FCA (Free Carrier):''' Used when shipping on the customer’s carrier account. Risk and responsibility transfer to the customer once the goods are handed over to the carrier at our facility.

* '''DDP (Delivered Duty Paid):''' Used when the customer chooses to pre-pay import fees and taxes at checkout. We handle all import fees and deliver the goods to the destination address.

* '''DAP (Delivered at Place):''' Used when the customer opts to pay import fees and taxes upon delivery. We deliver the goods, but the customer is responsible for paying any import fees directly to the carrier.

==Product Returns==
===All Returns Must Be Authorized===
Before returning a package {{ContactUs|contact us}} and ask for a Return Merchandise Authorization or RMA number. Once you have received it, put the RMA number on the outside of the packaging as well as the packing slip so that it is possible for us to track what the package is supposed to be. Any merchandise returned without an RMA number clearly visible on the packaging will be charged an administrative fee of $25.00 or the value of the returned product, whichever is less ''if we are able to determine what it is''. In the event we are unable to determine what the package is, it will be refused and returned to the sender.

===Unopened Product===
Phidgets accepts returns of unopened products within 30 days of the date of purchase. To initiate a return, please contact us by phone or email to obtain an RMA number. Products must be shipped back to Phidgets Inc. prepaid. A refund will be issued to your credit card once we receive and inspect the returned items. The refund excludes the cost of shipping as well as any duties or brokerage charges incurred.

Returns received after 30 days are subject to a restocking fee of 25% of the package's value (minimum $5.00, maximum $500).

We do '''not''' accept returns beyond 90 days from the date of purchase.

===Cut to Length===
Unfortunately we cannot accept returns on any items which are cut to custom lengths. This includes: cable, wire, roller chain, linear shaft, rotary shaft, and t-slot extrusions.

===We Shipped the Wrong/Incomplete Product===
{{ContactUs|Contact us}}. We will get the correct product sent to you immediately, and will pay all shipping charges.

==Payment Terms==
We accept credit cards, PayPal, and Wire Transfers.

{| style="border:1px solid darkgray;" cellpadding="7px;"
|-style="background: #d1d1d1" align=center
! Payment Method|| Terms
|-
|style="background: #f0f0f0" align=center|Credit Cards
|style="background: #f0f0f0" align=left|Visa, MasterCard, American Express (for order in CAD only)
|-
|style="background: #f0f0f0" align=center|PayPal
|style="background: #f0f0f0" align=left|PayPal is accepted. There are no extra fees for using PayPal
|-
|style="background: #f0f0f0" align=center|Wire Transfers
|style="background: #f0f0f0" align=left|Wire transfers are only accepted for orders over $200.00 USD (excluding shipping charges). There is a $25.00 USD charge for wire transfers under $500.00 USD. Any fees charged by the sending bank are your responsibility.<br />Please make sure that the amount sent to us covers both our invoice and your bank fees. Products are not shipped until the money is deposited in our bank account. We recommend that you e-mail orders@phidgets.com with the amount of the transfer and the invoice you are paying. <br />Any order for which payment is not received within 15 days, will be canceled.
|}

==Security and Privacy==
Phidgets Inc. pledges a safe and worry-free shopping experience. If you are using the current version of Internet Explorer, on the checkout page where you enter your credit card information, you will notice a a locked padlock icon on the top bar your browser window. If you are using Mozilla Firefox, you will notice a locked padlock icon in the bottom right corner of your browser window. If this icon does not appear, please contact us directly to complete your purchase. These icons tell you that the page you are on is secure. We use Secure Sockets Layer (SSL 128-bit) technology with a digital certificate by GeoTrust, Inc. for Internet security to protect your personal information. This encryption makes it impossible for anyone to read your information in transit. We do not store your credit information and it is deleted once it has been securely transmitted to Moneris for processing.

We use your e-mail address to let you know your shipment's tracking number. Your phone number is required by the Courier Company. We do not sell, rent or give any of your personal information to any unrelated third parties with the exception of Moneris for authorizing credit card payments and the Courier company to let them know where to deliver the shipment and how to contact you if there is any problems.

If you have any questions or concerns about our Security and Privacy policy, call us at 1.403.282.7335 or e-mail us at support@phidgets.com

Phidgets Inc. uses various Google Analytics tools such as conversion tracking in order to improve the effectiveness of the website. These statistics are completely anonymous.

==Holidays==
Phidgets, Inc. will be closed on the following days. During these times, the site will still be accessible and orders can be placed, but they will not ship until the next business day.

{| style="border:1px solid darkgray;" cellpadding="7px;"
|-style="background: #d1d1d1" align=center
! style="text-align:center;"| Holiday
! style="text-align:center;"| Description
! style="text-align:center;"| 2026
! style="text-align:center;"| 2027
|-
|style="background: #f0f0f0" align=center| Alberta Family Day
|style="background: #f0f0f0" align=center| Third Monday in February
|style="background: #f0f0f0" align=center| Feb 16
|style="background: #f0f0f0" align=center| Feb 15
|-
|style="background: #f0f0f0" align=center| Good Friday
|style="background: #f0f0f0" align=center| Friday before Easter Sunday
|style="background: #f0f0f0" align=center| Apr 3
|style="background: #f0f0f0" align=center| Mar 26
|-
|style="background: #f0f0f0" align=center| Victoria Day
|style="background: #f0f0f0" align=center| Monday before May 25
|style="background: #f0f0f0" align=center| May 18
|style="background: #f0f0f0" align=center| May 24
|-
|style="background: #f0f0f0" align=center| Canada Day
|style="background: #f0f0f0" align=center| First day of July (or nearest business day)
|style="background: #f0f0f0" align=center| Jul 1
|style="background: #f0f0f0" align=center| Jul 1
|-
|style="background: #f0f0f0" align=center| Civic Holiday
|style="background: #f0f0f0" align=center| First Monday in August
|style="background: #f0f0f0" align=center| Aug 3
|style="background: #f0f0f0" align=center| Aug 2
|-
|style="background: #f0f0f0" align=center| Labour Day
|style="background: #f0f0f0" align=center| First Monday in September
|style="background: #f0f0f0" align=center| Sept 7
|style="background: #f0f0f0" align=center| Sept 6
|-
|style="background: #f0f0f0" align=center| Thanksgiving
|style="background: #f0f0f0" align=center| Second Monday in October
|style="background: #f0f0f0" align=center| Oct 12
|style="background: #f0f0f0" align=center| Oct 11
|-
|style="background: #f0f0f0" align=center| Remembrance Day
|style="background: #f0f0f0" align=center| November 11 (or nearest business day)
|style="background: #f0f0f0" align=center| Nov 11
|style="background: #f0f0f0" align=center| Nov 11
|-
|style="background: #f0f0f0" align=center| Christmas and New Years
|style="background: #f0f0f0" align=center| Varies
|style="background: #f0f0f0" align=center| TBA
|style="background: #f0f0f0" align=center| TBA
|-
|}

Controlling an SPI Encoder

2026-04-15T15:48:57Z

Lmpacent:

[[Category: Project]]
{{#seo:|keywords=SPI Adapter}}
{{#seo:|description=Control an SPI encoder with the SPI Adapter Phidget}}
<div style="display:none;">
[[Image:Adp0002_spiencoder_primary.png|thumb|link=|alt=]]
</div>
[[Image:ADP0002_0.jpg|link=|thumb| 400px|<center>[https://www.phidgets.com/?prodid=1355 SPI Adapter Phidget (ADP0002_0)]]]
==Introduction==
The [https://www.phidgets.com/?prodid=1355 SPI Adapter Phidget] allows you to interface with a wide range of SPI-compatible devices, including sensors, displays, and more.

In this project, we will use it to control an absolute position magnetic encoder.

===Steps===
To complete this project, we will work through the following steps:
# Determine the device's basic configuration parameters
# Identify the sequence of commands expected by the device
# Connect the device to the SPI Adapter Phidget
# Test the device using the Phidget Control Panel
# Create a custom program.

===Resources===
Information from the following datasheet will be referenced throughout this project:
* [https://ams-osram.com/products/boards-kits-accessories/boards/ams-as5048a-ts-evm-ab-evaluation-board Device Product Page]
* [https://cdn.phidgets.com/docs/images/f/fd/AS5048A.pdf AS5048A Encoder Datasheet]

==Demonstration==
<center>{{#ev:youtube|-TkTykk1Ris|rel=0}}</center>

===Additional Information===
[[Image:Adp0002_magnet.png|link=https://cdn.phidgets.com/docs/images/2/2e/Adp0002_magnet.png|thumb]]
The encoder is designed to be used with a small magnet, magnetized with the poles on the edges of the cylinder instead of the top and bottom. The magnet can be attached to the exposed rear shaft of a motor, and this sensor can use the position of the magnetic field to determine the absolute position of the shaft.

==Configuration Parameters==
During this step, we are looking for the following information:
* Supply Voltage
* Communication Frequency
* Endianness (MSB-first or LSB-first)
* Chip Select Polarity
* SPI Wire Mode

This information is typically found using the device's product page and/or any relevant datasheets.
Based on the AS5048A datasheet, we will use the following parameters:
* Supply Voltage: 3.3V or 5V (we'll use 5V)
* Communication Frequency: The clock period is 100ns minimum (10MHz maximum)
* Endianness: MSB-first
* Chip Select: Active Low
* SPI Wire Mode: Mode = 1

==Command Sequence==
Next, we need to determine the sequence of commands the device is expecting. Some devices have certain commands that must be sent to configure the device, but this one is ready to provide sensor data as soon as it's powered up.

[[Image:SPI_commandflow.png|link=|center|800px]]
<center>''AS5048A datasheet (page 11)''</center>

This diagram explains that each command we send will have its response delivered during the next transaction. Since our first goal is to get a stream of angle data from the encoder, we can just continuously send the Read Angle command.

===Reading from AS5048A Registers===

Commands sent to the encoder must follow the following format:
[[Image:SPI_command_package.png|link=|center|800px]]
<center>''AS5048A datasheet (page 14)''</center>
This table tells us that the 16-bit command package consists of a parity bit, a read/write bit, and then a 14-bit register address.

There are three data readout registers we can access. Here is the definition for the angle register:

[[Image:SPI_command_angle_readout.png|link=|center|800px]]
<center>''AS5048A datasheet (page 17)''</center>

The register address for the angle data is '''0x3FFF''', but this is not the complete 16-bit value we need to transmit. First, we must add the R/W bit (Read=1) and then calculate the parity bit for even parity.

[[Image:SPI_command_parity.png|link=|center|700px]]
<center>''Calculating the parity bit''</center>

This results in '''0xFFFF''', which is the command we need to send with the SPI Phidget.

== Connecting to the ADP0002 ==

The wiring for this sensor is very straightforward with the ADP0002:
[[Image:SPI_encoder_pinout.png|link=|120px|left]]
* '''5V''' - VCC
* '''3.3V''' - Not connected
* '''PWM''' - Not connected
* '''SDA/CSn''' - CS
* '''SCL/SCK''' - SCLK
* '''A1/MOSI''' - MOSI
* '''A2/MISO''' - MISO
* '''GND''' - GND

[[Image:SPI_wiring_diagram.png|link=|center|800px]]

== Testing in the Phidget Control Panel ==
Now that we have the configuration parameters and the command sequence, we can use the Phidget Control Panel to confirm our device is working as expected.

=== Reading the Angle ===

==== Reading the Angle in the Control Panel ====
Set the voltage to 5V, the chip select to Active Low, the wire mode to Mode_1, and the frequency to any value as they are all within the stated range.

We can try sending our '''0xFFFF''' command we calculated in the previous step:

[[Image:SPI_angle_send.png|link=|center|800px]]

The first response is an empty '''0x0000''', because responses are always sent in the next transaction. After that, we start getting data back from the encoder. In order to decode these values, we must go back to the datasheet and pay attention to the read package format.

==== Decoding the Read Data Package ====
[[Image:SPI_read_package.png|link=|center|800px]]
<center>''AS5048A datasheet (page 15)''</center>

Similar to the command package, it's made up of two control bits and one 14-bit value. The control bits are a parity bit to ensure communication fidelity, and an error flag that activates if there's a problem with the previous transaction. In this example we'll ignore these bits, but in an actual deployment you'd want to be checking both of these bits on each transaction.

So to decode the response for our angle command, '''0x9048''', we need to strip the top two bits:

[[Image:SPI_decode_response.png|link=|center|800px]]

This leaves us with '''0x1048''', or 4168 in decimal. The encoder has 14-bit precision, so the formula is as follows:

::<math>\text{Angle(°)} = \frac{\text{n}}{2^{14}} \times 360 \!</math>

Where 'n' is the response in decimal. Using this equation, our angle works out to '''91.58 degrees'''. When we eventually write our own program, we'll handle all of this bit manipulation and unit conversion in code.

=== Zeroing the Encoder ===

The advantage of an absolute encoder is that the actual angle of the shaft will be known as soon as the system is powered, without need for calibration or homing. This also means that the "home position" of our rotary system will be an arbitrary angle. We could zero this by keeping track of the initial angle in our program, but this chip has its own zeroing feature, so let's take a look.

==== Zeroing Command Registers and Sequence ====

We can find the zeroing process in the datasheet:
# Clear zero position registers by writing '0' into them
# Read the current angle
# Write the angle into the zero position registers
# (optional) Burn the value into the register so it persists across power cycles

For now we'll only do the steps 2 and 3, since the zero position registers will already be zero on startup by default since we haven't burned a value into the register. In our final program we'll be using the zero as a sort of 'tare' function so we will have to do the first step there. Here are the zero register definitions:

[[Image:SPI_zero_registers.png|link=|center|800px]]
<center>''AS5048A datasheet (page 17)''</center>

Just as before, we need to add the proper control bits to these address values before we send them.
* Write to Zero Position Hi: 0x0016 -> '''0x8016'''
* Write to Zero Position Lo: 0x0017 -> '''0x0017'''

For each of these registers, we'll follow this flow:
* Write to the zero position command
* Send the angle data
* Send a NOP (empty command) to confirm data sent

==== Zeroing in the Control Panel ====

In this example, our received data is '''0xBB99'''. Stripping the control bits, we get '''0x3B99''' or '''11 1011 1001 1001''' in binary. According to the zero register definitions, we need the 6 least significant bits in the low register, and the other 8 in the high register. This gives us:

* LSB: '''0b011001''' '''(0x19)''' -> '''0x8019'''
* MSB: '''0b11101110''' '''(0xEE)''' -> '''0x00EE'''

Again, since we need to set the write bits and proper parity, we end up with '''0x8019''' and '''0x00EE'''. Here's what the zeroing process looks like in the control panel (annotations added for clarity):

[[Image:SPI_controlpanel_zero.png|link=|center|850px]]

There are no error bits set in the responses, and each register we set echoed back the correct value when we wrote to it. The angle response we got after zeroing is '''0xBFF7'''.

* Strip control bits -> 0x3FF7
* Convert to decimal -> 16375
* Angle formula -> 359.80°

Since our new angle is close to 360° (the same as 0°), it looks like the zeroing process was successful.

== Writing a Custom Python Script ==

To begin writing a custom program for your Phidget device, navigate to the product page and select the [https://www.phidgets.com/?prodid=1354#Tab_Code_Samples Code Samples tab]. From there, you can customize the code for your own purposes. Here we have modified the code sample to demonstrate a simple readout of the encoder angle:

<syntaxhighlight lang=python>
from Phidget22.Phidget import *
from Phidget22.Devices.DataAdapter import *
import time

def hex2angle(hex):
bytes = (hex[0] << 8) | hex[1] # Combine MSB and LSB
bytes = bytes & 0b0011111111111111 # Discard top two bits (parity and error flag bits)
angle = round(bytes / 16348*360,3) # Divide by 2^14, multiply by 360 to get degrees
return angle

def main():
# Open ADP0002
adp = DataAdapter()
adp.openWaitForAttachment(5000)

# Set properties
adp.setEndianness(DataAdapterEndianness.ENDIANNESS_MSB_FIRST)
adp.setFrequency(DataAdapterFrequency.FREQUENCY_1500kHz)
adp.setDataAdapterVoltage(DataAdapterVoltage.DATAADAPTER_VOLTAGE_5_0V)
adp.setSPIChipSelect(DataAdapterSPIChipSelect.SPI_CHIP_SELECT_ACTIVE_LOW)
adp.setSPIMode(DataAdapterSPIMode.SPI_MODE_1)
time.sleep(0.5)

# Read and print angle until keyboard interrupt
print("Printing encoder data. Press CTRL+C to quit.")
try:
while True:
recvData = adp.sendPacketWaitResponse([0xFF,0xFF])
print(f"\rEncoder Angle: {hex2angle(recvData)} ",end="",flush=True)
time.sleep(0.1)

except KeyboardInterrupt:
pass

adp.close()

main()
</syntaxhighlight>

That’s about it, we went from reading the datasheet to a working script. Not all datasheets are created equal, so if you’re struggling with getting your sensor set up, feel free to ask for help by [https://www.phidgets.com/?view=contact sending us an email].

===Full Script===
Here is the full Python script that was used in the demonstration video. It displays the encoder angle and also provides the option to zero the encoder.

{{UGC-Entry|Full Script (Click to expand)||
<syntaxhighlight lang=python>
from Phidget22.Phidget import *
from Phidget22.Devices.DataAdapter import *
import time
import threading

# Register definitions from datasheet
ANGLE = [0x3F,0xFF]
MAGNITUDE = [0x3F,0xFE]
DIAGNOSTIC = [0x3F,0xFD]
CLEAR_ERR = [0x00,0x01]
NOP = [0x00,0x00]
ZERO_POS_HI = [0x00,0x16]
ZERO_POS_LO = [0x00,0x17]
READ = 1
WRITE = 0

adp = DataAdapter()

# Listener for keypress during main loop
running = True
def keyboard_listener():
global running
while running:
cmd = input().strip().lower()
if cmd == "z":
zero()
elif cmd == "q":
running = False

# Adds the required RW and parity bits
def addBits(packet,rw):
bits = ((packet[0] << 8) | packet[1]) & 0x3FFF

if(rw):
bits = bits | 0b0100000000000000
else:
bits = bits & 0b1011111111111111

if(bits.bit_count()%2 == 0):
bits = bits & 0b0111111111111111
else:
bits = bits | 0b1000000000000000

res = [(bits >> 8)& 0xFF,(bits & 0xFF)]
return res

def zero():
# Clear zero registers - this is needed to be able to zero more than once per run
adp.sendPacket(addBits(ZERO_POS_HI,WRITE))
adp.sendPacket(addBits([0x00,0x00],WRITE))
adp.sendPacket(addBits(NOP,WRITE))
adp.sendPacket(addBits(ZERO_POS_LO,WRITE))
adp.sendPacket(addBits([0x00,0x00],WRITE))
adp.sendPacket(addBits(NOP,WRITE))

# Read current angle
adp.sendPacket(addBits(ANGLE,READ))
resp = adp.sendPacketWaitResponse(addBits(NOP,WRITE))

# Combine angle bytes and mask out err/parity bits
angle = ((resp[0] << 8) | resp[1]) & 0x3FFF

# Split out angle for sending to zero registers
zposm = (angle >> 6) & 0xFF
zposl = angle & 0x3F

# write ZPOSM (0x0016)
resp = adp.sendPacketWaitResponse(addBits(ZERO_POS_HI,WRITE))
resp = adp.sendPacketWaitResponse(addBits([0x00,zposm],WRITE))
resp = adp.sendPacketWaitResponse(addBits(NOP,WRITE))

# write ZPOSL (0x0017)
resp = adp.sendPacketWaitResponse(addBits(ZERO_POS_LO,WRITE))
resp = adp.sendPacketWaitResponse(addBits([0x00,zposl],WRITE))
resp = adp.sendPacketWaitResponse(addBits(NOP,WRITE))

def hex2angle(hex):
bytes = (hex[0] << 8) | hex[1] # Combine MSB and LSB
bytes = bytes & 0b0011111111111111 # Discard top two bits (parity and error flag bits)
angle = round(bytes / 16348*360,3) # Divide by 2^14, multiply by 360 to get degrees
return angle

def main():
# Open ADP0002
adp.openWaitForAttachment(5000)

# Set properties
adp.setEndianness(DataAdapterEndianness.ENDIANNESS_MSB_FIRST)
adp.setFrequency(DataAdapterFrequency.FREQUENCY_1500kHz)
adp.setDataAdapterVoltage(DataAdapterVoltage.DATAADAPTER_VOLTAGE_5_0V)
adp.setSPIChipSelect(DataAdapterSPIChipSelect.SPI_CHIP_SELECT_ACTIVE_LOW)
adp.setSPIMode(DataAdapterSPIMode.SPI_MODE_1)
time.sleep(0.5)

# Start thread for keypress detection during the loop
threading.Thread(target=keyboard_listener, daemon=True).start()
print("Printing encoder data. Press 'z' to zero and 'q' to quit.")

# Read and print angle until 'q' pressed
try:
while running:
recvData = adp.sendPacketWaitResponse(addBits(ANGLE,READ))
print(f"\rEncoder Angle: {hex2angle(recvData)} ",end="",flush=True)
time.sleep(0.1)

except KeyboardInterrupt:
pass

adp.close()

main()
</syntaxhighlight>
}}
{{UGC-End}}

File:Adp0002 spiencoder primary.png

2026-04-15T15:48:35Z

Lmpacent:

Reading an I2C Color Sensor

2026-04-15T15:46:47Z

Lmpacent:

[[Category: Project]]
{{#seo:|keywords=I2C Adapter}}
{{#seo:|description=Read an I2C color sensor with the I2C Adapter Phidget}}
<div style="display:none;">
[[Image:Adp0001_rgbcolor_primary.png|thumb|link=|alt=]]
</div>
==Introduction==
[[Image:ADP0001_0_169.jpg|link=https://cdn.phidgets.com/docs/images/f/f5/ADP0001_0_169.jpg|thumb| 450px|<center>[https://www.phidgets.com/?prodid=1354 I2C Adapter Phidget (ADP0001_0)]]]
The [https://www.phidgets.com/?prodid=1354 I2C Adapter Phidget] allows you to interface with a wide range of I2C-compatible devices, including sensors, displays, and more.

In this project, we will use it to read data from an RGB Color Sensor.

===Steps===
To complete this project, we will work through the following steps:
# Determine the device's basic configuration parameters
# Identify the sequence of commands expected by the device
# Connect the device to the I2C Adapter Phidget
# Test the device using the Phidget Control Panel
# Create a custom program.

===Resources===
Information from the following resource will be referenced throughout this project.
* [https://cdn.phidgets.com/docs/images/1/13/TCS34725.pdf TCS34725 RGB Color Sensor IC Datasheet]

==Demonstration==
<center>{{#ev:youtube|dYREkxXgjEA|rel=0}}</center>

==Configuration Parameters==
[[Image:Adp0002_rgb_specs2.png|link=https://cdn.phidgets.com/docs/images/0/05/Adp0002_rgb_specs2.png|thumb|<center>Excerpts from Datasheet</center>]]

During this step, we are looking for the following information:
* Supply Voltage
* Communication Frequency
* Device Address

This information is typically found using the device's product page and/or datasheet. In this case, it was all found on pages 3 to 5 of the datasheet:
* Supply Voltage: 3.3V
* Communication Frequency: 400kHz
* I2C Address: 0x29
<div style="clear:both">

==Command Sequence==
Next, we need to determine the sequence of commands the device is expecting. The TCS34725 datasheet provides a state diagram that we can use to create a list of actions:

[[Image:Adp0002_rgb_states.png|link=https://cdn.phidgets.com/docs/images/0/0e/Adp0002_rgb_states.png|200px|right|thumb|<center>From datasheet (page 7)</center>]]

<br>Based on the state diagram, our list of actions should look like this:

'''Power On Steps''':
# Enable PON (power on) to go from sleep to idle state
# Enable AEN (RGB enabled) to go from idle to RGBC state

After these steps, the device should be able to provide data and respond to commands. We're not using WEN (wait enabled) since we don't need this power-saving feature at this time.

===Writing to TCS34725 Registers===
I2C devices typically expect the following format:

[[Image:Adp0002_an_typicalcomms3.png|link=https://cdn.phidgets.com/docs/images/2/29/Adp0002_an_typicalcomms3.png|600px]]

This protocol diagram from page 12 of the datasheet confirms that the TCS34725 behaves as expected:

[[Image:Adp0002_rgb_protocol.png|link=https://cdn.phidgets.com/docs/images/3/38/Adp0002_rgb_protocol.png|700px]]

The Start (S), Stop (P), Acknowledge (A), and W/R (Write/Read) is all handled internally by the I2C Phidget, so we just need to focus on the command code and data.

==== Command Register ====

The command register lets us tell the sensor which register we want to read or write on our next communication.

[[Image:Adp0002_rgb_cmdreg.png|link=https://cdn.phidgets.com/docs/images/0/0d/Adp0002_rgb_cmdreg.png|750px|center]]

* The first bit is always '1'
* The next two bits control the how the device behaves when requesting multiple bytes
* The last five bits hold the register address (we can ignore the special functions for this project)

Here's an abridged list of registers we'll be using:

[[Image:Adp0002_rgb_registers.png|link=https://cdn.phidgets.com/docs/images/4/48/Adp0002_rgb_registers.png|600px|center]]

===Power On Steps===
====Enable the Sensor====
Enable is managed by register '''0x00''', so our command register will look like this:

[[Image:Adp0002_rgb_cmdenable.png|link=https://cdn.phidgets.com/docs/images/0/03/Adp0002_rgb_cmdenable.png|center|850px]]

So we'll send '''0x80''' to select the enable register.

The enable register is defined in the datasheet as follows:

[[Image:Adp0002_rgb_enablereg.png|link=https://cdn.phidgets.com/docs/images/8/89/Adp0002_rgb_enablereg.png|center|850px]]

* Bits 5, 6, and 7 are '''000''', as they're reserved
* Bit 4 will be '''0''', since we're not using interrupts
* Bit 3 will be '''0''', since we're not using the wait feature
* Bit 2 is '''0''', as it's reserved
* Bit 1 will be '''0''', since we're not enabling RGBC yet
* Bit 0 will be '''1''', to enable power

That gives us '''0x01'''. Together with our command register, our first communication will be '''0x8001'''.
The reason we don't enable RGBC yet is because the device requires a 2.4ms delay between PON and RGBC for reliable startup.

====Enable RGBC====

To enable RGBC we will use the same command we used for power on, but both the AEN bit and the PON bit will be 1. This gives us '''0x8003'''.

=== Reading Data ===

Now that the sensor is initialized, we can start getting data from it. We want to read all eight color registers, so we need to set auto-increment in the command register and point it to the first color register which is at 0x14:

[[Image:Adp0002_rgb_cmdreadauto.png|link=https://cdn.phidgets.com/docs/images/8/87/Adp0002_rgb_cmdreadauto.png|center|850px]]

This means we need to send '''B4'''. After that, we can listen for 8 bytes at a time to get all of our color data.

== Connecting to the ADP0001 ==

The pinout for this sensor is printed on the PCB:

[[Image:I2C_rgb_pinout2.png|link=|130px|left]]

*'''VIN''' - Power
*'''GND''' - Ground
*'''3V3''' - 3.3V Output
*'''SCL''' - Serial Clock
*'''SDA''' - Serial Data
*'''INT''' - Interrupt
*'''LED''' - LED toggle

We don't need the 3.3V output or the interrupt pin for this project. The other pins can be connected to the ADP0001 as follows:

[[Image:I2C_rgb_connection.png|800px|link=https://cdn.phidgets.com/docs/images/d/d9/I2C_rgb_connection.png]]

The LED toggle pin is connected to one of the ADP0001's GPIO pins so we can use it to turn off the LED when not in use.

==Testing in the Phidget Control Panel==
Now that we have the command sequence and our sensor connected, we can use the Phidget Control Panel to confirm our device is working as expected.

===Power On Steps===
We can set the voltage to 3.3V, the frequency to 400kHz, and the address to 0x29.

[[Image:I2C_RGB_ControlPanel.png|link=https://cdn.phidgets.com/docs/images/2/20/I2C_RGB_ControlPanel.png|center]]

Now we can enable the sensor with our command sequence:
* 0x8001 (Power on)
* 0x8003 (RGBC on)
* 0xB4 (auto increment and start from register 0x14)

[[Image:I2C_RGB_ControlPanel2.png|link=https://cdn.phidgets.com/docs/images/4/4f/I2C_RGB_ControlPanel2.png|center]]

===Reading Data===
After sending the command register B4, we can read all color registers by reading 8 bytes at a time.

[[Image:I2C_RGB_ControlPanel3.png|link=https://cdn.phidgets.com/docs/images/0/0a/I2C_RGB_ControlPanel3.png|center]]
[[Image:I2C_RGB_responsegraph.png|link=https://wwwdev.int.phidgets.com/docs/images/9/97/I2C_RGB_responsegraph.png|thumb|<center>Sensor response characteristic (pg.6)<center>]]

This sensor ultimately provides us with four 16-bit values: Clear, Red, Green, and Blue. The clear light value is important for providing brightness calibration. Since the responses of the red, green and blue sensors are normalized to match the response of the clear sensor, we can use it as a baseline to determine color in both bright and dim environments.

In the above image, we get roughly the same value when polling the sensor three times, so the value seems stable. We'll use the bottom row to see if the color makes sense. The data bytes received are sent in register order, so our values are:

* Clear: 0x0FFD
* Red: 0x0A96
* Green: 0x0331
* Blue: 0x0271

Converting to decimal, that's 4093, 2710, 817, 625. We can normalize the last three values using the clear value, and then multiply by 255 and round to get a standard RGB value:

* Red: (2710/4093)*255 = 169
* Green: (817/4093)*255 = 51
* Blue: (625/4093)*255 = 39

This RGB value '''<span style="color:#A93327">(#A93327)</span>''' looks to be correct, as the sensor was pointed at a roll of red electrical tape.

==Writing a Custom Program==
To begin writing a custom program for your Phidget device, navigate to the product page and select the [https://www.phidgets.com/?prodid=1354#Tab_Code_Samples Code Samples tab]. From there, you can customize the code for your own purposes. Here we have modified the Python code sample to match our steps from the Phidget Control Panel.

<syntaxhighlight lang=python>
from Phidget22.Phidget import *
from Phidget22.Devices.DataAdapter import *
import time

def convert_rgbc(data):

c = data[1] << 8 | data[0]

if(c <= 0):
return [0,0,0]

# Combine high and low bytes for each color,
# Then normalize and cap at 255
r = min(255,round((data[3] << 8 | data[2]) / c * 255))
g = min(255,round((data[5] << 8 | data[4]) / c * 255))
b = min(255,round((data[7] << 8 | data[6]) / c * 255))
return [r,g,b]

def main():

adp = DataAdapter()
adp.openWaitForAttachment(5000)

# Set properties
adp.setFrequency(DataAdapterFrequency.FREQUENCY_400kHz)
adp.setDataAdapterVoltage(DataAdapterVoltage.DATAADAPTER_VOLTAGE_3_3V)
addr = 0x29

# Power On
adp.i2cSendReceive(addr, [0x8001], 0)
time.sleep(0.01)

# RGBC On
adp.i2cSendReceive(addr, [0x8003], 0)

# Auto-increment starting with CDATAL
adp.i2cSendReceive(addr, [0xB4], 0)

try:
while True:
rgb = convert_rgbc(adp.i2cSendReceive(addr, [], 8))
print("R: " + str(rgb[0]) + " G: " + str(rgb[1]) + " B: " + str(rgb[2]))
time.sleep(0.5)
pass
except KeyboardInterrupt:
print("Closing...")

adp.close()

main()
</syntaxhighlight>

That’s about it, we went from reading the datasheet to a working script. Not all datasheets are created equal, so if you’re struggling with getting your sensor set up, feel free to ask for help by [https://www.phidgets.com/?view=contact sending us an email].

===Python Graphical Example===
Here is a more in-depth script that displays a graph of the raw values and shows the calculated color after gamma and saturation adjustment.

{{UGC-Start}}
{{UGC-Entry|Full Script (Click to expand)||
<syntaxhighlight lang=python>
import tkinter as tk
import math
from Phidget22.Phidget import *
from Phidget22.Devices.DataAdapter import *
import time

class MultiLineGraph(tk.Canvas):
def __init__(self, parent, lines=4, max_points=100, **kwargs):
super().__init__(parent, bg="black", **kwargs)
self.lines = lines
self.max_points = max_points
self.data = [[] for _ in range(lines)]
self.colors = ["white", "red", "green", "blue"]

def add_points(self, *values):
for i, v in enumerate(values):
self.data[i].append(v)
if len(self.data[i]) > self.max_points:
self.data[i].pop(0)
self.draw()

def draw(self):
self.delete("all")
w = self.winfo_width()
h = self.winfo_height()

if w < 10 or h < 10:
return

# Flatten all visible data
all_values = [v for line in self.data for v in line]

if not all_values:
return

min_val = min(all_values)
max_val = max(all_values)

# Prevent divide-by-zero
if max_val == min_val:
max_val += 1

padding = (max_val - min_val) * 0.1 # 10% padding
min_val -= padding
max_val += padding

for i, line in enumerate(self.data):
if len(line) < 2:
continue

points = []
for j, val in enumerate(line):
x = j / (self.max_points - 1) * w

# Normalize to 0–1
norm = (val - min_val) / (max_val - min_val)

# Flip Y (Tkinter origin is top-left)
y = h - (norm * h)

points.extend([x, y])

self.create_line(points, fill=self.colors[i], width=2)

class App:
def __init__(self, root):
self.root = root
self.root.title("I2C RGB Viewer")
self.adp = DataAdapter()
self.addr = 0x29
self.sat = 1.8
self.gamma = 1.3

# --- Define Gamma Table ---
self.gamma_table = [0] * 256
for i in range(256):
self.gamma_table[i] = int(math.pow(i/255.0,self.gamma)*255)

# --- UI ---
self.graph = MultiLineGraph(root, height=300)
self.graph.pack(fill="both", expand=True)

self.rgb_entry = tk.Entry(root, font=("Consolas", 14))
self.rgb_entry.pack(fill="x")

self.color_panel = tk.Frame(root, height=50, bg="black")
self.color_panel.pack(fill="x")

self.adp.openWaitForAttachment(5000)

# Set properties
self.adp.setFrequency(DataAdapterFrequency.FREQUENCY_400kHz)
self.adp.setDataAdapterVoltage(DataAdapterVoltage.DATAADAPTER_VOLTAGE_3_3V)

# Power On
self.adp.i2cSendReceive(self.addr, [0x8001], 0)
time.sleep(0.01)

# RGBC On
self.adp.i2cSendReceive(self.addr, [0x8003], 0)

# Auto-increment starting with CDATAL
self.adp.i2cSendReceive(self.addr, [0xB4], 0)

# --- Timer ---
self.update_loop()

def read_sensor(self):

data = self.adp.i2cSendReceive(self.addr, [], 8)

# Combine high and low bytes for clear register
raw_c = data[1] << 8 | data[0]

if(raw_c <= 0):
return [0,0,0,0]

# Combine high and low bytes for each colour
raw_r = data[3] << 8 | data[2]
raw_g = data[5] << 8 | data[4]
raw_b = data[7] << 8 | data[6]

return raw_c, raw_r, raw_g, raw_b

def update_loop(self):
raw_c, raw_r, raw_g, raw_b = self.read_sensor()

if raw_c > 0:
# Normalize + gamma
norm_r = self.gamma_table[int(raw_r / raw_c * 255)]
norm_g = self.gamma_table[int(raw_g / raw_c * 255)]
norm_b = self.gamma_table[int(raw_b / raw_c * 255)]

avg = (norm_r + norm_g + norm_b) / 3

# Saturation adjust
norm_r = max(0, min(255, avg + (norm_r - avg) * self.sat))
norm_g = max(0, min(255, avg + (norm_g - avg) * self.sat))
norm_b = max(0, min(255, avg + (norm_b - avg) * self.sat))

hex_color = "#{:02X}{:02X}{:02X}".format(
int(norm_r), int(norm_g), int(norm_b)
)

self.rgb_entry.delete(0, tk.END)
self.rgb_entry.insert(0, hex_color)

self.color_panel.config(bg=hex_color)

# Update graph
self.graph.add_points(raw_c, raw_r, raw_g, raw_b)

# Repeat every 50 ms
self.root.after(50, self.update_loop)

if __name__ == "__main__":
root = tk.Tk()
app = App(root)
root.geometry("600x400")
root.mainloop()
</syntaxhighlight>
}}
{{UGC-End}}

File:Adp0001 rgbcolor primary.png

2026-04-15T15:46:22Z

Lmpacent:

LEDArray API Guide

2026-04-15T15:34:14Z

Lmpacent:

[[Category:IntroGuide]]
{{#seo:|keywords=Addressable LED}}
{{#seo:|description=Get started with your Addressable LED Phidget}}
<div class="nonumtoc">
<div class="toclimit-4">
=Introduction=
This guide will provide information about the LEDArray API to get you up and running with your new Addressable LED Phidget.

=LEDArray API Overview=
==Phidget Control Panel==
After wiring your Addressable LED Phidget using the Quick Start Guide on the product page, we recommend opening the [https://www.phidgets.com/docs/Phidget_Control_Panel Phidget Control Panel] on a Windows computer to experiment with key features.

[[Image:LED0100_ControlPanel.png|center|link=]]

When the Addressable LED Phidget is plugged in via USB or VINT, it will appear up on the Phidget Control Panel device list as shown above. Double-click on the entry to view the program.

[[Image:LED0100_ControlPanelExample2.jpg|center|link=https://cdn.phidgets.com/docs/images/3/3e/LED0100_ControlPanelExample2.jpg]]

After opening the program, you will see the screen shown above. The program is split into multiple sections to help you get familiar with your controller.
#Phidget Info
#Configuration
#Basic/Advanced Tabs
In this guide, we will focus on the areas that contain important information about controlling your LEDs. For information about the Phidget Info section, and the Phidget Control Panel in general, visit our [https://www.phidgets.com/docs/Phidget_Control_Panel Phidget Control Panel] Page.

==Configuration==
===Color Order===
[[Image:Ledarray_colororder_addressableLED.png|thumb|400px|link=https://cdn.phidgets.com/docs/images/1/19/Ledarray_colororder_addressableLED.png|<center>Illustration of a RGBW Addressable LED<center>]]

Addressable LEDs consist of red, green, blue, and sometimes white LEDs, as shown in the illustration on the right.

To control these LEDs, the LED chip must receive data from the Addressable LED Phidget in a specific order. The most common sequences are:
* RGB
* GRB
* RGBW
* GRBW

Refer to the product page or datasheet of your addressable LEDs to determine which sequence is used, and configure your controller accordingly using this property.

===Gamma===
The brightness of an LED increases linearly with current, however, the human eye perceives this brightness in a non-linear fashion. The Addressable LED Phidget includes built-in gamma correction to compensate for this.

The default value of this property is 2.2, which matches most computer displays.

===Brightness===
Apply a brightness value to all LEDs.

====Other Considerations====
Increasing the brightness of your LEDs will increase their current draw. Ensure you are using an appropriately sized power supply.

===PowerEnabled===
Control the power to your LEDs with this property.

====Other Considerations====
If an [[#Over Current|Over Current]] error event occurs, you must toggle Power Enabled to resume operation.

===Clear===
This will turn off all LEDs. It will also stop any [[#Animations|animations]].

==Basic Tab==
The basic tab uses the {{Code|setLEDs}} method to apply a single color to the LEDs specified by the start and end addresses.

===Other Considerations===
The {{Code|MinAddress}} is 0, and the {{Code|MaxAddress}} is 2047 for this controller. This means you can control up to 2048 LEDs, which is specified by the {{Code|MaxLEDCount}} property.

If you are using addressable LEDs with a white component (e.g., RGBW), the {{Code|MaxAddress}} is reduced to 1535 and the {{Code|MaxLEDCount}} is reduced to 1536.

==Advanced Tab==
The advanced tab also uses the {{Code|setLEDs}} method, however, it exposes extra parameters to experiment with.

===LED Pattern===
The LED Pattern selector can be used to define a color pattern that can be sent to the controller.

[[Image:Ledarray_ledarraycolor_selector.jpg|center|link=https://cdn.phidgets.com/docs/images/9/92/Ledarray_ledarraycolor_selector.jpg]]

This is equivalent to the following {{Code|LEDArrayColor}} array:

<syntaxhighlight lang='CSharp'>
//C#
LEDArrayColor[] exampleArray = new LEDArrayColor[2];
exampleArray[0].B = 255;
exampleArray[1].G = 255;
</syntaxhighlight>

This pattern will repeat if it is shorter than the total number of LEDs being controlled, as defined by the start and end addresses. For example, if the start address is set to 0 and the end address to 7, we would see the following result:

[[Image:ledarray_ledpattern_bluegreen4.png|center|800px|link=https://cdn.phidgets.com/docs/images/7/77/Ledarray_ledpattern_bluegreen4.png]]

Conversely, if the pattern is longer than the total number of LEDs being controlled, it will be truncated.

===Fade Time===
If a fade time is defined, the controller will smoothly fade the LED from its previous state to its new state.

===Other Considerations===
The {{Code|MinAddress}} is 0, and the {{Code|MaxAddress}} is 2047 for this controller. This means you can control up to 2048 LEDs, which is specified by the {{Code|MaxLEDCount}} property.

If you are using addressable LEDs with a white component (e.g., RGBW), the {{Code|MaxAddress}} is reduced to 1535 and the {{Code|MaxLEDCount}} is reduced to 1536.

==Animations==
<center>{{#ev:youtube|dJqAxyxWizY|rel=0}}</center>

The Addressable LED Phidget can perform various animations on board.

===Animation Type===
There are five animation types:
* ForwardScroll
* ReverseScroll
* ForwardScrollMirror
* ReverseScrollMirror
* Randomize

===Animation Slot===
Up to 16 animations can run concurrently. The animation slot (animation ID) is used when setting and stopping an animation.

===Start/End Address===
Define the range of your animation. Animations cannot overlap.

===Time===
Define the time between changes in milliseconds.

===Other Considerations===
Animations can be especially useful when paired with [{{SERVER}}/docs/Channel_Persistence_Guide Channel Persistence], as they are executed directly by the controller and can continue running even after the software application is no longer active.

==Errors==
===Over Current===
Addressable LEDs can demand significant power, especially when many LEDs are used at high brightness. The Addressable LED Phidget intelligently monitors current draw and will shut off power when the following limits are exceeded:

{| class="wikitable" style="margin:auto;width:75%;text-align:center"
! style="text-align: center;" | Power Source
! style="text-align: center;" | Current Limit (mA)
|-
| USB || 800
|-
| External (Power Jack) || 3200
|-
| External (Direct to LEDs) || N/A*
|}

<nowiki>*</nowiki>The Addressable LED Phidget can only monitor current draw when the LEDs are powered via USB or the onboard power jack. If the LEDs are powered directly, they are not protected by the onboard fuse or current monitoring circuitry. In these situations, the user is responsible for implementing adequate overcurrent protection to prevent damage or injury.

====Other Considerations====
If an '''OverCurrent''' error occurs, you will need to toggle [[#Power Enabled|Power Enabled]] to resume operation.

Controlling an I2C Display

2026-04-15T15:32:32Z

Lmpacent:

[[Category: Project]]
{{#seo:|keywords=I2C Adapter}}
{{#seo:|description=Control an 14-segment LCD display with the I2C Adapter Phidget}}
<div style="display:none;">
[[Image:I2C_Sensor_Phid.png|thumb|link=|alt=]]
</div>
==Introduction==
[[Image:ADP0001_0_169.jpg|link=https://cdn.phidgets.com/docs/images/f/f5/ADP0001_0_169.jpg|thumb| 450px|<center>[https://www.phidgets.com/?prodid=1354 I2C Adapter Phidget (ADP0001_0)]]]
The [https://www.phidgets.com/?prodid=1354 I2C Adapter Phidget] allows you to interface with a wide range of I2C-compatible devices, including sensors, displays, and more.

In this project, we will use it to control a 14-segment alphanumeric display.

===Steps===
To complete this project, we will work through the following steps:
# Determine the device's basic configuration parameters
# Identify the sequence of commands expected by the device
# Connect the device to the I2C Adapter Phidget
# Test the device using the Phidget Control Panel
# Create a custom program.

===Resources===
Information from the following resources will be referenced throughout this project.
* [https://www.sparkfun.com/sparkfun-qwiic-alphanumeric-display-red.html Device Product Page]
* [https://cdn.phidgets.com/docs/images/7/7b/VK16K33.pdf VK16K33 LED Driver IC Datasheet]

==Demonstration==
<center>{{#ev:youtube|x2YtRTRMybw|rel=0}}</center>

==Configuration Parameters==
[[Image:Adp0002_an_productpage2.png|link=https://cdn.phidgets.com/docs/images/2/26/Adp0002_an_productpage2.png|thumb|<center>Product page features</center>]]
[[Image:I2C_Sensor_Freq.png|thumb|link=https://cdn.phidgets.com/docs/images/5/59/I2C_Sensor_Freq.png|<center>VK16K33 datasheet (Page 29)</center>]]
During this step, we are looking for the following information:
* Supply Voltage
* Communication Frequency
* Device Address

This information is typically found using the device's product page and/or any relevant datasheets. Based on these resources, we will use the following parameters:
* Supply Voltage: 3.3V*
* Communication Frequency: 400kHz
* I2C Address: 0x70

<nowiki>*</nowiki>''The datasheet specifies an operating voltage of 4.5-5V, however, this applies only when the chip is powered directly. The breakout board includes an onboard 3.3V to 5V boost circuit, which provides the required operating voltage for the chip.''

==Command Sequence==
Next, we need to determine the sequence of commands the device is expecting. The VK16K33 datasheet provides flowcharts that we can use to create a list of actions:

[[Image:Adp0002_an_flow.png|link=https://cdn.phidgets.com/docs/images/a/a8/Adp0002_an_flow.png|750px|center]]
<center>''Adapted from datasheet (page 26)''</center>

<br>Based on the flowcharts, our list of actions should look like this:

'''Power On Steps''':
# Enable the internal system clock
# Set the dimming register
# Set the blinking register
<nowiki>*</nowiki> ''The ROW/INT step is ignored because the feature is not being used.''

'''Display Steps'''
# Set the write address
# Send the data to display
# Turn on the display

===Writing to VK16K33 Registers===
I2C devices typically expect the following format:

[[Image:Adp0002_an_typicalcomms3.png|link=https://cdn.phidgets.com/docs/images/2/29/Adp0002_an_typicalcomms3.png|600px]]

The VK16K33 instead expects the following format, where the register address and data is combined into a single byte:

[[Image:Adp0002_an_VK16K33comms4.png|link=https://cdn.phidgets.com/docs/images/c/c5/Adp0002_an_VK16K33comms4.png|400px]]

===Power On Steps===
====Enable the System Clock====
The system clock (oscillator) is managed by register '''0x20''':

[[Image:I2C_Sensor_SysClock.png|link=https://cdn.phidgets.com/docs/images/d/d7/I2C_Sensor_SysClock.png|center|850px]]
<center>''VK16K33 datasheet (page 7)''</center>

This register only has one relevant bit, the '''S''' bit in position '''D8'''. By sending the command '''0010 0001''' (0x21 in hexadecimal), the system clock will be enabled. Bits marked with an '''X''' are irrelevant and can be set to either 0 or 1 with no impact.

====Set Dimming Register====
Dimming is managed by register '''0xEF''':
[[Image:Adp0002_an_dimmingreg.png|link=https://cdn.phidgets.com/docs/images/3/30/Adp0002_an_dimmingreg.png|center|850px]]
<center>''VK16K33 datasheet (page 25)''</center>

The register has four relevant bits, '''P0 through P3''', in positions '''D8 through D11'''. These bits are used to set the duty cycle of the display, which allows for fine control of brightness. By sending the command '''1110 1111''' (0xEF in hexadecimal), maximum brightness is selected.

====Set Blinking Register====
The blinking frequency and display state is managed by register '''0x80''':

[[Image:I2C_Sensor_Blink.png|link=|center|850px]]
<center>''Datasheet page 9''</center>

There are three relevant bits in this register: '''D''', '''B0''', and '''B1''' in positions '''D8 through D10'''. By sending the command '''1000 0001''' (0x81 in hexadecimal), the display will be turned on, and blinking will be set to off.

===Display Steps===
====Set the Write Address====
The display RAM is 16 bytes and begins at address '''0x00''':
[[Image:Adp0002_an_ram.png|link=https://cdn.phidgets.com/docs/images/b/bd/Adp0002_an_ram.png|center|750px]]
<center>''Datasheet page 10''</center>

====Send Data to Display====
The VK16K33 datasheet explains how the sent data translates into certain segments being activated. This is outside the scope of this project, so for the sake of simplicity, we will skip the conversion. A full code sample is provided later in this project and can be reviewed for more information.

====Turn On Display====
The display was previously turned on during the Power On Steps, so this step can be ignored.

== Connecting to the ADP0001 ==

We don't have a cable handy for the connectors on this display, so we soldered wires directly to the exposed I2C pads. The product page for the display board provides the following pinout:

[[Image:I2C_display_pads2.png|link=|75px|left]]

*'''C''' - SCL
*'''D''' - SDA
*'''3''' - 3.3V
*'''G''' - GND

We can simply wire each of these to their corresponding terminal on the I2C Adapter Phidget. Note that your device's SCL may be labeled "SCK", and the SDA pin may be "DIN" depending on which naming convention is used.

[[Image:I2C_display_pinout.png|800px|link=]]

==Testing in the Phidget Control Panel==
Now that we have the configuration parameters and the command sequence, we can use the Phidget Control Panel to confirm our device is working as expected.

===Power On Steps===
We can set the voltage to 3.3V, the frequency to 400kHz, and the address to 0x70. We can then queue up the commands we determined in the previous step.

[[Image:I2C_Sensor_ControlPanel2.png|link=https://cdn.phidgets.com/docs/images/c/c9/I2C_Sensor_ControlPanel2.png|center]]

Since we have not sent any data to the RAM yet, the segments are uninitialized, with some on and some off:

[[Image:I2C_Sensor_UnInit.png|800px|link=https://cdn.phidgets.com/docs/images/8/8c/I2C_Sensor_UnInit.png]]

===Display Steps===
To make the screen display '''PHID''', we will first clear the screen with the following command:
*'''0x0000000000000000000000000000'''.

We can then send the following data:
*'''0x003D000B00CA000C000300C30003'''

[[Image:I2C_Multisend.png|850px|link=]]

We can now see the expected result:

[[Image:I2C_Sensor_Phid.png|800px|link=https://cdn.phidgets.com/docs/images/c/cd/I2C_Sensor_Phid.png]]

===Reading Display RAM===
This display also supports reading the RAM, so you can programmatically know what's currently showing on the display. For most devices, this is as simple as providing the proper command and specifying a number of expected reply bytes. In this case, the device is expecting a stop condition in between the command and the data, as shown by the 'P' in the third block in this diagram:

[[Image:I2C_Sensor_Read.png|850px|link=https://cdn.phidgets.com/docs/images/b/b4/I2C_Sensor_Read.png|center]]
<center>''From page 23 of the datasheet''</center>

In order to replicate this in the control panel, we must send '''0x00''' first, and then send again with no data to listen for our reply bytes.

[[Image:I2C_Panel_Read.png|850px|link=]]

==Writing a Custom Program==
To begin writing a custom program for your Phidget device, navigate to the product page and select the [https://www.phidgets.com/?prodid=1354#Tab_Code_Samples Code Samples tab]. From there, you can customize the code for your own purposes. Here we have modified the Python code sample to match our steps from the Phidget Control Panel.

<syntaxhighlight lang=python>
from Phidget22.Phidget import *
from Phidget22.Devices.DataAdapter import *

def main():

clear = [0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00]
phid = [0x00,0x3D,0x00,0x0B,0x00,0xCA,0x00,0x0C,0x00,0x03,0x00,0xC3,0x00,0x03]

adp = DataAdapter()
adp.openWaitForAttachment(5000)

# Set properties
adp.setFrequency(DataAdapterFrequency.FREQUENCY_400kHz)
adp.setDataAdapterVoltage(DataAdapterVoltage.DATAADAPTER_VOLTAGE_3_3V)
addr = 0x70

# Clear Screen
adp.i2cSendReceive(addr, clear, 0)

# Initialize display
adp.i2cSendReceive(addr, [0x21], 0)
adp.i2cSendReceive(addr, [0xEF], 0)
adp.i2cSendReceive(addr, [0x81], 0)

# Print PHID
adp.i2cSendReceive(addr, phid, 0)

try:
input("Press Enter to Stop\n")
except (Exception, KeyboardInterrupt):
pass

adp.close()

main()
</syntaxhighlight>

That’s about it, we went from reading the datasheet to a working script. Not all datasheets are created equal, so if you’re struggling with getting your sensor set up, feel free to ask for help by [https://www.phidgets.com/?view=contact sending us an email].

===Full Script===
Here is the full Python script that was used in the demonstration video. It will take input from the console and print scrolling messages on the display.

{{UGC-Start}}
{{UGC-Entry|Full Script (Click to expand)||
<syntaxhighlight lang=python>
from Phidget22.Phidget import *
from Phidget22.Devices.DataAdapter import *
import time

ram = ["0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000"]

# _ _ _ b _ _ _
# | \ | / |
# | c e g |
# l \ | / d
# | \ | / |
# | _ n _ _ _ a _ |
# | / | \ |
# j / | \ f
# | m k i |
# | / | \ |
# | _ _ _ h _ _ _ |

letters = {
# abcdefghijklmn abcdefghijklmn abcdefghijklmn
"A": 0b11010100010101, "N": 0b00110100110100, "0": 0b01010111010110,
"B": 0b11011101001001, "O": 0b01010101010100, "1": 0b00010110000000,
"C": 0b01000001010100, "P": 0b11010000010101, "2": 0b11010001010001,
"D": 0b01011101001000, "Q": 0b01010101110100, "3": 0b11010101000001,
"E": 0b11000001010101, "R": 0b11010000110101, "4": 0b10010100000101,
"F": 0b11000000010101, "S": 0b11100101000000, "5": 0b11000101000101,
"G": 0b11000101010100, "T": 0b01001000001000, "6": 0b11000101010101,
"H": 0b10010100010101, "U": 0b00010101010100, "7": 0b01010100000000,
"I": 0b01001001001000, "V": 0b00000010010110, "8": 0b11010101010101,
"J": 0b00010101010000, "W": 0b00010100110110, "9": 0b11010100000101,
"K": 0b00000010110101, "X": 0b00100010100010,
"L": 0b00000001010100, "Y": 0b00100010001000,
"M": 0b00110110010100, "Z": 0b01000011000010
}

# loadRAM Reads all 13 bytes of of the screen memory into an array of 26 strings (for easier debugging)
# It should be loaded before overwriting a character, to preserve the other three.
def loadRAM(phid, addr):
for i in range(13):
byte = format(phid.i2cSendReceive(addr,[i],1)[0],'08b')
ram[(i*2)] = byte[:4]
ram[(i*2)+1] = byte[4:]

# printMessage prints a scrolling marquee messasge 'str'
def printMessage(str, phid, addr):
# Add four spaces to ensure the message scrolls off
str += " "
a0 = a1 = a2 = a3 = ""

for a in str:
a0 = a1
a1 = a2
a2 = a3
a3 = a.upper()
clearScreen(phid,addr)
printLetter(a0, phid, addr, 0)
printLetter(a1, phid, addr, 1)
printLetter(a2, phid, addr, 2)
printLetter(a3, phid, addr, 3)
time.sleep(0.08)

# printLetter prints letter 'a' to position 'pos'
def printLetter(a, phid, addr,pos):

# Confirm parameters are valid
if a not in letters or (pos > 3) or (pos < 0):
return

# Get the segments required for the letter
bits = [(letters[a] >> bit) & 1 for bit in range(13,-1,-1)]

# For each segment, AND or OR it to the existing memory to preseve the other three digits
# It had to be broken into two in order to skip over other bytes in the memory string.
# The memory string is laid out like this: 00ab0:cd0.ef00gh00ij00kl00mn
# Where ':' turns on the center colon and '.' turns on the decimal point when 0001 is written there.
for i in range(7):
if bits[2*i] == 0:
tmp = int(ram[4*i], 2)
tmp &= ~(1 << pos)
ram[4*i] = f"{tmp:04b}"
else:
tmp = int(ram[4*i], 2)
tmp |= (1 << pos)
ram[4*i] = f"{tmp:04b}"

if bits[(2*i)+1] == 0:
tmp = int(ram[(4*i)+1], 2)
tmp &= ~(1 << pos)
ram[(4*i)+1] = f"{tmp:04b}"
else:
tmp = int(ram[(4*i)+1], 2)
tmp |= (1 << pos)
ram[(4*i)+1] = f"{tmp:04b}"

hex = bytes(
(int(ram[i], 2) << 4) | int(ram[i+1], 2)
for i in range(0, 26, 2)
)
hex = list(hex)
hex.insert(0,0x00) # add the leading 0x00 for writing
phid.i2cSendReceive(addr, hex, 0)

# clearScreen clears the screen and the ram array
def clearScreen(phid,addr):
phid.i2cSendReceive(addr, [0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00], 0)
loadRAM(phid,addr)

# initialize sets the clock, brightness and blinking so the screen can operate
def initialize(phid,addr):
phid.i2cSendReceive(addr, [0x21], 0)
phid.i2cSendReceive(addr, [0xEF], 0)
phid.i2cSendReceive(addr, [0x81], 0)

def main():

# Declare and open dataAdapter channel
adp = DataAdapter()
adp.openWaitForAttachment(5000)

# Set properties
adp.setFrequency(DataAdapterFrequency.FREQUENCY_400kHz)
adp.setDataAdapterVoltage(DataAdapterVoltage.DATAADAPTER_VOLTAGE_3_3V)
addr = 0x70

# Clear Screen
clearScreen(adp,addr)

# Initialize display
initialize(adp,addr)

print("Type a message to display, or 'exit' to quit.")

message = ""

while message != "exit":
try:
message = input()
printMessage(message,adp,addr)
except (Exception, KeyboardInterrupt):
pass

adp.close()

main()

</syntaxhighlight>
}}
{{UGC-End}}

Controlling an SPI Encoder

2026-04-15T15:15:41Z

Lmpacent:

[[Category: Project]]
{{#seo:|keywords=SPI Adapter}}
{{#seo:|description=Control an SPI encoder with the SPI Adapter Phidget}}

[[Image:ADP0002_0.jpg|link=|thumb| 400px|<center>[https://www.phidgets.com/?prodid=1355 SPI Adapter Phidget (ADP0002_0)]]]
==Introduction==
The [https://www.phidgets.com/?prodid=1355 SPI Adapter Phidget] allows you to interface with a wide range of SPI-compatible devices, including sensors, displays, and more.

In this project, we will use it to control an absolute position magnetic encoder.

===Steps===
To complete this project, we will work through the following steps:
# Determine the device's basic configuration parameters
# Identify the sequence of commands expected by the device
# Connect the device to the SPI Adapter Phidget
# Test the device using the Phidget Control Panel
# Create a custom program.

===Resources===
Information from the following datasheet will be referenced throughout this project:
* [https://ams-osram.com/products/boards-kits-accessories/boards/ams-as5048a-ts-evm-ab-evaluation-board Device Product Page]
* [https://cdn.phidgets.com/docs/images/f/fd/AS5048A.pdf AS5048A Encoder Datasheet]

==Demonstration==
<center>{{#ev:youtube|-TkTykk1Ris|rel=0}}</center>

===Additional Information===
[[Image:Adp0002_magnet.png|link=https://cdn.phidgets.com/docs/images/2/2e/Adp0002_magnet.png|thumb]]
The encoder is designed to be used with a small magnet, magnetized with the poles on the edges of the cylinder instead of the top and bottom. The magnet can be attached to the exposed rear shaft of a motor, and this sensor can use the position of the magnetic field to determine the absolute position of the shaft.

==Configuration Parameters==
During this step, we are looking for the following information:
* Supply Voltage
* Communication Frequency
* Endianness (MSB-first or LSB-first)
* Chip Select Polarity
* SPI Wire Mode

This information is typically found using the device's product page and/or any relevant datasheets.
Based on the AS5048A datasheet, we will use the following parameters:
* Supply Voltage: 3.3V or 5V (we'll use 5V)
* Communication Frequency: The clock period is 100ns minimum (10MHz maximum)
* Endianness: MSB-first
* Chip Select: Active Low
* SPI Wire Mode: Mode = 1

==Command Sequence==
Next, we need to determine the sequence of commands the device is expecting. Some devices have certain commands that must be sent to configure the device, but this one is ready to provide sensor data as soon as it's powered up.

[[Image:SPI_commandflow.png|link=|center|800px]]
<center>''AS5048A datasheet (page 11)''</center>

This diagram explains that each command we send will have its response delivered during the next transaction. Since our first goal is to get a stream of angle data from the encoder, we can just continuously send the Read Angle command.

===Reading from AS5048A Registers===

Commands sent to the encoder must follow the following format:
[[Image:SPI_command_package.png|link=|center|800px]]
<center>''AS5048A datasheet (page 14)''</center>
This table tells us that the 16-bit command package consists of a parity bit, a read/write bit, and then a 14-bit register address.

There are three data readout registers we can access. Here is the definition for the angle register:

[[Image:SPI_command_angle_readout.png|link=|center|800px]]
<center>''AS5048A datasheet (page 17)''</center>

The register address for the angle data is '''0x3FFF''', but this is not the complete 16-bit value we need to transmit. First, we must add the R/W bit (Read=1) and then calculate the parity bit for even parity.

[[Image:SPI_command_parity.png|link=|center|700px]]
<center>''Calculating the parity bit''</center>

This results in '''0xFFFF''', which is the command we need to send with the SPI Phidget.

== Connecting to the ADP0002 ==

The wiring for this sensor is very straightforward with the ADP0002:
[[Image:SPI_encoder_pinout.png|link=|120px|left]]
* '''5V''' - VCC
* '''3.3V''' - Not connected
* '''PWM''' - Not connected
* '''SDA/CSn''' - CS
* '''SCL/SCK''' - SCLK
* '''A1/MOSI''' - MOSI
* '''A2/MISO''' - MISO
* '''GND''' - GND

[[Image:SPI_wiring_diagram.png|link=|center|800px]]

== Testing in the Phidget Control Panel ==
Now that we have the configuration parameters and the command sequence, we can use the Phidget Control Panel to confirm our device is working as expected.

=== Reading the Angle ===

==== Reading the Angle in the Control Panel ====
Set the voltage to 5V, the chip select to Active Low, the wire mode to Mode_1, and the frequency to any value as they are all within the stated range.

We can try sending our '''0xFFFF''' command we calculated in the previous step:

[[Image:SPI_angle_send.png|link=|center|800px]]

The first response is an empty '''0x0000''', because responses are always sent in the next transaction. After that, we start getting data back from the encoder. In order to decode these values, we must go back to the datasheet and pay attention to the read package format.

==== Decoding the Read Data Package ====
[[Image:SPI_read_package.png|link=|center|800px]]
<center>''AS5048A datasheet (page 15)''</center>

Similar to the command package, it's made up of two control bits and one 14-bit value. The control bits are a parity bit to ensure communication fidelity, and an error flag that activates if there's a problem with the previous transaction. In this example we'll ignore these bits, but in an actual deployment you'd want to be checking both of these bits on each transaction.

So to decode the response for our angle command, '''0x9048''', we need to strip the top two bits:

[[Image:SPI_decode_response.png|link=|center|800px]]

This leaves us with '''0x1048''', or 4168 in decimal. The encoder has 14-bit precision, so the formula is as follows:

::<math>\text{Angle(°)} = \frac{\text{n}}{2^{14}} \times 360 \!</math>

Where 'n' is the response in decimal. Using this equation, our angle works out to '''91.58 degrees'''. When we eventually write our own program, we'll handle all of this bit manipulation and unit conversion in code.

=== Zeroing the Encoder ===

The advantage of an absolute encoder is that the actual angle of the shaft will be known as soon as the system is powered, without need for calibration or homing. This also means that the "home position" of our rotary system will be an arbitrary angle. We could zero this by keeping track of the initial angle in our program, but this chip has its own zeroing feature, so let's take a look.

==== Zeroing Command Registers and Sequence ====

We can find the zeroing process in the datasheet:
# Clear zero position registers by writing '0' into them
# Read the current angle
# Write the angle into the zero position registers
# (optional) Burn the value into the register so it persists across power cycles

For now we'll only do the steps 2 and 3, since the zero position registers will already be zero on startup by default since we haven't burned a value into the register. In our final program we'll be using the zero as a sort of 'tare' function so we will have to do the first step there. Here are the zero register definitions:

[[Image:SPI_zero_registers.png|link=|center|800px]]
<center>''AS5048A datasheet (page 17)''</center>

Just as before, we need to add the proper control bits to these address values before we send them.
* Write to Zero Position Hi: 0x0016 -> '''0x8016'''
* Write to Zero Position Lo: 0x0017 -> '''0x0017'''

For each of these registers, we'll follow this flow:
* Write to the zero position command
* Send the angle data
* Send a NOP (empty command) to confirm data sent

==== Zeroing in the Control Panel ====

In this example, our received data is '''0xBB99'''. Stripping the control bits, we get '''0x3B99''' or '''11 1011 1001 1001''' in binary. According to the zero register definitions, we need the 6 least significant bits in the low register, and the other 8 in the high register. This gives us:

* LSB: '''0b011001''' '''(0x19)''' -> '''0x8019'''
* MSB: '''0b11101110''' '''(0xEE)''' -> '''0x00EE'''

Again, since we need to set the write bits and proper parity, we end up with '''0x8019''' and '''0x00EE'''. Here's what the zeroing process looks like in the control panel (annotations added for clarity):

[[Image:SPI_controlpanel_zero.png|link=|center|850px]]

There are no error bits set in the responses, and each register we set echoed back the correct value when we wrote to it. The angle response we got after zeroing is '''0xBFF7'''.

* Strip control bits -> 0x3FF7
* Convert to decimal -> 16375
* Angle formula -> 359.80°

Since our new angle is close to 360° (the same as 0°), it looks like the zeroing process was successful.

== Writing a Custom Python Script ==

To begin writing a custom program for your Phidget device, navigate to the product page and select the [https://www.phidgets.com/?prodid=1354#Tab_Code_Samples Code Samples tab]. From there, you can customize the code for your own purposes. Here we have modified the code sample to demonstrate a simple readout of the encoder angle:

<syntaxhighlight lang=python>
from Phidget22.Phidget import *
from Phidget22.Devices.DataAdapter import *
import time

def hex2angle(hex):
bytes = (hex[0] << 8) | hex[1] # Combine MSB and LSB
bytes = bytes & 0b0011111111111111 # Discard top two bits (parity and error flag bits)
angle = round(bytes / 16348*360,3) # Divide by 2^14, multiply by 360 to get degrees
return angle

def main():
# Open ADP0002
adp = DataAdapter()
adp.openWaitForAttachment(5000)

# Set properties
adp.setEndianness(DataAdapterEndianness.ENDIANNESS_MSB_FIRST)
adp.setFrequency(DataAdapterFrequency.FREQUENCY_1500kHz)
adp.setDataAdapterVoltage(DataAdapterVoltage.DATAADAPTER_VOLTAGE_5_0V)
adp.setSPIChipSelect(DataAdapterSPIChipSelect.SPI_CHIP_SELECT_ACTIVE_LOW)
adp.setSPIMode(DataAdapterSPIMode.SPI_MODE_1)
time.sleep(0.5)

# Read and print angle until keyboard interrupt
print("Printing encoder data. Press CTRL+C to quit.")
try:
while True:
recvData = adp.sendPacketWaitResponse([0xFF,0xFF])
print(f"\rEncoder Angle: {hex2angle(recvData)} ",end="",flush=True)
time.sleep(0.1)

except KeyboardInterrupt:
pass

adp.close()

main()
</syntaxhighlight>

That’s about it, we went from reading the datasheet to a working script. Not all datasheets are created equal, so if you’re struggling with getting your sensor set up, feel free to ask for help by [https://www.phidgets.com/?view=contact sending us an email].

===Full Script===
Here is the full Python script that was used in the demonstration video. It displays the encoder angle and also provides the option to zero the encoder.

{{UGC-Entry|Full Script (Click to expand)||
<syntaxhighlight lang=python>
from Phidget22.Phidget import *
from Phidget22.Devices.DataAdapter import *
import time
import threading

# Register definitions from datasheet
ANGLE = [0x3F,0xFF]
MAGNITUDE = [0x3F,0xFE]
DIAGNOSTIC = [0x3F,0xFD]
CLEAR_ERR = [0x00,0x01]
NOP = [0x00,0x00]
ZERO_POS_HI = [0x00,0x16]
ZERO_POS_LO = [0x00,0x17]
READ = 1
WRITE = 0

adp = DataAdapter()

# Listener for keypress during main loop
running = True
def keyboard_listener():
global running
while running:
cmd = input().strip().lower()
if cmd == "z":
zero()
elif cmd == "q":
running = False

# Adds the required RW and parity bits
def addBits(packet,rw):
bits = ((packet[0] << 8) | packet[1]) & 0x3FFF

if(rw):
bits = bits | 0b0100000000000000
else:
bits = bits & 0b1011111111111111

if(bits.bit_count()%2 == 0):
bits = bits & 0b0111111111111111
else:
bits = bits | 0b1000000000000000

res = [(bits >> 8)& 0xFF,(bits & 0xFF)]
return res

def zero():
# Clear zero registers - this is needed to be able to zero more than once per run
adp.sendPacket(addBits(ZERO_POS_HI,WRITE))
adp.sendPacket(addBits([0x00,0x00],WRITE))
adp.sendPacket(addBits(NOP,WRITE))
adp.sendPacket(addBits(ZERO_POS_LO,WRITE))
adp.sendPacket(addBits([0x00,0x00],WRITE))
adp.sendPacket(addBits(NOP,WRITE))

# Read current angle
adp.sendPacket(addBits(ANGLE,READ))
resp = adp.sendPacketWaitResponse(addBits(NOP,WRITE))

# Combine angle bytes and mask out err/parity bits
angle = ((resp[0] << 8) | resp[1]) & 0x3FFF

# Split out angle for sending to zero registers
zposm = (angle >> 6) & 0xFF
zposl = angle & 0x3F

# write ZPOSM (0x0016)
resp = adp.sendPacketWaitResponse(addBits(ZERO_POS_HI,WRITE))
resp = adp.sendPacketWaitResponse(addBits([0x00,zposm],WRITE))
resp = adp.sendPacketWaitResponse(addBits(NOP,WRITE))

# write ZPOSL (0x0017)
resp = adp.sendPacketWaitResponse(addBits(ZERO_POS_LO,WRITE))
resp = adp.sendPacketWaitResponse(addBits([0x00,zposl],WRITE))
resp = adp.sendPacketWaitResponse(addBits(NOP,WRITE))

def hex2angle(hex):
bytes = (hex[0] << 8) | hex[1] # Combine MSB and LSB
bytes = bytes & 0b0011111111111111 # Discard top two bits (parity and error flag bits)
angle = round(bytes / 16348*360,3) # Divide by 2^14, multiply by 360 to get degrees
return angle

def main():
# Open ADP0002
adp.openWaitForAttachment(5000)

# Set properties
adp.setEndianness(DataAdapterEndianness.ENDIANNESS_MSB_FIRST)
adp.setFrequency(DataAdapterFrequency.FREQUENCY_1500kHz)
adp.setDataAdapterVoltage(DataAdapterVoltage.DATAADAPTER_VOLTAGE_5_0V)
adp.setSPIChipSelect(DataAdapterSPIChipSelect.SPI_CHIP_SELECT_ACTIVE_LOW)
adp.setSPIMode(DataAdapterSPIMode.SPI_MODE_1)
time.sleep(0.5)

# Start thread for keypress detection during the loop
threading.Thread(target=keyboard_listener, daemon=True).start()
print("Printing encoder data. Press 'z' to zero and 'q' to quit.")

# Read and print angle until 'q' pressed
try:
while running:
recvData = adp.sendPacketWaitResponse(addBits(ANGLE,READ))
print(f"\rEncoder Angle: {hex2angle(recvData)} ",end="",flush=True)
time.sleep(0.1)

except KeyboardInterrupt:
pass

adp.close()

main()
</syntaxhighlight>
}}
{{UGC-End}}

Reading an I2C Color Sensor

2026-04-15T15:15:07Z

Lmpacent:

[[Category: Project]]
{{#seo:|keywords=I2C Adapter}}
{{#seo:|description=Read an I2C color sensor with the I2C Adapter Phidget}}

==Introduction==
[[Image:ADP0001_0_169.jpg|link=https://cdn.phidgets.com/docs/images/f/f5/ADP0001_0_169.jpg|thumb| 450px|<center>[https://www.phidgets.com/?prodid=1354 I2C Adapter Phidget (ADP0001_0)]]]
The [https://www.phidgets.com/?prodid=1354 I2C Adapter Phidget] allows you to interface with a wide range of I2C-compatible devices, including sensors, displays, and more.

In this project, we will use it to read data from an RGB Color Sensor.

===Steps===
To complete this project, we will work through the following steps:
# Determine the device's basic configuration parameters
# Identify the sequence of commands expected by the device
# Connect the device to the I2C Adapter Phidget
# Test the device using the Phidget Control Panel
# Create a custom program.

===Resources===
Information from the following resource will be referenced throughout this project.
* [https://cdn.phidgets.com/docs/images/1/13/TCS34725.pdf TCS34725 RGB Color Sensor IC Datasheet]

==Demonstration==
<center>{{#ev:youtube|dYREkxXgjEA|rel=0}}</center>

==Configuration Parameters==
[[Image:Adp0002_rgb_specs2.png|link=https://cdn.phidgets.com/docs/images/0/05/Adp0002_rgb_specs2.png|thumb|<center>Excerpts from Datasheet</center>]]

During this step, we are looking for the following information:
* Supply Voltage
* Communication Frequency
* Device Address

This information is typically found using the device's product page and/or datasheet. In this case, it was all found on pages 3 to 5 of the datasheet:
* Supply Voltage: 3.3V
* Communication Frequency: 400kHz
* I2C Address: 0x29
<div style="clear:both">

==Command Sequence==
Next, we need to determine the sequence of commands the device is expecting. The TCS34725 datasheet provides a state diagram that we can use to create a list of actions:

[[Image:Adp0002_rgb_states.png|link=https://cdn.phidgets.com/docs/images/0/0e/Adp0002_rgb_states.png|200px|right|thumb|<center>From datasheet (page 7)</center>]]

<br>Based on the state diagram, our list of actions should look like this:

'''Power On Steps''':
# Enable PON (power on) to go from sleep to idle state
# Enable AEN (RGB enabled) to go from idle to RGBC state

After these steps, the device should be able to provide data and respond to commands. We're not using WEN (wait enabled) since we don't need this power-saving feature at this time.

===Writing to TCS34725 Registers===
I2C devices typically expect the following format:

[[Image:Adp0002_an_typicalcomms3.png|link=https://cdn.phidgets.com/docs/images/2/29/Adp0002_an_typicalcomms3.png|600px]]

This protocol diagram from page 12 of the datasheet confirms that the TCS34725 behaves as expected:

[[Image:Adp0002_rgb_protocol.png|link=https://cdn.phidgets.com/docs/images/3/38/Adp0002_rgb_protocol.png|700px]]

The Start (S), Stop (P), Acknowledge (A), and W/R (Write/Read) is all handled internally by the I2C Phidget, so we just need to focus on the command code and data.

==== Command Register ====

The command register lets us tell the sensor which register we want to read or write on our next communication.

[[Image:Adp0002_rgb_cmdreg.png|link=https://cdn.phidgets.com/docs/images/0/0d/Adp0002_rgb_cmdreg.png|750px|center]]

* The first bit is always '1'
* The next two bits control the how the device behaves when requesting multiple bytes
* The last five bits hold the register address (we can ignore the special functions for this project)

Here's an abridged list of registers we'll be using:

[[Image:Adp0002_rgb_registers.png|link=https://cdn.phidgets.com/docs/images/4/48/Adp0002_rgb_registers.png|600px|center]]

===Power On Steps===
====Enable the Sensor====
Enable is managed by register '''0x00''', so our command register will look like this:

[[Image:Adp0002_rgb_cmdenable.png|link=https://cdn.phidgets.com/docs/images/0/03/Adp0002_rgb_cmdenable.png|center|850px]]

So we'll send '''0x80''' to select the enable register.

The enable register is defined in the datasheet as follows:

[[Image:Adp0002_rgb_enablereg.png|link=https://cdn.phidgets.com/docs/images/8/89/Adp0002_rgb_enablereg.png|center|850px]]

* Bits 5, 6, and 7 are '''000''', as they're reserved
* Bit 4 will be '''0''', since we're not using interrupts
* Bit 3 will be '''0''', since we're not using the wait feature
* Bit 2 is '''0''', as it's reserved
* Bit 1 will be '''0''', since we're not enabling RGBC yet
* Bit 0 will be '''1''', to enable power

That gives us '''0x01'''. Together with our command register, our first communication will be '''0x8001'''.
The reason we don't enable RGBC yet is because the device requires a 2.4ms delay between PON and RGBC for reliable startup.

====Enable RGBC====

To enable RGBC we will use the same command we used for power on, but both the AEN bit and the PON bit will be 1. This gives us '''0x8003'''.

=== Reading Data ===

Now that the sensor is initialized, we can start getting data from it. We want to read all eight color registers, so we need to set auto-increment in the command register and point it to the first color register which is at 0x14:

[[Image:Adp0002_rgb_cmdreadauto.png|link=https://cdn.phidgets.com/docs/images/8/87/Adp0002_rgb_cmdreadauto.png|center|850px]]

This means we need to send '''B4'''. After that, we can listen for 8 bytes at a time to get all of our color data.

== Connecting to the ADP0001 ==

The pinout for this sensor is printed on the PCB:

[[Image:I2C_rgb_pinout2.png|link=|130px|left]]

*'''VIN''' - Power
*'''GND''' - Ground
*'''3V3''' - 3.3V Output
*'''SCL''' - Serial Clock
*'''SDA''' - Serial Data
*'''INT''' - Interrupt
*'''LED''' - LED toggle

We don't need the 3.3V output or the interrupt pin for this project. The other pins can be connected to the ADP0001 as follows:

[[Image:I2C_rgb_connection.png|800px|link=https://cdn.phidgets.com/docs/images/d/d9/I2C_rgb_connection.png]]

The LED toggle pin is connected to one of the ADP0001's GPIO pins so we can use it to turn off the LED when not in use.

==Testing in the Phidget Control Panel==
Now that we have the command sequence and our sensor connected, we can use the Phidget Control Panel to confirm our device is working as expected.

===Power On Steps===
We can set the voltage to 3.3V, the frequency to 400kHz, and the address to 0x29.

[[Image:I2C_RGB_ControlPanel.png|link=https://cdn.phidgets.com/docs/images/2/20/I2C_RGB_ControlPanel.png|center]]

Now we can enable the sensor with our command sequence:
* 0x8001 (Power on)
* 0x8003 (RGBC on)
* 0xB4 (auto increment and start from register 0x14)

[[Image:I2C_RGB_ControlPanel2.png|link=https://cdn.phidgets.com/docs/images/4/4f/I2C_RGB_ControlPanel2.png|center]]

===Reading Data===
After sending the command register B4, we can read all color registers by reading 8 bytes at a time.

[[Image:I2C_RGB_ControlPanel3.png|link=https://cdn.phidgets.com/docs/images/0/0a/I2C_RGB_ControlPanel3.png|center]]
[[Image:I2C_RGB_responsegraph.png|link=https://wwwdev.int.phidgets.com/docs/images/9/97/I2C_RGB_responsegraph.png|thumb|<center>Sensor response characteristic (pg.6)<center>]]

This sensor ultimately provides us with four 16-bit values: Clear, Red, Green, and Blue. The clear light value is important for providing brightness calibration. Since the responses of the red, green and blue sensors are normalized to match the response of the clear sensor, we can use it as a baseline to determine color in both bright and dim environments.

In the above image, we get roughly the same value when polling the sensor three times, so the value seems stable. We'll use the bottom row to see if the color makes sense. The data bytes received are sent in register order, so our values are:

* Clear: 0x0FFD
* Red: 0x0A96
* Green: 0x0331
* Blue: 0x0271

Converting to decimal, that's 4093, 2710, 817, 625. We can normalize the last three values using the clear value, and then multiply by 255 and round to get a standard RGB value:

* Red: (2710/4093)*255 = 169
* Green: (817/4093)*255 = 51
* Blue: (625/4093)*255 = 39

This RGB value '''<span style="color:#A93327">(#A93327)</span>''' looks to be correct, as the sensor was pointed at a roll of red electrical tape.

==Writing a Custom Program==
To begin writing a custom program for your Phidget device, navigate to the product page and select the [https://www.phidgets.com/?prodid=1354#Tab_Code_Samples Code Samples tab]. From there, you can customize the code for your own purposes. Here we have modified the Python code sample to match our steps from the Phidget Control Panel.

<syntaxhighlight lang=python>
from Phidget22.Phidget import *
from Phidget22.Devices.DataAdapter import *
import time

def convert_rgbc(data):

c = data[1] << 8 | data[0]

if(c <= 0):
return [0,0,0]

# Combine high and low bytes for each color,
# Then normalize and cap at 255
r = min(255,round((data[3] << 8 | data[2]) / c * 255))
g = min(255,round((data[5] << 8 | data[4]) / c * 255))
b = min(255,round((data[7] << 8 | data[6]) / c * 255))
return [r,g,b]

def main():

adp = DataAdapter()
adp.openWaitForAttachment(5000)

# Set properties
adp.setFrequency(DataAdapterFrequency.FREQUENCY_400kHz)
adp.setDataAdapterVoltage(DataAdapterVoltage.DATAADAPTER_VOLTAGE_3_3V)
addr = 0x29

# Power On
adp.i2cSendReceive(addr, [0x8001], 0)
time.sleep(0.01)

# RGBC On
adp.i2cSendReceive(addr, [0x8003], 0)

# Auto-increment starting with CDATAL
adp.i2cSendReceive(addr, [0xB4], 0)

try:
while True:
rgb = convert_rgbc(adp.i2cSendReceive(addr, [], 8))
print("R: " + str(rgb[0]) + " G: " + str(rgb[1]) + " B: " + str(rgb[2]))
time.sleep(0.5)
pass
except KeyboardInterrupt:
print("Closing...")

adp.close()

main()
</syntaxhighlight>

That’s about it, we went from reading the datasheet to a working script. Not all datasheets are created equal, so if you’re struggling with getting your sensor set up, feel free to ask for help by [https://www.phidgets.com/?view=contact sending us an email].

===Python Graphical Example===
Here is a more in-depth script that displays a graph of the raw values and shows the calculated color after gamma and saturation adjustment.

{{UGC-Start}}
{{UGC-Entry|Full Script (Click to expand)||
<syntaxhighlight lang=python>
import tkinter as tk
import math
from Phidget22.Phidget import *
from Phidget22.Devices.DataAdapter import *
import time

class MultiLineGraph(tk.Canvas):
def __init__(self, parent, lines=4, max_points=100, **kwargs):
super().__init__(parent, bg="black", **kwargs)
self.lines = lines
self.max_points = max_points
self.data = [[] for _ in range(lines)]
self.colors = ["white", "red", "green", "blue"]

def add_points(self, *values):
for i, v in enumerate(values):
self.data[i].append(v)
if len(self.data[i]) > self.max_points:
self.data[i].pop(0)
self.draw()

def draw(self):
self.delete("all")
w = self.winfo_width()
h = self.winfo_height()

if w < 10 or h < 10:
return

# Flatten all visible data
all_values = [v for line in self.data for v in line]

if not all_values:
return

min_val = min(all_values)
max_val = max(all_values)

# Prevent divide-by-zero
if max_val == min_val:
max_val += 1

padding = (max_val - min_val) * 0.1 # 10% padding
min_val -= padding
max_val += padding

for i, line in enumerate(self.data):
if len(line) < 2:
continue

points = []
for j, val in enumerate(line):
x = j / (self.max_points - 1) * w

# Normalize to 0–1
norm = (val - min_val) / (max_val - min_val)

# Flip Y (Tkinter origin is top-left)
y = h - (norm * h)

points.extend([x, y])

self.create_line(points, fill=self.colors[i], width=2)

class App:
def __init__(self, root):
self.root = root
self.root.title("I2C RGB Viewer")
self.adp = DataAdapter()
self.addr = 0x29
self.sat = 1.8
self.gamma = 1.3

# --- Define Gamma Table ---
self.gamma_table = [0] * 256
for i in range(256):
self.gamma_table[i] = int(math.pow(i/255.0,self.gamma)*255)

# --- UI ---
self.graph = MultiLineGraph(root, height=300)
self.graph.pack(fill="both", expand=True)

self.rgb_entry = tk.Entry(root, font=("Consolas", 14))
self.rgb_entry.pack(fill="x")

self.color_panel = tk.Frame(root, height=50, bg="black")
self.color_panel.pack(fill="x")

self.adp.openWaitForAttachment(5000)

# Set properties
self.adp.setFrequency(DataAdapterFrequency.FREQUENCY_400kHz)
self.adp.setDataAdapterVoltage(DataAdapterVoltage.DATAADAPTER_VOLTAGE_3_3V)

# Power On
self.adp.i2cSendReceive(self.addr, [0x8001], 0)
time.sleep(0.01)

# RGBC On
self.adp.i2cSendReceive(self.addr, [0x8003], 0)

# Auto-increment starting with CDATAL
self.adp.i2cSendReceive(self.addr, [0xB4], 0)

# --- Timer ---
self.update_loop()

def read_sensor(self):

data = self.adp.i2cSendReceive(self.addr, [], 8)

# Combine high and low bytes for clear register
raw_c = data[1] << 8 | data[0]

if(raw_c <= 0):
return [0,0,0,0]

# Combine high and low bytes for each colour
raw_r = data[3] << 8 | data[2]
raw_g = data[5] << 8 | data[4]
raw_b = data[7] << 8 | data[6]

return raw_c, raw_r, raw_g, raw_b

def update_loop(self):
raw_c, raw_r, raw_g, raw_b = self.read_sensor()

if raw_c > 0:
# Normalize + gamma
norm_r = self.gamma_table[int(raw_r / raw_c * 255)]
norm_g = self.gamma_table[int(raw_g / raw_c * 255)]
norm_b = self.gamma_table[int(raw_b / raw_c * 255)]

avg = (norm_r + norm_g + norm_b) / 3

# Saturation adjust
norm_r = max(0, min(255, avg + (norm_r - avg) * self.sat))
norm_g = max(0, min(255, avg + (norm_g - avg) * self.sat))
norm_b = max(0, min(255, avg + (norm_b - avg) * self.sat))

hex_color = "#{:02X}{:02X}{:02X}".format(
int(norm_r), int(norm_g), int(norm_b)
)

self.rgb_entry.delete(0, tk.END)
self.rgb_entry.insert(0, hex_color)

self.color_panel.config(bg=hex_color)

# Update graph
self.graph.add_points(raw_c, raw_r, raw_g, raw_b)

# Repeat every 50 ms
self.root.after(50, self.update_loop)

if __name__ == "__main__":
root = tk.Tk()
app = App(root)
root.geometry("600x400")
root.mainloop()
</syntaxhighlight>
}}
{{UGC-End}}

Controlling an I2C Display

2026-04-15T15:14:17Z

Lmpacent:

[[Category: Project]]
{{#seo:|keywords=I2C Adapter}}
{{#seo:|description=Control an 14-segment LCD display with the I2C Adapter Phidget}}
==Introduction==
[[Image:ADP0001_0_169.jpg|link=https://cdn.phidgets.com/docs/images/f/f5/ADP0001_0_169.jpg|thumb| 450px|<center>[https://www.phidgets.com/?prodid=1354 I2C Adapter Phidget (ADP0001_0)]]]
The [https://www.phidgets.com/?prodid=1354 I2C Adapter Phidget] allows you to interface with a wide range of I2C-compatible devices, including sensors, displays, and more.

In this project, we will use it to control a 14-segment alphanumeric display.

===Steps===
To complete this project, we will work through the following steps:
# Determine the device's basic configuration parameters
# Identify the sequence of commands expected by the device
# Connect the device to the I2C Adapter Phidget
# Test the device using the Phidget Control Panel
# Create a custom program.

===Resources===
Information from the following resources will be referenced throughout this project.
* [https://www.sparkfun.com/sparkfun-qwiic-alphanumeric-display-red.html Device Product Page]
* [https://cdn.phidgets.com/docs/images/7/7b/VK16K33.pdf VK16K33 LED Driver IC Datasheet]

==Demonstration==
<center>{{#ev:youtube|x2YtRTRMybw|rel=0}}</center>

==Configuration Parameters==
[[Image:Adp0002_an_productpage2.png|link=https://cdn.phidgets.com/docs/images/2/26/Adp0002_an_productpage2.png|thumb|<center>Product page features</center>]]
[[Image:I2C_Sensor_Freq.png|thumb|link=https://cdn.phidgets.com/docs/images/5/59/I2C_Sensor_Freq.png|<center>VK16K33 datasheet (Page 29)</center>]]
During this step, we are looking for the following information:
* Supply Voltage
* Communication Frequency
* Device Address

This information is typically found using the device's product page and/or any relevant datasheets. Based on these resources, we will use the following parameters:
* Supply Voltage: 3.3V*
* Communication Frequency: 400kHz
* I2C Address: 0x70

<nowiki>*</nowiki>''The datasheet specifies an operating voltage of 4.5-5V, however, this applies only when the chip is powered directly. The breakout board includes an onboard 3.3V to 5V boost circuit, which provides the required operating voltage for the chip.''

==Command Sequence==
Next, we need to determine the sequence of commands the device is expecting. The VK16K33 datasheet provides flowcharts that we can use to create a list of actions:

[[Image:Adp0002_an_flow.png|link=https://cdn.phidgets.com/docs/images/a/a8/Adp0002_an_flow.png|750px|center]]
<center>''Adapted from datasheet (page 26)''</center>

<br>Based on the flowcharts, our list of actions should look like this:

'''Power On Steps''':
# Enable the internal system clock
# Set the dimming register
# Set the blinking register
<nowiki>*</nowiki> ''The ROW/INT step is ignored because the feature is not being used.''

'''Display Steps'''
# Set the write address
# Send the data to display
# Turn on the display

===Writing to VK16K33 Registers===
I2C devices typically expect the following format:

[[Image:Adp0002_an_typicalcomms3.png|link=https://cdn.phidgets.com/docs/images/2/29/Adp0002_an_typicalcomms3.png|600px]]

The VK16K33 instead expects the following format, where the register address and data is combined into a single byte:

[[Image:Adp0002_an_VK16K33comms4.png|link=https://cdn.phidgets.com/docs/images/c/c5/Adp0002_an_VK16K33comms4.png|400px]]

===Power On Steps===
====Enable the System Clock====
The system clock (oscillator) is managed by register '''0x20''':

[[Image:I2C_Sensor_SysClock.png|link=https://cdn.phidgets.com/docs/images/d/d7/I2C_Sensor_SysClock.png|center|850px]]
<center>''VK16K33 datasheet (page 7)''</center>

This register only has one relevant bit, the '''S''' bit in position '''D8'''. By sending the command '''0010 0001''' (0x21 in hexadecimal), the system clock will be enabled. Bits marked with an '''X''' are irrelevant and can be set to either 0 or 1 with no impact.

====Set Dimming Register====
Dimming is managed by register '''0xEF''':
[[Image:Adp0002_an_dimmingreg.png|link=https://cdn.phidgets.com/docs/images/3/30/Adp0002_an_dimmingreg.png|center|850px]]
<center>''VK16K33 datasheet (page 25)''</center>

The register has four relevant bits, '''P0 through P3''', in positions '''D8 through D11'''. These bits are used to set the duty cycle of the display, which allows for fine control of brightness. By sending the command '''1110 1111''' (0xEF in hexadecimal), maximum brightness is selected.

====Set Blinking Register====
The blinking frequency and display state is managed by register '''0x80''':

[[Image:I2C_Sensor_Blink.png|link=|center|850px]]
<center>''Datasheet page 9''</center>

There are three relevant bits in this register: '''D''', '''B0''', and '''B1''' in positions '''D8 through D10'''. By sending the command '''1000 0001''' (0x81 in hexadecimal), the display will be turned on, and blinking will be set to off.

===Display Steps===
====Set the Write Address====
The display RAM is 16 bytes and begins at address '''0x00''':
[[Image:Adp0002_an_ram.png|link=https://cdn.phidgets.com/docs/images/b/bd/Adp0002_an_ram.png|center|750px]]
<center>''Datasheet page 10''</center>

====Send Data to Display====
The VK16K33 datasheet explains how the sent data translates into certain segments being activated. This is outside the scope of this project, so for the sake of simplicity, we will skip the conversion. A full code sample is provided later in this project and can be reviewed for more information.

====Turn On Display====
The display was previously turned on during the Power On Steps, so this step can be ignored.

== Connecting to the ADP0001 ==

We don't have a cable handy for the connectors on this display, so we soldered wires directly to the exposed I2C pads. The product page for the display board provides the following pinout:

[[Image:I2C_display_pads2.png|link=|75px|left]]

*'''C''' - SCL
*'''D''' - SDA
*'''3''' - 3.3V
*'''G''' - GND

We can simply wire each of these to their corresponding terminal on the I2C Adapter Phidget. Note that your device's SCL may be labeled "SCK", and the SDA pin may be "DIN" depending on which naming convention is used.

[[Image:I2C_display_pinout.png|800px|link=]]

==Testing in the Phidget Control Panel==
Now that we have the configuration parameters and the command sequence, we can use the Phidget Control Panel to confirm our device is working as expected.

===Power On Steps===
We can set the voltage to 3.3V, the frequency to 400kHz, and the address to 0x70. We can then queue up the commands we determined in the previous step.

[[Image:I2C_Sensor_ControlPanel2.png|link=https://cdn.phidgets.com/docs/images/c/c9/I2C_Sensor_ControlPanel2.png|center]]

Since we have not sent any data to the RAM yet, the segments are uninitialized, with some on and some off:

[[Image:I2C_Sensor_UnInit.png|800px|link=https://cdn.phidgets.com/docs/images/8/8c/I2C_Sensor_UnInit.png]]

===Display Steps===
To make the screen display '''PHID''', we will first clear the screen with the following command:
*'''0x0000000000000000000000000000'''.

We can then send the following data:
*'''0x003D000B00CA000C000300C30003'''

[[Image:I2C_Multisend.png|850px|link=]]

We can now see the expected result:

[[Image:I2C_Sensor_Phid.png|800px|link=https://cdn.phidgets.com/docs/images/c/cd/I2C_Sensor_Phid.png]]

===Reading Display RAM===
This display also supports reading the RAM, so you can programmatically know what's currently showing on the display. For most devices, this is as simple as providing the proper command and specifying a number of expected reply bytes. In this case, the device is expecting a stop condition in between the command and the data, as shown by the 'P' in the third block in this diagram:

[[Image:I2C_Sensor_Read.png|850px|link=https://cdn.phidgets.com/docs/images/b/b4/I2C_Sensor_Read.png|center]]
<center>''From page 23 of the datasheet''</center>

In order to replicate this in the control panel, we must send '''0x00''' first, and then send again with no data to listen for our reply bytes.

[[Image:I2C_Panel_Read.png|850px|link=]]

==Writing a Custom Program==
To begin writing a custom program for your Phidget device, navigate to the product page and select the [https://www.phidgets.com/?prodid=1354#Tab_Code_Samples Code Samples tab]. From there, you can customize the code for your own purposes. Here we have modified the Python code sample to match our steps from the Phidget Control Panel.

<syntaxhighlight lang=python>
from Phidget22.Phidget import *
from Phidget22.Devices.DataAdapter import *

def main():

clear = [0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00]
phid = [0x00,0x3D,0x00,0x0B,0x00,0xCA,0x00,0x0C,0x00,0x03,0x00,0xC3,0x00,0x03]

adp = DataAdapter()
adp.openWaitForAttachment(5000)

# Set properties
adp.setFrequency(DataAdapterFrequency.FREQUENCY_400kHz)
adp.setDataAdapterVoltage(DataAdapterVoltage.DATAADAPTER_VOLTAGE_3_3V)
addr = 0x70

# Clear Screen
adp.i2cSendReceive(addr, clear, 0)

# Initialize display
adp.i2cSendReceive(addr, [0x21], 0)
adp.i2cSendReceive(addr, [0xEF], 0)
adp.i2cSendReceive(addr, [0x81], 0)

# Print PHID
adp.i2cSendReceive(addr, phid, 0)

try:
input("Press Enter to Stop\n")
except (Exception, KeyboardInterrupt):
pass

adp.close()

main()
</syntaxhighlight>

That’s about it, we went from reading the datasheet to a working script. Not all datasheets are created equal, so if you’re struggling with getting your sensor set up, feel free to ask for help by [https://www.phidgets.com/?view=contact sending us an email].

===Full Script===
Here is the full Python script that was used in the demonstration video. It will take input from the console and print scrolling messages on the display.

{{UGC-Start}}
{{UGC-Entry|Full Script (Click to expand)||
<syntaxhighlight lang=python>
from Phidget22.Phidget import *
from Phidget22.Devices.DataAdapter import *
import time

ram = ["0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000"]

# _ _ _ b _ _ _
# | \ | / |
# | c e g |
# l \ | / d
# | \ | / |
# | _ n _ _ _ a _ |
# | / | \ |
# j / | \ f
# | m k i |
# | / | \ |
# | _ _ _ h _ _ _ |

letters = {
# abcdefghijklmn abcdefghijklmn abcdefghijklmn
"A": 0b11010100010101, "N": 0b00110100110100, "0": 0b01010111010110,
"B": 0b11011101001001, "O": 0b01010101010100, "1": 0b00010110000000,
"C": 0b01000001010100, "P": 0b11010000010101, "2": 0b11010001010001,
"D": 0b01011101001000, "Q": 0b01010101110100, "3": 0b11010101000001,
"E": 0b11000001010101, "R": 0b11010000110101, "4": 0b10010100000101,
"F": 0b11000000010101, "S": 0b11100101000000, "5": 0b11000101000101,
"G": 0b11000101010100, "T": 0b01001000001000, "6": 0b11000101010101,
"H": 0b10010100010101, "U": 0b00010101010100, "7": 0b01010100000000,
"I": 0b01001001001000, "V": 0b00000010010110, "8": 0b11010101010101,
"J": 0b00010101010000, "W": 0b00010100110110, "9": 0b11010100000101,
"K": 0b00000010110101, "X": 0b00100010100010,
"L": 0b00000001010100, "Y": 0b00100010001000,
"M": 0b00110110010100, "Z": 0b01000011000010
}

# loadRAM Reads all 13 bytes of of the screen memory into an array of 26 strings (for easier debugging)
# It should be loaded before overwriting a character, to preserve the other three.
def loadRAM(phid, addr):
for i in range(13):
byte = format(phid.i2cSendReceive(addr,[i],1)[0],'08b')
ram[(i*2)] = byte[:4]
ram[(i*2)+1] = byte[4:]

# printMessage prints a scrolling marquee messasge 'str'
def printMessage(str, phid, addr):
# Add four spaces to ensure the message scrolls off
str += " "
a0 = a1 = a2 = a3 = ""

for a in str:
a0 = a1
a1 = a2
a2 = a3
a3 = a.upper()
clearScreen(phid,addr)
printLetter(a0, phid, addr, 0)
printLetter(a1, phid, addr, 1)
printLetter(a2, phid, addr, 2)
printLetter(a3, phid, addr, 3)
time.sleep(0.08)

# printLetter prints letter 'a' to position 'pos'
def printLetter(a, phid, addr,pos):

# Confirm parameters are valid
if a not in letters or (pos > 3) or (pos < 0):
return

# Get the segments required for the letter
bits = [(letters[a] >> bit) & 1 for bit in range(13,-1,-1)]

# For each segment, AND or OR it to the existing memory to preseve the other three digits
# It had to be broken into two in order to skip over other bytes in the memory string.
# The memory string is laid out like this: 00ab0:cd0.ef00gh00ij00kl00mn
# Where ':' turns on the center colon and '.' turns on the decimal point when 0001 is written there.
for i in range(7):
if bits[2*i] == 0:
tmp = int(ram[4*i], 2)
tmp &= ~(1 << pos)
ram[4*i] = f"{tmp:04b}"
else:
tmp = int(ram[4*i], 2)
tmp |= (1 << pos)
ram[4*i] = f"{tmp:04b}"

if bits[(2*i)+1] == 0:
tmp = int(ram[(4*i)+1], 2)
tmp &= ~(1 << pos)
ram[(4*i)+1] = f"{tmp:04b}"
else:
tmp = int(ram[(4*i)+1], 2)
tmp |= (1 << pos)
ram[(4*i)+1] = f"{tmp:04b}"

hex = bytes(
(int(ram[i], 2) << 4) | int(ram[i+1], 2)
for i in range(0, 26, 2)
)
hex = list(hex)
hex.insert(0,0x00) # add the leading 0x00 for writing
phid.i2cSendReceive(addr, hex, 0)

# clearScreen clears the screen and the ram array
def clearScreen(phid,addr):
phid.i2cSendReceive(addr, [0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00], 0)
loadRAM(phid,addr)

# initialize sets the clock, brightness and blinking so the screen can operate
def initialize(phid,addr):
phid.i2cSendReceive(addr, [0x21], 0)
phid.i2cSendReceive(addr, [0xEF], 0)
phid.i2cSendReceive(addr, [0x81], 0)

def main():

# Declare and open dataAdapter channel
adp = DataAdapter()
adp.openWaitForAttachment(5000)

# Set properties
adp.setFrequency(DataAdapterFrequency.FREQUENCY_400kHz)
adp.setDataAdapterVoltage(DataAdapterVoltage.DATAADAPTER_VOLTAGE_3_3V)
addr = 0x70

# Clear Screen
clearScreen(adp,addr)

# Initialize display
initialize(adp,addr)

print("Type a message to display, or 'exit' to quit.")

message = ""

while message != "exit":
try:
message = input()
printMessage(message,adp,addr)
except (Exception, KeyboardInterrupt):
pass

adp.close()

main()

</syntaxhighlight>
}}
{{UGC-End}}

Controlling an I2C Display

2026-04-13T15:11:42Z

Lmpacent: /* Writing a Custom Program */

<metadesc>A step-by-step example writing code to interface a sensor with the ADP0001.</metadesc>

==Introduction==
[[Image:ADP0001_0_169.jpg|link=https://cdn.phidgets.com/docs/images/f/f5/ADP0001_0_169.jpg|thumb| 450px|<center>[https://www.phidgets.com/?prodid=1354 I2C Adapter Phidget (ADP0001_0)]]]
The [https://www.phidgets.com/?prodid=1354 I2C Adapter Phidget] allows you to interface with a wide range of I2C-compatible devices, including sensors, displays, and more.

In this project, we will use it to control a 14-segment alphanumeric display.

===Steps===
To complete this project, we will work through the following steps:
# Determine the device's basic configuration parameters
# Identify the sequence of commands expected by the device
# Connect the device to the I2C Adapter Phidget
# Test the device using the Phidget Control Panel
# Create a custom program.

===Resources===
Information from the following resources will be referenced throughout this project.
* [https://www.sparkfun.com/sparkfun-qwiic-alphanumeric-display-red.html Device Product Page]
* [https://cdn.phidgets.com/docs/images/7/7b/VK16K33.pdf VK16K33 LED Driver IC Datasheet]

==Demonstration==
<center>{{#ev:youtube|x2YtRTRMybw|rel=0}}</center>

==Configuration Parameters==
[[Image:Adp0002_an_productpage2.png|link=https://cdn.phidgets.com/docs/images/2/26/Adp0002_an_productpage2.png|thumb|<center>Product page features</center>]]
[[Image:I2C_Sensor_Freq.png|thumb|link=https://cdn.phidgets.com/docs/images/5/59/I2C_Sensor_Freq.png|<center>VK16K33 datasheet (Page 29)</center>]]
During this step, we are looking for the following information:
* Supply Voltage
* Communication Frequency
* Device Address

This information is typically found using the device's product page and/or any relevant datasheets. Based on these resources, we will use the following parameters:
* Supply Voltage: 3.3V*
* Communication Frequency: 400kHz
* I2C Address: 0x70

<nowiki>*</nowiki>''The datasheet specifies an operating voltage of 4.5-5V, however, this applies only when the chip is powered directly. The breakout board includes an onboard 3.3V to 5V boost circuit, which provides the required operating voltage for the chip.''

==Command Sequence==
Next, we need to determine the sequence of commands the device is expecting. The VK16K33 datasheet provides flowcharts that we can use to create a list of actions:

[[Image:Adp0002_an_flow.png|link=https://cdn.phidgets.com/docs/images/a/a8/Adp0002_an_flow.png|750px|center]]
<center>''Adapted from datasheet (page 26)''</center>

<br>Based on the flowcharts, our list of actions should look like this:

'''Power On Steps''':
# Enable the internal system clock
# Set the dimming register
# Set the blinking register
<nowiki>*</nowiki> ''The ROW/INT step is ignored because the feature is not being used.''

'''Display Steps'''
# Set the write address
# Send the data to display
# Turn on the display

===Writing to VK16K33 Registers===
I2C devices typically expect the following format:

[[Image:Adp0002_an_typicalcomms3.png|link=https://cdn.phidgets.com/docs/images/2/29/Adp0002_an_typicalcomms3.png|600px]]

The VK16K33 instead expects the following format, where the register address and data is combined into a single byte:

[[Image:Adp0002_an_VK16K33comms4.png|link=https://cdn.phidgets.com/docs/images/c/c5/Adp0002_an_VK16K33comms4.png|400px]]

===Power On Steps===
====Enable the System Clock====
The system clock (oscillator) is managed by register '''0x20''':

[[Image:I2C_Sensor_SysClock.png|link=https://cdn.phidgets.com/docs/images/d/d7/I2C_Sensor_SysClock.png|center|850px]]
<center>''VK16K33 datasheet (page 7)''</center>

This register only has one relevant bit, the '''S''' bit in position '''D8'''. By sending the command '''0010 0001''' (0x21 in hexadecimal), the system clock will be enabled. Bits marked with an '''X''' are irrelevant and can be set to either 0 or 1 with no impact.

====Set Dimming Register====
Dimming is managed by register '''0xEF''':
[[Image:Adp0002_an_dimmingreg.png|link=https://cdn.phidgets.com/docs/images/3/30/Adp0002_an_dimmingreg.png|center|850px]]
<center>''VK16K33 datasheet (page 25)''</center>

The register has four relevant bits, '''P0 through P3''', in positions '''D8 through D11'''. These bits are used to set the duty cycle of the display, which allows for fine control of brightness. By sending the command '''1110 1111''' (0xEF in hexadecimal), maximum brightness is selected.

====Set Blinking Register====
The blinking frequency and display state is managed by register '''0x80''':

[[Image:I2C_Sensor_Blink.png|link=|center|850px]]
<center>''Datasheet page 9''</center>

There are three relevant bits in this register: '''D''', '''B0''', and '''B1''' in positions '''D8 through D10'''. By sending the command '''1000 0001''' (0x81 in hexadecimal), the display will be turned on, and blinking will be set to off.

===Display Steps===
====Set the Write Address====
The display RAM is 16 bytes and begins at address '''0x00''':
[[Image:Adp0002_an_ram.png|link=https://cdn.phidgets.com/docs/images/b/bd/Adp0002_an_ram.png|center|750px]]
<center>''Datasheet page 10''</center>

====Send Data to Display====
The VK16K33 datasheet explains how the sent data translates into certain segments being activated. This is outside the scope of this project, so for the sake of simplicity, we will skip the conversion. A full code sample is provided later in this project and can be reviewed for more information.

====Turn On Display====
The display was previously turned on during the Power On Steps, so this step can be ignored.

== Connecting to the ADP0001 ==

We don't have a cable handy for the connectors on this display, so we soldered wires directly to the exposed I2C pads. The product page for the display board provides the following pinout:

[[Image:I2C_display_pads2.png|link=|75px|left]]

*'''C''' - SCL
*'''D''' - SDA
*'''3''' - 3.3V
*'''G''' - GND

We can simply wire each of these to their corresponding terminal on the I2C Adapter Phidget. Note that your device's SCL may be labeled "SCK", and the SDA pin may be "DIN" depending on which naming convention is used.

[[Image:I2C_display_pinout.png|800px|link=]]

==Testing in the Phidget Control Panel==
Now that we have the configuration parameters and the command sequence, we can use the Phidget Control Panel to confirm our device is working as expected.

===Power On Steps===
We can set the voltage to 3.3V, the frequency to 400kHz, and the address to 0x70. We can then queue up the commands we determined in the previous step.

[[Image:I2C_Sensor_ControlPanel2.png|link=https://cdn.phidgets.com/docs/images/c/c9/I2C_Sensor_ControlPanel2.png|center]]

Since we have not sent any data to the RAM yet, the segments are uninitialized, with some on and some off:

[[Image:I2C_Sensor_UnInit.png|800px|link=https://cdn.phidgets.com/docs/images/8/8c/I2C_Sensor_UnInit.png]]

===Display Steps===
To make the screen display '''PHID''', we will first clear the screen with the following command:
*'''0x0000000000000000000000000000'''.

We can then send the following data:
*'''0x003D000B00CA000C000300C30003'''

[[Image:I2C_Multisend.png|850px|link=]]

We can now see the expected result:

[[Image:I2C_Sensor_Phid.png|800px|link=https://cdn.phidgets.com/docs/images/c/cd/I2C_Sensor_Phid.png]]

===Reading Display RAM===
This display also supports reading the RAM, so you can programmatically know what's currently showing on the display. For most devices, this is as simple as providing the proper command and specifying a number of expected reply bytes. In this case, the device is expecting a stop condition in between the command and the data, as shown by the 'P' in the third block in this diagram:

[[Image:I2C_Sensor_Read.png|850px|link=https://cdn.phidgets.com/docs/images/b/b4/I2C_Sensor_Read.png|center]]
<center>''From page 23 of the datasheet''</center>

In order to replicate this in the control panel, we must send '''0x00''' first, and then send again with no data to listen for our reply bytes.

[[Image:I2C_Panel_Read.png|850px|link=]]

==Writing a Custom Program==
To begin writing a custom program for your Phidget device, navigate to the product page and select the [https://www.phidgets.com/?prodid=1354#Tab_Code_Samples Code Samples tab]. From there, you can customize the code for your own purposes. Here we have modified the Python code sample to match our steps from the Phidget Control Panel.

<syntaxhighlight lang=python>
from Phidget22.Phidget import *
from Phidget22.Devices.DataAdapter import *

def main():

clear = [0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00]
phid = [0x00,0x3D,0x00,0x0B,0x00,0xCA,0x00,0x0C,0x00,0x03,0x00,0xC3,0x00,0x03]

adp = DataAdapter()
adp.openWaitForAttachment(5000)

# Set properties
adp.setFrequency(DataAdapterFrequency.FREQUENCY_400kHz)
adp.setDataAdapterVoltage(DataAdapterVoltage.DATAADAPTER_VOLTAGE_3_3V)
addr = 0x70

# Clear Screen
adp.i2cSendReceive(addr, clear, 0)

# Initialize display
adp.i2cSendReceive(addr, [0x21], 0)
adp.i2cSendReceive(addr, [0xEF], 0)
adp.i2cSendReceive(addr, [0x81], 0)

# Print PHID
adp.i2cSendReceive(addr, phid, 0)

try:
input("Press Enter to Stop\n")
except (Exception, KeyboardInterrupt):
pass

adp.close()

main()
</syntaxhighlight>

That’s about it, we went from reading the datasheet to a working script. Not all datasheets are created equal, so if you’re struggling with getting your sensor set up, feel free to ask for help by [https://www.phidgets.com/?view=contact sending us an email].

===Full Script===
Here is the full Python script that was used in the demonstration video. It will take input from the console and print scrolling messages on the display.

{{UGC-Start}}
{{UGC-Entry|Full Script (Click to expand)||
<syntaxhighlight lang=python>
from Phidget22.Phidget import *
from Phidget22.Devices.DataAdapter import *
import time

ram = ["0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000"]

# _ _ _ b _ _ _
# | \ | / |
# | c e g |
# l \ | / d
# | \ | / |
# | _ n _ _ _ a _ |
# | / | \ |
# j / | \ f
# | m k i |
# | / | \ |
# | _ _ _ h _ _ _ |

letters = {
# abcdefghijklmn abcdefghijklmn abcdefghijklmn
"A": 0b11010100010101, "N": 0b00110100110100, "0": 0b01010111010110,
"B": 0b11011101001001, "O": 0b01010101010100, "1": 0b00010110000000,
"C": 0b01000001010100, "P": 0b11010000010101, "2": 0b11010001010001,
"D": 0b01011101001000, "Q": 0b01010101110100, "3": 0b11010101000001,
"E": 0b11000001010101, "R": 0b11010000110101, "4": 0b10010100000101,
"F": 0b11000000010101, "S": 0b11100101000000, "5": 0b11000101000101,
"G": 0b11000101010100, "T": 0b01001000001000, "6": 0b11000101010101,
"H": 0b10010100010101, "U": 0b00010101010100, "7": 0b01010100000000,
"I": 0b01001001001000, "V": 0b00000010010110, "8": 0b11010101010101,
"J": 0b00010101010000, "W": 0b00010100110110, "9": 0b11010100000101,
"K": 0b00000010110101, "X": 0b00100010100010,
"L": 0b00000001010100, "Y": 0b00100010001000,
"M": 0b00110110010100, "Z": 0b01000011000010
}

# loadRAM Reads all 13 bytes of of the screen memory into an array of 26 strings (for easier debugging)
# It should be loaded before overwriting a character, to preserve the other three.
def loadRAM(phid, addr):
for i in range(13):
byte = format(phid.i2cSendReceive(addr,[i],1)[0],'08b')
ram[(i*2)] = byte[:4]
ram[(i*2)+1] = byte[4:]

# printMessage prints a scrolling marquee messasge 'str'
def printMessage(str, phid, addr):
# Add four spaces to ensure the message scrolls off
str += " "
a0 = a1 = a2 = a3 = ""

for a in str:
a0 = a1
a1 = a2
a2 = a3
a3 = a.upper()
clearScreen(phid,addr)
printLetter(a0, phid, addr, 0)
printLetter(a1, phid, addr, 1)
printLetter(a2, phid, addr, 2)
printLetter(a3, phid, addr, 3)
time.sleep(0.08)

# printLetter prints letter 'a' to position 'pos'
def printLetter(a, phid, addr,pos):

# Confirm parameters are valid
if a not in letters or (pos > 3) or (pos < 0):
return

# Get the segments required for the letter
bits = [(letters[a] >> bit) & 1 for bit in range(13,-1,-1)]

# For each segment, AND or OR it to the existing memory to preseve the other three digits
# It had to be broken into two in order to skip over other bytes in the memory string.
# The memory string is laid out like this: 00ab0:cd0.ef00gh00ij00kl00mn
# Where ':' turns on the center colon and '.' turns on the decimal point when 0001 is written there.
for i in range(7):
if bits[2*i] == 0:
tmp = int(ram[4*i], 2)
tmp &= ~(1 << pos)
ram[4*i] = f"{tmp:04b}"
else:
tmp = int(ram[4*i], 2)
tmp |= (1 << pos)
ram[4*i] = f"{tmp:04b}"

if bits[(2*i)+1] == 0:
tmp = int(ram[(4*i)+1], 2)
tmp &= ~(1 << pos)
ram[(4*i)+1] = f"{tmp:04b}"
else:
tmp = int(ram[(4*i)+1], 2)
tmp |= (1 << pos)
ram[(4*i)+1] = f"{tmp:04b}"

hex = bytes(
(int(ram[i], 2) << 4) | int(ram[i+1], 2)
for i in range(0, 26, 2)
)
hex = list(hex)
hex.insert(0,0x00) # add the leading 0x00 for writing
phid.i2cSendReceive(addr, hex, 0)

# clearScreen clears the screen and the ram array
def clearScreen(phid,addr):
phid.i2cSendReceive(addr, [0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00], 0)
loadRAM(phid,addr)

# initialize sets the clock, brightness and blinking so the screen can operate
def initialize(phid,addr):
phid.i2cSendReceive(addr, [0x21], 0)
phid.i2cSendReceive(addr, [0xEF], 0)
phid.i2cSendReceive(addr, [0x81], 0)

def main():

# Declare and open dataAdapter channel
adp = DataAdapter()
adp.openWaitForAttachment(5000)

# Set properties
adp.setFrequency(DataAdapterFrequency.FREQUENCY_400kHz)
adp.setDataAdapterVoltage(DataAdapterVoltage.DATAADAPTER_VOLTAGE_3_3V)
addr = 0x70

# Clear Screen
clearScreen(adp,addr)

# Initialize display
initialize(adp,addr)

print("Type a message to display, or 'exit' to quit.")

message = ""

while message != "exit":
try:
message = input()
printMessage(message,adp,addr)
except (Exception, KeyboardInterrupt):
pass

adp.close()

main()

</syntaxhighlight>
}}
{{UGC-End}}

Controlling an I2C Display

2026-04-13T15:11:21Z

Lmpacent: /* Writing a Custom Python Script */

<metadesc>A step-by-step example writing code to interface a sensor with the ADP0001.</metadesc>

==Introduction==
[[Image:ADP0001_0_169.jpg|link=https://cdn.phidgets.com/docs/images/f/f5/ADP0001_0_169.jpg|thumb| 450px|<center>[https://www.phidgets.com/?prodid=1354 I2C Adapter Phidget (ADP0001_0)]]]
The [https://www.phidgets.com/?prodid=1354 I2C Adapter Phidget] allows you to interface with a wide range of I2C-compatible devices, including sensors, displays, and more.

In this project, we will use it to control a 14-segment alphanumeric display.

===Steps===
To complete this project, we will work through the following steps:
# Determine the device's basic configuration parameters
# Identify the sequence of commands expected by the device
# Connect the device to the I2C Adapter Phidget
# Test the device using the Phidget Control Panel
# Create a custom program.

===Resources===
Information from the following resources will be referenced throughout this project.
* [https://www.sparkfun.com/sparkfun-qwiic-alphanumeric-display-red.html Device Product Page]
* [https://cdn.phidgets.com/docs/images/7/7b/VK16K33.pdf VK16K33 LED Driver IC Datasheet]

==Demonstration==
<center>{{#ev:youtube|x2YtRTRMybw|rel=0}}</center>

==Configuration Parameters==
[[Image:Adp0002_an_productpage2.png|link=https://cdn.phidgets.com/docs/images/2/26/Adp0002_an_productpage2.png|thumb|<center>Product page features</center>]]
[[Image:I2C_Sensor_Freq.png|thumb|link=https://cdn.phidgets.com/docs/images/5/59/I2C_Sensor_Freq.png|<center>VK16K33 datasheet (Page 29)</center>]]
During this step, we are looking for the following information:
* Supply Voltage
* Communication Frequency
* Device Address

This information is typically found using the device's product page and/or any relevant datasheets. Based on these resources, we will use the following parameters:
* Supply Voltage: 3.3V*
* Communication Frequency: 400kHz
* I2C Address: 0x70

<nowiki>*</nowiki>''The datasheet specifies an operating voltage of 4.5-5V, however, this applies only when the chip is powered directly. The breakout board includes an onboard 3.3V to 5V boost circuit, which provides the required operating voltage for the chip.''

==Command Sequence==
Next, we need to determine the sequence of commands the device is expecting. The VK16K33 datasheet provides flowcharts that we can use to create a list of actions:

[[Image:Adp0002_an_flow.png|link=https://cdn.phidgets.com/docs/images/a/a8/Adp0002_an_flow.png|750px|center]]
<center>''Adapted from datasheet (page 26)''</center>

<br>Based on the flowcharts, our list of actions should look like this:

'''Power On Steps''':
# Enable the internal system clock
# Set the dimming register
# Set the blinking register
<nowiki>*</nowiki> ''The ROW/INT step is ignored because the feature is not being used.''

'''Display Steps'''
# Set the write address
# Send the data to display
# Turn on the display

===Writing to VK16K33 Registers===
I2C devices typically expect the following format:

[[Image:Adp0002_an_typicalcomms3.png|link=https://cdn.phidgets.com/docs/images/2/29/Adp0002_an_typicalcomms3.png|600px]]

The VK16K33 instead expects the following format, where the register address and data is combined into a single byte:

[[Image:Adp0002_an_VK16K33comms4.png|link=https://cdn.phidgets.com/docs/images/c/c5/Adp0002_an_VK16K33comms4.png|400px]]

===Power On Steps===
====Enable the System Clock====
The system clock (oscillator) is managed by register '''0x20''':

[[Image:I2C_Sensor_SysClock.png|link=https://cdn.phidgets.com/docs/images/d/d7/I2C_Sensor_SysClock.png|center|850px]]
<center>''VK16K33 datasheet (page 7)''</center>

This register only has one relevant bit, the '''S''' bit in position '''D8'''. By sending the command '''0010 0001''' (0x21 in hexadecimal), the system clock will be enabled. Bits marked with an '''X''' are irrelevant and can be set to either 0 or 1 with no impact.

====Set Dimming Register====
Dimming is managed by register '''0xEF''':
[[Image:Adp0002_an_dimmingreg.png|link=https://cdn.phidgets.com/docs/images/3/30/Adp0002_an_dimmingreg.png|center|850px]]
<center>''VK16K33 datasheet (page 25)''</center>

The register has four relevant bits, '''P0 through P3''', in positions '''D8 through D11'''. These bits are used to set the duty cycle of the display, which allows for fine control of brightness. By sending the command '''1110 1111''' (0xEF in hexadecimal), maximum brightness is selected.

====Set Blinking Register====
The blinking frequency and display state is managed by register '''0x80''':

[[Image:I2C_Sensor_Blink.png|link=|center|850px]]
<center>''Datasheet page 9''</center>

There are three relevant bits in this register: '''D''', '''B0''', and '''B1''' in positions '''D8 through D10'''. By sending the command '''1000 0001''' (0x81 in hexadecimal), the display will be turned on, and blinking will be set to off.

===Display Steps===
====Set the Write Address====
The display RAM is 16 bytes and begins at address '''0x00''':
[[Image:Adp0002_an_ram.png|link=https://cdn.phidgets.com/docs/images/b/bd/Adp0002_an_ram.png|center|750px]]
<center>''Datasheet page 10''</center>

====Send Data to Display====
The VK16K33 datasheet explains how the sent data translates into certain segments being activated. This is outside the scope of this project, so for the sake of simplicity, we will skip the conversion. A full code sample is provided later in this project and can be reviewed for more information.

====Turn On Display====
The display was previously turned on during the Power On Steps, so this step can be ignored.

== Connecting to the ADP0001 ==

We don't have a cable handy for the connectors on this display, so we soldered wires directly to the exposed I2C pads. The product page for the display board provides the following pinout:

[[Image:I2C_display_pads2.png|link=|75px|left]]

*'''C''' - SCL
*'''D''' - SDA
*'''3''' - 3.3V
*'''G''' - GND

We can simply wire each of these to their corresponding terminal on the I2C Adapter Phidget. Note that your device's SCL may be labeled "SCK", and the SDA pin may be "DIN" depending on which naming convention is used.

[[Image:I2C_display_pinout.png|800px|link=]]

==Testing in the Phidget Control Panel==
Now that we have the configuration parameters and the command sequence, we can use the Phidget Control Panel to confirm our device is working as expected.

===Power On Steps===
We can set the voltage to 3.3V, the frequency to 400kHz, and the address to 0x70. We can then queue up the commands we determined in the previous step.

[[Image:I2C_Sensor_ControlPanel2.png|link=https://cdn.phidgets.com/docs/images/c/c9/I2C_Sensor_ControlPanel2.png|center]]

Since we have not sent any data to the RAM yet, the segments are uninitialized, with some on and some off:

[[Image:I2C_Sensor_UnInit.png|800px|link=https://cdn.phidgets.com/docs/images/8/8c/I2C_Sensor_UnInit.png]]

===Display Steps===
To make the screen display '''PHID''', we will first clear the screen with the following command:
*'''0x0000000000000000000000000000'''.

We can then send the following data:
*'''0x003D000B00CA000C000300C30003'''

[[Image:I2C_Multisend.png|850px|link=]]

We can now see the expected result:

[[Image:I2C_Sensor_Phid.png|800px|link=https://cdn.phidgets.com/docs/images/c/cd/I2C_Sensor_Phid.png]]

===Reading Display RAM===
This display also supports reading the RAM, so you can programmatically know what's currently showing on the display. For most devices, this is as simple as providing the proper command and specifying a number of expected reply bytes. In this case, the device is expecting a stop condition in between the command and the data, as shown by the 'P' in the third block in this diagram:

[[Image:I2C_Sensor_Read.png|850px|link=https://cdn.phidgets.com/docs/images/b/b4/I2C_Sensor_Read.png|center]]
<center>''From page 23 of the datasheet''</center>

In order to replicate this in the control panel, we must send '''0x00''' first, and then send again with no data to listen for our reply bytes.

[[Image:I2C_Panel_Read.png|850px|link=]]

==Writing a Custom Program==
To begin writing a custom program for your Phidget device, navigate to the product page and select the [https://www.phidgets.com/?prodid=1354#Tab_Code_Samples Code Samples tab]. From there, you can customize the code for your own purposes. Here we have modified the code sample to match our steps from the Phidget Control Panel.

<syntaxhighlight lang=python>
from Phidget22.Phidget import *
from Phidget22.Devices.DataAdapter import *

def main():

clear = [0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00]
phid = [0x00,0x3D,0x00,0x0B,0x00,0xCA,0x00,0x0C,0x00,0x03,0x00,0xC3,0x00,0x03]

adp = DataAdapter()
adp.openWaitForAttachment(5000)

# Set properties
adp.setFrequency(DataAdapterFrequency.FREQUENCY_400kHz)
adp.setDataAdapterVoltage(DataAdapterVoltage.DATAADAPTER_VOLTAGE_3_3V)
addr = 0x70

# Clear Screen
adp.i2cSendReceive(addr, clear, 0)

# Initialize display
adp.i2cSendReceive(addr, [0x21], 0)
adp.i2cSendReceive(addr, [0xEF], 0)
adp.i2cSendReceive(addr, [0x81], 0)

# Print PHID
adp.i2cSendReceive(addr, phid, 0)

try:
input("Press Enter to Stop\n")
except (Exception, KeyboardInterrupt):
pass

adp.close()

main()
</syntaxhighlight>

That’s about it, we went from reading the datasheet to a working script. Not all datasheets are created equal, so if you’re struggling with getting your sensor set up, feel free to ask for help by [https://www.phidgets.com/?view=contact sending us an email].

===Full Script===
Here is the full Python script that was used in the demonstration video. It will take input from the console and print scrolling messages on the display.

{{UGC-Start}}
{{UGC-Entry|Full Script (Click to expand)||
<syntaxhighlight lang=python>
from Phidget22.Phidget import *
from Phidget22.Devices.DataAdapter import *
import time

ram = ["0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000","0000"]

# _ _ _ b _ _ _
# | \ | / |
# | c e g |
# l \ | / d
# | \ | / |
# | _ n _ _ _ a _ |
# | / | \ |
# j / | \ f
# | m k i |
# | / | \ |
# | _ _ _ h _ _ _ |

letters = {
# abcdefghijklmn abcdefghijklmn abcdefghijklmn
"A": 0b11010100010101, "N": 0b00110100110100, "0": 0b01010111010110,
"B": 0b11011101001001, "O": 0b01010101010100, "1": 0b00010110000000,
"C": 0b01000001010100, "P": 0b11010000010101, "2": 0b11010001010001,
"D": 0b01011101001000, "Q": 0b01010101110100, "3": 0b11010101000001,
"E": 0b11000001010101, "R": 0b11010000110101, "4": 0b10010100000101,
"F": 0b11000000010101, "S": 0b11100101000000, "5": 0b11000101000101,
"G": 0b11000101010100, "T": 0b01001000001000, "6": 0b11000101010101,
"H": 0b10010100010101, "U": 0b00010101010100, "7": 0b01010100000000,
"I": 0b01001001001000, "V": 0b00000010010110, "8": 0b11010101010101,
"J": 0b00010101010000, "W": 0b00010100110110, "9": 0b11010100000101,
"K": 0b00000010110101, "X": 0b00100010100010,
"L": 0b00000001010100, "Y": 0b00100010001000,
"M": 0b00110110010100, "Z": 0b01000011000010
}

# loadRAM Reads all 13 bytes of of the screen memory into an array of 26 strings (for easier debugging)
# It should be loaded before overwriting a character, to preserve the other three.
def loadRAM(phid, addr):
for i in range(13):
byte = format(phid.i2cSendReceive(addr,[i],1)[0],'08b')
ram[(i*2)] = byte[:4]
ram[(i*2)+1] = byte[4:]

# printMessage prints a scrolling marquee messasge 'str'
def printMessage(str, phid, addr):
# Add four spaces to ensure the message scrolls off
str += " "
a0 = a1 = a2 = a3 = ""

for a in str:
a0 = a1
a1 = a2
a2 = a3
a3 = a.upper()
clearScreen(phid,addr)
printLetter(a0, phid, addr, 0)
printLetter(a1, phid, addr, 1)
printLetter(a2, phid, addr, 2)
printLetter(a3, phid, addr, 3)
time.sleep(0.08)

# printLetter prints letter 'a' to position 'pos'
def printLetter(a, phid, addr,pos):

# Confirm parameters are valid
if a not in letters or (pos > 3) or (pos < 0):
return

# Get the segments required for the letter
bits = [(letters[a] >> bit) & 1 for bit in range(13,-1,-1)]

# For each segment, AND or OR it to the existing memory to preseve the other three digits
# It had to be broken into two in order to skip over other bytes in the memory string.
# The memory string is laid out like this: 00ab0:cd0.ef00gh00ij00kl00mn
# Where ':' turns on the center colon and '.' turns on the decimal point when 0001 is written there.
for i in range(7):
if bits[2*i] == 0:
tmp = int(ram[4*i], 2)
tmp &= ~(1 << pos)
ram[4*i] = f"{tmp:04b}"
else:
tmp = int(ram[4*i], 2)
tmp |= (1 << pos)
ram[4*i] = f"{tmp:04b}"

if bits[(2*i)+1] == 0:
tmp = int(ram[(4*i)+1], 2)
tmp &= ~(1 << pos)
ram[(4*i)+1] = f"{tmp:04b}"
else:
tmp = int(ram[(4*i)+1], 2)
tmp |= (1 << pos)
ram[(4*i)+1] = f"{tmp:04b}"

hex = bytes(
(int(ram[i], 2) << 4) | int(ram[i+1], 2)
for i in range(0, 26, 2)
)
hex = list(hex)
hex.insert(0,0x00) # add the leading 0x00 for writing
phid.i2cSendReceive(addr, hex, 0)

# clearScreen clears the screen and the ram array
def clearScreen(phid,addr):
phid.i2cSendReceive(addr, [0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00], 0)
loadRAM(phid,addr)

# initialize sets the clock, brightness and blinking so the screen can operate
def initialize(phid,addr):
phid.i2cSendReceive(addr, [0x21], 0)
phid.i2cSendReceive(addr, [0xEF], 0)
phid.i2cSendReceive(addr, [0x81], 0)

def main():

# Declare and open dataAdapter channel
adp = DataAdapter()
adp.openWaitForAttachment(5000)

# Set properties
adp.setFrequency(DataAdapterFrequency.FREQUENCY_400kHz)
adp.setDataAdapterVoltage(DataAdapterVoltage.DATAADAPTER_VOLTAGE_3_3V)
addr = 0x70

# Clear Screen
clearScreen(adp,addr)

# Initialize display
initialize(adp,addr)

print("Type a message to display, or 'exit' to quit.")

message = ""

while message != "exit":
try:
message = input()
printMessage(message,adp,addr)
except (Exception, KeyboardInterrupt):
pass

adp.close()

main()

</syntaxhighlight>
}}
{{UGC-End}}

I2C Adapter API Guide

2026-04-09T19:50:44Z

Lmpacent: /* I2CSendReceive() */

{{#seo:|description=Get started with your I2C Adapter Phidget}}
[[Category:IntroGuide]]
<div class="nonumtoc">
<div class="toclimit-4">
== Introduction ==
[[Image:ADP0001_0.jpg|thumb|<center>I2C Adapter Phidget (ADP0001_0)</center>]]
This guide will provide information about the DataAdapter API to get you up and running with your new I2C Adapter Phidget.

Before starting this guide, visit the Quick Start Guide on your I2C Adapter Phidget's product page for information about wiring.

== Address Format ==

The I2C Adapter Phidget interprets the device address as follows:

[[Image:I2C_Addr.png|link=|550px]]

The read/write bit is not included in the hexadecimal value for the address, as this bit is handled by the API calls.
You may find that datasheets for some I2C devices include the read/write bit, so a read-only device like a simple temperature sensor might specify the address as '''0xE3''' instead of '''0x71''' in this case. When using such a sensor, be sure to ignore the R/W bit and shift the remaining seven bits down to get the address you need to send to Phidgets API calls.

== Methods ==
=== I2CSendReceive() ===

Parameters:
* int '''address'''
* byte[ ] '''data'''
* int '''receiveLength'''

This is the main function you'll use for simple read and write operations.

* The first parameter is the I2C address of your device, usually specified in the datasheet or printed on the circuit board.
* The second parameter is the data array, which can contain up to 127 bytes. If the data array is empty, the I2C Adapter Phidget will skip sending the write address and bytes.
* The third parameter is the receive length, or the number of bytes you're expecting back from the device for this transaction. Maximum receive length is 127, and if it's zero the I2C Adapter Phidget will skip sending the read address and bytes.

This diagram illustrates the data structure when using {{Code|I2CSendReceive}}:

[[Image:I2C_SendRecv.png|link=|850px]]

''''S'''' represents a start condition, while ''''P'''' represents a stop condition. If your I2C device requires data in a different structure than this, you may need to use {{Code|I2CComplexTransaction()}}, as explained in the next section.

=== I2CComplexTransaction() ===

Parameters:
* int '''address'''
* string '''I2CPacketString'''
* byte[ ] '''data'''

This function gives you more control over the read/write structure for more complex interactions. This is useful for longer commands that make use of repeated start conditions.

* The first parameter is the I2C address of your device, usually specified in the datasheet or printed on the circuit board.
* The second parameter is a string that dictates the read/write sequence to follow.
* The third parameter is the data array, whose length must match the number of writes in the string, up to 127 bytes.

The string is made up of the following characters, case-sensitive with no spaces:
* ''''s'''' for a start condition
* ''''R'''' for a read byte
* ''''T'''' for a write byte
* ''''p'''' for a stop condition

Here's an example:

[[Image:I2C_Complex.png|link=|850px]]

Numerals can also be used after a 'T' or 'R' to make the string compact. In this example, the data array would need to have a length of 3, since a total of three bytes are written in the sequence.

I2C Adapter API Guide

2026-04-09T19:44:04Z

Lmpacent: /* Introduction */

I2C Adapter API Guide

2026-04-09T19:43:28Z

Lmpacent: /* Introduction */

{{#seo:|description=Get started with your I2C Adapter Phidget}}
[[Category:IntroGuide]]
<div class="nonumtoc">
<div class="toclimit-4">
== Introduction ==
[[Image:ADP0001_0.jpg|thumb|<center>I2C Adapter Phidget (ADP0001_0)</center>]]
This guide will provide information about the DataAdapter API to get you up and running with your new I2C Adapter Phidget.

Before starting this guide, visit the Quick Start Guide on your Adapter Phidget's product page for information about wiring.

== Address Format ==

The I2C Adapter Phidget interprets the device address as follows:

[[Image:I2C_Addr.png|link=|550px]]

The read/write bit is not included in the hexadecimal value for the address, as this bit is handled by the API calls.
You may find that datasheets for some I2C devices include the read/write bit, so a read-only device like a simple temperature sensor might specify the address as '''0xE3''' instead of '''0x71''' in this case. When using such a sensor, be sure to ignore the R/W bit and shift the remaining seven bits down to get the address you need to send to Phidgets API calls.

== Methods ==
=== I2CSendReceive() ===

Parameters:
* int '''address'''
* byte[ ] '''data'''
* int '''receiveLength'''

This is the main function you'll use for simple read and write operations.

* The first parameter is the I2C address of your device, usually specified in the datasheet or printed on the circuit board.
* The second parameter is the data array, which can contain up to 127 bytes. If the data array is empty, the I2C Adapter Phidget will skip sending the write address and bytes.
* The third parameter is the receive length, or the number of bytes you're expecting back from the device for this transaction. Maximum receive length is 127, and if it's zero the I2C Adapter Phidget will skip sending the read address and bytes.

This diagram illustrates the data structure when using {{Code|I2CSendReceive}}:

[[Image:I2C_SendRecv.png|link=|850px]]

''''S'''' represents a start condition, while ''''P'''' represents a stop condition. If your I2C device requires data in a different structure than this, you may need to use {{Code|I2CComplexTransaction()}}, as explained in the next section.

=== I2CComplexTransaction() ===

Parameters:
* int '''address'''
* string '''I2CPacketString'''
* byte[ ] '''data'''

This function gives you more control over the read/write structure for more complex interactions. This is useful for longer commands that make use of repeated start conditions.

* The first parameter is the I2C address of your device, usually specified in the datasheet or printed on the circuit board.
* The second parameter is a string that dictates the read/write sequence to follow.
* The third parameter is the data array, whose length must match the number of writes in the string, up to 127 bytes.

The string is made up of the following characters, case-sensitive with no spaces:
* ''''s'''' for a start condition
* ''''R'''' for a read byte
* ''''T'''' for a write byte
* ''''p'''' for a stop condition

Here's an example:

[[Image:I2C_Complex.png|link=|850px]]

Numerals can also be used after a 'T' or 'R' to make the string compact. In this example, the data array would need to have a length of 3, since a total of three bytes are written in the sequence.

File:ADP0001 0.jpg

2026-04-09T19:42:20Z

Lmpacent:

Language - Java

2026-04-02T16:40:00Z

Lmpacent: /* Deploying Applications */

{{#seo:|description=Learn how to use Phidget USB devices with Java.}}
[[Category:Language]]

==Get Started==
With the Phidget22 library, it's easy to create Java applications that work with Phidget devices.

==Java Libraries==
During development, we recommend downloading the appropriate installer or package for your [https://www.phidgets.com/docs/Operating_System_Support operating system]. This will place the required Phidget library files in standard locations where Java will look for them. When [[#Deploying Applications|deploying applications]], you can instead include these files manually as part of your application.

====macOS Considerations====
Legacy Phidgets running a HID USB stack require a driver extension (macOS 10.15 and newer) or a kernel extension (macOS 10.14 and earlier). During development, we recommend downloading the appropriate [https://www.phidgets.com/docs/OS_-_macOS#Quick_Downloads package] which will install the extension. When deploying applications, review the README in the [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip macOS Development Files] for information about bundling the extension with your application.

=====Determining USB Stack=====
To determine which USB stack your device is running, navigate to the product page and then to the specification tab, and look for the ''USB Stack'' specification. If you are using a VINT device, navigate to the product page for the VINT Hub you are using.

[[Image:Javascript_networkserver_webusb_spec.png|center|600px|link=https://cdn.phidgets.com/docs/images/8/80/Javascript_networkserver_webusb_spec.png]]

====Linux Considerations====
Linux restricts access to USB devices to the root user. To run your Python application as a regular user, you'll need to [{{SERVER}}/docs/OS_-_Linux#Setting_Udev_Rules set up udev rules] on your system.

==Development Environment Configuration==

Before choosing a development environment, make sure you have the [http://www.oracle.com/technetwork/java/index.html Java Development Kit] installed.

===Visual Studio Code===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
| To start developing with Java in VSCode, open it up and install the '''Extension Pack for Java'''.||[[Image:Language_java_vscode_extension2.png|center|350px|link=https://cdn.phidgets.com/docs/images/b/b4/Language_java_vscode_extension2.png]]
|-
| Next, press '''Ctrl+Shift+P''' to open the command palette, type "java" and select '''Java: Create Java Project'''. || [[Image:Language_java_vscode_createproj.png|center|360px|link=https://cdn.phidgets.com/docs/images/7/78/Language_java_vscode_createproj.png]]
|-
| Select "No Build Tools" and select a directory for the new project. You'll be asked for a project name, and VSCode will create the directory structure. || [[Image:Language_java_vscode_emptyproj.png|center|350px|link=https://cdn.phidgets.com/docs/images/c/c1/Language_java_vscode_emptyproj.png]]
|-
| colspan="2"|You'll need to get a copy of '''phidget22.jar''' to put inside the "lib" folder. [https://www.phidgets.com/downloads/phidget22/libraries/any/Phidget22Java.zip You can download phidget22.jar here].
|-
| colspan="2"| You can now begin writing code in the newly created "App.java" file, or you can download a [[#Example_Code|sample program]] for your device and place it in the "src" folder.
|-
| Compile and run by pressing '''F5''' or by clicking the play button in the top right. || [[Image:Language_java_vscode_run.png|center|350px|link=https://cdn.phidgets.com/docs/images/e/ea/Language_java_vscode_run.png]]
|-
| Once you're ready to compile your project into a .jar executable, click on the '''Java Projects''' section in the explorer. || [[Image:Language_java_vscode_jar.png|center|350px|link=https://cdn.phidgets.com/docs/images/6/65/Language_java_vscode_jar.png]]
|-
| Click on the export icon, and then select your main class and click OK. || [[Image:Language_java_vscode_jar2.png|center|350px|link=https://cdn.phidgets.com/docs/images/7/74/Language_java_vscode_jar2.png]]
|-
| colspan="2"| Now you can run your new .jar file with the following command:
<syntaxhighlight>
java -jar Example.jar
</syntaxhighlight>
|}

===Javac===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
|The easiest way to allow Java to access the Phidgets Java library is to place a copy of '''phidget22.jar''' in the same folder as your .java program. ||[[Image:Language_java_javac_folder.png|center|350px|link=https://cdn.phidgets.com/docs/images/8/89/Language_java_javac_folder.png]]
|-
|[https://www.phidgets.com/downloads/phidget22/libraries/any/Phidget22Java.zip You can download phidget22.jar here].||
|-
|colspan="2"|To run your program, enter the following command in the command prompt or terminal:
<syntaxhighlight>
javac -classpath .;phidget22.jar example.java
</syntaxhighlight>
Then, enter the following command to run the program:
<syntaxhighlight>
java -classpath .;phidget22.jar example
</syntaxhighlight>
||
|-
| colspan="2"| Once you're ready to compile your project into a .jar executable, create a '''manifest.mf''' file with the following contents:
<syntaxhighlight>
Manifest-Version: 1.0
Main-Class: example
Class-Path: phidget22.jar

</syntaxhighlight>
Make sure there's an empty newline at the bottom of the three lines and a space after each colon.
|-
| colspan="2"| Next, create the .jar file with this command:
<syntaxhighlight>
jar cfm example.jar manifest.mf *.class
</syntaxhighlight>
Once the .jar is created, you can execute it with
<syntaxhighlight>
java -jar example.jar
</syntaxhighlight>

|}

===Netbeans===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
|The easiest way to allow Java to access the Phidgets Java library is to place a copy of '''phidget22.jar''' in the same folder as your .java program. ||[[Image:Language_java_javac_folder.png|center|350px|link=https://cdn.phidgets.com/docs/images/8/89/Language_java_javac_folder.png]]
|-
|[https://www.phidgets.com/downloads/phidget22/libraries/any/Phidget22Java.zip You can download phidget22.jar here].||
|-
| To start, open NetBeans and create a new project. Select Java Application and follow the steps as directed by Netbeans.|| [[Image:Windows_netbeans1.jpg|center|350px|link=https://cdn.phidgets.com/docs/images/c/c9/Windows_netbeans1.jpg]]
|-
| Next, add a reference to phidget22.jar by right-clicking on the libraries folder. || [[Image:Windows_netbeans2.jpg|center|350px|link=https://cdn.phidgets.com/docs/images/2/2b/Windows_netbeans2.jpg]]
|-
| Navigate to the folder where you downloaded phidget22.jar, and select it. || [[Image:Windows_netbeans3.jpg|center|350px|link=https://cdn.phidgets.com/docs/images/7/76/Windows_netbeans3.jpg]]
|-
| The project now has access to Phidgets. By default, Netbeans should create an executable .jar file in the '''dist''' folder of the project directory when it's built. If it didn't, go to '''Build -> Packaging''' in the project properties and make sure "Build JAR after compiling" is checked.|| [[Image:Windows_netbeans4.png|center|350px|link=https://cdn.phidgets.com/docs/images/7/78/Windows_netbeans4.png]]
|-
| colspan="2"| You can now run the .jar file from the command prompt with:
<syntaxhighlight>
java -jar phidgetTest.jar
</syntaxhighlight>
|}

===Eclipse===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
| To start, open Eclipse and create a new Java project. Name the project and uncheck the '''create module-info.java file''' box.|| [[Image:java_eclipse_newproj.png|center|350px|link=https://cdn.phidgets.com/docs/images/9/97/Java_eclipse_newproj.png]]
|-
| On the Libraries tab, click Add External JARs and add [https://www.phidgets.com/downloads/phidget22/libraries/any/Phidget22Java.zip phidget22.jar]. to your project as an external jar. Be sure it's being added to the '''Classpath''' and not the module path. || [[Image:java_eclipse_library.png|center|350px|link=https://cdn.phidgets.com/docs/images/1/1b/Java_eclipse_library.png]]
|-
| Create a new Class in your project. || [[Image:java_eclipse_newclass.png|center|350px|link=https://cdn.phidgets.com/docs/images/0/02/Java_eclipse_newclass.png]]
|-
| Name the class, and be sure to check the '''public static void main''' box. Eclipse may require that you add a package name. || [[Image:java_eclipse_newclass2.png|center|350px|link=https://cdn.phidgets.com/docs/images/c/ca/Java_eclipse_newclass2.png]]
|-
| Your project now has access to Phidgets! ||
|-
| Once you're ready to compile your project into a .jar executable, right click on the project in the package explorer and choose '''Export'''. Select '''Runnable JAR file'''. || [[Image:java_eclipse_export.png|center|350px|link=https://cdn.phidgets.com/docs/images/8/8c/Java_eclipse_export.png]]
|-
| Choose the main class and a destination for the .jar file and click finish. || [[Image:java_eclipse_export2.png|center|350px|link=https://cdn.phidgets.com/docs/images/8/8d/Java_eclipse_export2.png]]
|-
| colspan="2"| You can now run the .jar file from the command prompt with:
<syntaxhighlight>
java -jar phidgetTest.jar
</syntaxhighlight>
|}

=== PhidgetSBC Web Interface ===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+'''Instructions'''
|<center>{{#ev:youtube|gZmWvWXICIA|rel=0}}</center>
|}

==Example Code==
Navigate to our [https://www.phidgets.com/?view=code_samples&lang=Java Code Sample Generator] to view and download code samples that are tailored to your specific device.

[[Image:Language_java_codesample.png|center|600px|link=https://cdn.phidgets.com/docs/images/a/af/Language_java_codesample.png]]

===Phidget Programming Basics===
{{PhidgetProgrammingBasicsLink}}

== Deploying Applications ==
The following files are required for your Java application:
* phidget22.jar
* phidget22.dll
* phidget22java.dll

The files can be found in the [https://cdn.phidgets.com/downloads/phidget22/libraries/windows/Phidget22-windevel.zip Development Files]. The .jar file is in lib/java, and the dll files are in lib/c/x64.

Java will look for these files in several locations, including the classpath and the working folder of the project.

==API==
[{{SERVER}}/?view=api&lang=Python Phidget22 API]

Language - Java

2026-04-02T16:38:13Z

Lmpacent: /* Java Libraries */

{{#seo:|description=Learn how to use Phidget USB devices with Java.}}
[[Category:Language]]

==Get Started==
With the Phidget22 library, it's easy to create Java applications that work with Phidget devices.

==Java Libraries==
During development, we recommend downloading the appropriate installer or package for your [https://www.phidgets.com/docs/Operating_System_Support operating system]. This will place the required Phidget library files in standard locations where Java will look for them. When [[#Deploying Applications|deploying applications]], you can instead include these files manually as part of your application.

====macOS Considerations====
Legacy Phidgets running a HID USB stack require a driver extension (macOS 10.15 and newer) or a kernel extension (macOS 10.14 and earlier). During development, we recommend downloading the appropriate [https://www.phidgets.com/docs/OS_-_macOS#Quick_Downloads package] which will install the extension. When deploying applications, review the README in the [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip macOS Development Files] for information about bundling the extension with your application.

=====Determining USB Stack=====
To determine which USB stack your device is running, navigate to the product page and then to the specification tab, and look for the ''USB Stack'' specification. If you are using a VINT device, navigate to the product page for the VINT Hub you are using.

[[Image:Javascript_networkserver_webusb_spec.png|center|600px|link=https://cdn.phidgets.com/docs/images/8/80/Javascript_networkserver_webusb_spec.png]]

====Linux Considerations====
Linux restricts access to USB devices to the root user. To run your Python application as a regular user, you'll need to [{{SERVER}}/docs/OS_-_Linux#Setting_Udev_Rules set up udev rules] on your system.

==Development Environment Configuration==

Before choosing a development environment, make sure you have the [http://www.oracle.com/technetwork/java/index.html Java Development Kit] installed.

===Visual Studio Code===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
| To start developing with Java in VSCode, open it up and install the '''Extension Pack for Java'''.||[[Image:Language_java_vscode_extension2.png|center|350px|link=https://cdn.phidgets.com/docs/images/b/b4/Language_java_vscode_extension2.png]]
|-
| Next, press '''Ctrl+Shift+P''' to open the command palette, type "java" and select '''Java: Create Java Project'''. || [[Image:Language_java_vscode_createproj.png|center|360px|link=https://cdn.phidgets.com/docs/images/7/78/Language_java_vscode_createproj.png]]
|-
| Select "No Build Tools" and select a directory for the new project. You'll be asked for a project name, and VSCode will create the directory structure. || [[Image:Language_java_vscode_emptyproj.png|center|350px|link=https://cdn.phidgets.com/docs/images/c/c1/Language_java_vscode_emptyproj.png]]
|-
| colspan="2"|You'll need to get a copy of '''phidget22.jar''' to put inside the "lib" folder. [https://www.phidgets.com/downloads/phidget22/libraries/any/Phidget22Java.zip You can download phidget22.jar here].
|-
| colspan="2"| You can now begin writing code in the newly created "App.java" file, or you can download a [[#Example_Code|sample program]] for your device and place it in the "src" folder.
|-
| Compile and run by pressing '''F5''' or by clicking the play button in the top right. || [[Image:Language_java_vscode_run.png|center|350px|link=https://cdn.phidgets.com/docs/images/e/ea/Language_java_vscode_run.png]]
|-
| Once you're ready to compile your project into a .jar executable, click on the '''Java Projects''' section in the explorer. || [[Image:Language_java_vscode_jar.png|center|350px|link=https://cdn.phidgets.com/docs/images/6/65/Language_java_vscode_jar.png]]
|-
| Click on the export icon, and then select your main class and click OK. || [[Image:Language_java_vscode_jar2.png|center|350px|link=https://cdn.phidgets.com/docs/images/7/74/Language_java_vscode_jar2.png]]
|-
| colspan="2"| Now you can run your new .jar file with the following command:
<syntaxhighlight>
java -jar Example.jar
</syntaxhighlight>
|}

===Javac===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
|The easiest way to allow Java to access the Phidgets Java library is to place a copy of '''phidget22.jar''' in the same folder as your .java program. ||[[Image:Language_java_javac_folder.png|center|350px|link=https://cdn.phidgets.com/docs/images/8/89/Language_java_javac_folder.png]]
|-
|[https://www.phidgets.com/downloads/phidget22/libraries/any/Phidget22Java.zip You can download phidget22.jar here].||
|-
|colspan="2"|To run your program, enter the following command in the command prompt or terminal:
<syntaxhighlight>
javac -classpath .;phidget22.jar example.java
</syntaxhighlight>
Then, enter the following command to run the program:
<syntaxhighlight>
java -classpath .;phidget22.jar example
</syntaxhighlight>
||
|-
| colspan="2"| Once you're ready to compile your project into a .jar executable, create a '''manifest.mf''' file with the following contents:
<syntaxhighlight>
Manifest-Version: 1.0
Main-Class: example
Class-Path: phidget22.jar

</syntaxhighlight>
Make sure there's an empty newline at the bottom of the three lines and a space after each colon.
|-
| colspan="2"| Next, create the .jar file with this command:
<syntaxhighlight>
jar cfm example.jar manifest.mf *.class
</syntaxhighlight>
Once the .jar is created, you can execute it with
<syntaxhighlight>
java -jar example.jar
</syntaxhighlight>

|}

===Netbeans===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
|The easiest way to allow Java to access the Phidgets Java library is to place a copy of '''phidget22.jar''' in the same folder as your .java program. ||[[Image:Language_java_javac_folder.png|center|350px|link=https://cdn.phidgets.com/docs/images/8/89/Language_java_javac_folder.png]]
|-
|[https://www.phidgets.com/downloads/phidget22/libraries/any/Phidget22Java.zip You can download phidget22.jar here].||
|-
| To start, open NetBeans and create a new project. Select Java Application and follow the steps as directed by Netbeans.|| [[Image:Windows_netbeans1.jpg|center|350px|link=https://cdn.phidgets.com/docs/images/c/c9/Windows_netbeans1.jpg]]
|-
| Next, add a reference to phidget22.jar by right-clicking on the libraries folder. || [[Image:Windows_netbeans2.jpg|center|350px|link=https://cdn.phidgets.com/docs/images/2/2b/Windows_netbeans2.jpg]]
|-
| Navigate to the folder where you downloaded phidget22.jar, and select it. || [[Image:Windows_netbeans3.jpg|center|350px|link=https://cdn.phidgets.com/docs/images/7/76/Windows_netbeans3.jpg]]
|-
| The project now has access to Phidgets. By default, Netbeans should create an executable .jar file in the '''dist''' folder of the project directory when it's built. If it didn't, go to '''Build -> Packaging''' in the project properties and make sure "Build JAR after compiling" is checked.|| [[Image:Windows_netbeans4.png|center|350px|link=https://cdn.phidgets.com/docs/images/7/78/Windows_netbeans4.png]]
|-
| colspan="2"| You can now run the .jar file from the command prompt with:
<syntaxhighlight>
java -jar phidgetTest.jar
</syntaxhighlight>
|}

===Eclipse===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
| To start, open Eclipse and create a new Java project. Name the project and uncheck the '''create module-info.java file''' box.|| [[Image:java_eclipse_newproj.png|center|350px|link=https://cdn.phidgets.com/docs/images/9/97/Java_eclipse_newproj.png]]
|-
| On the Libraries tab, click Add External JARs and add [https://www.phidgets.com/downloads/phidget22/libraries/any/Phidget22Java.zip phidget22.jar]. to your project as an external jar. Be sure it's being added to the '''Classpath''' and not the module path. || [[Image:java_eclipse_library.png|center|350px|link=https://cdn.phidgets.com/docs/images/1/1b/Java_eclipse_library.png]]
|-
| Create a new Class in your project. || [[Image:java_eclipse_newclass.png|center|350px|link=https://cdn.phidgets.com/docs/images/0/02/Java_eclipse_newclass.png]]
|-
| Name the class, and be sure to check the '''public static void main''' box. Eclipse may require that you add a package name. || [[Image:java_eclipse_newclass2.png|center|350px|link=https://cdn.phidgets.com/docs/images/c/ca/Java_eclipse_newclass2.png]]
|-
| Your project now has access to Phidgets! ||
|-
| Once you're ready to compile your project into a .jar executable, right click on the project in the package explorer and choose '''Export'''. Select '''Runnable JAR file'''. || [[Image:java_eclipse_export.png|center|350px|link=https://cdn.phidgets.com/docs/images/8/8c/Java_eclipse_export.png]]
|-
| Choose the main class and a destination for the .jar file and click finish. || [[Image:java_eclipse_export2.png|center|350px|link=https://cdn.phidgets.com/docs/images/8/8d/Java_eclipse_export2.png]]
|-
| colspan="2"| You can now run the .jar file from the command prompt with:
<syntaxhighlight>
java -jar phidgetTest.jar
</syntaxhighlight>
|}

=== PhidgetSBC Web Interface ===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+'''Instructions'''
|<center>{{#ev:youtube|gZmWvWXICIA|rel=0}}</center>
|}

==Example Code==
Navigate to our [https://www.phidgets.com/?view=code_samples&lang=Java Code Sample Generator] to view and download code samples that are tailored to your specific device.

[[Image:Language_java_codesample.png|center|600px|link=https://cdn.phidgets.com/docs/images/a/af/Language_java_codesample.png]]

===Phidget Programming Basics===
{{PhidgetProgrammingBasicsLink}}

== Deploying Applications ==

If you're planning to deploy your application, it should be noted that you don't strictly need the Phidget Drivers installed.

At a minimum, these three files are required:
* phidget22.jar
* phidget22.dll
* phidget22java.dll

All three files can be found in the [https://cdn.phidgets.com/downloads/phidget22/libraries/windows/Phidget22-windevel.zip Development Files]. The .jar file is in lib/java, and the .dll files are in lib/c/x64.

Java will look for these files in several locations, including the classpath and the working folder of the project.

==API==
[{{SERVER}}/?view=api&lang=Python Phidget22 API]

Language - Java

2026-04-02T16:37:19Z

Lmpacent: /* Java Libraries */

{{#seo:|description=Learn how to use Phidget USB devices with Java.}}
[[Category:Language]]

==Get Started==
With the Phidget22 library, it's easy to create Java applications that work with Phidget devices.

==Java Libraries==
During development, we recommend downloading the appropriate installer or package for your [https://www.phidgets.com/docs/Operating_System_Support operating system]. This will put required Phidget library files in standard locations where Java will look for them. When [[#Deploying Applications|deploying applications]], you can manually include these files yourself as part of your application.

====macOS Considerations====
Legacy Phidgets running a HID USB stack require a driver extension (macOS 10.15 and newer) or a kernel extension (macOS 10.14 and earlier). During development, we recommend downloading the appropriate [https://www.phidgets.com/docs/OS_-_macOS#Quick_Downloads package] which will install the extension. When deploying applications, review the README in the [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip macOS Development Files] for information about bundling the extension with your application.

=====Determining USB Stack=====
To determine which USB stack your device is running, navigate to the product page and then to the specification tab, and look for the ''USB Stack'' specification. If you are using a VINT device, navigate to the product page for the VINT Hub you are using.

[[Image:Javascript_networkserver_webusb_spec.png|center|600px|link=https://cdn.phidgets.com/docs/images/8/80/Javascript_networkserver_webusb_spec.png]]

====Linux Considerations====
Linux restricts access to USB devices to the root user. To run your Python application as a regular user, you'll need to [{{SERVER}}/docs/OS_-_Linux#Setting_Udev_Rules set up udev rules] on your system.

==Development Environment Configuration==

Before choosing a development environment, make sure you have the [http://www.oracle.com/technetwork/java/index.html Java Development Kit] installed.

===Visual Studio Code===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
| To start developing with Java in VSCode, open it up and install the '''Extension Pack for Java'''.||[[Image:Language_java_vscode_extension2.png|center|350px|link=https://cdn.phidgets.com/docs/images/b/b4/Language_java_vscode_extension2.png]]
|-
| Next, press '''Ctrl+Shift+P''' to open the command palette, type "java" and select '''Java: Create Java Project'''. || [[Image:Language_java_vscode_createproj.png|center|360px|link=https://cdn.phidgets.com/docs/images/7/78/Language_java_vscode_createproj.png]]
|-
| Select "No Build Tools" and select a directory for the new project. You'll be asked for a project name, and VSCode will create the directory structure. || [[Image:Language_java_vscode_emptyproj.png|center|350px|link=https://cdn.phidgets.com/docs/images/c/c1/Language_java_vscode_emptyproj.png]]
|-
| colspan="2"|You'll need to get a copy of '''phidget22.jar''' to put inside the "lib" folder. [https://www.phidgets.com/downloads/phidget22/libraries/any/Phidget22Java.zip You can download phidget22.jar here].
|-
| colspan="2"| You can now begin writing code in the newly created "App.java" file, or you can download a [[#Example_Code|sample program]] for your device and place it in the "src" folder.
|-
| Compile and run by pressing '''F5''' or by clicking the play button in the top right. || [[Image:Language_java_vscode_run.png|center|350px|link=https://cdn.phidgets.com/docs/images/e/ea/Language_java_vscode_run.png]]
|-
| Once you're ready to compile your project into a .jar executable, click on the '''Java Projects''' section in the explorer. || [[Image:Language_java_vscode_jar.png|center|350px|link=https://cdn.phidgets.com/docs/images/6/65/Language_java_vscode_jar.png]]
|-
| Click on the export icon, and then select your main class and click OK. || [[Image:Language_java_vscode_jar2.png|center|350px|link=https://cdn.phidgets.com/docs/images/7/74/Language_java_vscode_jar2.png]]
|-
| colspan="2"| Now you can run your new .jar file with the following command:
<syntaxhighlight>
java -jar Example.jar
</syntaxhighlight>
|}

===Javac===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
|The easiest way to allow Java to access the Phidgets Java library is to place a copy of '''phidget22.jar''' in the same folder as your .java program. ||[[Image:Language_java_javac_folder.png|center|350px|link=https://cdn.phidgets.com/docs/images/8/89/Language_java_javac_folder.png]]
|-
|[https://www.phidgets.com/downloads/phidget22/libraries/any/Phidget22Java.zip You can download phidget22.jar here].||
|-
|colspan="2"|To run your program, enter the following command in the command prompt or terminal:
<syntaxhighlight>
javac -classpath .;phidget22.jar example.java
</syntaxhighlight>
Then, enter the following command to run the program:
<syntaxhighlight>
java -classpath .;phidget22.jar example
</syntaxhighlight>
||
|-
| colspan="2"| Once you're ready to compile your project into a .jar executable, create a '''manifest.mf''' file with the following contents:
<syntaxhighlight>
Manifest-Version: 1.0
Main-Class: example
Class-Path: phidget22.jar

</syntaxhighlight>
Make sure there's an empty newline at the bottom of the three lines and a space after each colon.
|-
| colspan="2"| Next, create the .jar file with this command:
<syntaxhighlight>
jar cfm example.jar manifest.mf *.class
</syntaxhighlight>
Once the .jar is created, you can execute it with
<syntaxhighlight>
java -jar example.jar
</syntaxhighlight>

|}

===Netbeans===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
|The easiest way to allow Java to access the Phidgets Java library is to place a copy of '''phidget22.jar''' in the same folder as your .java program. ||[[Image:Language_java_javac_folder.png|center|350px|link=https://cdn.phidgets.com/docs/images/8/89/Language_java_javac_folder.png]]
|-
|[https://www.phidgets.com/downloads/phidget22/libraries/any/Phidget22Java.zip You can download phidget22.jar here].||
|-
| To start, open NetBeans and create a new project. Select Java Application and follow the steps as directed by Netbeans.|| [[Image:Windows_netbeans1.jpg|center|350px|link=https://cdn.phidgets.com/docs/images/c/c9/Windows_netbeans1.jpg]]
|-
| Next, add a reference to phidget22.jar by right-clicking on the libraries folder. || [[Image:Windows_netbeans2.jpg|center|350px|link=https://cdn.phidgets.com/docs/images/2/2b/Windows_netbeans2.jpg]]
|-
| Navigate to the folder where you downloaded phidget22.jar, and select it. || [[Image:Windows_netbeans3.jpg|center|350px|link=https://cdn.phidgets.com/docs/images/7/76/Windows_netbeans3.jpg]]
|-
| The project now has access to Phidgets. By default, Netbeans should create an executable .jar file in the '''dist''' folder of the project directory when it's built. If it didn't, go to '''Build -> Packaging''' in the project properties and make sure "Build JAR after compiling" is checked.|| [[Image:Windows_netbeans4.png|center|350px|link=https://cdn.phidgets.com/docs/images/7/78/Windows_netbeans4.png]]
|-
| colspan="2"| You can now run the .jar file from the command prompt with:
<syntaxhighlight>
java -jar phidgetTest.jar
</syntaxhighlight>
|}

===Eclipse===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
| To start, open Eclipse and create a new Java project. Name the project and uncheck the '''create module-info.java file''' box.|| [[Image:java_eclipse_newproj.png|center|350px|link=https://cdn.phidgets.com/docs/images/9/97/Java_eclipse_newproj.png]]
|-
| On the Libraries tab, click Add External JARs and add [https://www.phidgets.com/downloads/phidget22/libraries/any/Phidget22Java.zip phidget22.jar]. to your project as an external jar. Be sure it's being added to the '''Classpath''' and not the module path. || [[Image:java_eclipse_library.png|center|350px|link=https://cdn.phidgets.com/docs/images/1/1b/Java_eclipse_library.png]]
|-
| Create a new Class in your project. || [[Image:java_eclipse_newclass.png|center|350px|link=https://cdn.phidgets.com/docs/images/0/02/Java_eclipse_newclass.png]]
|-
| Name the class, and be sure to check the '''public static void main''' box. Eclipse may require that you add a package name. || [[Image:java_eclipse_newclass2.png|center|350px|link=https://cdn.phidgets.com/docs/images/c/ca/Java_eclipse_newclass2.png]]
|-
| Your project now has access to Phidgets! ||
|-
| Once you're ready to compile your project into a .jar executable, right click on the project in the package explorer and choose '''Export'''. Select '''Runnable JAR file'''. || [[Image:java_eclipse_export.png|center|350px|link=https://cdn.phidgets.com/docs/images/8/8c/Java_eclipse_export.png]]
|-
| Choose the main class and a destination for the .jar file and click finish. || [[Image:java_eclipse_export2.png|center|350px|link=https://cdn.phidgets.com/docs/images/8/8d/Java_eclipse_export2.png]]
|-
| colspan="2"| You can now run the .jar file from the command prompt with:
<syntaxhighlight>
java -jar phidgetTest.jar
</syntaxhighlight>
|}

=== PhidgetSBC Web Interface ===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+'''Instructions'''
|<center>{{#ev:youtube|gZmWvWXICIA|rel=0}}</center>
|}

==Example Code==
Navigate to our [https://www.phidgets.com/?view=code_samples&lang=Java Code Sample Generator] to view and download code samples that are tailored to your specific device.

[[Image:Language_java_codesample.png|center|600px|link=https://cdn.phidgets.com/docs/images/a/af/Language_java_codesample.png]]

===Phidget Programming Basics===
{{PhidgetProgrammingBasicsLink}}

== Deploying Applications ==

If you're planning to deploy your application, it should be noted that you don't strictly need the Phidget Drivers installed.

At a minimum, these three files are required:
* phidget22.jar
* phidget22.dll
* phidget22java.dll

All three files can be found in the [https://cdn.phidgets.com/downloads/phidget22/libraries/windows/Phidget22-windevel.zip Development Files]. The .jar file is in lib/java, and the .dll files are in lib/c/x64.

Java will look for these files in several locations, including the classpath and the working folder of the project.

==API==
[{{SERVER}}/?view=api&lang=Python Phidget22 API]

Language - Java

2026-04-02T16:11:15Z

Lmpacent:

{{#seo:|description=Learn how to use Phidget USB devices with Java.}}
[[Category:Language]]

==Get Started==
With the Phidget22 library, it's easy to create Java applications that work with Phidget devices.

==Java Libraries==

We recommend installing the [https://www.phidgets.com/docs/Operating_System_Support Phidget drivers] for your operating system. Installing the drivers will put required .dll files in the proper place where Java will look for them. If you want to run your application on a computer without installing our drivers, see the [[#Deploying Applications|Deploying Applications]] section.

====macOS Considerations====
Legacy Phidgets running a HID USB stack require a driver extension (macOS 10.15 and newer) or a kernel extension (macOS 10.14 and earlier). During development, we recommend downloading the appropriate [https://www.phidgets.com/docs/OS_-_macOS#Quick_Downloads package] which will install the extension. When deploying applications, review the README in the [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip macOS Development Files] for information about bundling the extension with your application.

=====Determining USB Stack=====
To determine which USB stack your device is running, navigate to the product page and then to the specification tab, and look for the ''USB Stack'' specification. If you are using a VINT device, navigate to the product page for the VINT Hub you are using.

[[Image:Javascript_networkserver_webusb_spec.png|center|600px|link=https://cdn.phidgets.com/docs/images/8/80/Javascript_networkserver_webusb_spec.png]]

====Linux Considerations====
Linux restricts access to USB devices to the root user. To run your Python application as a regular user, you'll need to [{{SERVER}}/docs/OS_-_Linux#Setting_Udev_Rules set up udev rules] on your system.

==Development Environment Configuration==

Before choosing a development environment, make sure you have the [http://www.oracle.com/technetwork/java/index.html Java Development Kit] installed.

===Visual Studio Code===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
| To start developing with Java in VSCode, open it up and install the '''Extension Pack for Java'''.||[[Image:Language_java_vscode_extension2.png|center|350px|link=https://cdn.phidgets.com/docs/images/b/b4/Language_java_vscode_extension2.png]]
|-
| Next, press '''Ctrl+Shift+P''' to open the command palette, type "java" and select '''Java: Create Java Project'''. || [[Image:Language_java_vscode_createproj.png|center|360px|link=https://cdn.phidgets.com/docs/images/7/78/Language_java_vscode_createproj.png]]
|-
| Select "No Build Tools" and select a directory for the new project. You'll be asked for a project name, and VSCode will create the directory structure. || [[Image:Language_java_vscode_emptyproj.png|center|350px|link=https://cdn.phidgets.com/docs/images/c/c1/Language_java_vscode_emptyproj.png]]
|-
| colspan="2"|You'll need to get a copy of '''phidget22.jar''' to put inside the "lib" folder. [https://www.phidgets.com/downloads/phidget22/libraries/any/Phidget22Java.zip You can download phidget22.jar here].
|-
| colspan="2"| You can now begin writing code in the newly created "App.java" file, or you can download a [[#Example_Code|sample program]] for your device and place it in the "src" folder.
|-
| Compile and run by pressing '''F5''' or by clicking the play button in the top right. || [[Image:Language_java_vscode_run.png|center|350px|link=https://cdn.phidgets.com/docs/images/e/ea/Language_java_vscode_run.png]]
|-
| Once you're ready to compile your project into a .jar executable, click on the '''Java Projects''' section in the explorer. || [[Image:Language_java_vscode_jar.png|center|350px|link=https://cdn.phidgets.com/docs/images/6/65/Language_java_vscode_jar.png]]
|-
| Click on the export icon, and then select your main class and click OK. || [[Image:Language_java_vscode_jar2.png|center|350px|link=https://cdn.phidgets.com/docs/images/7/74/Language_java_vscode_jar2.png]]
|-
| colspan="2"| Now you can run your new .jar file with the following command:
<syntaxhighlight>
java -jar Example.jar
</syntaxhighlight>
|}

===Javac===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
|The easiest way to allow Java to access the Phidgets Java library is to place a copy of '''phidget22.jar''' in the same folder as your .java program. ||[[Image:Language_java_javac_folder.png|center|350px|link=https://cdn.phidgets.com/docs/images/8/89/Language_java_javac_folder.png]]
|-
|[https://www.phidgets.com/downloads/phidget22/libraries/any/Phidget22Java.zip You can download phidget22.jar here].||
|-
|colspan="2"|To run your program, enter the following command in the command prompt or terminal:
<syntaxhighlight>
javac -classpath .;phidget22.jar example.java
</syntaxhighlight>
Then, enter the following command to run the program:
<syntaxhighlight>
java -classpath .;phidget22.jar example
</syntaxhighlight>
||
|-
| colspan="2"| Once you're ready to compile your project into a .jar executable, create a '''manifest.mf''' file with the following contents:
<syntaxhighlight>
Manifest-Version: 1.0
Main-Class: example
Class-Path: phidget22.jar

</syntaxhighlight>
Make sure there's an empty newline at the bottom of the three lines and a space after each colon.
|-
| colspan="2"| Next, create the .jar file with this command:
<syntaxhighlight>
jar cfm example.jar manifest.mf *.class
</syntaxhighlight>
Once the .jar is created, you can execute it with
<syntaxhighlight>
java -jar example.jar
</syntaxhighlight>

|}

===Netbeans===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
|The easiest way to allow Java to access the Phidgets Java library is to place a copy of '''phidget22.jar''' in the same folder as your .java program. ||[[Image:Language_java_javac_folder.png|center|350px|link=https://cdn.phidgets.com/docs/images/8/89/Language_java_javac_folder.png]]
|-
|[https://www.phidgets.com/downloads/phidget22/libraries/any/Phidget22Java.zip You can download phidget22.jar here].||
|-
| To start, open NetBeans and create a new project. Select Java Application and follow the steps as directed by Netbeans.|| [[Image:Windows_netbeans1.jpg|center|350px|link=https://cdn.phidgets.com/docs/images/c/c9/Windows_netbeans1.jpg]]
|-
| Next, add a reference to phidget22.jar by right-clicking on the libraries folder. || [[Image:Windows_netbeans2.jpg|center|350px|link=https://cdn.phidgets.com/docs/images/2/2b/Windows_netbeans2.jpg]]
|-
| Navigate to the folder where you downloaded phidget22.jar, and select it. || [[Image:Windows_netbeans3.jpg|center|350px|link=https://cdn.phidgets.com/docs/images/7/76/Windows_netbeans3.jpg]]
|-
| The project now has access to Phidgets. By default, Netbeans should create an executable .jar file in the '''dist''' folder of the project directory when it's built. If it didn't, go to '''Build -> Packaging''' in the project properties and make sure "Build JAR after compiling" is checked.|| [[Image:Windows_netbeans4.png|center|350px|link=https://cdn.phidgets.com/docs/images/7/78/Windows_netbeans4.png]]
|-
| colspan="2"| You can now run the .jar file from the command prompt with:
<syntaxhighlight>
java -jar phidgetTest.jar
</syntaxhighlight>
|}

===Eclipse===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
| To start, open Eclipse and create a new Java project. Name the project and uncheck the '''create module-info.java file''' box.|| [[Image:java_eclipse_newproj.png|center|350px|link=https://cdn.phidgets.com/docs/images/9/97/Java_eclipse_newproj.png]]
|-
| On the Libraries tab, click Add External JARs and add [https://www.phidgets.com/downloads/phidget22/libraries/any/Phidget22Java.zip phidget22.jar]. to your project as an external jar. Be sure it's being added to the '''Classpath''' and not the module path. || [[Image:java_eclipse_library.png|center|350px|link=https://cdn.phidgets.com/docs/images/1/1b/Java_eclipse_library.png]]
|-
| Create a new Class in your project. || [[Image:java_eclipse_newclass.png|center|350px|link=https://cdn.phidgets.com/docs/images/0/02/Java_eclipse_newclass.png]]
|-
| Name the class, and be sure to check the '''public static void main''' box. Eclipse may require that you add a package name. || [[Image:java_eclipse_newclass2.png|center|350px|link=https://cdn.phidgets.com/docs/images/c/ca/Java_eclipse_newclass2.png]]
|-
| Your project now has access to Phidgets! ||
|-
| Once you're ready to compile your project into a .jar executable, right click on the project in the package explorer and choose '''Export'''. Select '''Runnable JAR file'''. || [[Image:java_eclipse_export.png|center|350px|link=https://cdn.phidgets.com/docs/images/8/8c/Java_eclipse_export.png]]
|-
| Choose the main class and a destination for the .jar file and click finish. || [[Image:java_eclipse_export2.png|center|350px|link=https://cdn.phidgets.com/docs/images/8/8d/Java_eclipse_export2.png]]
|-
| colspan="2"| You can now run the .jar file from the command prompt with:
<syntaxhighlight>
java -jar phidgetTest.jar
</syntaxhighlight>
|}

=== PhidgetSBC Web Interface ===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+'''Instructions'''
|<center>{{#ev:youtube|gZmWvWXICIA|rel=0}}</center>
|}

==Example Code==
Navigate to our [https://www.phidgets.com/?view=code_samples&lang=Java Code Sample Generator] to view and download code samples that are tailored to your specific device.

[[Image:Language_java_codesample.png|center|600px|link=https://cdn.phidgets.com/docs/images/a/af/Language_java_codesample.png]]

===Phidget Programming Basics===
{{PhidgetProgrammingBasicsLink}}

== Deploying Applications ==

If you're planning to deploy your application, it should be noted that you don't strictly need the Phidget Drivers installed.

At a minimum, these three files are required:
* phidget22.jar
* phidget22.dll
* phidget22java.dll

All three files can be found in the [https://cdn.phidgets.com/downloads/phidget22/libraries/windows/Phidget22-windevel.zip Development Files]. The .jar file is in lib/java, and the .dll files are in lib/c/x64.

Java will look for these files in several locations, including the classpath and the working folder of the project.

==API==
[{{SERVER}}/?view=api&lang=Python Phidget22 API]

Terms and Conditions

2026-03-13T01:39:25Z

Lmpacent: /* Holidays */

[[Category:Linked From Website]]

==Product Warranty==

All Phidgets products are warranted to be free of defects in material or workmanship under normal use and service for a period of one year from the date of shipment. This warranty does not include damage resulting from accident or misuse. The warranty is also void if the product is modified. This warranty is in lieu of all other warranties expressed or implied including the implied warranties of merchantability of fitness for a particular purpose, whether arising by law, custom or conduct, and the rights and remedies provided under this warranty are exclusive and in lieu of any other rights or remedies. In no event shall Phidgets Incorporated be liable for consequential damages.

If you believe that your product is defective while still under warranty, {{ContactUs|contact us}}. Once the support desk confirms that the product is defective, we will replace your defective product free of charge.

==Shipping==
===Last Call at 12:00PM===
Orders received before 12:00 PM Mountain Time (GMT-07:00) Monday to Friday will be shipped the same day.

Orders containing cut-to-length parts may not ship on the same day due to the additional processing time associated with these orders.

===Shipping Costs===
Shipping costs are calculated at checkout and presented for your review before you confirm your order. If multiple shipping options are available for your destination, all options will be listed so you can choose the one that best suits your needs.

If you have your own UPS or FedEx account, you can use it at checkout and be billed directly by the carrier. This gives you access to a wider range of shipping options.

Note that a $5.00 handling charge is added to all orders that are under $50.00.

===Shipping in Canada===
We offer the following services:
* '''UPS Express Saver'''. 1 - 3 business days.
* '''UPS Expedited'''. 2 - 5 business days. Available for packages over 3 lbs.
* '''UPS Standard'''. 3 - 5 business days ground delivery.

===Shipping to the United States===
We offer the following services:
* '''UPS Express Saver'''. 1 - 3 business days.
* '''UPS Expedited'''. 2 - 5 business days. Available for packages over 3 lbs.
* '''UPS Standard'''. 3 - 5 business days ground delivery.

Effective May 2, 2025, orders shipped to the United States will incur additional duties, tariffs, and brokerage fees, regardless of the order value. For more details, visit our guide about [[U.S._Tariffs | U.S. Tariffs]].

===International Shipments===
We offer the following services:
* '''UPS Worldwide Express Saver'''. 1 - 3 business days.
* '''UPS Worldwide Expedited'''. 2 - 5 business days. Available for packages over 3 lbs.

====European Union====
Effective July 1, 2021, the European Union (EU) updated its Value Added Tax (VAT) regulations. All shipments to EU countries now require formal customs clearance and are subject to VAT based on the destination country.

For goods with an intrinsic value up to €150, VAT must be collected at the time of purchase. This means for orders under $200 USD, we require prepayment of VAT and brokerage fees at checkout to ensure fast, hassle-free delivery.

For orders over $200 USD, we provide the option to prepay all applicable import fees (including VAT and brokerage). If you choose this option, the quoted amount is guaranteed — there will be no additional charges upon delivery.

We use UPS® Global Checkout to collect import fees and taxes based on your product's HS Code and Country of Origin. There is a fee associated with the UPS® Global Checkout service. At Phidgets Inc., we continually monitor and negotiate all fees to ensure our customers receive the best deal possible.

Customs policies vary by country, so we recommend contacting your local customs office for more information.

====Other Countries====
International shipments may be subject to import duties, taxes, and brokerage fees upon arrival in your country. These charges are determined by your local customs authorities and are the responsibility of the recipient.

At checkout, we provide the option to prepay these fees. If you choose this option, the quoted amount is guaranteed — there will be no additional charges upon delivery.

We use UPS® Global Checkout to collect import fees and taxes based on your product's HS Code and Country of Origin. There is a fee associated with the UPS® Global Checkout service. At Phidgets Inc., we continually monitor and negotiate all fees to ensure our customers receive the best deal possible.

Customs policies vary by country, so we recommend contacting your local customs office for more information.

===Tracking Your Order===
You can track your shipment using the tracking number sent to you by email when your order was shipped.

===Refunds on Late Deliveries===

Normally, UPS will offer a service guarantee refund when their deliveries arrive late. However, for companies that apply for shipping discounts, this refund does not apply. Phidgets Inc. has applied for such discounts in order to keep shipping costs down and regrettably cannot offer compensation for late shipments.

===Damaged or Lost Shipment===

'''Shipping on our UPS account''' - Report all damaged or lost shipments to support@phidgets.com and include your order number. According to UPS, in order to be considered lost, a package must be undelivered 24 hours after the expected delivery date and time. Before contacting us, check your shipment status at ups.ca.

Damaged or lost items will be replaced at no charge (including shipping costs).

'''Shipping on your UPS account''' - You must notify your local UPS office. If they confirm that they have lost your shipment, you must repurchase the lost or damaged products from Phidgets and file a claim with your local UPS in order to get reimbursed.

===Refused/Missed Delivery===
If no one is available to accept the package upon delivery, UPS will attempt redelivery two more times, as per their standard procedure. If all delivery attempts fail, UPS will hold the package for 5 days before returning it to us. In such cases, we will issue a refund for your order minus the cost of shipping (both directions) and a flat $50 fee, up to the total value of the package. This policy applies both to deliveries that failed due to no one being present and to packages that were refused at the delivery address.

===Incoterms===

We use the following Incoterms depending on the shipping and payment arrangement:

* '''FCA (Free Carrier):''' Used when shipping on the customer’s carrier account. Risk and responsibility transfer to the customer once the goods are handed over to the carrier at our facility.

* '''DDP (Delivered Duty Paid):''' Used when the customer chooses to pre-pay import fees and taxes at checkout. We handle all import fees and deliver the goods to the destination address.

* '''DAP (Delivered at Place):''' Used when the customer opts to pay import fees and taxes upon delivery. We deliver the goods, but the customer is responsible for paying any import fees directly to the carrier.

==Product Returns==
===All Returns Must Be Authorized===
Before returning a package {{ContactUs|contact us}} and ask for a Return Merchandise Authorization or RMA number. Once you have received it, put the RMA number on the outside of the packaging as well as the packing slip so that it is possible for us to track what the package is supposed to be. Any merchandise returned without an RMA number clearly visible on the packaging will be charged an administrative fee of $25.00 or the value of the returned product, whichever is less ''if we are able to determine what it is''. In the event we are unable to determine what the package is, it will be refused and returned to the sender.

===Unopened Product===
Phidgets accepts returns of unopened products within 30 days of the date of purchase. To initiate a return, please contact us by phone or email to obtain an RMA number. Products must be shipped back to Phidgets Inc. prepaid. A refund will be issued to your credit card once we receive and inspect the returned items. The refund excludes the cost of shipping as well as any duties or brokerage charges incurred.

Returns received after 30 days are subject to a restocking fee of 25% of the package's value (minimum $5.00, maximum $500).

We do '''not''' accept returns beyond 90 days from the date of purchase.

===Cut to Length===
Unfortunately we cannot accept returns on any items which are cut to custom lengths. This includes: cable, wire, roller chain, linear shaft, rotary shaft, and t-slot extrusions.

===We Shipped the Wrong/Incomplete Product===
{{ContactUs|Contact us}}. We will get the correct product sent to you immediately, and will pay all shipping charges.

==Payment Terms==
We accept credit cards, PayPal, and Wire Transfers.

{| style="border:1px solid darkgray;" cellpadding="7px;"
|-style="background: #d1d1d1" align=center
! Payment Method|| Terms
|-
|style="background: #f0f0f0" align=center|Credit Cards
|style="background: #f0f0f0" align=left|Visa, MasterCard, American Express (for order in CAD only)
|-
|style="background: #f0f0f0" align=center|PayPal
|style="background: #f0f0f0" align=left|PayPal is accepted. There are no extra fees for using PayPal
|-
|style="background: #f0f0f0" align=center|Wire Transfers
|style="background: #f0f0f0" align=left|Wire transfers are only accepted for orders over $200.00 USD (excluding shipping charges). There is a $25.00 USD charge for wire transfers under $500.00 USD. Any fees charged by the sending bank are your responsibility.<br />Please make sure that the amount sent to us covers both our invoice and your bank fees. Products are not shipped until the money is deposited in our bank account. We recommend that you e-mail orders@phidgets.com with the amount of the transfer and the invoice you are paying. <br />Any order for which payment is not received within 15 days, will be canceled.
|}

==Security and Privacy==
Phidgets Inc. pledges a safe and worry-free shopping experience. IF you are using the current version of Internet Explorer, on the checkout page where you enter your credit card information, you will notice a a locked padlock icon on the top bar your browser window. If you are using Mozilla Firefox, you will notice a locked padlock icon in the bottom right corner of your browser window. If this icon does not appear, please contact us directly to complete your purchase. These icons tell you that the page you are on is secure. We use Secure Sockets Layer (SSL 128-bit) technology with a digital certificate by GeoTrust, Inc. for Internet security to protect your personal information. This encryption makes it impossible for anyone to read your information in transit. We do not store your credit information and it is deleted once it has been securely transmitted to Moneris for processing.

We use your e-mail address to let you know your shipment's tracking number. Your phone number is required by the Courier Company. We do not sell, rent or give any of your personal information to any unrelated third parties with the exception of Moneris for authorizing credit card payments and the Courier company to let them know where to deliver the shipment and how to contact you if there is any problems.

If you have any questions or concerns about our Security and Privacy policy, call us at 1.403.282.7335 or e-mail us at support@phidgets.com

Phidgets Inc. uses various Google Analytics tools such as conversion tracking in order to improve the effectiveness of the website. These statistics are completely anonymous.

==Holidays==
Phidgets, Inc. will be closed on the following days. During these times, the site will still be accessible and orders can be placed, but they will not ship until the next business day.

{| style="border:1px solid darkgray;" cellpadding="7px;"
|-style="background: #d1d1d1" align=center
! style="text-align:center;"| Holiday
! style="text-align:center;"| Description
! style="text-align:center;"| 2026
! style="text-align:center;"| 2027
|-
|style="background: #f0f0f0" align=center| Alberta Family Day
|style="background: #f0f0f0" align=center| Third Monday in February
|style="background: #f0f0f0" align=center| Feb 16
|style="background: #f0f0f0" align=center| Feb 15
|-
|style="background: #f0f0f0" align=center| Good Friday
|style="background: #f0f0f0" align=center| Friday before Easter Sunday
|style="background: #f0f0f0" align=center| Apr 3
|style="background: #f0f0f0" align=center| Mar 26
|-
|style="background: #f0f0f0" align=center| Victoria Day
|style="background: #f0f0f0" align=center| Monday before May 25
|style="background: #f0f0f0" align=center| May 18
|style="background: #f0f0f0" align=center| May 24
|-
|style="background: #f0f0f0" align=center| Canada Day
|style="background: #f0f0f0" align=center| First day of July (or nearest business day)
|style="background: #f0f0f0" align=center| Jul 1
|style="background: #f0f0f0" align=center| Jul 1
|-
|style="background: #f0f0f0" align=center| Civic Holiday
|style="background: #f0f0f0" align=center| First Monday in August
|style="background: #f0f0f0" align=center| Aug 3
|style="background: #f0f0f0" align=center| Aug 2
|-
|style="background: #f0f0f0" align=center| Labour Day
|style="background: #f0f0f0" align=center| First Monday in September
|style="background: #f0f0f0" align=center| Sept 7
|style="background: #f0f0f0" align=center| Sept 6
|-
|style="background: #f0f0f0" align=center| Thanksgiving
|style="background: #f0f0f0" align=center| Second Monday in October
|style="background: #f0f0f0" align=center| Oct 12
|style="background: #f0f0f0" align=center| Oct 11
|-
|style="background: #f0f0f0" align=center| Remembrance Day
|style="background: #f0f0f0" align=center| November 11 (or nearest business day)
|style="background: #f0f0f0" align=center| Nov 11
|style="background: #f0f0f0" align=center| Nov 11
|-
|style="background: #f0f0f0" align=center| Christmas and New Years
|style="background: #f0f0f0" align=center| Varies
|style="background: #f0f0f0" align=center| TBA
|style="background: #f0f0f0" align=center| TBA
|-
|}

Language - C Sharp

2026-03-06T17:00:43Z

Lmpacent: /* macOS Considerations */

{{#seo:|description=Learn how to use Phidget USB devices with C#.}}
[[Category:Language]]

==Get Started==
With the Phidget22.NET library, it's easy to create C# applications that work with Phidget devices.

==C# Libraries==
===Nuget Package===
The Phidget22.NET library is available as a [https://www.nuget.org/packages/Phidget22.NET/ nuget package]. This is the recommend way to install and manage the Phidget22.NET library.

====macOS Considerations====
Legacy Phidgets running a HID USB stack require a driver extension (macOS 10.15 and newer) or a kernel extension (macOS 10.14 and earlier). During development, we recommend downloading the appropriate [https://www.phidgets.com/docs/OS_-_macOS#Quick_Downloads package] which will install the extension. When deploying applications, review the README in the [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip macOS Development Files] for information about bundling the extension with your application.

=====Determining USB Stack=====
To determine which USB stack your device is running, navigate to the product page and then to the specification tab, and look for the ''USB Stack'' specification. If you are using a VINT device, navigate to the product page for the VINT Hub you are using.

[[Image:Javascript_networkserver_webusb_spec.png|center|600px|link=https://cdn.phidgets.com/docs/images/8/80/Javascript_networkserver_webusb_spec.png]]

====Linux Considerations====
Linux restricts access to USB devices to the root user. To run your .NET application as a regular user, you'll need to [{{SERVER}}/docs/OS_-_Linux#Setting_udev_Rules set up udev rules] on your system.

===Library Files===
If you would like to manually manage the Phidget22.NET library files, you can download them [https://cdn.phidgets.com/downloads/phidget22/libraries/windows/Phidget22-windevel.zip here].

==Development Environment Configuration==
===Visual Studio===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
| Create your Visual Studio project, and navigate to the '''Solution Explorer'''. From there, right-click on '''Dependencies''' and select '''Manage NuGet Packages...'''|| [[Image:Language_csharp_vs_managenuget.png|center|350px|link=https://cdn.phidgets.com/docs/images/c/cc/Language_csharp_vs_managenuget.png]]
|-
| Next, click '''Browse''' and enter '''Phidget22.NET''' in the search bar. || [[Image:Language_csharp_vs_browsenuget.png|center|350px|link=https://cdn.phidgets.com/docs/images/6/61/Language_csharp_vs_browsenuget.png]]
|-
| Click on the package and press the '''Install''' button. || [[Image:Language_csharp_vs_installnuget.png|center|350px|link=https://cdn.phidgets.com/docs/images/b/b8/Language_csharp_vs_installnuget.png]]
|-
| Finally, add your C# code and run it using the button at the top of the screen. || [[Image:Language_csharp_vs_run.png|center|350px|link=https://cdn.phidgets.com/docs/images/5/5a/Language_csharp_vs_run.png]]
|-
|}

===Visual Studio Code===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
| Install the [https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit C# Dev Kit extension for Visual Studio Code].|| [[Image:Language_csharp_vscode_installext.png|center|350px|link=https://cdn.phidgets.com/docs/images/b/b8/Language_csharp_vscode_installext.png]]
|-
| Next, create a directory and open it in Visual Studio Code. You can do this by opening Visual Studio Code and selecting '''File > Open Folder...''' || [[Image:Language_csharp_vscode_newfolder.png|center|350px|link=https://cdn.phidgets.com/docs/images/4/43/Language_csharp_vscode_newfolder.png]]
|-
| Open the Command Palette (Ctrl + Shift + P), type '''.NET: New Project''', and press Enter. A list of supported project types will appear. || [[Image:Language_csharp_vscode_netnewproject.png|center|350px|link=https://cdn.phidgets.com/docs/images/f/f7/Language_csharp_vscode_netnewproject.png]]
|-
| Select your preferred project type from the list. For this example, we will select '''Console App'''. || [[Image:Language_csharp_vscode_netconsoleapp.png|center|350px|link=https://cdn.phidgets.com/docs/images/b/bc/Language_csharp_vscode_netconsoleapp.png]]
|-
| Next, we need to add the Phidget22.NET library using NuGet. Open the Command Palette again (Ctrl + Shift + P), and enter '''NuGet: Add NuGet package...'''.
|| [[Image:Language_csharp_vscode_addnugetpackage.png|center|350px|link=https://cdn.phidgets.com/docs/images/2/26/Language_csharp_vscode_addnugetpackage.png]]
|-
| When prompted, enter '''Phidget22.NET''' and install the latest package.<br><br>'''Note''': Ensure you are downloading the latest version which can be seen [{{SERVER}}/?view=changelog here]. Visual Studio Code may incorrectly show an older version as the ''latest'' by default.|| [[Image:Language_csharp_vscode_phidget22net.png|center|350px|link=https://cdn.phidgets.com/docs/images/d/d5/Language_csharp_vscode_phidget22net.png]]
|-
|-
| Finally, add your C# code and run it using the button at the top of the screen. || [[Image:Language_csharp_vscode_runcodepng.png|center|350px|link=https://cdn.phidgets.com/docs/images/d/dc/Language_csharp_vscode_runcodepng.png]]
|-
|}

===.NET Command-Line Interface (CLI)===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
| Download and install the latest version of.NET from [https://dotnet.microsoft.com/en-us/download/dotnet Microsoft's .NET download page].|| [[Image:Language_csharp_cli_download.png|center|350px|link=https://cdn.phidgets.com/docs/images/9/90/Language_csharp_cli_download.png]]
|-
| Next, open a command prompt or terminal in a new folder and enter the following command:

<syntaxhighlight lang=bash>
dotnet new console
</syntaxhighlight>

|| [[Image:Language_csharp_cli_newconsole.png|center|350px|link=https://cdn.phidgets.com/docs/images/3/3a/Language_csharp_cli_newconsole.png]]
|-
| This previous command will create a new console application at the folder location. || [[Image:Language_csharp_cli_newproject.png|center|350px|link=https://cdn.phidgets.com/docs/images/c/cb/Language_csharp_cli_newproject.png]]
|-
| Navigate back to the command prompt or terminal, and add the Phidget22.NET package with the following command:

<syntaxhighlight lang=bash>
dotnet add package Phidget22.NET
</syntaxhighlight>

|| [[Image:Language_csharp_cli_addpackage.png|center|350px|link=https://cdn.phidgets.com/docs/images/7/78/Language_csharp_cli_addpackage.png]]
|-
| You can now open the '''Program.cs''' file and add your code. Run the program by entering the following command into your command prompt or terminal:

<syntaxhighlight lang=bash>
dotnet run
</syntaxhighlight>

|| [[Image:Language_csharp_cli_runcode.png|center|350px|link=https://cdn.phidgets.com/docs/images/f/f3/Language_csharp_cli_runcode.png]]
|-
|}

==Example Code==
Navigate to our [https://www.phidgets.com/?view=code_samples&lang=CSharp Code Sample Generator] to view and download code samples that are tailored to your specific device.

[[Image:Language_csharp_codesample.png|center|600px|link=https://cdn.phidgets.com/docs/images/0/03/Language_csharp_codesample.png]]

===Phidget Programming Basics===
{{PhidgetProgrammingBasicsLink}}

==API==
[{{SERVER}}/?view=api&lang=CSharp Phidget22 API]

Language - Python

2026-03-06T17:00:06Z

Lmpacent: /* macOS Considerations */

{{#seo:|description=Learn how to use Phidget USB devices with Python.}}
[[Category:Language]]

==Get Started==
With the Phidget22 Python library, it's easy to create Python applications that work with Phidget devices.

==Python Libraries==
===pip Package===
The Phidget22 Python library is available as a [https://pypi.org/project/phidget22/ pip package]. Most development environments provide built-in tools to manage packages. View the [[#Development Environment Configuration | Development Environment Configuration]] section below for examples.

====macOS Considerations====
Legacy Phidgets running a HID USB stack require a driver extension (macOS 10.15 and newer) or a kernel extension (macOS 10.14 and earlier). During development, we recommend downloading the appropriate [https://www.phidgets.com/docs/OS_-_macOS#Quick_Downloads package] which will install the extension. When deploying applications, review the README in the [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip macOS Development Files] for information about bundling the extension with your application.

=====Determining USB Stack=====
To determine which USB stack your device is running, navigate to the product page and then to the specification tab, and look for the ''USB Stack'' specification. If you are using a VINT device, navigate to the product page for the VINT Hub you are using.

[[Image:Javascript_networkserver_webusb_spec.png|center|600px|link=https://cdn.phidgets.com/docs/images/8/80/Javascript_networkserver_webusb_spec.png]]

====Linux Considerations====
Linux restricts access to USB devices to the root user. To run your Python application as a regular user, you'll need to [{{SERVER}}/docs/OS_-_Linux#Setting_Udev_Rules set up udev rules] on your system.

===Source Files===
The Phidget22 Python library source files are available [https://cdn.phidgets.com/downloads/phidget22/libraries/any/Phidget22Python.zip here].

==Development Environment Configuration==
Most development environments provide built-in tools to manage Python interpreters, packages, and virtual environments. See the examples below for more information.
===Installing a Python Interpreter===
If you don't already have a Python interpreter installed, you can download and install one from [https://www.python.org/downloads/ python.org] or through package managers like [https://brew.sh/ Homebrew].

===Visual Studio Code===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
| Install the [https://marketplace.visualstudio.com/items?itemName=ms-python.python Python extension for Visual Studio Code].|| [[Image:Language_python_vscode_install.png|center|350px|link=https://cdn.phidgets.com/docs/images/f/f9/Language_python_vscode_install.png]]
|-
| Next, create a directory and open it in Visual Studio Code. You can do this by opening Visual Studio Code and selecting '''File > Open Folder...''' || [[Image:Language_python_vscode_newfolder.png|center|350px|link=https://cdn.phidgets.com/docs/images/f/f8/Language_python_vscode_newfolder.png]]
|-
| Open the Command Palette (Ctrl + Shift + P), type '''Python: Create Environment''', and press Enter. Select '''Venv''' when prompted. || [[Image:Language_python_vscode_newvenv.png|center|350px|link=https://cdn.phidgets.com/docs/images/a/a6/Language_python_vscode_newvenv.png]]
|-
| Next, select your preferred Python interpreter from the list. You may need to browse to find it. || [[Image:Language_python_vscode_selectinterpreter.png|center|350px|link=https://cdn.phidgets.com/docs/images/2/20/Language_python_vscode_selectinterpreter.png]]
|-
| Open a new terminal. You can do this through the Command Palette again (Ctrl + Shift + P), by typing '''Terminal: Create New Terminal'''. Install the Phidget22 pip package:
<syntaxhighlight lang=bash>
#Windows
py -m pip install phidget22

#macOS
python3 -m pip install phidget22

#Linux (Debian)
python3 -m pip install phidget22
</syntaxhighlight>
|| [[Image:Language_python_vscode_installpackage.png|center|350px|link=https://cdn.phidgets.com/docs/images/a/a8/Language_python_vscode_installpackage.png]]
|-
| Finally, add your Python file and run it using the button in the top right corner.|| [[Image:Language_python_vscode_runcode.png|center|350px|link=https://cdn.phidgets.com/docs/images/9/96/Language_python_vscode_runcode.png]]
|-
|}

===PyCharm===
{| style="margin:auto;" class="table-no-border mw-collapsible mw-collapsed"
|+ '''Instructions'''
| Create your PyCharm project and navigate to '''Settings''': || [[Image:Windows_pycharm_settings.jpg|center|350px|link=https://cdn.phidgets.com/docs/images/7/75/Windows_pycharm_settings.jpg]]
|-
| Next, navigate to '''Project > Project Interpreter''' and click on the '''+''' symbol: || [[Image:Windows_pycharm_addpackage.jpg|center|350px|link=https://cdn.phidgets.com/docs/images/6/6f/Windows_pycharm_addpackage.jpg]]
|-
| Search for '''phidget22''' and install the package: || [[Image:Windows_pycharm_installpackage.jpg|center|350px|link=https://cdn.phidgets.com/docs/images/a/ad/Windows_pycharm_installpackage.jpg]]
|-
| Finally, add your Python file and run it using the button at the top of the screen: || [[Image:Windows_pycharm_run.png|center|350px|link=https://cdn.phidgets.com/docs/images/0/0a/Windows_pycharm_run.png]]
|}

==Example Code==
Navigate to our [https://www.phidgets.com/?view=code_samples&lang=Python Code Sample Generator] to view and download code samples that are tailored to your specific device.

[[Image:Language_python_codesample.png|center|600px|link=https://cdn.phidgets.com/docs/images/2/2d/Language_python_codesample.png]]

===Phidget Programming Basics===
{{PhidgetProgrammingBasicsLink}}

==API==
[{{SERVER}}/?view=api&lang=Python Phidget22 API]

Asynchronous Methods

2026-03-04T23:19:29Z

Lmpacent: /* Multiple Channels Example */

{{#seo:|description=This guide provides information about asynchronous methods with Phidget22.}}
[[Category:IntroGuide]]
__TOC__
==What Are Asynchronous Methods?==
Asynchronous methods allow you to send commands to a device ''without'' waiting for return codes.

When calling a typical non-asynchronous method, your program must wait for the return code, blocking the rest of your program’s operation.
[[Image:Async_methods_typical_flow.png|center|link=]]

When using an asynchronous method, your program can immediately continue executing and handle the return code in an asynchronous handler.
[[Image:Async_methods_async_flow.png|center|link=]]

==When Should I Use Asynchronous Methods?==
There are two situations where asynchronous methods may be beneficial:
# When sending commands to multiple channels on the same device
# When sending commands to multiple channels on different devices

===Multiple Channels Example===
[[Image:1032_0B.jpg|thumb|link=https://cdn.phidgets.com/docs/images/6/6d/1032_0B.jpg|<center>PhidgetLED-64 Advanced(1032_0)</center>]]
The [https://www.phidgets.com/?prodid=1024 PhidgetLED-64 Advanced] features 64 channels, one for each LED. To turn all the LEDs on or off simultaneously, 64 sequential commands are necessary (one for each channel). In this situation, using asynchronous methods can drastically improve the performance of your application.

===Multiple Devices Example===
The [https://www.phidgets.com/?prodid=712 Isolated 12-bit Voltage Output Phidget] is a single-channel device. If two or more of these devices were used in an application, it may be beneficial to use asynchronous methods.

==How Do I Use Asynchronous Methods?==
Asynchronous methods are comprised of two parts:
* Asynchronous API call
* Asynchronous handler

When calling an asynchronous method, you must assign an asynchronous handler. The Phidget22 libraries will then initiate the command and immediately return. The asynchronous handler will be called once the relevant communications have been completed to provide the return code from the device.

===Code Example===
The code below provides a simple demonstration of how asynchronous methods can be used (while avoiding [[#Overloading|overloading]]).

<tabber>
Python=
<syntaxhighlight lang=python>
from Phidget22.Phidget import *
from Phidget22.Devices.DigitalOutput import *
from Phidget22.ErrorCode import *
import time

def main():
digitalOutput0 = DigitalOutput()

digitalOutput0.openWaitForAttachment(5000)

#Assign new variables to track the number of calls made vs completed
digitalOutput0.AsyncCalls = 0
digitalOutput0.AsyncComplete = 0
def AsyncResult(ch, res, details):
ch.AsyncComplete += 1
print("Async Complete:" + str(ch.AsyncComplete))
if res != ErrorCode.EPHIDGET_OK:
print("Async failure: %i : %s" % (res, details))

while(1): #some loop condition
#Here we check if the previous asynchronous call has completed before issuing a new one
#If you had multiple asynchronous calls to make, you could (for example) give each its
#own counter, or call a new batch of them once an entire set completes
if(digitalOutput0.AsyncCalls == digitalOutput0.AsyncComplete):
digitalOutput0.AsyncCalls += 1
digitalOutput0.setDutyCycle_async(1, AsyncResult)
# NOTE: Make sure to wait for async call to complete before closing the channel

#Do other work here...

digitalOutput0.close()

main()
</syntaxhighlight>
|-|
Java=
<syntaxhighlight lang=java>
import com.phidget22.*;
import java.io.IOException;

public class JavaApplication11 {

static int asyncCalls = 0;
static int asyncComplete = 0;

public static void main(String[] args) throws Exception {

Phidget.resetLibrary();
DigitalOutput digitalOutput0 = new DigitalOutput();

digitalOutput0.open(5000);

while(asyncComplete < 1000) { //Some loop condition
//Here we check if the previous asynchronous call has completed before issuing a new one
//If you had multiple asynchronous calls to make, you could (for example) give each its
//own counter, or call a new batch of them once an entire set completes
if(asyncCalls == asyncComplete) {
asyncCalls++;
digitalOutput0.setDutyCycle(1, new AsyncListener() {
public void onAsyncCallback(AsyncResult ar) {
if (ar.getReturnCode() == ErrorCode.SUCCESS) {
asyncComplete++;
System.out.println("Async Complete: " + asyncComplete);
}
else
System.out.println("Async Failure: " + ar);
}
});
// NOTE: Make sure to wait for async call to complete before closing the channel
}

//Do other work here...
Thread.sleep(1);
}

digitalOutput0.close();
}
}
</syntaxhighlight>
|-|
C#=
<syntaxhighlight lang=cSharp>
using System;
using Phidget22;

namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
DigitalOutput digitalOutput0 = new DigitalOutput();

digitalOutput0.Open(5000);

digitalOutput0.DutyCycle = 1;

int asyncCalls = 0;
int asyncComplete = 0;
double dutyCycle = 0.1;
while (true) /* Some loop condition */
{
//Here we check if the previous asynchronous call has completed before issuing a new one
//If you had multiple asynchronous calls to make, you could (for example) give each its
//own counter, or call a new batch of them once an entire set completes
if (asyncCalls == asyncComplete)
{
asyncCalls++;
digitalOutput0.BeginSetDutyCycle(dutyCycle, delegate (IAsyncResult result)
{
try
{
asyncComplete++;
digitalOutput0.EndSetDutyCycle(result);
Console.WriteLine("Async Complete: " + asyncComplete.ToString());
}
catch (PhidgetException ex)
{
Console.WriteLine("Async Failure: " + ex.Message);
}
}, null);
}

/*
* Do other work were
*/
}
digitalOutput0.Close();
}
}
}
</syntaxhighlight>
|-|
C=
<syntaxhighlight lang=c>
#include <phidget22.h>
#include <stdio.h>

void CCONV setDutyCycleDone(PhidgetHandle phid, void *ctx, PhidgetReturnCode res) {
int *asyncComplete = (int*)ctx;
(*asyncComplete)++;
printf("Async Complete : %d\n", *asyncComplete);
}

int main() {
PhidgetDigitalOutputHandle digitalOutput0;
int asyncComplete;
int asyncCalls;

PhidgetDigitalOutput_create(&digitalOutput0);

Phidget_openWaitForAttachment((PhidgetHandle)digitalOutput0, 5000);

PhidgetDigitalOutput_setDutyCycle(digitalOutput0, 1);

asyncComplete = 0;
asyncCalls = 0;
while (1) { //Some loop condition

//Here we check if the previous asynchronous call has completed before issuing a new one
//If you had multiple asynchronous calls to make, you could (for example) give each its
//own counter, or call a new batch of them once an entire set completes
if (asyncCalls == asyncComplete) {
asyncCalls++;
PhidgetDigitalOutput_setDutyCycle_async(digitalOutput0, 1, setDutyCycleDone, &asyncComplete);
}

//Do other work here...

}
Phidget_close((PhidgetHandle)digitalOutput0);

PhidgetDigitalOutput_delete(&digitalOutput0);
}
</syntaxhighlight>
</tabber>

==Other Considerations==
===Overloading===
If asynchronous methods are called faster than they can be dispatched, they will be added to a queue. In extreme cases, if the queue grows large enough, newer calls will be dropped and your async handler will complete with ''Phidget Error 0x10 NoSpace''.

===Single Device, Single Channel===
Asynchronous commands are not recommended when using a single device and a single channel. Multiple asynchronous calls to the same channel will be queued and issued one at a time as return codes are received for each, providing no benefit to your application.

===Network Delays===
If you are accessing your device(s) over a network connection with high latency, you may benefit from using asynchronous methods.

===Callback Handlers===
When programming using the [https://www.phidgets.com/docs/Language_-_C C language], a callback handler is required. If a callback handler is not provided, the method will not run asynchronously. In all other programming languages, a callback handler is recommended but optional.

===VINT Communication Speed===
Asynchronous methods are particularly useful on VINT devices with lower [https://www.phidgets.com/docs/VINT_Communication_Speed_Guide communication speeds]. If you are working with USB devices or higher-speed VINT devices, the impact of asynchronous commands will be less significant.

File:1032 0B.jpg

2026-03-04T23:18:29Z

Lmpacent:

OS - macOS

2026-03-04T17:50:26Z

Lmpacent: /* Phidget Control Panel */

<metadesc>Communicate over USB with sensors, controllers, and relays with Phidgets! Program in macOS using a wide variety of programming languages.</metadesc>
[[Category:OS]]

==Quick Downloads==
Our libraries support macOS 10.11 and newer.
* [https://cdn.phidgets.com/downloads/phidget22/tools/macos/Phidget22ControlPanel.dmg Phidget22 Control Panel (macOS 10.15 and newer)]
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22.dmg Phidget22 Installer (macOS 10.14 and earlier)]

===Other Resources===
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip macOS Development Files]
* [{{SERVER}}/downloads/phidget22/libraries/macos/Phidget22/ Previous Releases]

==Getting Started with macOS==
===Install===
To get started, download the appropriate [[#Quick Downloads|package]] for your machine from the list above. This will install the Phidget Control Panel and the Phidget Network Server. These are powerful tools that will help you develop your Phidget applications.

===Phidget Control Panel===
After downloading, drag the application into your Applications folder:
[[Image:Macos_standalone_install.png|link=https://cdn.phidgets.com/docs/images/c/c8/Macos_applications_controlpanel.png|center|600px]]

You can then find the application in the Applications folder by searching for ''Phidget Control Panel''.
[[Image:Macos_applications_controlpanel.png|link=https://cdn.phidgets.com/docs/images/c/c8/Macos_applications_controlpanel.png|600px|center]]

When you open the application for the first time, you will see the following notice:
[[Image:Macos_install_extension.png|link=https://cdn.phidgets.com/docs/images/9/9e/Macos_install_extension.png|300px|center]]

Follow the link in the pop-up, or navigate to ''System Settings > General > Login Items & Extensions > Extensions'', and give permissions:
[[Image:Macos_install_extension_permission.png|link=https://cdn.phidgets.com/docs/images/a/ac/Macos_install_extension_permission.png|600px|center]]
<center>''Note: The driver extension is only required for legacy USB Phidgets running a HID USB stack. Refer to your product’s specifications page for information about its USB stack.''</center>

After running the application, you will see all the Phidgets that are plugged into your machine, as well as any Phidgets that are on your network.
[[Image:Os_macos_controlpanel.png|600px|link=https://cdn.phidgets.com/docs/images/a/a1/Os_macos_controlpanel.png|center]]

Click on the arrow beside a device to expand it so that you can see all available channels. Double-click on one of these channels to open up a window that lets you interact with it.

[[File:Os_macos_controlpanel_example.png‎|link=https://cdn.phidgets.com/docs/images/3/37/Os_macos_controlpanel_example.png|center|600px]]

The Phidget Control Panel can be used for testing devices, updating firmware, enabling a Phidget Network Server, and more. Visit the [[Phidget Control Panel|Phidget Control Panel page]] for more information.

===Programming===
When you are ready to develop your own applications, visit our [{{SERVER}}/docs/Programming_Resources programming resources page] and select your programming language to get started.

==Software License==
By downloading the installer and/or development files, you agree to adhere to the terms of the [{{SERVER}}/documentation/Licenses/Phidgets_EULA.pdf Phidgets End User License Agreement]. The Phidget libraries and development files are covered by the The 3-Clause BSD License.

OS - macOS

2026-03-04T17:10:12Z

Lmpacent:

<metadesc>Communicate over USB with sensors, controllers, and relays with Phidgets! Program in macOS using a wide variety of programming languages.</metadesc>
[[Category:OS]]

==Quick Downloads==
Our libraries support macOS 10.11 and newer.
* [https://cdn.phidgets.com/downloads/phidget22/tools/macos/Phidget22ControlPanel.dmg Phidget22 Control Panel (macOS 10.15 and newer)]
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22.dmg Phidget22 Installer (macOS 10.14 and earlier)]

===Other Resources===
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip macOS Development Files]
* [{{SERVER}}/downloads/phidget22/libraries/macos/Phidget22/ Previous Releases]

==Getting Started with macOS==
===Install===
To get started, download the appropriate [[#Quick Downloads|package]] for your machine from the list above. This will install the Phidget Control Panel and the Phidget Network Server. These are powerful tools that will help you develop your Phidget applications.

===Phidget Control Panel===
After downloading, drag the application into your Applications folder:
[[Image:Macos_standalone_install.png|link=https://cdn.phidgets.com/docs/images/c/c8/Macos_applications_controlpanel.png|center|600px]]

You can then find the application in the Applications folder by searching for ''Phidget Control Panel''.
[[Image:Macos_applications_controlpanel.png|link=https://cdn.phidgets.com/docs/images/c/c8/Macos_applications_controlpanel.png|600px|center]]

When you open the application for the first time, you will see the following notice:
[[Image:Macos_install_extension.png|link=https://cdn.phidgets.com/docs/images/9/9e/Macos_install_extension.png|300px|center]]

Follow the link in the pop-up, or navigate to ''System Settings > General > Login Items & Extensions > Extensions'', and give permissions:
[[Image:Macos_install_extension_permission.png|link=https://cdn.phidgets.com/docs/images/a/ac/Macos_install_extension_permission.png|600px|center]]
<center>''Note: The driver extension is only required for legacy USB Phidgets that use a HID USB stack. Refer to your product’s specifications page for information about its USB stack.''</center>

After running the application, you will see all the Phidgets that are plugged into your machine, as well as any Phidgets that are on your network.
[[Image:Os_macos_controlpanel.png|600px|link=https://cdn.phidgets.com/docs/images/a/a1/Os_macos_controlpanel.png|center]]

Click on the arrow beside a device to expand it so that you can see all available channels. Double-click on one of these channels to open up a window that lets you interact with it.

[[File:Os_macos_controlpanel_example.png‎|link=https://cdn.phidgets.com/docs/images/3/37/Os_macos_controlpanel_example.png|center|600px]]

The Phidget Control Panel can be used for testing devices, updating firmware, enabling a Phidget Network Server, and more. Visit the [[Phidget Control Panel|Phidget Control Panel page]] for more information.

===Programming===
When you are ready to develop your own applications, visit our [{{SERVER}}/docs/Programming_Resources programming resources page] and select your programming language to get started.

==Software License==
By downloading the installer and/or development files, you agree to adhere to the terms of the [{{SERVER}}/documentation/Licenses/Phidgets_EULA.pdf Phidgets End User License Agreement]. The Phidget libraries and development files are covered by the The 3-Clause BSD License.

File:Os macos controlpanel.png

2026-03-04T17:08:08Z

Lmpacent:

File:Os macos controlpanel example.png

2026-03-04T17:07:35Z

Lmpacent:

File:Macos install extension permission.png

2026-03-04T17:06:29Z

Lmpacent:

File:Macos install extension.png

2026-03-04T17:05:49Z

Lmpacent:

File:Macos applications controlpanel.png

2026-03-04T17:05:27Z

Lmpacent:

File:Macos standalone install.png

2026-03-04T17:05:10Z

Lmpacent:

OS - Windows

2026-03-03T16:28:33Z

Lmpacent: /* Install */

<metadesc>Communicate over USB with sensors, controllers and relays with Phidgets! Program in Windows using a wide variety of programming languages.</metadesc>
[[Category:OS]]

==Quick Downloads==
Our libraries support Windows 8 and newer.

*[https://cdn.phidgets.com/downloads/phidget22/libraries/windows/Phidget22-x64.exe Installer Download (64-bit)]
*[https://cdn.phidgets.com/downloads/phidget22/libraries/windows/Phidget22-ARM64.exe Installer Download (ARM64)]
*[https://cdn.phidgets.com/downloads/phidget22/libraries/windows/Phidget22-x86.exe Installer Download (32-bit)]

===Other Resources===
* [[OS - Windows Advanced Information|Windows Advanced Information]]
*[https://cdn.phidgets.com/downloads/phidget22/libraries/windows/Phidget22-windevel.zip Windows Development Files]
* [https://www.phidgets.com/downloads/phidget22/libraries/windows/ Previous Releases]

==Getting Started with Windows==
===Install===
To get started, download the appropriate [[#Quick Downloads|installer]] for your machine from the list above. This will install the Phidget Control Panel and the Phidget Network Server. These are powerful tools that will help you develop your Phidget applications.

===Phidget Control Panel===
After installing, you can find the application through your system tray, or by opening the start menu and searching for ''Phidget Control Panel''.

[[Image:Os_windows_systemtray.png|link=|center]]

After opening, you will see all the Phidgets that are plugged into your machine, as well as any Phidgets that are on your network.

[[File:Windows ControlPanel General.PNG|link=|alt=Windows Control Panel General|center]]

Click on the '''+''' beside a device to expand it so that you can see all available channels. Double-click on one of these channels to open up a window that lets you interact with it.

[[File:Controlpanel_openapplication.png|500px|link=https://cdn.phidgets.com/docs/images/b/bd/Controlpanel_openapplication.png|alt=Windows Control Panel General|center]]

The Phidget Control Panel can be used for testing devices, updating firmware, enabling a Phidget Network Server, and more. Visit the [[Phidget Control Panel|Phidget Control Panel page]] for more information.

===Programming===
When you are ready to develop your own applications, visit our [{{SERVER}}/docs/Programming_Resources programming resources page] and select your programming language to get started.

==Software License==
By downloading the installer and/or development files, you agree to adhere to the terms of the [{{SERVER}}/documentation/Licenses/Phidgets_EULA.pdf Phidgets End User License Agreement]. The Phidget libraries and development files are covered by the The 3-Clause BSD License.

OS - Windows

2026-03-02T22:27:56Z

Lmpacent: /* Install */

<metadesc>Communicate over USB with sensors, controllers and relays with Phidgets! Program in Windows using a wide variety of programming languages.</metadesc>
[[Category:OS]]

==Quick Downloads==
Our libraries support Windows 8 and newer.

*[https://cdn.phidgets.com/downloads/phidget22/libraries/windows/Phidget22-x64.exe Installer Download (64-bit)]
*[https://cdn.phidgets.com/downloads/phidget22/libraries/windows/Phidget22-ARM64.exe Installer Download (ARM64)]
*[https://cdn.phidgets.com/downloads/phidget22/libraries/windows/Phidget22-x86.exe Installer Download (32-bit)]

===Other Resources===
* [[OS - Windows Advanced Information|Windows Advanced Information]]
*[https://cdn.phidgets.com/downloads/phidget22/libraries/windows/Phidget22-windevel.zip Windows Development Files]
* [https://www.phidgets.com/downloads/phidget22/libraries/windows/ Previous Releases]

==Getting Started with Windows==
===Install===
To get started, download the appropriate [[#Quick Downloads|installer]] for your machine from the list above. This will install the Phidget Control Panel and the Phidget Network Sever. These are powerful tools that will help you develop your Phidget applications.

===Phidget Control Panel===
After installing, you can find the application through your system tray, or by opening the start menu and searching for ''Phidget Control Panel''.

[[Image:Os_windows_systemtray.png|link=|center]]

After opening, you will see all the Phidgets that are plugged into your machine, as well as any Phidgets that are on your network.

[[File:Windows ControlPanel General.PNG|link=|alt=Windows Control Panel General|center]]

Click on the '''+''' beside a device to expand it so that you can see all available channels. Double-click on one of these channels to open up a window that lets you interact with it.

[[File:Controlpanel_openapplication.png|500px|link=https://cdn.phidgets.com/docs/images/b/bd/Controlpanel_openapplication.png|alt=Windows Control Panel General|center]]

The Phidget Control Panel can be used for testing devices, updating firmware, enabling a Phidget Network Server, and more. Visit the [[Phidget Control Panel|Phidget Control Panel page]] for more information.

===Programming===
When you are ready to develop your own applications, visit our [{{SERVER}}/docs/Programming_Resources programming resources page] and select your programming language to get started.

==Software License==
By downloading the installer and/or development files, you agree to adhere to the terms of the [{{SERVER}}/documentation/Licenses/Phidgets_EULA.pdf Phidgets End User License Agreement]. The Phidget libraries and development files are covered by the The 3-Clause BSD License.

OS - Windows

2026-03-02T16:50:34Z

Lmpacent:

<metadesc>Communicate over USB with sensors, controllers and relays with Phidgets! Program in Windows using a wide variety of programming languages.</metadesc>
[[Category:OS]]

==Quick Downloads==
Our libraries support Windows 8 and newer.

*[https://cdn.phidgets.com/downloads/phidget22/libraries/windows/Phidget22-x64.exe Installer Download (64-bit)]
*[https://cdn.phidgets.com/downloads/phidget22/libraries/windows/Phidget22-ARM64.exe Installer Download (ARM64)]
*[https://cdn.phidgets.com/downloads/phidget22/libraries/windows/Phidget22-x86.exe Installer Download (32-bit)]

===Other Resources===
* [[OS - Windows Advanced Information|Windows Advanced Information]]
*[https://cdn.phidgets.com/downloads/phidget22/libraries/windows/Phidget22-windevel.zip Windows Development Files]
* [https://www.phidgets.com/downloads/phidget22/libraries/windows/ Previous Releases]

==Getting Started with Windows==
===Install===
To get started, download the appropriate [[#Quick Downloads|installer]] for your machine from the list above. This will install the Phidget Control Panel, a powerful tool that will help you develop your Phidget applications.

===Phidget Control Panel===
After installing, you can find the application through your system tray, or by opening the start menu and searching for ''Phidget Control Panel''.

[[Image:Os_windows_systemtray.png|link=|center]]

After opening, you will see all the Phidgets that are plugged into your machine, as well as any Phidgets that are on your network.

[[File:Windows ControlPanel General.PNG|link=|alt=Windows Control Panel General|center]]

Click on the '''+''' beside a device to expand it so that you can see all available channels. Double-click on one of these channels to open up a window that lets you interact with it.

[[File:Controlpanel_openapplication.png|500px|link=https://cdn.phidgets.com/docs/images/b/bd/Controlpanel_openapplication.png|alt=Windows Control Panel General|center]]

The Phidget Control Panel can be used for testing devices, updating firmware, enabling a Phidget Network Server, and more. Visit the [[Phidget Control Panel|Phidget Control Panel page]] for more information.

===Programming===
When you are ready to develop your own applications, visit our [{{SERVER}}/docs/Programming_Resources programming resources page] and select your programming language to get started.

==Software License==
By downloading the installer and/or development files, you agree to adhere to the terms of the [{{SERVER}}/documentation/Licenses/Phidgets_EULA.pdf Phidgets End User License Agreement]. The Phidget libraries and development files are covered by the The 3-Clause BSD License.

File:Os windows systemtray.png

2026-03-02T16:49:11Z

Lmpacent: