I just added support for the OUYA on Windows 8, but it was fraught with peril.
I want to help by providing this little guide, so the next person won’t have as much trouble as I did. The OUYA developer has documentation to lead you through the process, but unfortunately that was not enough to get it working. Read on!
Android SDK
The first step is having a copy of the Android SDK installed. You’ll get this if you used “openfl setup android” and went through the steps, or if you go to the Android developer site. After you have the Android SDK on your system somewhere, you will need to run the “SDK Manager” which is in the same directory.
In order to deploy to any device, you will need the “Android SDK Platform-tools”, then you will want an “Android API” installed, OUYA recommends API 16, but you can usually older versions based on the code you are using. OpenFL has been using API 8 (targeting API 7, for technical reasons I can explain later) so that we can support 99.9% of the Android device market. This works perfectly well with newer devices.
You will also need the “Google USB Driver” which will be modified to allow installation for the OUYA.
android_winusb.inf
When you have the packages you need from the Android SDK Manager (it can take some time), you will want to modify the Google USB Driver to allow installation for the OUYA. If you have worked with other third-party Android platforms (such as a Kindle or Nook) then this process is similar.
Find “android_winusb.inf” within the Android SDK directory, underneath “extras/google/usb_driver”
Underneath the “[Google.NTx86]” and “[Google.NTamd64]” add the following entry:
;OUYA Console %SingleAdbInterface% = USB_Install, USB\VID_2836&PID_0010 %CompositeAdbInterface% = USB_Install, USB\VID_2836&PID_0010&MI_01 |
android_usb.ini
Next, you need to modify “C:\Users\<your user name>\.android\android_usb.ini”
If the “.android” directory does not exist, running “android update adb” from the “tools” directory of the Android SDK should create it for you. The OUYA documentation tells you to do this part from the command-line, but the line endings were wrong on my system, causing it to not work.
Add a line to the file with the following value:
0x2836 |
Advanced Start-Up
You will need to perform an “Advanced Start-Up” in order to install the USB driver on Windows 8:
Device Manager
Once you have restarted, go to Device Manager. Connect the OUYA and look for it under “Portable Devices” or “Unknown”
Go ahead and right-click it, then choose options in this order:
- “Update Driver Software…”
- “Browse my computer for driver software”
- “Let me pick from a list of device drivers on my computer”
- “Have disk…”
You will want to choose the “android_winusb.inf” file you earlier.
If it says that the driver is not compatible with your device, right-click the OUYA in Device Manager, and select “Uninstall” and try the above steps again to install the driver. When you are done, the OUYA should appear as an “Android Composite ADB Interface” in Device Manager.
Test
If all is working is properly, the OUYA should show in your list of ADB devices.
Go to a command-prompt and open “platform-tools” under the Android SDK directory, then run “adb start-server” and “adb devices”
On my system, the OUYA appears as the (incredibly descriptive) “015d4a5f6957fe08 device”
Hope this helps!
