[bootlin/training-materials updates] master: kernel-hw: Introduce the different DT properties first (0edb18bb)

[Miquel Raynal]

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

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

commit 0edb18bb5a42688351e5ed3b1c2b5ba06fd6fa4e
Author: Miquel Raynal <miquel.raynal at bootlin.com>
Date:   Thu Jan 26 18:23:35 2023 +0100

    kernel-hw: Introduce the different DT properties first
    
    Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>


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

0edb18bb5a42688351e5ed3b1c2b5ba06fd6fa4e
 slides/kernel-hw-devices/kernel-hw-devices.tex | 32 ++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/slides/kernel-hw-devices/kernel-hw-devices.tex b/slides/kernel-hw-devices/kernel-hw-devices.tex
index 598b8d4c..108f17f7 100644
--- a/slides/kernel-hw-devices/kernel-hw-devices.tex
+++ b/slides/kernel-hw-devices/kernel-hw-devices.tex
@@ -679,6 +679,38 @@ examples:
   \end{itemize}
 \end{frame}
 
+\begin{frame}{The properties}
+  Device tree properties can be:
+  \begin{itemize}
+  \item Fully generic
+    \begin{itemize}
+    \item Their meaning is usually described in one place: the core DT
+      schema available at \url{https://github.com/devicetree-org/dt-schema}.
+    \item \code{compatible}, \code{reg}, \code{\#address-cells}, etc
+    \end{itemize}
+  \item Subsystem specific and cover generic consumer bindings
+    \begin{itemize}
+    \item Their meaning is either described in the \code{dt-schema}
+      Github or under \kfile{Documentation/device-tree/bindings}.
+    \item \code{clocks}, \code{interrupts}, \code{regulators}, etc
+    \end{itemize}
+  \item Subsystem specific
+    \begin{itemize}
+    \item All devices of a certain class may use them, often starting
+      with the class name
+    \item \code{spi-cpha}, \code{i2c-scl-internal-delay-ns}, \code{nand-ecc-engine},
+      \code{mac-address}, etc
+    \end{itemize}
+  \item Vendor/device specific
+    \begin{itemize}
+    \item To describe uncommon or very specific properties
+    \item Always described in the device's binding file and prefixed with \code{<vendor>,}
+    \item \code{ti,hwmods}, \code{xlnx,num-channels}, \code{nxp,tx-output-mode}, etc
+    \end{itemize}
+  \item Some of them are deprecated, watch out the bindings!
+  \end{itemize}
+\end{frame}
+
 \begin{frame}{The {\tt compatible} property}
   \begin{itemize}
   \item Is a list of strings