forked from M-Labs/artiq
doc: Edit of manual reference pages (#2466)
Co-authored-by: architeuthis <am@m-labs.hk>
This commit is contained in:
architeuthidae
parent
9a5ca15b80
commit
ab1aeb136f
@ -40,10 +40,10 @@ def get_argparser():
|
||||
parser = argparse.ArgumentParser(description="ARTIQ CLI client")
|
||||
parser.add_argument(
|
||||
"-s", "--server", default="::1",
|
||||
help="hostname or IP of the master to connect to")
|
||||
help="hostname or IP of the master to connect to (default: %(default)s)")
|
||||
parser.add_argument(
|
||||
"--port", default=None, type=int,
|
||||
help="TCP port to use to connect to the master")
|
||||
help="TCP port to use to connect to the master (default: %(default)s)")
|
||||
parser.add_argument("--version", action="version",
|
||||
version="ARTIQ v{}".format(artiq_version),
|
||||
help="print the ARTIQ version number")
|
||||
@ -59,7 +59,8 @@ def get_argparser():
|
||||
help="priority (higher value means sooner "
|
||||
"scheduling, default: %(default)s)")
|
||||
parser_add.add_argument("-t", "--timed", default=None, type=str,
|
||||
help="set a due date for the experiment")
|
||||
help="set a due date for the experiment "
|
||||
"(default: %(default)s)")
|
||||
parser_add.add_argument("-f", "--flush", default=False,
|
||||
action="store_true",
|
||||
help="flush the pipeline before preparing "
|
||||
|
||||
@ -32,31 +32,28 @@ def get_argparser():
|
||||
help="print the ARTIQ version number")
|
||||
parser.add_argument(
|
||||
"-s", "--server", default="::1",
|
||||
help="hostname or IP of the master to connect to")
|
||||
parser.add_argument(
|
||||
"--port-notify", default=3250, type=int,
|
||||
help="TCP port to connect to for notifications")
|
||||
help="hostname or IP of the master to connect to (default: %(default)s)")
|
||||
parser.add_argument(
|
||||
"--port-control", default=3251, type=int,
|
||||
help="TCP port to connect to for control")
|
||||
help="TCP port to connect to for control (default: %(default)s)")
|
||||
parser.add_argument(
|
||||
"--port-broadcast", default=1067, type=int,
|
||||
help="TCP port to connect to for broadcasts")
|
||||
help="TCP port to connect to for broadcasts (default: %(default)s)")
|
||||
parser.add_argument(
|
||||
"--db-file", default=None,
|
||||
help="database file for local GUI settings")
|
||||
help="database file for local GUI settings (default: %(default)s)")
|
||||
parser.add_argument(
|
||||
"-p", "--load-plugin", dest="plugin_modules", action="append",
|
||||
help="Python module to load on startup")
|
||||
parser.add_argument(
|
||||
"--analyzer-proxy-timeout", default=5, type=float,
|
||||
help="connection timeout to core analyzer proxy")
|
||||
help="connection timeout to core analyzer proxy (default: %(default)s)")
|
||||
parser.add_argument(
|
||||
"--analyzer-proxy-timer", default=5, type=float,
|
||||
help="retry timer to core analyzer proxy")
|
||||
help="retry timer to core analyzer proxy (default: %(default)s)")
|
||||
parser.add_argument(
|
||||
"--analyzer-proxy-timer-backoff", default=1.1, type=float,
|
||||
help="retry timer backoff multiplier to core analyzer proxy")
|
||||
help="retry timer backoff multiplier to core analyzer proxy, (default: %(default)s)")
|
||||
common_args.verbosity_args(parser)
|
||||
return parser
|
||||
|
||||
|
||||
@ -833,7 +833,7 @@ def process(output, primary_description, satellites):
|
||||
processor(peripheral)
|
||||
|
||||
|
||||
def main():
|
||||
def get_argparser():
|
||||
parser = argparse.ArgumentParser(
|
||||
description="ARTIQ device database template builder")
|
||||
parser.add_argument("--version", action="version",
|
||||
@ -847,8 +847,11 @@ def main():
|
||||
default=[], metavar=("DESTINATION", "DESCRIPTION"), type=str,
|
||||
help="add DRTIO satellite at the given destination number with "
|
||||
"devices from the given JSON description")
|
||||
return parser
|
||||
|
||||
args = parser.parse_args()
|
||||
|
||||
def main():
|
||||
args = get_argparser().parse_args()
|
||||
|
||||
primary_description = jsondesc.load(args.primary_description)
|
||||
|
||||
|
||||
@ -30,7 +30,8 @@ Valid actions:
|
||||
* firmware: write firmware to flash
|
||||
* load: load main gateware bitstream into device (volatile but fast)
|
||||
* erase: erase flash memory
|
||||
* start: trigger the target to (re)load its gateware bitstream from flash
|
||||
* start: trigger the target to (re)load its gateware bitstream from flash.
|
||||
If your core device is reachable by network, prefer 'artiq_coremgmt reboot'.
|
||||
|
||||
Prerequisites:
|
||||
|
||||
|
||||
@ -40,21 +40,21 @@ def get_argparser():
|
||||
|
||||
group = parser.add_argument_group("databases")
|
||||
group.add_argument("--device-db", default="device_db.py",
|
||||
help="device database file (default: '%(default)s')")
|
||||
help="device database file (default: %(default)s)")
|
||||
group.add_argument("--dataset-db", default="dataset_db.mdb",
|
||||
help="dataset file (default: '%(default)s')")
|
||||
help="dataset file (default: %(default)s)")
|
||||
|
||||
group = parser.add_argument_group("repository")
|
||||
group.add_argument(
|
||||
"-g", "--git", default=False, action="store_true",
|
||||
help="use the Git repository backend")
|
||||
help="use the Git repository backend (default: %(default)s)")
|
||||
group.add_argument(
|
||||
"-r", "--repository", default="repository",
|
||||
help="path to the repository (default: '%(default)s')")
|
||||
help="path to the repository (default: %(default)s)")
|
||||
group.add_argument(
|
||||
"--experiment-subdir", default="",
|
||||
help=("path to the experiment folder from the repository root "
|
||||
"(default: '%(default)s')"))
|
||||
"(default: %(default)s)"))
|
||||
log_args(parser)
|
||||
|
||||
parser.add_argument("--name",
|
||||
|
||||
@ -8,9 +8,77 @@ While it is possible to use the other parts of ARTIQ (controllers, master, GUI,
|
||||
.. _core-device-flash-storage:
|
||||
|
||||
Flash storage
|
||||
^^^^^^^^^^^^^
|
||||
-------------
|
||||
|
||||
The core device contains some flash storage space which is used to store configuration data. It is one sector (typically 64 kB) large and organized as a list of key-value records, accessible by using ``artiq_coremgmt`` (see :ref:`core-device-management-tool`). The core device IP and MAC addresses, as well as, if present, the startup and/or idle kernels (see :ref:`miscellaneous_config_core_device`) are stored here.
|
||||
The core device contains some flash storage space which is used to store configuration data and the idle/startup kernels. It is one sector (typically 64 kB) large and organized as a list of key-value records, accessible either through ``artiq_mkfs`` and ``artiq_flash`` or (preferable in most cases) the ``config`` option of the ``artiq_coremgmt`` core management tool (see below). Information can be stored to keys of any name, but the specific keys currently used and referenced by ARTIQ are summarized below:
|
||||
|
||||
``idle_kernel``
|
||||
Stores (compiled ``.tar`` or ``.elf`` binary of) idle kernel. See :ref:`miscellaneous_config_core_device`.
|
||||
``startup_kernel``
|
||||
Stores (compiled ``.tar`` or ``.elf`` binary of) startup kernel. See :ref:`miscellaneous_config_core_device`.
|
||||
``ip``
|
||||
Sets IP address of core device. For this and other networking options see also :ref:`core-device-networking`.
|
||||
``mac``
|
||||
Sets MAC address of core device. Unnecessary on Kasli or Kasli-SoC, which can obtain it from EEPROM.
|
||||
``ipv4_default_route``
|
||||
Sets IPv4 default route.
|
||||
``ip6``
|
||||
Sets IPv6 address of core device. Can be set irrespective of and used simultaneously as IPv4 address above.
|
||||
``ipv6_default_route``
|
||||
Sets IPv6 default route.
|
||||
``sed_spread_enable``
|
||||
If set to ``1``, will activate :ref:`sed-event-spreading` in this core device. Needs to be set separately for satellite devices in a DRTIO setting.
|
||||
``log_level``
|
||||
Sets core device log level. Possible levels are ``TRACE``, ``DEBUG``, ``INFO``, ``WARN``, ``ERROR``, and ``OFF``. Note that enabling higher log levels will produce some core device slowdown.
|
||||
``uart_log_level``
|
||||
Sets UART log level, with same options. Printing a large number of messages to UART log will produce a significant slowdown.
|
||||
``rtio_clock``
|
||||
Sets the RTIO clock; see :ref:`core-device-clocking`.
|
||||
``routing_table``
|
||||
Sets the routing table in DRTIO systems; see :ref:`drtio-routing`. If not set, a star topology is assumed.
|
||||
``device_map``
|
||||
If set, allows the core log to connect RTIO channels to device names and use device names as well as channel numbers in log output. A correctly formatted table can be automatically generated with ``artiq_rtiomap``, see :ref:`Utilities<rtiomap-tool>`.
|
||||
``net_trace``
|
||||
If set to ``1``, will activate net trace (print all packets sent and received to UART and core log). This will considerably slow down all network response from the core. Not applicable for ARTIQ-Zynq (Kasli-SoC, ZC706).
|
||||
``panic_reset``
|
||||
If set to ``1``, core device will restart automatically. Not applicable for ARTIQ-Zynq.
|
||||
``no_flash_boot``
|
||||
If set to ``1``, will disable flash boot. Network boot is attempted if possible. Not applicable for ARTIQ-Zynq.
|
||||
``boot``
|
||||
Allows full firmware/gateware (``boot.bin``) to be written with ``artiq_coremgmt``, on ARTIQ-Zynq systems only.
|
||||
|
||||
Common configuration commands
|
||||
-----------------------------
|
||||
|
||||
To write, then read, the value ``test_value`` in the key ``my_key``::
|
||||
|
||||
$ artiq_coremgmt config write -s my_key test_value
|
||||
$ artiq_coremgmt config read my_key
|
||||
b'test_value'
|
||||
|
||||
You do not need to remove a record in order to change its value. Just overwrite it::
|
||||
|
||||
$ artiq_coremgmt config write -s my_key some_value
|
||||
$ artiq_coremgmt config write -s my_key some_other_value
|
||||
$ artiq_coremgmt config read my_key
|
||||
b'some_other_value'
|
||||
|
||||
You can write several records at once::
|
||||
|
||||
$ artiq_coremgmt config write -s key1 value1 -f key2 filename -s key3 value3
|
||||
|
||||
You can also write entire files in a record using the ``-f`` option. This is useful for instance to write the startup and idle kernels into the flash storage::
|
||||
|
||||
$ artiq_coremgmt config write -f idle_kernel idle.elf
|
||||
$ artiq_coremgmt config read idle_kernel | head -c9
|
||||
b'\x7fELF
|
||||
|
||||
The same option is used to write ``boot.bin`` in ARTIQ-Zynq. Note that the ``boot`` key is write-only.
|
||||
|
||||
See also the full reference of ``artiq_coremgmt`` in :ref:`Utilities <core-device-management-tool>`.
|
||||
|
||||
Board details
|
||||
-------------
|
||||
|
||||
FPGA board ports
|
||||
^^^^^^^^^^^^^^^^
|
||||
@ -32,20 +100,20 @@ KC705
|
||||
An alternative target board for the ARTIQ core device is the KC705 development board from Xilinx. It supports the NIST CLOCK and QC2 hardware (FMC).
|
||||
|
||||
Common problems
|
||||
---------------
|
||||
^^^^^^^^^^^^^^^
|
||||
|
||||
* The SW13 switches on the board need to be set to 00001.
|
||||
* When connected, the CLOCK adapter breaks the JTAG chain due to TDI not being connected to TDO on the FMC mezzanine.
|
||||
* On some boards, the JTAG USB connector is not correctly soldered.
|
||||
|
||||
VADJ
|
||||
----
|
||||
""""
|
||||
|
||||
With the NIST CLOCK and QC2 adapters, for safe operation of the DDS buses (to prevent damage to the IO banks of the FPGA), the FMC VADJ rail of the KC705 should be changed to 3.3V. Plug the Texas Instruments USB-TO-GPIO PMBus adapter into the PMBus connector in the corner of the KC705 and use the Fusion Digital Power Designer software to configure (requires Windows). Write to chip number U55 (address 52), channel 4, which is the VADJ rail, to make it 3.3V instead of 2.5V. Power cycle the KC705 board to check that the startup voltage on the VADJ rail is now 3.3V.
|
||||
|
||||
|
||||
NIST CLOCK
|
||||
----------
|
||||
^^^^^^^^^^
|
||||
|
||||
With the CLOCK hardware, the TTL lines are mapped as follows:
|
||||
|
||||
@ -89,7 +157,7 @@ The DDS bus is on channel 27.
|
||||
|
||||
|
||||
NIST QC2
|
||||
--------
|
||||
^^^^^^^^
|
||||
|
||||
With the QC2 hardware, the TTL lines are mapped as follows:
|
||||
|
||||
@ -135,7 +203,7 @@ See :mod:`artiq.coredevice.i2c` for more details.
|
||||
.. _core-device-clocking:
|
||||
|
||||
Clocking
|
||||
^^^^^^^^
|
||||
--------
|
||||
|
||||
The core device generates the RTIO clock using a PLL locked either to an internal crystal or to an external frequency reference. If choosing the latter, external reference must be provided (via front panel SMA input on Kasli boards). Valid configuration options include:
|
||||
|
||||
|
||||
@ -3,30 +3,29 @@ Core drivers reference
|
||||
|
||||
These drivers are for the core device and the peripherals closely integrated into it, which do not use the controller mechanism.
|
||||
|
||||
|
||||
System drivers
|
||||
--------------
|
||||
|
||||
:mod:`artiq.coredevice.core` module
|
||||
+++++++++++++++++++++++++++++++++++
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. automodule:: artiq.coredevice.core
|
||||
:members:
|
||||
|
||||
:mod:`artiq.coredevice.exceptions` module
|
||||
+++++++++++++++++++++++++++++++++++++++++
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. automodule:: artiq.coredevice.exceptions
|
||||
:members:
|
||||
|
||||
:mod:`artiq.coredevice.dma` module
|
||||
++++++++++++++++++++++++++++++++++
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. automodule:: artiq.coredevice.dma
|
||||
:members:
|
||||
|
||||
:mod:`artiq.coredevice.cache` module
|
||||
++++++++++++++++++++++++++++++++++++
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. automodule:: artiq.coredevice.cache
|
||||
:members:
|
||||
@ -36,25 +35,25 @@ Digital I/O drivers
|
||||
-------------------
|
||||
|
||||
:mod:`artiq.coredevice.ttl` module
|
||||
++++++++++++++++++++++++++++++++++
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. automodule:: artiq.coredevice.ttl
|
||||
:members:
|
||||
|
||||
:mod:`artiq.coredevice.edge_counter` module
|
||||
++++++++++++++++++++++++++++++++++++++++++++
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. automodule:: artiq.coredevice.edge_counter
|
||||
:members:
|
||||
|
||||
:mod:`artiq.coredevice.spi2` module
|
||||
+++++++++++++++++++++++++++++++++++
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. automodule:: artiq.coredevice.spi2
|
||||
:members:
|
||||
|
||||
:mod:`artiq.coredevice.i2c` module
|
||||
++++++++++++++++++++++++++++++++++
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. automodule:: artiq.coredevice.i2c
|
||||
:members:
|
||||
@ -63,49 +62,49 @@ RF generation drivers
|
||||
---------------------
|
||||
|
||||
:mod:`artiq.coredevice.urukul` module
|
||||
+++++++++++++++++++++++++++++++++++++
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. automodule:: artiq.coredevice.urukul
|
||||
:members:
|
||||
|
||||
:mod:`artiq.coredevice.ad9910` module
|
||||
+++++++++++++++++++++++++++++++++++++
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. automodule:: artiq.coredevice.ad9910
|
||||
:members:
|
||||
|
||||
:mod:`artiq.coredevice.ad9912` module
|
||||
+++++++++++++++++++++++++++++++++++++
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. automodule:: artiq.coredevice.ad9912
|
||||
:members:
|
||||
|
||||
:mod:`artiq.coredevice.ad9914` module
|
||||
+++++++++++++++++++++++++++++++++++++
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. automodule:: artiq.coredevice.ad9914
|
||||
:members:
|
||||
|
||||
:mod:`artiq.coredevice.mirny` module
|
||||
+++++++++++++++++++++++++++++++++++++
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. automodule:: artiq.coredevice.mirny
|
||||
:members:
|
||||
|
||||
:mod:`artiq.coredevice.almazny` module
|
||||
++++++++++++++++++++++++++++++++++++++
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. automodule:: artiq.coredevice.almazny
|
||||
:members:
|
||||
|
||||
:mod:`artiq.coredevice.adf5356` module
|
||||
+++++++++++++++++++++++++++++++++++++++
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. automodule:: artiq.coredevice.adf5356
|
||||
:members:
|
||||
|
||||
:mod:`artiq.coredevice.phaser` module
|
||||
+++++++++++++++++++++++++++++++++++++
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. automodule:: artiq.coredevice.phaser
|
||||
:members:
|
||||
@ -114,37 +113,37 @@ DAC/ADC drivers
|
||||
---------------
|
||||
|
||||
:mod:`artiq.coredevice.ad53xx` module
|
||||
+++++++++++++++++++++++++++++++++++++
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. automodule:: artiq.coredevice.ad53xx
|
||||
:members:
|
||||
|
||||
:mod:`artiq.coredevice.zotino` module
|
||||
+++++++++++++++++++++++++++++++++++++
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. automodule:: artiq.coredevice.zotino
|
||||
:members:
|
||||
|
||||
:mod:`artiq.coredevice.sampler` module
|
||||
++++++++++++++++++++++++++++++++++++++
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. automodule:: artiq.coredevice.sampler
|
||||
:members:
|
||||
|
||||
:mod:`artiq.coredevice.novogorny` module
|
||||
++++++++++++++++++++++++++++++++++++++++
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. automodule:: artiq.coredevice.novogorny
|
||||
:members:
|
||||
|
||||
:mod:`artiq.coredevice.fastino` module
|
||||
++++++++++++++++++++++++++++++++++++++++
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. automodule:: artiq.coredevice.fastino
|
||||
:members:
|
||||
|
||||
:mod:`artiq.coredevice.shuttler` module
|
||||
++++++++++++++++++++++++++++++++++++++++
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. automodule:: artiq.coredevice.shuttler
|
||||
:members:
|
||||
@ -154,14 +153,14 @@ Miscellaneous
|
||||
-------------
|
||||
|
||||
:mod:`artiq.coredevice.suservo` module
|
||||
++++++++++++++++++++++++++++++++++++++
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. automodule:: artiq.coredevice.suservo
|
||||
:members:
|
||||
|
||||
|
||||
:mod:`artiq.coredevice.grabber` module
|
||||
++++++++++++++++++++++++++++++++++++++
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. automodule:: artiq.coredevice.grabber
|
||||
:members:
|
||||
|
||||
@ -7,18 +7,21 @@ The most commonly used features from the ARTIQ language modules and from the cor
|
||||
---------------------------------
|
||||
|
||||
.. automodule:: artiq.language.core
|
||||
:member-order: bysource
|
||||
:members:
|
||||
|
||||
:mod:`artiq.language.environment` module
|
||||
----------------------------------------
|
||||
|
||||
.. automodule:: artiq.language.environment
|
||||
:member-order: bysource
|
||||
:members:
|
||||
|
||||
:mod:`artiq.language.scan` module
|
||||
----------------------------------------
|
||||
|
||||
.. automodule:: artiq.language.scan
|
||||
:member-order: bysource
|
||||
:members:
|
||||
|
||||
:mod:`artiq.language.units` module
|
||||
|
||||
@ -9,6 +9,7 @@ These are the top-level commands used to run and manage ARTIQ experiments. Not a
|
||||
.. argparse::
|
||||
:ref: artiq.frontend.artiq_run.get_argparser
|
||||
:prog: artiq_run
|
||||
:nodefault:
|
||||
|
||||
.. _frontend-artiq-master:
|
||||
|
||||
@ -18,6 +19,7 @@ These are the top-level commands used to run and manage ARTIQ experiments. Not a
|
||||
.. argparse::
|
||||
:ref: artiq.frontend.artiq_master.get_argparser
|
||||
:prog: artiq_master
|
||||
:nodefault:
|
||||
|
||||
.. _frontend-artiq-client:
|
||||
|
||||
@ -27,6 +29,7 @@ These are the top-level commands used to run and manage ARTIQ experiments. Not a
|
||||
.. argparse::
|
||||
:ref: artiq.frontend.artiq_client.get_argparser
|
||||
:prog: artiq_client
|
||||
:nodefault:
|
||||
|
||||
|
||||
.. _frontend-artiq-dashboard:
|
||||
@ -37,7 +40,7 @@ These are the top-level commands used to run and manage ARTIQ experiments. Not a
|
||||
.. argparse::
|
||||
:ref: artiq.frontend.artiq_dashboard.get_argparser
|
||||
:prog: artiq_dashboard
|
||||
|
||||
:nodefault:
|
||||
|
||||
:mod:`artiq.frontend.artiq_session`
|
||||
-----------------------------------
|
||||
@ -45,3 +48,4 @@ These are the top-level commands used to run and manage ARTIQ experiments. Not a
|
||||
.. argparse::
|
||||
:ref: artiq.frontend.artiq_session.get_argparser
|
||||
:prog: artiq_session
|
||||
:nodefault:
|
||||
|
||||
@ -3,25 +3,43 @@ Utilities
|
||||
|
||||
.. Sort these tool by some subjective combination of their
|
||||
typical sequence and expected frequency of use.
|
||||
|
||||
ARTIQ Firmware Service (AFWS) client
|
||||
------------------------------------
|
||||
|
||||
This tool serves as a client for building tailored firmware and gateware from M-Lab's servers and downloading the binaries in ready-to-flash format. It is necessary to have a valid subscription to AFWS to use it. Subscription also includes general helpdesk support and can be purchased or extended by contacting ``sales@``. One year of support is included with any Kasli carriers or crates containing them purchased from M-Labs. Additional one-time use is generally provided with purchase of additional cards to facilitate the system configuration change.
|
||||
|
||||
.. argparse::
|
||||
:ref: artiq.frontend.afws_client.get_argparser
|
||||
:prog: afws_client
|
||||
:nodescription:
|
||||
:nodefault:
|
||||
|
||||
passwd
|
||||
.. warning::
|
||||
After receiving your credentials from M-Labs, it is recommended to change your password as soon as possible. It is your responsibility to set and remember a secure password. If necessary, passwords can be reset by contacting helpdesk@.
|
||||
|
||||
Static compiler
|
||||
---------------
|
||||
|
||||
This tool compiles an experiment into a ELF file. It is primarily used to prepare binaries for the default experiment loaded in non-volatile storage of the core device.
|
||||
Experiments compiled with this tool are not allowed to use RPCs, and their ``run`` entry point must be a kernel.
|
||||
This tool compiles an experiment into a ELF file. It is primarily used to prepare binaries for the startup and idle kernels, loaded in non-volatile storage of the core device. Experiments compiled with this tool are not allowed to use RPCs, and their ``run`` entry point must be a kernel.
|
||||
|
||||
.. argparse::
|
||||
:ref: artiq.frontend.artiq_compile.get_argparser
|
||||
:prog: artiq_compile
|
||||
:nodescription:
|
||||
:nodefault:
|
||||
|
||||
Flash storage image generator
|
||||
-----------------------------
|
||||
|
||||
This tool compiles key/value pairs into a binary image suitable for flashing into the flash storage space of the core device.
|
||||
This tool compiles key/value pairs (e.g. configuration information) into a binary image suitable for flashing into the storage space of the core device. It can be used in combination with ``artiq_flash`` to configure the core device, but this is normally necessary at most to set the ``ip`` field; once the core device is reachable by network it is preferable to use ``artiq_coremgmt config``.
|
||||
|
||||
.. argparse::
|
||||
:ref: artiq.frontend.artiq_mkfs.get_argparser
|
||||
:prog: artiq_mkfs
|
||||
:nodescription:
|
||||
:nodefault:
|
||||
|
||||
.. _flashing-loading-tool:
|
||||
|
||||
@ -31,69 +49,22 @@ Flashing/Loading tool
|
||||
.. argparse::
|
||||
:ref: artiq.frontend.artiq_flash.get_argparser
|
||||
:prog: artiq_flash
|
||||
:nodefault:
|
||||
|
||||
.. _core-device-management-tool:
|
||||
|
||||
Core device management tool
|
||||
---------------------------
|
||||
|
||||
The artiq_coremgmt utility gives remote access to the core device logs, the :ref:`core-device-flash-storage`, and other management functions.
|
||||
The core management utility gives remote access to the core device logs, the :ref:`core-device-flash-storage`, and other management functions.
|
||||
|
||||
To use this tool, it is necessary to specify the IP address your core device can be contacted at. If no option is used, the utility will assume there is a file named ``device_db.py`` in the current directory containing the device database; otherwise, a device database file can be provided with ``--device-db`` or an address directly with ``--device`` (see also below).
|
||||
|
||||
To read core device logs::
|
||||
|
||||
$ artiq_coremgmt log
|
||||
|
||||
To set core device log level and UART log level (possible levels are ``TRACE``, ``DEBUG``, ``INFO``, ``WARN`` and ``ERROR``)::
|
||||
|
||||
$ artiq_coremgmt log set_level LEVEL
|
||||
$ artiq_coremgmt log set_uart_level LEVEL
|
||||
|
||||
Note that enabling the ``TRACE`` log level results in small core device slowdown, and printing large amounts of log messages to the UART results in significant core device slowdown.
|
||||
|
||||
To read the record whose key is ``mac``::
|
||||
|
||||
$ artiq_coremgmt config read mac
|
||||
|
||||
To write the value ``test_value`` in the key ``my_key``::
|
||||
|
||||
$ artiq_coremgmt config write -s my_key test_value
|
||||
$ artiq_coremgmt config read my_key
|
||||
b'test_value'
|
||||
|
||||
You can also write entire files in a record using the ``-f`` parameter. This is useful for instance to write the startup and idle kernels in the flash storage::
|
||||
|
||||
$ artiq_coremgmt config write -f idle_kernel idle.elf
|
||||
$ artiq_coremgmt config read idle_kernel | head -c9
|
||||
b'\x7fELF
|
||||
|
||||
You can write several records at once::
|
||||
|
||||
$ artiq_coremgmt config write -s key1 value1 -f key2 filename -s key3 value3
|
||||
|
||||
To remove the previously written key ``my_key``::
|
||||
|
||||
$ artiq_coremgmt config remove my_key
|
||||
|
||||
You can remove several keys at once::
|
||||
|
||||
$ artiq_coremgmt config remove key1 key2
|
||||
|
||||
To erase the entire flash storage area::
|
||||
|
||||
$ artiq_coremgmt config erase
|
||||
|
||||
You do not need to remove a record in order to change its value, just overwrite it::
|
||||
|
||||
$ artiq_coremgmt config write -s my_key some_value
|
||||
$ artiq_coremgmt config write -s my_key some_other_value
|
||||
$ artiq_coremgmt config read my_key
|
||||
b'some_other_value'
|
||||
|
||||
.. argparse::
|
||||
:ref: artiq.frontend.artiq_coremgmt.get_argparser
|
||||
:prog: artiq_coremgmt
|
||||
:nodescription:
|
||||
:nodefault:
|
||||
|
||||
Core device logging controller
|
||||
------------------------------
|
||||
@ -101,6 +72,23 @@ Core device logging controller
|
||||
.. argparse::
|
||||
:ref: artiq.frontend.aqctl_corelog.get_argparser
|
||||
:prog: aqctl_corelog
|
||||
:nodefault:
|
||||
|
||||
Device database template generator
|
||||
----------------------------------
|
||||
|
||||
.. argparse::
|
||||
:ref: artiq.frontend.artiq_ddb_template.get_argparser
|
||||
:prog: artiq_ddb_template
|
||||
:nodefault:
|
||||
|
||||
ARTIQ RTIO monitor
|
||||
------------------
|
||||
|
||||
.. argparse::
|
||||
:ref: artiq.frontend.artiq_rtiomon.get_argparser
|
||||
:prog: artiq_rtiomon
|
||||
:nodefault:
|
||||
|
||||
Moninj proxy
|
||||
------------
|
||||
@ -108,6 +96,7 @@ Moninj proxy
|
||||
.. argparse::
|
||||
:ref: artiq.frontend.aqctl_moninj_proxy.get_argparser
|
||||
:prog: aqctl_moninj_proxy
|
||||
:nodefault:
|
||||
|
||||
.. _rtiomap-tool:
|
||||
|
||||
@ -117,29 +106,33 @@ RTIO channel name map tool
|
||||
.. argparse::
|
||||
:ref: artiq.frontend.artiq_rtiomap.get_argparser
|
||||
:prog: artiq_rtiomap
|
||||
|
||||
:nodefault:
|
||||
|
||||
.. _core-device-rtio-analyzer-tool:
|
||||
|
||||
Core device RTIO analyzer tool
|
||||
------------------------------
|
||||
|
||||
:mod:`~artiq.frontend.artiq_coreanalyzer` is a tool to convert core device RTIO logs to VCD waveform files that are readable by third-party tools such as GtkWave. This tool extracts pre-recorded data from an ARTIQ core device buffer (or from a file with the ``-r`` option), and converts it to a standard VCD file format. See :ref:`rtio-analyzer-example` for an example, or :mod:`artiq.test.coredevice.test_analyzer` for a relevant unit test.
|
||||
This tool converts core device RTIO logs to VCD waveform files that are readable by third-party tools such as GtkWave. See :ref:`rtio-analyzer-example` for an example, or ``artiq.test.coredevice.test_analyzer`` for a relevant unit test. When using the ARTIQ dashboard, recorded data can be viewed or exported directly in the integrated waveform analyzer (the "Waveform" dock).
|
||||
|
||||
.. argparse::
|
||||
:ref: artiq.frontend.artiq_coreanalyzer.get_argparser
|
||||
:prog: artiq_coreanalyzer
|
||||
:nodescription:
|
||||
:nodefault:
|
||||
|
||||
.. _routing-table-tool:
|
||||
|
||||
Core device RTIO analyzer proxy
|
||||
-------------------------------
|
||||
|
||||
:mod:`~artiq.frontend.aqctl_coreanalyzer_proxy` is a tool to distribute the core analyzer dump to several clients such as the dashboard.
|
||||
This tool distributes the core analyzer dump to several clients such as the dashboard.
|
||||
|
||||
.. argparse::
|
||||
:ref: artiq.frontend.aqctl_coreanalyzer_proxy.get_argparser
|
||||
:prog: aqctl_coreanalyzer_proxy
|
||||
:nodescription:
|
||||
:nodefault:
|
||||
|
||||
DRTIO routing table manipulation tool
|
||||
-------------------------------------
|
||||
@ -147,3 +140,4 @@ DRTIO routing table manipulation tool
|
||||
.. argparse::
|
||||
:ref: artiq.frontend.artiq_route.get_argparser
|
||||
:prog: artiq_route
|
||||
:nodefault:
|
||||
|
||||
Loading…
Reference in New Issue
Block a user