IOIO-OTG - Revision history

Admin: /* Documents */

2014-08-30T06:41:01Z

Documents

← Older revision		Revision as of 06:41, 30 August 2014
Line 242:		Line 242:

	GitHub [[Media:IOIO OTG master.zip]]		GitHub [[Media:IOIO OTG master.zip]]



			== How to buy ==
			Click here to buy: http://www.geeetech.com/ioio-otg-android-development-board-p-859.html

Admin at 09:35, 28 August 2014

2014-08-28T09:35:34Z

← Older revision		Revision as of 09:35, 28 August 2014
Line 1:		Line 1:
	==Introduction==		==Introduction==
	[[File:~~10748-01b~~.jpg\|600px\|]]		[[File:IOIO OTG1.jpg\|600px\|]]

	The IOIO–OTG is a printed circuit board specially designed to work with the Android device or PC application. With it, you can connect an app on an Android device or a PC to low level peripherals like PWM, GPIO, ADC, I2C, UART and SPI. The IOIO doesn’t require you to write two pieces of software (board and client), it only require you to write the client-side (Android, PC) software. You can use a high-level programming language (currently Java) with a rich and intuitive API that allows you to manipulate the I/O pins and hardware peripherals on the board. So it is so fast and simple to do some prototyping and development with the IOIO. And this must be attributed to its microcontroller – PIC24FJ256GB206.		The IOIO–OTG is a printed circuit board specially designed to work with the Android device or PC application. With it, you can connect an app on an Android device or a PC to low level peripherals like PWM, GPIO, ADC, I2C, UART and SPI. The IOIO doesn’t require you to write two pieces of software (board and client), it only require you to write the client-side (Android, PC) software. You can use a high-level programming language (currently Java) with a rich and intuitive API that allows you to manipulate the I/O pins and hardware peripherals on the board. So it is so fast and simple to do some prototyping and development with the IOIO. And this must be attributed to its microcontroller – PIC24FJ256GB206.

Admin at 02:31, 19 August 2014

2014-08-19T02:31:51Z

← Older revision		Revision as of 02:31, 19 August 2014
Line 241:		Line 241:
	IOIO Project Gallery [https://github.com/sparkfun/IOIO-OTG]		IOIO Project Gallery [https://github.com/sparkfun/IOIO-OTG]

	GitHub		GitHub [[Media:IOIO OTG master.zip]]

Admin at 02:27, 19 August 2014

2014-08-19T02:27:39Z

@@ Line 53: / Line 53: @@
 Installing Eclipse and the Android SDK[http://developer.android.com/sdk/installing.html]
 '''ATTENTION:''' You must use JDK v6 (not v5 or v7) for Android development.
@@ Line 222: / Line 223: @@
 ::*IOIO Manager Wiki[https://github.com/ytai/ioio/wiki/The-IOIO-Manager-Application]

Admin at 02:09, 19 August 2014

2014-08-19T02:09:37Z

Show changes

Admin at 01:54, 19 August 2014

2014-08-19T01:54:09Z

← Older revision		Revision as of 01:54, 19 August 2014
Line 35:		Line 35:
	*Pins marked with DAx and CLx are used for TWI.		*Pins marked with DAx and CLx are used for TWI.
	==Beginner Guide==		==Beginner Guide==
	The programming language used to write an Android app is Java. If you are not familiar with Java, this tutorial will only go over writing a simple Java app using the IOIO library. This tutorial will not cover how to write Java code nor will it cover how to use the rich features within your Android device, like GPS, accelerometer, touch screen, etc. Once you get to the point where you want to use the vast array of features on your Android, we suggest first looking at the technical resource section on developer.android.com. If you still can't find the examples you are looking for, simply browsing the web will result in a ton of information and examples that show you how to communicate with all of the great pieces of hardware within your Andriod device.		The programming language used to write an Android app is Java. If you are not familiar with Java, this tutorial will only go over writing a simple Java app using the IOIO library. This tutorial will not cover how to write Java code nor will it cover how to use the rich features within your Android device, like GPS, accelerometer, touch screen, etc. Once you get to the point where you want to use the vast array of features on your Android, we suggest first looking at the [technical resource][http://developer.android.com/resources/browser.html?tag=sample] section on developer.android.com. If you still can't find the examples you are looking for, simply browsing the web will result in a ton of information and examples that show you how to communicate with all of the great pieces of hardware within your Andriod device.

	In general, the holy grail for developing Android apps is developer.android.com. There, you will find most of the information on Android development. For documentation/downloads specific to the IOIO and for more advanced discussions about the IOIO, see these links:		In general, the holy grail for developing Android apps is developer.android.com. There, you will find most of the information on Android development. For documentation/downloads specific to the IOIO and for more advanced discussions about the IOIO, see these links:

Admin at 01:51, 19 August 2014

2014-08-19T01:51:54Z

← Older revision		Revision as of 01:51, 19 August 2014
Line 179:		Line 179:
	return new IOIOThread();		return new IOIOThread();
	}		}
	}		}
	In the code above, there are plenty of comments that explain what each line does. This app is a great starting point for making sure your development environment and the IOIO board is working correctly.		In the code above, there are plenty of comments that explain what each line does. This app is a great starting point for making sure your development environment and the IOIO board is working correctly.

Admin at 01:49, 19 August 2014

2014-08-19T01:49:24Z

← Older revision		Revision as of 01:49, 19 August 2014
Line 39:		Line 39:
	In general, the holy grail for developing Android apps is developer.android.com. There, you will find most of the information on Android development. For documentation/downloads specific to the IOIO and for more advanced discussions about the IOIO, see these links:		In general, the holy grail for developing Android apps is developer.android.com. There, you will find most of the information on Android development. For documentation/downloads specific to the IOIO and for more advanced discussions about the IOIO, see these links:

	**IOIO-OTG Wiki		::*IOIO-OTG Wiki
	**All of the Downloads you need		::*All of the Downloads you need
	**IOIO discussion group		::*IOIO discussion group
	*Gathering Your Hardware		::Gathering Your Hardware
	Here are the pieces of hardware you will need to complete this tutorial:		Here are the pieces of hardware you will need to complete this tutorial:

	**Android enabled device using OS 1.5 or greater		::*Android enabled device using OS 1.5 or greater
	**IOIO-OTG board, with adapter cable		::*IOIO-OTG board, with adapter cable
	**USB cable that is compatible with your Android device		::*USB cable that is compatible with your Android device
	**5-15V power supply with at least 1A of current. You will need to power the IOIO through the VIN and GND pins or there is an optional JST connector, which can be used with this adapter and wall wart power supply. More information at the end of the tutorial found here.		::*5-15V power supply with at least 1A of current. You will need to power the IOIO through the VIN and GND pins or there is an optional JST connector, which can be used with this adapter and wall wart power supply. More information at the end of the tutorial found here.
	*Installing the Development Environment		*Installing the Development Environment
	The Eclipse IDE (integrated development environment), the Android SDK (software development kit), and the JDK (Java development kit) are the primary pieces of software that you will need to install. The page developer.android.com has written thorough instructions on what exactly you will need to download. Please read the instructions carefully, they are found in the link below:		The Eclipse IDE (integrated development environment), the Android SDK (software development kit), and the JDK (Java development kit) are the primary pieces of software that you will need to install. The page developer.android.com has written thorough instructions on what exactly you will need to download. Please read the instructions carefully, they are found in the link below:
Line 130:		Line 130:
	button_ = (ToggleButton) findViewById(R.id.button);		button_ = (ToggleButton) findViewById(R.id.button);
	}		}

	/**		/**
	* This is the thread on which all the IOIO activity happens. It will be run		* This is the thread on which all the IOIO activity happens. It will be run
Line 141:		Line 140:
	/** The on-board LED. */		/** The on-board LED. */
	private DigitalOutput led_;		private DigitalOutput led_;

	/**		/**
	* Called every time a connection with IOIO has been established.		* Called every time a connection with IOIO has been established.
Line 155:		Line 153:
	led_ = ioio_.openDigitalOutput(0, true);		led_ = ioio_.openDigitalOutput(0, true);
	}		}

	/**		/**
	* Called repetitively while the IOIO is connected.		* Called repetitively while the IOIO is connected.
Line 173:		Line 170:
	}		}
	}		}

	/**		/**
	* A method to create our IOIO thread.		* A method to create our IOIO thread.
Line 196:		Line 192:
	Here are some more resources to help you out with writing code:		Here are some more resources to help you out with writing code:

	**For all Android types, see the Android package index.		::*For all Android types, see the Android package index.
	**For IOIO types and examples, see the IOIO-OTG Wiki.		::*For IOIO types and examples, see the IOIO-OTG Wiki.
	*Compiling, Loading, and Running the App on Your Android Device		*Compiling, Loading, and Running the App on Your Android Device
	If you change any part of the code, simply saving the project compiles the program and creates a new HelloIOIO.apk file. An apk file is a compressed Android Package file, similar to zip and jar. files, that is used to create an app on your Android device. This file can be found in the HelloIOIO project tree within the bin directory.		If you change any part of the code, simply saving the project compiles the program and creates a new HelloIOIO.apk file. An apk file is a compressed Android Package file, similar to zip and jar. files, that is used to create an app on your Android device. This file can be found in the HelloIOIO project tree within the bin directory.
Line 225:		Line 221:
	The IOIO firmware is code that sits on the PIC microncontroller located on the IOIO board. Sometimes new changes will be pushed out and you might have an board with older firmware. There is a very simple way to update the IOIO firmware.		The IOIO firmware is code that sits on the PIC microncontroller located on the IOIO board. Sometimes new changes will be pushed out and you might have an board with older firmware. There is a very simple way to update the IOIO firmware.

	**IOIO Manager Wiki		::*IOIO Manager Wiki

Admin at 01:46, 19 August 2014

2014-08-19T01:46:47Z

← Older revision		Revision as of 01:46, 19 August 2014
Line 1:		Line 1:
	==Introduction==		==Introduction==
	[[File:10748-01b.jpg]]		[[File:10748-01b.jpg\|600px\|]]

	The IOIO–OTG is a printed circuit board specially designed to work with the Android device or PC application. With it, you can connect an app on an Android device or a PC to low level peripherals like PWM, GPIO, ADC, I2C, UART and SPI. The IOIO doesn’t require you to write two pieces of software (board and client), it only require you to write the client-side (Android, PC) software. You can use a high-level programming language (currently Java) with a rich and intuitive API that allows you to manipulate the I/O pins and hardware peripherals on the board. So it is so fast and simple to do some prototyping and development with the IOIO. And this must be attributed to its microcontroller – PIC24FJ256GB206.		The IOIO–OTG is a printed circuit board specially designed to work with the Android device or PC application. With it, you can connect an app on an Android device or a PC to low level peripherals like PWM, GPIO, ADC, I2C, UART and SPI. The IOIO doesn’t require you to write two pieces of software (board and client), it only require you to write the client-side (Android, PC) software. You can use a high-level programming language (currently Java) with a rich and intuitive API that allows you to manipulate the I/O pins and hardware peripherals on the board. So it is so fast and simple to do some prototyping and development with the IOIO. And this must be attributed to its microcontroller – PIC24FJ256GB206.
Line 22:		Line 22:
	*Charge current trimmer (CHG): Adjusts the amount of current supplied on the VBUS line of the USB when acting as a USB host. Typically used in battery-powered application with Android to prevent the Android from draining the battery quickly. Turning in the (+) direction increases charge current.		*Charge current trimmer (CHG): Adjusts the amount of current supplied on the VBUS line of the USB when acting as a USB host. Typically used in battery-powered application with Android to prevent the Android from draining the battery quickly. Turning in the (+) direction increases charge current.
	*Host switch: In "A" mode, the IOIO-OTG will detect whether it should act as host or as device automatically, according to whichever USB connector is plugged in (micro-A or micro-B). To support non-standard USB cables or adapters that use micro-B type, move the switch to the "H" position to force host mode.		*Host switch: In "A" mode, the IOIO-OTG will detect whether it should act as host or as device automatically, according to whichever USB connector is plugged in (micro-A or micro-B). To support non-standard USB cables or adapters that use micro-B type, move the switch to the "H" position to force host mode.

	[[File:6874747.jpg]]		[[File:6874747.jpg]]

Line 69:		Line 70:

	3) Next, open Eclipse, then goto File > Import, and select Existing Projects Into Workspace. Then hit Next.		3) Next, open Eclipse, then goto File > Import, and select Existing Projects Into Workspace. Then hit Next.

	[[File:Import small.jpg]]		[[File:Import small.jpg]]

	4) Another window will pop up (as shown below). Select 'Select Root Directory' and navigate to the file you just unzipped and point to the HelloIOIO folder found in /applications/HelloIOIO. Be sure the check box is selected for your project. Now hit Finish.		4) Another window will pop up (as shown below). Select 'Select Root Directory' and navigate to the file you just unzipped and point to the HelloIOIO folder found in /applications/HelloIOIO. Be sure the check box is selected for your project. Now hit Finish.

	[[File:Import project small.jpg]]		[[File:Import project small.jpg]]

	5) You should now have HelloIOIO in your project explorer in Eclipse. Notice that there is a small red x next to the project name. This means there are build errors, so whenever you see this, you know something needs to be fixed. In this situation, we need to link the IOIO library to our project, as outlined in the next step.		5) You should now have HelloIOIO in your project explorer in Eclipse. Notice that there is a small red x next to the project name. This means there are build errors, so whenever you see this, you know something needs to be fixed. In this situation, we need to link the IOIO library to our project, as outlined in the next step.

	[[File:Project explorer.jpg]]		[[File:Project explorer.jpg]]

Line 82:		Line 86:

	After you added the library files into the workspace, select the HelloIOIO project, then on the top toolbar goto: Project > Properties. Then, select 'Android' in the list to the left. In the 'Library' section, click add, then add both the IOIOLib and IOIOLibBT libraries. You should see both of them with a green check mark as shown below (note: image doesn't show the IOIOLibBT, but it should be there if using Bluetooth).		After you added the library files into the workspace, select the HelloIOIO project, then on the top toolbar goto: Project > Properties. Then, select 'Android' in the list to the left. In the 'Library' section, click add, then add both the IOIOLib and IOIOLibBT libraries. You should see both of them with a green check mark as shown below (note: image doesn't show the IOIOLibBT, but it should be there if using Bluetooth).

	[[File:Liblink small.jpg]]		[[File:Liblink small.jpg]]

Line 89:		Line 94:

	7) The next thing you need to do is make sure your app has internet permissions. To do this, open the AndroidManifest.xml file located in the main project tree. Make sure you are in the permissions tab, then click Add > Usage Permissions, then make sure the 'Name' field is android.permission.INTERNET. See the picture below for reference:		7) The next thing you need to do is make sure your app has internet permissions. To do this, open the AndroidManifest.xml file located in the main project tree. Make sure you are in the permissions tab, then click Add > Usage Permissions, then make sure the 'Name' field is android.permission.INTERNET. See the picture below for reference:

	[[File:Permissions small.jpg]]		[[File:Permissions small.jpg]]

	After you have done this and saved your project, the projects explorer window should look something like this:		After you have done this and saved your project, the projects explorer window should look something like this:

	[[File:Project tree2 small.jpg]]		[[File:Project tree2 small.jpg]]

	The project tree has many files. You really don't need to mess with the IOIOLib project tree so you can minimize that one. The file that contains the java code for the IOIO is in HelloIOIO > scr > ioio.examples.hello > MainActivity.java. Double click on the MainActivity.java file and you should see this:		The project tree has many files. You really don't need to mess with the IOIOLib project tree so you can minimize that one. The file that contains the java code for the IOIO is in HelloIOIO > scr > ioio.examples.hello > MainActivity.java. Double click on the MainActivity.java file and you should see this:

	[[File:Project main small.jpg]]		[[File:Project main small.jpg]]

Line 100:		Line 108:

	The MainActivity.java file contains the code that talks to the IOIO board. If you want to change the UI (user interface or graphics) of your app, the res > layout > main.xml file is where you make the changes. The main.xml file in the HelloIOIO example uses an interface that looks like this:		The MainActivity.java file contains the code that talks to the IOIO board. If you want to change the UI (user interface or graphics) of your app, the res > layout > main.xml file is where you make the changes. The main.xml file in the HelloIOIO example uses an interface that looks like this:

	[[File:App small.jpg]]		[[File:App small.jpg]]

Line 178:		Line 187:

	Eclipse is a very powerful tool and gives debugging information in real time. For instance, if you write code that doesn't make sense, Eclipse will show a red x next to the line in question and even give you suggestions as to how to change the line of code. Simply hover your mouse cursor over the line and you will see something like this:		Eclipse is a very powerful tool and gives debugging information in real time. For instance, if you write code that doesn't make sense, Eclipse will show a red x next to the line in question and even give you suggestions as to how to change the line of code. Simply hover your mouse cursor over the line and you will see something like this:

	[[File:Error small.jpg]]		[[File:Error small.jpg]]

Line 198:		Line 208:

	3. Prepare the IOIO board. The only thing you need to do for the HelloIOIO example is power the IOIO board. Keep in mind, the IOIO board will always need an external power supply between 5-15V. Single cell LiPos batteries will NOT work, you need a 5-15V input. You can connect the power supply to the VIN and GND pins (headers will need to be soldered in place) or to the JST connector. If using the JST connector, you might want this adapter cable.		3. Prepare the IOIO board. The only thing you need to do for the HelloIOIO example is power the IOIO board. Keep in mind, the IOIO board will always need an external power supply between 5-15V. Single cell LiPos batteries will NOT work, you need a 5-15V input. You can connect the power supply to the VIN and GND pins (headers will need to be soldered in place) or to the JST connector. If using the JST connector, you might want this adapter cable.

	[[File:Ioio-otg-power small.jpg]]		[[File:Ioio-otg-power small.jpg]]

Line 204:		Line 215:

	5. Open the Hello IOIO app and toggle the button, you should see the yellow stat LED come on and off. Congratulations! You are now on your way to creating your very own IOIO apps!		5. Open the Hello IOIO app and toggle the button, you should see the yellow stat LED come on and off. Congratulations! You are now on your way to creating your very own IOIO apps!

	[[File:app_small.jpg]]		[[File:app_small.jpg]]

Admin at 01:44, 19 August 2014

2014-08-19T01:44:54Z

Show changes