xref: /openbmc/qemu/target/loongarch/README (revision d2dfe0b5)
1- Introduction
2
3  LoongArch is the general processor architecture of Loongson.
4
5  The following versions of the LoongArch core are supported
6    core: 3A5000
7    https://github.com/loongson/LoongArch-Documentation/releases/download/2021.08.17/LoongArch-Vol1-v1.00-EN.pdf
8
9  We can get the latest loongarch documents at https://github.com/loongson/LoongArch-Documentation/tags.
10
11
12- System emulation
13
14  You can reference docs/system/loongarch/loongson3.rst to get the information about system emulation of LoongArch.
15
16- Linux-user emulation
17
18  We already support Linux user emulation. We can use LoongArch cross-tools to build LoongArch executables on X86 machines,
19  and We can also use qemu-loongarch64 to run LoongArch executables.
20
21  1. Config cross-tools env.
22
23     see System emulation.
24
25  2. Test tests/tcg/multiarch.
26
27     ./configure  --static  --prefix=/usr  --disable-werror --target-list="loongarch64-linux-user" --enable-debug
28
29     cd build
30
31     make && make check-tcg
32
33  3. Run LoongArch system basic command with loongarch-clfs-system.
34
35     - Config clfs env.
36
37       wget https://github.com/loongson/build-tools/releases/download/2022.05.29/loongarch64-clfs-system-5.0.tar.bz2
38
39       tar -vxf loongarch64-clfs-system-5.0.tar.bz2 -C /opt/clfs
40
41       cp /opt/clfs/lib64/ld-linux-loongarch-lp64d.so.1  /lib64
42
43       export LD_LIBRARY_PATH="/opt/clfs/lib64"
44
45     - Run LoongArch system basic command.
46
47       ./qemu-loongarch64  /opt/clfs/usr/bin/bash
48       ./qemu-loongarch64  /opt/clfs/usr/bin/ls
49       ./qemu-loongarch64  /opt/clfs/usr/bin/pwd
50
51- Note.
52  We can get the latest LoongArch documents or LoongArch tools at https://github.com/loongson/
53