|
|
| (42 intermediate revisions by 5 users not shown) |
| Line 1: |
Line 1: |
| | <metadesc>Communicate over USB with sensors, controllers, and relays with Phidgets! Program in macOS using a wide variety of programming languages.</metadesc> |
| [[Category:OS]] | | [[Category:OS]] |
| __TOC__
| |
|
| |
|
| ==Quick Downloads== | | ==Quick Downloads== |
| Already know what you're doing? Here you go:
| | Our libraries support macOS 10.11 and newer. |
| *[{{SERVER}}/downloads/phidget22/libraries/macos/Phidget22.dmg macOS Installer Download] | | * [https://cdn.phidgets.com/downloads/phidget22/tools/macos/Phidget22ControlPanel.dmg Phidget22 Control Panel (macOS 10.15 and newer)] |
| *[[Software License]] | | * [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22.dmg Phidget22 Installer (macOS 10.14 and earlier)] |
|
| |
|
| If you need older versions of the Phidget22 macOS libraries, [{{SERVER}}/downloads/phidget22/libraries/macos/Phidget22/ click here].
| | ===Other Resources=== |
| | | * [https://cdn.phidgets.com/downloads/phidget22/libraries/macos/Phidget22_macosdevel.zip macOS Development Files] |
| If you need Phidget21 macOS libraries, [{{SERVER}}/downloads/phidget21/libraries/macos/Phidget/ click here].
| | * [{{SERVER}}/downloads/phidget22/libraries/macos/Phidget22/ Previous Releases] |
| | |
| If you're using Phidgets with [[Image:artisan.jpg|link=|150px]], you should download the [{{SERVER}}/downloads/phidget21/libraries/macos/Phidget/ Phidget21 Libraries], as Phidget22 is not yet supported in Artisan.
| |
|
| |
|
| ==Getting Started with macOS== | | ==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!
| |
|
| |
| ===Install=== | | ===Install=== |
| To install our libraries, download the installer for your machine: | | To get started, download the appropriate [[#Quick Downloads|package]] for your machine from the list above. This will install the Phidget Control Panel and the Phidget Network Server. These are powerful tools that will help you develop your Phidget applications. |
| *[{{SERVER}}/downloads/phidget22/libraries/macos/Phidget22.dmg macOS installer download]
| |
| | |
| | |
| 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]]
| |
| | |
| | |
| The libraries are now installed on your machine. Next, let's verify that they are working properly.
| |
| | |
| ===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:
| |
| | |
| | |
| 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|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|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:
| |
| | |
| ''Great choices for beginners:''
| |
| * [[Language - C|C]]
| |
| * [[Language - C Sharp|C#]]
| |
| * [[Language - Python | Python]]
| |
| * [[Language - Java | Java]]
| |
| ''Also supported:''
| |
| * [[Language - Objective C | Objective-C]]
| |
| * [[Language - JavaScript | JavaScript]]
| |
| * [[Language - Swift | Swift]]
| |
| * [[Language - Max/MSP|Max/MSP]]
| |
| | |
| ==Phidget Network Server==
| |
| The Phidget Network Server is an extremely useful tool that allows you to remotely control Phidgets over your network. If you haven't already, check out the [[Phidget Network Server]] page for a complete overview.
| |
| | |
| ===Try it Out!===
| |
| In order to try the Phidget Network Server out, you will need a host computer, and a client computer:
| |
| *'''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.
| |
| If you only have one computer, don't worry, your machine can act as both a host and a client.
| |
| | |
| | |
| Next, open the Phidget Control Panel on your host computer. Do this by double-clicking on the [[File:Ph.jpg|link=]] icon in your applications folder. Navigate to the Network Server tab, you will see the following:
| |
| [[File:macos_networkserver.png|link=|center]]
| |
| | |
| | |
| From here, you can start or stop the Network Server. You can also decide when the Network Server will start.
| |
| [[File:macos_networkserver_run.png|link=|center]]
| |
| | |
| | |
| Check the automatic start box and enter a server name. By enabling automatic startup, the Network Server will run immediately after macOS boots, so you won't have to manually start it again. You can verify the Network Server is running by looking at the label beside the start/stop button.
| |
|
| |
|
| | ===Phidget Control Panel=== |
| | After downloading, drag the application into your Applications folder: |
| | [[Image:Macos_standalone_install.png|link=https://cdn.phidgets.com/docs/images/c/c8/Macos_applications_controlpanel.png|center|600px]] |
|
| |
|
| Now that you have the Network Server running on your host computer, the next step will be accessing the Phidgets connected to your host computer from your client computer. Follow the steps below:
| | You can then find the application in the Applications folder by searching for ''Phidget Control Panel''. |
| | [[Image:Macos_applications_controlpanel.png|link=https://cdn.phidgets.com/docs/images/c/c8/Macos_applications_controlpanel.png|600px|center]] |
|
| |
|
| | When you open the application for the first time, you will see the following notice: |
| | [[Image:Macos_install_extension.png|link=https://cdn.phidgets.com/docs/images/9/9e/Macos_install_extension.png|300px|center]] |
|
| |
|
| Open the Phidget Control Panel on your client computer. You will see something like this:
| | Follow the link in the pop-up, or navigate to ''System Settings > General > Login Items & Extensions > Extensions'', and give permissions: |
| [[File:macos_controlpanel_remote.png|link=|center]] | | [[Image:Macos_install_extension_permission.png|link=https://cdn.phidgets.com/docs/images/a/ac/Macos_install_extension_permission.png|600px|center]] |
| | <center>''Note: The driver extension is only required for legacy USB Phidgets running a HID USB stack. Refer to your product’s specifications page for information about its USB stack.''</center> |
|
| |
|
|
| |
|
| As you can see from the image above, Phidget servers are listed under the following heading:
| | After running the application, you will see all the Phidgets that are plugged into your machine, as well as any Phidgets that are on your network. |
| *Remote Server: Servername
| | [[Image:Os_macos_controlpanel.png|600px|link=https://cdn.phidgets.com/docs/images/a/a1/Os_macos_controlpanel.png|center]] |
|
| |
|
|
| |
|
| You now have access to the Phidgets that are connected to your host computer. Try double-clicking one of them to bring up an example:
| | 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:macos_controlpanel_remoteexample.png|link=|center]]
| |
|
| |
|
|
| |
|
| Note the label in the example indicating a remote connection. This means the example is using the Phidget Network Server in order to communicate with the device.
| | [[File:Os_macos_controlpanel_example.png|link=https://cdn.phidgets.com/docs/images/3/37/Os_macos_controlpanel_example.png|center|600px]] |
|
| |
|
| ===What's Next?===
| |
| Now that you have seen the Phidget Network Server in action, you may be interested in implementing an application that takes advantage of all it's features. Luckily, every programming language we support comes with example code on how to do this! Jump to [[#Programming|programming languages]] above.
| |
|
| |
|
| | 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. |
|
| |
|
| For more information about the Network Server tab on the Phidget Control Panel, visit the Visit the [[Phidget Control Panel|Phidget Control Panel]] page.
| | ===Programming=== |
| | When you are ready to develop your own applications, visit our [{{SERVER}}/docs/Programming_Resources programming resources page] and select your programming language to get started. |
|
| |
|
| ==Advanced Information== | | ==Software License== |
| ===Installed Files===
| | By downloading the installer and/or development files, you agree to adhere to the terms of the [{{SERVER}}/documentation/Licenses/Phidgets_EULA.pdf Phidgets End User License Agreement]. The Phidget libraries and development files are covered by the The 3-Clause BSD License. |
| 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.||/System/Library/Extensions
| |
| |-
| |
| |phidgetnetworkserver22||Phidget Network Server||/usr/local/bin
| |
| |-
| |
| |}
| |
Quick Downloads
Our libraries support macOS 10.11 and newer.
Other Resources
Getting Started with macOS
Install
To get started, download the appropriate package for your machine from the list above. This will install the Phidget Control Panel and the Phidget Network Server. These are powerful tools that will help you develop your Phidget applications.
Phidget Control Panel
After downloading, drag the application into your Applications folder:
You can then find the application in the Applications folder by searching for Phidget Control Panel.
When you open the application for the first time, you will see the following notice:
Follow the link in the pop-up, or navigate to System Settings > General > Login Items & Extensions > Extensions, and give permissions:
Note: The driver extension is only required for legacy USB Phidgets running a HID USB stack. Refer to your product’s specifications page for information about its USB stack.
After running the application, you will see all the Phidgets that are plugged into your machine, as well as any Phidgets that are on your network.
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.
The Phidget Control Panel can be used for testing devices, updating firmware, enabling a Phidget Network Server, and more. Visit the Phidget Control Panel page for more information.
Programming
When you are ready to develop your own applications, visit our programming resources page and select your programming language to get started.
Software License
By downloading the installer and/or development files, you agree to adhere to the terms of the Phidgets End User License Agreement. The Phidget libraries and development files are covered by the The 3-Clause BSD License.
