docs/system: convert Texinfo documentation to rST
[qemu.git] / docs / system / target-arm.rst
1 .. _ARM-System-emulator:
2
3 ARM System emulator
4 -------------------
5
6 Use the executable ``qemu-system-arm`` to simulate a ARM machine. The
7 ARM Integrator/CP board is emulated with the following devices:
8
9 -  ARM926E, ARM1026E, ARM946E, ARM1136 or Cortex-A8 CPU
10
11 -  Two PL011 UARTs
12
13 -  SMC 91c111 Ethernet adapter
14
15 -  PL110 LCD controller
16
17 -  PL050 KMI with PS/2 keyboard and mouse.
18
19 -  PL181 MultiMedia Card Interface with SD card.
20
21 The ARM Versatile baseboard is emulated with the following devices:
22
23 -  ARM926E, ARM1136 or Cortex-A8 CPU
24
25 -  PL190 Vectored Interrupt Controller
26
27 -  Four PL011 UARTs
28
29 -  SMC 91c111 Ethernet adapter
30
31 -  PL110 LCD controller
32
33 -  PL050 KMI with PS/2 keyboard and mouse.
34
35 -  PCI host bridge. Note the emulated PCI bridge only provides access
36    to PCI memory space. It does not provide access to PCI IO space. This
37    means some devices (eg. ne2k_pci NIC) are not usable, and others (eg.
38    rtl8139 NIC) are only usable when the guest drivers use the memory
39    mapped control registers.
40
41 -  PCI OHCI USB controller.
42
43 -  LSI53C895A PCI SCSI Host Bus Adapter with hard disk and CD-ROM
44    devices.
45
46 -  PL181 MultiMedia Card Interface with SD card.
47
48 Several variants of the ARM RealView baseboard are emulated, including
49 the EB, PB-A8 and PBX-A9. Due to interactions with the bootloader, only
50 certain Linux kernel configurations work out of the box on these boards.
51
52 Kernels for the PB-A8 board should have CONFIG_REALVIEW_HIGH_PHYS_OFFSET
53 enabled in the kernel, and expect 512M RAM. Kernels for The PBX-A9 board
54 should have CONFIG_SPARSEMEM enabled, CONFIG_REALVIEW_HIGH_PHYS_OFFSET
55 disabled and expect 1024M RAM.
56
57 The following devices are emulated:
58
59 -  ARM926E, ARM1136, ARM11MPCore, Cortex-A8 or Cortex-A9 MPCore CPU
60
61 -  ARM AMBA Generic/Distributed Interrupt Controller
62
63 -  Four PL011 UARTs
64
65 -  SMC 91c111 or SMSC LAN9118 Ethernet adapter
66
67 -  PL110 LCD controller
68
69 -  PL050 KMI with PS/2 keyboard and mouse
70
71 -  PCI host bridge
72
73 -  PCI OHCI USB controller
74
75 -  LSI53C895A PCI SCSI Host Bus Adapter with hard disk and CD-ROM
76    devices
77
78 -  PL181 MultiMedia Card Interface with SD card.
79
80 The XScale-based clamshell PDA models (\"Spitz\", \"Akita\", \"Borzoi\"
81 and \"Terrier\") emulation includes the following peripherals:
82
83 -  Intel PXA270 System-on-chip (ARM V5TE core)
84
85 -  NAND Flash memory
86
87 -  IBM/Hitachi DSCM microdrive in a PXA PCMCIA slot - not in \"Akita\"
88
89 -  On-chip OHCI USB controller
90
91 -  On-chip LCD controller
92
93 -  On-chip Real Time Clock
94
95 -  TI ADS7846 touchscreen controller on SSP bus
96
97 -  Maxim MAX1111 analog-digital converter on |I2C| bus
98
99 -  GPIO-connected keyboard controller and LEDs
100
101 -  Secure Digital card connected to PXA MMC/SD host
102
103 -  Three on-chip UARTs
104
105 -  WM8750 audio CODEC on |I2C| and |I2S| busses
106
107 The Palm Tungsten|E PDA (codename \"Cheetah\") emulation includes the
108 following elements:
109
110 -  Texas Instruments OMAP310 System-on-chip (ARM 925T core)
111
112 -  ROM and RAM memories (ROM firmware image can be loaded with
113    -option-rom)
114
115 -  On-chip LCD controller
116
117 -  On-chip Real Time Clock
118
119 -  TI TSC2102i touchscreen controller / analog-digital converter /
120    Audio CODEC, connected through MicroWire and |I2S| busses
121
122 -  GPIO-connected matrix keypad
123
124 -  Secure Digital card connected to OMAP MMC/SD host
125
126 -  Three on-chip UARTs
127
128 Nokia N800 and N810 internet tablets (known also as RX-34 and RX-44 /
129 48) emulation supports the following elements:
130
131 -  Texas Instruments OMAP2420 System-on-chip (ARM 1136 core)
132
133 -  RAM and non-volatile OneNAND Flash memories
134
135 -  Display connected to EPSON remote framebuffer chip and OMAP on-chip
136    display controller and a LS041y3 MIPI DBI-C controller
137
138 -  TI TSC2301 (in N800) and TI TSC2005 (in N810) touchscreen
139    controllers driven through SPI bus
140
141 -  National Semiconductor LM8323-controlled qwerty keyboard driven
142    through |I2C| bus
143
144 -  Secure Digital card connected to OMAP MMC/SD host
145
146 -  Three OMAP on-chip UARTs and on-chip STI debugging console
147
148 -  Mentor Graphics \"Inventra\" dual-role USB controller embedded in a
149    TI TUSB6010 chip - only USB host mode is supported
150
151 -  TI TMP105 temperature sensor driven through |I2C| bus
152
153 -  TI TWL92230C power management companion with an RTC on
154    |I2C| bus
155
156 -  Nokia RETU and TAHVO multi-purpose chips with an RTC, connected
157    through CBUS
158
159 The Luminary Micro Stellaris LM3S811EVB emulation includes the following
160 devices:
161
162 -  Cortex-M3 CPU core.
163
164 -  64k Flash and 8k SRAM.
165
166 -  Timers, UARTs, ADC and |I2C| interface.
167
168 -  OSRAM Pictiva 96x16 OLED with SSD0303 controller on
169    |I2C| bus.
170
171 The Luminary Micro Stellaris LM3S6965EVB emulation includes the
172 following devices:
173
174 -  Cortex-M3 CPU core.
175
176 -  256k Flash and 64k SRAM.
177
178 -  Timers, UARTs, ADC, |I2C| and SSI interfaces.
179
180 -  OSRAM Pictiva 128x64 OLED with SSD0323 controller connected via
181    SSI.
182
183 The Freecom MusicPal internet radio emulation includes the following
184 elements:
185
186 -  Marvell MV88W8618 ARM core.
187
188 -  32 MB RAM, 256 KB SRAM, 8 MB flash.
189
190 -  Up to 2 16550 UARTs
191
192 -  MV88W8xx8 Ethernet controller
193
194 -  MV88W8618 audio controller, WM8750 CODEC and mixer
195
196 -  128x64 display with brightness control
197
198 -  2 buttons, 2 navigation wheels with button function
199
200 The Siemens SX1 models v1 and v2 (default) basic emulation. The
201 emulation includes the following elements:
202
203 -  Texas Instruments OMAP310 System-on-chip (ARM 925T core)
204
205 -  ROM and RAM memories (ROM firmware image can be loaded with
206    -pflash) V1 1 Flash of 16MB and 1 Flash of 8MB V2 1 Flash of 32MB
207
208 -  On-chip LCD controller
209
210 -  On-chip Real Time Clock
211
212 -  Secure Digital card connected to OMAP MMC/SD host
213
214 -  Three on-chip UARTs
215
216 A Linux 2.6 test image is available on the QEMU web site. More
217 information is available in the QEMU mailing-list archive.
218
219 The following options are specific to the ARM emulation:
220
221 ``-semihosting``
222    Enable semihosting syscall emulation.
223
224    On ARM this implements the \"Angel\" interface.
225
226    Note that this allows guest direct access to the host filesystem, so
227    should only be used with trusted guest OS.