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

manual: update firmware/gateware build/flashing instructions. Closes #1223

This commit is contained in:
Sebastien Bourdeauducq 2019-01-05 12:38:54 +08:00
parent 9b081737d4
commit 6020b9c2f1
1 changed files with 7 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
doc/manual/developing.rst
View File

@ -56,7 +56,7 @@ Preparing the build environment for the core device
--------------------------------------------------- ---------------------------------------------------
These steps are required to generate code that can run on the core These steps are required to generate code that can run on the core
device. They are necessary both for building the MiSoC BIOS device. They are necessary both for building the firmware
and the ARTIQ kernels. and the ARTIQ kernels.
* Install required host packages: :: * Install required host packages: ::
@ -226,6 +226,10 @@ These steps are required to generate gateware bitstream (``.bit``) files, build
.. _build-target-binaries: .. _build-target-binaries:
* For Kasli::
$ python3 -m artiq.gateware.targets.kasli -V <your_variant>
* For KC705:: * For KC705::
$ python3 -m artiq.gateware.targets.kc705 -V nist_clock # or nist_qc2 $ python3 -m artiq.gateware.targets.kc705 -V nist_clock # or nist_qc2
@ -234,13 +238,9 @@ These steps are required to generate gateware bitstream (``.bit``) files, build
.. _flash-target-binaries: .. _flash-target-binaries:
* Then, gather the binaries and flash them: :: * Then, flash the binaries: ::
$ mkdir binaries $ artiq_flash --srcbuild artiq_kasli -V <your_variant>
$ cp misoc_nist_qcX_<board>/gateware/top.bit binaries
$ cp misoc_nist_qcX_<board>/software/bios/bios.bin binaries
$ cp misoc_nist_qcX_<board>/software/runtime/runtime.fbi binaries
$ artiq_flash -d binaries
* Check that the board boots by running a serial terminal program (you may need to press its FPGA reconfiguration button or power-cycle it to load the gateware bitstream that was newly written into the flash): :: * Check that the board boots by running a serial terminal program (you may need to press its FPGA reconfiguration button or power-cycle it to load the gateware bitstream that was newly written into the flash): ::