Skip to content

Commit

Permalink
manual: closes #63, tell to install xc3sprog before flashing
Browse files Browse the repository at this point in the history
fallen committed Jul 4, 2015
1 parent 813a2a2 commit 3471ef8
Showing 1 changed file with 4 additions and 0 deletions.
4 changes: 4 additions & 0 deletions doc/manual/installing.rst
Original file line number Diff line number Diff line change
@@ -51,6 +51,8 @@ You now need to flash 3 things on the FPGA board:
2. The BIOS
3. The ARTIQ runtime

First you need to :ref:`install xc3sprog <install-xc3sprog>`. Then, you can flash the board:

* For the Pipistrello board::

$ artiq_flash.sh -t pipistrello
@@ -122,6 +124,8 @@ These steps are required to generate bitstream (``.bit``) files, build the MiSoC
$ make -j4
$ sudo make install

.. _install-xc3sprog:

* Install JTAG tools needed to program the Pipistrello and KC705:

::

6 comments on commit 3471ef8

@sbourdeauducq
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Many linux distros also package it.

@fallen
Copy link
Contributor Author

@fallen fallen commented on 3471ef8 Jul 4, 2015

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I see archlinux has a "recipe" for it.
But none of Debian, Ubuntu or Fedora have packages for it unfortunately :/

@sbourdeauducq
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

xc3sprog is laden with bugs and some Pipistrello boards fail to flash correctly, as you have noticed. There will be no easy Pipistrello demo until we invest in JTAG tooling (KC705s, on the other hand, seem unaffected by xc3sprog problems).

@sbourdeauducq
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Those problematic boards can be programmed with:
fpgaprog -v -f artiq_pipistrello-nist_qc1-pipistrello.bit -a 170000:bios.bin -b .../fpgaprog-linux/src/bscan_spi_lx45_csg324.bit -sa -r

Of course, the flash proxy bitstream for fpgaprog is not compatible with the one for xc3sprog. Additionally, fpgaprog does not let you flash components separately.

@sbourdeauducq
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The recommended board is KC705, not pipistrello.

@jordens
Copy link
Member

@jordens jordens commented on 3471ef8 Jul 5, 2015

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have added support for jtag-spi, the xilinx chips that we use (most of the xilinx chips should work afaict), and added a much simpler and straight-forward bscan_spi bitstream. If we package something I would like to avoid xc3sprog and fpgaprog. https://github.com/jordens/openocd With that you can also now do smart things like write bios+runtime to flash and then load the bitstream onto the fpga directly.

Please sign in to comment.