Phidgets Support - User contributions [en]

Dealers

2026-03-17T17:43:09Z

Patrick:

[[Category:Linked_From_Website]]
__NOTOC__


{|
!style="background: #269964; color:white; text-align: center;" colspan=9| Select your region
|-
|style="background: #f0f0f0; text-align: right; vertical-align:middle;"|'''[[#North America|North America]]'''
|style="background: #dddddd; text-align: center;"| [[Image:USA_FLAG_V2.png|link=#USA|50px]]
|style="background: #dddddd; text-align: center;"| [[Image:Canada_Flag.png|link=#Canada|50px]]
|style="background: #dddddd; text-align: center;"|
|style="background: #dddddd; text-align: center;"|
|style="background: #dddddd; text-align: center;"|
|style="background: #dddddd; text-align: center;"|
|style="background: #dddddd; text-align: center;"|
|style="background: #dddddd; text-align: center;"|
|-
|style="background: #f0f0f0; text-align: right; vertical-align:middle;"|'''[[#Europe|Europe]]'''
|style="background: #dddddd; text-align: center;"| [[Image:France_Flag.png|link=#France|50px]]
|style="background: #dddddd; text-align: center;"| [[Image:Germany_Flag.png|link=#Germany|50px]]
|style="background: #dddddd; text-align: center;"| [[Image:Italy_Flag.png|link=#Italy|50px]]
|style="background: #dddddd; text-align: center;"| [[Image:Slovenia_Flag.png|link=#Slovenia|50px]]
|style="background: #dddddd; text-align: center;"| [[Image:Spain_Flag.png|link=#Spain|50px]]
|style="background: #dddddd; text-align: center;"| [[Image:Netherlands_Flag.png|link=#The Netherlands|50px]]
|style="background: #dddddd; text-align: center;"| [[Image:UK_Flag.png|link=#United Kingdom|50px]]
|style="background: #dddddd; text-align: center;"|
|-
|style="background: #f0f0f0; text-align: right; vertical-align:middle;"|'''[[#Asia|Asia]]'''
|style="background: #dddddd; text-align: center;"| [[Image:India_Flag.png|link=#India|50px]]
|style="background: #dddddd; text-align: center;"| [[Image:Japan_Flag.png|link=#Japan|50px]]
|style="background: #dddddd; text-align: center;"| [[Image:Singapore_Flag.png|link=#Singapore|50px]]
|style="background: #dddddd; text-align: center;"| [[Image:SouthKorea_Flag.png|link=#South Korea|50px]]
|style="background: #dddddd; text-align: center;"| [[Image:Taiwan_Flag.png|link=#Taiwan|50px]]
|style="background: #dddddd; text-align: center;"|
|style="background: #dddddd; text-align: center;"|
|style="background: #dddddd; text-align: center;"|
|-
|style="background: #f0f0f0; text-align: right; vertical-align:middle;"|'''[[#Middle East & Africa|Middle East & Africa]]'''
|style="background: #dddddd; text-align: center;"| [[Image:Israel_Flag.png|link=#Israel|50px]]
|style="background: #dddddd; text-align: center;"| [[Image:Kuwait_Flag.png|link=#Kuwait|50px]]
|style="background: #dddddd; text-align: center;"|
|style="background: #dddddd; text-align: center;"|
|style="background: #dddddd; text-align: center;"|
|style="background: #dddddd; text-align: center;"|
|style="background: #dddddd; text-align: center;"|
|style="background: #dddddd; text-align: center;"|
|-
|style="background: #f0f0f0; text-align: right; vertical-align:middle;"|'''[[#Australia & Oceania|Australia & Oceania]]'''
|style="background: #dddddd; text-align: center;"| [[Image:Australia_Flag.png|link=#Australia|50px]]
|style="background: #dddddd; text-align: center;"|
|style="background: #dddddd; text-align: center;"|
|style="background: #dddddd; text-align: center;"|
|style="background: #dddddd; text-align: center;"|
|style="background: #dddddd; text-align: center;"|
|style="background: #dddddd; text-align: center;"|
|style="background: #dddddd; text-align: center;"|
|-
|}

----

==North America==

{{Dealerbox2
|title=Canada
|a={{Dealers
|nam=RobotShop
|loc=Mirabel, QC
|pin=YDSVkZWCisQsque79
|vrl=www.robotshop.com
|url=www.robotshop.com/ca/en/phidgets-en.html
|tel=450-420-1446
|fax=450-420-1447
|ema=sales@robotshop.ca}}
|b={{Dealers
|nam=Solarbotics Ltd.
|loc=Calgary, AB
|pin=br4DR9n5U7dEEuGa7
|url=www.solarbotics.com
|tel=1-403-232-6268
|fax=1-403-226-3741
|ema=info@solarbotics.com}}
}}

{{Dealerbox2
|title=USA
|a={{Dealers
|nam=RobotShop
|vrl=www.robotshop.com
|url=www.robotshop.com/en/phidgets-en.html
|loc=Swanton, VT
|pin=xCkwvThSZwxyCxW26
|tel=866-627-3178
|fax=420-420-1447
|ema=supportcenter@robotshop.com
}}
|b={{Dealers
|nam=Amazon
|url=www.amazon.com/phidgets
}}
|c=
}}

==Europe==

{{Dealerbox2
|title=France
|a={{Dealers
|nam=GO TRONIC
|loc=Blagny
|pin=HzA7iwT8kUhMqA3o7
|url=www.gotronic.fr
|tel=+33.324.27.93.42
|fax=+33.324.27.93.50
|ema=commandes@gotronic.fr}}
|b={{Dealers
|nam=RobotShop Europe
|loc=Bois d'Arcy
|vrl=www.robotshop.com
|url=www.robotshop.com/eu/fr/phidgets-en.html
|tel=+33 (0) 8 00 00 18 37
|ema=supportcenter@robotshop.com}}
}}

{{Dealerbox2
|title=Germany
|a={{Dealers
|nam=RobotShop
|loc=Duisburg
|vrl=www.robotshop.com
|url=www.robotshop.com/de/de/phidgets-en.html
|tel=00 + 33 + 8 00 00 18 37
|fax=001-450-420-1447
|ema=support@robotshop.com}}
|b={{Dealers
|nam=MYBOTSHOP
|loc=Bergheim
|url=www.mybotshop.de
|tel=+49 (0) 2271 485 7233
|ema=info@mybotshop.de}}
|c={{Dealers
|nam=zeroDNA
|loc=Landsberg am Lech
|pin=Jebfb66CJvx6WwZdA
|url=www.zerodna.de
|tel=+49.8191.9406800
|ema=info@zerodna.de}}
}}

{{Dealerbox2
|title=Italy
|a={{Dealers
|nam=Deersoft {{Small|(Formerly Emmeshop)}}
|url=www.deersoft.eu/shop/
|tel=+386 40 511 338
|ema=administration@deersoft.eu}}
|b={{Dealers
|nam=Robot Italy
|loc=Rome
|pin=FEWZMuU8LhUKarbL6
|url=www.robot-italy.com
|tel=+39 06 414 011 01
|fax=+39 06 233 243 440}}
}}

{{Dealerbox2
|title=Slovenia
|a={{Dealers
|nam=Deersoft
|loc=Izola
|pin=hfqtXYFGJsWEhvDD7
|url=www.deersoft.eu/shop/
|tel=+386 40 511 338
|ema=administration@deersoft.eu}}
}}

{{Dealerbox2
|title=Spain
|a={{Dealers
|nam=RobotShop
|loc=Barcelona
|vrl=www.robotshop.com
|url=www.robotshop.com/es/es/phidgets-en.html
|fax=001-450-420-1447
|ema=support@robotshop.com}}
}}

{{Dealerbox2
|title=The Netherlands
|a={{Dealers
|nam=EZtronics
|loc=Schijndel
|pin=ih8F3pCP7R4WGiiu7
|url=www.eztronics.nl
|tel=+31 302421478
|ema=info@eztronics.nl}}
}}

{{Dealerbox2
|title=United Kingdom
|a={{Dealers
|nam=RobotShop
|loc=Hethersett
|vrl=www.robotshop.com
|url=www.robotshop.com/uk/phidgets-en.html
|tel=00+33+800001837
|fax=001-450-420-1447
|ema=support@robotshop.com}}
}}

==Asia==

{{Dealerbox2
|title=India
|a={{Dealers
|nam=MG Automation Technologies
|url=www.mgsuperlabs.com/
|tel=(+91)7721933328
|ema=estore@mgsuperlabs.co.in}}
}}

{{Dealerbox2
|title=Japan
|a={{Dealers
|nam=RobotShop Japan
|loc=Tokushima
|vrl=www.robotshop.com
|url=www.robotshop.com/jp/ja/phidgets-en.html
|tel=088-635-0277
|fax=088-635-0278}}
}}

{{Dealerbox2
|title=Singapore
|a={{Dealers
|nam=sgBOTIC
|loc=Woodlands
|pin=hhGdN398azFzMx9J7
|url=www.sgbotic.com
|tel=+65-65701125
|ema=sales@sgbotic.com}}
|b={{Dealers
|nam=Amicus Engineering
|loc=Jalan Besar
|url=www.amicus.com.sg
|tel=+65-684 55558
|ema=sales@amicus.com.sg}}
}}

{{Dealerbox2
|title=South Korea
|a={{Dealers
|nam=SEED Technology
|loc=Bucheon
|url=seedtech.co.kr
|tel=82-32-623-6220
|fax=82-32-623-5267
|ema=info@seedtech.co.kr}}
|b={{Dealers
|nam=VCTEC
|loc=Anyang
|pin=1Z1JWFBGeQtqTx4E8
|url=vctec.co.kr
|tel=070-7770-6256
|fax=031-696-6258
|ema=cs@vctec.co.kr}}
}}

{{Dealerbox2
|title=Taiwan
|a={{Dealers
|nam=IDM Store
|loc=Taipei
|pin=wsa4gm2a6o6EcTaz8
|url=www.idmstore.com
|tel=886-2-2362-9896
|ema=inquiry@idmstore.com}}
}}

==Middle East & Africa==

{{Dealerbox2
|title=Israel
|a={{Dealers
|nam=Testview
|loc=Kfar Baruch
|url=shop.testview.co.il/
|tel=+972-54-5376124
|fax=+972-773457377
|ema=info@testview.co.il}}
}}

{{Dealerbox2
|title=Kuwait
|a={{Dealers
|nam=Electronics In Touch
|loc=Shuwaikh
|pin=rrRbX5KvLM4oobrT8
|url=eitkw.com/
|tel=+965-55751243
|ema=info@eitkw.com}}
}}

==Australia & Oceania==
{{Dealerbox2
|title=Australia
|a={{Dealers
|nam=IoT Store Australia
|url=iot-store.com.au
|loc=Beckenham, WA
|tel=+61424742772
|ema=info@iot-store.com.au}}
|b={{Dealers
|nam=Amazon
|url=www.amazon.com.au/stores/Phidgets/page/29286736-16AC-41C4-98D1-DA1AD1FB20F5
|vrl=amazon.com.au
}}
}}

Template:LinuxPackageInstall

2026-02-03T21:01:21Z

Patrick:

We recommend installing with our '''Install Script'''. If you prefer not to run a script, or the script cannot detect your distro, use the '''Manual Install'''.

<tabber>
|-|Install Script=
To run the install script and install phidget22, enter the following command in the terminal:

{{LinuxInstallScript}}

If the ''curl'' command is not found: <syntaxhighlight enclose="none">apt install curl</syntaxhighlight> and try again.

|-|Manual Install=
To install our package repository manually, enter the following command in the terminal, replacing '''''distro''''' with your distro codename:

{{LinuxGetKey}}

We support Debian releases from 6 to current, and Ubuntu LTS releases from 18.04 to current. If you are using another flavour of Linux (such as Mint), which is based on Ubuntu or Debian, use the corresponding Ubuntu or Debian codename.

Update your package lists:
{{LinuxAptUpdate}}

Finally, install the Phidget package by entering the command below:
{{LinuxAptInstall}}
</tabber>

====Additional Packages====
You may also want to apt install the following optional packages:
* '''libphidget22-dev''': The C development libraries for Phidget22
* '''libphidget22extra''': Extra runtime library required for the Network Server and Admin tools
* '''phidget22networkserver''': The [[Phidget Network Server]], which enables use of Phidgets over your network
* '''libphidget22java''': The Java libraries for Phidget22
* [[Phidget22admin Guide|'''phidget22admin''']]: An administrator utility for listing Phidgets and upgrading firmware
* '''phidget22wwwjs''': The JavaScript libraries for Phidget22. This package also installs the HTML examples which can be accessed through the web interface

The libraries are now installed on your machine. Next, set up the UDev rules below.

OS - macOS

2026-01-28T18:16:28Z

Patrick:

[[Category:OS]]

==Getting Started with macOS==
Welcome to using Phidgets with macOS!

Phidget22 is supported on '''macOS 10.11 and newer'''.

To get started, install our libraries.

===Quick Downloads===
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22.dmg macOS Installer]
* [https://cdn.phidgets.com/downloads/phidget22/tools/macos/Phidget22ControlPanel.dmg macOS Standalone Control Panel]
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip macOS Development Files]

===Install===
To begin, select which version of our installer to use:
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22.dmg Installer]
** Installs Phidget development libraries globally for use in C, Java or Max.
** Includes the Phidget Control Panel and the Phidget Network Server.
** May Require changing security settings on Apple Silicon macs. See here [https://support.apple.com/en-ca/guide/mac-help/mchl768f7291/mac].

* [https://cdn.phidgets.com/downloads/phidget22/tools/macos/Phidget22ControlPanel.dmg Standalone]
** Self contained Application; no installer.
** Includes the Phidget Control Panel and the Phidget Network Server.
** Requires macOS 10.15 or newer.

Open up the installer, and double click on ''Phidgets.pkg'' to install the libraries:
[[File:OSX Install 1.png|link=|alt=macOS Install|center]]

When prompted, continue with the installation:
[[File:OSX Install 2.png|link=|alt=macOS Install|center]]

If you are using macOS 10.13 or newer you will also need to give explicit permission for the driver to function. You can read about this here [https://support.apple.com/en-us/120363].

The Phidgets libraries are now installed on your machine. Next, let's verify that the Phidget libraries are working properly.

===Verify===
The best way to verify that your libraries are working properly is to use the Phidget Control Panel. The Phidget Control Panel is a powerful tool that will help you develop your Phidgets applications. Get started by following the instructions below:

Open Finder and navigate to the Phidget Control Panel in the Applications list:
[[File:OSX Finder Apps.png|link=|800px|alt=macOS Finder Apps|center]]

Double click on the Phidgets icon to bring up the Phidget Control Panel. You can now see all the Phidgets that are plugged into your machine, as well as any Phidgets that are on the network:
[[File:OSX ControlPanel General.png|600px|link=|alt=macOS Control Panel General|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:OSX Control Panel Channel.png ‎|link=|alt=macOS Control Panel Channel|center]]

The Phidget Control Panel can be used for testing devices, updating firmware, enabling a network server, and more! Visit the [[Phidget Control Panel#macOS|Phidget Control Panel]] page if you want to delve a little deeper.

Your Phidget is now able to communicate with your development machine. The next step is selecting a programming language so you can start to write some code!

==Programming==
Ready to write some code? Select one of the programming languages below:

{{Programming_Languages_Table}}

===Development Files===
If you're a developer and want to bundle the Phidget libraries with your application for distribution, download the [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip macOS Development Files]. See the included README for more details.

===Older Versions===
If you need older versions of the macOS libraries, [{{SERVER}}/downloads/phidget22/libraries/macos/Phidget22/ click here].

===Software License===
By downloading the macOS installer 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 [https://opensource.org/licenses/BSD-3-Clause The 3-Clause BSD License].

OS - iOS

2025-11-14T21:14:08Z

Patrick:

[[Category:OS]]
{|
|style="vertical-align:middle; width: 60%;"|
==Getting Started with iOS==
Welcome to using Phidgets with iOS!

If you haven't already, check out the [[:Category:UserGuide|user guide]] for your device. If you are ready to go, the first step to creating an iOS application with Phidgets is downloading the Phidget libraries on your macOS development machine!
|{{TOC limit|3}}
|}
==Download==
The Phidget libraries for iOS development are available here:
*[https://cdn.phidgets.com/downloads/phidget22/libraries/ios/Phidget22_iOS.zip iOS Libraries]

Download and unpack the libraries. You will need to reference these files from your Xcode project in order to use Phidgets. This step is covered in detail after you select your programming language below. If you need to access older versions of the libraries, [https://www.phidgets.com/downloads/phidget22/libraries/ios/ click here].

==Network Server==
Phidgets cannot be connected directly to iOS devices, therefore, in order to use Phidgets with your iOS device, you must have a host computer that is running the Phidget Network Server.

[[Image:iOS-connection.jpg|link=]]

*Host computer: the computer that is physically connected to the Phidgets via USB and is running the Phidget Network Server.
*Client computer: a computer running a Phidgets application that accesses Phidgets connected to the host computer. When developing for iOS, your iOS device acts as the client.

The next step is to install the Phidget libraries on your host computer, and get the Phidget Network Server up and running. Start by following the ''Getting Started'' guide, and continue with the ''Network Server'' guide. When you are done, come back and finish this guide!
*[[OS - Windows#Phidget Network Server| Windows]]
*[[OS - macOS#Phidget Network Server| macOS]]
*[[OS - Linux#Phidget Network Server| Linux]]
*[[OS - Phidget SBC#Phidget Network Server| Phidget Single Board Computer]]

==Programming==
Now that you have everything set up, all you have to do is code! Select from one of the following programming languages to get started:

* [[Language - Objective C#iOS|Objective C]]
* [[Language - Swift#iOS|Swift]]

If your app uses Server Discovery, you must list the service types in Info.plist:
*Key: NSBonjourServices
*Type: Array of Strings
*Value: _phidget22server._tcp

==Software License==
By downloading the iOS library you agree to adhere to the terms of the [{{SERVER}}/documentation/Licenses/Phidgets_EULA.pdf Phidgets End User License Agreement]. The C API section of Phidget22 is covered by the [https://opensource.org/licenses/BSD-3-Clause The 3-Clause BSD License]. The source code of C API can be found [{{SERVER}}/downloads/phidget22/libraries/linux/libphidget22.tar.gz here].

Operating System Support

2025-11-13T19:11:50Z

Patrick:

[[Category:Overview]]
We provide support for all major operating systems. Select your operating system from the table below and follow the ''Getting Started'' guide in order to set up your machine. If you need to access non-current versions of our drivers you can find them [{{SERVER}}/downloads/phidget22/libraries/ here]. You can find the driver changelog [{{SERVER}}/?view=changelog here].

<div class="OSTableFull">
== Desktop OS ==
{|class="table-no-border"
|style="text-align:center;"|[[Image:Logo-Windows2.png|alt=OS - Windows|link=OS - Windows|150px]]
|style="text-align:center;"|[[Image:Logo-Mac-OS.png|alt=OS - macOS|link=OS - macOS|150px]]
|style="text-align:center;"|[[Image:Logo-Linux.png|alt=OS - Linux|link=OS - Linux|150px]]
|-
|style="text-align:center;"| [[OS - Windows|Windows]]
|style="text-align:center;"| [[OS - macOS|macOS]]
|style="text-align:center;"| [[OS - Linux|Linux]]
|-
|style="text-align:center;"| (Windows 8 or Newer)
|style="text-align:center;"| (macOS 10.11 or Newer)
|style="text-align:center;"| (Kernel 2.6 or Newer)
|}

== Mobile/Wireless OS ==
{|class="table-no-border"
|style="text-align:center;"|[[Image:Logo-Android.png|alt=OS - Android|link=OS_-_Android|150px]]
|style="text-align:center;"|[[Image:Logo-iOS.png|alt=OS - iOS|link=OS - iOS|150px]]
|style="text-align:center;"|[[Image:Logo-Phidgets.png|alt=OS - Phidget SBC|link=OS - Phidget SBC|150px]]
|-
|style="text-align:center;"| [[OS - Android|Android]]
|style="text-align:center;"| [[OS - iOS|iOS]]
|style="text-align:center;"| [[OS - Phidget SBC|Phidget SBC]]
|-
|style="text-align:center;"| (4.1 Jellybean or Newer)
|style="text-align:center;"| (12.0 or Newer)
|style="text-align:center;"| (All versions supported)
|}
</div>
<div class="OSTableSmall">
'''Desktop OSes'''
{|class="table-no-border"
|style="text-align:center;"|[[Image:Logo-Windows.png|alt=OS - Windows|link=OS - Windows|30px]]||[[OS - Windows|Windows]]||(Windows 8 or Newer)
|-
|style="text-align:center;"|[[Image:Logo-Mac-OS.png|alt=OS - macOS|link=OS - macOS|30px]]||[[OS - macOS|MacOS]]||(macOS 10.5 or Newer)
|-
|style="text-align:center;"|[[Image:Logo-Linux.png|alt=OS - Linux|link=OS - Linux|30px]]||[[OS - Linux|Linux]]||(Kernel 2.6 or Newer)
|}
'''Mobile/Wireless OSes'''
{|class="table-no-border"
|style="text-align:center;"|[[Image:Logo-Android.png|alt=OS - Android|link=OS_-_Android|30px]]||[[OS - Android|Android]]||(4.1 Jellybean or Newer)
|-
|style="text-align:center;"|[[Image:Logo-iOS.png|alt=OS - iOS|link=OS - iOS|30px]]||[[OS - iOS|iOS]]||(8.0 or Newer)
|-
|style="text-align:center;"|[[Image:Logo-Phidgets.png|alt=OS - Phidget SBC|link=OS - Phidget SBC|30px]]||[[OS - Phidget SBC|Phidget SBC]]||(All versions supported)
|}
</div>

OS - Windows

2025-09-11T22:32:38Z

Patrick:

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

==Getting Started with Windows==
Welcome to using Phidgets with Windows!

Phidget22 is supported on '''Windows 8 and newer'''.

If you are ready to go, the first step in creating Windows applications with Phidgets is installing our libraries.

===Install===
To install our libraries, download the installer for your system:
*[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)]

If you need to access an old version of the drivers, [https://www.phidgets.com/downloads/phidget22/libraries/windows/ click here].

When prompted, continue with the installation:
[[image:Windows_Install.png|link=|center]]

The libraries are now installed on your machine. Next, let's verify that they are working properly.

''For instructions on installing our libraries without an installer, check out the [[OS - Windows Advanced Information]] page.''

===Verify===
The best way to verify that your libraries are working properly is to use the Phidget Control Panel. The control panel is a powerful tool that will help you develop your Phidgets applications. Get started by following the instructions below:

Find the [[File:Ph.jpg|link=]] icon in the taskbar. If it is not there, open up the start menu and search for ''Phidget Control Panel''
[[File:Windows PhidgetTaskbar.PNG|link=|center]]

Next, double-click on the Phidgets icon to bring up the Phidget Control Panel. You can now see all the Phidgets that are plugged into your machine, as well as any Phidgets that are on the 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=|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.

Your Phidget is now able to communicate with your development machine. The next step is selecting a programming language so you can start to write some code!

==Programming==
Ready to write some code? Select one of the programming languages below:

{{Programming_Languages_Table}}

==Advanced Information==

For information on advanced Windows topics, such as installing our libraries without an installer, installing our libraries without an internet connection, or using Windows in a Virtual Machine, check our page on [[OS - Windows Advanced Information|Windows Advanced Information]]

==Software License==
By downloading the Phidget22.MSI you agree to adhere to the terms of the [{{SERVER}}/documentation/Licenses/Phidgets_EULA.pdf Phidgets End User License Agreement]. The C API section of Phidget22 is covered by the [https://opensource.org/licenses/BSD-3-Clause The 3-Clause BSD License]. The source code of C API can be found [{{SERVER}}/downloads/phidget22/libraries/linux/libphidget22.tar.gz here].

Network Server Guide

2025-08-22T14:58:56Z

Patrick:

{{#seo:|description=Get started with the Phidget Network Server}}
[[Category:IntroGuide]]
<div class="nonumtoc">
<div class="toclimit-5">
==Introduction==
The Phidget Network Server is a powerful tool that allows you to do the following:
* Access Phidgets that are connected to other computers on your network.
* Access Phidgets from more than one application simultaneously.
* Host webpages and run JavaScript applications using the built-in web server.
* Manage dictionaries to easily share information between applications.

This guide will provide an overview of the Phidget Network Server and showcase how it can be used in your applications.

==How It Works==
The Phidget Network Server has three elements: a Phidget server, a web server, and a dictionary manager. The Phidget server is the primary component, which we will discuss here. The other components will be discussed later in this guide.

When the Phidget Network Server is running, your computer can host a '''Phidget Server''' which makes all connected Phidget channels available to other computers on your network.

[[Image:NetworkServer_PhidgetServer.jpg|center|link=https://cdn.phidgets.com/docs/images/thumb/f/fd/NetworkServer_PhidgetServer.jpg/800px-NetworkServer_PhidgetServer.jpg|650px]]

As long as the Phidget Server is running, clients can access the remote channels. They can be addressed, opened, and attached in much the same way as local channels.

Unlike local channels, remote channels may be opened by multiple programs simultaneously. There are some exceptions (e.g. motor controllers) that cannot be opened simultaneously for safety reasons.

===Hosts and Clients===
This guide references '''host''' computers and '''client''' computers.
*'''Host''': a computer or Wireless VINT Hub that is physically connected to Phidget devices and is running the Phidget Network Server.
*'''Client''': a computer running an application that accesses Phidget channels via the Phidget Server. The Phidget Network Server does '''not''' need to run on the client computer.

A single computer can act as both a host and a client. A Wireless VINT Hub (HUB5000) can only act as a host.

==Running the Phidget Network Server==
<tabber>
Windows=

On Windows machines, start by [[OS_-_Windows#Install|installing our libraries]]. Next, open the [[Phidget Control Panel|Phidget Control Panel]] on your host computer and navigate to the ''Network Server'' tab:

[[Image:Windows_networkserver.PNG|link=https://cdn.phidgets.com/docs/images/f/f4/Windows_networkserver.PNG|center]]

There are various [[#Network_Server_Settings|configuration settings]] for the Phidget Network Server. For now, press '''Start''' in the bottom right corner and navigate back to the Phidgets tab.

[[Image:Windows_controlpanel_remote.PNG|center|link=https://cdn.phidgets.com/docs/images/5/55/Windows_controlpanel_remote.PNG|500px]]

As shown above, the Phidget server is now making your channels available to other computers on your network. You can view/hide remote channels in the Phidget Control Panel by navigating to ''File > Options > List Remote Phidgets''.
|-|
macOS=

On macOS machines, start by [[OS_-_macOS#Install|installing our libraries]]. Next, open the [[Phidget_Control_Panel|Phidget Control Panel]] on your host computer and navigate to the ''Network Server'' tab:

[[File:macos_networkserver.png|600px|link=https://cdn.phidgets.com/docs/images/0/0c/Macos_networkserver.png|center]]

There are various [[#Network_Server_Settings|configuration settings]] for the Phidget Network Server. For now, press '''Start''' at the top of the screen and navigate back to the Phidgets tab.

[[File:macos_controlpanel_remote.png|link=https://cdn.phidgets.com/docs/images/c/ca/Macos_controlpanel_remote.png|center]]

As shown above, the Phidget Server is now making your channels available to other computers on your network.
|-|
Linux=

On Linux machines, start by [[OS_-_Linux#Install|installing our libraries]], specifically ''phidget22networkserver'' and ''phidget22admin''. The Phidget Network Server will start automatically after installing from packages.

Open the terminal on the client and type in the following command:
<syntaxhighlight lang=bash>
phidget22admin -s
</syntaxhighlight>
[[File:Linux_networkserver_phidgetadmin.PNG|link=https://cdn.phidgets.com/docs/images/4/4a/Linux_networkserver_phidgetadmin.PNG|center|850px]]

This will list all of the Phidget servers on your network. Confirm that you can see a Phidget server running on your host computer.

After you have confirmed your server is running, type in the following command:
<syntaxhighlight lang=bash>
phidget22admin -R -d
</syntaxhighlight>

This command will list all remote Phidgets on the network. Confirm that you can see the Phidgets attached to your host computer:
[[File:Linux_networkserver_phidadminlist.PNG|link=https://cdn.phidgets.com/docs/images/4/49/Linux_networkserver_phidadminlist.PNG|center]]
|-|
Wireless VINT Hub=

The Wireless VINT Hub will automatically run the Phidget Network Server on boot. No configuration is required. Please note that The Wireless VINT Hub is not able to manage dictionaries.
|-|
PhidgetSBC4=

The PhidgetSBC4 comes with the Phidget Network Server installed, and the SBC automatically starts the Phidget Network Server on boot. Open the web interface and navigate to '''Phidgets''' > '''phidget22Network Server''' to see the status.

[[File:Networkserver_sbc_boot.png|link=https://cdn.phidgets.com/docs/images/a/a7/Networkserver_sbc_boot.png|alt=|center|700px]]
</tabber>

==Connecting to Remote Phidgets==
After you have the [[#Running the Phidget Network Server|Phidget Network Server running]], you can access remote Phidget channels from a client computer.

===Networking API===
To access remote channels in your application, you will need to use our '''Networking API'''. Navigate to our [https://www.phidgets.com/?view=api API] and select Networking from the dropdown menu.
[[Image:Api_dropdown_networking.jpg|600px|center|link=https://cdn.phidgets.com/docs/images/2/2a/Api_dropdown_networking.jpg]]

Here you will see all relevant methods and events. There are two primary ways to connect to remote channels in your application:
# Specify hostname/IP address (recommended)
# Enable server discovery

Continue reading for more information.

====Connecting via Hostname/IP Address (Recommended)====
Specifying a hostname or IP address in your code is recommended for most applications. Examples of how to do this in various languages are shown below:

<tabber>
Python=<syntaxhighlight lang=python>
from Phidget22.Net import *

Net.addServer("ServerName", "hostname/IP address", 5661, "password", 0)
</syntaxhighlight>
|-|
Java=<syntaxhighlight lang=java>
Net.addServer("ServerName", "hostname/IP address", 5661, "password", 0);
</syntaxhighlight>
|-|
C#=<syntaxhighlight lang=cSharp>
Net.AddServer("ServerName", "hostname/IP address", 5661, "password", 0);
</syntaxhighlight>
|-|
C=<syntaxhighlight lang=c>
PhidgetNet_addServer("ServerName", "hostname/IP address", 5661, "password", 0);
</syntaxhighlight>
|-|
JavaScript=
<syntaxhighlight lang=javascript>
const conn = new phidget22.NetworkConnection(5661, "hostname")
await conn.connect()
</syntaxhighlight>
</tabber>

=====Hostname vs IP Address=====
For most applications, using a hostname to add a server is preferred (such as 'localhost' or 'hub5000.local'). This approach allows your application to adapt seamlessly to network changes. However, in certain scenarios, assigning a static IP address to your host may provide additional benefits.

====Enabling Server Discovery====
By enabling server discovery, you can access any Phidget server on your network that is published (see [[#Phidget_Server|Phidget server settings]] for more information about publishing). Examples of how to do this in various languages are shown below:

<tabber>
Python=<syntaxhighlight lang=python>
Net.enableServerDiscovery(PhidgetServerType.PHIDGETSERVER_DEVICEREMOTE)
</syntaxhighlight>
|-|
Java=<syntaxhighlight lang=java>
Net.enableServerDiscovery(ServerType.DEVICE_REMOTE);
</syntaxhighlight>
|-|
C#=<syntaxhighlight lang=cSharp>
Net.EnableServerDiscovery(ServerType.DeviceRemote);
</syntaxhighlight>
|-|
C=<syntaxhighlight lang=c>
PhidgetNet_enableServerDiscovery(PHIDGETSERVER_DEVICEREMOTE);
</syntaxhighlight>
|-|
JavaScript=

Server discovery is not available in JavaScript due to networking restrictions.
</tabber>
=====Considerations=====
Enabling server discovery is useful for certain applications. For example, if you need to manage a dynamic list of devices, similar to the Phidget Control Panel. It can also be useful during development, when devices and networks are changing frequently. For most applications and when deploying applications, [[#Connecting via Hostname/IP Address (Recommended)| connecting via hostname/IP address]] is recommended.

When using server discovery, review the following:
* A Phidget server must be [[#Phidget Server|published]] in order to connect to it.
* Windows machines must have [https://developer.apple.com/bonjour/ Bonjour] installed on both the host computer and the client computer. [https://phidgets.com/downloads/misc/Bonjour64.msi Download it here].
* Linux machines require Avahi which is typically preinstalled. It can also be easily installed with {{Code|apt install libavahi-client3 avahi-daemon}}
* macOS machines require Bonjour which is always preinstalled, so no further configuration is required.

===Code Samples===
In this example, a Light Phidget (LUX1000) is plugged into a Wireless VINT Hub (HUB5000) which runs the Phidget Network Server. On a client machine, this code is used to remotely access the light sensor and sample
5 seconds of data.
<tabber>
Python=<syntaxhighlight lang='python'>
from Phidget22.Phidget import *
from Phidget22.Net import *
from Phidget22.Devices.LightSensor import *
import time

def onIlluminanceChange(self, illuminance):
print("Illuminance: " + str(illuminance))

def main():
Net.addServer("PHIDGETS-PC", "hub5000.local", 5661, "", 0);

lightSensor0 = LightSensor()

lightSensor0.setIsRemote(True)
lightSensor0.setDeviceSerialNumber(37299)

lightSensor0.setOnIlluminanceChangeHandler(onIlluminanceChange)

lightSensor0.openWaitForAttachment(20000)

time.sleep(5)

lightSensor0.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 {
Net.addServer("PHIDGETS-PC", "hub5000.local", 5661, "", 0);

LightSensor lightSensor0 = new LightSensor();

lightSensor0.setIsRemote(true);
lightSensor0.setDeviceSerialNumber(37299);

lightSensor0.addIlluminanceChangeListener(new LightSensorIlluminanceChangeListener() {
public void onIlluminanceChange(LightSensorIlluminanceChangeEvent e) {
System.out.println("Illuminance: " + e.getIlluminance());
}
});

lightSensor0.open(20000);

Thread.sleep(5000);

lightSensor0.close();
}
}
</syntaxhighlight>
|-|
C#=<syntaxhighlight lang='CSharp'>
using System;
using Phidget22;

namespace ConsoleApplication
{
class Program
{

private static void LightSensor0_IlluminanceChange(object sender, Phidget22.Events.LightSensorIlluminanceChangeEventArgs e)
{
Console.WriteLine("Illuminance: " + e.Illuminance);
}

static void Main(string[] args)
{
Net.AddServer("PHIDGETS-PC", "hub5000.local", 5661, "", 0);

LightSensor lightSensor0 = new LightSensor();

lightSensor0.IsRemote = true;
lightSensor0.DeviceSerialNumber = 37299;

lightSensor0.IlluminanceChange += LightSensor0_IlluminanceChange;

lightSensor0.Open(20000);

System.Threading.Thread.Sleep(5000);

lightSensor0.Close();
}
}
}
</syntaxhighlight>
|-|
C=<syntaxhighlight lang=cpp>
#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 onIlluminanceChange(PhidgetLightSensorHandle ch, void * ctx, double illuminance) {
printf("Illuminance: %lf\n", illuminance);
}

int main() {
PhidgetLightSensorHandle lightSensor0;

PhidgetNet_addServer("PHIDGETS-PC", "hub5000.local", 5661, "", 0);

PhidgetLightSensor_create(&lightSensor0);

Phidget_setIsRemote((PhidgetHandle)lightSensor0, 1);
Phidget_setDeviceSerialNumber((PhidgetHandle)lightSensor0, 37299);

PhidgetLightSensor_setOnIlluminanceChangeHandler(lightSensor0, onIlluminanceChange, NULL);

Phidget_openWaitForAttachment((PhidgetHandle)lightSensor0, 20000);

Sleep(5000);

Phidget_close((PhidgetHandle)lightSensor0);

PhidgetLightSensor_delete(&lightSensor0);
}

</syntaxhighlight>
|-|
JavaScript=<syntaxhighlight lang=javascript>
const phidget22 = require('phidget22');

async function runExample() {
const conn = new phidget22.NetworkConnection(5661, 'hub5000.local');
try {
await conn.connect();
} catch(err) {
console.error('Error during connect', err);
process.exit(1);
}

const lightSensor0 = new phidget22.LightSensor();

lightSensor0.setDeviceSerialNumber(37299);

lightSensor0.onIlluminanceChange = (illuminance) => {
console.log('Illuminance: ' + illuminance.toString());
};

try {
await lightSensor0.open(5000);
} catch(err) {
console.error('Error during open', err);
process.exit(1);
}

setTimeout(async () => {
await lightSensor0.close();
conn.close();
conn.delete();
}, 5000);
}

runExample();
</syntaxhighlight>
</tabber>

====Code Sample Generator====
The code sample above was generated using our [{{SERVER}}/?view=code_samples Code Sample Generator]. To generate Network-enabled code for a specific device, select the '''Remote''' checkbox and specify a hostname.

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

==Webserver==
The Phidget Network Server includes a built-in web server and is required for supporting the Phidget JavaScript library for in-browser use.
* On Windows and macOS, a JavaScript version of the Phidget Control panel is served on port 8989 (http://localhost:8989) by default.
* On Linux machines, PhidgetSBC4, and the Wireless VINT Hub, a JavaScript version of the Phidget Control panel is served on port 8080 (http://localhost:8080) by default.

[[Image:Networkserver_webserver_controlpanel.jpg|center|500px|link=https://cdn.phidgets.com/docs/images/c/c7/Networkserver_webserver_controlpanel.jpg]]

===Enabling the Webserver===
On Windows and macOS, you can enable the web server through the Phidget Control Panel:

[[Image:enable_webserver.jpg|center|800px|link=https://cdn.phidgets.com/docs/images/0/08/Enable_webserver.jpg]]

On Linux, you can enable it in the Phidget Network Server configuration file located at ''/etc/phidgets/phidget22networkserver.pc''. Modify '''enabled''' to '''true''' in the '''www''' section.

===Considerations===
The primary purpose of the Webserver is to support a Websockets connection for the in-browser JavaScript library - because regular sockets cannot be used in-browser.

==Dictionaries==
The Phidget Network Server allows you to publish Phidget Dictionaries on your network. Dictionaries provide a convenient method of sharing information between applications. For more information, view our [[Phidget_Dictionary|Phidget Dictionaries Guide]].

==Upgrading the Phidget Network Server==
From time to time, you may consider upgrading your Phidget Network Server (i.e. your Phidget libraries). There are several reasons to do this, for example:
* Your application needs to support a new device.
* The [{{SERVER}}/?view=changelog Phidget22 Changelog] indicates that there was an improvement or bug fix that is relevant to your application. Consider signing up for Phidget22 Changelog notifications to stay updated.

When upgrading your Phidget libraries, you should ensure your host and client are on the same version for the best performance.

===Host: Determining Version===
Select the operating system of your host for more information.
<tabber>
Windows=

On Windows, the Phidget Network Server is managed from the Phidget Control Panel. Open the Phidget Control Panel and navigate to '''Help > About Phidget Control Panel''' to see the library version you are running.

[[Image:Networkserver_controlpanel_about_windows.png|link=https://cdn.phidgets.com/docs/images/f/f7/Networkserver_controlpanel_about_windows.png|center]]
|-|
macOS=

On macOS, the Phidget Network Server is managed from the Phidget Control Panel. Open the Phidget Control Panel and navigate to '''Phidget Control Panel > About Phidget Control Panel''' to see the library version you are running.

[[Image:Networkserver_controlpanel_about_mac.png|link=https://cdn.phidgets.com/docs/images/c/cd/Networkserver_controlpanel_about_mac.png|400px|center]]
|-|
Linux=

On Linux, open a terminal and enter the following command

<syntaxhighlight lang=bash>
apt show libphidget22
</syntaxhighlight>

[[Image:Networkserver_controlpanel_about_linux.png|center|400px|link=https://cdn.phidgets.com/docs/images/0/02/Networkserver_controlpanel_about_linux.png]]

|-|
Wireless VINT Hub=

On the Wireless VINT Hub (HUB5000), navigate to the web interface, select the '''Phidgets''' tab, and then select the '''View''' button.
[[Image:Networkserver_controlpanel_about_hub5000_1.png|center|400px|link=https://cdn.phidgets.com/docs/images/0/0c/Networkserver_controlpanel_about_hub5000_1.png]]

You will now see the Phidget log. At the top of the file, you will see the library version:
[[Image:Networkserver_controlpanel_about_hub5000_2.png|center|400px|link=https://cdn.phidgets.com/docs/images/6/6b/Networkserver_controlpanel_about_hub5000_2.png]]

|-|
PhidgetSBC=

On the PhidgetSBC, navigate to the web interface and select the '''Status > System''' tab.

[[Image:Networkserver_controlpanel_about_sbc.png|center|400px|link=https://cdn.phidgets.com/docs/images/7/7c/Networkserver_controlpanel_about_sbc.png]]
</tabber>

===Client: Determining Version===
There are several ways to determine the version of the Phidget library used in your application. Below are some recommended methods.
====Phidget Logging====
If you have [[Phidget_Logging|Phidget Logging]] enabled in your application (recommended), you can view the library version that your project is using at the top of the log file.

[[Image:Networkserver_phidgetlog_version.png|center|500px|link=Networkserver_phidgetlog_version.png]]

====Phidget API====
The Phidget API makes it easy to verify the version of the Phidget libraries that your application is using. View the code samples below for more information.
<tabber>
Python=<syntaxhighlight lang='python'>
from Phidget22.Phidget import *
from Phidget22.Devices.VoltageInput import *

libraryVersion = Phidget.getLibraryVersion()
print("LibraryVersion: " + str(libraryVersion))

</syntaxhighlight>
|-|
Java=<syntaxhighlight lang='Java'>
import com.phidget22.*;

class Example {
public static void main(String[] args) {
try {
java.lang.String LibraryVersion = Phidget.getLibraryVersion();
} catch (PhidgetException ex) {
System.out.println("Failure: " + ex);
}
}
}
</syntaxhighlight>
|-|
C#=<syntaxhighlight lang='CSharp'>
using System;
using Phidget22;

class Program {
static void Main(string[] args) {
try {
string LibraryVersion = Phidget.LibraryVersion;
} catch (PhidgetException ex) {
Console.WriteLine("Failure: " + ex.Message);
}
}
}
</syntaxhighlight>
|-|
C=<syntaxhighlight lang=cpp>
int main() {
PhidgetReturnCode res;
const char *libraryVersion;

res = Phidget_getLibraryVersion(&libraryVersion);
if (res != EPHIDGET_OK)
return 1; // Exit in error

return 0;
}

</syntaxhighlight>
|-|
JavaScript=<syntaxhighlight lang=javascript>
// NOTE: This shows importing phidget22 in Node.JS. In-Browser JavaScript import is different
const phidget22 = require("phidget22");

async function main() {
const libraryVersion = Phidget.libraryVersion;
console.log("libraryVersion: " + libraryVersion);

}

main();
</syntaxhighlight>
</tabber>

==Phidget Network Server Logging==
The host computer will generate a Phidget Network Server log file. Select the operating system of your host below for information about where this log file can be found.
<tabber>
Windows=

On Windows, the Phidget Network Server log file is located at:

<code>C:\ProgramData\Phidgets\logs\Phidget22NetworkServer_networkserver.log</code>

You can also navigate here by opening the Phidget Control Panel an selecting '''Help''' > '''Open Logs Folder'''.
|-|
macOS=

On macOS, the Phidget Network Server log file is located at:

<code>/Library/Logs/phidget22networkserver.log</code>
|-|
Linux=

On Linux, the Phidget Network Server log file is located at:

<code>/var/log/phidget22networkserver.log</code>
|-|
Wireless VINT Hub=

On the Wireless VINT Hub (HUB5000), open the web interface and navigate to the '''Phidgets''' tab. Select the '''View''' button to view the log file.

[[Image:Networkserver_controlpanel_about_hub5000_1.png|center|400px|link=link=Networkserver_controlpanel_about_hub5000_1.png]]
|-|
PhidgetSBC4=

On the PhidgetSBC4, the Phidget Network Server log file is located at:

<code>/var/log/phidget22networkserver.log</code>
</tabber>

==Phidget Network Server Settings==
===Operating System===
There are a number of settings related to the Phidget Network Server. Select your operating system for more information about how to modify these settings.
<tabber>
Windows=

On Windows, you can adjust settings by opening the Phidget Control Panel and navigating to the '''Network Server''' tab.
|-|
macOS=

On macOS, you can adjust settings by opening the Phidget Control Panel and navigating to the '''Network Server''' tab.
|-|
Linux=

On Linux, you can adjust settings by navigating to the network server configuration file located at ''/etc/phidgets/phidget22networkserver.pc''.

|-|
Wireless VINT Hub=

On the Wireless VINT Hub (HUB5000), you can adjust settings through the web interface by navigating to the '''Phidgets''' tab.

|-|
PhidgetSBC=

On the PhidgetSBC, you can adjust settings through the web interface by navigating to the Phidgets Tab and then the '''phidget22 Network Server''' tab.
</tabber>

===Basic Settings===
====Startup Type====
{| class="wikitable" style="margin:auto"
|-
! Setting!! Description
|-
| Automatic || The Phidget Network Server will start automatically every time your machine boots.
|-
| Manual || The Phidget Network Server needs to be started manually. It will not restart when your machine boots. Another service may also start it when in Manual mode.
|-
| Disabled || The Phidget Network Server is disabled. This will disable all components, including the Phidget Server, the Webserver, and any Dictionaries. Other services will not be able to start it.
|}

====Phidget Server====
{| class="wikitable" style="margin:auto"
|-
! Setting!! Description
|-
| Enabled || Enables the Phidget Server. When enabled, client computers on your network will be able to access Phidgets that are connected to your computer.
|-
| Publish || This will determine if the Phidget Server should publish itself to mDNS. If you plan to use the {{Code|EnableServerDiscovery}} method in your applications, you must publish your Phidget Server. Otherwise, this can be disabled.
|-
| Server Name || Specify the name of your server. A {{Code|setServerName}} method is available when [[Addressing_Phidgets|addressing your channels]]. If you plan to use the {{Code|EnableServerDiscovery}} method in your applications, the Server Name can be used to enable or disable servers. The default server name is the computer name (hostname on Linux machines, Wireless VINT Hub, and PhidgetSBC4). This means if you do not specify a server name, your server name may change if your change your computer name or hostname.
|-
| Port || Specify the Phidget server port. ''Defaults to 5661''.
|-
| Password (optional) || This will determine if a password is required to access channels on the Phidget server.
|-
| Log Level|| When running, the Phidget Network Server will generate [[#Phidget Network Server Logging|logs]]. Use these options to configure the [[Phidget_Logging#Log_Levels|log level]]. Defaults to ''Info''.
|}

====Webserver====
{| class="wikitable" style="margin:auto"
|-
! Setting!! Description
|-
| Enabled || Enables the web server. The web server enables connections from the in-browser JavaScript library and allows hosting of files.
|-
| Port || Specify the web server port. Defaults to ''8989''.
|-
| Docroot|| Specify the location of your web server files.
|}

====Dictionaries====
{| class="wikitable" style="margin:auto"
|-
! Setting !! Description
|-
| Enabled User Dictionaries || Enables user dictionaries. These are useful for sharing information between applications.
|-
| Enable Monitoring/control Dictionary || Enables a monitoring/control dictionary that provides information about incoming/outgoing traffic related to your Phidget Network Server.
|}

For more information about dictionaries, view our [[Phidget_Dictionary|Phidget Dictionaries Guide]].

===Advanced Settings===
Advanced settings are available through a configuration file. Select the operating system of your host below for more information.

<tabber>
Windows=

For advanced settings, you can edit the configuration file directly by navigating to ''C:\ProgramData\Phidgets\phidget22networkserver.pc''. Refer to the Phidget Network Server Linux [[Media:PHIDGETNETWORKSERVER_README.txt| README]] for more information.
|-|
macOS=

For advanced settings, you can edit the configuration file directly by navigating to ''/Library/Preferences/Phidget22NetworkServer/phidget22networkserver.pc''. Refer to the Phidget Network Server Linux [[Media:PHIDGETNETWORKSERVER_README.txt| README]] for more information.
|-|
Linux=

On Linux, you can adjust settings by navigating to the network server configuration file located at ''/etc/phidgets/phidget22networkserver.pc''. Refer to the Phidget Network Server Linux [[Media:PHIDGETNETWORKSERVER_README.txt| README]] for more information.

You can also point the Phidget Network Server towards your own configuration file with the following command:
<syntaxhighlight lang=bash>
phidget22networkserver -c /path/to/configuration/file
</syntaxhighlight>

|-|
Wireless VINT Hub=

Advanced settings are not available on the Wireless VINT Hub.

|-|
PhidgetSBC=

For advanced settings, you can edit the configuration file directly by navigating to ''/etc/phidgets/phidget22networkserver.pc''. Refer to the Phidget Network Server Linux [[Media:PHIDGETNETWORKSERVER_README.txt| README]] for more information.

</tabber>

OS - macOS

2025-08-14T18:59:33Z

Patrick:

[[Category:OS]]

==Getting Started with macOS==
Welcome to using Phidgets with macOS!

Phidget22 is supported on '''macOS 10.11 and newer'''.

To get started, install our libraries.

===Quick Downloads===
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22.dmg macOS Installer Download]
* [https://cdn.phidgets.com/downloads/phidget22/tools/macos/Phidget22ControlPanel.dmg macOS Standalone Control Panel]
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip macOS Development Files]

===Install===
To begin, select which version of our installer to use:
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22.dmg Installer]
** Installs Phidget development libraries globally for use in C, Java or Max.
** Includes the Phidget Control Panel and the Phidget Network Server.
** May Require changing security settings on Apple Silicon macs. See here [https://support.apple.com/en-ca/guide/mac-help/mchl768f7291/mac].

* [https://cdn.phidgets.com/downloads/phidget22/tools/macos/Phidget22ControlPanel.dmg Standalone]
** Self contained Application; no installer.
** Includes the Phidget Control Panel and the Phidget Network Server.
** Requires macOS 10.15 or newer.

Open up the installer, and double click on ''Phidgets.pkg'' to install the libraries:
[[File:OSX Install 1.png|link=|alt=macOS Install|center]]

When prompted, continue with the installation:
[[File:OSX Install 2.png|link=|alt=macOS Install|center]]

If you are using macOS 10.13 or newer you will also need to give explicit permission for the driver to function. You can read about this here [https://support.apple.com/en-us/120363].

The Phidgets libraries are now installed on your machine. Next, let's verify that the Phidget libraries are working properly.

===Verify===
The best way to verify that your libraries are working properly is to use the Phidget Control Panel. The Phidget Control Panel is a powerful tool that will help you develop your Phidgets applications. Get started by following the instructions below:

Open Finder and navigate to the Phidget Control Panel in the Applications list:
[[File:OSX Finder Apps.png|link=|800px|alt=macOS Finder Apps|center]]

Double click on the Phidgets icon to bring up the Phidget Control Panel. You can now see all the Phidgets that are plugged into your machine, as well as any Phidgets that are on the network:
[[File:OSX ControlPanel General.png|600px|link=|alt=macOS Control Panel General|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:OSX Control Panel Channel.png ‎|link=|alt=macOS Control Panel Channel|center]]

The Phidget Control Panel can be used for testing devices, updating firmware, enabling a network server, and more! Visit the [[Phidget Control Panel#macOS|Phidget Control Panel]] page if you want to delve a little deeper.

Your Phidget is now able to communicate with your development machine. The next step is selecting a programming language so you can start to write some code!

==Programming==
Ready to write some code? Select one of the programming languages below:

{{Programming_Languages_Table}}

===Development Files===
If you're a developer and want to bundle the Phidget libraries with your application for distribution, download the [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip macOS Development Files]. See the included README for more details.

===Older Versions===
If you need older versions of the macOS libraries, [{{SERVER}}/downloads/phidget22/libraries/macos/Phidget22/ click here].

===Software License===
By downloading the macOS installer 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 [https://opensource.org/licenses/BSD-3-Clause The 3-Clause BSD License].

OS - macOS

2025-08-14T18:52:41Z

Patrick:

[[Category:OS]]

==Getting Started with macOS==
Welcome to using Phidgets with macOS!

Phidget22 is supported on '''macOS 10.11 and newer'''.

To get started, install our libraries.

===Quick Downloads===
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22.dmg macOS Installer Download]
* [https://cdn.phidgets.com/downloads/phidget22/tools/macos/Phidget22ControlPanel.dmg macOS Standalone Control Panel]
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip macOS Development Files]

===Install===
To begin, select which version of our installer to use:
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22.dmg Installer]
** Installs Phidget development libraries globally for use in C, Java or Max.
** Includes the Phidget Control Panel and the Phidget Network Server.
** May Require changing security settings on Apple Silicon macs. See here [https://support.apple.com/en-ca/guide/mac-help/mchl768f7291/mac].

* [https://cdn.phidgets.com/downloads/phidget22/tools/macos/Phidget22ControlPanel.dmg Standalone]
** Self contained Application; no installer.
** Includes the Phidget Control Panel and the Phidget Network Server.
** Requires macOS 10.15 or newer.

Open up the installer, and double click on ''Phidgets.pkg'' to install the libraries:
[[File:OSX Install 1.png|link=|alt=macOS Install|center]]

When prompted, continue with the installation:
[[File:OSX Install 2.png|link=|alt=macOS Install|center]]

If you are using macOS 10.13 or newer you will also need to give explicit permission for the driver to function. You can read about this here [https://developer.apple.com/library/content/technotes/tn2459/_index.html].

The Phidgets libraries are now installed on your machine. Next, let's verify that the Phidget libraries are working properly.

===Verify===
The best way to verify that your libraries are working properly is to use the Phidget Control Panel. The Phidget Control Panel is a powerful tool that will help you develop your Phidgets applications. Get started by following the instructions below:

Open Finder and navigate to the Phidget Control Panel in the Applications list:
[[File:OSX Finder Apps.png|link=|800px|alt=macOS Finder Apps|center]]

Double click on the Phidgets icon to bring up the Phidget Control Panel. You can now see all the Phidgets that are plugged into your machine, as well as any Phidgets that are on the network:
[[File:OSX ControlPanel General.png|600px|link=|alt=macOS Control Panel General|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:OSX Control Panel Channel.png ‎|link=|alt=macOS Control Panel Channel|center]]

The Phidget Control Panel can be used for testing devices, updating firmware, enabling a network server, and more! Visit the [[Phidget Control Panel#macOS|Phidget Control Panel]] page if you want to delve a little deeper.

Your Phidget is now able to communicate with your development machine. The next step is selecting a programming language so you can start to write some code!

==Programming==
Ready to write some code? Select one of the programming languages below:

{{Programming_Languages_Table}}

===Development Files===
If you're a developer and want to bundle the Phidget libraries with your application for distribution, download the [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip macOS Development Files]. See the included README for more details.

===Older Versions===
If you need older versions of the macOS libraries, [{{SERVER}}/downloads/phidget22/libraries/macos/Phidget22/ click here].

===Software License===
By downloading the macOS installer 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 [https://opensource.org/licenses/BSD-3-Clause The 3-Clause BSD License].

Language - Python

2025-06-05T22:27:22Z

Patrick:

{{#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====
Phidget devices running a HID USB stack require the installation of the macOS libraries or the standalone Phidget Control Panel ([{{SERVER}}/docs/OS_-_macOS download here]).

To determine what USB stack your Phidget device is on, 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/7/75/Windows_pycharm_settings.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 Code Sample Generator] and select Python 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]]

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

OS - Linux

2025-06-05T22:17:34Z

Patrick:

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

==Getting Started with Linux==
Welcome to using Phidgets with Linux!

===Install===
The first step to using Phidgets with Linux is installing the Phidget22 libraries.

We provide prebuilt packages for Debian, Ubuntu, and their derivatives.

If you're running a supported distros, we recommend using the '''Package Install'''. For other systems, you can use the '''Source Install'''.

<div class="bigTabs">
<tabber>
|-|Package Install=
{{LinuxPackageInstall}}

|-|Source Install=
====Source Install====
To install our libraries, first install libusb-1.0 development libraries. The exact command and package name will vary depending on distribution. For Debian based distributions, including Ubuntu and Mint, the command would be:
<syntaxhighlight lang=bash>
apt install libusb-1.0-0-dev
</syntaxhighlight>

Next, download and unpack the following files:
*[https://cdn.phidgets.com/downloads/phidget22/libraries/linux/libphidget22.tar.gz libphidget22] (Mandatory)
*[https://cdn.phidgets.com/downloads/phidget22/libraries/linux/libphidget22extra.tar.gz libphidget22extra] (Optional - needed by NetworkServer and Admin)
*[https://cdn.phidgets.com/downloads/phidget22/libraries/linux/libphidget22java.tar.gz libphidget22java] (Optional - Java Libraries)
*[https://cdn.phidgets.com/downloads/phidget22/servers/linux/phidget22networkserver.tar.gz phidget22networkserver] (Optional - [[Phidget Network Server]])
*[https://cdn.phidgets.com/downloads/phidget22/tools/linux/phidget22admin.tar.gz phidget22admin] (Optional - Phidget Admin Tool)
Open the README file that is included at the top of each directory. This file will give you important information about how to properly install the files.

Libraries are installed in /usr/local/lib by default. If you run into trouble finding the libraries during linking or at runtime, this probably means that /usr/local/lib is not on the library path for your distribution.

You can handle this in a number of ways:

Specify a different install folder during compile
<syntaxhighlight lang=bash>./configure --prefix=/usr && make && sudo make install</syntaxhighlight>
OR Add /usr/local/lib to the system-wide library path
<syntaxhighlight lang=bash>echo /usr/local/lib >> /etc/ld.so.conf && sudo ldconfig</syntaxhighlight>
OR Add /usr/local/lib in your local shell every time
<syntaxhighlight lang=bash>export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib</syntaxhighlight>

The libraries are now installed on your machine. Next, you should set the UDev Rules.
</tabber>
</div>

=== Setting udev Rules ===
By default, Linux restricts regular users from accessing physical hardware for security reasons. As a result, you typically need root privileges to access Phidgets. For example:
<syntaxhighlight lang=bash>
sudo ./HelloWorld
</syntaxhighlight>

To avoid using sudo every time, you can set up a udev rules file that automatically grants access based on Phidget's USB vendor ID. Create a file named 99-libphidget22.rules with the following content:
<syntaxhighlight lang=bash>
# All current and future Phidgets - Vendor = 0x06c2, Product = 0x0030 - 0x00af
SUBSYSTEMS=="usb", ACTION=="add", ATTRS{idVendor}=="06c2", ATTRS{idProduct}=="00[3-a][0-f]", MODE="666"
</syntaxhighlight>

The MODE="666" grants read/write access to the matching device for all users. Save this file to "/etc/udev/rules.d". Once in place, you'll be able to run Phidget programs as a regular user without permission issues.

===Verify===
The best way to verify that your libraries are working properly is to compile and run an example program.

First, download and unpack this C example:
*[https://cdn.phidgets.com/downloads/phidget22/examples/c/Manager/Phidget22_HelloWorld_C_Ex.zip HelloWorld C example]

'''Note:''' If using the Debian intallation methods, you will need to install the '''libphidget22-dev''' package to use the C libraries for Phidget22

Next, open the terminal at the example location. Compile the example by entering the following command:
<syntaxhighlight lang=bash>
gcc HelloWorld.c -o HelloWorld -lphidget22
</syntaxhighlight>

Run the HelloWorld example:
<syntaxhighlight lang=bash>
./HelloWorld
</syntaxhighlight>

Your terminal should look something like this:
[[File:linux_helloworld.PNG|link=|center]]

The HelloWorld program will simply communicate when a Phidget has been attached or detached, as can be seen in the image above.

Your Phidget is now able to communicate with your development machine. The next step is selecting a programming language so you can start to write some code!

==Programming==
Ready to write some code? Select one of the programming languages below:

{{Programming_Languages_Table}}

==Older Versions==
If you need older versions of the Phidget22 Linux libraries, [{{SERVER}}/downloads/phidget22/libraries/linux/libphidget22/ click here].

If you need Phidget21 Linux Libraries, [{{SERVER}}/downloads/phidget21/libraries/linux/libphidget/ click here].

==Software License==
By downloading Linux Source you agree to adhere to the terms of the [https://opensource.org/licenses/BSD-3-Clause The 3-Clause BSD License].

Language - JavaScript

2025-05-26T18:46:13Z

Patrick:

{{#seo:|description=Learn how to use Phidget USB devices with JavaScript.}}
[[Category:Language]]
==Get Started==
JavaScript is supported for browser and Node.js applications. Phidget devices can be accessed either directly through a [[#USB Connection | USB Connection]] or indirectly through a [[#Network Connection | Network Connection]].

==JavaScript Libraries==
===Browser Applications===
For browser applications, you can load the library directly from UNPKG:
<syntaxhighlight lang=javascript>
<script src="https://unpkg.com/phidget22@3.x/browser/phidget22.min.js"></script>
</syntaxhighlight>

Compiled and minified library files are also available [https://www.phidgets.com/downloads/phidget22/libraries/any/Phidget22JavaScript.zip here].

===Node.js Applications===
For Node.js applications, a [https://www.npmjs.com/package/phidget22 npm package] is available and can be installed with the following command:
<syntaxhighlight lang=javascript>
npm install phidget22
</syntaxhighlight>

==USB Connection==
Browser and Node.js applications can access Phidget devices directly via USB.

===Supported Devices===
USB connections with JavaScript are supported on Phidget devices running a PHIDUSB USB stack. To determine what USB stack your Phidget device is on, 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|500px|link=https://cdn.phidgets.com/docs/images/8/80/Javascript_networkserver_webusb_spec.png]]
<br><br>

===Browser Applications===
====Supported Browsers====
In-browser USB connections are achieved through the WebUSB API. This API is currently supported by Chromium-based browsers like Google Chrome and Microsoft Edge.

====JavaScript Control Panel (USB)====
You can experiment with browser-based USB applications by opening the JavaScript Phidget Control Panel:
* [https://www.phidgets.com/controlpanel phidgets.com/controlpanel]

Click on the ''Connect USB Device'' button to give the website permission to access your device.

[[Image:Javascript_networkserver_webusb_contropanel1.jpg|600px|center|link=https://cdn.phidgets.com/docs/images/9/9d/Javascript_networkserver_webusb_contropanel1.jpg]]

After granting permission, your device will be accessible from the control panel.

====USB Permission====
As demonstrated above, websites must request access to communicate with USB devices. This must be implemented through an interactive element, like a button. Use the '''requestWebUSBDeviceAccess''' method in the Phidget USBConnection API for this purpose.

[[Image:Javascript_networkserver_browser_api.png|center|500px|link=https://cdn.phidgets.com/docs/images/8/88/Javascript_networkserver_browser_api.png]]

===Example Code===
Navigate to our [https://www.phidgets.com/?view=code_samples Code Sample Generator] to view code samples for both browser and Node.js applications that are tailored to your specific device.

Make sure to '''uncheck''' the ''Remote (Network)'' box when using a direct USB connection. If you leave this box checked, your application will look for a [[#Network Connection | Network Connection]].

[[Image:Javascript_networkserver_webusb_codesample.png|center|500px|link=https://cdn.phidgets.com/docs/images/5/5f/Javascript_networkserver_webusb_codesample.png]]
<br><br>

==Network Connection==
Browser and Node.js applications can connect to Phidget devices through the [[Phidget Network Server]]. In this configuration, client applications can run on machines that don't have Phidget devices physically connected to them.

===Running the Phidget Network Server===
Before starting, ensure you are [{{SERVER}}/docs/Network_Server_Guide#Running_the_Phidget_Network_Server running the Phidget Network Server] on your host machine.
===Browser Considerations===
When using a Network Connection in a browser-based application, you must [{{SERVER}}/docs/Network_Server_Guide#Enabling_the_Webserver enable the web server] on your host machine.

====JavaScript Control Panel (Network)====
You can experiment with browser-based Network applications by opening the JavaScript Phidget Control Panel:
* If your host is a Windows or macOS machine, visit port 8989 (http://localhost:8989).
* If your host is a Linux machine, a PhidgetSBC, or a Wireless VINT Hub, visit port 8080 (http://localhost:8080).

If you are accessing the JavaScript Control Panel from a machine that is not the host, you will need to enter the IP address or hostname in place of localhost (e.g. http://phidgetsbc:8080).

[[Image:Networkserver_webserver_controlpanel.jpg|center|500px|link=https://cdn.phidgets.com/docs/images/c/c7/Networkserver_webserver_controlpanel.jpg]]

===Example Code===
Navigate to our [https://www.phidgets.com/?view=code_samples Code Sample Generator] to view code samples for both browser and Node.js applications that are tailored to your specific device.

Make sure the '''Remote (Network)''' box is checked when using the Phidget Network Server. If you do not check this box, your example will look for a [[#USB Connection | USB Connection]].

[[Image:Javascript_networkserver_browser_codesample.png|center|500px|link=https://cdn.phidgets.com/docs/images/5/5e/Javascript_networkserver_browser_codesample.png]]

==API==
[{{SERVER}}/?view=api&lang=JavaScript Phidget22 JavaScript API (Node.js)]<br>
[{{SERVER}}/?view=api&lang=JavaScriptBrowser Phidget22 JavaScript API (Browser)]

==Version History==
The Phidget JavaScript Libraries version history is reviewed here:<br><br>
'''1.x.x''' - Initial release. Unstable.<br>
'''2.x.x''' - Improved stability issues.<br>
'''3.x.x''' - WebUSB support added.

Language - JavaScript

2025-05-26T18:44:53Z

Patrick:

{{#seo:|description=Learn how to use Phidget USB devices with JavaScript.}}
[[Category:Language]]
==Get Started==
JavaScript is supported for browser and Node.js applications. Phidget devices can be accessed either directly through a [[#USB Connection | USB Connection]] or indirectly through a [[#Network Connection | Network Connection]].

==JavaScript Libraries==
===Browser Applications===
For browser applications, you can load the library directly from UNPKG:
<syntaxhighlight lang=javascript>
<script src="https://unpkg.com/phidget22@3.x/browser/phidget22.min.js"></script>
</syntaxhighlight>

Compiled and minified library files are also available [https://www.phidgets.com/downloads/phidget22/libraries/any/Phidget22JavaScript.zip here].

===Node.js Applications===
For Node.js applications, a [https://www.npmjs.com/package/phidget22 npm package] is available and can be installed with the following command:
<syntaxhighlight lang=javascript>
npm install phidget22
</syntaxhighlight>

==USB Connection==
Browser and Node.js applications can access Phidget devices directly via USB.

===Supported Devices===
USB connections with JavaScript are supported on Phidget devices running a PHIDUSB USB stack. To determine what USB stack your Phidget device is on, 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|500px|link=https://cdn.phidgets.com/docs/images/8/80/Javascript_networkserver_webusb_spec.png]]
<br><br>

===Browser Applications===
====Supported Browsers====
In-browser USB connections are achieved through the WebUSB API. This API is currently supported by Chromium-based browsers like Google Chrome and Microsoft Edge.

====JavaScript Control Panel (USB)====
You can experiment with browser-based USB applications by opening the JavaScript Phidget Control Panel:
* [https://www.phidgets.com/controlpanel phidgets.com/controlpanel]

Click on the ''Connect USB Device'' button to give the website permission to access your device.

[[Image:Javascript_networkserver_webusb_contropanel1.jpg|600px|center|link=https://cdn.phidgets.com/docs/images/9/9d/Javascript_networkserver_webusb_contropanel1.jpg]]

After granting permission, your device will be accessible from the control panel.

====USB Permission====
As demonstrated above, websites must request access to communicate with USB devices. This must be implemented through an interactive element, like a button. Use the '''requestWebUSBDeviceAccess''' method in the Phidget USBConnection API for this purpose.

[[Image:Javascript_networkserver_browser_api.png|center|500px|link=https://cdn.phidgets.com/docs/images/8/88/Javascript_networkserver_browser_api.png]]

===Example Code===
Navigate to our [https://www.phidgets.com/?view=code_samples Code Sample Generator] to view code samples for both browser and Node.js applications that are tailored to your specific device.

Make sure to '''uncheck''' the ''Remote (Network)'' box when using a direct USB connection. If you leave this box checked, your application will look for a [[#Network Connection | Network Connection]].

[[Image:Javascript_networkserver_webusb_codesample.png|center|500px|link=https://cdn.phidgets.com/docs/images/5/5f/Javascript_networkserver_webusb_codesample.png]]
<br><br>

==Network Connection==
Browser and Node.js applications can connect to Phidget devices through the [[Phidget Network Server]]. In this configuration, client applications can run on machines that don't have Phidget devices physically connected to them.

===Running the Phidget Network Server===
Before starting, ensure you are [{{SERVER}}/docs/Network_Server_Guide#Running_the_Phidget_Network_Server running the Phidget Network Server] on your host machine.
===Browser Considerations===
When using a Network Connection in a browser-based application, you must [{{SERVER}}/docs/Network_Server_Guide#Enabling_the_Webserver enable the web server] on your host machine.

====JavaScript Control Panel (Network)====
You can experiment with browser-based Network applications by opening the JavaScript Phidget Control Panel:
* If your host is a Windows or macOS machine, visit port 8989 (http://localhost:8989).
* If your host is a Linux machine, a PhidgetSBC, or a Wireless VINT Hub, visit port 8080 (http://localhost:8080).

If you are accessing the JavaScript Control Panel from a machine that is not the host, you will need to enter the IP address or hostname in place of localhost (e.g. http://phidgetsbc:8080).

[[Image:Networkserver_webserver_controlpanel.jpg|center|500px|link=https://cdn.phidgets.com/docs/images/c/c7/Networkserver_webserver_controlpanel.jpg]]

===Example Code===
Navigate to our [https://www.phidgets.com/?view=code_samples Code Sample Generator] to view code samples for both browser and Node.js applications that are tailored to your specific device.

Make sure the '''Remote (Network)''' box is checked when using the Phidget Network Server. If you do not check this box, your example will look for a [[#USB Connection | USB Connection]].

[[Image:Javascript_networkserver_browser_codesample.png|center|500px|link=https://cdn.phidgets.com/docs/images/5/5e/Javascript_networkserver_browser_codesample.png]]

==API==
[{{SERVER}}/?view=api&lang=JavaScript Phidget22 JavaScript API (Node.JS)]<br>
[{{SERVER}}/?view=api&lang=JavaScriptBrowser Phidget22 JavaScript API (Browser)]

==Version History==
The Phidget JavaScript Libraries version history is reviewed here:<br><br>
'''1.x.x''' - Initial release. Unstable.<br>
'''2.x.x''' - Improved stability issues.<br>
'''3.x.x''' - WebUSB support added.

Language - JavaScript

2025-05-26T18:44:28Z

Patrick:

{{#seo:|description=Learn how to use Phidget USB devices with JavaScript.}}
[[Category:Language]]
==Get Started==
JavaScript is supported for browser and Node.js applications. Phidget devices can be accessed either directly through a [[#USB Connection | USB Connection]] or indirectly through a [[#Network Connection | Network Connection]].

==JavaScript Libraries==
===Browser Applications===
For browser applications, you can load the library directly from UNPKG:
<syntaxhighlight lang=javascript>
<script src="https://unpkg.com/phidget22@3.x/browser/phidget22.min.js"></script>
</syntaxhighlight>

Compiled and minified library files are also available [https://www.phidgets.com/downloads/phidget22/libraries/any/Phidget22JavaScript.zip here].

===Node.js Applications===
For Node.js applications, a [https://www.npmjs.com/package/phidget22 npm package] is available and can be installed with the following command:
<syntaxhighlight lang=javascript>
npm install phidget22
</syntaxhighlight>

==USB Connection==
Browser and Node.js applications can access Phidget devices directly via USB.

===Supported Devices===
USB connections with JavaScript are supported on Phidget devices running a PHIDUSB USB stack. To determine what USB stack your Phidget device is on, 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|500px|link=https://cdn.phidgets.com/docs/images/8/80/Javascript_networkserver_webusb_spec.png]]
<br><br>

===Browser Applications===
====Supported Browsers====
In-browser USB connections are achieved through the WebUSB API. This API is currently supported by Chromium-based browsers like Google Chrome and Microsoft Edge.

====JavaScript Control Panel (USB)====
You can experiment with browser-based USB applications by opening the JavaScript Phidget Control Panel:
* [https://www.phidgets.com/controlpanel phidgets.com/controlpanel]

Click on the ''Connect USB Device'' button to give the website permission to access your device.

[[Image:Javascript_networkserver_webusb_contropanel1.jpg|600px|center|link=https://cdn.phidgets.com/docs/images/9/9d/Javascript_networkserver_webusb_contropanel1.jpg]]

After granting permission, your device will be accessible from the control panel.

====USB Permission====
As demonstrated above, websites must request access to communicate with USB devices. This must be implemented through an interactive element, like a button. Use the '''requestWebUSBDeviceAccess''' method in the Phidget USBConnection API for this purpose.

[[Image:Javascript_networkserver_browser_api.png|center|500px|link=https://cdn.phidgets.com/docs/images/8/88/Javascript_networkserver_browser_api.png]]

===Example Code===
Navigate to our [https://www.phidgets.com/?view=code_samples Code Sample Generator] to view code samples for both browser and Node.js applications that are tailored to your specific device.

Make sure to '''uncheck''' the ''Remote (Network)'' box when using a direct USB connection. If you leave this box checked, your application will look for a [[#Network Connection | Network Connection]].

[[Image:Javascript_networkserver_webusb_codesample.png|center|500px|link=https://cdn.phidgets.com/docs/images/5/5f/Javascript_networkserver_webusb_codesample.png]]
<br><br>

==Network Connection==
Browser and Node.js applications can connect to Phidget devices through the [[Phidget Network Server]]. In this configuration, client applications can run on machines that don't have Phidget devices physically connected to them.

===Running the Phidget Network Server===
Before starting, ensure you are [{{SERVER}}/docs/Network_Server_Guide#Running_the_Phidget_Network_Server running the Phidget Network Server] on your host machine.
===Browser Considerations===
When using a Network Connection in a browser-based application, you must [{{SERVER}}/docs/Network_Server_Guide#Enabling_the_Webserver enable the web server] on your host machine.

====JavaScript Control Panel (Network)====
You can experiment with browser-based Network applications by opening the JavaScript Phidget Control Panel:
* If your host is a Windows or macOS machine, visit port 8989 (http://localhost:8989).
* If your host is a Linux machine, a PhidgetSBC, or a Wireless VINT Hub, visit port 8080 (http://localhost:8080).

If you are accessing the JavaScript Control Panel from a machine that is not the host, you will need to enter the IP address or hostname in place of localhost (e.g. http://phidgetsbc:8080).

[[Image:Networkserver_webserver_controlpanel.jpg|center|500px|link=https://cdn.phidgets.com/docs/images/c/c7/Networkserver_webserver_controlpanel.jpg]]

===Example Code===
Navigate to our [https://www.phidgets.com/?view=code_samples Code Sample Generator] to view code samples for both browser and Node.js applications that are tailored to your specific device.

Make sure the '''Remote (Network)''' box is checked when using the Phidget Network Server. If you do not check this box, your example will look for a [[#USB Connection | USB Connection]].

[[Image:Javascript_networkserver_browser_codesample.png|center|500px|link=https://cdn.phidgets.com/docs/images/5/5e/Javascript_networkserver_browser_codesample.png]]

==API==
[{{SERVER}}/?view=api&lang=JavaScript Phidget22 JavaScript API (Node.JS)]
[{{SERVER}}/?view=api&lang=JavaScriptBrowser Phidget22 JavaScript API (Browser)]

==Version History==
The Phidget JavaScript Libraries version history is reviewed here:<br><br>
'''1.x.x''' - Initial release. Unstable.<br>
'''2.x.x''' - Improved stability issues.<br>
'''3.x.x''' - WebUSB support added.

Terms and Conditions

2025-05-15T19:25:44Z

Patrick:

[[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 by Phidgets Inc.===
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.

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;"| 2025
! style="text-align:center;"| 2026
|-
|style="background: #f0f0f0" align=center| Alberta Family Day
|style="background: #f0f0f0" align=center| Third Monday in February
|style="background: #f0f0f0" align=center| Feb 17
|style="background: #f0f0f0" align=center| Feb 16
|-
|style="background: #f0f0f0" align=center| Good Friday
|style="background: #f0f0f0" align=center| Friday before Easter Sunday
|style="background: #f0f0f0" align=center| Apr 18
|style="background: #f0f0f0" align=center| Apr 3
|-
|style="background: #f0f0f0" align=center| Victoria Day
|style="background: #f0f0f0" align=center| Monday before May 25
|style="background: #f0f0f0" align=center| May 19
|style="background: #f0f0f0" align=center| May 18
|-
|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| Heritage Day
|style="background: #f0f0f0" align=center| First Monday in August
|style="background: #f0f0f0" align=center| Aug 4
|style="background: #f0f0f0" align=center| Aug 3
|-
|style="background: #f0f0f0" align=center| Labour Day
|style="background: #f0f0f0" align=center| First Monday in September
|style="background: #f0f0f0" align=center| Sept 1
|style="background: #f0f0f0" align=center| Sept 7
|-
|style="background: #f0f0f0" align=center| Thanksgiving
|style="background: #f0f0f0" align=center| Second Monday in October
|style="background: #f0f0f0" align=center| Oct 13
|style="background: #f0f0f0" align=center| Oct 12
|-
|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

2025-05-14T19:50:25Z

Patrick:

[[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 customs 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 customs fees 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 customs fees 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 customs duties 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 customs duties 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 by Phidgets Inc.===
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.

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;"| 2025
! style="text-align:center;"| 2026
|-
|style="background: #f0f0f0" align=center| Alberta Family Day
|style="background: #f0f0f0" align=center| Third Monday in February
|style="background: #f0f0f0" align=center| Feb 17
|style="background: #f0f0f0" align=center| Feb 16
|-
|style="background: #f0f0f0" align=center| Good Friday
|style="background: #f0f0f0" align=center| Friday before Easter Sunday
|style="background: #f0f0f0" align=center| Apr 18
|style="background: #f0f0f0" align=center| Apr 3
|-
|style="background: #f0f0f0" align=center| Victoria Day
|style="background: #f0f0f0" align=center| Monday before May 25
|style="background: #f0f0f0" align=center| May 19
|style="background: #f0f0f0" align=center| May 18
|-
|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| Heritage Day
|style="background: #f0f0f0" align=center| First Monday in August
|style="background: #f0f0f0" align=center| Aug 4
|style="background: #f0f0f0" align=center| Aug 3
|-
|style="background: #f0f0f0" align=center| Labour Day
|style="background: #f0f0f0" align=center| First Monday in September
|style="background: #f0f0f0" align=center| Sept 1
|style="background: #f0f0f0" align=center| Sept 7
|-
|style="background: #f0f0f0" align=center| Thanksgiving
|style="background: #f0f0f0" align=center| Second Monday in October
|style="background: #f0f0f0" align=center| Oct 13
|style="background: #f0f0f0" align=center| Oct 12
|-
|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

2025-05-09T21:38:07Z

Patrick:

[[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 EU===

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.

As of July 1, 2021, the European Union updated its Value Added Tax (VAT) regulations. All shipments to the EU 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 is required to be collected at the time of purchase. For orders under '''$200 USD''', we '''require prepayment''' of VAT and brokerage fees at checkout to ensure fast, trouble-free delivery.

For higher-value orders, we offer '''optional prepayment''' of all applicable customs fees (including VAT and brokerage). If you choose this option, the quoted amount is guaranteed — we will cover any difference ourselves.

We recommend checking with your local customs office for details specific to your country.

===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.

International shipments may be subject to import duties, taxes, and brokerage fees once they arrive in your country. These charges are determined by your local customs authorities and are the responsibility of the recipient.

At checkout, we offer the option to prepay these fees. If you choose this option, the amount shown is guaranteed — we will cover any difference, if applicable.

Customs policies vary by country, so for more information, please contact your local customs office.

===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.

==Product Returns==
===All returns must be authorized by Phidgets Inc.===
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.

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;"| 2025
! style="text-align:center;"| 2026
|-
|style="background: #f0f0f0" align=center| Alberta Family Day
|style="background: #f0f0f0" align=center| Third Monday in February
|style="background: #f0f0f0" align=center| Feb 17
|style="background: #f0f0f0" align=center| Feb 16
|-
|style="background: #f0f0f0" align=center| Good Friday
|style="background: #f0f0f0" align=center| Friday before Easter Sunday
|style="background: #f0f0f0" align=center| Apr 18
|style="background: #f0f0f0" align=center| Apr 3
|-
|style="background: #f0f0f0" align=center| Victoria Day
|style="background: #f0f0f0" align=center| Monday before May 25
|style="background: #f0f0f0" align=center| May 19
|style="background: #f0f0f0" align=center| May 18
|-
|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| Heritage Day
|style="background: #f0f0f0" align=center| First Monday in August
|style="background: #f0f0f0" align=center| Aug 4
|style="background: #f0f0f0" align=center| Aug 3
|-
|style="background: #f0f0f0" align=center| Labour Day
|style="background: #f0f0f0" align=center| First Monday in September
|style="background: #f0f0f0" align=center| Sept 1
|style="background: #f0f0f0" align=center| Sept 7
|-
|style="background: #f0f0f0" align=center| Thanksgiving
|style="background: #f0f0f0" align=center| Second Monday in October
|style="background: #f0f0f0" align=center| Oct 13
|style="background: #f0f0f0" align=center| Oct 12
|-
|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

2025-04-30T22:47:02Z

Patrick:

[[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 EU===

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.

Effective July 1, 2021, there were significant changes to the European Union’s Value Added Tax (VAT) rules.

# All goods will now require formal customs clearance and are now subject to the VAT related to the country of entry.
# Online market places are required to charge the VAT upfront for all goods valued intrinsically up to '''€150'''.

These requirements prevent Phidgets Inc. from shipping directly into the EU for goods less than this value.

EU customers ordering goods on our website with a total value less the '''$200 USD''' are now encouraged to either:
* Increase the value of their order to over '''$200 USD''' or,
* Follow the link to our [[Dealers|distributors]] page and place an order through them.

Customers within the EU can still place orders above $200USD and have them shipped directly to them within
the EU without going through a distributor.
Please note in these cases customers within the EU are responsible for the VAT. UPS will collect it upon delivery or by invoice after 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.

Goods shipped internationally may be subject to import duties and taxes, which are applied once the shipment reaches your country. Any additional charges for customs clearance are your responsibility. As customs policies vary widely, 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.

==Product Returns==
===All returns must be authorized by Phidgets Inc.===
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.

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;"| 2025
! style="text-align:center;"| 2026
|-
|style="background: #f0f0f0" align=center| Alberta Family Day
|style="background: #f0f0f0" align=center| Third Monday in February
|style="background: #f0f0f0" align=center| Feb 17
|style="background: #f0f0f0" align=center| Feb 16
|-
|style="background: #f0f0f0" align=center| Good Friday
|style="background: #f0f0f0" align=center| Friday before Easter Sunday
|style="background: #f0f0f0" align=center| Apr 18
|style="background: #f0f0f0" align=center| Apr 3
|-
|style="background: #f0f0f0" align=center| Victoria Day
|style="background: #f0f0f0" align=center| Monday before May 25
|style="background: #f0f0f0" align=center| May 19
|style="background: #f0f0f0" align=center| May 18
|-
|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| Heritage Day
|style="background: #f0f0f0" align=center| First Monday in August
|style="background: #f0f0f0" align=center| Aug 4
|style="background: #f0f0f0" align=center| Aug 3
|-
|style="background: #f0f0f0" align=center| Labour Day
|style="background: #f0f0f0" align=center| First Monday in September
|style="background: #f0f0f0" align=center| Sept 1
|style="background: #f0f0f0" align=center| Sept 7
|-
|style="background: #f0f0f0" align=center| Thanksgiving
|style="background: #f0f0f0" align=center| Second Monday in October
|style="background: #f0f0f0" align=center| Oct 13
|style="background: #f0f0f0" align=center| Oct 12
|-
|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

2025-04-30T22:45:43Z

Patrick:

[[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<sup>®</sup>'''. 1 - 3 business days.
* '''UPS Expedited<sup>®</sup>'''. 2 - 5 business days. Available for packages over 3 lbs.
* '''UPS Standard<sup>®</sup>'''. 3 - 5 business days ground delivery.

===Shipping to the EU===

We offer the following services:
* '''UPS Worldwide Express Saver<sup>®</sup>'''. 1 - 3 business days.
* '''UPS Worldwide Expedited<sup>®</sup>'''. 2 - 5 business days. Available for packages over 3 lbs.

Effective July 1, 2021, there were significant changes to the European Union’s Value Added Tax (VAT) rules.

# All goods will now require formal customs clearance and are now subject to the VAT related to the country of entry.
# Online market places are required to charge the VAT upfront for all goods valued intrinsically up to '''€150'''.

These requirements prevent Phidgets Inc. from shipping directly into the EU for goods less than this value.

EU customers ordering goods on our website with a total value less the '''$200 USD''' are now encouraged to either:
* Increase the value of their order to over '''$200 USD''' or,
* Follow the link to our [[Dealers|distributors]] page and place an order through them.

Customers within the EU can still place orders above $200USD and have them shipped directly to them within
the EU without going through a distributor.
Please note in these cases customers within the EU are responsible for the VAT. UPS will collect it upon delivery or by invoice after delivery.

===Shipping to the United States===
We offer the following services:
* '''UPS Express Saver<sup>®</sup>'''. 1 - 3 business days.
* '''UPS Expedited<sup>®</sup>'''. 2 - 5 business days. Available for packages over 3 lbs.
* '''UPS Standard<sup>®</sup>'''. 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<sup>®</sup>'''. 1 - 3 business days.
* '''UPS Worldwide Expedited<sup>®</sup>'''. 2 - 5 business days. Available for packages over 3 lbs.

Goods shipped internationally may be subject to import duties and taxes, which are applied once the shipment reaches your country. Any additional charges for customs clearance are your responsibility. As customs policies vary widely, 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.

==Product Returns==
===All returns must be authorized by Phidgets Inc.===
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.

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;"| 2025
! style="text-align:center;"| 2026
|-
|style="background: #f0f0f0" align=center| Alberta Family Day
|style="background: #f0f0f0" align=center| Third Monday in February
|style="background: #f0f0f0" align=center| Feb 17
|style="background: #f0f0f0" align=center| Feb 16
|-
|style="background: #f0f0f0" align=center| Good Friday
|style="background: #f0f0f0" align=center| Friday before Easter Sunday
|style="background: #f0f0f0" align=center| Apr 18
|style="background: #f0f0f0" align=center| Apr 3
|-
|style="background: #f0f0f0" align=center| Victoria Day
|style="background: #f0f0f0" align=center| Monday before May 25
|style="background: #f0f0f0" align=center| May 19
|style="background: #f0f0f0" align=center| May 18
|-
|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| Heritage Day
|style="background: #f0f0f0" align=center| First Monday in August
|style="background: #f0f0f0" align=center| Aug 4
|style="background: #f0f0f0" align=center| Aug 3
|-
|style="background: #f0f0f0" align=center| Labour Day
|style="background: #f0f0f0" align=center| First Monday in September
|style="background: #f0f0f0" align=center| Sept 1
|style="background: #f0f0f0" align=center| Sept 7
|-
|style="background: #f0f0f0" align=center| Thanksgiving
|style="background: #f0f0f0" align=center| Second Monday in October
|style="background: #f0f0f0" align=center| Oct 13
|style="background: #f0f0f0" align=center| Oct 12
|-
|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

2025-04-30T22:41:55Z

Patrick:

[[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<sup>®</sup>'''. 1 - 3 business days.
* '''UPS Expedited<sup>®</sup>'''. 2 - 5 business days. Available for packages over 3 lbs.
* '''UPS Standard<sup>®</sup>'''. 3 - 5 business days ground delivery.

===Shipping to the EU===

We offer the following services:
* '''UPS Worldwide Express Saver<sup>®</sup>'''. 1 - 3 business days.
* '''UPS Worldwide Expedited™'''. 2 - 5 business days. Available for packages over 3 lbs.

Effective July 1, 2021, there were significant changes to the European Union’s Value Added Tax (VAT) rules.

# All goods will now require formal customs clearance and are now subject to the VAT related to the country of entry.
# Online market places are required to charge the VAT upfront for all goods valued intrinsically up to '''€150'''.

These requirements prevent Phidgets Inc. from shipping directly into the EU for goods less than this value.

EU customers ordering goods on our website with a total value less the '''$200 USD''' are now encouraged to either:
* Increase the value of their order to over '''$200 USD''' or,
* Follow the link to our [[Dealers|distributors]] page and place an order through them.

Customers within the EU can still place orders above $200USD and have them shipped directly to them within
the EU without going through a distributor.
Please note in these cases customers within the EU are responsible for the VAT. UPS will collect it upon delivery or by invoice after delivery.

===Shipping to the United States===
We offer the following services:
* '''UPS Express Saver<sup>®</sup>'''. 1 - 3 business days.
* '''UPS Expedited<sup>®</sup>'''. 2 - 5 business days. Available for packages over 3 lbs.
* '''UPS Standard<sup>®</sup>'''. 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<sup>®</sup>'''. 1 - 3 business days.
* '''UPS Worldwide Expedited™'''. 2 - 5 business days. Available for packages over 3 lbs.

Goods shipped internationally may be subject to import duties and taxes, which are applied once the shipment reaches your country. Any additional charges for customs clearance are your responsibility. As customs policies vary widely, 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.

==Product Returns==
===All returns must be authorized by Phidgets Inc.===
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.

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;"| 2025
! style="text-align:center;"| 2026
|-
|style="background: #f0f0f0" align=center| Alberta Family Day
|style="background: #f0f0f0" align=center| Third Monday in February
|style="background: #f0f0f0" align=center| Feb 17
|style="background: #f0f0f0" align=center| Feb 16
|-
|style="background: #f0f0f0" align=center| Good Friday
|style="background: #f0f0f0" align=center| Friday before Easter Sunday
|style="background: #f0f0f0" align=center| Apr 18
|style="background: #f0f0f0" align=center| Apr 3
|-
|style="background: #f0f0f0" align=center| Victoria Day
|style="background: #f0f0f0" align=center| Monday before May 25
|style="background: #f0f0f0" align=center| May 19
|style="background: #f0f0f0" align=center| May 18
|-
|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| Heritage Day
|style="background: #f0f0f0" align=center| First Monday in August
|style="background: #f0f0f0" align=center| Aug 4
|style="background: #f0f0f0" align=center| Aug 3
|-
|style="background: #f0f0f0" align=center| Labour Day
|style="background: #f0f0f0" align=center| First Monday in September
|style="background: #f0f0f0" align=center| Sept 1
|style="background: #f0f0f0" align=center| Sept 7
|-
|style="background: #f0f0f0" align=center| Thanksgiving
|style="background: #f0f0f0" align=center| Second Monday in October
|style="background: #f0f0f0" align=center| Oct 13
|style="background: #f0f0f0" align=center| Oct 12
|-
|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
|-
|}

Template:LinuxPackageInstall

2025-01-23T18:39:20Z

Patrick:

We recommend installing with our '''Install Script'''. If you prefer not to run a script, or the script cannot detect your distro, use the '''Manual Install'''.

<tabber>
|-|Install Script=
To run the install script and install phidget22, enter the following command in the terminal:

{{LinuxInstallScript}}

If the ''curl'' command is not found: <syntaxhighlight enclose="none">apt install curl</syntaxhighlight> and try again.

|-|Manual Install=
To install our package repository manually, enter the following command in the terminal, replacing '''''distro''''' with your distro codename:

{{LinuxGetKey}}

We support Debian releases from 6 to current, and Ubuntu LTS releases from 14.04 to current. If you are using another flavour of Linux (such as Mint), which is based on Ubuntu or Debian, use the corresponding Ubuntu or Debian codename.

Update your package lists:
{{LinuxAptUpdate}}

Finally, install the Phidget package by entering the command below:
{{LinuxAptInstall}}
</tabber>

====Additional Packages====
You may also want to apt install the following optional packages:
* '''libphidget22-dev''': The C development libraries for Phidget22
* '''libphidget22extra''': Extra runtime library required for the Network Server and Admin tools
* '''phidget22networkserver''': The [[Phidget Network Server]], which enables use of Phidgets over your network
* '''libphidget22java''': The Java libraries for Phidget22
* [[Phidget22admin Guide|'''phidget22admin''']]: An administrator utility for listing Phidgets and upgrading firmware
* '''phidget22wwwjs''': The JavaScript libraries for Phidget22. This package also installs the HTML examples which can be accessed through the web interface

The libraries are now installed on your machine. Next, set up the UDev rules below.

Template:LinuxPackageInstall

2025-01-23T18:37:14Z

Patrick:

We recommend installing with our '''Install Script'''. If you prefer not to run a script, or the script cannot detect your distro, use the '''Manual Install'''.

<tabber>
|-|Install Script=
To run the install script and install phidget22, enter the following command in the terminal:

{{LinuxInstallScript}}

If the ''curl'' command is not found: <syntaxhighlight lang="bash" enclose="none">apt install curl</syntaxhighlight> and try again.

|-|Manual Install=
To install our package repository manually, enter the following command in the terminal, replacing '''''distro''''' with your distro codename:

{{LinuxGetKey}}

We support Debian releases from 6 to current, and Ubuntu LTS releases from 14.04 to current. If you are using another flavour of Linux (such as Mint), which is based on Ubuntu or Debian, use the corresponding Ubuntu or Debian codename.

Update your package lists:
{{LinuxAptUpdate}}

Finally, install the Phidget package by entering the command below:
{{LinuxAptInstall}}
</tabber>

====Additional Packages====
You may also want to apt install the following optional packages:
* '''libphidget22-dev''': The C development libraries for Phidget22
* '''libphidget22extra''': Extra runtime library required for the Network Server and Admin tools
* '''phidget22networkserver''': The [[Phidget Network Server]], which enables use of Phidgets over your network
* '''libphidget22java''': The Java libraries for Phidget22
* [[Phidget22admin Guide|'''phidget22admin''']]: An administrator utility for listing Phidgets and upgrading firmware
* '''phidget22wwwjs''': The JavaScript libraries for Phidget22. This package also installs the HTML examples which can be accessed through the web interface

The libraries are now installed on your machine. Next, set up the UDev rules below.

Template:LinuxPackageInstall

2025-01-20T18:31:17Z

Patrick:

We recommend installing with our '''Install Script'''. If you prefer not to run a script, or the script cannot detect your distro, use the '''Manual Install'''.

<tabber>
|-|Install Script=
To run the install script and install phidget22, enter the following command in the terminal:

{{LinuxInstallScript}}

|-|Manual Install=
To install our package repository manually, enter the following command in the terminal, replacing '''''distro''''' with your distro codename:

{{LinuxGetKey}}

We support Debian releases from 6 to current, and Ubuntu LTS releases from 14.04 to current. If you are using another flavour of Linux (such as Mint), which is based on Ubuntu or Debian, use the corresponding Ubuntu or Debian codename.

Update your package lists:
{{LinuxAptUpdate}}

Finally, install the Phidget package by entering the command below:
{{LinuxAptInstall}}
</tabber>

====Additional Packages====
You may also want to apt install the following optional packages:
* '''libphidget22-dev''': The C development libraries for Phidget22
* '''libphidget22extra''': Extra runtime library required for the Network Server and Admin tools
* '''phidget22networkserver''': The [[Phidget Network Server]], which enables use of Phidgets over your network
* '''libphidget22java''': The Java libraries for Phidget22
* [[Phidget22admin Guide|'''phidget22admin''']]: An administrator utility for listing Phidgets and upgrading firmware
* '''phidget22wwwjs''': The JavaScript libraries for Phidget22. This package also installs the HTML examples which can be accessed through the web interface

The libraries are now installed on your machine. Next, set up the UDev rules below.

OS - Linux

2025-01-20T18:28:12Z

Patrick:

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

==Getting Started with Linux==
Welcome to using Phidgets with Linux!

===Install===
The first step to using Phidgets with Linux is installing the Phidget22 libraries.

We provide prebuilt packages for Debian, Ubuntu, and their derivatives.

If you're running a supported distros, we recommend using the '''Package Install'''. For other systems, you can use the '''Source Install'''.

<div class="bigTabs">
<tabber>
|-|Package Install=
{{LinuxPackageInstall}}

|-|Source Install=
====Source Install====
To install our libraries, first install libusb-1.0 development libraries. The exact command and package name will vary depending on distribution. For Debian based distributions, including Ubuntu and Mint, the command would be:
<syntaxhighlight lang=bash>
apt install libusb-1.0-0-dev
</syntaxhighlight>

Next, download and unpack the following files:
*[https://cdn.phidgets.com/downloads/phidget22/libraries/linux/libphidget22.tar.gz libphidget22] (Mandatory)
*[https://cdn.phidgets.com/downloads/phidget22/libraries/linux/libphidget22extra.tar.gz libphidget22extra] (Optional - needed by NetworkServer and Admin)
*[https://cdn.phidgets.com/downloads/phidget22/libraries/linux/libphidget22java.tar.gz libphidget22java] (Optional - Java Libraries)
*[https://cdn.phidgets.com/downloads/phidget22/servers/linux/phidget22networkserver.tar.gz phidget22networkserver] (Optional - [[Phidget Network Server]])
*[https://cdn.phidgets.com/downloads/phidget22/tools/linux/phidget22admin.tar.gz phidget22admin] (Optional - Phidget Admin Tool)
Open the README file that is included at the top of each directory. This file will give you important information about how to properly install the files.

Libraries are installed in /usr/local/lib by default. If you run into trouble finding the libraries during linking or at runtime, this probably means that /usr/local/lib is not on the library path for your distribution.

You can handle this in a number of ways:

Specify a different install folder during compile
<syntaxhighlight lang=bash>./configure --prefix=/usr && make && sudo make install</syntaxhighlight>
OR Add /usr/local/lib to the system-wide library path
<syntaxhighlight lang=bash>echo /usr/local/lib >> /etc/ld.so.conf && sudo ldconfig</syntaxhighlight>
OR Add /usr/local/lib in your local shell every time
<syntaxhighlight lang=bash>export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib</syntaxhighlight>

The libraries are now installed on your machine. Next, you should set the UDev Rules.
</tabber>
</div>

=== Setting UDev Rules ===
By default, Linux will not grant permission to regular users to access physical hardware as a security feature. This means that in order to run Phidgets code from user space you must grant yourself root privileges via sudo. For example:

sudo ./HelloWorld

You can grant access manually or, more commonly, set up a rules file to do it automatically keying off of the vendor code for Phidget USB devices. To do this, create a text file called "99-libphidget22.rules" with the following contents:
<syntaxhighlight lang=bash>
# All current and future Phidgets - Vendor = 0x06c2, Product = 0x0030 - 0x00af
SUBSYSTEMS=="usb", ACTION=="add", ATTRS{idVendor}=="06c2", ATTRS{idProduct}=="00[3-a][0-f]", MODE="666"
</syntaxhighlight>

Where mode 666 means every user has permission to read and write to the specified file/device. You need to then move this file to "/etc/udev/rules.d". Now you can run Phidget related code as a regular user without the OS denying permission.

===Verify===
The best way to verify that your libraries are working properly is to compile and run an example program.

First, download and unpack this C example:
*[https://cdn.phidgets.com/downloads/phidget22/examples/c/Manager/Phidget22_HelloWorld_C_Ex.zip HelloWorld C example]

'''Note:''' If using the Debian intallation methods, you will need to install the '''libphidget22-dev''' package to use the C libraries for Phidget22

Next, open the terminal at the example location. Compile the example by entering the following command:
<syntaxhighlight lang=bash>
gcc HelloWorld.c -o HelloWorld -lphidget22
</syntaxhighlight>

Run the HelloWorld example:
<syntaxhighlight lang=bash>
./HelloWorld
</syntaxhighlight>

Your terminal should look something like this:
[[File:linux_helloworld.PNG|link=|center]]

The HelloWorld program will simply communicate when a Phidget has been attached or detached, as can be seen in the image above.

Your Phidget is now able to communicate with your development machine. The next step is selecting a programming language so you can start to write some code!

==Programming==
Ready to write some code? Select one of the programming languages below:

{{Programming_Languages_Table}}

==Older Versions==
If you need older versions of the Phidget22 Linux libraries, [{{SERVER}}/downloads/phidget22/libraries/linux/libphidget22/ click here].

If you need Phidget21 Linux Libraries, [{{SERVER}}/downloads/phidget21/libraries/linux/libphidget/ click here].

==Software License==
By downloading Linux Source you agree to adhere to the terms of the [https://opensource.org/licenses/BSD-3-Clause The 3-Clause BSD License].

Template:LinuxPackageInstall

2025-01-20T18:21:15Z

Patrick:

We recommend installing with our '''Install Script'''. If you prefer not to run a script, or are using an unknown distro based on Debian, use the '''Manual Install'''.

<tabber>
|-|Install Script=
To run the install script and install phidget22, enter the following command in the terminal:

{{LinuxInstallScript}}

|-|Manual Install=
To install our package repository manually, enter the following command in the terminal, replacing '''''distro''''' with your distro codename:

{{LinuxGetKey}}

We support Debian releases from 6 to current, and Ubuntu LTS releases from 14.04 to current. If you are using another flavour of Linux (such as Mint), which is based on Ubuntu or Debian, use the corresponding Ubuntu or Debian codename.

Update your package lists:
{{LinuxAptUpdate}}

Finally, install the Phidget package by entering the command below:
{{LinuxAptInstall}}
</tabber>

====Additional Packages====
You may also want to apt install the following optional packages:
* '''libphidget22-dev''': The C development libraries for Phidget22
* '''libphidget22extra''': Extra runtime library required for the Network Server and Admin tools
* '''phidget22networkserver''': The [[Phidget Network Server]], which enables use of Phidgets over your network
* '''libphidget22java''': The Java libraries for Phidget22
* [[Phidget22admin Guide|'''phidget22admin''']]: An administrator utility for listing Phidgets and upgrading firmware
* '''phidget22wwwjs''': The JavaScript libraries for Phidget22. This package also installs the HTML examples which can be accessed through the web interface

The libraries are now installed on your machine. Next, set up the UDev rules below.

OS - Linux

2025-01-20T18:17:38Z

Patrick:

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

==Getting Started with Linux==
Welcome to using Phidgets with Linux!

Phidget22 is supported on the following distros and architectures '''(click to expand)''':
{{LinuxSupport}}

===Install===
The first step to using Phidgets with Linux is installing the Phidget22 libraries.

If you're running one of the supported distros, we recommend using the '''Package Install'''. For other systems, you can use the '''Source Install'''.

<div class="bigTabs">
<tabber>
|-|Package Install=
{{LinuxPackageInstall}}

|-|Source Install=
====Source Install====
To install our libraries, first install libusb-1.0 development libraries. The exact command and package name will vary depending on distribution. For Debian based distributions, including Ubuntu and Mint, the command would be:
<syntaxhighlight lang=bash>
apt install libusb-1.0-0-dev
</syntaxhighlight>

Next, download and unpack the following files:
*[https://cdn.phidgets.com/downloads/phidget22/libraries/linux/libphidget22.tar.gz libphidget22] (Mandatory)
*[https://cdn.phidgets.com/downloads/phidget22/libraries/linux/libphidget22extra.tar.gz libphidget22extra] (Optional - needed by NetworkServer and Admin)
*[https://cdn.phidgets.com/downloads/phidget22/libraries/linux/libphidget22java.tar.gz libphidget22java] (Optional - Java Libraries)
*[https://cdn.phidgets.com/downloads/phidget22/servers/linux/phidget22networkserver.tar.gz phidget22networkserver] (Optional - [[Phidget Network Server]])
*[https://cdn.phidgets.com/downloads/phidget22/tools/linux/phidget22admin.tar.gz phidget22admin] (Optional - Phidget Admin Tool)
Open the README file that is included at the top of each directory. This file will give you important information about how to properly install the files.

Libraries are installed in /usr/local/lib by default. If you run into trouble finding the libraries during linking or at runtime, this probably means that /usr/local/lib is not on the library path for your distribution.

You can handle this in a number of ways:

Specify a different install folder during compile
<syntaxhighlight lang=bash>./configure --prefix=/usr && make && sudo make install</syntaxhighlight>
OR Add /usr/local/lib to the system-wide library path
<syntaxhighlight lang=bash>echo /usr/local/lib >> /etc/ld.so.conf && sudo ldconfig</syntaxhighlight>
OR Add /usr/local/lib in your local shell every time
<syntaxhighlight lang=bash>export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib</syntaxhighlight>

The libraries are now installed on your machine. Next, you should set the UDev Rules.
</tabber>
</div>

=== Setting UDev Rules ===
By default, Linux will not grant permission to regular users to access physical hardware as a security feature. This means that in order to run Phidgets code from user space you must grant yourself root privileges via sudo. For example:

sudo ./HelloWorld

You can grant access manually or, more commonly, set up a rules file to do it automatically keying off of the vendor code for Phidget USB devices. To do this, create a text file called "99-libphidget22.rules" with the following contents:
<syntaxhighlight lang=bash>
# All current and future Phidgets - Vendor = 0x06c2, Product = 0x0030 - 0x00af
SUBSYSTEMS=="usb", ACTION=="add", ATTRS{idVendor}=="06c2", ATTRS{idProduct}=="00[3-a][0-f]", MODE="666"
</syntaxhighlight>

Where mode 666 means every user has permission to read and write to the specified file/device. You need to then move this file to "/etc/udev/rules.d". Now you can run Phidget related code as a regular user without the OS denying permission.

===Verify===
The best way to verify that your libraries are working properly is to compile and run an example program.

First, download and unpack this C example:
*[https://cdn.phidgets.com/downloads/phidget22/examples/c/Manager/Phidget22_HelloWorld_C_Ex.zip HelloWorld C example]

'''Note:''' If using the Debian intallation methods, you will need to install the '''libphidget22-dev''' package to use the C libraries for Phidget22

Next, open the terminal at the example location. Compile the example by entering the following command:
<syntaxhighlight lang=bash>
gcc HelloWorld.c -o HelloWorld -lphidget22
</syntaxhighlight>

Run the HelloWorld example:
<syntaxhighlight lang=bash>
./HelloWorld
</syntaxhighlight>

Your terminal should look something like this:
[[File:linux_helloworld.PNG|link=|center]]

The HelloWorld program will simply communicate when a Phidget has been attached or detached, as can be seen in the image above.

Your Phidget is now able to communicate with your development machine. The next step is selecting a programming language so you can start to write some code!

==Programming==
Ready to write some code? Select one of the programming languages below:

{{Programming_Languages_Table}}

==Older Versions==
If you need older versions of the Phidget22 Linux libraries, [{{SERVER}}/downloads/phidget22/libraries/linux/libphidget22/ click here].

If you need Phidget21 Linux Libraries, [{{SERVER}}/downloads/phidget21/libraries/linux/libphidget/ click here].

==Software License==
By downloading Linux Source you agree to adhere to the terms of the [https://opensource.org/licenses/BSD-3-Clause The 3-Clause BSD License].

Template:LinuxPackageInstall

2025-01-20T18:14:39Z

Patrick:

<tabber>
|-|Install Script=
====Install Script====
To run the install script and install phidget22, enter the following command in the terminal:

{{LinuxInstallScript}}

|-|Manual Install=
====Manual Install====
To install our package repository manually, enter the following command in the terminal, replacing '''''distro''''' with your distro codename:

{{LinuxGetKey}}

We support Debian releases from 6 to current, and Ubuntu LTS releases from 14.04 to current. If you are using another flavour of Linux (such as Mint), which is based on Ubuntu or Debian, use the corresponding Ubuntu or Debian codename.

Update your package lists:
{{LinuxAptUpdate}}

Finally, install the Phidget package by entering the command below:
{{LinuxAptInstall}}
</tabber>

====Additional Packages====
You may also want to apt install the following optional packages:
* '''libphidget22-dev''': The C development libraries for Phidget22
* '''libphidget22extra''': Extra runtime library required for the Network Server and Admin tools
* '''phidget22networkserver''': The [[Phidget Network Server]], which enables use of Phidgets over your network
* '''libphidget22java''': The Java libraries for Phidget22
* [[Phidget22admin Guide|'''phidget22admin''']]: An administrator utility for listing Phidgets and upgrading firmware
* '''phidget22wwwjs''': The JavaScript libraries for Phidget22. This package also installs the HTML examples which can be accessed through the web interface

The libraries are now installed on your machine. Next, set up the UDev rules below.

Template:LinuxPackageInstall

2025-01-20T18:13:33Z

Patrick: Created page with " ====Install Script==== To run the install script and install phidget22, enter the following command in the terminal: {{LinuxInstallScript}} ====Manual Install==== To install our package repository manually, enter the following command in the terminal, replacing '''''distro''''' with your distro codename: {{LinuxGetKey}} We support Debian releases from 6 to current, and Ubuntu LTS releases from 14.04 to current. If you are using another flavour of Linux (such as Mint..."

====Install Script====
To run the install script and install phidget22, enter the following command in the terminal:

{{LinuxInstallScript}}

====Manual Install====
To install our package repository manually, enter the following command in the terminal, replacing '''''distro''''' with your distro codename:

{{LinuxGetKey}}

We support Debian releases from 6 to current, and Ubuntu LTS releases from 14.04 to current. If you are using another flavour of Linux (such as Mint), which is based on Ubuntu or Debian, use the corresponding Ubuntu or Debian codename.

Update your package lists:
{{LinuxAptUpdate}}

Finally, install the Phidget package by entering the command below:
{{LinuxAptInstall}}

====Additional Packages====
You may also want to apt install the following optional packages:
* '''libphidget22-dev''': The C development libraries for Phidget22
* '''libphidget22extra''': Extra runtime library required for the Network Server and Admin tools
* '''phidget22networkserver''': The [[Phidget Network Server]], which enables use of Phidgets over your network
* '''libphidget22java''': The Java libraries for Phidget22
* [[Phidget22admin Guide|'''phidget22admin''']]: An administrator utility for listing Phidgets and upgrading firmware
* '''phidget22wwwjs''': The JavaScript libraries for Phidget22. This package also installs the HTML examples which can be accessed through the web interface

The libraries are now installed on your machine. Next, set up the UDev rules below.

OS - Linux

2025-01-20T18:12:16Z

Patrick:

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

==Getting Started with Linux==
Welcome to using Phidgets with Linux!

Phidget22 is supported on the following distros and architectures '''(click to expand)''':
{{LinuxSupport}}

===Install===
The first step to using Phidgets with Linux is installing the Phidget22 libraries.

If you're running one of the supported distros, we recommend using the '''Package Install'''. For other systems, you can use the '''Source Install'''.

<div class="bigTabs">
<tabber>
|-|Package Install=
====Install Script====
To run the install script and install phidget22, enter the following command in the terminal:

{{LinuxInstallScript}}

====Manual Install====
To install our package repository manually, enter the following command in the terminal, replacing '''''distro''''' with your distro codename:

{{LinuxGetKey}}

We support Debian releases from 6 to current, and Ubuntu LTS releases from 14.04 to current. If you are using another flavour of Linux (such as Mint), which is based on Ubuntu or Debian, use the corresponding Ubuntu or Debian codename.

Update your package lists:
{{LinuxAptUpdate}}

Finally, install the Phidget package by entering the command below:
{{LinuxAptInstall}}

====Additional Packages====
You may also want to apt install the following optional packages:
* '''libphidget22-dev''': The C development libraries for Phidget22
* '''libphidget22extra''': Extra runtime library required for the Network Server and Admin tools
* '''phidget22networkserver''': The [[Phidget Network Server]], which enables use of Phidgets over your network
* '''libphidget22java''': The Java libraries for Phidget22
* [[Phidget22admin Guide|'''phidget22admin''']]: An administrator utility for listing Phidgets and upgrading firmware
* '''phidget22wwwjs''': The JavaScript libraries for Phidget22. This package also installs the HTML examples which can be accessed through the web interface

The libraries are now installed on your machine. Next, set up the UDev rules below.

|-|Source Install=
====Source Install====
To install our libraries, first install libusb-1.0 development libraries. The exact command and package name will vary depending on distribution. For Debian based distributions, including Ubuntu and Mint, the command would be:
<syntaxhighlight lang=bash>
apt install libusb-1.0-0-dev
</syntaxhighlight>

Next, download and unpack the following files:
*[https://cdn.phidgets.com/downloads/phidget22/libraries/linux/libphidget22.tar.gz libphidget22] (Mandatory)
*[https://cdn.phidgets.com/downloads/phidget22/libraries/linux/libphidget22extra.tar.gz libphidget22extra] (Optional - needed by NetworkServer and Admin)
*[https://cdn.phidgets.com/downloads/phidget22/libraries/linux/libphidget22java.tar.gz libphidget22java] (Optional - Java Libraries)
*[https://cdn.phidgets.com/downloads/phidget22/servers/linux/phidget22networkserver.tar.gz phidget22networkserver] (Optional - [[Phidget Network Server]])
*[https://cdn.phidgets.com/downloads/phidget22/tools/linux/phidget22admin.tar.gz phidget22admin] (Optional - Phidget Admin Tool)
Open the README file that is included at the top of each directory. This file will give you important information about how to properly install the files.

Libraries are installed in /usr/local/lib by default. If you run into trouble finding the libraries during linking or at runtime, this probably means that /usr/local/lib is not on the library path for your distribution.

You can handle this in a number of ways:

Specify a different install folder during compile
<syntaxhighlight lang=bash>./configure --prefix=/usr && make && sudo make install</syntaxhighlight>
OR Add /usr/local/lib to the system-wide library path
<syntaxhighlight lang=bash>echo /usr/local/lib >> /etc/ld.so.conf && sudo ldconfig</syntaxhighlight>
OR Add /usr/local/lib in your local shell every time
<syntaxhighlight lang=bash>export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib</syntaxhighlight>

The libraries are now installed on your machine. Next, you should set the UDev Rules.
</tabber>
</div>

=== Setting UDev Rules ===
By default, Linux will not grant permission to regular users to access physical hardware as a security feature. This means that in order to run Phidgets code from user space you must grant yourself root privileges via sudo. For example:

sudo ./HelloWorld

You can grant access manually or, more commonly, set up a rules file to do it automatically keying off of the vendor code for Phidget USB devices. To do this, create a text file called "99-libphidget22.rules" with the following contents:
<syntaxhighlight lang=bash>
# All current and future Phidgets - Vendor = 0x06c2, Product = 0x0030 - 0x00af
SUBSYSTEMS=="usb", ACTION=="add", ATTRS{idVendor}=="06c2", ATTRS{idProduct}=="00[3-a][0-f]", MODE="666"
</syntaxhighlight>

Where mode 666 means every user has permission to read and write to the specified file/device. You need to then move this file to "/etc/udev/rules.d". Now you can run Phidget related code as a regular user without the OS denying permission.

===Verify===
The best way to verify that your libraries are working properly is to compile and run an example program.

First, download and unpack this C example:
*[https://cdn.phidgets.com/downloads/phidget22/examples/c/Manager/Phidget22_HelloWorld_C_Ex.zip HelloWorld C example]

'''Note:''' If using the Debian intallation methods, you will need to install the '''libphidget22-dev''' package to use the C libraries for Phidget22

Next, open the terminal at the example location. Compile the example by entering the following command:
<syntaxhighlight lang=bash>
gcc HelloWorld.c -o HelloWorld -lphidget22
</syntaxhighlight>

Run the HelloWorld example:
<syntaxhighlight lang=bash>
./HelloWorld
</syntaxhighlight>

Your terminal should look something like this:
[[File:linux_helloworld.PNG|link=|center]]

The HelloWorld program will simply communicate when a Phidget has been attached or detached, as can be seen in the image above.

Your Phidget is now able to communicate with your development machine. The next step is selecting a programming language so you can start to write some code!

==Programming==
Ready to write some code? Select one of the programming languages below:

{{Programming_Languages_Table}}

==Older Versions==
If you need older versions of the Phidget22 Linux libraries, [{{SERVER}}/downloads/phidget22/libraries/linux/libphidget22/ click here].

If you need Phidget21 Linux Libraries, [{{SERVER}}/downloads/phidget21/libraries/linux/libphidget/ click here].

==Software License==
By downloading Linux Source you agree to adhere to the terms of the [https://opensource.org/licenses/BSD-3-Clause The 3-Clause BSD License].

OS - Linux

2025-01-20T18:05:04Z

Patrick:

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

==Getting Started with Linux==
Welcome to using Phidgets with Linux!

Phidget22 is supported on the following distros and architectures '''(click to expand)''':
{{LinuxSupport}}

===Install===
The first step to using Phidgets with Linux is installing the Phidget22 libraries.

If you're running one of the supported distros, we recommend using the '''Package Install'''. For other systems, you can use the '''Source Install'''.

<div class="bigTabs">
<tabber>
Package Install=
====Install Script====
To run the install script and install phidget22, enter the following command in the terminal:

{{LinuxInstallScript}}

====Manual Install====
To install our package repository manually, enter the following command in the terminal, replacing '''''distro''''' with your distro codename:

{{LinuxGetKey}}

We support Debian releases from 6 to current, and Ubuntu LTS releases from 14.04 to current. If you are using another flavour of Linux (such as Mint), which is based on Ubuntu or Debian, use the corresponding Ubuntu or Debian codename.

Update your package lists:
{{LinuxAptUpdate}}

Finally, install the Phidget package by entering the command below:
{{LinuxAptInstall}}

====Additional Packages====
You may also want to apt install the following optional packages:
* '''libphidget22-dev''': The C development libraries for Phidget22
* '''libphidget22extra''': Extra runtime library required for the Network Server and Admin tools
* '''phidget22networkserver''': The [[Phidget Network Server]], which enables use of Phidgets over your network
* '''libphidget22java''': The Java libraries for Phidget22
* [[Phidget22admin Guide|'''phidget22admin''']]: An administrator utility for listing Phidgets and upgrading firmware
* '''phidget22wwwjs''': The JavaScript libraries for Phidget22. This package also installs the HTML examples which can be accessed through the web interface

The libraries are now installed on your machine. Next, set up the UDev rules below.

|-|
Source Install=
====Source Install====
To install our libraries, first install libusb-1.0 development libraries. The exact command and package name will vary depending on distribution. For Debian based distributions, including Ubuntu and Mint, the command would be:
<syntaxhighlight lang=bash>
apt install libusb-1.0-0-dev
</syntaxhighlight>

Next, download and unpack the following files:
*[https://cdn.phidgets.com/downloads/phidget22/libraries/linux/libphidget22.tar.gz libphidget22] (Mandatory)
*[https://cdn.phidgets.com/downloads/phidget22/libraries/linux/libphidget22extra.tar.gz libphidget22extra] (Optional - needed by NetworkServer and Admin)
*[https://cdn.phidgets.com/downloads/phidget22/libraries/linux/libphidget22java.tar.gz libphidget22java] (Optional - Java Libraries)
*[https://cdn.phidgets.com/downloads/phidget22/servers/linux/phidget22networkserver.tar.gz phidget22networkserver] (Optional - [[Phidget Network Server]])
*[https://cdn.phidgets.com/downloads/phidget22/tools/linux/phidget22admin.tar.gz phidget22admin] (Optional - Phidget Admin Tool)
Open the README file that is included at the top of each directory. This file will give you important information about how to properly install the files.

Libraries are installed in /usr/local/lib by default. If you run into trouble finding the libraries during linking or at runtime, this probably means that /usr/local/lib is not on the library path for your distribution.

You can handle this in a number of ways:

Specify a different install folder during compile
<syntaxhighlight lang=bash>./configure --prefix=/usr && make && sudo make install</syntaxhighlight>
OR Add /usr/local/lib to the system-wide library path
<syntaxhighlight lang=bash>echo /usr/local/lib >> /etc/ld.so.conf && sudo ldconfig</syntaxhighlight>
OR Add /usr/local/lib in your local shell every time
<syntaxhighlight lang=bash>export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib</syntaxhighlight>

The libraries are now installed on your machine. Next, you should set the UDev Rules.
</tabber>
</div>

=== Setting UDev Rules ===
By default, Linux will not grant permission to regular users to access physical hardware as a security feature. This means that in order to run Phidgets code from user space you must grant yourself root privileges via sudo. For example:

sudo ./HelloWorld

You can grant access manually or, more commonly, set up a rules file to do it automatically keying off of the vendor code for Phidget USB devices. To do this, create a text file called "99-libphidget22.rules" with the following contents:
<syntaxhighlight lang=bash>
# All current and future Phidgets - Vendor = 0x06c2, Product = 0x0030 - 0x00af
SUBSYSTEMS=="usb", ACTION=="add", ATTRS{idVendor}=="06c2", ATTRS{idProduct}=="00[3-a][0-f]", MODE="666"
</syntaxhighlight>

Where mode 666 means every user has permission to read and write to the specified file/device. You need to then move this file to "/etc/udev/rules.d". Now you can run Phidget related code as a regular user without the OS denying permission.

===Verify===
The best way to verify that your libraries are working properly is to compile and run an example program.

First, download and unpack this C example:
*[https://cdn.phidgets.com/downloads/phidget22/examples/c/Manager/Phidget22_HelloWorld_C_Ex.zip HelloWorld C example]

'''Note:''' If using the Debian intallation methods, you will need to install the '''libphidget22-dev''' package to use the C libraries for Phidget22

Next, open the terminal at the example location. Compile the example by entering the following command:
<syntaxhighlight lang=bash>
gcc HelloWorld.c -o HelloWorld -lphidget22
</syntaxhighlight>

Run the HelloWorld example:
<syntaxhighlight lang=bash>
./HelloWorld
</syntaxhighlight>

Your terminal should look something like this:
[[File:linux_helloworld.PNG|link=|center]]

The HelloWorld program will simply communicate when a Phidget has been attached or detached, as can be seen in the image above.

Your Phidget is now able to communicate with your development machine. The next step is selecting a programming language so you can start to write some code!

==Programming==
Ready to write some code? Select one of the programming languages below:

{{Programming_Languages_Table}}

==Older Versions==
If you need older versions of the Phidget22 Linux libraries, [{{SERVER}}/downloads/phidget22/libraries/linux/libphidget22/ click here].

If you need Phidget21 Linux Libraries, [{{SERVER}}/downloads/phidget21/libraries/linux/libphidget/ click here].

==Software License==
By downloading Linux Source you agree to adhere to the terms of the [https://opensource.org/licenses/BSD-3-Clause The 3-Clause BSD License].

Template:LinuxInstallScript

2025-01-20T18:03:44Z

Patrick:

<tabber>
Root=
<syntaxhighlight lang=bash>
curl -fsSL https://www.phidgets.com/downloads/setup_linux | bash -
apt install -y libphidget22
</syntaxhighlight>
|-|
Non-Root=
<syntaxhighlight lang=bash>
curl -fsSL https://www.phidgets.com/downloads/setup_linux | sudo -E bash -
sudo apt install -y libphidget22
</syntaxhighlight>
</tabber>

Template:LinuxGetKey

2025-01-20T18:03:06Z

Patrick:

<tabber>
Root=
wget -qO /usr/share/keyrings/phidgets.gpg \
https://www.phidgets.com/gpgkey/pubring.gpg
echo deb [signed-by=/usr/share/keyrings/phidgets.gpg] \
http://www.phidgets.com/debian '''''distro''''' main \
> /etc/apt/sources.list.d/phidgets.list
|-|
Non-Root=
sudo wget -qO /usr/share/keyrings/phidgets.gpg \
https://www.phidgets.com/gpgkey/pubring.gpg
echo deb [signed-by=/usr/share/keyrings/phidgets.gpg] \
http://www.phidgets.com/debian '''''distro''''' main | sudo tee \
/etc/apt/sources.list.d/phidgets.list > /dev/null
</tabber>

Template:LinuxAptUpdate

2025-01-20T17:49:06Z

Patrick:

<tabber>
Root=
<syntaxhighlight lang=bash>
apt update
</syntaxhighlight>
|-|
Non-Root=
<syntaxhighlight lang=bash>
sudo apt update
</syntaxhighlight>
</tabber>

Template:LinuxAptInstall

2025-01-20T17:48:54Z

Patrick:

<tabber>
Root=
<syntaxhighlight lang=bash>
apt install libphidget22
</syntaxhighlight>
|-|
Non-Root=
<syntaxhighlight lang=bash>
sudo apt install libphidget22
</syntaxhighlight>
</tabber>

OS - Linux

2025-01-20T17:48:34Z

Patrick:

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

==Getting Started with Linux==
Welcome to using Phidgets with Linux!

Phidget22 is supported on the following distros and architectures '''(click to expand)''':
{{LinuxSupport}}

===Install===
The first step to using Phidgets with Linux is installing the Phidget22 libraries.

If you're running one of the supported distros, we recommend using the '''Package Install'''. For other systems, you can use the '''Source Install'''.

<div class="bigTabs">
<tabber>
Package Install=
====Install Script====
To run the install script and install phidget22, enter the following command in the terminal:

{{LinuxInstallScript}}

====Manual Install====
To install our package repository manually, enter the following command in the terminal, replacing ''distro'' with your distro codename:

{{LinuxGetKey}}

We support Debian releases from 6 to current, and Ubuntu LTS releases from 14.04 to current. If you are using another flavour of Linux (such as Mint), which is based on Ubuntu or Debian, use the corresponding Ubuntu or Debian codename.

Update your package lists:
{{LinuxAptUpdate}}

Finally, install the Phidget package by entering the command below:
{{LinuxAptInstall}}

====Additional Packages====
You may also want to apt install the following optional packages:
* '''libphidget22-dev''': The C development libraries for Phidget22
* '''libphidget22extra''': Extra runtime library required for the Network Server and Admin tools
* '''phidget22networkserver''': The [[Phidget Network Server]], which enables use of Phidgets over your network
* '''libphidget22java''': The Java libraries for Phidget22
* [[Phidget22admin Guide|'''phidget22admin''']]: An administrator utility for listing Phidgets and upgrading firmware
* '''phidget22wwwjs''': The JavaScript libraries for Phidget22. This package also installs the HTML examples which can be accessed through the web interface

The libraries are now installed on your machine. Next, set up the UDev rules below.

|-|
Source Install=
====Source Install====
To install our libraries, first install libusb-1.0 development libraries. The exact command and package name will vary depending on distribution. For Debian based distributions, including Ubuntu and Mint, the command would be:
<syntaxhighlight lang=bash>
apt install libusb-1.0-0-dev
</syntaxhighlight>

Next, download and unpack the following files:
*[https://cdn.phidgets.com/downloads/phidget22/libraries/linux/libphidget22.tar.gz libphidget22] (Mandatory)
*[https://cdn.phidgets.com/downloads/phidget22/libraries/linux/libphidget22extra.tar.gz libphidget22extra] (Optional - needed by NetworkServer and Admin)
*[https://cdn.phidgets.com/downloads/phidget22/libraries/linux/libphidget22java.tar.gz libphidget22java] (Optional - Java Libraries)
*[https://cdn.phidgets.com/downloads/phidget22/servers/linux/phidget22networkserver.tar.gz phidget22networkserver] (Optional - [[Phidget Network Server]])
*[https://cdn.phidgets.com/downloads/phidget22/tools/linux/phidget22admin.tar.gz phidget22admin] (Optional - Phidget Admin Tool)
Open the README file that is included at the top of each directory. This file will give you important information about how to properly install the files.

Libraries are installed in /usr/local/lib by default. If you run into trouble finding the libraries during linking or at runtime, this probably means that /usr/local/lib is not on the library path for your distribution.

You can handle this in a number of ways:

Specify a different install folder during compile
<syntaxhighlight lang=bash>./configure --prefix=/usr && make && sudo make install</syntaxhighlight>
OR Add /usr/local/lib to the system-wide library path
<syntaxhighlight lang=bash>echo /usr/local/lib >> /etc/ld.so.conf && sudo ldconfig</syntaxhighlight>
OR Add /usr/local/lib in your local shell every time
<syntaxhighlight lang=bash>export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib</syntaxhighlight>

The libraries are now installed on your machine. Next, you should set the UDev Rules.
</tabber>
</div>

=== Setting UDev Rules ===
By default, Linux will not grant permission to regular users to access physical hardware as a security feature. This means that in order to run Phidgets code from user space you must grant yourself root privileges via sudo. For example:

sudo ./HelloWorld

You can grant access manually or, more commonly, set up a rules file to do it automatically keying off of the vendor code for Phidget USB devices. To do this, create a text file called "99-libphidget22.rules" with the following contents:
<syntaxhighlight lang=bash>
# All current and future Phidgets - Vendor = 0x06c2, Product = 0x0030 - 0x00af
SUBSYSTEMS=="usb", ACTION=="add", ATTRS{idVendor}=="06c2", ATTRS{idProduct}=="00[3-a][0-f]", MODE="666"
</syntaxhighlight>

Where mode 666 means every user has permission to read and write to the specified file/device. You need to then move this file to "/etc/udev/rules.d". Now you can run Phidget related code as a regular user without the OS denying permission.

===Verify===
The best way to verify that your libraries are working properly is to compile and run an example program.

First, download and unpack this C example:
*[https://cdn.phidgets.com/downloads/phidget22/examples/c/Manager/Phidget22_HelloWorld_C_Ex.zip HelloWorld C example]

'''Note:''' If using the Debian intallation methods, you will need to install the '''libphidget22-dev''' package to use the C libraries for Phidget22

Next, open the terminal at the example location. Compile the example by entering the following command:
<syntaxhighlight lang=bash>
gcc HelloWorld.c -o HelloWorld -lphidget22
</syntaxhighlight>

Run the HelloWorld example:
<syntaxhighlight lang=bash>
./HelloWorld
</syntaxhighlight>

Your terminal should look something like this:
[[File:linux_helloworld.PNG|link=|center]]

The HelloWorld program will simply communicate when a Phidget has been attached or detached, as can be seen in the image above.

Your Phidget is now able to communicate with your development machine. The next step is selecting a programming language so you can start to write some code!

==Programming==
Ready to write some code? Select one of the programming languages below:

{{Programming_Languages_Table}}

==Older Versions==
If you need older versions of the Phidget22 Linux libraries, [{{SERVER}}/downloads/phidget22/libraries/linux/libphidget22/ click here].

If you need Phidget21 Linux Libraries, [{{SERVER}}/downloads/phidget21/libraries/linux/libphidget/ click here].

==Software License==
By downloading Linux Source you agree to adhere to the terms of the [https://opensource.org/licenses/BSD-3-Clause The 3-Clause BSD License].

Network Server Guide

2025-01-10T19:09:25Z

Patrick:

{{#seo:|description=Get started with the Phidget Network Server}}
[[Category:IntroGuide]]
<div class="nonumtoc">
<div class="toclimit-5">
==Introduction==
The Phidget Network Server is a powerful tool that allows you to do the following:
* Access Phidgets that are connected to other computers on your network.
* Access Phidgets from more than one application simultaneously.
* Host webpages and run JavaScript applications using the built-in web server.
* Manage dictionaries to easily share information between applications.

This guide will provide an overview of the Phidget Network Server and showcase how it can be used in your applications.

==How It Works==
The Phidget Network Server has three elements: a Phidget server, a web server, and a dictionary manager. The Phidget server is the primary component, which we will discuss here. The other components will be discussed later in this guide.

When the Phidget Network Server is running, your computer can host a '''Phidget server''' which makes all connected Phidget channels available to other computers on your network.

[[Image:NetworkServer_PhidgetServer.jpg|center|link=https://cdn.phidgets.com/docs/images/thumb/f/fd/NetworkServer_PhidgetServer.jpg/800px-NetworkServer_PhidgetServer.jpg|650px]]

As long as the Phidget server is running, clients can access the remote channels. They can be addressed, opened, and attached in much the same way as local channels.

Unlike local channels, remote channels may be opened by multiple programs simultaneously. There are some exceptions (e.g. motor controllers) that cannot be opened simultaneously for safety reasons.

===Hosts and Clients===
This guide references '''host''' computers and '''client''' computers.
*'''Host''': a computer or Wireless VINT Hub that is physically connected to Phidget devices and is running the Phidget Network Server.
*'''Client''': a computer running an application that accesses Phidget channels via the Phidget Server. The Phidget Network Server does '''not''' need to run on the client computer.

A single computer can act as both a host and a client. A Wireless VINT Hub (HUB5000) can only act as a host.

==Running the Phidget Network Server==
<tabber>
Windows=

On Windows machines, start by [[OS_-_Windows#Install|installing our libraries]]. Next, open the [[Phidget Control Panel|Phidget Control Panel]] on your host computer and navigate to the ''Network Server'' tab:

[[Image:Windows_networkserver.PNG|link=https://cdn.phidgets.com/docs/images/f/f4/Windows_networkserver.PNG|center]]

There are various [[#Network_Server_Settings|configuration settings]] for the Phidget Network Server. For now, press '''Start''' in the bottom right corner and navigate back to the Phidgets tab.

[[Image:Windows_controlpanel_remote.PNG|center|link=https://cdn.phidgets.com/docs/images/5/55/Windows_controlpanel_remote.PNG|500px]]

As shown above, the Phidget server is now making your channels available to other computers on your network. You can view/hide remote channels in the Phidget Control Panel by navigating to ''File > Options > List Remote Phidgets''.
|-|
macOS=

On macOS machines, start by [[OS_-_macOS#Install|installing our libraries]]. Next, open the [[Phidget_Control_Panel|Phidget Control Panel]] on your host computer and navigate to the ''Network Server'' tab:

[[File:macos_networkserver.png|600px|link=|center]]

There are various [[#Network_Server_Settings|configuration settings]] for the Phidget Network Server. For now, press '''Start''' at the top of the screen and navigate back to the Phidgets tab.

[[File:macos_controlpanel_remote.png|link=|center]]

As shown above, the Phidget Server is now making your channels available to other computers on your network.
|-|
Linux=

On Linux machines, start by [[OS_-_Linux#Install|installing our libraries]], specifically ''phidget22networkserver'' and ''phidget22admin''. The Phidget Network Server will start automatically after installing from packages.

Open the terminal on the client and type in the following command:
<syntaxhighlight lang=bash>
phidget22admin -s
</syntaxhighlight>
[[File:Linux_networkserver_phidgetadmin.PNG|link=|center|850px]]

This will list all of the Phidget servers on your network. Confirm that you can see a Phidget server running on your host computer.

After you have confirmed your server is running, type in the following command:
<syntaxhighlight lang=bash>
phidget22admin -R -d
</syntaxhighlight>

This command will list all remote Phidgets on the network. Confirm that you can see the Phidgets attached to your host computer:
[[File:Linux_networkserver_phidadminlist.PNG|link=|center]]
|-|
Wireless VINT Hub=

The Wireless VINT Hub will automatically run the Phidget Network Server on boot. No configuration is required. Please note that The Wireless VINT Hub is not able to manage dictionaries.
|-|
PhidgetSBC4=

The PhidgetSBC4 comes with the Phidget Network Server installed, and the SBC automatically starts the Phidget Network Server on boot. Open the web interface and navigate to '''Phidgets''' > '''phidget22Network Server''' to see the status.

[[File:Networkserver_sbc_boot.png|link=https://cdn.phidgets.com/docs/images/a/a7/Networkserver_sbc_boot.png|alt=|center|700px]]
</tabber>

==Connecting to Remote Phidgets==
After you have the [[#Running the Phidget Network Server|Phidget Network Server running]], you can access remote Phidget channels from a client computer.

===Networking API===
To access remote channels in your application, you will need to use our '''Networking API'''. Navigate to our [https://www.phidgets.com/?view=api API] and select Networking from the dropdown menu.
[[Image:Api_dropdown_networking.jpg|600px|center|link=https://cdn.phidgets.com/docs/images/2/2a/Api_dropdown_networking.jpg]]

Here you will see all relevant methods and events. There are two primary ways to connect to remote channels in your application:
# Specify hostname/IP address (recommended)
# Enable server discovery

Continue reading for more information.

====Connecting via Hostname/IP Address (Recommended)====
Specifying a hostname or IP address in your code is recommended for most applications. Examples of how to do this in various languages are shown below:

<tabber>
Python=<syntaxhighlight lang=python>
from Phidget22.Net import *

Net.addServer("ServerName", "hostname/IP address", 5661, "password", 0)
</syntaxhighlight>
|-|
Java=<syntaxhighlight lang=java>
Net.addServer("ServerName", "hostname/IP address", 5661, "password", 0);
</syntaxhighlight>
|-|
C#=<syntaxhighlight lang=cSharp>
Net.AddServer("ServerName", "hostname/IP address", 5661, "password", 0);
</syntaxhighlight>
|-|
C=<syntaxhighlight lang=c>
PhidgetNet_addServer("ServerName", "hostname/IP address", 5661, "password", 0);
</syntaxhighlight>
|-|
JavaScript=
<syntaxhighlight lang=javascript>
const conn = new phidget22.NetworkConnection(5661, "hostname")
await conn.connect()
</syntaxhighlight>
</tabber>

=====Hostname vs IP Address=====
For most applications, using a hostname to add a server is preferred (such as 'localhost' or 'hub5000.local'). This approach allows your application to adapt seamlessly to network changes. However, in certain scenarios, assigning a static IP address to your host may provide additional benefits.

====Enabling Server Discovery====
By enabling server discovery, you can access any Phidget server on your network that is published (see [[#Phidget_Server|Phidget server settings]] for more information about publishing). Examples of how to do this in various languages are shown below:

<tabber>
Python=<syntaxhighlight lang=python>
Net.enableServerDiscovery(PhidgetServerType.PHIDGETSERVER_DEVICEREMOTE)
</syntaxhighlight>
|-|
Java=<syntaxhighlight lang=java>
Net.enableServerDiscovery(ServerType.DEVICE_REMOTE);
</syntaxhighlight>
|-|
C#=<syntaxhighlight lang=cSharp>
Net.EnableServerDiscovery(ServerType.DeviceRemote);
</syntaxhighlight>
|-|
C=<syntaxhighlight lang=c>
PhidgetNet_enableServerDiscovery(PHIDGETSERVER_DEVICEREMOTE);
</syntaxhighlight>
|-|
JavaScript=

Server discovery is not available in JavaScript due to networking restrictions.
</tabber>
=====Considerations=====
Enabling server discovery is useful for certain applications. For example, if you need to manage a dynamic list of devices, similar to the Phidget Control Panel. It can also be useful during development, when devices and networks are changing frequently. For most applications and when deploying applications, [[#Connecting via Hostname/IP Address (Recommended)| connecting via hostname/IP address]] is recommended.

When using server discovery, review the following:
* A Phidget server must be [[#Phidget Server|published]] in order to connect to it.
* For Windows You must have [https://developer.apple.com/bonjour/ Bonjour] installed on both your host computer and your client computer. [https://phidgets.com/downloads/misc/Bonjour64.msi Download it here].
* Linux machines typically have Avahi preinstalled. It can also be easily installed with {{Code|apt install avahi-client}}
* macOS typically has Bonjour preinstalled, so no further configuration is required.

===Code Samples===
In this example, a Light Phidget (LUX1000) is plugged into a Wireless VINT Hub (HUB5000) which runs the Phidget Network Server. On a client machine, this code is used to remotely access the light sensor and sample
5 seconds of data.
<tabber>
Python=<syntaxhighlight lang='python'>
from Phidget22.Phidget import *
from Phidget22.Net import *
from Phidget22.Devices.LightSensor import *
import time

def onIlluminanceChange(self, illuminance):
print("Illuminance: " + str(illuminance))

def main():
Net.addServer("PHIDGETS-PC", "hub5000.local", 5661, "", 0);

lightSensor0 = LightSensor()

lightSensor0.setIsRemote(True)
lightSensor0.setDeviceSerialNumber(37299)

lightSensor0.setOnIlluminanceChangeHandler(onIlluminanceChange)

lightSensor0.openWaitForAttachment(20000)

time.sleep(5)

lightSensor0.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 {
Net.addServer("PHIDGETS-PC", "hub5000.local", 5661, "", 0);

LightSensor lightSensor0 = new LightSensor();

lightSensor0.setIsRemote(true);
lightSensor0.setDeviceSerialNumber(37299);

lightSensor0.addIlluminanceChangeListener(new LightSensorIlluminanceChangeListener() {
public void onIlluminanceChange(LightSensorIlluminanceChangeEvent e) {
System.out.println("Illuminance: " + e.getIlluminance());
}
});

lightSensor0.open(20000);

Thread.sleep(5000);

lightSensor0.close();
}
}
</syntaxhighlight>
|-|
C#=<syntaxhighlight lang='CSharp'>
using System;
using Phidget22;

namespace ConsoleApplication
{
class Program
{

private static void LightSensor0_IlluminanceChange(object sender, Phidget22.Events.LightSensorIlluminanceChangeEventArgs e)
{
Console.WriteLine("Illuminance: " + e.Illuminance);
}

static void Main(string[] args)
{
Net.AddServer("PHIDGETS-PC", "hub5000.local", 5661, "", 0);

LightSensor lightSensor0 = new LightSensor();

lightSensor0.IsRemote = true;
lightSensor0.DeviceSerialNumber = 37299;

lightSensor0.IlluminanceChange += LightSensor0_IlluminanceChange;

lightSensor0.Open(20000);

System.Threading.Thread.Sleep(5000);

lightSensor0.Close();
}
}
}
</syntaxhighlight>
|-|
C=<syntaxhighlight lang=cpp>
#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 onIlluminanceChange(PhidgetLightSensorHandle ch, void * ctx, double illuminance) {
printf("Illuminance: %lf\n", illuminance);
}

int main() {
PhidgetLightSensorHandle lightSensor0;

PhidgetNet_addServer("PHIDGETS-PC", "hub5000.local", 5661, "", 0);

PhidgetLightSensor_create(&lightSensor0);

Phidget_setIsRemote((PhidgetHandle)lightSensor0, 1);
Phidget_setDeviceSerialNumber((PhidgetHandle)lightSensor0, 37299);

PhidgetLightSensor_setOnIlluminanceChangeHandler(lightSensor0, onIlluminanceChange, NULL);

Phidget_openWaitForAttachment((PhidgetHandle)lightSensor0, 20000);

Sleep(5000);

Phidget_close((PhidgetHandle)lightSensor0);

PhidgetLightSensor_delete(&lightSensor0);
}

</syntaxhighlight>
|-|
JavaScript=<syntaxhighlight lang=javascript>
const phidget22 = require('phidget22');

async function runExample() {
const conn = new phidget22.NetworkConnection(5661, 'hub5000.local');
try {
await conn.connect();
} catch(err) {
console.error('Error during connect', err);
process.exit(1);
}

const lightSensor0 = new phidget22.LightSensor();

lightSensor0.setDeviceSerialNumber(37299);

lightSensor0.onIlluminanceChange = (illuminance) => {
console.log('Illuminance: ' + illuminance.toString());
};

try {
await lightSensor0.open(5000);
} catch(err) {
console.error('Error during open', err);
process.exit(1);
}

setTimeout(async () => {
await lightSensor0.close();
conn.close();
conn.delete();
}, 5000);
}

runExample();
</syntaxhighlight>
</tabber>

====Code Sample Generator====
The code sample above was generated using our [https://www.phidgets.com/?view=code_samples| Code Sample Generator]. To generate Network-enabled code for a specific device, select the '''Remote''' checkbox and specify a hostname.

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

==Webserver==
The Phidget Network Server includes a built-in web server and is required for supporting the Phidget JavaScript library for in-browser use.
* On Windows and macOS, a JavaScript version of the Phidget Control panel is served on port 8989 (http://localhost:8989) by default.
* On Linux machines, PhidgetSBC4, and the Wireless VINT Hub, a JavaScript version of the Phidget Control panel is served on port 8080 (http://localhost:8080) by default.

[[Image:Networkserver_webserver_controlpanel.jpg|center|500px|link=https://www.phidgets.com/docs/File:Networkserver_webserver_controlpanel.jpg]]

===Enabling the Webserver===
On Windows and macOS, you can enable the web server through the Phidget Control Panel:

[[Image:enable_webserver.jpg|center|800px|link=https://cdn.phidgets.com/docs/images/0/08/Enable_webserver.jpg]]

On Linux, you can enable it in the Phidget Network Server configuration file located at ''/etc/phidgets/phidget22networkserver.pc''. Modify '''enabled''' to '''true''' in the '''www''' section.

===Considerations===
The primary purpose of the Webserver is to support a Websockets connection for the Browser JavaScript library - because regular sockets cannot be used in Browser.

==Dictionaries==
The Phidget Network Server allows you to publish Phidget Dictionaries on your network. Dictionaries provide a convenient method of sharing information between applications. For more information, view our [[Phidget_Dictionary|Phidget Dictionaries Guide]].

==Upgrading the Phidget Network Server==
From time to time, you may consider upgrading your Phidget Network Server (i.e. your Phidget libraries). There are several reasons to do this, for example:
* Your application needs to support a new device.
* The [{{SERVER}}/?view=changelog Phidget22 Changelog] indicates that there was an improvement or bug fix that is relevant to your application. Consider signing up for Phidget22 Changelog notifications to stay updated.

When upgrading your Phidget libraries, you should ensure your host and client are on the same version for the best performance.

===Host: Determining Version===
Select the operating system of your host for more information.
<tabber>
Windows=

On Windows, the Phidget Network Server is managed from the Phidget Control Panel. Open the Phidget Control Panel and navigate to '''Help > About Phidget Control Panel''' to see the library version you are running.

[[Image:Networkserver_controlpanel_about_windows.png|center]]
|-|
macOS=

On macOS, the Phidget Network Server is managed from the Phidget Control Panel. Open the Phidget Control Panel and navigate to '''Phidget Control Panel > About Phidget Control Panel''' to see the library version you are running.

[[Image:Networkserver_controlpanel_about_mac.png|400px|center]]
|-|
Linux=

On Linux, open a terminal and enter the following command

<syntaxhighlight lang=bash>
apt show libphidget22
</syntaxhighlight>

[[Image:Networkserver_controlpanel_about_linux.png|center|400px|link=https://cdn.phidgets.com/docs/images/0/02/Networkserver_controlpanel_about_linux.png]]

|-|
Wireless VINT Hub=

On the Wireless VINT Hub (HUB5000), navigate to the web interface, select the '''Phidgets''' tab, and then select the '''View''' button.
[[Image:Networkserver_controlpanel_about_hub5000_1.png|center|400px|link=Networkserver_controlpanel_about_hub5000_1.png]]

You will now see the Phidget log. At the top of the file, you will see the library version:
[[Image:Networkserver_controlpanel_about_hub5000_2.png|center|400px|link=Networkserver_controlpanel_about_hub5000_2.png]]

|-|
PhidgetSBC=

On the PhidgetSBC, navigate to the web interface and select the '''Status > System''' tab.

[[Image:Networkserver_controlpanel_about_sbc.png|center|400px|link=Networkserver_controlpanel_about_sbc.png]]
</tabber>

===Client: Determining Version===
There are several ways to determine the version of the Phidget library used in your application. Below are some recommended methods.
====Phidget Logging====
If you have [[Phidget_Logging|Phidget Logging]] enabled in your application (recommended), you can view the library version that your project is using at the top of the log file.

[[Image:Networkserver_phidgetlog_version.png|center|500px|link=Networkserver_phidgetlog_version.png]]

====Phidget API====
The Phidget API makes it easy to verify the version of the Phidget libraries that your application is using. View the code samples below for more information.
<tabber>
Python=<syntaxhighlight lang='python'>
from Phidget22.Phidget import *
from Phidget22.Devices.VoltageInput import *

libraryVersion = Phidget.getLibraryVersion()
print("LibraryVersion: " + str(libraryVersion))

</syntaxhighlight>
|-|
Java=<syntaxhighlight lang='Java'>
import com.phidget22.*;

class Example {
public static void main(String[] args) {
try {
java.lang.String LibraryVersion = Phidget.getLibraryVersion();
} catch (PhidgetException ex) {
System.out.println("Failure: " + ex);
}
}
}
</syntaxhighlight>
|-|
C#=<syntaxhighlight lang='CSharp'>
using System;
using Phidget22;

class Program {
static void Main(string[] args) {
try {
string LibraryVersion = Phidget.LibraryVersion;
} catch (PhidgetException ex) {
Console.WriteLine("Failure: " + ex.Message);
}
}
}
</syntaxhighlight>
|-|
C=<syntaxhighlight lang=cpp>
int main() {
PhidgetReturnCode res;
const char *libraryVersion;

res = Phidget_getLibraryVersion(&libraryVersion);
if (res != EPHIDGET_OK)
return 1; // Exit in error

return 0;
}

</syntaxhighlight>
|-|
JavaScript=<syntaxhighlight lang=javascript>
// NOTE: This shows importing phidget22 in Node.JS. In-Browser JavaScript import is different
const phidget22 = require("phidget22");

async function main() {
const libraryVersion = Phidget.libraryVersion;
console.log("libraryVersion: " + libraryVersion);

}

main();
</syntaxhighlight>
</tabber>

==Phidget Network Server Logging==
The host computer will generate a Phidget Network Server log file. Select the operating system of your host below for information about where this log file can be found.
<tabber>
Windows=

On Windows, the Phidget Network Server log file is located at:

<code>C:\ProgramData\Phidgets\logs\Phidget22NetworkServer_networkserver.log</code>

You can also navigate here by opening the Phidget Control Panel an selecting '''Help''' > '''Open Logs Folder'''.
|-|
macOS=

On macOS, the Phidget Network Server log file is located at:

<code>/Library/Logs/phidget22networkserver.log</code>
|-|
Linux=

On Linux, the Phidget Network Server log file is located at:

<code>/var/log/phidget22networkserver.log</code>
|-|
Wireless VINT Hub=

On the Wireless VINT Hub (HUB5000), open the web interface and navigate to the '''Phidgets''' tab. Select the '''View''' button to view the log file.

[[Image:Networkserver_controlpanel_about_hub5000_1.png|center|400px|link=link=Networkserver_controlpanel_about_hub5000_1.png]]
|-|
PhidgetSBC4=

On the PhidgetSBC4, the Phidget Network Server log file is located at:

<code>/var/log/phidget22networkserver.log</code>
</tabber>

==Phidget Network Server Settings==
===Operating System===
There are a number of settings related to the Phidget Network Server. Select your operating system for more information about how to modify these settings.
<tabber>
Windows=

On Windows, you can adjust settings by opening the Phidget Control Panel and navigating to the '''Network Server''' tab.
|-|
macOS=

On macOS, you can adjust settings by opening the Phidget Control Panel and navigating to the '''Network Server''' tab.
|-|
Linux=

On Linux, you can adjust settings by navigating to the network server configuration file located at ''/etc/phidgets/phidget22networkserver.pc''.

|-|
Wireless VINT Hub=

On the Wireless VINT Hub (HUB5000), you can adjust settings through the web interface by navigating to the '''Phidgets''' tab.

|-|
PhidgetSBC=

On the PhidgetSBC, you can adjust settings through the web interface by navigating to the Phidgets Tab and then the '''phidget22 Network Server''' tab.
</tabber>

===Basic Settings===
====Startup Type====
{| class="wikitable" style="margin:auto"
|-
! Setting!! Description
|-
| Automatic || The Phidget Network Server will start automatically every time your machine boots.
|-
| Manual || The Phidget Network Server needs to be started manually. It will not restart when your machine boots. Another service may also start it when in Manual mode.
|-
| Disabled || The Phidget Network Server is disabled. This will disable all components, including the Phidget Server, the Webserver, and any Dictionaries. Other services will not be able to start it.
|}

====Phidget Server====
{| class="wikitable" style="margin:auto"
|-
! Setting!! Description
|-
| Enabled || Enables the Phidget Server. When enabled, client computers on your network will be able to access Phidgets that are connected to your computer.
|-
| Publish || This will determine if the Phidget Server should publish itself to mDNS. If you plan to use the {{Code|EnableServerDiscovery}} method in your applications, you must publish your Phidget Server. Otherwise, this can be disabled.
|-
| Server Name || Specify the name of your server. A {{Code|setServerName}} method is available when [[Addressing_Phidgets|addressing your channels]]. If you plan to use the {{Code|EnableServerDiscovery}} method in your applications, the Server Name can be used to enable or disable servers. The default server name is the computer name (hostname on Linux machines, Wireless VINT Hub, and PhidgetSBC4). This means if you do not specify a server name, your server name may change if your change your computer name or hostname.
|-
| Port || Specify the Phidget server port. ''Defaults to 5661''.
|-
| Password (optional) || This will determine if a password is required to access channels on the Phidget server.
|-
| Log Level|| When running, the Phidget Network Server will generate [[#Phidget Network Server Logging|logs]]. Use these options to configure the [[Phidget_Logging#Log_Levels|log level]]. Defaults to ''Info''.
|}

====Webserver====
{| class="wikitable" style="margin:auto"
|-
! Setting!! Description
|-
| Enabled || Enables the web server. The web server enables connections from the in-browser JavaScript library and allows hosting of files.
|-
| Port || Specify the web server port. Defaults to ''8989''.
|-
| Docroot|| Specify the location of your web server files.
|}

====Dictionaries====
{| class="wikitable" style="margin:auto"
|-
! Setting !! Description
|-
| Enabled User Dictionaries || Enables user dictionaries. These are useful for sharing information between applications.
|-
| Enable Monitoring/control Dictionary || Enables a monitoring/control dictionary that provides information about incoming/outgoing traffic related to your Phidget Network Server.
|}

For more information about dictionaries, view our [[Phidget_Dictionary|Phidget Dictionaries Guide]].

===Advanced Settings===
Advanced settings are available through a configuration file. Select the operating system of your host below for more information.

<tabber>
Windows=

For advanced settings, you can edit the configuration file directly by navigating to ''C:\ProgramData\Phidgets\phidget22networkserver.pc''. Refer to the Phidget Network Server Linux [[Media:PHIDGETNETWORKSERVER_README.txt| README]] for more information.
|-|
macOS=

For advanced settings, you can edit the configuration file directly by navigating to ''/Library/Preferences/Phidget22NetworkServer/phidget22networkserver.pc''. Refer to the Phidget Network Server Linux [[Media:PHIDGETNETWORKSERVER_README.txt| README]] for more information.
|-|
Linux=

On Linux, you can adjust settings by navigating to the network server configuration file located at ''/etc/phidgets/phidget22networkserver.pc''. Refer to the Phidget Network Server Linux [[Media:PHIDGETNETWORKSERVER_README.txt| README]] for more information.

You can also point the Phidget Network Server towards your own configuration file with the following command:
<syntaxhighlight lang=bash>
phidget22networkserver -c /path/to/configuration/file
</syntaxhighlight>

|-|
Wireless VINT Hub=

Advanced settings are not available on the Wireless VINT Hub.

|-|
PhidgetSBC=

For advanced settings, you can edit the configuration file directly by navigating to ''/etc/phidgets/phidget22networkserver.pc''. Refer to the Phidget Network Server Linux [[Media:PHIDGETNETWORKSERVER_README.txt| README]] for more information.

</tabber>

OS - macOS

2024-12-20T22:44:51Z

Patrick:

[[Category:OS]]

==Getting Started with macOS==
Welcome to using Phidgets with macOS!

Phidget22 is supported on '''macOS 10.11 and newer'''.

To get started, install our libraries.

===Quick Downloads===
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22.dmg macOS Installer Download]
* [https://cdn.phidgets.com/downloads/phidget22/tools/macos/Phidget22ControlPanel.dmg macOS Standalone Control Panel]
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip macOS Development Files]

===Install===
To begin, select which version of our installer to use:
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22.dmg Installer]
** '''Recommended for most users.'''
** Installs Phidget development libraries globally for use in C, Java or Max.
** Includes the Phidget Control Panel and the Phidget Network Server.

* [https://cdn.phidgets.com/downloads/phidget22/tools/macos/Phidget22ControlPanel.dmg Standalone]
** '''Optional''' for simpler setups (requires macOS 10.15 or newer).
** Self contained Application; no installer.
** Includes the Phidget Control Panel and the Phidget Network Server.

Open up the installer, and double click on ''Phidgets.pkg'' to install the libraries:
[[File:OSX Install 1.png|link=|alt=macOS Install|center]]

When prompted, continue with the installation:
[[File:OSX Install 2.png|link=|alt=macOS Install|center]]

If you are using macOS 10.13 or newer you will also need to give explicit permission for the driver to function. You can read about this here[https://developer.apple.com/library/content/technotes/tn2459/_index.html].

The Phidgets libraries are now installed on your machine. Next, let's verify that the Phidget libraries are working properly.

===Verify===
The best way to verify that your libraries are working properly is to use the Phidget Control Panel. The Phidget Control Panel is a powerful tool that will help you develop your Phidgets applications. Get started by following the instructions below:

Open Finder and navigate to the Phidget Control Panel in the Applications list:
[[File:OSX Finder Apps.png|link=|800px|alt=macOS Finder Apps|center]]

Double click on the Phidgets icon to bring up the Phidget Control Panel. You can now see all the Phidgets that are plugged into your machine, as well as any Phidgets that are on the network:
[[File:OSX ControlPanel General.png|600px|link=|alt=macOS Control Panel General|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:OSX Control Panel Channel.png ‎|link=|alt=macOS Control Panel Channel|center]]

The Phidget Control Panel can be used for testing devices, updating firmware, enabling a network server, and more! Visit the [[Phidget Control Panel#macOS|Phidget Control Panel]] page if you want to delve a little deeper.

Your Phidget is now able to communicate with your development machine. The next step is selecting a programming language so you can start to write some code!

==Programming==
Ready to write some code? Select one of the programming languages below:

{{Programming_Languages_Table}}

===Development Files===
If you're a developer and want to bundle the Phidget libraries with your application for distribution, download the [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip macOS Development Files]. See the included README for more details.

===Older Versions===
If you need older versions of the macOS libraries, [{{SERVER}}/downloads/phidget22/libraries/macos/Phidget22/ click here].

===Software License===
By downloading the macOS installer 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 [https://opensource.org/licenses/BSD-3-Clause The 3-Clause BSD License].

OS - macOS

2024-12-20T22:26:03Z

Patrick:

[[Category:OS]]

==Getting Started with macOS==
Welcome to using Phidgets with macOS!

Phidget22 is supported on '''macOS 10.11 and newer'''.

To get started, install our libraries.

===Quick Downloads===
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22.dmg macOS Installer Download]
* [https://cdn.phidgets.com/downloads/phidget22/tools/macos/Phidget22ControlPanel.dmg macOS Standalone Control Panel]
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip macOS Development Files]

===Install===
To begin, select which version of our installer to use:
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22.dmg Installer]
** '''Recommended for most users.'''
** Installs Phidget development libraries globally for use in C, Java or Max.
** Includes the Phidget Control Panel and the Phidget Network Server.

* [https://cdn.phidgets.com/downloads/phidget22/tools/macos/Phidget22ControlPanel.dmg Standalone]
** '''Optional''' for simpler setups (requires macOS 10.15 or newer).
** Self contained Application; no installer.
** Includes the Phidget Control Panel and the Phidget Network Server.

Open up the installer, and double click on ''Phidgets.pkg'' to install the libraries:
[[File:OSX Install 1.png|link=|alt=macOS Install|center]]

When prompted, continue with the installation:
[[File:OSX Install 2.png|link=|alt=macOS Install|center]]

If you are using macOS 10.13 or newer you will also need to give explicit permission for the driver to function. You can read about this here[https://developer.apple.com/library/content/technotes/tn2459/_index.html].

The Phidgets libraries are now installed on your machine. Next, let's verify that the Phidget libraries are working properly.

===Verify===
The best way to verify that your libraries are working properly is to use the Phidget Control Panel. The Phidget Control Panel is a powerful tool that will help you develop your Phidgets applications. Get started by following the instructions below:

Open Finder and navigate to the Phidget Control Panel in the Applications list:
[[File:OSX Finder Apps.png|link=|800px|alt=macOS Finder Apps|center]]

Double click on the Phidgets icon to bring up the Phidget Control Panel. You can now see all the Phidgets that are plugged into your machine, as well as any Phidgets that are on the network:
[[File:OSX ControlPanel General.png|600px|link=|alt=macOS Control Panel General|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:OSX Control Panel Channel.png ‎|link=|alt=macOS Control Panel Channel|center]]

The Phidget Control Panel can be used for testing devices, updating firmware, enabling a network server, and more! Visit the [[Phidget Control Panel#macOS|Phidget Control Panel]] page if you want to delve a little deeper.

Your Phidget is now able to communicate with your development machine. The next step is selecting a programming language so you can start to write some code!

==Programming==
Ready to write some code? Select one of the programming languages below:

{{Programming_Languages_Table}}

===Development Files===
If you're a developer and want to bundle the Phidget libraries with your application for distribution, download the [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip macOS Development Files]. See the included README for more details.

===Older Versions===
If you need older versions of the macOS libraries, [{{SERVER}}/downloads/phidget22/libraries/macos/Phidget22/ click here].

===Software License===
By downloading the macOS Framework you agree to adhere to the terms of the [{{SERVER}}/documentation/Licenses/Phidgets_EULA.pdf Phidgets End User License Agreement]. The C API section of Phidget22 is covered by the [https://opensource.org/licenses/BSD-3-Clause The 3-Clause BSD License]. The source code of C API can be found [{{SERVER}}/downloads/phidget22/libraries/linux/libphidget22.tar.gz here].

OS - macOS

2024-12-20T22:07:59Z

Patrick:

[[Category:OS]]

==Getting Started with macOS==
Welcome to using Phidgets with macOS!

Phidget22 is supported on '''macOS 10.11 and newer'''.

To get started, install our libraries.

===Quick Downloads===
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22.dmg macOS Installer Download]
* [https://cdn.phidgets.com/downloads/phidget22/tools/macos/Phidget22ControlPanel.dmg macOS Standalone Control Panel]
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip macOS Development Files]

===For Developers===
If you're a developer and want to bundle the Phidget libraries with your application, or if you want to program against our drivers, download the [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip macOS Development Files]. See the included README for more details.

===Install===
To begin, select which version of our installer to use:
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22.dmg Installer]
** '''Recommended for most users.'''
** Installs Phidget development libraries globally for use in C, Java or Max.
** Includes the Phidget Control Panel and the Phidget Network Server.

* [https://cdn.phidgets.com/downloads/phidget22/tools/macos/Phidget22ControlPanel.dmg Standalone]
** '''Optional''' for simpler setups (requires macOS 10.15 or newer).
** Self contained Application; no installer.
** Includes the Phidget Control Panel and the Phidget Network Server.

Next, open up the installer, and double click on ''Phidgets.pkg'' to install the libraries:
[[File:OSX Install 1.png|link=|alt=macOS Install|center]]

When prompted, continue with the installation:
[[File:OSX Install 2.png|link=|alt=macOS Install|center]]

If you are using macOS 10.13 or newer you will also need to give explicit permission for the driver to function. You can read about this here[https://developer.apple.com/library/content/technotes/tn2459/_index.html].

The Phidgets libraries are now installed on your machine. Next, let's verify that the Phidget libraries are working properly.

===Verify===
The best way to verify that your libraries are working properly is to use the Phidget Control Panel. The Phidget Control Panel is a powerful tool that will help you develop your Phidgets applications. Get started by following the instructions below:

Open Finder and navigate to the Phidget Control Panel in the Applications list:
[[File:OSX Finder Apps.png|link=|800px|alt=macOS Finder Apps|center]]

Double click on the Phidgets icon to bring up the Phidget Control Panel. You can now see all the Phidgets that are plugged into your machine, as well as any Phidgets that are on the network:
[[File:OSX ControlPanel General.png|600px|link=|alt=macOS Control Panel General|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:OSX Control Panel Channel.png ‎|link=|alt=macOS Control Panel Channel|center]]

The Phidget Control Panel can be used for testing devices, updating firmware, enabling a network server, and more! Visit the [[Phidget Control Panel#macOS|Phidget Control Panel]] page if you want to delve a little deeper.

Your Phidget is now able to communicate with your development machine. The next step is selecting a programming language so you can start to write some code!

==Programming==
Ready to write some code? Select one of the programming languages below:

{{Programming_Languages_Table}}

==Advanced Information==

===Installed Files===
These files were placed onto your system as part of the installation process:
{| class="wikitable"
|-
| align="center" style="background:#f0f0f0;"|'''File'''
| align="center" style="background:#f0f0f0;"|'''Description'''
| align="center" style="background:#f0f0f0;"|'''Location'''
|-
|Phidget22.framework||contains our library, which is used at run-time.||/Library/Frameworks
|-
|Phidget.kext||kernel extension.||/Library/Extensions
|-
|phidgetnetworkserver22||Phidget Network Server||/usr/local/bin
|-
|}

===Older Versions===
If you need older versions of the macOS libraries, [{{SERVER}}/downloads/phidget22/libraries/macos/Phidget22/ click here].

===Software License===
By downloading the macOS Framework you agree to adhere to the terms of the [{{SERVER}}/documentation/Licenses/Phidgets_EULA.pdf Phidgets End User License Agreement]. The C API section of Phidget22 is covered by the [https://opensource.org/licenses/BSD-3-Clause The 3-Clause BSD License]. The source code of C API can be found [{{SERVER}}/downloads/phidget22/libraries/linux/libphidget22.tar.gz here].

Addressing Phidgets

2024-12-03T23:00:42Z

Patrick:

[[Category:Programming]]{{Recommended_Flow_Links|{{Flow Page Number|{{PAGENAME}} }} }}
__NOTOC__
Before opening a Phidget channel, it is important to set enough of the addressing properties to ensure your program attaches to the right Phidgets. Keep reading for an overview of the parameters available to you.

The following video summarizes the basics of how to address the proper channel in your code:
<center>{{#ev:youtube|HUswzM-DQHg|||||rel=0}}</center>

==Intro to Addressing Phidgets==

When opening a channel, the Phidget library will attach it to the first available physical channel that matches all given addressing parameters. If no addressing parameters are specified, the first available channel of the correct class will be attached. This works well for single Phidgets, but will give undefined results when two similar Phidgets are plugged in to the same computer.

For this reason, it is important to specify enough addressing information to make sure your program attaches to the right Phidget.

A good practice is to always specify at least the device serial number and the channel number of the channel on the Phidget that should be attached to the software channel. Even when not strictly necessary, setting as many addressing properties as possible can ensure that code will not break in the future.

==Addressing Properties==

Now we will outline the available addressing properties available to you, and describe what they are. You may specify as many, or as few as is necessary for your application.

*[[#Channel Class|Channel Class]]
*[[#Channel Number|Channel Number]]
*[[#Hub Port|Hub Port]]
*[[#"Is Hub Port Device"|"Is Hub Port Device"]]
*[[#Serial Number|Serial Number]]
*[[#Label|Label]]

===Channel Class===
[[Image:ChannelClass.jpg|150px|right|thumb|The Phidget's channel classes highlighted in yellow.|link=]]
Each channel exported by a Phidget device has channel class. The channel class describes the type of Phidget being used, and must be known to start interacting with the Phidget. A Phidget can have multiple channels, and they may even have different channel classes, like the example shown in the image to the right. You can find which channel classes are used with your Phidget by finding them listed on the enclosure, or on the '''API''' tab of the product's page.

The {{Code|channelClass}} property is implied by the handle and API you use to communicate with the Phidget. For instance a DigitalOutput channel has a channel class of DigitalOutput, and a HumiditySensor channel has a channel class of HumiditySensor.

Get the '''channel class''' with the {{Code|ChannelClass}} property. It's often useful for [[Using Multiple Phidgets#Distinguishing Events|distinguishing which Phidget channel]] called a shared Attach, Detach, or Error Event Handler.

<br clear="all">

===Channel Number===
[[Image:ChannelID.jpg|150px|right|thumb|Channel numbers highlighted in yellow.|link=]]
Each channel on a Phidget device has a channel number, normally starting at 0. The channel number will allow you to distinguish between multiple channels on a single device. If the Phidget has more than one channel class, the numbering starts back at zero for each class. For example, the [{{SERVER}}/?prodid=962 Thumbstick Phidget] has two VoltageRatioInput channels (0 and 1), and a single DigitalInput channel (0).

The {{Code|channel}} property must be set to ensure the physical channel the Phidget software library attaches to is right one. If the {{Code|channel}} property is not specified, the library will attach to channel 0 if available, or the next available channel if not.

Set the '''channel number''' with the {{Code|Channel}} property.
<br clear="all">

===Hub Port===
[[File:Vint_hub_port.jpg|150px|right|thumb|Numbered ports on a VINT Hub.|link=]]
{{CT|VINTHub|VINT hubs}} have a number of ports that VINT devices can be connected to. To ensure the correct VINT device is attached, the hub port must be specified. If two temperature sensors are attached to the same hub, and the hub port is not specified prior to opening a {{Code|TemperatureSensor}} channel, there is no way to know which temperature sensor will be attached.

Set the '''hub port''' with the {{Code|HubPort}} property.
<br clear="all">
==="Is Hub Port Device"===
[[File:IsHubPortDevice.jpg|250px|right|thumb|Examples of devices that would require IsHubPortDevice to be true.|link={{SERVER}}/docs/images/d/d8/IsHubPortDevice.jpg]]
VINT ports have the ability to be used with analog sensors as well as with intelligent VINT Phidgets. If you are trying to use a simple device such as a slider, a 0-5V sensor, a switch, or an LED with the VINT port directly, you will want to set this property to {{Code|TRUE}}. Otherwise this should be left as default or set to {{Code|FALSE}}.

Set '''is hub port device''' with the {{Code|IsHubPortDevice}} property.
<br clear="all">
===Serial Number===
[[File:SerialNumber.jpg|150px|right|thumb|The serial number on the underside of a Phidget.|link=]]
Each Phidget has a unique serial number (VINT devices inherit the serial number of the hub they're connected to). When you use more than one device with the same channel class, the device serial number must be specified to ensure the channel on the desired device is matched. The device serial number can be found on a label on the underside of the Phidget, or determined by reading the {{Code|DeviceSerialNumber}} property.

Set the '''device serial number''' with the {{Code|DeviceSerialNumber}} property.
<br clear="all">
===Label===

If you want to have a human-readable way to reference your Phidget instead of an arbitrary serial number, you can use the Label feature of Phidgets. You can call the {{Code|WriteLabel}} method to permanently store the desired label in the Phidget's onboard flash. From then on, you can set the {{Code|DeviceLabel}} property of a channel before opening it.

There are some limitations that will determine if you can use Labels in your project:

* You can only write labels to Phidgets that have serial numbers.
* In [[OS - Windows|Windows]], any label can be read, but label can only be written for newer Phidgets that support firmware upgrading.
* Some programming languages do not support writing to labels. See the Phidget22 API to see if it's supported in your language.

If you have a VINT Hub that has a label written to it, you can use the same label to address any device connected to that hub. See the [[HUB0000_User_Guide|User Guide]] for more information on using labels with the VINT Hub.

Note: You should be careful when writing labels to your Phidgets in your code, because the label is stored in flash which can only be re-written around 10,000 times before it will no longer write. If your program is complex, be sure to test it thoroughly before using {{Code|WriteLabel}} to avoid accidentally burning out the flash.

==Finding the Addressing Information==

If you are ever unsure what the addressing parameters are for a given Phidget channel, the addressing parameters can be found using the '''Phidget Control Panel''' by clicking the button at the top of the Control Panel example for that Phidget.
[[Image:AddressingButton.png|center|link=|The locate Phidget button is found in the device information box]]

In the Addressing Information window, the section above the line displays information you will need to connect to your Phidget from any application. In particular, note the ''Channel Class'' field as this will be the API you will need to use with your Phidget, and the type of example you should use to get started with it. The section below the line provides information about the network the Phidget is connected on if it is attached remotely. Keep track of these parameters moving forward, as you will need them once you start running our examples or your own code.
[[Image:AddressInfo.png|center|link=|All the information you need to address your Phidget]]

==Code Samples==

Here are some examples of how to address Phidgets:

==== Opening a Channel on a USB Phidget ====

[[Image:channel-matching-1.jpg|link=|500px|center]]

In this example, a [{{SERVER}}/products.php?product_id=1018 1018 PhidgetInterfaceKit 8/8/8] is connected to a computer. A [{{SERVER}}/products.php?product_id=1108 1108 Magnetic Sensor] is connected to analog port 3 on the 1018. Here's how you would open the channel for the magnetic sensor:

<tabber>
Python=<syntaxhighlight lang=python>
ch = VoltageRatioInput()
ch.setDeviceSerialNumber(324781)
ch.setChannel(3)
ch.openWaitForAttachment(5000)
</syntaxhighlight>
|-|
Java=<syntaxhighlight lang=java>
VoltageRatioInput ch = new VoltageRatioInput();
ch.setDeviceSerialNumber(324781);
ch.setChannel(3);
ch.open(5000);
</syntaxhighlight>
|-|
C#=<syntaxhighlight lang=cSharp>
VoltageRatioInput ch = new VoltageRatioInput();
ch.DeviceSerialNumber = 324781;
ch.Channel = 3;
ch.Open(5000);
</syntaxhighlight>
|-|
C=<syntaxhighlight lang=c>
PhidgetVoltageRatioInputHandle ch;
PhidgetVoltageRatioInput_create(&ch);

Phidget_setDeviceSerialNumber((PhidgetHandle)ch, 324781);
Phidget_setChannel((PhidgetHandle)ch, 3);
Phdiget_openWaitForAttachment((PhidgetHandle)ch, 5000);
</syntaxhighlight>
|-|
JavaScript=<syntaxhighlight lang=javascript>
const ch = new phidget22.VoltageRatioInput()
ch.deviceSerialNumber = 324781
ch.channel = 3
await ch.open(5000)
</syntaxhighlight>
</tabber>

If you wanted to open digital input 5 in the same example, it would look like this:

<tabber>
Python=<syntaxhighlight lang=python>
ch = DigitalInput()
ch.setDeviceSerialNumber(324781)
ch.setChannel(5)
ch.openWaitForAttachment(5000)
</syntaxhighlight>
|-|
Java=<syntaxhighlight lang=java>
DigitalInput ch = new DigitalInput();
ch.setDeviceSerialNumber(324781);
ch.setChannel(5);
ch.open(5000);
</syntaxhighlight>
|-|
C#=<syntaxhighlight lang=cSharp>
DigitalInput ch = new DigitalInput();
ch.DeviceSerialNumber = 324781;
ch.Channel = 5;
ch.Open(5000);
</syntaxhighlight>
|-|
C=<syntaxhighlight lang=c>
PhidgetDigitalInputHandle ch;
PhidgetDigitalInput_create(&ch);

Phidget_setDeviceSerialNumber((PhidgetHandle)ch, 324781);
Phidget_setChannel((PhidgetHandle)ch, 5);
Phdiget_openWaitForAttachment((PhidgetHandle)ch, 5000);
</syntaxhighlight>
|-|
JavaScript=<syntaxhighlight lang=javascript>
const ch = new phidget22.DigitalInput()
ch.deviceSerialNumber = 324781
ch.channel = 5
await ch.open(5000)
</syntaxhighlight>
</tabber>

==== Opening a Channel on a VINT Device ====

In this example, we have a [{{SERVER}}/products.php?product_id=TMP1101 TMP1101 4x Thermocouple Phidget] and a [{{SERVER}}/products.php?product_id=HUB0000 HUB0000 VINT Hub].

[[Image:channel-matching-3.jpg|link=|500px|center]]

Let's say we want to open both the thermocouple connected to port 0 and the integrated temperature sensor on the board. We first need to figure out which channels those are. You can find this information on the [{{SERVER}}/products.php?product_id=TMP1101 product page for the TMP1101] and click on the API tab. From the table at the top of the tab, we can see that the integrated temperature sensor is TemperatureSensor channel 4. Opening these channels would look like this:

<tabber>
Python=<syntaxhighlight lang=python>
tc = TemperatureSensor() # Handle for the thermocouple
ic = TemperatureSensor() # Handle for the integrated temperature chip

tc.setDeviceSerialNumber(370181)
ic.setDeviceSerialNumber(370181)
tc.setHubPort(2)
ic.setHubPort(2)
tc.setChannel(0)
ic.setChannel(4)

tc.openWaitForAttachment(5000)
ic.openWaitForAttachment(5000)
</syntaxhighlight>
|-|
Java=<syntaxhighlight lang=java>
TemperatureSensor tc = new TemperatureSensor(); // Handle for the thermocouple
TemperatureSensor ic = new TemperatureSensor(); // Handle for the integrated temperature chip

tc.setDeviceSerialNumber(370181);
ic.setDeviceSerialNumber(370181);
tc.setHubPort(2);
ic.setHubPort(2);
tc.setChannel(0);
ic.setChannel(4);

tc.open(5000);
ic.open(5000);
</syntaxhighlight>
|-|
C#=<syntaxhighlight lang=cSharp>
TemperatureSensor tc = new TemperatureSensor(); // Handle for the thermocouple
TemperatureSensor ic = new TemperatureSensor(); // Handle for the integrated temperature chip

tc.DeviceSerialNumber = 370181;
ic.DeviceSerialNumber = 370181;
tc.HubPort = 2;
ic.HubPort = 2;
tc.Channel = 0;
ic.Channel = 4;

tc.Open(5000);
ic.Open(5000);
</syntaxhighlight>
|-|
C=<syntaxhighlight lang=c>
PhidgetTemperatureSensorHandle tc; // Handle for the thermocouple
PhidgetTemperatureSensorHandle ic; // Handle for the integrated temperature chip
PhidgetTemperatureSensor_create(&tc);
PhidgetTemperatureSensor_create(&ic);

Phidget_setDeviceSerialNumber((PhidgetHandle)tc, 370181);
Phidget_setDeviceSerialNumber((PhidgetHandle)ic, 370181);
Phidget_setHubPort((PhidgetHandle)tc, 2);
Phidget_setHubPort((PhidgetHandle)ic, 2);
Phidget_setChannel((PhidgetHandle)tc, 0);
Phidget_setChannel((PhidgetHandle)ic, 4);

Phidget_openWaitForAttachment((PhidgetHandle)tc, 5000);
Phidget_openWaitForAttachment((PhidgetHandle)ic, 5000);
</syntaxhighlight>
|-|
JavaScript=<syntaxhighlight lang=javascript>
const tc = new phidget22.TemperatureSensor() // Handle for the thermocouple
const ic = new phidget22.TemperatureSensor() // Handle for the integrated temperature chip

tc.deviceSerialNumber = 370181
ic.deviceSerialNumber = 370181
tc.hubPort = 2
ic.hubPort = 2
tc.channel = 0
ic.channel = 4

await tc.open(5000)
await ic.open(5000)
</syntaxhighlight>
</tabber>

==== Opening a VINT Hub Port as a Channel ====

The ports on a [[What is VINT?|VINT]] Hub can be opened as Digital Inputs, Digital Outputs, Voltage Inputs, or Voltage Ratio Inputs. Suppose you had a [{{SERVER}}/products.php?product_id=HUB0000 HUB0000 VINT Hub] with a ''Ratiometric'' sensor connected to its fourth port.

[[Image:channel-matching-2.jpg|link=|500px|center]]

Here's how you would open it:

<tabber>
Python=<syntaxhighlight lang=python>
ch = VoltageRatioInput()
ch.setDeviceSerialNumber(370181)
ch.setIsHubPortDevice(True)
ch.setHubPort(4)
ch.openWaitForAttachment(5000)
</syntaxhighlight>
|-|
Java=<syntaxhighlight lang=java>
VoltageRatioInput ch = new VoltageRatioInput();
ch.setDeviceSerialNumber(370181);
ch.setIsHubPortDevice(true);
ch.setHubPort(4);
ch.open(5000);
</syntaxhighlight>
|-|
C#=<syntaxhighlight lang=cSharp>
VoltageRatioInput ch = new VoltageRatioInput();
ch.DeviceSerialNumber = 370181;
ch.IsHubPortDevice = true;
ch.HubPort = 4;
ch.Open(5000);
</syntaxhighlight>
|-|
C=<syntaxhighlight lang=c>
PhidgetVoltageRatioInputHandle ch;
PhidgetVoltageRatioInput_create(&ch);

Phidget_setDeviceSerialNumber((PhidgetHandle)ch, 370181);
Phidget_setIsHubPortDevice((PhidgetHandle)ch, 1);
Phidget_setHubPort((PhidgetHandle)ch, 4);
Phdiget_openWaitForAttachment((PhidgetHandle)ch, 5000);
</syntaxhighlight>
|-|
JavaScript=<syntaxhighlight lang=javascript>
const ch = new phidget22.VoltageRatioInput()
ch.deviceSerialNumber = 370181
ch.isHubPortDevice = true
ch.hubPort = 4
await ch.open(5000)
</syntaxhighlight>
</tabber>

==== Opening a Channel on a Remote Phidget ====

Suppose you wanted to open a locally connected Phidget remotely over the Network Service, so that you could have multiple programs connecting to it at the same time. In this example, we have a [{{SERVER}}/products.php?product_id=1024 1024 PhidgetRFID] connected to a computer that has the Phidget Network Server enabled.

[[Image:channel-matching-4.jpg|link=|600px|center]]

You could open the RFID reader channel remotely with the following code:

<tabber>
Python=<syntaxhighlight lang=python>
ch = new RFID();

#Enable connecting to the Phidget Network Server
Net.enableServerDiscovery(PhidgetServerType.PHIDGETSERVER_DEVICEREMOTE)

ch.setDeviceSerialNumber(388624);
ch.setIsRemote(True);
ch.openWaitForAttachment(5000);
</syntaxhighlight>
|-|
Java=<syntaxhighlight lang=java>
RFID ch = new RFID();

//Enable connecting to the Phidget Network Server
Net.enableServerDiscovery(ServerType.DEVICE_REMOTE);

ch.setDeviceSerialNumber(388624);
ch.setIsRemote(true);
ch.open(5000);
</syntaxhighlight>
|-|
C#=<syntaxhighlight lang=cSharp>
RFID ch = new RFID();

//Enable connecting to the Phidget Network Server
Net.EnableServerDiscovery(ServerType.DeviceRemote);

ch.DeviceSerialNumber = 388624;
ch.IsRemote = true;
ch.Open(5000);
</syntaxhighlight>
|-|
C=<syntaxhighlight lang=c>
PhidgetRFIDHandle ch;
PhidgetRFID_create(&ch)

//Enable connecting to the Phidget Network Server
PhidgetNet_enableServerDiscovery(PHIDGETSERVER_DEVICEREMOTE);

Phidget_setDeviceSerialNumber((PhidgetHandle)ch, 388624);
Phidget_setIsRemote((PhidgetHandle)ch, 1);
Phidget_open((PhidgetHandle)ch, 5000);
</syntaxhighlight>
|-|
JavaScript=
In Javascript, all Phidgets are opened remotely if the '''NetworkConnection''' object is used. Once you've connected in this way, all channels are opened over the network. If you want to open locally via USB, you need to use the '''USBConnection''' object instead (this is only supported for VINT devices).
<syntaxhighlight lang=javascript>
const conn = new phidget22.NetworkConnection(5661, 'localhost')
await conn.connect()

const ch = new phidget22.RFID()
ch.deviceSerialNumber = 388624
await ch.open(5000)
</syntaxhighlight>
</tabber>

{{Flow Navigation Buttons|{{Flow Page Number|{{PAGENAME}} }} }}

OS - macOS

2024-05-14T17:12:15Z

Patrick:

[[Category:OS]]

{{NoticeBox|Note to macOS 11+ Users:|If you're having issues with the regular installer, try installing and running the [https://cdn.phidgets.com/downloads/phidget22/tools/macos/Phidget22ControlPanel.dmg Standalone Control Panel], which uses a driver extension instead of a kernel extension.}}

{|
|style="vertical-align:middle; width: 60%;"|
==Getting Started with macOS==
Welcome to using Phidgets with macOS!

If you are ready to go, the first step in creating macOS applications with Phidgets is installing our libraries.
|{{TOC limit|3}}
|}

===Install===
To install our libraries, download the installer for your system:
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22.dmg macOS Installer Download]

Before installing our libraries, be sure to read our [[Software License]]. If you need to access older versions of the drivers, [https://www.phidgets.com/downloads/phidget22/libraries/macos/ click here].

Next, open up the installer, and double click on ''Phidgets.pkg'' to install the libraries:
[[File:OSX Install 1.png|link=|alt=macOS Install|center]]

When prompted, continue with the installation:
[[File:OSX Install 2.png|link=|alt=macOS Install|center]]

If you are using OS X 10.13 or newer you will also need to give explicit permission for the driver to function. You can read about this here[https://developer.apple.com/library/content/technotes/tn2459/_index.html].

The Phidgets libraries are now installed on your machine. Next, let's verify that the Phidget libraries are working properly.

===Verify===
The best way to verify that your libraries are working properly is to use the Phidget Control Panel. The Phidget Control Panel is a powerful tool that will help you develop your Phidgets applications. Get started by following the instructions below:

Open Finder and navigate to the Phidget Control Panel in the Applications list:
[[File:OSX Finder Apps.png|link=|900px|alt=macOS Finder Apps|center]]

Double click on the Phidgets icon to bring up the Phidget Control Panel. You can now see all the Phidgets that are plugged into your machine, as well as any Phidgets that are on the network:
[[File:OSX ControlPanel General.png|600px|link=|alt=macOS Control Panel General|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:OSX Control Panel Channel.png ‎|link=|alt=macOS Control Panel Channel|center]]

The Phidget Control Panel can be used for testing devices, updating firmware, enabling a network server, and more! Visit the [[Phidget Control Panel#macOS|Phidget Control Panel]] page if you want to delve a little deeper.

Your Phidget is now able to communicate with your development machine. The next step is selecting a programming language so you can start to write some code!

==Programming==
Ready to write some code? Select one of the programming languages below:

{{Programming_Languages_Table}}

==Advanced Information==

===Installed Files===
These files were placed onto your system as part of the installation process:
{| class="wikitable"
|-
| align="center" style="background:#f0f0f0;"|'''File'''
| align="center" style="background:#f0f0f0;"|'''Description'''
| align="center" style="background:#f0f0f0;"|'''Location'''
|-
|Phidget22.framework||contains our library, which is used at run-time.||/Library/Frameworks
|-
|Phidget.kext||kernel extension.||/Library/Extensions
|-
|phidgetnetworkserver22||Phidget Network Server||/usr/local/bin
|-
|}

===Developer Tools===
If you're a software developer and want to be able to bundle Phidgets with your application, you'll need our developer tools:

* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip Phidgets macOS Developer Tools]

You can also use the tools in this package to do a custom minimal install.

Please see the included README file for details on how to use these tools.

===Older Versions===
If you need older versions of the macOS libraries, [{{SERVER}}/downloads/phidget22/libraries/macos/Phidget22/ click here].

===Standalone Control Panel===
If you just want to install the [[Phidget_Control_Panel#macOS|Phidget Control Panel]] without the rest of our libraries (requires macOS 10.15 and newer):

* [https://cdn.phidgets.com/downloads/phidget22/tools/macos/Phidget22ControlPanel.dmg macOS Standalone Control Panel]

If you intend to write code that uses Phidgets, you should use the main installer mentioned at the beginning of this guide.

OS - macOS

2024-05-14T17:11:33Z

Patrick:

[[Category:OS]]

{{NoticeBox|Note to macOS 11+ Users:|If you're having issues with the regular installer, try installing and running the [https://cdn.phidgets.com/downloads/phidget22/tools/macos/Phidget22ControlPanel.dmg Standalone Control Panel], which uses a driver extension instead of a kernel extension.}}

{|
|style="vertical-align:middle; width: 60%;"|
==Getting Started with macOS==
Welcome to using Phidgets with macOS!

If you are ready to go, the first step in creating macOS applications with Phidgets is installing our libraries.
|{{TOC limit|3}}
|}

===Install===
To install our libraries, download the installer for your system:
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22.dmg macOS Installer Download]

Before installing our libraries, be sure to read our [[Software License]]. If you need to access older versions of the drivers, [https://www.phidgets.com/downloads/phidget22/libraries/macos/ click here].

Next, open up the installer, and double click on ''Phidgets.pkg'' to install the libraries:
[[File:OSX Install 1.png|link=|alt=macOS Install|center]]

When prompted, continue with the installation:
[[File:OSX Install 2.png|link=|alt=macOS Install|center]]

If you are using OS X 10.13 or newer you will also need to give explicit permission for the driver to function. You can read about this here[https://developer.apple.com/library/content/technotes/tn2459/_index.html].

The Phidgets libraries are now installed on your machine. Next, let's verify that the Phidget libraries are working properly.

===Verify===
The best way to verify that your libraries are working properly is to use the Phidget Control Panel. The Phidget Control Panel is a powerful tool that will help you develop your Phidgets applications. Get started by following the instructions below:

Open Finder and navigate to the Phidget Control Panel in the Applications list:
[[File:OSX Finder Apps.png|link=|900px|alt=macOS Finder Apps|center]]

Double click on the Phidgets icon to bring up the Phidget Control Panel. You can now see all the Phidgets that are plugged into your machine, as well as any Phidgets that are on the network:
[[File:OSX ControlPanel General.png|600px|link=|alt=macOS Control Panel General|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:OSX Control Panel Channel.png ‎|link=|alt=macOS Control Panel Channel|center]]

The Phidget Control Panel can be used for testing devices, updating firmware, enabling a network server, and more! Visit the [[Phidget Control Panel#macOS|Phidget Control Panel]] page if you want to delve a little deeper.

Your Phidget is now able to communicate with your development machine. The next step is selecting a programming language so you can start to write some code!

==Programming==
Ready to write some code? Select one of the programming languages below:

{{Programming_Languages_Table}}

==Advanced Information==

===Installed Files===
These files were placed onto your system as part of the installation process:
{| class="wikitable"
|-
| align="center" style="background:#f0f0f0;"|'''File'''
| align="center" style="background:#f0f0f0;"|'''Description'''
| align="center" style="background:#f0f0f0;"|'''Location'''
|-
|Phidget22.framework||contains our library, which is used at run-time.||/Library/Frameworks
|-
|Phidget.kext||kernel extension.||/Library/Extensions
|-
|phidgetnetworkserver22||Phidget Network Server||/usr/local/bin
|-
|}

===Developer Tools===
If you're a software developer and want to be able to bundle Phidgets with your application, you'll need our developer tools:

* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip Phidgets MacOS Developer Tools]

You can also use the tools in this package to do a custom minimal install.

Please see the included README file for details on how to use these tools.

===Older Versions===
If you need older versions of the macOS libraries, [{{SERVER}}/downloads/phidget22/libraries/macos/Phidget22/ click here].

===Standalone Control Panel===
If you just want to install the [[Phidget_Control_Panel#macOS|Phidget Control Panel]] without the rest of our libraries (requires macOS 10.15 and newer):

* [https://cdn.phidgets.com/downloads/phidget22/tools/macos/Phidget22ControlPanel.dmg MacOS Standalone Control Panel]

If you intend to write code that uses Phidgets, you should use the main installer mentioned at the beginning of this guide.

OS - macOS

2024-05-14T17:08:17Z

Patrick:

[[Category:OS]]

{{NoticeBox|Note to macOS 11 Users:|If you're having issues with the regular installer, try installing and running the [https://cdn.phidgets.com/downloads/phidget22/tools/macos/Phidget22ControlPanel.dmg Standalone Control Panel], which uses a driver extension instead of a kernel extension.}}

{|
|style="vertical-align:middle; width: 60%;"|
==Getting Started with macOS==
Welcome to using Phidgets with macOS!

If you are ready to go, the first step in creating macOS applications with Phidgets is installing our libraries.
|{{TOC limit|3}}
|}

===Install===
To install our libraries, download the installer for your system:
* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22.dmg macOS Installer Download]

Before installing our libraries, be sure to read our [[Software License]]. If you need to access older versions of the drivers, [https://www.phidgets.com/downloads/phidget22/libraries/macos/ click here].

Next, open up the installer, and double click on ''Phidgets.pkg'' to install the libraries:
[[File:OSX Install 1.png|link=|alt=macOS Install|center]]

When prompted, continue with the installation:
[[File:OSX Install 2.png|link=|alt=macOS Install|center]]

If you are using OS X 10.13 or newer you will also need to give explicit permission for the driver to function. You can read about this here[https://developer.apple.com/library/content/technotes/tn2459/_index.html].

The Phidgets libraries are now installed on your machine. Next, let's verify that the Phidget libraries are working properly.

===Verify===
The best way to verify that your libraries are working properly is to use the Phidget Control Panel. The Phidget Control Panel is a powerful tool that will help you develop your Phidgets applications. Get started by following the instructions below:

Open Finder and navigate to the Phidget Control Panel in the Applications list:
[[File:OSX Finder Apps.png|link=|900px|alt=macOS Finder Apps|center]]

Double click on the Phidgets icon to bring up the Phidget Control Panel. You can now see all the Phidgets that are plugged into your machine, as well as any Phidgets that are on the network:
[[File:OSX ControlPanel General.png|600px|link=|alt=macOS Control Panel General|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:OSX Control Panel Channel.png ‎|link=|alt=macOS Control Panel Channel|center]]

The Phidget Control Panel can be used for testing devices, updating firmware, enabling a network server, and more! Visit the [[Phidget Control Panel#macOS|Phidget Control Panel]] page if you want to delve a little deeper.

Your Phidget is now able to communicate with your development machine. The next step is selecting a programming language so you can start to write some code!

==Programming==
Ready to write some code? Select one of the programming languages below:

{{Programming_Languages_Table}}

==Advanced Information==

===Installed Files===
These files were placed onto your system as part of the installation process:
{| class="wikitable"
|-
| align="center" style="background:#f0f0f0;"|'''File'''
| align="center" style="background:#f0f0f0;"|'''Description'''
| align="center" style="background:#f0f0f0;"|'''Location'''
|-
|Phidget22.framework||contains our library, which is used at run-time.||/Library/Frameworks
|-
|Phidget.kext||kernel extension.||/Library/Extensions
|-
|phidgetnetworkserver22||Phidget Network Server||/usr/local/bin
|-
|}

===Developer Tools===
If you're a software developer and want to be able to bundle Phidgets with your application, you'll need our developer tools:

* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip Phidgets MacOS Developer Tools]

You can also use the tools in this package to do a custom minimal install.

Please see the included README file for details on how to use these tools.

===Older Versions===
If you need older versions of the macOS libraries, [{{SERVER}}/downloads/phidget22/libraries/macos/Phidget22/ click here].

===Standalone Control Panel===
If you just want to install the [[Phidget_Control_Panel#macOS|Phidget Control Panel]] without the rest of our libraries, you can get this driver extension (requires macOS 10.15 and newer):

* [https://cdn.phidgets.com/downloads/phidget22/tools/macos/Phidget22ControlPanel.dmg MacOS Standalone Control Panel]

If you intend to write code that uses Phidgets, you should use the main installer mentioned at the beginning of this guide.

Operating System Support

2024-05-14T17:06:57Z

Patrick:

[[Category:Overview]]
We provide support for all major operating systems. Select your operating system from the table below and follow the ''Getting Started'' guide in order to set up your machine. If you need to access non-current versions of our drivers you can find them [{{SERVER}}/downloads/phidget22/libraries/ here]. You can find the driver changelog [{{SERVER}}/?view=changelog here].

<div class="OSTableFull">
== Desktop OS ==
{|class="table-no-border"
|style="text-align:center;"|[[Image:Logo-Windows.png|alt=OS - Windows|link=OS - Windows|150px]]
|style="text-align:center;"|[[Image:Logo-Mac-OS.png|alt=OS - macOS|link=OS - macOS|150px]]
|style="text-align:center;"|[[Image:Logo-Linux.png|alt=OS - Linux|link=OS - Linux|150px]]
|-
|style="text-align:center;"| [[OS - Windows|Windows]]
|style="text-align:center;"| [[OS - macOS|macOS]]
|style="text-align:center;"| [[OS - Linux|Linux]]
|-
|style="text-align:center;"| (Windows 8 or Newer)
|style="text-align:center;"| (OS X 10.11 or Newer)
|style="text-align:center;"| (Kernel 2.6 or Newer)
|}

== Mobile/Wireless OS ==
{|class="table-no-border"
|style="text-align:center;"|[[Image:Logo-Android.png|alt=OS - Android|link=OS_-_Android|150px]]
|style="text-align:center;"|[[Image:Logo-iOS.png|alt=OS - iOS|link=OS - iOS|150px]]
|style="text-align:center;"|[[Image:Logo-Phidgets.png|alt=OS - Phidget SBC|link=OS - Phidget SBC|150px]]
|-
|style="text-align:center;"| [[OS - Android|Android]]
|style="text-align:center;"| [[OS - iOS|iOS]]
|style="text-align:center;"| [[OS - Phidget SBC|Phidget SBC]]
|-
|style="text-align:center;"| (4.1 Jellybean or Newer)
|style="text-align:center;"| (8.0 or Newer)
|style="text-align:center;"| (All versions supported)
|}
</div>
<div class="OSTableSmall">
'''Desktop OSes'''
{|class="table-no-border"
|style="text-align:center;"|[[Image:Logo-Windows.png|alt=OS - Windows|link=OS - Windows|30px]]||[[OS - Windows|Windows]]||(Windows 8 or Newer)
|-
|style="text-align:center;"|[[Image:Logo-Mac-OS.png|alt=OS - macOS|link=OS - macOS|30px]]||[[OS - macOS|MacOS]]||(OS X 10.5 or Newer)
|-
|style="text-align:center;"|[[Image:Logo-Linux.png|alt=OS - Linux|link=OS - Linux|30px]]||[[OS - Linux|Linux]]||(Kernel 2.6 or Newer)
|}
'''Mobile/Wireless OSes'''
{|class="table-no-border"
|style="text-align:center;"|[[Image:Logo-Android.png|alt=OS - Android|link=OS_-_Android|30px]]||[[OS - Android|Android]]||(4.1 Jellybean or Newer)
|-
|style="text-align:center;"|[[Image:Logo-iOS.png|alt=OS - iOS|link=OS - iOS|30px]]||[[OS - iOS|iOS]]||(8.0 or Newer)
|-
|style="text-align:center;"|[[Image:Logo-Phidgets.png|alt=OS - Phidget SBC|link=OS - Phidget SBC|30px]]||[[OS - Phidget SBC|Phidget SBC]]||(All versions supported)
|}
</div>

OS - macOS

2024-05-14T17:05:50Z

Patrick:

[[Category:OS]]

{{NoticeBox|Note to macOS 11 Users:|If you're having issues with the regular installer, try installing and running the [https://cdn.phidgets.com/downloads/phidget22/tools/macos/Phidget22ControlPanel.dmg Standalone Control Panel], which uses a driver extension instead of a kernel extension.}}

{|
|style="vertical-align:middle; width: 60%;"|
==Getting Started with macOS==
Welcome to using Phidgets with macOS!

If you are ready to go, the first step in creating macOS applications with Phidgets is installing our libraries.
|{{TOC limit|3}}
|}

===Install===
To install our libraries, download the installer for your system:
*OS X 10.11+: [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22.dmg Installer Download]

Before installing our libraries, be sure to read our [[Software License]]. If you need to access older versions of the drivers, [https://www.phidgets.com/downloads/phidget22/libraries/macos/ click here].

Next, open up the installer, and double click on ''Phidgets.pkg'' to install the libraries:
[[File:OSX Install 1.png|link=|alt=macOS Install|center]]

When prompted, continue with the installation:
[[File:OSX Install 2.png|link=|alt=macOS Install|center]]

If you are using OS X 10.13 or newer you will also need to give explicit permission for the driver to function. You can read about this here[https://developer.apple.com/library/content/technotes/tn2459/_index.html].

The Phidgets libraries are now installed on your machine. Next, let's verify that the Phidget libraries are working properly.

===Verify===
The best way to verify that your libraries are working properly is to use the Phidget Control Panel. The Phidget Control Panel is a powerful tool that will help you develop your Phidgets applications. Get started by following the instructions below:

Open Finder and navigate to the Phidget Control Panel in the Applications list:
[[File:OSX Finder Apps.png|link=|900px|alt=macOS Finder Apps|center]]

Double click on the Phidgets icon to bring up the Phidget Control Panel. You can now see all the Phidgets that are plugged into your machine, as well as any Phidgets that are on the network:
[[File:OSX ControlPanel General.png|600px|link=|alt=macOS Control Panel General|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:OSX Control Panel Channel.png ‎|link=|alt=macOS Control Panel Channel|center]]

The Phidget Control Panel can be used for testing devices, updating firmware, enabling a network server, and more! Visit the [[Phidget Control Panel#macOS|Phidget Control Panel]] page if you want to delve a little deeper.

Your Phidget is now able to communicate with your development machine. The next step is selecting a programming language so you can start to write some code!

==Programming==
Ready to write some code? Select one of the programming languages below:

{{Programming_Languages_Table}}

==Advanced Information==

===Installed Files===
These files were placed onto your system as part of the installation process:
{| class="wikitable"
|-
| align="center" style="background:#f0f0f0;"|'''File'''
| align="center" style="background:#f0f0f0;"|'''Description'''
| align="center" style="background:#f0f0f0;"|'''Location'''
|-
|Phidget22.framework||contains our library, which is used at run-time.||/Library/Frameworks
|-
|Phidget.kext||kernel extension.||/Library/Extensions
|-
|phidgetnetworkserver22||Phidget Network Server||/usr/local/bin
|-
|}

===Developer Tools===
If you're a software developer and want to be able to bundle Phidgets with your application, you'll need our developer tools:

* [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip Phidgets MacOS Developer Tools]

You can also use the tools in this package to do a custom minimal install.

Please see the included README file for details on how to use these tools.

===Older Versions===
If you need older versions of the macOS libraries, [{{SERVER}}/downloads/phidget22/libraries/macos/Phidget22/ click here].

===Standalone Control Panel===
If you just want to install the [[Phidget_Control_Panel#macOS|Phidget Control Panel]] without the rest of our libraries, you can get this driver extension (requires macOS 10.15 and newer):

* [https://cdn.phidgets.com/downloads/phidget22/tools/macos/Phidget22ControlPanel.dmg MacOS Standalone Control Panel]

If you intend to write code that uses Phidgets, you should use the main installer mentioned at the beginning of this guide.

Template:LinuxSupport

2024-04-23T20:05:58Z

Patrick:

<div class="ugcHeader"><span class="ugcHeaderIcon"></span><span class="ugcHeaderName">Supported Distros / Archs</span></div>
<div class="ugcContent">
{| style="border:1px solid darkgray;" cellpadding="7px;"
|-
|Debian 6 (Squeeze)
|style="background: #ade6ab" align="center" rowspan="7"|'''i386'''
|style="border-top: none;" rowspan="4"|
|style="background: #adabe6" align="center" rowspan="4"|'''armel'''
|-
|Debian 7 (Wheezy)
|-
|Debian 8 (Jessie)
|style="background: #e6abab" align="center" rowspan="5"|'''armhf'''
|-
|Debian 9 (Stretch)
|-
|Debian 10 (Buster)
|style="background: #ade6e6" align="center" rowspan="3"|'''amd64'''
|style="border-top: none;" rowspan="3"|
|style="background: #e6e6ab" align="center" rowspan="3"|'''arm64'''
|-
|Debian 11 (Bullseye)
|-
|Debian 12 (Bookworm)
|-
|style="background: #e6e6e6" align="center" colspan="6"|
|-
|Ubuntu Xenial 16.04 LTS
|style="background: #ade6ab" align="center"|'''i386'''
|style="border-top: none;"|
|style="border-top: none;" rowspan="4"|
|style="background: #e6abab" align="center" rowspan="5"|'''armhf'''
|-
|Ubuntu Bionic 18.04 LTS
|style="border-top: none;" rowspan="3"|
|style="background: #ade6e6" align="center" rowspan="4"|'''amd64'''
|style="background: #e6e6ab" align="center" rowspan="4"|'''arm64'''
|-
|Ubuntu Focal 20.04 LTS
|-
|Ubuntu Jammy 22.04 LTS
|-
|Ubuntu Noble 24.04 LTS
|-
|}
<div style="clear: both;"></div>
</div>

Template:LinuxInstallScript

2024-03-21T17:37:09Z

Patrick:

<tabber>
Root=
<syntaxhighlight lang=bash>
curl -fsSL https://www.phidgets.com/downloads/setup_linux | bash -
apt-get install -y libphidget22
</syntaxhighlight>
|-|
Non-Root=
<syntaxhighlight lang=bash>
curl -fsSL https://www.phidgets.com/downloads/setup_linux | sudo -E bash -
sudo apt-get install -y libphidget22
</syntaxhighlight>
</tabber>

Template:LinuxGetKey

2024-03-21T16:41:36Z

Patrick:

<tabber>
Root=
<syntaxhighlight lang=bash>
wget -qO /usr/share/keyrings/phidgets.gpg \
https://www.phidgets.com/gpgkey/pubring.gpg
echo deb [signed-by=/usr/share/keyrings/phidgets.gpg] \
http://www.phidgets.com/debian distro main \
> /etc/apt/sources.list.d/phidgets.list
</syntaxhighlight>
|-|
Non-Root=
<syntaxhighlight lang=bash>
sudo wget -qO /usr/share/keyrings/phidgets.gpg \
https://www.phidgets.com/gpgkey/pubring.gpg
echo deb [signed-by=/usr/share/keyrings/phidgets.gpg] \
http://www.phidgets.com/debian distro main | sudo tee \
/etc/apt/sources.list.d/phidgets.list > /dev/null
</syntaxhighlight>
</tabber>

OS - Linux

2024-03-21T16:40:39Z

Patrick:

<metadesc>Communicate over USB with sensors, controllers and relays with Phidgets! Program in Linux using a wide variety of programming languages.</metadesc>
[[Category:OS]]
{|
|style="vertical-align:middle; width: 60%;"|
==Getting Started with Linux==
Welcome to using Phidgets with Linux!

If you are ready to go, the first step in creating Linux applications with Phidgets is installing our libraries.
|{{TOC limit|3}}
|}
===Install===
The first step to using Phidgets with Linux is installing the Phidget22 libraries.
{{LinuxSupport}}
If you're running one of the supported distros, we recommend using the '''Package Install'''. For other systems, you can use the '''Source Install'''.

<div class="bigTabs">
<tabber>
Package Install=
====Install Script====
To run the install script and install phidget22, enter the following command in the terminal:

{{LinuxInstallScript}}

====Manual Install====
To install our package repository manually, enter the following command in the terminal, replacing ''distro'' with your distro codename:

{{LinuxGetKey}}

We support Debian releases from 6 to current, and Ubuntu LTS releases from 14.04 to current. If you are using another flavour of Linux (such as Mint), which is based on Ubuntu or Debian, use the corresponding Ubuntu or Debian codename.

Update your package lists:
{{LinuxAptUpdate}}

Finally, install the Phidget package by entering the command below:
{{LinuxAptInstall}}

====Additional Packages====
You may also want to apt-get install the following optional packages:
* '''libphidget22-dev''': The C development libraries for Phidget22
* '''libphidget22extra''': Extra runtime library required for the Network Server and Admin tools
* '''phidget22networkserver''': The [[Phidget Network Server]], which enables use of Phidgets over your network
* '''libphidget22java''': The Java libraries for Phidget22
* '''phidget22admin''': An administrator utility for listing Phidgets and upgrading firmware
* '''phidget22wwwjs''': The JavaScript libraries for Phidget22. This package also installs the HTML examples which can be accessed through the web interface

The libraries are now installed on your machine. Next, set up the UDev rules below.

|-|
Source Install=
====Source Install====
To install our libraries, first install libusb-1.0 development libraries. The exact command and package name will vary depending on distribution. For Debian based distributions, including Ubuntu and Mint, the command would be:
<syntaxhighlight lang=bash>
apt-get install libusb-1.0-0-dev
</syntaxhighlight>

Next, download and unpack the following files:
*[https://cdn.phidgets.com/downloads/phidget22/libraries/linux/libphidget22.tar.gz libphidget22] (Mandatory)
*[https://cdn.phidgets.com/downloads/phidget22/libraries/linux/libphidget22extra.tar.gz libphidget22extra] (Optional - needed by NetworkServer and Admin)
*[https://cdn.phidgets.com/downloads/phidget22/libraries/linux/libphidget22java.tar.gz libphidget22java] (Optional - Java Libraries)
*[https://cdn.phidgets.com/downloads/phidget22/servers/linux/phidget22networkserver.tar.gz phidget22networkserver] (Optional - [[Phidget Network Server]])
*[https://cdn.phidgets.com/downloads/phidget22/tools/linux/phidget22admin.tar.gz phidget22admin] (Optional - Phidget Admin Tool)
Open the README file that is included at the top of each directory. This file will give you important information about how to properly install the files.

Libraries are installed in /usr/local/lib by default. If you run into trouble finding the libraries during linking or at runtime, this probably means that /usr/local/lib is not on the library path for your distribution.

You can handle this in a number of ways:

Specify a different install folder during compile
<syntaxhighlight lang=bash>./configure --prefix=/usr && make && sudo make install</syntaxhighlight>
OR Add /usr/local/lib to the system-wide library path
<syntaxhighlight lang=bash>echo /usr/local/lib >> /etc/ld.so.conf && sudo ldconfig</syntaxhighlight>
OR Add /usr/local/lib in your local shell every time
<syntaxhighlight lang=bash>export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib</syntaxhighlight>

The libraries are now installed on your machine. Next, you should set the UDev Rules.
</tabber>
</div>

=== Setting UDev Rules ===
By default, Linux will not grant permission to regular users to access physical hardware as a security feature. This means that in order to run Phidgets code from user space you must grant yourself root privileges via sudo. For example:

sudo ./HelloWorld

You can grant access manually or, more commonly, set up a rules file to do it automatically keying off of the vendor code for Phidget USB devices. To do this, create a text file called "99-libphidget22.rules" with the following contents:

# All current and future Phidgets - Vendor = 0x06c2, Product = 0x0030 - 0x00af
SUBSYSTEMS=="usb", ACTION=="add", ATTRS{idVendor}=="06c2", ATTRS{idProduct}=="00[3-a][0-f]", MODE="666"

Where mode 666 means every user has permission to read and write to the specified file/device. You need to then move this file to "/etc/udev/rules.d". Now you can run Phidget related code as a regular user without the OS denying permission.

===Verify===
The best way to verify that your libraries are working properly is to compile and run an example program.

First, download and unpack this C example:
*[https://cdn.phidgets.com/downloads/phidget22/examples/c/Manager/Phidget22_HelloWorld_C_Ex.zip HelloWorld C example]

'''Note:''' If using the Debian intallation methods, you will need to install the '''libphidget22-dev''' package to use the C libraries for Phidget22

Next, open the terminal at the example location. Compile the example by entering the following command:
<syntaxhighlight lang=bash>
gcc HelloWorld.c -o HelloWorld -lphidget22
</syntaxhighlight>

Run the HelloWorld example:
<syntaxhighlight lang=bash>
./HelloWorld
</syntaxhighlight>

Your terminal should look something like this:
[[File:linux_helloworld.PNG|link=|center]]

The HelloWorld program will simply communicate when a Phidget has been attached or detached, as can be seen in the image above.

Your Phidget is now able to communicate with your development machine. The next step is selecting a programming language so you can start to write some code!

==Programming==
Ready to write some code? Select one of the programming languages below:

{{Programming_Languages_Table}}

==Older Versions==
If you need older versions of the Phidget22 Linux libraries, [{{SERVER}}/downloads/phidget22/libraries/linux/libphidget22/ click here].

If you need Phidget21 Linux Libraries, [{{SERVER}}/downloads/phidget21/libraries/linux/libphidget/ click here].

Template:LinuxGetKey

2024-02-15T22:16:41Z

Patrick:

<tabber>
Root=
<syntaxhighlight lang=bash>
wget -qO /usr/share/keyrings/phidgets.gpg \
https://www.phidgets.com/gpgkey/pubring.gpg
echo deb [signed-by=/usr/share/keyrings/phidgets.gpg] \
http://www.phidgets.com/debian bullseye main \
> /etc/apt/sources.list.d/phidgets.list
</syntaxhighlight>
|-|
Non-Root=
<syntaxhighlight lang=bash>
sudo wget -qO /usr/share/keyrings/phidgets.gpg \
https://www.phidgets.com/gpgkey/pubring.gpg
echo deb [signed-by=/usr/share/keyrings/phidgets.gpg] \
http://www.phidgets.com/debian bullseye main | sudo tee \
/etc/apt/sources.list.d/phidgets.list > /dev/null
</syntaxhighlight>
</tabber>