324b2298fe
Apart from targets.rst, which was written by hand, this is an automated
conversion obtained with the following command:
makeinfo --force -o - --docbook \
-D 'qemu_system_x86 QEMU_SYSTEM_X86_MACRO' \
-D 'qemu_system QEMU_SYSTEM_MACRO' \
$texi | pandoc -f docbook -t rst+smart | perl -e '
$/=undef;
$_ = <>;
s/^- − /- /gm;
s/QEMU_SYSTEM_MACRO/|qemu_system|/g;
s/QEMU_SYSTEM_X86_MACRO/|qemu_system_x86|/g;
s/(?=::\n\n +\|qemu)/.. parsed-literal/g;
s/:\n\n::$/::/gm;
print' > $rst
In addition, the following changes were made manually:
- target-i386.rst and target-mips.rst: replace CPU model documentation with
an include directive
- monitor.rst: replace the command section with a comment
- images.rst: add toctree
- target-arm.rst: Replace use of :math: (which Sphinx complains
about) with :sup:, and hide it behind |I2C| and |I2C| substitutions.
Content that is not @included remains exclusive to qemu-doc.texi.
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
Reviewed-by: Peter Maydell <peter.maydell@linaro.org>
Reviewed-by: Alex Bennée <alex.bennee@linaro.org>
Tested-by: Alex Bennée <alex.bennee@linaro.org>
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Message-id: 20200228153619.9906-20-peter.maydell@linaro.org
Message-id: 20200226113034.6741-19-pbonzini@redhat.com
[PMM: Fixed target-arm.rst use of :math:; remove out of date
note about images.rst from commit message; fixed expansion
of |qemu_system_x86|; use parsed-literal in invocation.rst
when we want to use |qemu_system_x86|; fix incorrect subsection
level for "OS requirements" in target-i386.rst; fix incorrect
syntax for making links to other sections of the manual]
Reviewed-by: Peter Maydell <peter.maydell@linaro.org>
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
121 lines
2.9 KiB
ReStructuredText
121 lines
2.9 KiB
ReStructuredText
.. _MIPS-System-emulator:
|
|
|
|
MIPS System emulator
|
|
--------------------
|
|
|
|
Four executables cover simulation of 32 and 64-bit MIPS systems in both
|
|
endian options, ``qemu-system-mips``, ``qemu-system-mipsel``
|
|
``qemu-system-mips64`` and ``qemu-system-mips64el``. Five different
|
|
machine types are emulated:
|
|
|
|
- A generic ISA PC-like machine \"mips\"
|
|
|
|
- The MIPS Malta prototype board \"malta\"
|
|
|
|
- An ACER Pica \"pica61\". This machine needs the 64-bit emulator.
|
|
|
|
- MIPS emulator pseudo board \"mipssim\"
|
|
|
|
- A MIPS Magnum R4000 machine \"magnum\". This machine needs the
|
|
64-bit emulator.
|
|
|
|
The generic emulation is supported by Debian 'Etch' and is able to
|
|
install Debian into a virtual disk image. The following devices are
|
|
emulated:
|
|
|
|
- A range of MIPS CPUs, default is the 24Kf
|
|
|
|
- PC style serial port
|
|
|
|
- PC style IDE disk
|
|
|
|
- NE2000 network card
|
|
|
|
The Malta emulation supports the following devices:
|
|
|
|
- Core board with MIPS 24Kf CPU and Galileo system controller
|
|
|
|
- PIIX4 PCI/USB/SMbus controller
|
|
|
|
- The Multi-I/O chip's serial device
|
|
|
|
- PCI network cards (PCnet32 and others)
|
|
|
|
- Malta FPGA serial device
|
|
|
|
- Cirrus (default) or any other PCI VGA graphics card
|
|
|
|
The Boston board emulation supports the following devices:
|
|
|
|
- Xilinx FPGA, which includes a PCIe root port and an UART
|
|
|
|
- Intel EG20T PCH connects the I/O peripherals, but only the SATA bus
|
|
is emulated
|
|
|
|
The ACER Pica emulation supports:
|
|
|
|
- MIPS R4000 CPU
|
|
|
|
- PC-style IRQ and DMA controllers
|
|
|
|
- PC Keyboard
|
|
|
|
- IDE controller
|
|
|
|
The MIPS Magnum R4000 emulation supports:
|
|
|
|
- MIPS R4000 CPU
|
|
|
|
- PC-style IRQ controller
|
|
|
|
- PC Keyboard
|
|
|
|
- SCSI controller
|
|
|
|
- G364 framebuffer
|
|
|
|
The Fulong 2E emulation supports:
|
|
|
|
- Loongson 2E CPU
|
|
|
|
- Bonito64 system controller as North Bridge
|
|
|
|
- VT82C686 chipset as South Bridge
|
|
|
|
- RTL8139D as a network card chipset
|
|
|
|
The mipssim pseudo board emulation provides an environment similar to
|
|
what the proprietary MIPS emulator uses for running Linux. It supports:
|
|
|
|
- A range of MIPS CPUs, default is the 24Kf
|
|
|
|
- PC style serial port
|
|
|
|
- MIPSnet network emulation
|
|
|
|
.. include:: cpu-models-mips.rst.inc
|
|
|
|
.. _nanoMIPS-System-emulator:
|
|
|
|
nanoMIPS System emulator
|
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Executable ``qemu-system-mipsel`` also covers simulation of 32-bit
|
|
nanoMIPS system in little endian mode:
|
|
|
|
- nanoMIPS I7200 CPU
|
|
|
|
Example of ``qemu-system-mipsel`` usage for nanoMIPS is shown below:
|
|
|
|
Download ``<disk_image_file>`` from
|
|
https://mipsdistros.mips.com/LinuxDistro/nanomips/buildroot/index.html.
|
|
|
|
Download ``<kernel_image_file>`` from
|
|
https://mipsdistros.mips.com/LinuxDistro/nanomips/kernels/v4.15.18-432-gb2eb9a8b07a1-20180627102142/index.html.
|
|
|
|
Start system emulation of Malta board with nanoMIPS I7200 CPU::
|
|
|
|
qemu-system-mipsel -cpu I7200 -kernel <kernel_image_file> \
|
|
-M malta -serial stdio -m <memory_size> -hda <disk_image_file> \
|
|
-append "mem=256m@0x0 rw console=ttyS0 vga=cirrus vesa=0x111 root=/dev/sda"
|