Skip to content

Update PRU UART documentation#708

Open
jmenti wants to merge 2 commits into
TexasInstruments:masterfrom
jmenti:pru-uart
Open

Update PRU UART documentation#708
jmenti wants to merge 2 commits into
TexasInstruments:masterfrom
jmenti:pru-uart

Conversation

@jmenti
Copy link
Copy Markdown
Collaborator

@jmenti jmenti commented May 14, 2026

This PR updates documentation on PRU UART, albeit SW or HW UART on the following platforms:

  • am62x
  • am64x
  • am335x
  • am437x
  • am57x

jmenti added 2 commits May 14, 2026 14:18
PRU SW UART is currently not supported, remove from TOC.

Signed-off-by: Judith Mendez <jm@ti.com>
PRU HW UART support exists for AM62x and AM64x SK board, enable
documentation for these platforms and update rst to accomadate
the new platforms.

Signed-off-by: Judith Mendez <jm@ti.com>
@github-actions
Copy link
Copy Markdown

New issues found with check_toc_txt.py:

WARNING:root:File not in any toc: source/linux/Foundational_Components/PRU-ICSS/Linux_Drivers/pru-sw-uart.rst

@cshilwant
Copy link
Copy Markdown
Member

New issues found with check_toc_txt.py:

WARNING:root:File not in any toc: source/linux/Foundational_Components/PRU-ICSS/Linux_Drivers/pru-sw-uart.rst

As suggested by the bot, if the file is no longer included in any toc tree, can you remove the file as well?

https://github.com/TexasInstruments/processor-sdk-doc/blob/master/source/linux/Foundational_Components/PRU-ICSS/Linux_Drivers/pru-sw-uart.rst

@jmenti
Copy link
Copy Markdown
Collaborator Author

jmenti commented May 15, 2026

@cshilwant No, we should not remove the fle, we will be adding SW UART support here in the future, why remove it?

Copy link
Copy Markdown
Member

@StaticRocket StaticRocket left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ordinary we would remove files when they no longer have any references. I do not see any reason for this to be special. It's git. We can always revert.

.. ifconfig:: CONFIG_part_variant in ('AM64X')

.. rubric:: Support Devices
Programmable Real-Time Unit and Industrial Communication Subsystem - Gigabit (PRU-ICSSG)
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Programmable Real-Time Unit and Industrial Communication Subsystem - Gigabit (PRU-ICSSG)
Programmable Real-Time Unit (PRU) and Industrial Communication Subsystem - Gigabit (ICSSG) or PRU-ICSSG

- |__PART_FAMILY_DEVICE_NAMES__|
.. ifconfig:: CONFIG_part_variant in ('AM335X', 'AM437X', 'AM57XX')

Programmable Real-Time Unit Subsystem and Industrial Communication Subsystem (PRU-ICSS)
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is it actually Programmable Real-Time Unit Subsystem or was this also supposed to just be Programmable Real-Time Unit?

Comment on lines +8 to +21
.. ifconfig:: CONFIG_part_variant in ('AM62X')

Programmable Real-Time Unit Subsystem (PRUSS)

.. ifconfig:: CONFIG_part_variant in ('AM64X')

.. rubric:: Support Devices
Programmable Real-Time Unit and Industrial Communication Subsystem - Gigabit (PRU-ICSSG)

- |__PART_FAMILY_DEVICE_NAMES__|
.. ifconfig:: CONFIG_part_variant in ('AM335X', 'AM437X', 'AM57XX')

Programmable Real-Time Unit Subsystem and Industrial Communication Subsystem (PRU-ICSS)

which is based on the industry standard TL16C550.
The kernel driver is at drivers/tty/serial/8250/8250_pruss.c.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If you want this to flow better consider adding a replacement variable definition for those platforms instead. Currently this will appear as a broken up sentence. Optionally you could restructure this so the user doesn't have to follow a few sentence fragments.

Programmable Real-Time Unit Subsystem and Industrial Communication Subsystem (PRU-ICSS)

which is based on the industry standard TL16C550.
The kernel driver is at drivers/tty/serial/8250/8250_pruss.c.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The kernel driver is at drivers/tty/serial/8250/8250_pruss.c.
The kernel driver is at :file:`drivers/tty/serial/8250/8250_pruss.c`.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

8 participants