tree 0fc9929113f3b963807790093bdfe6a8026f013b
parent 8a63981d5afe44bfb5c8c82ba39c055c28818a29
author Miodrag Dinic <miodrag.dinic@imgtec.com> 1421664302 +0100
committer Miodrag Dinic <miodrag.dinic@imgtec.com> 1423131754 +0100

Add MIPS ranchu machine

MIPS "ranchu" machine represents the new virtual
board which will be used for running Android emulation.
It inherits a number of Goldfish devices which are
modified to be used without the Goldfish platform
Bus controller and are installed using the Simple Bus
interface (sysbus_create_simple()).

The advantage of this platform over the old one
is support for Virtio Devices. Ranchu board
supports up to 16 virtio devices which can be
attached using virtio MMIO Bus.

For better overview of the ranchu virtual board
layout, take a look at the following picture :

  ABUS
  ||----MIPS CPU
  ||      |                   IRQs
  ||----Goldfish PIC---------------------(32)------
  ||                    | | | | | | | |         | |
  ||----Goldfish TTY----  | | | | | | |         | |
  ||                      | | | | | | |         | |
  ||----Goldfish RTC------  | | | | | |         | |
  ||                        | | | | | |         | |
  ||----Goldfish Timer------  | | | | |         | |
  ||                          | | | | |         | |
  ||----Goldfish FB-----------  | | | |         | |
  ||                            | | | |         | |
  ||----Goldfish Events---------  | | |         | |
  ||                              | | |         | |
  ||----Goldfish Audio------------  | |         | |
  ||                                | |         | |
  ||----Goldfish Battery------------  |         | |
  ||                                  |         | |
  ||----Android PIPE------------------          | |
  ||                                            | |
  ||----Virtio MMIO Bus                         | |
  ||    |     |    |                            | |
  ||    |     |    Virtio Device (virtio-block)-- |
  ||   (16)   |                                   |
  ||    |    Virtio Device (virtio-net)------------

For booting the board, Ranchu Platform kernel is used:

git clone https://android.googlesource.com/kernel/goldfish.git
git checkout origin/android-goldfish-3.10 -b android-goldfish-3.10

Take look at arch/mips/goldfish.

This is a Goldfish based kernel enriched with Device
Tree support. To build the kernel for the "ranchu" board,
use ranchu64_defconfig for MIPS64R6 configuration.

Device Tree is created on the QEMU side based on the
information about devices IO map and IRQ numbers. DTB
is automatically generated and appended right after
where the kernel is loaded. Kernel will pick up this
DTB and register everything according to the information
provided. It is assumed that the kernel has
CONFIG_MIPS_APPENDED_DTB=y option enabled, otherwise
it will use the built-in device tree which may hold stale
information.

Change-Id: I8344e140dcc70e6cae0e06af4deca75960b93fbc