diff --git a/doc/manual/core_device.rst b/doc/manual/core_device.rst index 470935aef..893c199d9 100644 --- a/doc/manual/core_device.rst +++ b/doc/manual/core_device.rst @@ -10,7 +10,7 @@ While it is possible to use all the other parts of ARTIQ (controllers, master, G Flash storage ************* -The core device contains some flash storage space which is largely 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 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`). This area is used to store a variety of configurations, in particular the core device IP address and, if present, the startup and/or idle kernels (see also: :ref:`miscellaneous_config_core_device`). diff --git a/doc/manual/installing.rst b/doc/manual/installing.rst index dfbaeccf8..2a4cb6578 100644 --- a/doc/manual/installing.rst +++ b/doc/manual/installing.rst @@ -192,9 +192,6 @@ Set up the Conda channel and install ARTIQ into a new Conda environment: :: $ conda config --append channels conda-forge $ conda create -n artiq artiq -.. note:: - If you do not need to flash boards, the ``artiq`` package is sufficient. The packages named ``artiq-board-*`` contain only firmware for the FPGA board, and you should not install them unless you are reflashing an FPGA board. - .. note:: On Windows, if the last command that creates and installs the ARTIQ environment fails with an error similar to "seeking backwards is not allowed", try re-running the command with admin rights. @@ -217,19 +214,19 @@ Upgrading ARTIQ When you upgrade ARTIQ, as well as updating the software on your host machine, it may also be necessary to reflash the gateware and firmware of your core device to keep them compatible. New numbered release versions in particular incorporate breaking changes and are not generally compatible. See :ref:`reflashing-core-device` below for instructions on reflashing. Upgrading with Nix -^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^ Run ``$ nix profile upgrade`` if you installed ARTIQ into your user profile. If you used a ``flake.nix`` shell environment, make a back-up copy of the ``flake.lock`` file to enable rollback, then run ``$ nix flake update`` and re-enter the environment with ``$ nix shell``. To rollback to the previous version, respectively use ``$ nix profile rollback`` or restore the backed-up version of the ``flake.lock`` file. Upgrading with MSYS2 -^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^ Run ``pacman -Syu`` to update all MSYS2 packages including ARTIQ. If you get a message telling you that the shell session must be restarted after a partial update, open the shell again after the partial update and repeat the command. See the MSYS2 and Pacman manual for information on how to update individual packages if required. Upgrading with Conda -^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +^^^^^^^^^^^^^^^^^^^^ When upgrading ARTIQ or when testing different versions it is recommended that new Conda environments are created instead of upgrading the packages in existing environments. As a rule, keep previous environments around unless you are certain that they are no longer needed and the new environment is working correctly. @@ -262,6 +259,8 @@ Run the command:: Replace ``[username]`` with the login name that was given to you with the subscription, ``[variant]`` with the name of your system variant, and ``[afws_directory]`` with the name of an empty directory, which will be created by the command if it does not exist. Enter your password when prompted and wait for the build (if applicable) and download to finish. If you experience issues with the AFWS client, write to the helpdesk@ email. +For certain configurations (KC705 or ZC705 only) it is also possible to source firmware from `the M-Labs Hydra server ` (in ``main`` and ``zynq`` respectively). + Without a subscription, you may build the firmware yourself from the open source code. See the section :ref:`Developing ARTIQ `. .. _installing-configuring-openocd: