User Tools

Site Tools


rpusbdisp_faq

RoboPeak Mini USB Display FAQ

Q1

Q: How to configure Linux Kernel to support RoboPeak Mini USB display?
A: Please make sure following configures has been select in kernel configure menu.

  • framebuffer support (CONFIG_FB=y)
  • deferred io support in framebuffer (CONFIG_FB_DEFERRED_IO=y)
  • fb file operation support
    • CONFIG_FB_CFB_FILLRECT=y
    • CONFIG_FB_CFB_COPYAREA=y
    • CONFIG_FB_CFB_IMAGEBLIT=y
    • CONFIG_FB_SYS_FILLRECT=m
    • CONFIG_FB_SYS_COPYAREA=m
    • CONFIG_FB_SYS_IMAGEBLIT=m
    • CONFIG_FB_SYS_FOPS=m
    • CONFIG_FB_MODE_HELPERS=y
  • Input event support (Generic input layer support)

Refer to https://github.com/robopeak/rpusbdisp for detailed configure and build steps.

Highly recommended to use pre-build ROMs provided by RoboPeak. pre-build ROMs


Q2

Q: How to know the firmware version of RoboPeak Mini USB display. What’s the latest firmware version?
A: Firmware version will be showed in the boot screen. The latest firmware version is 1.04 which boost frame rate a lot by supporting data compression.


Q3

Q: How to customize the start screen of RoboPeak Mini USB display?
A: We provided customization service for the display. Please contact with support@robopeak.org


Q4

Q: How to use RoboPeak Mini USB display in my current system without replacing the rom and compiling the device driver?
A: Yes, it’s possible to use RoboPeak Mini USB display directly in most of systems. We provided approach for Raspberry Pi and Allwinner AX chip based MiniPC devices (Cubieboard/PCDuino/ITeaduino plus A10). Please continue read this FAQ to find your answer.


Q5

Q: How to support RoboPeak Mini USB display for Raspberry Pi?
A: The official kernel of Raspberry Pi doesn't support delayed frame buffer IO feature, so we have to re-compile kernel for it. You can keep all your current application data and settings with replacing kernel and device drivers only.

–Replace Kernel–

Approach #1,Recompile kernel and replace

You can recompile kernel refer to the link: http://elinux.org/RPi_Kernel_Compilation The above approach will keep your application data and settings, but still suggest you backup your system before operation. Please make sure all required kernel module has been selected. Please refer to Q1 for more details.

Approach #2, Replace Linux kernel with the file from RoboPeak provided pre-build ROM

  1. Extract Linux kernel file from RoboPeak provided pre-build ROM.
    1. Write RoboPeak pre-build image to a blank SD card.
    2. Find kernel.img in the first FAT partition. (You can also boot from SD card, kernel.img is under /boot directory)
    3. Save a copy of Kernel.img
  2. Replace Linux Kernel
    1. Mount your own SD card
    2. Replace kernel.img with the one you saved in the previous step. (You can also replace the file under /boot if your system is running)

–Copy Device Drivers–

Now, your kernel is ready. You need to copy RoboPeak Mini USB display related device drivers from RoboPeak pre-build ROM.

  1. Copy RoboPeak Mini USB display driver to your system
    1. Mount RoboPeak pre-build image
    2. Mount rootfs in the second partition. (Assume operation in Linux/Mac OS)
            $ sudo mount /dev/sdd2 /media/sdcard
            Please replace /dev/sdd2 to your SD card device number
  2. Save a copy of the files under lib/modules
         $ cd /media/sdcard
         $ sudo mkdir ~/temp_folde
         $ sudo cp -r lib/modules/* ~/temp_folder/
         $ sudo umount /dev/sdd2
  3. Mount your own SD card and copy the files to the lib/modules directory:
         $ mount /dev/sdd2 /media/sdcard
         $ cd /media/sdcard
         $ sudo cp -r -f ~/temp_folder/* lib/modules/
         $ sudo umount /dev/sdd2

Now, your SD card is ready. It contains all the required kernel file and device drivers. Your application data and settings is kept the same.


Q6

Q: How to support RoboPeak Mini USB display for Allwinner AX chip based MiniPC devices including Cubieboard/PCDuino/ITeaduino plus A10?
A: RoboPeak provided hwpack package for Allwinner AX chip based MiniPC devices. The hwpack package including Linux kernel and required device drivers. You only need to install this hwpack package to your SD card. This approach is not suitable for system installed in NandFlash. Steps (Strongly suggest you backup your system before operation):

  1. Download pre-build hwpack package according to your MiniPC type:miniPC firmware
  2. Insert the SD card with your own system, download update script:
      git clone git://github.com/linux-sunxi/sunxi-bsp.git
  3. Run bellow command to install hwpack package to your SD card:
         $ ./scripts/sunxi-media-create.sh [device] [hwpack] norootfs
         [device]: your SD device name in Linux, e.g. /dev/sdc 
         [hwpack]: the package name you just downloaded. The whole command looks like this:
         $./scripts/sunxi-media-create.sh /dev/sdc hwpack_cubieboardII_rpusbdisp_v2.tar.xz norootfs
         This command will install hwpack package to /dev/sdc.

More information about hwpack, please refer to http://linux-sunxi.org/BSP#Update_an_SD-card_from_a_hwpack


Q7

Q: Why Windows cannot find driver for RoboPeak Mini USB display?/ How to use RoboPeak Mini USB display in Windows?
A: We will publish user mode SDK for Windows/MacOS/Linux soon. You can use RoboPeak Mini USB display then under windows.


Q8

Q: My Raspberry Pi cannot work with RoboPeak Mini USB display anymore after I update my system with raspi-update. Why?
A: raspi-update will replace your Linux kernel back to official version. And the RoboPeak Mini USB display driver is not included in Raspberry Pi official kernel. Please follow Q5 to add RoboPeak Mini USB display support to Raspberry Pi. One tips for raspi-update: you can backup /boot/kernel.img before updating your system and then replace /boot/kernel.img with the saved one after update.


Q9

Q: The X window showed in the RoboPeak Mini USB display is too small to configure IP address. Any other approach to configure IP address?
A: We use DHCP to get IP address in our provided pre-build ROM. You can view the MiniPC’s IP address in your router/gateway’s administrate page. You can also set static IP address follow this article: http://www.cyberciti.biz/tips/howto-ubuntu-linux-convert-dhcp-network-configuration-to-static-ip-configuration.html

You can also use serial port to configure the IP address. Putty/Minicom can be used to login to MiniPC’s serial port command line.

Serial port connection approach for different MiniPC:


Q10

Q: Can video player like omxplayer/mplayer be played on RoboPeak Mini USB display?
A: Yes, omxplayer/mplayer can be used to play video on RoboPeak Mini USB display, but needs some configuration.

Raspberry Pi has hardware video decoder, omxplayer/mplayer will use hardware video decoder to play video by default. Since Raspberry Pi’s hardware decoder only support output the video to HDMI not USB, we need to configure omxplayer/mplayer to use software decoder if you want to play the video on RoboPeak Mini USB display.


Q11

Q: How to show console on RoboPeak Mini USB display (after logout X window)?
A: There’re several approach to do so. Let’s take Raspberry Pi as example:

Approach #1: Edit Linux kernel command line

  1. Edit the cmdline.txt file under /boot
         $ sudo nano /boot/cmdline.txt
  2. Add following line into the file:
         fbcon=font:ProFont6x11 fbcon=map:1
         fbcon=font:ProFont6x11 specify the font will be used in the virtual terminal.
         fbcon=map:1 used to configure virtual terminal to the second framebuffer device
         (/dev/fb1 is the default framebuffer device number for RoboPeak Mini USB display in Raspberry Pi)
  3. Save the change and reboot your Raspberry Pi. Now, you can enter the console when exiting (logout) the X window.

Note: you can also edit this file by inserting the SD card to PC. The cmdline.txt is in SD card’s first FAT partition.

Approach #2: Virtual terminal remap

Open a console under X window or via serial port and type bellow command in the terminal:

     $ sudo con2fbmap 1 1

This command will remap console to the second framebuffer device (/dev/fb1 is the default framebuffer device number for RoboPeak Mini USB display in Raspberry Pi) Then, after you logout X window, the console will show on RoboPeak Mini USB display.


Q12

Q: How to enter console mode directly after booting up? (Raspberry Pi)?
A: Please follow Q11 to configure your system able to show console first. Then follow bellow steps:

For Legacy Raspberry-PI User:

  1. Edit system configure under /etc/init.d/launch_desktop.sh
         $ sudo nano  /etc/init.d/launch_desktop.sh
  2. Comment out bellow statement. (Adding # to the start of the line)
         #su -c startx pi &
  3. Save the change and reboot.

For Raspberry-Pi B+ User:

The new release of the firmware image integrated a script to switch between hdmi and usb display automaticlly, which will launch X when display is connected to or disconnected from pi.

What else you need to do to make the console work is just comment out the following line from the /etc/rc.local: /etc/init.d/rpusbdispd start

rpusbdisp_faq.txt · Last modified: 2015/06/29 12:27 (external edit)