IOIO Bridge

Ytai Ben-Tsvi edited this page Nov 27, 2012 · 1 revision

IOIO Bridge


Since IOIO can work with both Android and PC, wouldn't it be cool if it could work with the Android emulator? You got it! But wait! I want to debug my IOIO-based Android application on the target device and cannot use Bluetooth for some reason. OK - this is workable too!

If you like using the Android emulator for developing Android apps or would like to debug the target device while working with the IOIO, the IOIO Bridge is what you are looking for. The IOIO bridge lets you connect a IOIO to a host PC, then bridge the connection to either a running emulator, or an actual Android device connected to that PC. Please note that this is an experimental tool, so it might be a little bit rough around the edges. Feel free to report any issues on the ioio-users list or open an issue on GitHub.

Download and Install

Here is the download link of the latest version. Earlier versions can be found here.

Once downloaded, extract the ZIP file somewhere. It contains a JAR file and two scripts (one for Windows, one for Unix / OSX). If you are on Unix / OSX, give the script execute permissions:

chmod +x ioiobridge

This is a one-time process.


You need to start by connecting the IOIO to your PC (over Bluetooth or USB), as described on this page. Once you are connected, and know the port identifier, the bridge tool must be running in the background as long as you want to use the IOIO from the emulator. Open a command shell and run:

ioiobridge <serial_port_id>

What you just did here is:

  • Setup the ADB server running on your PC to listen for incoming connections on TCP port 4545 or your PC and forward them to TCP port 4545 on the emulator or device (which is where the IOIO library is listening for an incoming IOIO connection).
  • Then run the bridge tool, which waits for a IOIO to connect to the PC as a serial port, and as soon as it does, opens a TCP connection to port 4545 on localhost and bridges the serial connection to the TCP connection.

To exit, simply press ctrl-C.