From 0c6f6180560c9e51e1098107afe21c7070e8365d Mon Sep 17 00:00:00 2001 From: whitequark Date: Tue, 22 May 2018 18:56:04 +0000 Subject: [PATCH] manual: update to reflect the new artiq_coremgmt tool. --- doc/manual/utilities.rst | 54 +++++++++++++++++++++------------------- 1 file changed, 29 insertions(+), 25 deletions(-) diff --git a/doc/manual/utilities.rst b/doc/manual/utilities.rst index 1a049b94f..bd5ac9b50 100644 --- a/doc/manual/utilities.rst +++ b/doc/manual/utilities.rst @@ -106,62 +106,66 @@ Flashing/Loading tool .. _core-device-configuration-tool: -Core device configuration tool ------------------------------- +Core device management tool +--------------------------- -The artiq_coreconfig utility gives remote access to the :ref:`core-device-flash-storage`. +The artiq_coremgmt utility gives remote access to the core device logs, the :ref:`core-device-flash-storage`, and other management functions. -To use this tool, you need to specify a ``device_db.py`` device database file which contains a ``comm`` device (an example is provided in ``examples/master/device_db.py``). This tells the tool how to connect to the core device and with which parameters (e.g. IP address, TCP port). When not specified, the artiq_coreconfig utility will assume that there is a file named ``device_db.py`` in the current directory. +To use this tool, you need to specify a ``device_db.py`` device database file which contains a ``comm`` device (an example is provided in ``examples/master/device_db.py``). This tells the tool how to connect to the core device and with which parameters (e.g. IP address, TCP port). When not specified, the artiq_coremgmt utility will assume that there is a file named ``device_db.py`` in the current directory. + +To read core device logs:: + + $ artiq_coremgmt log + +To set core device log level and UART log level (possible levels are ``DEBUG``, ``INFO``, ``WARN`` and ``ERROR``):: + + $ artiq_coremgmt log set_level LEVEL + $ artiq_coremgmt log set_uart_level LEVEL + +Note that enabling the ``DEBUG`` 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_coreconfig read mac + $ artiq_coremgmt config read mac To write the value ``test_value`` in the key ``my_key``:: - $ artiq_coreconfig write -s my_key test_value - $ artiq_coreconfig read 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_coreconfig write -f idle_kernel idle.elf - $ artiq_coreconfig read idle_kernel | head -c9 + $ 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_coreconfig write -s key1 value1 -f key2 filename -s key3 value3 + $ artiq_coremgmt config write -s key1 value1 -f key2 filename -s key3 value3 To remove the previously written key ``my_key``:: - $ artiq_coreconfig delete my_key + $ artiq_coremgmt config delete my_key You can remove several keys at once:: - $ artiq_coreconfig delete key1 key2 + $ artiq_coremgmt config delete key1 key2 To erase the entire flash storage area:: - $ artiq_coreconfig erase + $ artiq_coremgmt config erase You do not need to remove a record in order to change its value, just overwrite it:: - $ artiq_coreconfig write -s my_key some_value - $ artiq_coreconfig write -s my_key some_other_value - $ artiq_coreconfig read my_key + $ 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_coreconfig.get_argparser - :prog: artiq_coreconfig - -Core device log download tool ------------------------------ - -.. argparse:: - :ref: artiq.frontend.artiq_corelog.get_argparser - :prog: artiq_corelog + :ref: artiq.frontend.artiq_coremgmt.get_argparser + :prog: artiq_coremgmt .. _core-device-rtio-analyzer-tool: