RISC-V (Linux)

Juliaは、Linuxを実行する64ビットRISC-V(RV64)プロセッサを実験的にサポートしています。このファイルでは、特定のデバイス向けの手順に加えて、コンパイルに関する一般的なガイドラインを説明します。

RISC-V向けのknown issuesの一覧を参照できます。問題が発生した場合は、cat /proc/cpuinfoの出力を添えてissueを作成してください。

Compiling Julia

RISC-V向けにJuliaをコンパイルするには、対象とするアーキテクチャと、必要に応じてCPUを手動で指定する必要があります。これは、Make.userでMARCH変数とMCPU変数を設定して行います。

MARCH変数には、RISC-V ISA文字列を設定する必要があります。これは、デバイスのドキュメントを確認するか、/proc/cpuinfoを調べることで確認できます。コンパイラがサポートするフラグのみを使用してください。たとえば、gcc -march=helpを実行すると、サポートされているフラグの一覧を確認できます。一般的な値はrv64gcで、設定の出発点として適しています。

MCPU変数は省略可能で、特定のCPU向けに生成コードをさらに最適化するために使用できます。判断がつかない場合は、設定しないことをおすすめします。gcc --target-helpを実行すると、サポートされている値の一覧を確認できます。

たとえば、SiFive U74をベースとするJH7110プロセッサを搭載したStarFive VisionFive2を使用している場合は、次のようにフラグを設定できます。

MARCH := rv64gc_zba_zbb
MCPU := sifive-u74

移植性を重視したビルドにする場合は、次のように設定できます。

MARCH := rv64gc

# also set JULIA_CPU_TARGET to the expanded form of rv64gc
# (it normally copies the value of MCPU, which we don't set)
JULIA_CPU_TARGET := generic-rv64,i,m,a,f,d,zicsr,zifencei,c

Cross-compilation

RISC-Vデバイス上でネイティブビルドを行うと非常に時間がかかる場合があります。そのため、より高速なマシンでJuliaをクロスコンパイルすることもできます。

まず、C、C++、FortranをサポートするRISC-Vクロスコンパイルツールチェーンを用意します。riscv-gnu-toolchainリポジトリをチェックアウトし、次のようにビルドします。

sudo mkdir /opt/riscv && sudo chown $USER /opt/riscv
./configure --prefix=/opt/riscv --with-languages=c,c++,fortran
make linux -j$(nproc)

次に、RISC-V用のQEMUユーザーモードエミュレーターをインストールし、ホストマシン上でRISC-Vバイナリを実行できるようにbinfmtのサポートも有効にします。具体的な手順はディストリビューションによって異なります。たとえばArch Linuxでは、qemu-user-staticパッケージとqemu-user-static-binfmtパッケージをインストールします。RISC-Vバイナリを実際に実行するには、QEMUがRISC-Vのシステムルートを見つけられる必要があります。ルートファイルシステムのパスをQEMU_LD_PREFIX環境変数に設定すると、見つけられるようになります。

最後に、前のセクションで設定した変数に加えて、次のMake.user変数を指定してJuliaをコンパイルします。

XC_HOST=riscv64-unknown-linux-gnu
OS=Linux
export QEMU_LD_PREFIX=/opt/riscv/sysroot

クロスコンパイルツールチェーンを含むようにPATHを設定してから、makeを実行する必要があります。たとえば、次のように実行します。

PATH=/opt/riscv/bin:$PATH make -j$(nproc)

使用するRISC-Vのsysrootは非常に最小限の構成であるため、Juliaのビルドシステムがシステム全体に存在することを前提としているライブラリを追加する必要がある場合があります。たとえば、現在のビルドではシステム提供のlibzに依存しているため、このライブラリをJuliaのビルドからシステムルートにコピーする必要がある場合があります。

make -C deps install-zlib
cp -v usr/lib/libz.*   /opt/riscv/sysroot/usr/lib
cp -v usr/include/z*.h /opt/riscv/sysroot/usr/include