Phidget Control Panel: Difference between revisions

From Phidgets Support
No edit summary
(20 intermediate revisions by 3 users not shown)
Line 1: Line 1:
The '''Phidget Control Panel''' is a tool that can be used to quickly determine whether your system is able to communicate with Phidgets, and also acts as a testing and debugging tool. You can also update the firmware of attached devices, manage [[Phidget Dictionary]] entries, and remotely open and test Phidgets over the Phidget Network Service.
[[Category:Overview]]
==Getting Started with the Phidget Control Panel==
The Phidget Control Panel is a powerful tool that will help you develop your Phidgets applications. With the Phidget Control Panel, you can see any/all Phidgets that are attached to your machine (or a remote machine), update your Phidget's firmware, manage a Phidget Network Server, and more!


==Windows==
The Phidget Control Panel is only available for Windows and macOS operating systems.


Once the [[OS_-_Windows#Quick_Downloads|Phidget libraries]] are installed using the installer, you should see the [[File:Ph.jpg]] icon in the taskbar. Double click on it to bring up the Phidget Control Panel. If the icon does not appear, just find and open the Phidget Control Panel from the start menu.
<tabber>
Windows=
{|
|style="vertical-align:top; width: 60%;"|
<font size=6>'''Windows'''</font>
<br/>


===Phidgets Tab===
If you haven't already, follow the [[OS_-_Windows#Getting started with Windows|getting started with Windows]] section on the Windows OS page. There you will install the Phidget libraries and learn how to open the Phidget Control Panel.
|{{TOC limit|5}}
|}
===Phidgets tab===
After opening the Phidget Control Panel, you should see something like this:
[[File:Windows ControlPanel General.PNG|link=|alt=Windows 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.
 
 
To add/remove information from the Phidget Control Panel, right-click on one of the column headers:
[[File:Controlpanel_windows_showmore.png|link=|center]]
 
 
Every Phidget has an example program, double-click on a Phidget to run the program:
[[File:RFIDReadWrite_Example.jpg|link=|alt=Windows Control Panel Example|center]]


[[File:Windows ControlPanel General.PNG|link=|alt=Windows Control Panel General]]


The Phidgets tab shows the list of Phidgets currently physically attached to the computer and their firmware version. It also lists the serial number that can be used in software to open a specific Phidget when more than one of the same type are connected at once. You can double click on a Phidget device in the Phidget Control Panel to open up an example program for the device.
The screenshot above shows the example application for the 1024 - PhidgetRFID Read-Write. These examples are intended for demonstration and debugging purposes.


[[File:RFIDReadWrite_Example.jpg|link=|alt=Windows Control Panel Example]]
====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]]


In the above screenshot, the RFID example was opened. These examples are intended for demonstration and debugging purposes. If you have not yet already, please see the '''Getting Started''' guide for your device, which is found in its [[:Category:UserGuide|user guide]]. It is important to keep in mind that when an example Phidget application is opened from the Phidget Control Panel or opened from any of your Phidget applications that you develop, it holds a lock on the Phidget. This prevents any other program from accessing the Phidget. Please ensure that this example application is closed (the Phidget Control Panel itself can still be running) before running your own applications. 


====Updating Firmware====
====Updating Firmware====
If a Phidget shows up in red on the list in the Phidgets tab, it means the firmware is out of date:
[[File:Controlpanel_windows_firmwareupgrade.png|link=|center]]


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 an option to apply the update. If you choose not to update, you can still use the control panel example afterwards.
 
Double click on the Phidget to be given an option to apply the update:
[[File:Controlpanel_windows_firmwareupgrade_click.png|link=|center]]


====Logging====
====Logging====
The Phidget Control Panel keeps a log file of all errors, warnings, and other various 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. You can enable logging by going to {{Code|File -> Options}} and checking the box beside {{Code|Enable Logging}}. From the {{Code|Level}} drop-down, you can select how detailed you want the output to be. {{Code|Critical}} is the most basic setting, which will only log messages that are deemed to be very important. {{Code|Verbose}}, on the other hand, will log ''everything'', although it may be harder to find the messages that are important to you among all of the rest of the messages.  
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 enable logging, first navigate to ''File'' -> ''Options...''
[[File:Controlpanel_windows_fileoptions.png|link=|center]]
 
 
Next, check the box beside ''Enable Logging''. From the ''Level'' drop-down menu, you can select how detailed you want the output to be:
[[File:Windows_ControlPanel_NetworkService_LogLevel.PNG|link=|alt=Windows Control Panel Network Server Setup|center]]
 
 
*'''Info:''' default/recommended setting. Will log general information such as errors, attach/detach events, etc.
*'''Error/Warning:''' will only log error messages/warning messages. Useful for keeping log files small in size.
*'''Debug:''' for use with Debug version of library.
*'''Critical:''' will only log critical messages (e.g. if program crashes)
*'''Verbose:''' will log everything. Not recommended for normal use.
 
 
 
To view the log files, click on ''Logs'' in the bottom right corner of the Phidget Control Panel. 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 is a separate log file for each example, as well as the Network Server, to make it easier to find messages that are relevant to the part you're debugging.


[[File:Windows_ControlPanel_NetworkService_LogLevel.PNG|link=|alt=Windows Control Panel WebService Setup]]
===Network Server Tab===
To get started, click on the Network Server tab:
[[File:Windows_ControlPanel_NetworkService_Setup_Stopped.jpg|link=|center|alt=Windows Control Panel Network Server Setup]]


You can find the log files at {{Code|C:\ProgramData\Phidgets\Logs}}, or you can click on {{Code|Logs}} in the bottom right corner of the Control Panel window:


[[File:Windows_ControlPanel_General.PNG|link=|alt=Windows Control Panel General]]
''Settings''
*'''Startup Type:''' determines when the Phidget Network Server will start.  
**'''Automatic:''' the Phidget Network Server will start automatically when Windows boots.
**'''Manual:''' the Phidget Network Server will start only when you click the ''Start'' button at the bottom of the Window, or, if another service starts it.
**'''Disabled:''' mode means the Phidget Network Server will stay off, regardless of what tries to start it.


There is a separate log file for the examples and the Network Service, to make it easier to find messages that are relevant to the part you're debugging. Each message in the log file will list the type of the message, the time and date, the place in the libraries the message came from, and a description. This can be very useful for figuring out why certain parts of one of the examples or the Network Service are not working properly.


===Network Service Tab===
''Phidget Server Settings''
*'''Enabled:''' enable the Phidget server. When you enable the Phidget Server, other computers on the network will be able to access the Phidgets that are connected to your computer.
*'''Publish:''' enable/disable mDNS. See the [[Phidget Network Server#Connecting to a Network Server|connecting to a Phidget Network Server]] for more information.
*'''Server Name:''' your server name will allow you to identify your Phidget Server from others on the network.
*'''Password (optional):''' prevent unauthorized computers on the network from accessing the Phidgets connected to your computer by setting a password.
*'''Log Level:''' defaults to ''Info''. See [[#Logging|logging]] section above for more information.
*'''Port:''' The port used by the Phidget Network Server (defaults to 5661).


The next tab is the {{Code|Network Service}} tab, which allows you to control Phidgets over a network.


[[File:Windows_ControlPanel_NetworkService_Setup_Stopped.jpg|link=|right|alt=Windows Control Panel Network Service Setup]]
''Webserver Settings''
*'''Enabled:''' enable the Webserver. The Webserver allows you to host a webpage that will have access to Phidgets through languages like [[Language_-_JavaScript|JavaScript]].
*'''Docroot:''' specifies the docroot path. This is where your webpage files will live and any/all additional libraries.
*'''Port:''' The port used by the Webserver (defaults to 8989).


The settings are as follows:


'''Startup Type''': Determines when the Network Service will start up. {{Code|Automatic}} mode will cause it to start up automatically when Windows boots. {{Code|Manual}} mode will cause it to start only when you click the {{Code|Start}} button at the bottom of this tab. The {{Code|Disabled}} mode means the Network Service has been disabled (normally this is set by other processes, not the Phidget Control Panel).
''Dictionaries Settings''
*'''Enable User Dictionaries:''' in order to create/use a Phidget Dictionary with the Phidget Control Panel, make sure this setting is enabled.
*'''Enable Monitoring/control Dictionary:''' by enabling this setting, you can view incoming/outgoing traffic related to your Phidget Network Server. Here is an example:
[[File:Controlpanel_windows_servermonitoring.png|link=|center]]


'''Phidget Server Enabled''': Check this box to enable the Phidget server, which is the part of the Network Service that makes the Phidgets connected to this computer accessible to other devices on your network.


'''Server Name''': When other computer's Phidget Control Panel applications see your Phidget Server, this is the name that will be displayed. When writing code, you can also locate remote Phidgets based on the name of the server hosting them.
====Adding a Phidget Dictionary====
Phidget Dictionaries are an extremely powerful tool when working with Phidgets. See the [[Phidget Dictionary]] page for more information.


'''Port''': The port used by the Phidget network server. Default is 5661.


'''Password''': Optional password that will be required to attach to the Phidgets on this server.
Creating a Phidget Dictionary is quick and easy with the Phidget Control Panel. First specify a serial number for your Dictionary, and then give it a name (if you don't specify a serial number, a default will be provided).  


'''Webserver Enabled''': Check this box to enable the Webserver. The Webserver allows you to host a webpage that will have access to the Phidgets through languages like [[Language_-_JavaScript|JavaScript]]. For more information, have a look at the [[Phidget Network Service]] page.


In order to make changes to any of these settings, you'll need administrator privileges.
Next, click on the ''Config...'' button. Here you can create a key-value pair for your Dictionary:
[[File:Controlpanel_windows_createdictionary.png|link=|center]]


===PhidgetSBC Tab===


The last tab is the {{Code|PhidgetSBC}} tab, which displays the complete list of any PhidgetSBCs connected to the network. This tab will be enabled if you have [http://www.apple.com/support/downloads/bonjourforwindows.html Bonjour] installed onto your system.
After you create your key-value pair, make sure your Dictionary is enabled and then start your Phidget Network Server (or Restart, if it is already running). Navigate to the Phidgets tab and you will see your new Dictionary:
[[File:Controlpanel_windows_dictionary.png|link=|center]]


[[File:Windows ControlPanel WebService PhidgetSBC.PNG|link=|alt=Windows Control Panel WebService PhidgetSBC]]


You can double click on the PhidgetSBC to bring up the PhidgetSBC Administration Console log-in page in your default browser.
You can now access the Phidget Dictionary from any machine on the network.


[[File:PhidgetSBCAdminConsole.PNG|link=|alt=PhidgetSBC Admin Console]]
===PhidgetSBC Tab===
The last tab is the PhidgetSBCs tab, which displays the complete list of any PhidgetSBCs connected to the network:
[[File:Phidgetsbc_windowscontrolpanel.PNG|link=|center]]


The PhidgetSBC Administration Console is where you can go to configure the PhidgetSBC. For more details, please see the [[1073 User Guide#Getting Started | PhidgetSBC]] section.


==OS X==
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]]


Once the Phidget libraries are installed using the installer, open up the {{Code|System Preferences}} window.


[[File:OSX System Preferences.png|link=|alt=OS X System Preferences]]
You can also double-click on a Phidget SBC to bring up the Phidget SBC Web Interface. The SBC Web Interface is covered in detail in the [[:Category:UserGuide | User Guide]] for your SBC.


Click on the {{Code|Phidgets}} icon in the {{Code|Other}} section to bring up the Phidgets Preference Pane.
|-|
macOS=
{|
|style="vertical-align:top; width: 60%;"|
<font size=6>'''macOS'''</font>
<br/>


===General Tab===
If you haven't already, follow the [[OS_-_macOS#Getting started with macOS|getting started with macOS]] section on the macOS page. There you will install the Phidget libraries and learn how to open the Phidget Control Panel.
|{{TOC limit|5}}
|}
===Phidgets Tab===
After opening the Phidget Control Panel, you should see something like this:
[[File:OSX ControlPanel General.png|link=|alt=macOS Control Panel General|center]]


[[File:OSX PreferencePane General.png|link=|alt=OS X PreferencePane General]]


The {{Code|general}} tab shows the list of Phidgets currently physically attached to the computer. You can also view the currently installed Phidget library version. You can double click on a Phidget device to open up an example program for the device.
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.


[[File:OSX PreferencePane Example.png|link=|alt=OS X PreferencePane Example]]


In the above screenshot, the RFID example was opened. These examples are intended for demonstration and debugging purposes. If you have not yet already, please see the '''Getting Started''' guide for your device, which may be found in its [[:Category:UserGuide|user guide]]. 
Every Phidget has an example program, double-click on a Phidget to run the program:
[[File:OSX Control Panel Channel.png ‎|link=|alt=macOS Control Panel Channel|center]]


It is important to keep in mind that when an example Phidget application is opened from the Phidget Preference Pane or opened from any of your Phidget applications that you develop, it holds a lock on the Phidget. This prevents any other program from accessing the Phidget. Please ensure that this example application is closed(the Phidget Preference Pane can still be running) when you are running your own applications. 
 
The screenshot above shows the example application for the 1024 - PhidgetRFID Read-Write. These examples are intended for demonstration and debugging purposes.


====Updating Firmware====
====Updating 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 an option to apply the update. If you choose not to update, you can still use the control panel example afterwards.
====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|900px|link=|center]]


If a Phidget shows up in red on the list in the general tab, it means the firmware is out of date. Double click on the Phidget to be given an option to apply the update. If you choose not to update, you can still use the example program afterwards.


===Web Service Tab===
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=|center]]


The next tab is the {{Code|Web Service}} tab, which allows you to control Phidgets over a network.
===Network Server Tab===
To get started, click on the Network Server tab:


[[File:OSX PreferencePane Webservice Stopped.png|link=|alt=OS X PreferencePane WebService Stopped]]
[[File:Macos_networkserver.png|link=|center]]


Here, you can start and stop the WebService. Details are provided in the [[#WebService | WebService]] section. This screen also tells you whether the Phidget WebService is currently running.


===Labels Tab===
''Settings''
*'''Start Network Server''': start or stop the Network Server. The text to the right of the button will display the current status of the Network Server.
*'''Start Automatically on Boot''': the Network Server will start automatically when the computer boots. Otherwise, you'll have to manually start the Network Server every time you want to use it.


The next tab is the {{Code|Labels}} tab. In this section, you can view the currently assigned labels of any Phidget attached to your computer. It is also possible to set the labels of Phidgets here too. You might want to set a label to a Phidget device because you can refer to it by its label as opposed to its serial number.


[[File:OSX PreferencePane Labels Local.png|link=|alt=OS X PreferencePane WebService Labels Local]]
''Phidget Server Settings''
*'''Enabled:''' enable the Phidget server. When you enable the Phidget Server, other computers on the network will be able to access the Phidgets that are connected to your computer.
*'''Publish:''' enable/disable mDNS. See the [[Phidget Network Server#Connecting to a Network Server|connecting to a Phidget Network Server]] for more information.
*'''Server Name:''' your server name will allow you to identify your Phidget Server from others on the network.
*'''Password (optional):''' prevent unauthorized computers on the network from accessing the Phidgets connected to your computer by setting a password.
*'''Port:''' The port used by the Phidget Network Server (defaults to 5661).


You can also view the labels of any Phidget connected through the WebService. You cannot change the label of a Phidget connected to a Windows computer, because of the way the Windows USB drivers are programmed.


[[File:OSX PreferencePane Labels Remote.png|link=|alt=OS X PreferencePane WebService Labels Remote]]
''Webserver Settings''
*'''Enabled:''' enable the Webserver. The Webserver allows you to host a webpage that will have access to Phidgets through languages like [[Language_-_JavaScript|JavaScript]].
*'''Docroot:''' specifies the docroot path. This is where your webpage files will live and any/all additional libraries.
*'''Port:''' The port used by the Webserver (defaults to 8989).


===Bonjour Tab===


The {{Code|Bonjour}} tab gives a list of all currently attached Phidgets that are connected to the WebService. You can also double click on the Phidget to connect to it over the network using one or more computers, but still use the Phidget on the computer it is directly connected to.
''Dictionaries Settings''
*'''Enable User Dictionaries:''' in order to create/use a Phidget Dictionary with the Phidget Control Panel, make sure this setting is enabled.
*'''Enable Monitoring/control Dictionary:''' by enabling this setting, you can view incoming/outgoing traffic related to your Phidget Network Server. Currently you can view this information on a Windows machine only.


[[File:OSX PreferencePane Bonjour.png|link=|alt=OS X PreferencePane Bonjour]]
====Adding a Phidget Dictionary====
Phidget Dictionaries are an extremely powerful tool when working with Phidgets. See the [[Phidget Dictionary]] page for more information.


===PhidgetSBC Tab===


The last tab is the {{Code|PhidgetSBC}} tab, which displays the complete list of PhidgetSBCs connected to the network.  
Creating a Phidget Dictionary is quick and easy with the Phidget Control Panel. Simply press the '''+''' button and specify a name and serial number for your Dictionary:
[[File:Controlpanel_macos_createdictionary.png|link=|center]]
 


[[File:OSX PreferencePane PhidgetSBC.png|link=|alt=OS X PreferencePane PhidgetSBC]]
Next, make sure your Dictionary is enabled and then start your Phidget Network Server (or Restart, if it is already running). Navigate to the Phidgets tab and you will see your new Dictionary:
[[File:Contorlpanel_macos_dictionary.png|link=|center]]


You can double click on the PhidgetSBC to bring up the PhidgetSBC Administration Console log-in page in your default browser.


[[File:PhidgetSBCAdminConsole.PNG|link=|alt=PhidgetSBC Admin Console]]
You can now access the Phidget Dictionary from any machine on the network.


The PhidgetSBC Administration Console is where you can go to configure the PhidgetSBC. For more details, please see the [[1073 User Guide| PhidgetSBC]] section.
===PhidgetSBC Tab===
The last tab is the PhidgetSBCs tab, which displays the complete list of PhidgetSBCs connected to the network.  


==Linux==
[[File:Phidgetsbc_maccontrolpanel.png|link=|center]]


There is no graphical interface like the control panel on Linux.


See the [[OS - Linux]] page for more information on how to get started with Phidgets on Linux.
You can double-click on a Phidget SBC to bring up the Phidget SBC Web Interface. The SBC Web Interface is covered in the [[:Category:UserGuide | User Guide]] for your SBC.
</tabber>

Revision as of 22:12, 30 October 2018

Getting Started with the Phidget Control Panel

The Phidget Control Panel is a powerful tool that will help you develop your Phidgets applications. With the Phidget Control Panel, you can see any/all Phidgets that are attached to your machine (or a remote machine), update your Phidget's firmware, manage a Phidget Network Server, and more!

The Phidget Control Panel is only available for Windows and macOS operating systems.

Windows

If you haven't already, follow the getting started with Windows section on the Windows OS page. There you will install the Phidget libraries and learn how to open the Phidget Control Panel.

Phidgets tab

After opening the Phidget Control Panel, you should see something like this:

Windows Control Panel General


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.


To add/remove information from the Phidget Control Panel, right-click on one of the column headers:

Controlpanel windows showmore.png


Every Phidget has an example program, double-click on a Phidget to run the program:

Windows Control Panel Example


The screenshot above shows the example application for the 1024 - PhidgetRFID Read-Write. These examples are intended for demonstration and debugging purposes.

Setting a label

Right-click on a Phidget to set a label. See using a label for more information about how to use labels with Phidgets.

Controlpanel windows setlabel.png


Updating Firmware

If a Phidget shows up in red on the list in the Phidgets tab, it means the firmware is out of date:

Controlpanel windows firmwareupgrade.png


Double click on the Phidget to be given an option to apply the update:

Controlpanel windows firmwareupgrade click.png

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 enable logging, first navigate to File -> Options...

Controlpanel windows fileoptions.png


Next, check the box beside Enable Logging. From the Level drop-down menu, you can select how detailed you want the output to be:

Windows Control Panel Network Server Setup


  • Info: default/recommended setting. Will log general information such as errors, attach/detach events, etc.
  • Error/Warning: will only log error messages/warning messages. Useful for keeping log files small in size.
  • Debug: for use with Debug version of library.
  • Critical: will only log critical messages (e.g. if program crashes)
  • Verbose: will log everything. Not recommended for normal use.


To view the log files, click on Logs in the bottom right corner of the Phidget Control Panel. You can also find it by navigating to the following location:

  • C:/ProgramData/Phidgets/logs


Windows Control Panel General


There is a separate log file for each example, as well as the Network Server, to make it easier to find messages that are relevant to the part you're debugging.

Network Server Tab

To get started, click on the Network Server tab:

Windows Control Panel Network Server Setup


Settings

  • Startup Type: determines when the Phidget Network Server will start.
    • Automatic: the Phidget Network Server will start automatically when Windows boots.
    • Manual: the Phidget Network Server will start only when you click the Start button at the bottom of the Window, or, if another service starts it.
    • Disabled: mode means the Phidget Network Server will stay off, regardless of what tries to start it.


Phidget Server Settings

  • Enabled: enable the Phidget server. When you enable the Phidget Server, other computers on the network will be able to access the Phidgets that are connected to your computer.
  • Publish: enable/disable mDNS. See the connecting to a Phidget Network Server for more information.
  • Server Name: your server name will allow you to identify your Phidget Server from others on the network.
  • Password (optional): prevent unauthorized computers on the network from accessing the Phidgets connected to your computer by setting a password.
  • Log Level: defaults to Info. See logging section above for more information.
  • Port: The port used by the Phidget Network Server (defaults to 5661).


Webserver Settings

  • Enabled: enable the Webserver. The Webserver allows you to host a webpage that will have access to Phidgets through languages like JavaScript.
  • Docroot: specifies the docroot path. This is where your webpage files will live and any/all additional libraries.
  • Port: The port used by the Webserver (defaults to 8989).


Dictionaries Settings

  • Enable User Dictionaries: in order to create/use a Phidget Dictionary with the Phidget Control Panel, make sure this setting is enabled.
  • Enable Monitoring/control Dictionary: by enabling this setting, you can view incoming/outgoing traffic related to your Phidget Network Server. Here is an example:
Controlpanel windows servermonitoring.png


Adding a Phidget Dictionary

Phidget Dictionaries are an extremely powerful tool when working with Phidgets. See the Phidget Dictionary page for more information.


Creating a Phidget Dictionary is quick and easy with the Phidget Control Panel. First specify a serial number for your Dictionary, and then give it a name (if you don't specify a serial number, a default will be provided).


Next, click on the Config... button. Here you can create a key-value pair for your Dictionary:

Controlpanel windows createdictionary.png


After you create your key-value pair, make sure your Dictionary is enabled and then start your Phidget Network Server (or Restart, if it is already running). Navigate to the Phidgets tab and you will see your new Dictionary:

Controlpanel windows dictionary.png


You can now access the Phidget Dictionary from any machine on the network.

PhidgetSBC Tab

The last tab is the PhidgetSBCs tab, which displays the complete list of any PhidgetSBCs connected to the network:

Phidgetsbc windowscontrolpanel.PNG


Just like the Phidgets tab, you can right-click on any of the column headers for view options:

Phidgetsbc windowscontrolpanel showmore.PNG


You can also double-click on a Phidget SBC to bring up the Phidget SBC Web Interface. The SBC Web Interface is covered in detail in the User Guide for your SBC.

macOS

If you haven't already, follow the getting started with macOS section on the macOS page. There you will install the Phidget libraries and learn how to open the Phidget Control Panel.

Phidgets Tab

After opening the Phidget Control Panel, you should see something like this:

macOS Control Panel General


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.


Every Phidget has an example program, double-click on a Phidget to run the program:

macOS Control Panel Channel


The screenshot above shows the example application for the 1024 - PhidgetRFID Read-Write. These examples are intended for demonstration and debugging purposes.

Updating 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 an option to apply the update. If you choose not to update, you can still use the control panel example afterwards.

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

Controlpanel mac console.png


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:

Controlpanel mac log.png

Network Server Tab

To get started, click on the Network Server tab:

Macos networkserver.png


Settings

  • Start Network Server: start or stop the Network Server. The text to the right of the button will display the current status of the Network Server.
  • Start Automatically on Boot: the Network Server will start automatically when the computer boots. Otherwise, you'll have to manually start the Network Server every time you want to use it.


Phidget Server Settings

  • Enabled: enable the Phidget server. When you enable the Phidget Server, other computers on the network will be able to access the Phidgets that are connected to your computer.
  • Publish: enable/disable mDNS. See the connecting to a Phidget Network Server for more information.
  • Server Name: your server name will allow you to identify your Phidget Server from others on the network.
  • Password (optional): prevent unauthorized computers on the network from accessing the Phidgets connected to your computer by setting a password.
  • Port: The port used by the Phidget Network Server (defaults to 5661).


Webserver Settings

  • Enabled: enable the Webserver. The Webserver allows you to host a webpage that will have access to Phidgets through languages like JavaScript.
  • Docroot: specifies the docroot path. This is where your webpage files will live and any/all additional libraries.
  • Port: The port used by the Webserver (defaults to 8989).


Dictionaries Settings

  • Enable User Dictionaries: in order to create/use a Phidget Dictionary with the Phidget Control Panel, make sure this setting is enabled.
  • Enable Monitoring/control Dictionary: by enabling this setting, you can view incoming/outgoing traffic related to your Phidget Network Server. Currently you can view this information on a Windows machine only.

Adding a Phidget Dictionary

Phidget Dictionaries are an extremely powerful tool when working with Phidgets. See the Phidget Dictionary page for more information.


Creating a Phidget Dictionary is quick and easy with the Phidget Control Panel. Simply press the + button and specify a name and serial number for your Dictionary:

Controlpanel macos createdictionary.png


Next, make sure your Dictionary is enabled and then start your Phidget Network Server (or Restart, if it is already running). Navigate to the Phidgets tab and you will see your new Dictionary:

Contorlpanel macos dictionary.png


You can now access the Phidget Dictionary from any machine on the network.

PhidgetSBC Tab

The last tab is the PhidgetSBCs tab, which displays the complete list of PhidgetSBCs connected to the network.

Phidgetsbc maccontrolpanel.png


You can double-click on a Phidget SBC to bring up the Phidget SBC Web Interface. The SBC Web Interface is covered in the User Guide for your SBC.

Retrieved from "http:///docs/index.php?title=Phidget_Control_Panel&oldid=30409"