Skip to content

About

No description, website, or topics provided.

Resources

Stars

11 stars

Watchers

2 watching

Forks

Repository files navigation

vortex-toolchain-prebuilt

Prebuilt binaries (LLVM, POCL, chipStar, libc/libcrt, riscv-gnu-toolchain, verilator, yosys, sv2v, sta, CIRCT, Foldsim, and optionally SLASH) for the Vortex GPGPU. Pulled by ci/toolchain_install.sh from the Vortex repo via the TOOLCHAIN_REV tag pin.

Installation

$ git clone --depth=1 https://github.com/vortexgpgpu/vortex-toolchain-prebuilt.git

Or use the Vortex repo's installer (recommended):

$ cd vortex && ./configure && cd build && ./ci/toolchain_install.sh --all

Releases

v3.0.2 (2026-11-08, pocl refreshed 2026-11-18)

v3.0.1 plus a new LLVM, the pocl rebuilt on it, and two new tools. The LLVM changes code generation, so instruction and cycle counts move against baselines recorded with v3.0.1. The v3.0.1 tag stays on its 2026-11-02 refresh.

  • LLVM (ubuntu/focal): llvm-vortex rebuilt at vortex_3.x @ f44a6bb2af4c. Adds the XVortex wide loads and stores (vx_flw.d/.q, vx_fsw.d/.q) behind the new +xvortexldstwide target feature, and 64-bit atomics on RV32 register pairs behind +xvortexamod. Also register-group and divergence codegen fixes. A __UNIFORM__ local is promoted to a register instead of being reloaded from the stack. With +xvortex alone no new instruction is emitted. llvm::createLoadStoreVectorizerPass now takes an optional function filter. The rhel/9 bundle is still a81a5957f406.
  • pocl (ubuntu/focal): the same source (vortex_3.x @ 5e06f2f44) and configuration, rebuilt against that LLVM. libpocl now resolves every LLVM symbol it imports. The previous build referenced the old createLoadStoreVectorizerPass() and failed to load under LD_BIND_NOW.
  • pocl refresh (2026-11-18): rebuilt at vortex_3.x @ 471f88096 with the same configuration and LLVM. barrier() and mem_fence() now emit the fence their memory scope needs. atomic_cmpxchg is correct under contention within a warp. atomic_xchg on float and the atom_* names of the cl_khr_*_int32_*_atomics extensions are added. An image's texture descriptor is rewritten only when it changes.
  • CIRCT (new): circt-verilog, circt-opt and firtool from vortexgpgpu/circt vortex_3.x @ 892a65a01. These are the SystemVerilog frontend of the Vortex synthesis flows. They lower processes that drive several interface ports, fold zero-width comparisons, keep RAM initial contents and keep port attributes. libstdc++ is linked statically.
  • Foldsim (new): vortexgpgpu/foldsim @ d8350bc, built on that CIRCT. Ships the foldsim driver, foldsim-opt (Beacon foldsim-estimate-timing and foldsim-estimate-area), foldsim-lift and the FPGA shell (share/foldsim). Install it with toolchain_install.sh --foldsim.
  • SLASH 1.0.0 (optional, manual install): the Alveo V80 userspace (slashkit, VRT, vrtd, v80-smi, headers and CMake configs) from vortexgpgpu/SLASH vortex_3.x @ 720754bb. vrtd no longer writes a design the card already holds, as XRT does for an xclbin: slashkit stamps a UUID into each vbin, vrtd remembers the UUID it wrote, VRT_FORCE_PROGRAM=1 writes anyway, v80-smi forget-design reports a design loaded over JTAG, and a design another client uses cannot be replaced. The daemon's request format and the client libraries' ABI changed while their SONAMEs did not: the daemon and the libraries must come from the same build, and a program built against an earlier SLASH must be rebuilt. Built on Ubuntu 24.04 (glibc 2.38, Python 3.12); not used by CI or toolchain_install.sh. See Vortex docs/xilinx_slash_setup.md.

v3.0.1 (refreshed 2026-11-02)

  • RHEL 9 (rhel/9): new per-OS slot for EL9 hosts (RHEL, Rocky, AlmaLinux, CentOS Stream 9). The ubuntu/focal builds need glibc 2.35 / GLIBCXX_3.4.30 and do not load there. Built natively on RHEL 9.8 (glibc 2.34, GCC 11): llvm-vortex (vortex_3.x @ a81a5957f406, + llvm-spirv), verilator 5.050, yosys 0.69 and sta (OpenSTA 2f6ccdae). The pocl, chipstar and mesa-vortex focal binaries are copied unchanged, because they already fit EL9 and link the rhel/9 LLVM ABI. The Vortex installer reuses the ubuntu/focal riscv-gnu and sv2v bundles for rhel/9. No gem5 bundle.

v3.0.1 (refreshed 2026-10-04)

  • LLVM: llvm-vortex rebuilt at vortex_3.x @ cd5be82eb447: divergence lowering in large kernels, SimplifyCFG/LowerSwitch order, register-group copies, late vector-op legalization.
  • mesa-vortex: rebuilt at vortex_3.x @ a5650eba435 against Vortex master 6f372b0ae (Vulkan ray-tracing pipelines on the RTU).
  • POCL: rebuilt at vortex_3.x @ 5e06f2f44 against Vortex master 6f372b0ae (both XLEN kernel libraries): by-value struct kernel arguments passed inline, single-precision exp in float arithmetic.
  • FireSim and SLASH removed. Both are platform stacks an administrator installs once per machine — like XRT, which was never packaged here — and CI never consumed either. The matching toolchain_install.sh --firesim / --slash flags are gone from the Vortex repo; install instructions live in docs/building_toolchain.md (FireSim) and docs/xilinx_slash_setup.md (SLASH).

v3.0 (2026-05-15)

  • LLVM: LLVM 20.1.8 (Vortex fork, RISC-V + X86 + clang + lld). Bundles llvm-spirv (SPIRV-LLVM-Translator llvm_release_200).
  • POCL: pocl_vortex on top of upstream release_7_0. KMU dispatch model. ENABLE_ICD=ON (ships libpocl.so + libOpenCL.so + pocl.icd). ENABLE_SPIRV=ON.
  • chipStar (new): HIP-on-Vortex via SPIR-V. bin/hipcc, lib/libCHIP.so, lib/llvm/libLLVMHipSpvPasses.so, device-libs.
  • libcrt32/libcrt64: compiler-rt builtins rebuilt against LLVM 20. libcrt64 previously shipped ELF32 .S objects (v2 toolchain defaulted to riscv32 so .S files never got -march=rv64) — now correct ELF64.
  • libc32/libc64: musl v1.2.5 rebuilt against LLVM 20. riscv32 setjmp/longjmp patched fld/fsd → flw/fsw for the ilp32f ABI.

Known limitations

  • chipStar HIP is rv64-only. chipStar's hipcc emits SPIR-V with OpMemoryModel Physical64; POCL checks SPIR-V address bits against the device's address_bits and refuses to compile Physical64 SPIR-V on a 32-bit Vortex device (CL_INVALID_OPERATION: No device in context supports SPIR). HIP works on rv64 (verified: vecadd, sgemm). For HIP on rv32 the upstream chipStar would need a --offload=spirv32 mode, or the native HIPVortex toolchain (see hip_support_proposal.md). OpenCL is fully supported on both XLENs.

v2.3

Prior release (LLVM 21 line, POCL pre-7.0, no chipStar). Kept for users on the v2.x branch.

About

No description, website, or topics provided.

Resources

Stars

11 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors