target/loongarch/README

   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/