Merge branch 'master' into L2SS-406-grafana-archiver

docs/source/devices/recv.rst

+RECV
+====================
+
+The ``recv == DeviceProxy("LTS/RECV/1")`` device controls the RCUs, the LBA antennas, and HBA tiles. Central to its operation are the masks (see also :ref:`attribute-masks`):
+
+:RCU_mask_RW: Controls which RCUs will actually be configured when attributes referring to RCUs are written.
+
+  :type: ``bool[N_RCUs]``
+
+:Ant_mask_RW: Controls which antennas will actually be configured when attributes referring to antennas are written.
+
+  :type: ``bool[N_RCUs][N_antennas_per_RCU]``
+
+Typically, ``N_RCUs == 32``, and ``N_antennas_per_RCU == 3``.
+

docs/source/devices/using.rst

@@ -75,7 +75,7 @@ Most devices provide the following commands, in order to configure the hardware
 
 :initialise_hardware(): For devices that control hardware, this command runs the hardware initialisation procedure.
 
-Typically, ``set_defaults()`` and ``initialise_hardware()`` are called in that order in the ``STANDBY`` state. The :ref:`boot` device runs these commands as part of its station initialsation sequence.
+Typically, ``set_defaults()`` and ``initialise_hardware()`` are called in that order in the ``STANDBY`` state. See also :ref:`boot`, which provides functionality to initialise all the devices.
 
 .. _attributes:
 

docs/source/faq.rst

@@ -7,12 +7,19 @@ Connecting to devices
 My device is unreachable, but the device logs say it's running fine?
 ``````````````````````````````````````````````````````````````````````````````````````````````````````````````
 
-The ``$HOSTNAME`` may have been incorrectly guessed by ``docker-compose/Makefile``, or you accidently set it to an incorrect value. See :ref:`corba`.
+The ``$HOSTNAME`` may have been incorrectly guessed by ``docker-compose/Makefile``, or you accidently set it to an incorrect value. If you have ``$HOSTNAME`` set in the shell running ``make``, try::
+
+  unset HOSTNAME
+  make build
+  make stop
+  make start
+
+If this does not work, you need to set ``$HOSTNAME`` to something that resolves to your machine, both for external parties and for docker containers. See :ref:`corba`.
 
 I get "API_CorbaException: TRANSIENT CORBA system exception: TRANSIENT_NoUsableProfile" when trying to connect to a device?
 ````````````````````````````````````````````````````````````````````````````````````````````````````````````````````````````````
 
-The ``$HOSTNAME`` may have been incorrectly guessed by ``docker-compose/Makefile``, or you accidently set it to an incorrect value. See :ref:`corba`.
+See the previous answer.
 
 Docker
 --------------------------------------------------------------------------------------------------------------

docs/source/index.rst

@@ -19,7 +19,11 @@ Even without having access to any LOFAR2.0 hardware, you can install the full st
    installation
    interfaces/overview
    devices/using
-   devices/devices
+   devices/boot
+   devices/docker
+   devices/recv
+   devices/sdp
+   devices/sst-xst
    devices/configure
    configure_station
    developer