occheung
/
artiq
forked from M-Labs/artiq
1
0
Fork 0
Code Pull Requests 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 2100a8b1f1
commit d6fea22174
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): ::