View source for Phidget Control Panel

[[Category:Overview]]
==Getting Started==
The Phidget Control Panel is a powerful tool that will help you develop your Phidget applications. With the control panel, you can view all Phidgets attached to your machine/network, graph data from your devices, upgrade your firmware, and more! 


We recommend using the '''Windows''' version of the Phidget Control Panel. There are macOS and browser-based options available, however, their functionality is limited.

==Windows==
===Install===
If you haven't already, follow the [[OS_-_Windows#Getting started with Windows|getting started with Windows]] guide. There, you will install the Phidget libraries, including the Phidget Control Panel.

===Phidgets Tab===
After opening the Phidget Control Panel, you will see something similar to this:
[[File:Windows ControlPanel General.PNG|link=|alt=Windows Control Panel General|center]]


By default, the Phidgets tab will list any Phidget that is connected to your machine, as well as the following information:
*'''Serial number:''' allows you to differentiate between similar Phidgets.
*'''Channel:''' allows you to differentiate between similar objects on a Phidget.
*'''Version number:''' corresponds to the firmware version your Phidget is running.


To add/remove information from the Phidget Control Panel, right-click on one of the column headers:
[[File:Controlpanel_windows_showmore.png|link=|center]]


If an entry has a '''+''' symbol next to it, it can be expanding by clicking on the symbol, or double-clicking the entry:
[[File:Controlpanel_expand.png|link=|center]]

====Running Applications====
Every Phidget has an example application, double-click on a Phidget channel to run the program. You can also right-click on a Phidget channel and click ''Open Selected Channel''.
[[File:Controlpanel_openapplication.png|500px|link=https://www.phidgets.com/docs/images/b/bd/Controlpanel_openapplication.png|center]]


These examples are intended for demonstration and debugging purposes; you'll eventually want to write your own program using our code samples for your preferred programming language.

====Upgrading Firmware====
If a Phidget has a blue arrow icon ([[File:Win_update_firm.jpg]]) next to it, it means the firmware is out of date. Right-click on the row and select ''Upgrade Firmware''.
[[Image:ControlpanelFWup.jpg|link=|center]]


The latest version will be auto-selected and you can simply click '''Upgrade''' to complete.
[[Image:Controlpanel_firmwareupgradescreen.png|link=|center]]

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


You can downgrade by right-clicking on the device's row and selecting ''Downgrade Firmware''.

[[Image:ControlpanelFWdown.jpg|link=]]


You can then select a specific firmware version.

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

==== Graphing and Data Logging ====
To plot data, open the channel for your device and click on the [[Image:plot.jpg|link=]] icon next to the data type that you want to plot. This will open up a new window:

[[Image:plot2.jpg|link=|850px]]

===== Filtering =====
You can perform filtering on the raw data in order to reduce noise in your graph. For more information, see the [[Control Panel Graphing]] page. 

===== Graph Type =====
You can perform a transform on the incoming data to get different graph types that may provide insights into your sensor data. For more information on how to use these graph types, see the [[Control Panel Graphing]] page.

====Error Logging====
The Phidget Control Panel keeps a log file of all errors, warnings, and other information related to its operation. This information can provide useful insight when your device/system is not behaving as expected. To enable logging, first navigate to ''File'' > ''Options...''
[[File:Controlpanel_windows_fileoptions.png|link=|center]]


Next, check the box beside ''Enable Logging''. For more information about log levels, view our [https://www.phidgets.com/docs/Logging_Details logging details] page.
[[File:Windows_ControlPanel_NetworkService_LogLevel.PNG|link=|alt=Windows Control Panel Network Server Setup|center]]


To view the log files, click on ''Help > Open Logs Folder'' in the menu at the top. You can also find it by navigating to the following location:
*C:/ProgramData/Phidgets/logs


[[File:Controlpanel_windows_loglocation.png|link=|alt=Windows Control Panel General|center]]


There are separate log files with different purposes: 
* '''Phidget22Manager.log''' - This is the main log file for all Phidgets you access through the Phidget Control Panel. 
* '''Phidget22NetworkServer_networkserver.log''' - If you have a Network Server running, this is the main log file for all activity on the server.
* '''Phidget22NetworkServer_access.log''' - This file logs requests made on the webpage hosted by your Network Server. 

====Setting VINT Speed====
Right-click on a Phidget to set the VINT Speed.

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


You can see the current VINT Speed in the [[#View Device/Channel Properties|properties menu]].
[[File:Deviceproperties_example.png|link=|center]]

====Setting a Label====
Right-click on a Phidget to set a label. See [[Addressing_Phidgets#Label|using a label]] for more information about how to use labels with Phidgets.
[[File:Controlpanel_windows_setlabel.png|link=|center]]

====Set Hub Port Power====
Power to VINT Hub ports can be controlled programmatically. Right-click on a hub port to turn the power on/off. For more information, visit the [https://www.phidgets.com/?view=api Phidget API], select your VINT Hub, and select '''USB''' as the interface type.
[[File:Controlpanel_hubportpower.png|link=|center]]

====View Device/Channel Properties====
Right-click on a device/channel to view its properties.
[[File:Controlpanel_deviceproperties.png|link=|center]]

====Access Device-Specific Options====
Some devices have other options that can be accessed through the Phidget Control Panel. For example, the [https://www.phidgets.com/?&prodid=1205 PhidgetSpatial Precision 3/3/3] shown in the example below has a Magnetometer Calibration program that can be accessed through the control panel.

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

===Network Server Tab===
The last tab is the Network Phidgets tab, which displays a complete list of any Phidget SBCs or Wireless VINT Hubs connected to your network.
[[File:Phidgetsbc_windowscontrolpanel.PNG|link=|center]]


Just like the Phidgets tab, you can right-click on any of the column headers for view options:
[[File:Phidgetsbc_windowscontrolpanel_showmore.PNG|link=|center]]


You can also double-click on a device to bring up its web interface.

====Wireless VINT Hub Firmware Upgrade====
If your Wireless VINT Hub has out-of-date firmware, a blue arrow icon ([[File:Win_update_firm.jpg]]) will appear in its row. 
[[File:Controlpanel_networktab_upgrade.png|link=|center]]


You can double-click on the entry for information about how to upgrade your device.
[[File:Controlpanel_networktab_upgradescreen.png|link=|center]]

====Phidget Network Server Guide====
For more information, view our [[Network Server Guide | Phidget Network Server Guide]].

==macOS==
===Install===
If you haven't already, follow the [[OS_-_macOS#Getting started with macOS|getting started with macOS]] guide. There, you will install the Phidget libraries, including the Phidget Control Panel.

===Phidgets Tab===
After opening the Phidget Control Panel, you will see something similar to this:
[[File:OSX ControlPanel General.png|600px|link=https://www.phidgets.com/docs/images/7/7f/OSX_ControlPanel_General.png|alt=macOS Control Panel General|center]]


The Phidgets tab will list all Phidgets (and associated objects) that are connected to your machine, as well as the following information:
*'''Serial number:''' allows you to differentiate between similar Phidgets.
*'''Channel:''' allows you to differentiate between similar objects on a Phidget.
*'''Version number:''' corresponds to the firmware version your Phidget is running.

====Running Applications====
Every Phidget has an example program, double-click on a Phidget to run the program:
[[File:Controlpanel_mac_openapplication2.png|link=https://www.phidgets.com/docs/images/1/11/Controlpanel_mac_openapplication2.png|center|600px]]


'''Note:''' important features for your device may be missing on the macOS version of the Phidget Control Panel. We recommend using the Windows version of the Phidget Control Panel when possible.

====Upgrading Firmware====
If a Phidget shows up in red on the list in the Phidgets tab, it means the firmware is out of date. Double-click on the Phidget to be given the option to apply the update. 

[[File:Controlpanel_mac_firmwareupgrade.png|link=https://www.phidgets.com/docs/images/9/93/Controlpanel_mac_firmwareupgrade.png|center|600px]]

Simply click '''Upgrade''' to complete.
[[File:Controlpanel_mac_upgradescreen.png|link=https://www.phidgets.com/docs/images/9/9d/Controlpanel_mac_upgradescreen.png|center|500px]]

====Downgrading Firmware====
This functionality is not supported in the macOS version of the Phidget Control Panel.

==== Graphing and Data Logging ====
This functionality is not supported in the macOS version of the Phidget Control Panel.

====Error Logging====
The Phidget Control Panel keeps a log file of all errors, warnings, and other information related to its operation. This information can be useful if you're having problems with your Phidgets, but you're not sure what's going wrong. To view the log file, open the ''Console'' application under ''Applications'' > ''Utilities''
[[File:Controlpanel_mac_console.png|600px|link=|center]]


After opening the ''Console'' application, navigate to user logs (''~/Library/Logs'') on the left menu. You will likely have a list of logs from various applications. After finding the Phidget logs, you will see something like this:
[[File:Controlpanel_mac_log.png|link=https://www.phidgets.com/docs/images/2/24/Controlpanel_mac_log.png|center|600px]]

====Setting VINT Speed====
This functionality is not supported in the macOS version of the Phidget Control Panel.

====Setting a Label====
This functionality is not supported in the macOS version of the Phidget Control Panel.

====Set Hub Port Power====
This functionality is not supported in the macOS version of the Phidget Control Panel.

====View Device/Channel Properties====
This functionality is not supported in the macOS version of the Phidget Control Panel.

====Access Device-Specific Options====
This functionality is not supported in the macOS version of the Phidget Control Panel.

===Network Phidgets Tab===
The last tab is the Network Phidgets tab, which displays a complete list of any Phidget SBC or Wireless VINT Hub connected to your network.

[[File:Phidgetsbc_maccontrolpanel.png|link=https://www.phidgets.com/docs/images/8/8f/Phidgetsbc_maccontrolpanel.png|center|600px]]


You can also double-click on a device to bring up its web interface.

====Phidget Network Server Guide====
For more information, view our [[Network Server Guide | Phidget Network Server Guide]].