pkpio / bard-linux

[GSoC] Beagle -> Android remote display. Kernel modules source.

bard-linux

Android remote display for BeagleBoard. This is a proposal for Google Summer of Code 2014 under Beagle.org. Check the complete proposal.

Developers / GSoC aspirants

Please start by reading this

Weekly reports

Weekly reports can be found at here

Framebuffer

Developed upon udlfb. udlfb is DisplayLinks's kernel framebuffer + USB driver. Most of the framebuffer work in this driver is taken directly from udlfb.

Usb communication

USB communication is done using Android Open Accessory (AOA) protocal with the Android device setup into Accessory Development Kit (ADK). Read about ADK on Android developers webpage.

A bare-bone implementation of the ADK driver, with only usb communication, can be found here

Setup

1. make and insmod both drivers udlfb and adk

   cd adk && make && sudo insmod adk.ko && cd .. && make && insmod udlfb.ko

2. Install Android app from Alpha testing or build from source

3. Attach your device - app opens popus up showing a green screen

Note: You may check the list of supported OEMs here

Starting remote display

Note: The value of X in \dev\fbX should be replaced with value new framebuffer device - appears after setup.

To start xserver on the framebuffer, run,

On PC :
FRAMEBUFFER=/dev/fbX xinit -- /usr/bin/X :1 -config /etc/X11/xorg.conf.fb

On BeagleBone :
FRAMEBUFFER=/dev/fb1 startx -- /usr/bin/X :1

bard-linux's Issues

Merging adk and udlfb driver

Two drivers have to be loaded for the setup to work. Merge the drivers to work seamlessly.

Merging is being kept on hold deliberately until the driver reaches stable stage.

Slow transfer path issue

When the bandwidth is not sufficient enough to send the frame data at the specified rate, a buffer overflow occurs in usb sub-system functions and throws errors. Need to check if they can be fixed from driver or decrease the update rate accordingly.

ADK mode interface details uniform across all devices?

This is a test to check if ADK mode USB descriptors are same for all Android device.

In particular, class, subclass and protocol info for the Accessory interface when device is in ADK mode

VID/PID Database

A few months ago http://usbhost.chainfire.eu/ had a list with vid/pid that support USB Host capabilities. We should find a way to query that data and include it in a .h file so the user does not need to edit the module code.

Now the server is down, maybe contact chainfire on IRC...

Android application not working

Hi,
I installed the android app on my MotoG device, but it crashes as soon as I try to open it. Any ideas on how to resolve this issue?

Compiled code

Please do not push compiled code to GitHub. Keep just the sources here.