diff --git a/docs/CrossCompile.md b/docs/CrossCompile.md index 49a2774b04..03a1cc85ff 100644 --- a/docs/CrossCompile.md +++ b/docs/CrossCompile.md @@ -8,3 +8,39 @@ A painless guide for cross compilation (or to test NCE) from a x86_64 system wit - Download Debian 13: `wget https://cdimage.debian.org/debian-cd/current/arm64/iso-cd/debian-13.0.0-arm64-netinst.iso` - Create a system disk: `qemu-img create -f qcow2 debian-13-arm64-ci.qcow2 30G` - Run the VM: `qemu-system-aarch64 -M virt -m 2G -cpu max -bios /usr/local/share/qemu/edk2-aarch64-code.fd -drive if=none,file=debian-13.0.0-arm64-netinst.iso,format=raw,id=cdrom -device scsi-cd,drive=cdrom -drive if=none,file=debian-13-arm64-ci.qcow2,id=hd0,format=qcow2 -device virtio-blk-device,drive=hd0 -device virtio-gpu-pci -device usb-ehci -device usb-kbd -device intel-hda -device hda-output -nic user,model=virtio-net-pci` + +## PowerPC + +This is a guide for FreeBSD users mainly. + +Now you got a PowerPC sysroot - quickly decompress it somewhere, say `/home/user/opt/powerpc64le`. + +```sh +fetch https://download.freebsd.org/ftp/releases/powerpc/powerpc64le/14.3-RELEASE/base.txz +mkdir -p ~/opt/powerpc64le/sysroot +mkdir -p ~/opt/powerpc64le/staging +cd ~/opt/powerpc64le/sysroot +tar -xvzf base.txz +``` + +Create a toolchain file, for example `powerpc64le-toolchain.cmake`; always [consult the manual](https://man.freebsd.org/cgi/man.cgi?query=cmake-toolchains&sektion=7&manpath=FreeBSD+13.2-RELEASE+and+Ports). + +```sh +set(CMAKE_SYSROOT "$ENV{HOME}/opt/powerpc64le/sysroot") +set(CMAKE_STAGING_PREFIX "$ENV{HOME}/opt/powerpc64le/sysroot") + +set(CMAKE_C_COMPILER /usr/bin/clang) +set(CMAKE_CXX_COMPILER /usr/bin/clang++) +set(CMAKE_C_FLAGS "--target=ppc64le-pc-freebsd") +set(CMAKE_CXX_FLAGS "--target=ppc64le-pc-freebsd") + +set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER) +set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY) +set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY) +set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY) +``` + +Specify: +- `YUZU_USE_CPM`: Set this to `ON` so packages can be found and built if your sysroot doesn't have them. +- `YUZU_USE_EXTERNAL_FFMPEG`: Set this to `ON` as well. +