feat(linux): Add CPSW Proxy Client documentation for AM62PX

The CPSW3G instance of CPSW on the AM62P SoC supports Native Ethernet by
default where Linux running on A53 configures CPSW3G. An alternative to
this is that of CPSW3G being configured by Ethernet Switch Firmware
(EthFw) running on R5. The CPSW Proxy Client driver in Linux interfaces
with EthFw to enable Ethernet functionality in the alternate configuration.
EthFw enables Ethernet traffic sharing among various cores on the SoC.

Signed-off-by: Siddharth Vadapalli <[email protected]>

Author: Siddharth-Vadapalli-at-TI

configs/AM62PX/AM62PX_linux_toc.txt

@@ -57,6 +57,8 @@ linux/Foundational_Components/Kernel/Kernel_Drivers/MCAN
 linux/Foundational_Components/Kernel/Kernel_Drivers/MCRC64
 linux/Foundational_Components/Kernel/Kernel_Drivers/Network/CPSW-Ethernet
 linux/Foundational_Components/Kernel/Kernel_Drivers/Network/CPSW3g
+linux/Foundational_Components/Kernel/Kernel_Drivers/Network/CPSWng
+linux/Foundational_Components/Kernel/Kernel_Drivers/Network/CPSW-Proxy-Client
 linux/Foundational_Components/Kernel/Kernel_Drivers/Network/CPSW-TSN
 linux/Foundational_Components/Kernel/Kernel_Drivers/Network/CPSW-PTP
 linux/Foundational_Components/Kernel/Kernel_Drivers/Network/CPSW-EST

source/linux/Foundational_Components/Kernel/Kernel_Drivers/Network/CPSW-Ethernet.rst

@@ -40,14 +40,25 @@ of the CPSW Ethernet Subsystem:
 
  For further details regarding the CPSWng instance, refer :ref:`cpswng`
 
-.. ifconfig:: CONFIG_part_family in ('AM62X_family','AM62AX_family','AM64X_family','AM62PX_family','AM62LX_family')
+.. ifconfig:: CONFIG_part_family in ('AM62X_family','AM62AX_family','AM64X_family','AM62LX_family')
 
    CPSW3g
 
  The CPSW3g instance is a part of the Main domain and is controlled by the am65-cpsw-nuss
  driver in Linux.
  For further details regarding the CPSW3g instance, refer :ref:`cpsw3g`
 
+.. ifconfig:: CONFIG_part_family in ('AM62PX_family')
+
+   CPSW3g
+
+ The CPSW3g instance can be configured to operate in two ways:
+   #. CPSW3g Virtual Client
+   #. CPSW3g Native Ethernet
+
+ To generalize, CPSW3g instance can be referred to as CPSWng with 'n' being '3'.
+ For further details regarding the CPSW3g instance, refer :ref:`cpswng`
+
 TSN Documentation and Testing
 """"""""""""""""""""""""""""""
 
@@ -60,11 +71,11 @@ The CPSW Ethernet Subsystem supports TSN features in the following configuration
 .. ifconfig:: CONFIG_part_variant in ('J721E','J7200','J784S4','J742S2')
 
    2. The CPSWng Native Ethernet configuration of the CPSWng instance supports both MAC mode
-      and Switch mode TSN features.
+      and Switch mode TSN features with Linux.
 
 .. ifconfig:: CONFIG_part_family in ('AM62X_family','AM62AX_family','AM64X_family','AM62PX_family','AM62LX_family')
 
-    The CPSW3g instance supports MAC mode and Switch mode TSN features.
+    The CPSW3g instance supports MAC mode and Switch mode TSN features with Linux.
 
 For further details regarding the TSN features and testing, refer :ref:`tsn_with_cpsw`
 

source/linux/Foundational_Components/Kernel/Kernel_Drivers/Network/CPSW-Proxy-Client.rst

@@ -12,8 +12,8 @@ Introduction
 The CPSW Proxy Client driver in Linux interfaces with Ethernet Switch Firmware (EthFw)
 via RPMsg using the Linux Remoteproc framework. The CPSW Ethernet Switch on the SoC
 is configured by EthFw which acts as the Server and provides services to Clients on
-remote cores with the Linux Client on A72 core being the CPSW Proxy Client and the
-driver corresponding to it located at:
+remote cores with the Linux Client on A53 / A72 core being the CPSW Proxy Client and
+the driver corresponding to it located at:
 drivers/net/ethernet/ti/cpsw-proxy-client.c
 in the SDK's Linux Source.
 
@@ -89,6 +89,12 @@ overlay at U-Boot prompt.
 
 To enable Linux CPSW Proxy Client functionality, save the following command in uEnv.txt:
 
+.. ifconfig:: CONFIG_part_variant in ('AM62PX')
+
+    .. code-block:: text
+
+        name_overlays="ti/k3-am62p5-sk-ethfw.dtbo"
+
 .. ifconfig:: CONFIG_part_variant in ('J721E')
 
     .. code-block:: text

source/linux/Foundational_Components/Kernel/Kernel_Drivers/Network/CPSWng.rst

@@ -24,15 +24,25 @@ in managed or learning mode between each of the individual MAC ports.
 
 Depending on the SoC, the value of n in CPSWng varies as follows:
 
-+-----------+----------------+-----------------------------------+
-| SoC       | n in CPSWng    | Number of Ports                   |
-+===========+================+===================================+
-| J7200     | n = 5 (CPSW5g) | 5 (1 host port, 4 external ports) |
-+-----------+----------------+-----------------------------------+
-| J721e     | n = 9 (CPSW9g) | 9 (1 host port, 8 external ports) |
-+-----------+----------------+-----------------------------------+
-| J784S4    | n = 9 (CPSW9g) | 9 (1 host port, 8 external ports) |
-+-----------+----------------+-----------------------------------+
+.. ifconfig:: CONFIG_part_family in ('J7_family')
+
+   +-----------+----------------+-----------------------------------+
+   | SoC       | n in CPSWng    | Number of Ports                   |
+   +===========+================+===================================+
+   | J7200     | n = 5 (CPSW5g) | 5 (1 host port, 4 external ports) |
+   +-----------+----------------+-----------------------------------+
+   | J721e     | n = 9 (CPSW9g) | 9 (1 host port, 8 external ports) |
+   +-----------+----------------+-----------------------------------+
+   | J784S4    | n = 9 (CPSW9g) | 9 (1 host port, 8 external ports) |
+   +-----------+----------------+-----------------------------------+
+
+.. ifconfig:: CONFIG_part_family in ('AM62PX_family')
+
+   +-----------+----------------+-----------------------------------+
+   | SoC       | n in CPSWng    | Number of Ports                   |
+   +===========+================+===================================+
+   | AM62P     | n = 3 (CPSW3g) | 3 (1 host port, 2 external ports) |
+   +-----------+----------------+-----------------------------------+
 
 The SDK provides support to use the CPSWng ports in two different
 configurations:
@@ -44,11 +54,21 @@ configurations:
     The two configurations are mutually exclusive. Only one of the two
     can be enabled for a build.
 
-.. note::
-    | Enabling the CPSW Proxy Client configuration or the CPSWng Native Ethernet configuration
-    | requires applying a Linux device-tree overlay at U-Boot using the **name_overlays** U-Boot environment variable.
-    | For details regarding applying CPSW Proxy Client overlay, refer :ref:`cpsw_proxy_client_enable`.
-    | For details regarding applying CPSWng Native Ethernet overlay, refer :ref:`cpswng_native_eth_overlays`.
+.. ifconfig:: CONFIG_part_family in ('J7_family')
+
+   .. note::
+      | Enabling the CPSW Proxy Client configuration or the CPSWng Native Ethernet configuration
+      | requires applying a Linux device-tree overlay at U-Boot using the **name_overlays** U-Boot environment variable.
+      | For details regarding applying CPSW Proxy Client overlay, refer :ref:`cpsw_proxy_client_enable`.
+      | For details regarding applying CPSWng Native Ethernet overlay, refer :ref:`cpswng_native_eth_overlays`.
+
+
+.. ifconfig:: CONFIG_part_family in ('AM62PX_family')
+
+   .. note::
+      | Enabling the CPSW Proxy Client configuration requires applying a Linux device-tree overlay
+      | at U-Boot using the **name_overlays** U-Boot environment variable.
+      | For details regarding applying CPSW Proxy Client overlay, refer :ref:`cpsw_proxy_client_enable`.
 
 CPSW Proxy Client
 """""""""""""""""
@@ -73,7 +93,13 @@ with other cores.
 
 This configuration supports MAC mode, Switch mode and TSN features on Linux.
 
-For further details, refer :ref:`cpswng_native_ethernet`
+.. ifconfig:: CONFIG_part_family in ('J7_family')
+
+   For further details, refer :ref:`cpswng_native_ethernet`
+
+.. ifconfig:: CONFIG_part_family in ('AM62PX_family')
+
+   For further details, refer :ref:`cpsw3g`
 
 .. toctree::
     :hidden: