vivado-on-silicon-mac

Adapted from https://github.com/ichi4096/vivado-on-silicon-mac

Setup

git submodules

git submodule update --init

Install Docker

1. Install Docker Desktop on Mac

2. Open Docker:

open -a docker

Install Vitis

1. Build Docker image:

make docker

2. Download Vitis installer 2025.2 or Vitis installer 2025.1 or Vitis installer 2024.2 and save it to the repo folder.

3. Install Vitis:

make VERSION=2025.2 Xilinx.img

If this step is interrupted or fails, remove Xilinx.img and try again.

Build xvcd

brew install libftdi

(cd xvcd && make)

---

Usage

Launch xvcd for JTAG over FTDI

./xvcd/bin/xvcd -v

Launch Vivado

make VERSION=2025.2 vivado

Launch Vitis

make VERSION=2025.2 vitis

Program the on-board FTDI chip

Install Docker Desktop >= 4.35.0

Then,

pip install libusb1

(cd pyusbip && python pyusbip.py)

In the container,

sudo nsenter -t 1 -m

usbip list -r host.docker.internal

usbip attach -r host.docker.internal -b 1-1

lsusb

exit

program_ftdi -write -ftdi FT2232H -serial 0ABC01 -vendor "my vendor co" -board "my board" -desc "my product desc"

---

References

• https://github.com/ichi4096/vivado-on-silicon-mac
• https://docs.docker.com/desktop/features/usbip/
• ichi4096/vivado-on-silicon-mac#52

---

Issues

Vitis may hang while using

Attempt to fix (does not work).

Modify vitis script (/tools/Xilinx/2025.1/Vitis/bin/vitis):

# $XILINX_VITIS/ide/electron-app/lnx64/vitis-ide --no-sandbox --log-level=debug $workspace_path ${analyzeArgs[@]} > /dev/null 2>&1 &
$XILINX_VITIS/ide/electron-app/lnx64/vitis-ide --no-sandbox --log-level=debug --disable-gpu --disable-software-rasterizer $workspace_path ${analyzeArgs[@]}

• ichi4096/vivado-on-silicon-mac#37
• https://www.reddit.com/r/FPGA/comments/z2gqk2/vitis_hls_closing_immediately/
• https://adaptivesupport.amd.com/s/question/0D54U000091FX0XSAW/vitis-no-longer-opening-ubuntu-2404-vitis-20242?language=en_US
• https://www.hackster.io/whitney-knitter/fix-for-vitis-unified-2023-2-launching-into-blank-screen-4ab565
• electron/electron#10345
• https://stackoverflow.com/questions/42898262/run-dbus-daemon-inside-docker-container