RoboPeak Mini USB Display Driver for Odroid U3 - Ubuntu 14.04 LTS by Mr_KrzYch00,
http://www.robopeak.com/blog/?p=406
320x240 16bpp (RGB16) - one-touchscreen

Compilled using kernel 3.8.13.23


How to install driver:
1. Download it to Your home directory.
2. Open terminal and type:
   sudo install rp_usbdisplay.ko "/lib/modules/`uname -r`/kernel/rp_usbdisplay.ko"
   sudo depmod -a
3. Connect Your RoboPeak Display to USB (You can even use USB extension cable)
4. Again run in terminal:
   sudo modprobe rp_usbdisplay
   OR
   sudo modprobe rp_usbdisplay fps=25 (or other frame rate default: 16)
5. After this Your screen should turn blank, if it does, You successfully installed driver!
6. Check cat /proc/fb to see what ID Your display has.
7. Test Your display if it shows random dots every 3 seconds by running (abort using CTRL+C):
while true; do `dd if=/dev/urandom bs=512 count=300 of=/dev/fb1 status=noxfer &>/dev/null`; sleep 1; done;


Additional configuration and test with links2:
1. Edit (create if doesn't exist) file /etc/directfbrc
2. Add these lines:

fbdev=/dev/fb1
mode=320x240
pixelformat=RGB16

3. Recheck if /dev/fb1 corresponds to Your RoboPeak display ID (installing driver, point 6).
4. Edit file /etc/fb.modes by adding at the end of file (not sure if it's necessary but just for compatibility):

mode "320x240"
    geometry 320 240 320 240 16
    timings 0 0 0 0 0 0 0
endmode

4. After this You can test it by installing links2 and running
   links2 -g -mode 320x240 www.4my.eu
5. If the page is displayed on full screen and You can use touchscreen to navigate then Your display is working properly.


Running X11 on display:
 (please note that I will not provide support for full Graphic Environment, just running one GUI window without titlebar and stuff.
  That's because it's pointless to run full GUI on such small screen in my opinion.)

1. Navigate to Your RP Usbdisplay sourcecode directory then drivers/linux-driver/xserver_conf
2. Edit 10-disp.conf to point to Your /dev/fb device, for me it was /dev/fb1
3. Copy it to /usr/share/X11/xorg.conf.d (not sure if that's really necessary but I did that just incase)
4. Log in with putty to Your odroid or use console and type:
FRAMEBUFFER=/dev/fb1 startx -- -dpi 48 &
OR
FRAMEBUFFER=/dev/fb1 X -dpi 48 > /dev/null 2>&1 &
5. Display should turn blank. Now You are successfully running X11 on Your RoboPeak USB Display
6. Increase dpi in case of unreadable text.


Calibrate display:
1. Make sure You are running X11 on Your display, by running in console:
   ps aufx | grep X
2. Read the display port, for example: /usr/bin/X :0 means it's :0
3. Map display using console:
   export DISPLAY=:0
4. In console or putty type:
  apt-get install xinput-calibrator
  xinput_calibrator
5. Calibrate Your touch screen by pressing on screen in marked places - I recommend using old smartphone pen instead of finger.


Run a brogram:
1. Make sure You are running X11 on Your display, by followin steps 1-3 in Calibrate display,
2. Run in Your console or putty: xterm
3. If command line showed on Your RoboPeak USB Display then You are successfully running an aplication in X11 in Framebuffer,
4. You can run some script like Odroid U3 temp measurements by running for example: xterm /home/odroid/temp.sh
5. You can even run firefox by just typing that word. Adding addition space and & symbol You can run it in the background.


Making Firefox more useful on this display:
1. Open firefox and download Classic Theme Restorer Add-on (I recommend doing it through HDMI display, X11 forwarding or VNC),
2. Browse through Classic Theme Restorer settings till You get all taskbars disabled and have tabs hiding when there is only one open,
3. Set zoom out level for some webpage by doing ctrl scroll down or minus, I use the minimum 30%, because the display is too small.
4. Additionally You can download and install Default FullZoom Level addon and set desired default zoom for all pages.


Use additional remote VNC in case of no keyboard connected:
1. Run putty,
2. apt-get install x11vnc
3. export DISPLAY=:0 (replace :0 with the number of display Your screen is using)
4. x11vnc OR x11vnc &
5. Connect to Your Odroid using VNC client (WARNING! no password protection),
6. Use Your local computer mouse and keyboard in VNC client window to do what You need and close x11vnc.


How to display static image on Your display:
1. You need RAW image file being 320x240 pixels, 16bpp color depth,
2. Make sure it's exactly 150KB in size,
3. Run cat image.raw > /dev/fb1 (make sure the screen is fb1).


Run Movie using VLC media player:
1. First Open VLC media player using X11 Forwarding or HDMI display,
2. Go to Tools->Preferences,
3. Show settings -> All,
4. Interface->Main interfaces->Qt->check Start in minimal view (without menus),
5. Video->check Fullscreen video output, Save and Close VLC,
6. In putty (make sure DISPLAY is exported to point RoboPeak USB Display) type for example vlc somemoviefile.avi.

NOTES:
I failed to run mplayer properly using directFB driver (without X11!). It can't get correct color space.
The driver doesn't install itself on boot to not cause any problems by accident, so You need to run
modprobe rp_usbdisplay
after booting. To install driver by default, please refer to other Ubuntu based articles.
This display uses 12mbps USB speed and normal vlc is not DirectFB optimised so playing movies can a bit laggy...

- Driver (unmodified) compilled by Mr_KrzYch00


~~~~
KrzY