fix(linux): Enable PRU HW UART doc for am62x and am64x

PRU HW UART support exists for AM62x and AM64x SK board, enable
documentation for these platforms and update rst to accommodate
the new platforms.

Fix a few other misc issues while we are here, including whitespace,
mispelling, and missing inline role issues.

Signed-off-by: Judith Mendez <jm@ti.com>

Author: jmenti

configs/AM62X/AM62X_linux_toc.txt

@@ -108,6 +108,7 @@ linux/Foundational_Components_PRU_Subsystem
 linux/Foundational_Components/PRU-ICSS-Linux-Drivers
 linux/Foundational_Components/PRU-ICSS/Linux_Drivers/RemoteProc
 linux/Foundational_Components/PRU-ICSS/Linux_Drivers/RPMsg
+linux/Foundational_Components/PRU-ICSS/Linux_Drivers/pruss-uart
 linux/Foundational_Components/PRU-ICSS/RPMsg_Quick_Start_Guide
 linux/Foundational_Components/PRU-ICSS-Hardware
 linux/Foundational_Components/PRU-ICSS/PRU-EVMs

configs/AM64X/AM64X_linux_toc.txt

@@ -112,6 +112,7 @@ linux/Foundational_Components/PRU-ICSS/Linux_Drivers/RemoteProc
 linux/Foundational_Components/PRU-ICSS/Linux_Drivers/PRU_ICSSG_Ethernet
 linux/Foundational_Components/PRU-ICSS/Linux_Drivers/PRU_ICSSG_Ethernet_Switch
 linux/Foundational_Components/PRU-ICSS/Linux_Drivers/RPMsg
+linux/Foundational_Components/PRU-ICSS/Linux_Drivers/pruss-uart
 linux/Foundational_Components/PRU-ICSS/Linux_Drivers/PRU_ICSSG_XDP
 linux/Foundational_Components/PRU-ICSS/RPMsg_Quick_Start_Guide
 linux/Foundational_Components/PRU-ICSS-Hardware

source/linux/Foundational_Components/PRU-ICSS/Linux_Drivers/pruss-uart.rst

@@ -3,27 +3,34 @@ PRU-ICSS Serial UART
 
 .. rubric:: Introduction
 
-As of Processor SDK v7.1, Linux supports the PRU UART peripheral within the
-PRU-ICSS, which is based on the industry standard TL16C550.
-The kernel driver is at drivers/tty/serial/8250/8250_pruss.c.
+.. ifconfig:: CONFIG_part_variant in ('AM62X')
 
+   Linux supports the PRU HW UART peripheral within the Programmable Real-Time Unit Subsystem
+   (PRUSS), which is based on the industry standard TL16C550.
 
-.. rubric:: Support Devices
+.. ifconfig:: CONFIG_part_variant in ('AM64X')
 
-- |__PART_FAMILY_DEVICE_NAMES__|
+   Linux supports the PRU HW UART peripheral within the Programmable Real-Time Unit (PRU) and
+   Industrial Communication Subsystem - Gigabit (ICSSG) or PRU-ICSSG, which is based on the
+   industry standard TL16C550.
 
+.. ifconfig:: CONFIG_part_variant in ('AM335X', 'AM437X', 'AM57XX')
+
+   Linux supports the PRU HW UART peripheral within the Programmable Real-Time Unit Subsystem
+   and Industrial Communication Subsystem (PRU-ICSS), which is based on the industry standard
+   TL16C550.
+
+The kernel driver is at :file:`drivers/tty/serial/8250/8250_pruss.c`.
 
 .. rubric:: Supported Driver Features
 
 - Baud rates up to 12Mbps
 - Hardware flow control
 
-
 .. rubric:: Unsupported Driver Features
 
 - DMA support
 
-
 .. rubric:: Kernel Config
 
 The PRUSS UART Linux kernel driver depends on the PRU-ICSS kernel drivers. So
@@ -46,7 +53,6 @@ module.
          Serial drivers  --->
             <M> TI PRU-ICSS UART support
 
-
 .. rubric:: Example DT configuration
 
 From am335x-evmsk.dts
@@ -61,7 +67,6 @@ From am335x-evmsk.dts
       status = "okay";
    };
 
-
 .. rubric:: Driver Usage
 
 Once the driver is probed, kernel log shows the following message.
@@ -70,13 +75,15 @@ Once the driver is probed, kernel log shows the following message.
 
    [   28.617700] 4a328000.serial: ttyS1 at MMIO 0x4a328000 (irq = 77, base_baud = 12000000) is a 16550A
 
-Therefore the device node /dev/ttyS1 is associated to the PRUSS UART, user
-space application can read/write this serial port. For detalls please refer
-to :ref:`kernel uart driver usage <linux-kernel-omap-uart-driver-usage>`.
+Therefore the device node /dev/ttyS1 is associated with PRUSS UART and
+user-space applications can read/write to this serial port. For details,
+please refer to :ref:`kernel uart driver usage <linux-kernel-omap-uart-driver-usage>`.
 
 .. note::
 
-    The index in ttyS1 could vary depending on the serial alias configuration
-    in the device tree.
+   The index in ttyS1 could vary depending on the serial alias configuration
+   in the device tree.
 
+.. note::
 
+   PRU cores do not need to be initialized in order for Linux to use the HW UART.