Skip to end of metadata
Go to start of metadata
 Table of Contents



Launching QEMU

Important note: When using purely software rendering in QEMU the GDP HMI will run with a very low frame rate. If you're doing a lot of work with the HMI, you might want to look into using QEMU with hardware graphics acceleration.

It is recommended that you have KVM installed (for example package qemu-kvm) to take advantage of efficient virtualization and graphics acceleration.

To download

  1. Download or build the gdp-<version> .ext4 (or ext4.gz) and corresponding bzImage files
  2. If the rootfs image is compressed, uncompress it.  E.g.:    gunzip <file>.ext4.gz
  3. Start the VM using the command-line (you may need to replace the name of the bzImage and ext4 files)


Example (Ubuntu)

   sudo kvm -kernel bzImage \
-net nic \
-net user,hostfwd=tcp::5555-:22 \
-cpu core2duo \
-hda genivi-dev-platform-qemux86-64.ext4 \
-vga std \
-no-reboot \
-soundhw ac97 \
-m 512 \
--append "vga=0 uvesafb.mode_option=640x480-32 root=/dev/hda rw mem=512M oprofile.timer=1"

On Fedora, the command is named qemu-kvm, and permissions seem to be set up so you don't need sudo/root privileges:

   qemu-kvm -kernel bzImage \
-net nic \
-net user,hostfwd=tcp::5555-:22 \
-cpu core2duo \
-hda genivi-dev-platform-qemux86-64.ext4 \
-vga std \
-no-reboot \
-soundhw ac97 \
-m 512 \
--append "vga=0 uvesafb.mode_option=640x480-32 root=/dev/hda rw mem=512M oprofile.timer=1"

(warning) NOTE: On your distro, the command the qemu command might have different names, "qemu-kvm" or simply "kvm", or "qemu" with a -kvm parameter instead.   Try what works on your distribution.


This command enables the user to ssh into the running image using the command:

ssh root@127.0.0.1 -p 5555 (the password is root)


If you are running an image you have bitbaked you should (from the gdp-src-build directory)

cd tmp/deploy/images/qemux86-64

and then use the above kvm command replacing gdp-<version>.bzImage with bzimage and gdp-<version>.ext4 with genivi-dev-platform-qemux86-64.ext4.

You can configure the root password to change it from the default ('root') by setting the following in local.conf

EXTRA_USERS_PARAMS = "newPassword"

or indeed an empty string.

Limitations and known issues

GDP-110 - Getting issue details... STATUS

GDP-375 - Getting issue details... STATUS

Earlier Instructions (obsolete, but might give some guidance)


GDP-ivi9

 Click here to expand...

Introduction

The purpose of this document is to explain how to quickly setup the hardware and install the GENIVI Dev Platform (GDP) on QEMU (qemux86-64).

Important note: When using purely software rendering in QEMU the GDP HMI will run with a very low frame rate. It is recommended that a KVM is used on the linux host to take advantage of the host hardware graphics acceleration.

Software setup

If you are building from source, ~100GB of storage needs to be available on the host machine

The following is known to work on Ubuntu Linux 14.04 LTS (x86_64)

Quick Start

The Genivi Dev Platform repo utilises git-submodules and source scripts to automate the configuration of the required repository build layers. Allthough this does not fully automate the process, the use of it is advised especially for those wanting to get up and running quickly.

  • Install the required development tools on the host by executing the following command.
    $ sudo apt-get install gawk wget git-core diffstat unzip texinfo gcc-multilib build-essential chrpath socat libsdl1.2-dev xterm
  • Create a directory for the GDP sources
    $ mkdir GDP
    $ cd GDP
    
  • Clone Genivi Dev Platform, specifying 'gdp-ivi9' branch
    $ git clone https://github.com/GENIVI/genivi-dev-platform.git -b gdp-ivi9
  • Initialize build environment
    $ cd $HOME/GDP/genivi-dev-platform
    $ source init.sh qemux86-64
    
  • Bitbake the image
    $ bitbake genivi-dev-platform

Launch QEMU

  • When built from source:
    $ cd $BUILDDIR/tmp/deploy/images/qemux86-64/
  • Install kvm & dependencies
    $ sudo apt-get install qemu-kvm libvirt-bin bridge-utils 
  •  Execute on the host shell(note '-serial stdio' can be added for serial console access): 
sudo kvm -kernel bzImage \
    -net nic,vlan=0 \
    -net tap,vlan=0,ifname=tap0,script=no,downscript=no \
    -cpu core2duo \
    -hda genivi-dev-platform-qemux86-64.ext4 \
    -vga vmware \
    -no-reboot \
    -soundhw ac97 \
    -m 512 \
    --append "vga=0 uvesafb.mode_option=640x480-32 root=/dev/hda rw mem=512M ip=192.168.7.2::192.168.7.1:255.255.255.0 oprofile.timer=1"
  • To get networking running use -net nic -net user,hostfwd=tcp::5555-:22 instead of -net nic, vlan=0

Limitations and Known Issues

  • GDP-166 - Getting issue details... STATUS  The gfx performance has taken a hit since upgrading to weston1.9



GDP-ivi7


 GDP-ivi7

GDP-ivi7 on QEMU

Introduction

The purpose of this document is to explain how to quickly setup the hardware and install the GENIVI Demo Platform (GDP) on QEMU (qemux86-64).

Important note: When using purely software rendering in QEMU the GDP HMI will run with a very low frame rate. It is recommended that a KVM is used on the linux host to take advantage of the host hardware graphics acceleration.

Software setup

If you are building from source, ~60GB of storage needs to be available on the host machine

The following is known to work on Ubuntu Linux 14.04 LTS (x86_64)

Quick Start

The Genivi Demo Platform repo utilises git-submodules and source scripts to automate the configuration of the required repository build layers. Allthough this does not fully automate the process, the use of it is advised especially for those wanting to get up and running quickly.

  • Install the required development tools on the host by executing the following command.
    $ sudo apt-get install gawk wget git-core diffstat unzip texinfo gcc-multilib build-essential chrpath socat libsdl1.2-dev xterm
  • Create a directory for the GDP sources
    $ mkdir GDP
    $ cd GDP
    
  • Clone genivi demo platform using the recursion on QEMU branch
    $ git clone --recursive http://git.projects.genivi.org/genivi-demo-platform.git -b qemux86-64
  • Initialize build environment
    $ cd $HOME/GDP/genivi-demo-platform
    $ source init.sh
    
  • Bitbake the image
    $ bitbake genivi-demo-platform
  • Once built, Setup Software & Boot

    Equipment Setup

    Software prerequisites

    Binary GENIVI Demo Platform image

    1. If you built from source, you should find the binaries in the following directory.
      $ cd $HOME/GDP/gdp-src-build/tmp/deploy/images/qemux86-64/
      

    A remote desktop (VNC) client

    • For example Remmina, the remote desktop client for the GNOME desktop environment
      $ sudo apt-get install remmina
      

    QEMU full system emulation binaries (x86-64)

    • To have the QEMU binaries available on the supported host invoke:
      $ sudo apt-get install qemu-system-x86
      

    Hardware prerequisites

    You need a Personal Computer running Ubuntu Linux 14.04 LTS (x86_64).

    Launch QEMU

    • When built from source:
      $ cd $BUILDDIR/tmp/deploy/images/qemux86-64/
      $ QEMU_AUDIO_DRV=pa; $HOME/GDP/genivi-demo-platform/meta-genivi-demo/scripts/runqemu bzImage-qemux86-64.bin genivi-demo-platform-qemux86-64.ext4 qemuparams="-soundhw ac97"
      

      Note: the $BUILDDIR environment variable is only set after you actually build from source.

    • Start remote desktop (VNC) client and attach to VNC server running on 127.0.0.1:5900
      $ /usr/bin/remmina
      
      1. Create a new Connection (Cltr-n)
      2. Select Protocol: VNC - Virtual Network Computing
      3. Set Server to: 127.0.0.1:5900
      4. and leave the new connection dialog by pushing: Connect
    • A new window is created on your host. It shall display the QEMU booting and executing the GDP.

    To access the shell (ssh)

    • Please run following command on your HOST PC.
      192.168.7.2 is your virtual board's IP address. To login use this credential : Password - root
      $ ssh root@192.168.7.2
      

    To access the shell (serial)

    • In remote desktop (VNC) client change to the serial0 console using Ctrl-Alt-3.
      To login use this credential : User - root / Password - root

    Shutdown QEMU

    • Access the shell (ssh or serial), login as administrator (user: 'root') and issue the command:
      # poweroff
      

    Limitations and Known Issues

      GENIVI Demo Platform is slow, yet running it in a KVM on a linux host can take advantage off hardware graphics acceleration