[bootlin/training-materials updates] master: kernel-hw: Explain generic DT suffixes (039c021d)

[Miquel Raynal]

Repository : https://github.com/bootlin/training-materials
On branch  : master
Link       : https://github.com/bootlin/training-materials/commit/039c021d14cb49408ce45b0f13d4f3da5c0b1d3c

>---------------------------------------------------------------

commit 039c021d14cb49408ce45b0f13d4f3da5c0b1d3c
Author: Miquel Raynal <miquel.raynal at bootlin.com>
Date:   Thu Jan 26 18:23:50 2023 +0100

    kernel-hw: Explain generic DT suffixes
    
    Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>


>---------------------------------------------------------------

039c021d14cb49408ce45b0f13d4f3da5c0b1d3c
 slides/kernel-hw-devices/kernel-hw-devices.tex | 28 ++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/slides/kernel-hw-devices/kernel-hw-devices.tex b/slides/kernel-hw-devices/kernel-hw-devices.tex
index 108f17f7..b903323b 100644
--- a/slides/kernel-hw-devices/kernel-hw-devices.tex
+++ b/slides/kernel-hw-devices/kernel-hw-devices.tex
@@ -958,6 +958,34 @@ spi3: spi at 4000c000 {
 \end{columns}
 \end{frame}
 
+\begin{frame}[fragile]{Generic suffixes}
+  \begin{itemize}
+  \item \code{xxx-gpios}
+    \begin{itemize}
+    \item When drivers need access to GPIOs
+    \item May be subsystem-specific or vendor-specific
+    \item Examples: \code{enable-gpios}, \code{ts,txrx-gpios}
+    \end{itemize}
+  \item \code{xxx-names}
+    \begin{itemize}
+    \item Sometimes naming items is relevant
+    \item Allows drivers to perform lookups by name rather than ID
+    \item The order of definition of each item still matters
+    \item Examples: \code{gpio-names}, \code{clock-names},
+      \code{reset-names}
+    \end{itemize}
+  \end{itemize}
+  \begin{block}{}
+    \begin{minted}{perl}
+uart0 at 4000c000 {
+    dmas = <&edma 26 0>, <&edma 27 0>;
+    dma-names = "tx", "rx";
+    ...
+};
+    \end{minted}
+  \end{block}
+\end{frame}
+
 % \begin{frame}{Pin-muxing description}
 %   \begin{columns}
 %     \column{0.5\textwidth}