Bash On Windows

Using Windows to develop Litex

Linux runs pretty well on Windows. Well enough to build and use Litex.

Pre-work

You can build Litex on Windows, using the Linux subsystem. To start with, Install Linux on Windows.

You can use Chocolatey as a package manager to install additional software, or you can manually install packages.

To use Bash, you can simply run "bash" from a command prompt, however it is recommended to use ConEmu.

To install Xilinx, install an X server. The preferred server is MobaXTerm.

You will need a terminal client. We use Tera Term.

You will also need a tftp server. Chocolatey has tftpd64.exe.

Install Vivado

Litex uses Vivado. You can do a console-only install, but it's usually easier to use the GUI.

1. Open MobaXTerm
2. Open bash
3. run "export DISPLAY=:0"
4. Follow the Linux instructions. Your Windows files are stored in /mnt/c/ in case you decide to download Vivado under Windows.

The Linux instructions are at Xilinx-Vivado

Install Litex

Download & setup the LiteX Build Environment

$ git clone https://github.com/timvideos/litex-buildenv.git
$ cd litex-buildenv
$ export CPU=or1k PLATFORM=arty TARGET=net
$ ./scripts/download-env.sh
$ source ./scripts/enter-env.sh
(LX P=arty C=or1k) $

You should have "(LX P=arty C=or1k)" in your bash prompt now. NOTE: if you see an error like “bash: lm32-elf-ld: command not found...” you probably forgot to do the exports above. Resuming Development So you walked away and now need to start a new session. Here’s how:

$ cd litex-buildenv
$ export CPU=or1k PLATFORM=arty TARGET=net
$ source ./scripts/enter-env.sh
(LX P=arty C=or1k) $