M-Labs
/
artiq
mirror of https://github.com/m-labs/artiq.git
2
0
Fork 2
Code Issues Projects Releases Wiki Activity

Update manual install instructions.

This commit is contained in:
whitequark 2015-07-26 09:28:11 +03:00
parent aba2d3f112
commit e5acdfe3fd
1 changed files with 25 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

55
doc/manual/installing.rst
View File

@ -99,31 +99,40 @@ These steps are required to generate bitstream (``.bit``) files, build the MiSoC
.. note:: .. note::
The options ``develop`` and ``--user`` are for setup.py to install Migen in ``~/.local/lib/python3.4``. The options ``develop`` and ``--user`` are for setup.py to install Migen in ``~/.local/lib/python3.4``.
* Install OpenRISC GCC/binutils toolchain (or1k-elf-...): :: * Install OpenRISC binutils (or1k-linux-...): ::
$ cd ~/artiq-dev $ cd ~/artiq-dev
$ git clone https://github.com/openrisc/or1k-src $ wget https://ftp.gnu.org/gnu/binutils/binutils-2.25.1.tar.bz2
$ cd or1k-src $ tar xvf binutils-2.25.1.tar.bz2
$ mkdir build $ rm binutils-2.25.1.tar.bz2
$ cd build
$ ../configure --target=or1k-elf --enable-shared --disable-itcl \ $ mkdir binutils-2.25.1/build
--disable-tk --disable-tcl --disable-winsup \ $ cd binutils-2.25.1/build
--disable-gdbtk --disable-libgui --disable-rda \ $ ../configure --target=or1k-linux --prefix=/usr/local
--disable-sid --disable-sim --disable-gdb \
--disable-newlib --disable-libgloss --disable-werror
$ make -j4 $ make -j4
$ sudo make install $ sudo make install
.. note::
We're using an ``or1k-linux`` target because it is necessary to enable
shared library support in ``ld``, not because Linux is involved.
* Install LLVM and Clang: ::
$ cd ~/artiq-dev $ cd ~/artiq-dev
$ git clone https://github.com/openrisc/or1k-gcc $ git clone https://github.com/openrisc/llvm-or1k
$ cd or1k-gcc $ cd llvm-or1k/tools
$ git clone https://github.com/openrisc/clang-or1k clang
$ cd ..
$ mkdir build $ mkdir build
$ cd build $ cd build
$ ../configure --target=or1k-elf --enable-languages=c \ $ cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local/llvm-or1k -DLLVM_TARGETS_TO_BUILD="OR1K;X86" -DCMAKE_BUILD_TYPE=Rel -DLLVM_ENABLE_ASSERTIONS=ON
--disable-shared --disable-libssp
$ make -j4 $ make -j4
$ sudo make install $ sudo make install
.. note::
Compilation of LLVM can take more than 30 min on some machines.
.. _install-xc3sprog: .. _install-xc3sprog:
* Install JTAG tools needed to program the Pipistrello and KC705: * Install JTAG tools needed to program the Pipistrello and KC705:
@ -181,6 +190,7 @@ These steps are required to generate bitstream (``.bit``) files, build the MiSoC
:: ::
$ cd ~/artiq-dev/misoc $ cd ~/artiq-dev/misoc
$ export PATH=$PATH:/usr/local/llvm-or1k/bin
* For Pipistrello:: * For Pipistrello::
@ -279,19 +289,7 @@ To flash the ``idle`` kernel:
Installing the host-side software Installing the host-side software
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
* Install LLVM and the llvmlite Python bindings: :: * Install the llvmlite Python bindings: ::
$ cd ~/artiq-dev
$ git clone https://github.com/openrisc/llvm-or1k
$ cd llvm-or1k/tools
$ git clone https://github.com/openrisc/clang-or1k clang
$ cd ..
$ mkdir build
$ cd build
$ cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local/llvm-or1k -DLLVM_TARGETS_TO_BUILD="OR1K;X86" -DCMAKE_BUILD_TYPE=Debug
$ make -j4
$ sudo make install
$ cd ~/artiq-dev $ cd ~/artiq-dev
$ git clone https://github.com/numba/llvmlite $ git clone https://github.com/numba/llvmlite
@ -304,9 +302,6 @@ Installing the host-side software
.. note:: .. note::
llvmlite is in development and its API is not stable yet. Commit ID ``11a8303d02e3d6dd2d1e0e9065701795cd8a979f`` is known to work. llvmlite is in development and its API is not stable yet. Commit ID ``11a8303d02e3d6dd2d1e0e9065701795cd8a979f`` is known to work.
.. note::
Compilation of LLVM can take more than 30 min on some machines.
* Install ARTIQ: :: * Install ARTIQ: ::
$ cd ~/artiq-dev $ cd ~/artiq-dev