[bootlin/training-materials updates] master: Boot time: first updates for the new cape (18f807fd)

Michael Opdenacker michael.opdenacker at bootlin.com
Wed Mar 31 18:40:13 CEST 2021

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


commit 18f807fd5284a858ff39194991442e6a2d562015
Author: Michael Opdenacker <michael.opdenacker at bootlin.com>
Date:   Wed Mar 31 18:40:13 2021 +0200

    Boot time: first updates for the new cape
    Signed-off-by: Michael Opdenacker <michael.opdenacker at bootlin.com>


 .../hardware/beaglebone-lcd4-reva1-schematic.pdf      | Bin 130741 -> 0 bytes
 labs/boot-time-board-setup/boot-time-board-setup.tex  |  14 ++++++--------
 labs/boot-time-board-setup/connecting-lcd4-cape.jpg   | Bin 115530 -> 0 bytes
 labs/boot-time-board-setup/connecting-lcd43-cape.jpg  | Bin 0 -> 1122913 bytes
 .../boot-time-build-kernel-and-start-system.tex       |  15 +++++++++------
 .../boot-time-hardware-measurement.tex                |   8 ++++----
 slides/beaglecam/beaglecam.tex                        |  10 ++--------
 slides/board-setup-lab/board-setup-lab.tex            |   2 +-
 8 files changed, 22 insertions(+), 27 deletions(-)

diff --git a/lab-data/boot-time/hardware/beaglebone-lcd4-reva1-schematic.pdf b/lab-data/boot-time/hardware/beaglebone-lcd4-reva1-schematic.pdf
deleted file mode 100644
index fd6259a6..00000000
Binary files a/lab-data/boot-time/hardware/beaglebone-lcd4-reva1-schematic.pdf and /dev/null differ
diff --git a/labs/boot-time-board-setup/boot-time-board-setup.tex b/labs/boot-time-board-setup/boot-time-board-setup.tex
index 378d7864..3bde0f3d 100644
--- a/labs/boot-time-board-setup/boot-time-board-setup.tex
+++ b/labs/boot-time-board-setup/boot-time-board-setup.tex
@@ -5,7 +5,7 @@ After this lab, you will be able to:
 \item Access the board through its serial line.
 \item Check the stock bootloader
-\item Attach the LCD4 cape
+\item Attach the 4.3" LCD cape
 \section{Getting familiar with the board}
@@ -117,20 +117,18 @@ maker, to avoid hardware damage that can happen if the board is abruptly
 switched off.}.
 Now that we have successfully tested serial console, we are ready to
-attach the LCD4 cape provided by your instructor.
+attach the 4.3 LCD cape provided by your instructor.
 Note that if you bought your own Beagle Bone Black board, you will have
 to {\bf gently} bend the serial headers using pliers, otherwise the
 serial cable won't fit between the board and the cape.
-There are two ways to connect the cape headers to the Bone Black
-headers, but only one actually fits, the \code{POWER} button of the cape
-sliding right between the board's RJ45 connector and power barrel
+Now, you can connect the LCD cape to your Bone Black board. There
+is just one way that fits, given the space taken by the RJ45 connector:
-You will find the schematics of the LCD4 cape in the
+You will find the schematics of the 4.3" LCD cape in the
 \code{~/boot-time-labs/hardware/} directory. This will be useful to know
 that header pins remain free to use.
diff --git a/labs/boot-time-board-setup/connecting-lcd4-cape.jpg b/labs/boot-time-board-setup/connecting-lcd4-cape.jpg
deleted file mode 100644
index 06d4e163..00000000
Binary files a/labs/boot-time-board-setup/connecting-lcd4-cape.jpg and /dev/null differ
diff --git a/labs/boot-time-board-setup/connecting-lcd43-cape.jpg b/labs/boot-time-board-setup/connecting-lcd43-cape.jpg
new file mode 100644
index 00000000..f728380f
Binary files /dev/null and b/labs/boot-time-board-setup/connecting-lcd43-cape.jpg differ
diff --git a/labs/boot-time-build-kernel-and-start-system/boot-time-build-kernel-and-start-system.tex b/labs/boot-time-build-kernel-and-start-system/boot-time-build-kernel-and-start-system.tex
index 09107e71..72338f5e 100644
--- a/labs/boot-time-build-kernel-and-start-system/boot-time-build-kernel-and-start-system.tex
+++ b/labs/boot-time-build-kernel-and-start-system/boot-time-build-kernel-and-start-system.tex
@@ -39,7 +39,7 @@ git checkout -b 5.11-beaglecam stable/linux-5.11.y
 This local branch will allow us to keep our modifications to the Linux
-kernel to support the LCD4 cape that we're using.
+kernel to support the 4.3" LCD cape that we're using.
 Open \code{Makefile} again and make sure you now have a 5.11.<n> version.
@@ -58,9 +58,9 @@ export ARCH=arm
 Now source this file (\code{source ~/.bashrc})  in the current terminal,
 or start a new terminal to get all needed variables.
-\section{Adding support for the LCD4 cape}
+\section{Adding support for the 4.3" LCD cape}
-To support using the LCD4 cape, all we need to do is declare and
+To support using the 4.3" LCD cape, all we need to do is declare and
 configure the devices on this cape. This is typically done by
 customizing the board's {\em Device Tree} or by adding a {\em Device
 Tree Overlay}.
@@ -69,7 +69,7 @@ So, to avoid messing with the standard DTS for our board, let's use a
 such a customized device tree through a separate file:
-cp ~/boot-time-labs/kernel/data/am335x-boneblack-lcd4.dts arch/arm/boot/dts/
+cp ~/boot-time-labs/kernel/data/am335x-boneblack-lcd43.dts arch/arm/boot/dts/
 You now have to modify \code{arch/arm/boot/dts/Makefile} so that
@@ -119,7 +119,10 @@ For USB support:
 \item \kconfigval{CONFIG_USB_MUSB_HDRC}{y}
 \item \kconfigval{CONFIG_USB_MUSB_DSPS}{y}
 \item \kconfigval{CONFIG_MUSB_PIO_ONLY}{y}
-\item \kconfigval{CONFIG_USB_GADGET}{y}
+\item \kconfigval{CONFIG_USB_GADGET}{y}\\
+      You may wonder why we need this while we're not using USB gadget
+      at all. At least in the 5.1 kernel, this setting was required to get some
+      of the USB host functionality we needed.
 \item \kconfigval{CONFIG_NOP_USB_XCEIV}{y}
 \item \kconfigval{CONFIG_AM335X_PHY_USB}{y}
 \item \kconfigval{CONFIG_USB_GPIO_VBUS}{y}
@@ -160,7 +163,7 @@ partition:
 cp arch/arm/boot/zImage /media/$USER/boot/
-cp arch/arm/boot/dts/am335x-boneblack-lcd4.dtb /media/$USER/boot/dtb
+cp arch/arm/boot/dts/am335x-boneblack-lcd43.dtb /media/$USER/boot/dtb
 \section{Installing the root filesystem}
diff --git a/labs/boot-time-hardware-measurement/boot-time-hardware-measurement.tex b/labs/boot-time-hardware-measurement/boot-time-hardware-measurement.tex
index 74ba3a42..aeaf9ca7 100644
--- a/labs/boot-time-hardware-measurement/boot-time-hardware-measurement.tex
+++ b/labs/boot-time-hardware-measurement/boot-time-hardware-measurement.tex
@@ -101,9 +101,9 @@ P9 headers is used to expose the \code{SYS_RESET} line.
 \subsection{Finding a free pin for the stop signal}
-Look at the schematics for the LCD4 cape. Unfortunately, no reference
+Look at the schematics for the 4.3" LCD. Unfortunately, no reference
 manual was ever published for this cape. However, the schematics are
-sufficient to find pins that are not used by the LCD4 cape.
+sufficient to find pins that are not used by the 4.3" LCD cape.
 If you look for \code{Bootlin} in the Device Tree Source we provided,
 you can see in the pin definitions sections that we selected pin 13 or
@@ -127,10 +127,10 @@ We are going the good old wire wrapping technique as shown by the
 instructor to hook up to pins we want to monitor, with a reliable
 connection, but without any soldering.
-So, take out the LCD4 cape, find which of its header pins are connected
+So, take out the LCD cape, find which of its header pins are connected
 to the Bone Black pins we want to monitor, and then use the wire and
 tool provided by the instructor to connect to these pins, before
-re-attaching the LCD4 cape.
+re-attaching the LCD cape.
 On the other end of the cables, your instructor will also give you small
 headers that you can plug into the breadboard holes and do some wiring
diff --git a/slides/beaglecam/beaglecam.tex b/slides/beaglecam/beaglecam.tex
index d0a48a4c..a8820aab 100644
--- a/slides/beaglecam/beaglecam.tex
+++ b/slides/beaglecam/beaglecam.tex
@@ -5,11 +5,8 @@
 	\item Beagle Bone Black board (of course). The Wireless variant
 	      should work fine too.
-	\item Beagle Bone LCD cape\\
-              \url{https://elinux.org/Beagleboard:BeagleBone_LCD4}\\
-	      Unfortunately, no longer manufactured. However, we will
-              try to make the course work too with this cape Element14:
-              \url{https://tinyurl.com/ncysvahc}
+	\item Beagle Bone 4.3" LCD cape from Element 14\\
+              \url{https://www.element14.com/bbcape43}
         \item Standard USB webcam (supported through the \code{uvcvideo}
@@ -17,6 +14,3 @@
diff --git a/slides/board-setup-lab/board-setup-lab.tex b/slides/board-setup-lab/board-setup-lab.tex
index 4afb934f..d8c41294 100644
--- a/slides/board-setup-lab/board-setup-lab.tex
+++ b/slides/board-setup-lab/board-setup-lab.tex
@@ -4,6 +4,6 @@
   \item Access the board through its serial line
   \item Check the stock bootloader
-  \item Attach the LCD4 cape
+  \item Attach the 4.3" LCD cape

More information about the training-materials-updates mailing list