mirrors/u-boot
1
0
Fork 0
mirror of https://source.denx.de/u-boot/u-boot.git synced 2026-05-05 04:36:13 +02:00
Code Issues Actions Packages Projects Releases Wiki Activity

doc: New documentation for qemu-xtensa

Browse Source 
Introduce the board and provide instructions on how to get
it work.

Tested-by: Max Filippov <jcmvbkbc@gmail.com>
Signed-off-by: Jiaxun Yang <jiaxun.yang@flygoat.com>
This commit is contained in:
Jiaxun Yang 2024-06-18 14:56:10 +01:00 committed by Tom Rini
parent 206ad6c7b0
commit 8363c876f6
2 changed files with 34 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
doc/board/emulation/index.rst
View File

@ -14,3 +14,4 @@ Emulation
qemu-ppce500
qemu-riscv
qemu-x86
qemu-xtensa

33
doc/board/emulation/qemu-xtensa.rst Normal file
View File

@ -0,0 +1,33 @@
.. SPDX-License-Identifier: GPL-2.0+
.. Copyright (C) 2024 Jiaxun Yang <jiaxun.yang@flygoat.com>
QEMU Xtensa
===========
QEMU for Xtensa supports a special 'virt' machine designed for emulation and
virtualization purposes. This document describes how to run U-Boot under it.
The QEMU virt machine models a generic Xtensa virtual machine with PCI Bus
and Xtensa ISS simcall semihosting support. It supports many different Xtensa
CPU configuration. Currently, only dc233c variant is tested against U-Boot.
Building U-Boot
---------------
Set the CROSS_COMPILE environment variable as usual, and run:
make qemu-xtensa-dc233c_defconfig
make
Note that Xtensa's toolchain is bounded to CPU configuration, you must use
the toolchain built for exactly the same CPU configuration as you selected
in U-Boot.
Running U-Boot
--------------
The minimal QEMU command line to get U-Boot up and running is:
qemu-system-xtensa -nographic -machine virt -cpu dc233c -semihosting -kernel ./u-boot.elf
You many change cpu option to match your U-Boot CPU type configuration.
semihosting option is mandatory because this is the only way to interact
with U-Boot in command line.