FE docs

source/hardware/fe.rst

@@ -124,6 +124,24 @@ PCI bracket panel
 The bracket panel of the FE has 8 external SMA connectors for TX/RX/TRX signals.
 
 
+sSDR module connections
+-----------------------
+
+The following schematic diagram shows the connections between the FE board and the sSDR module.
+
+.. image:: ../_static/fe/ssdr_wiring.png
+   :alt: fe ssdr connection diagram
+
+
+dSDR module connections
+-----------------------
+
+The following schematic diagram shows the connections between the FE board and the dSDR module.
+
+.. image:: ../_static/fe/dsdr_wiring.png
+   :alt: fe dsdr connection diagram
+
+
 Clocks and synchronization
 ==========================
 
@@ -151,7 +169,6 @@ The following diagram shows the clock and synchronization wiring when using the
    :alt: fe ssdr clocks and synchronization block diagram
 
 
-
 dSDR wiring
 -----------
 
@@ -221,6 +238,238 @@ Calibration
 The loopback mode is possible for each TX/RX pair for calibration purposes.
 
 
+RF frontend control
+===================
+
+
+.. note::
+   | In order to control the frontend from software, you need to use the ``usdr_registers`` tool.
+   | Please refer to the :doc:`/software/usdr_registers`.
+
+
+exfe10_4ch_usr
+--------------
+
+This section describes the main register map for controlling the FE front-end.
+Using controls on this page, you can switch filters, set attenuators, select antenna paths, and enable/disable channels.
+
+
+.. image:: ../_static/fe/fe_control_usr.png
+   :alt: fe control registers
+
+
+* - ``RX_FILTER_BANK``/``A`` - RX filter bank selector for channel A
+  - Options:
+
+        - ``FILT_400_1000M`` - RX filter 400-1000 MHz
+        - ``FILT_1000_2000M`` - RX filter 1000-2000 MHz
+        - ``FILT_2000_3500M`` - RX filter 2000-3500 MHz
+        - ``FILT_2500_5000M`` - RX filter 2500-5000 MHz
+        - ``FILT_3500_7100M`` - RX filter 3500-7100 MHz
+        - ``AUTO_400_1000M`` - Sets filter automatically by LO frequency / Shows selected filter when in AUTO mode
+        - ``AUTO_1000_2000M`` - Sets filter automatically by LO frequency / Shows selected filter when in AUTO mode
+        - ``AUTO_2000_3500M`` - Sets filter automatically by LO frequency / Shows selected filter when in AUTO mode
+        - ``AUTO_2500_5000M`` - Sets filter automatically by LO frequency / Shows selected filter when in AUTO mode
+        - ``AUTO_3500_7100M`` - Sets filter automatically by LO frequency / Shows selected filter when in AUTO mode
+
+* - ``RX_FILTER_BANK``/``B`` - RX filter bank selector for channel B
+  - Options: same as channel A
+
+* - ``RX_FILTER_BANK``/``C`` - RX filter bank selector for channel C
+  - Options: same as channel A
+
+* - ``RX_FILTER_BANK``/``D`` - RX filter bank selector for channel D
+  - Options: same as channel A
+
+* - ``RX_ATTN``/``A`` - RX attenuator setting (dB) for channel A
+
+* - ``RX_ATTN``/``B`` - RX attenuator setting (dB) for channel B
+
+* - ``RX_ATTN``/``C`` - RX attenuator setting (dB) for channel C
+
+* - ``RX_ATTN``/``D`` - RX attenuator setting (dB) for channel D
+
+* - ``ANT_SEL``/``A`` - Antenna path selector for channel A
+  - Options:
+
+        - ``RX_TO_RX_AND_TX_TO_TRX`` - RX to RX path and TX to TRX path
+        - ``RX_TO_TRX_AND_TX_TERM`` - RX to TRX path and TX terminated
+        - ``RX_TO_RX_AND_TX_TERM`` - RX to RX path and TX terminated
+        - ``RX_TX_LOOPBACK`` - RX to TX loopback
+        - ``TDD_DRIVEN_AUTO`` - Automatic TDD mode
+
+* - ``ANT_SEL``/``B`` - Antenna path selector for channel B
+  - Options: same as channel A
+
+* - ``ANT_SEL``/``C`` - Antenna path selector for channel C
+  - Options: same as channel A
+
+* - ``ANT_SEL``/``D`` - Antenna path selector for channel D
+  - Options: same as channel A
+
+* - ``RX_CHEN``/``A`` - Enable RX channel A
+
+* - ``RX_CHEN``/``B`` - Enable RX channel B
+
+* - ``RX_CHEN``/``C`` - Enable RX channel C
+
+* - ``RX_CHEN``/``D`` - Enable RX channel D
+
+* - ``TX_CHEN``/``A`` - Enable TX channel A
+
+* - ``TX_CHEN``/``B`` - Enable TX channel B
+
+* - ``TX_CHEN``/``C`` - Enable TX channel C
+
+* - ``TX_CHEN``/``D`` - Enable TX channel D
+
+* - ``TX_2STAGE``/``A`` - Enable TX 2nd stage for channel A
+
+* - ``TX_2STAGE``/``B`` - Enable TX 2nd stage for channel B
+
+* - ``TX_2STAGE``/``C`` - Enable TX 2nd stage for channel C
+
+* - ``TX_2STAGE``/``D`` - Enable TX 2nd stage for channel D
+
+
+
+exfe10_4ch_exp
+--------------
+
+This section describes the low level control register map for the FE front-end.
+Using this page, you can control each hardware component directly.
+
+.. warning::
+   | The page exposes the low-level hardware controls.
+   | Improper use may lead to unexpected behavior or damage to your hardware.
+
+.. image:: ../_static/fe/fe_control_exp.png
+   :alt: fe control lowlevel registers
+
+
+* - ``SW_RX_FILTER``/``IN_CHA`` - RX IN filters switch for Channel A
+  - Options:
+
+        - ``MUTE0`` - Mute / Disconnected
+        - ``400_1000M`` - Input filter bank switch to filter 400-1000 MHz
+        - ``1000_2000M`` - Input filter bank switch to filter 1000-2000 MHz
+        - ``2000_3500M`` - Input filter bank switch to filter 2000-3500 MHz
+        - ``2500_5000M`` - Input filter bank switch to filter 2500-5000 MHz
+        - ``3500_7100M`` - Input filter bank switch to filter 3500-7100 MHz
+        - ``MUTE1`` - Mute / Disconnected
+        - ``MUTE2`` - Mute / Disconnected
+
+* - ``SW_RX_FILTER``/``OUT_CHA`` - RX OUT filters switch for Channel A
+  - Options:
+
+        - ``MUTE0`` - Mute / Disconnected
+        - ``400_1000M`` - Output filter bank switch to filter 400-1000 MHz
+        - ``1000_2000M`` - Output filter bank switch to filter 1000-2000 MHz
+        - ``2000_3500M`` - Output filter bank switch to filter 2000-3500 MHz
+        - ``2500_5000M`` - Output filter bank switch to filter 2500-5000 MHz
+        - ``3500_7100M`` - Output filter bank switch to filter 3500-7100 MHz
+        - ``MUTE1`` - Mute / Disconnected
+        - ``MUTE2`` - Mute / Disconnected
+
+* - ``SW_RX_FILTER``/``IN_CHB`` - RX IN filters switch for Channel B
+  - Options: same as Channel A
+
+* - ``SW_RX_FILTER``/``OUT_CHB`` - RX OUT filters switch for Channel B
+  - Options: same as Channel A
+
+* - ``SW_RX_FILTER``/``IN_CHC`` - RX IN filters switch for Channel C
+  - Options: same as Channel A
+
+* - ``SW_RX_FILTER``/``OUT_CHC`` - RX OUT filters switch for Channel C
+  - Options: same as Channel A
+
+* - ``SW_RX_FILTER``/``IN_CHD`` - RX IN filters switch for Channel D
+  - Options: same as Channel A
+
+* - ``SW_RX_FILTER``/``OUT_CHD`` - RX OUT filters switch for Channel D
+  - Options: same as Channel A
+
+* - ``ENABLE``/``IF_VBYP`` - IF bypass control
+
+* - ``ENABLE``/``REF_GPS`` - Enable GPS module
+
+* - ``ENABLE``/``P8V_TX`` - Enable +8V power supply for TX amps
+
+* - ``ENABLE``/``P6V_RX`` - Enable +6V power supply for RX amps
+
+* - ``ENABLE``/``PA_BYPASS_CHD`` - Stage-2 PA bypass, channel D
+
+* - ``ENABLE``/``PA_BYPASS_CHC`` - Stage-2 PA bypass, channel C
+
+* - ``ENABLE``/``PA_BYPASS_CHB`` - Stage-2 PA bypass, channel B
+
+* - ``ENABLE``/``PA_BYPASS_CHA`` - Stage-2 PA bypass, channel A
+
+* - ``LED_TRX_CTRL``/``LED_CHA`` - LED TX/RX control for Channel A
+
+* - ``LED_TRX_CTRL``/``LED_CHB`` - LED TX/RX control for Channel B
+
+* - ``LED_TRX_CTRL``/``LED_CHC`` - LED TX/RX control for Channel C
+
+* - ``LED_TRX_CTRL``/``LED_CHD`` - LED TX/RX control for Channel D
+
+* - ``LEDRX_CH_CTRL``/``EN_CHA`` - Enable LED CHA
+
+* - ``LEDRX_CH_CTRL``/``EN_CHB`` - Enable LED CHB
+
+* - ``LEDRX_CH_CTRL``/``EN_CHC`` - Enable LED CHC
+
+* - ``LEDRX_CH_CTRL``/``EN_CHD`` - Enable LED CHD
+
+* - ``LEDRX_CH_CTRL``/``LED_CHA`` - LED CHA indicator
+
+* - ``LEDRX_CH_CTRL``/``LED_CHB`` - LED CHB indicator
+
+* - ``LEDRX_CH_CTRL``/``LED_CHC`` - LED CHC indicator
+
+* - ``LEDRX_CH_CTRL``/``LED_CHD`` - LED CHD indicator
+
+* - ``P_A_EN_AB``/``B`` - Enable CHB (PA enable AB)
+
+* - ``P_A_EN_AB``/``A`` - Enable CHA (PA enable AB)
+
+* - ``ATTN_RX_CH_AB``/``B`` - Attenuator CHB
+
+* - ``ATTN_RX_CH_AB``/``A`` - Attenuator CHA
+
+* - ``SW_AB``/``TDDFDD_A`` - TDD/FDD control bits (A)
+
+* - ``SW_AB``/``TDDFDD_B`` - TDD/FDD control bits (B)
+
+* - ``SW_AB``/``PA_ON_A`` - PA on control for A
+
+* - ``SW_AB``/``PA_ON_B`` - PA on control for B
+
+* - ``SW_AB``/``RXTX_A`` - RX/TX switch control for A
+
+* - ``SW_AB``/``RXTX_B`` - RX/TX switch control for B
+
+* - ``P_A_EN_CD``/``D`` - Enable CHD (PA enable CD)
+
+* - ``P_A_EN_CD``/``C`` - Enable CHC (PA enable CD)
+
+* - ``ATTN_RX_CH_CD``/``D`` - Attenuator CHD
+
+* - ``ATTN_RX_CH_CD``/``C`` - Attenuator CHC
+
+* - ``SW_CD``/``TDDFDD_C`` - TDD/FDD control bits (C)
+
+* - ``SW_CD``/``TDDFDD_D`` - TDD/FDD control bits (D)
+
+* - ``SW_CD``/``PA_ON_C`` - PA on control for C
+
+* - ``SW_CD``/``PA_ON_D`` - PA on control for D
+
+* - ``SW_CD``/``RXTX_C`` - RX/TX switch control for C
+
+* - ``SW_CD``/``RXTX_D`` - RX/TX switch control for D
+
+
 Software
 ========