OS - Android - Revision history

Mparadis at 21:22, 19 December 2024

2024-12-19T21:22:49Z

← Older revision		Revision as of 21:22, 19 December 2024
Line 40:		Line 40:

	Note that Android Java is NOT the same as mainstream Java. Any Java programs you have will probably need significant modification before they run on Android, including our [[Language - Java\|mainstream Java]] Phidget Examples.		Note that Android Java is NOT the same as mainstream Java. Any Java programs you have will probably need significant modification before they run on Android, including our [[Language - Java\|mainstream Java]] Phidget Examples.
	~~<!--~~
	==~~Common Problems and Solutions~~==		==Software License==
	-->		By downloading the Android 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].

Mparadis: /* Network Server */

2024-12-19T20:23:20Z

Network Server

← Older revision		Revision as of 20:23, 19 December 2024
Line 31:		Line 31:
	In this case, you will need to install the Phidget libraries on your host computer, and get the Phidget Network Server up and running. Follow the ''Getting Started'' guide, and continue with the ''Network Server'' guide for your operating system. When you are done, come back and finish this guide!		In this case, you will need to install the Phidget libraries on your host computer, and get the Phidget Network Server up and running. Follow the ''Getting Started'' guide, and continue with the ''Network Server'' guide for your operating system. When you are done, come back and finish this guide!
	*[[OS - Windows\| Windows]]		*[[OS - Windows\| Windows]]
	*[[OS - ~~OS X~~\| macOS]]		*[[OS - macOS\| macOS]]
	*[[OS - Linux\| Linux]]		*[[OS - Linux\| Linux]]
	*[[OS - Phidget SBC\| Phidget Single Board Computer]]		*[[OS - Phidget SBC\| Phidget Single Board Computer]]

Patrick at 22:03, 17 October 2023

2023-10-17T22:03:07Z

← Older revision		Revision as of 22:03, 17 October 2023
Line 11:		Line 11:
	==Download==		==Download==
	The Phidget libraries for Android development are available here:		The Phidget libraries for Android development are available here:
	*[~~{{SERVER}}~~/downloads/phidget22/libraries/android/phidget22-android.zip Android Java Libraries]		*[https://cdn.phidgets.com/downloads/phidget22/libraries/android/phidget22-android.zip Android Java Libraries]

	Download and unpack the libraries. You will need to reference these files from your project in order to use Phidgets. This step is covered in detail in the [[Language - Android Java \| Android Java page]]. If you need to access older versions of the libraries, [https://www.phidgets.com/downloads/phidget22/libraries/android/ click here].		Download and unpack the libraries. You will need to reference these files from your project in order to use Phidgets. This step is covered in detail in the [[Language - Android Java \| Android Java page]]. If you need to access older versions of the libraries, [https://www.phidgets.com/downloads/phidget22/libraries/android/ click here].

Mparadis: /* Download */

2023-08-11T18:04:54Z

Download

← Older revision		Revision as of 18:04, 11 August 2023
Line 13:		Line 13:
	*[{{SERVER}}/downloads/phidget22/libraries/android/phidget22-android.zip Android Java Libraries]		*[{{SERVER}}/downloads/phidget22/libraries/android/phidget22-android.zip Android Java Libraries]

	Download and unpack the libraries. You will need to reference these files from your project in order to use Phidgets. This step is covered in detail in the [[Language - Android Java \| Android Java page]].		Download and unpack the libraries. You will need to reference these files from your project in order to use Phidgets. This step is covered in detail in the [[Language - Android Java \| Android Java page]]. If you need to access older versions of the libraries, [https://www.phidgets.com/downloads/phidget22/libraries/android/ click here].

	==Direct USB Connection==		==Direct USB Connection==

Jdecoux at 18:47, 31 October 2018

2018-10-31T18:47:58Z

← Older revision		Revision as of 18:47, 31 October 2018
Line 1:		Line 1:
	<metadesc>Communicate over USB with sensors, controllers and relays with Phidgets! Program in Android using Android Java.</metadesc>		<metadesc>Communicate over USB with sensors, controllers and relays with Phidgets! Program in Android using Android Java.</metadesc>
	[[Category:OS]]		[[Category:OS]]
	~~__TOC__~~		{\|
	~~==Quick Downloads==~~		\|style="vertical-align:middle; width: 60%;"\|

	~~Already know what you're doing? Here you go:~~

	* [{~~{SERVER}}/downloads/phidget22/libraries/android/phidget22-android.zip Phidget Android libraries]~~
	* {{SampleCodeOS\|~~Android\|Android Java Examples}}~~
	* [[Language - ~~Android Java#Quick Downloads~~\|~~Android Java page]]~~

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

	If this is your first Phidget, we highly recommend working through the Getting Started guide for your specific Phidget device, which may be found in its [[:Category:UserGuide\|user guide]].		If this is your first Phidget, we highly recommend working through the Getting Started guide for your specific Phidget device, which may be found in its [[:Category:UserGuide\|user guide]]. If you are ready to go, the first step to creating an Android application with Phidgets is downloading the Phidget libraries on your development machine!
			\|{{TOC limit\|2}}
	===Download===		\|}
			==Download==
	The Phidget libraries for Android development are available here:		The Phidget libraries for Android development are available here:
	*[{{SERVER}}/downloads/phidget22/libraries/android/phidget22-android.zip Android Java Libraries]		*[{{SERVER}}/downloads/phidget22/libraries/android/phidget22-android.zip Android Java Libraries]
Line 20:		Line 15:
	Download and unpack the libraries. You will need to reference these files from your project in order to use Phidgets. This step is covered in detail in the [[Language - Android Java \| Android Java page]].		Download and unpack the libraries. You will need to reference these files from your project in order to use Phidgets. This step is covered in detail in the [[Language - Android Java \| Android Java page]].

	===Direct USB Connection===		==Direct USB Connection==
	For directly controlling a Phidget with your Android device (i.e. plugging a Phidget directly into your device), you will need to ensure the device is capable of being a USB host. Just having a port that the USB cable can fit into does not necessarily indicate that the port can host a USB device. On the other hand, some phones can use an OTG (on-the-go) cable to allow plugging USB devices into their charging port. Some tablets (like the Samsung Galaxy Tab, for example) have the large 30-pin connectors that can be changed into a USB host using an adapter.		For directly controlling a Phidget with your Android device (i.e. plugging a Phidget directly into your device), you will need to ensure the device is capable of being a USB host. Just having a port that the USB cable can fit into does not necessarily indicate that the port can host a USB device. On the other hand, some phones can use an OTG (on-the-go) cable to allow plugging USB devices into their charging port. Some tablets (like the Samsung Galaxy Tab, for example) have the large 30-pin connectors that can be changed into a USB host using an adapter.

	The best way to know before getting your hands on a device is to check its specifications for whether it can serve as a USB host. Alternately, a quick way to figure out if your device can serve as a USB host is to try plugging other devices (such as a mouse, or USB memory stick) into your Android device.		The best way to know before getting your hands on a device is to check its specifications for whether it can serve as a USB host. Alternately, a quick way to figure out if your device can serve as a USB host is to try plugging other devices (such as a mouse, or USB memory stick) into your Android device.

	===Network Server===		==Network Server==
	In applications where you aren't plugging Phidgets into your Android device directly, you must have a host computer that is running the Phidget Network Server.		In applications where you aren't plugging Phidgets into your Android device directly, you must have a host computer that is running the Phidget Network Server.

Line 34:		Line 29:


	In this case, you will need to install the Phidget libraries on your host computer, and get the Phidget Network Server up and running. Follow the ''Getting ~~started~~'' guide, and continue with the ''Network Server'' guide for your operating system. When you are done, come back and finish this guide!		In this case, you will need to install the Phidget libraries on your host computer, and get the Phidget Network Server up and running. Follow the ''Getting Started'' guide, and continue with the ''Network Server'' guide for your operating system. When you are done, come back and finish this guide!
	*[[OS - Windows\| Windows]]		*[[OS - Windows\| Windows]]
	*[[OS - OS X\| macOS]]		*[[OS - OS X\| macOS]]

Jdecoux at 18:33, 12 December 2017

2017-12-12T18:33:47Z

Show changes

Mparadis at 19:51, 7 June 2017

2017-06-07T19:51:24Z

← Older revision		Revision as of 19:51, 7 June 2017
Line 14:		Line 14:

	Android does not need special drivers installed, though for developing code you will need the Android Java libraries when you start writing code:		Android does not need special drivers installed, though for developing code you will need the Android Java libraries when you start writing code:
	* [{{SERVER}}/downloads/libraries/~~phidget21-~~android.tar.gz Phidget Android libraries]		* [{{SERVER}}/downloads/phidget22/libraries/android.tar.gz Phidget Android libraries]
	* [{{SERVER}}/downloads/examples/android-examples.tar.gz Phidget Android examples]		* [{{SERVER}}/downloads/examples/android-examples.tar.gz Phidget Android examples]
	* [[Language - Android Java#Quick Downloads\|Android Java page]]		* [[Language - Android Java#Quick Downloads\|Android Java page]]

Mparadis at 16:08, 4 May 2017

2017-05-04T16:08:51Z

← Older revision		Revision as of 16:08, 4 May 2017
Line 2:		Line 2:
	{{OSLang\|[[File:Icon-Android.png‎\|64x64px\|left\|link=]]\|Android is a mobile OS commonly used on smartphones and tablet computers.}}		{{OSLang\|[[File:Icon-Android.png‎\|64x64px\|left\|link=]]\|Android is a mobile OS commonly used on smartphones and tablet computers.}}
	__TOC__		__TOC__

			Android is currently not supported in Phidget22, but support will be added in a future version.

			<!--

	Tablets with a USB port and Android version 3.1 or greater can control Phidgets directly plugged in to them. Earlier Android versions (tested down to 2.1) can control Phidgets over a network using the [[#Network Server\|Network Server]]. We do not currently support Android devices acting as a [[Phidget Network Server]] server, but if you are looking for a compact and cheaper-than-a-tablet way to host Phidgets over a network, take a look at our [{{SERVER}}/products.php?product_id=1073 Single Board Computer].		Tablets with a USB port and Android version 3.1 or greater can control Phidgets directly plugged in to them. Earlier Android versions (tested down to 2.1) can control Phidgets over a network using the [[#Network Server\|Network Server]]. We do not currently support Android devices acting as a [[Phidget Network Server]] server, but if you are looking for a compact and cheaper-than-a-tablet way to host Phidgets over a network, take a look at our [{{SERVER}}/products.php?product_id=1073 Single Board Computer].
Line 223:		Line 227:
	===Issue: Ad-Hoc Networking doesn't work===		===Issue: Ad-Hoc Networking doesn't work===
	Unfortunately Ad-Hoc networking is not currently supported by Android devices. This might change in the future but there is no work-around for the problem at this point in time (current as of 2014-3-11).		Unfortunately Ad-Hoc networking is not currently supported by Android devices. This might change in the future but there is no work-around for the problem at this point in time (current as of 2014-3-11).

			-->

Mparadis at 18:57, 28 April 2017

2017-04-28T18:57:19Z

← Older revision		Revision as of 18:57, 28 April 2017
Line 3:		Line 3:
	__TOC__		__TOC__

	Tablets with a USB port and Android version 3.1 or greater can control Phidgets directly plugged in to them. Earlier Android versions (tested down to 2.1) can control Phidgets over a network using the [[#Network ~~Service~~\|Network ~~Service~~]]. We do not currently support Android devices acting as a [[Phidget Network ~~Service~~]] server, but if you are looking for a compact and cheaper-than-a-tablet way to host Phidgets over a network, take a look at our [{{SERVER}}/products.php?product_id=1073 Single Board Computer].		Tablets with a USB port and Android version 3.1 or greater can control Phidgets directly plugged in to them. Earlier Android versions (tested down to 2.1) can control Phidgets over a network using the [[#Network Server\|Network Server]]. We do not currently support Android devices acting as a [[Phidget Network Server]] server, but if you are looking for a compact and cheaper-than-a-tablet way to host Phidgets over a network, take a look at our [{{SERVER}}/products.php?product_id=1073 Single Board Computer].

	==Quick Downloads==		==Quick Downloads==
Line 110:		Line 110:
	====Hardware====		====Hardware====

	If you are having problems running the examples, you should check the [[#Remote Phidget\|hardware of the host computer]] if your Android device is controlling the Phidget over the Network ~~Service~~. Or, you should check the hardware of your [[#Directly Connected Phidget\|Android device]] if the Phidget is directly connected to the tablet's USB port.		If you are having problems running the examples, you should check the [[#Remote Phidget\|hardware of the host computer]] if your Android device is controlling the Phidget over the Network Server. Or, you should check the hardware of your [[#Directly Connected Phidget\|Android device]] if the Phidget is directly connected to the tablet's USB port.

	=====Remote Phidget=====		=====Remote Phidget=====

	When using the [[#Network ~~Service~~\|Network ~~Service~~]] to control a Phidget, the problem may be with the USB connection on the remote computer. Make sure both the server-side of (a) the network ~~service~~ and (b) the USB connection are working by using the instructions on the [[Software Overview#Operating System Support\|page specific to the operating system]]		When using the [[#Network Server\|Network Server]] to control a Phidget, the problem may be with the USB connection on the remote computer. Make sure both the server-side of (a) the network server and (b) the USB connection are working by using the instructions on the [[Software Overview#Operating System Support\|page specific to the operating system]]

	=====Directly Connected Phidget=====		=====Directly Connected Phidget=====
Line 160:		Line 160:
	* You have copied and linked the Phidget jar libraries and libs/ folder into your project (as described on the [[Language - Android Java]] page)		* You have copied and linked the Phidget jar libraries and libs/ folder into your project (as described on the [[Language - Android Java]] page)
	* The Phidget libraries are the latest version (visit the [[#Quick Downloads\| quick downloads section]] to download them)		* The Phidget libraries are the latest version (visit the [[#Quick Downloads\| quick downloads section]] to download them)
	* If using the Phidget over the network ~~service~~, make sure the network ~~service~~ drivers and the Android libraries are both the latest version		* If using the Phidget over the network server, make sure the network server drivers and the Android libraries are both the latest version
	* If directly connecting to your Android device, the port you are using is a real USB host port (not a reduced-function power charging port)		* If directly connecting to your Android device, the port you are using is a real USB host port (not a reduced-function power charging port)
	* Check the [[#Common Problems and Solutions\|common problems]] section below, some specific combinations can cause problems		* Check the [[#Common Problems and Solutions\|common problems]] section below, some specific combinations can cause problems
Line 168:		Line 168:
	==Programming Languages==		==Programming Languages==

	Android OS programs are written in [[Language - Android Java\|Android Java]] using the Android SDK and the Phidgets library. You can read on within this page to learn how to use Android with the Network ~~Service~~, or you can jump ahead right now to the [[Language - Android Java\|Android Java]] page and start writing code!		Android OS programs are written in [[Language - Android Java\|Android Java]] using the Android SDK and the Phidgets library. You can read on within this page to learn how to use Android with the Network Server, or you can jump ahead right now to the [[Language - Android Java\|Android Java]] page and start writing code!

	Note that Android Java is NOT the same as mainstream Java. Any Java programs you have will probably need significant modification before they run on Android, including our [[Language - Java\|mainstream Java]] Phidget Examples.		Note that Android Java is NOT the same as mainstream Java. Any Java programs you have will probably need significant modification before they run on Android, including our [[Language - Java\|mainstream Java]] Phidget Examples.

	==Network ~~Service~~==		==Network Server==

	The Phidget Network ~~Service~~ allows you to remotely control a Phidget over a network.<br>This section helps you use the Network ~~Service~~ on Android, but we also have an overview of the [[Phidget Network ~~Service~~]] in general.		The Phidget Network Server allows you to remotely control a Phidget over a network.<br>This section helps you use the Network Server on Android, but we also have an overview of the [[Phidget Network Server]] in general.

	Currently, Android devices cannot ''host'' the Network ~~Service~~, but they can use data streaming from another computer over the Network ~~Service~~.		Currently, Android devices cannot ''host'' the Network Server, but they can use data streaming from another computer over the Network Server.

	===Setting Up the Network ~~Service~~===		===Setting Up the Network Server===

	Using an Android device, your network-controlled Phidget system will probably look something like this:		Using an Android device, your network-controlled Phidget system will probably look something like this:
Line 184:		Line 184:
	[[Image:Network service general pctoandroid.png\|600px\|link=\|alt=]]		[[Image:Network service general pctoandroid.png\|600px\|link=\|alt=]]

	1. Start the Network ~~Service~~ on the host computer		1. Start the Network Server on the host computer
	* How to do this [[OS - Windows#Phidget Network ~~Service~~\|on Windows]]		* How to do this [[OS - Windows#Phidget Network Server\|on Windows]]
	* How to do this [[OS - OS X#Phidget Network ~~Service~~\|on Mac OS]]		* How to do this [[OS - OS X#Phidget Network Server\|on Mac OS]]
	* How to do this [[OS - Linux#Phidget Network ~~Service~~\|On Linux]]		* How to do this [[OS - Linux#Phidget Network Server\|On Linux]]
	* How to do this [[OS - Phidget SBC#Phidget Network ~~Service~~\|On the Phidget Single Board Computer]]		* How to do this [[OS - Phidget SBC#Phidget Network Server\|On the Phidget Single Board Computer]]

	2. Download the [{{SERVER}}/downloads/examples/android-examples.tar.gz Android Examples].		2. Download the [{{SERVER}}/downloads/examples/android-examples.tar.gz Android Examples].
Line 199:		Line 199:
	3. Plug a Phidget into the host computer		3. Plug a Phidget into the host computer

	===Using the Network ~~Service~~===		===Using the Network Server===

	After performing the steps above, you will be using the Network ~~Service~~ already. Plugging in the Phidget to the host computer will probably give you a screen like this:		After performing the steps above, you will be using the Network Server already. Plugging in the Phidget to the host computer will probably give you a screen like this:

	[[Image:android_helloworld_remotehello.png\|700px\|alt=\|link=]]		[[Image:android_helloworld_remotehello.png\|700px\|alt=\|link=]]
Line 211:		Line 211:
	[[Image:android_helloworld_remotegoodbye.png\|700px\|alt=\|link=]]		[[Image:android_helloworld_remotegoodbye.png\|700px\|alt=\|link=]]

	===Debugging the Network ~~Service~~===		===Debugging the Network Server===

	As currently an Android device can only be a user and not a host of the Network ~~Service~~, you should use debugging server side. Refer to the network ~~service~~ sections for each operating system:		As currently an Android device can only be a user and not a host of the Network Server, you should use debugging server side. Refer to the network server sections for each operating system:
	* [[OS - Windows#Phidget Network ~~Service~~\|Windows]]		* [[OS - Windows#Phidget Network Server\|Windows]]
	* [[OS - OS X#Phidget Network ~~Service~~\|Mac OS]]		* [[OS - OS X#Phidget Network Server\|Mac OS]]
	* [[OS - Linux#Phidget Network ~~Service~~\|Linux]]		* [[OS - Linux#Phidget Network Server\|Linux]]
	* [[OS - Phidget SBC#Phidget Network ~~Service~~\|Phidget Single Board Computer]]		* [[OS - Phidget SBC#Phidget Network Server\|Phidget Single Board Computer]]
	In addition, if you are having network ~~service~~ problems, you will probably find the network ~~service~~ section of our [[General Troubleshooting#Network ~~Service~~ Troubleshooting\|General Troubleshooting Guide]] helpful as well.		In addition, if you are having network server problems, you will probably find the network server section of our [[General Troubleshooting#Network Server Troubleshooting\|General Troubleshooting Guide]] helpful as well.

	==Common Problems and Solutions==		==Common Problems and Solutions==
	===Issue: Ad-Hoc Networking doesn't work===		===Issue: Ad-Hoc Networking doesn't work===
	Unfortunately Ad-Hoc networking is not currently supported by Android devices. This might change in the future but there is no work-around for the problem at this point in time (current as of 2014-3-11).		Unfortunately Ad-Hoc networking is not currently supported by Android devices. This might change in the future but there is no work-around for the problem at this point in time (current as of 2014-3-11).

Mparadis at 20:19, 21 April 2017

2017-04-21T20:19:54Z

← Older revision		Revision as of 20:19, 21 April 2017
Line 182:		Line 182:
	Using an Android device, your network-controlled Phidget system will probably look something like this:		Using an Android device, your network-controlled Phidget system will probably look something like this:

	[[Image:~~Webservice~~ general pctoandroid.png\|600px\|link=\|alt=]]		[[Image:Network service general pctoandroid.png\|600px\|link=\|alt=]]

	1. Start the Network Service on the host computer		1. Start the Network Service on the host computer

← Older revision		Revision as of 20:23, 19 December 2024
Line 31:		Line 31:
	In this case, you will need to install the Phidget libraries on your host computer, and get the Phidget Network Server up and running. Follow the ''Getting Started'' guide, and continue with the ''Network Server'' guide for your operating system. When you are done, come back and finish this guide!		In this case, you will need to install the Phidget libraries on your host computer, and get the Phidget Network Server up and running. Follow the ''Getting Started'' guide, and continue with the ''Network Server'' guide for your operating system. When you are done, come back and finish this guide!
	*[[OS - Windows\| Windows]]		*[[OS - Windows\| Windows]]
	*[[OS - ~~OS X~~\| macOS]]		*[[OS - macOS\| macOS]]
	*[[OS - Linux\| Linux]]		*[[OS - Linux\| Linux]]
	*[[OS - Phidget SBC\| Phidget Single Board Computer]]		*[[OS - Phidget SBC\| Phidget Single Board Computer]]