From 24d4de45c22170ff2ce3eaad9bf88e0dac3e9c57 Mon Sep 17 00:00:00 2001
From: ths <ths@c046a42c-6fe2-441c-8c8c-71466251a162>
Date: Wed, 11 Jul 2007 10:24:28 +0000
Subject: [PATCH] Documentation update for MIPS.

git-svn-id: svn://svn.savannah.nongnu.org/qemu/trunk@3056 c046a42c-6fe2-441c-8c8c-71466251a162
---
 qemu-doc.texi  | 80 ++++++++++++++++++++++++++++++++++++++------------
 qemu-tech.texi | 26 ++++++++++++++++
 2 files changed, 87 insertions(+), 19 deletions(-)

diff --git a/qemu-doc.texi b/qemu-doc.texi
index cc530d659..e42aad8aa 100644
--- a/qemu-doc.texi
+++ b/qemu-doc.texi
@@ -1559,11 +1559,11 @@ differences are mentioned in the following sections.
 
 @menu
 * QEMU PowerPC System emulator::
-* Sparc32 System emulator invocation::
-* Sparc64 System emulator invocation::
-* MIPS System emulator invocation::
-* ARM System emulator invocation::
-* ColdFire System emulator invocation::
+* Sparc32 System emulator::
+* Sparc64 System emulator::
+* MIPS System emulator::
+* ARM System emulator::
+* ColdFire System emulator::
 @end menu
 
 @node QEMU PowerPC System emulator
@@ -1631,8 +1631,8 @@ Set the initial VGA graphic mode. The default is 800x600x15.
 More information is available at
 @url{http://perso.magic.fr/l_indien/qemu-ppc/}.
 
-@node Sparc32 System emulator invocation
-@section Sparc32 System emulator invocation
+@node Sparc32 System emulator
+@section Sparc32 System emulator
 
 Use the executable @file{qemu-system-sparc} to simulate a SparcStation 5
 or SparcStation 10 (sun4m architecture). The emulation is somewhat complete.
@@ -1698,8 +1698,8 @@ Set the emulated machine type. Default is SS-5.
 
 @c man end 
 
-@node Sparc64 System emulator invocation
-@section Sparc64 System emulator invocation
+@node Sparc64 System emulator
+@section Sparc64 System emulator
 
 Use the executable @file{qemu-system-sparc64} to simulate a Sun4u machine.
 The emulator is not usable for anything yet.
@@ -1717,26 +1717,68 @@ Non Volatile RAM M48T59
 PC-compatible serial ports
 @end itemize
 
-@node MIPS System emulator invocation
-@section MIPS System emulator invocation
+@node MIPS System emulator
+@section MIPS System emulator
 
 Use the executable @file{qemu-system-mips} to simulate a MIPS machine.
-The emulator is able to boot a Linux kernel and to run a Linux Debian
-installation from NFS. The following devices are emulated:
+Three different machine types are emulated:
+
+@itemize @minus
+@item
+A generic ISA PC-like machine "mips"
+@item
+The MIPS Malta prototype board "malta"
+@item
+An ACER Pica "pica61"
+@end itemize
+
+The generic emulation is supported by Debian 'Etch' and is able to
+install Debian into a virtual disk image. The following devices are
+emulated:
 
 @itemize @minus
 @item 
-MIPS R4K CPU
+MIPS 24Kf CPU
 @item
 PC style serial port
 @item
+PC style IDE disk
+@item
 NE2000 network card
 @end itemize
 
-More information is available in the QEMU mailing-list archive.
+The Malta emulation supports the following devices:
+
+@itemize @minus
+@item
+Core board with MIPS 24Kf CPU and Galilleo system controller
+@item
+PIIX4 PCI/USB/SMbus controller
+@item
+The Multi-I/O chip's serial device
+@item
+PCnet32 PCI network card
+@item
+Malta FPGA serial device
+@item
+Cirrus VGA graphics card
+@end itemize
+
+The ACER Pica emulation supports:
+
+@itemize @minus
+@item
+MIPS R4000 CPU
+@item
+PC-style IRQ and DMA controllers
+@item
+PC Keyboard
+@item
+IDE controller
+@end itemize
 
-@node ARM System emulator invocation
-@section ARM System emulator invocation
+@node ARM System emulator
+@section ARM System emulator
 
 Use the executable @file{qemu-system-arm} to simulate a ARM
 machine. The ARM Integrator/CP board is emulated with the following
@@ -1844,8 +1886,8 @@ WM8750 audio CODEC on I@math{^2}C and I@math{^2}S busses
 A Linux 2.6 test image is available on the QEMU web site. More
 information is available in the QEMU mailing-list archive.
 
-@node ColdFire System emulator invocation
-@section ColdFire System emulator invocation
+@node ColdFire System emulator
+@section ColdFire System emulator
 
 Use the executable @file{qemu-system-m68k} to simulate a ColdFire machine.
 The emulator is able to boot a uClinux kernel.
diff --git a/qemu-tech.texi b/qemu-tech.texi
index fc72ff1b6..45949547e 100644
--- a/qemu-tech.texi
+++ b/qemu-tech.texi
@@ -35,6 +35,7 @@
 * intro_features::        Features
 * intro_x86_emulation::   x86 emulation
 * intro_arm_emulation::   ARM emulation
+* intro_mips_emulation::  MIPS emulation
 * intro_ppc_emulation::   PowerPC emulation
 * intro_sparc_emulation:: SPARC emulation
 @end menu
@@ -152,6 +153,31 @@ maximum performances.
 
 @end itemize
 
+@node intro_mips_emulation
+@section MIPS emulation
+
+@itemize
+
+@item The system emulation allows full MIPS32/MIPS64 Release 2 emulation,
+including privileged instructions, FPU and MMU, in both little and big
+endian modes.
+
+@item The Linux userland emulation can run many 32 bit MIPS Linux binaries.
+
+@end itemize
+
+Current QEMU limitations:
+
+@itemize
+
+@item Self-modifying code is not always handled correctly.
+
+@item 64 bit userland emulation is not implemented.
+
+@item The system emulation is not complete enough to run real firmware.
+
+@end itemize
+
 @node intro_ppc_emulation
 @section PowerPC emulation
 
-- 
2.39.2