[FE training-materials-updates] Improve course guidelines
Michael Opdenacker
michael.opdenacker at free-electrons.com
Sun Nov 8 17:13:24 CET 2015
Repository : git://git.free-electrons.com/training-materials.git
On branch : master
Link : http://git.free-electrons.com/training-materials/commit/?id=0998541d9333cc9c7441e44ba47aa65ec0ac87c3
>---------------------------------------------------------------
commit 0998541d9333cc9c7441e44ba47aa65ec0ac87c3
Author: Michael Opdenacker <michael.opdenacker at free-electrons.com>
Date: Sun Nov 8 17:13:24 2015 +0100
Improve course guidelines
- Instruct people to write down their commands and settings
in a file
- Too many people wasting time because of lack of methodology
Signed-off-by: Michael Opdenacker <michael.opdenacker at free-electrons.com>
>---------------------------------------------------------------
0998541d9333cc9c7441e44ba47aa65ec0ac87c3
slides/course-information/course-information.tex | 25 +-
slides/course-information/text-notes.svg | 329 +++++++++++++++++++++++
2 files changed, 351 insertions(+), 3 deletions(-)
diff --git a/slides/course-information/course-information.tex b/slides/course-information/course-information.tex
index 8d908ff..d30e871 100644
--- a/slides/course-information/course-information.tex
+++ b/slides/course-information/course-information.tex
@@ -27,13 +27,32 @@ sessions: up to 10 people).
groups.
\item Open the electronic copy of your lecture materials, and use it throughout
the practical labs to find the slides you need again.
-\item Don't copy and paste from the PDF slides.\\
-The slides contain UTF-8 characters that look the same as ASCII ones, but won't
-be understood by shells or compilers.
+\item Don't hesitate to copy and paste commands from the PDF slides and
+labs.
\end{itemize}
\end{frame}
\begin{frame}
+\frametitle{Advise: write down your commands!}
+During practical labs, write down all your commands in a text file.
+\begin{columns}
+\column{0.6\textwidth}
+ \begin{itemize}
+ \item You can save a lot of time re-using commands in later labs.
+ \item This helps to replay your work if you make significant mistakes.
+ \item You build a reference to remember commands in the long run.
+ \item That's particular useful to keep kernel command line settings
+ that you used earlier.
+ \item Also useful to get help from the instructor, showing the
+ commands that you run.
+ \end{itemize}
+\code{gedit ~/lab-history.txt}
+\column{0.4\textwidth}
+ \includegraphics[width=\textwidth]{slides/course-information/text-notes.pdf}
+\end{columns}
+\end{frame}
+
+\begin{frame}
\frametitle{Cooperate!}
As in the Free Software and Open Source community,
cooperation during practical labs is valuable in this training session:
diff --git a/slides/course-information/text-notes.svg b/slides/course-information/text-notes.svg
new file mode 100644
index 0000000..a4ab316
--- /dev/null
+++ b/slides/course-information/text-notes.svg
@@ -0,0 +1,329 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+ xmlns:dc="http://purl.org/dc/elements/1.1/"
+ xmlns:cc="http://creativecommons.org/ns#"
+ xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+ xmlns:svg="http://www.w3.org/2000/svg"
+ xmlns="http://www.w3.org/2000/svg"
+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+ xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+ id="svg1"
+ sodipodi:docname="text-notes.svg"
+ viewBox="0 0 137.48 150.32"
+ sodipodi:version="0.32"
+ version="1.1"
+ inkscape:version="0.91 r13725">
+ <defs
+ id="defs3">
+ <linearGradient
+ id="linearGradient1492">
+ <stop
+ id="stop1493"
+ style="stop-color:#dadada"
+ offset="0" />
+ <stop
+ id="stop1496"
+ style="stop-color:#f1f1f1"
+ offset=".34923" />
+ <stop
+ id="stop1494"
+ style="stop-color:#f0f0f0"
+ offset="1" />
+ </linearGradient>
+ <linearGradient
+ id="linearGradient1495"
+ y2="689.86"
+ xlink:href="#linearGradient1492"
+ gradientUnits="userSpaceOnUse"
+ y1="230.07"
+ gradientTransform="matrix(.28346 0 0 .31053 -85.252 -40.356)"
+ x2="351.71"
+ x1="728.96" />
+ <linearGradient
+ id="linearGradient1497"
+ y2="287.73"
+ xlink:href="#linearGradient1492"
+ gradientUnits="userSpaceOnUse"
+ y1="169.44"
+ gradientTransform="matrix(.28342 0 0 .31058 -85.252 -40.356)"
+ x2="622.35"
+ x1="741.65" />
+ <linearGradient
+ id="linearGradient1499"
+ y2="418.54"
+ gradientUnits="userSpaceOnUse"
+ x2="330.88"
+ gradientTransform="matrix(.29343 0 0 .29999 -85.252 -40.356)"
+ y1="236.13"
+ x1="687.96">
+ <stop
+ id="stop1502"
+ style="stop-color:#ffffff"
+ offset="0" />
+ <stop
+ id="stop1504"
+ style="stop-color:#ffffff;stop-opacity:0"
+ offset="1" />
+ </linearGradient>
+ <linearGradient
+ id="linearGradient1506"
+ y1=".97656"
+ x2=".78261"
+ x1=".052174"
+ y2=".0078125">
+ <stop
+ id="stop1508"
+ style="stop-color:#000000;stop-opacity:.095506"
+ offset="0" />
+ <stop
+ id="stop1510"
+ style="stop-color:#000000;stop-opacity:0"
+ offset="1" />
+ </linearGradient>
+ <linearGradient
+ id="linearGradient3008"
+ y2="389.18"
+ xlink:href="#linearGradient1506"
+ gradientUnits="userSpaceOnUse"
+ x2="544.79"
+ gradientTransform="scale(.94318 1.0602)"
+ y1="836.03"
+ x1="207.87"
+ inkscape:collect="always" />
+ <linearGradient
+ id="linearGradient3010"
+ y2="386.48"
+ xlink:href="#linearGradient1506"
+ gradientUnits="userSpaceOnUse"
+ x2="546.29"
+ gradientTransform="scale(.94395 1.0594)"
+ y1="839.62"
+ x1="204.63"
+ inkscape:collect="always" />
+ <linearGradient
+ id="linearGradient3012"
+ y2="383.76"
+ xlink:href="#linearGradient1506"
+ gradientUnits="userSpaceOnUse"
+ x2="547.81"
+ gradientTransform="scale(.94469 1.0585)"
+ y1="843.2"
+ x1="201.39"
+ inkscape:collect="always" />
+ </defs>
+ <sodipodi:namedview
+ id="base"
+ bordercolor="#666666"
+ inkscape:pageshadow="2"
+ inkscape:window-y="27"
+ pagecolor="#ffffff"
+ snaptogrid="false"
+ inkscape:window-width="1303"
+ inkscape:zoom="2.1382455"
+ inkscape:window-x="0"
+ showgrid="false"
+ borderopacity="1.0"
+ inkscape:current-layer="svg1"
+ inkscape:cx="-25.331874"
+ inkscape:cy="92.018193"
+ inkscape:window-height="682"
+ showborder="false"
+ inkscape:pageopacity="0.0"
+ inkscape:window-maximized="0" />
+ <path
+ id="path930"
+ inkscape:connector-curvature="0"
+ sodipodi:nodetypes="cccccccccccccccc"
+ style="fill-rule:evenodd;stroke-width:.42649;stroke-opacity:.36478;fill:#ffffff"
+ d="m3.1031 0.031155v146.96h134.11v-110.22l-33.53-36.74-33.525 0.0003h-67.053z" />
+ <g
+ id="g1552"
+ style="fill:url(#linearGradient3012)"
+ transform="matrix(.30417 0 0 .29757 -50.76 -118.79)">
+ <path
+ id="path1505"
+ inkscape:connector-curvature="0"
+ sodipodi:nodetypes="cccccccccccccccc"
+ style="fill-rule:evenodd;stroke-width:.95407pt;fill:url(#linearGradient3008);fill-opacity:.75"
+ d="m173.36 408.81v489.05h435.05v-366.79l-108.76-122.26h-326.29z" />
+ <path
+ id="path1538"
+ style="fill-rule:evenodd;stroke-width:.95407pt;fill:url(#linearGradient3010);fill-opacity:.75"
+ inkscape:connector-curvature="0"
+ d="m170.12 407.19v493.9h441.54v-371.28c-36.85-41.42-73.68-82.86-110.57-124.25h-330.97v1.63z" />
+ <path
+ id="path1543"
+ style="fill-rule:evenodd;stroke-width:.95407pt;fill:url(#linearGradient3012);fill-opacity:.75"
+ inkscape:connector-curvature="0"
+ d="m166.88 403.94v500.4h448.03v-375.78c-37.45-42.09-74.89-84.19-112.38-126.25h-335.65v1.63z" />
+ </g>
+ <path
+ id="rect900"
+ inkscape:connector-curvature="0"
+ sodipodi:nodetypes="cccccccccccccccc"
+ style="fill-rule:evenodd;stroke:#000000;stroke-width:.42649;stroke-opacity:.36478;fill:url(#linearGradient1495)"
+ d="m3.1588 0.21325v146.96h134.11v-110.22l-33.53-36.737h-100.58z" />
+ <text
+ xml:space="preserve"
+ style="font-style:normal;font-weight:normal;font-size:40px;line-height:125%;font-family:Sans;-inkscape-font-specification:Sans;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+ x="10.083382"
+ y="60.940613"
+ id="text4215-3-8"
+ sodipodi:linespacing="125%"><tspan
+ sodipodi:role="line"
+ id="tspan4217-2-8"
+ x="10.083382"
+ y="60.940613"
+ style="font-size:5px">Booting kernel through tftp:</tspan><tspan
+ sodipodi:role="line"
+ x="10.083382"
+ y="67.190613"
+ style="font-size:5px"
+ id="tspan4172">setenv bootargs console=ttyS0 root=/dev/nfs</tspan><tspan
+ sodipodi:role="line"
+ x="10.083382"
+ y="73.440613"
+ style="font-size:5px"
+ id="tspan4261">setenv bootcmd tftp 0x21000000 zImage; tftp</tspan><tspan
+ sodipodi:role="line"
+ x="10.083382"
+ y="79.690613"
+ style="font-size:5px"
+ id="tspan4263">0x22000000 dtb; bootz 0x21000000 - 0x2200...</tspan></text>
+ <path
+ id="path1500"
+ inkscape:connector-curvature="0"
+ sodipodi:nodetypes="cccczc"
+ style="fill-rule:evenodd;stroke-width:1pt;fill:url(#linearGradient1499)"
+ d="m4.1438 11.538-0.6053 134.69h131.68l0.0742-33.295c-2.94 1.13-32.69-41.002-70.141-39.189-37.484 1.813-27.785-56.778-61.005-62.213z" />
+ <path
+ id="path906"
+ inkscape:connector-curvature="0"
+ sodipodi:nodetypes="cccc"
+ style="fill-rule:evenodd;stroke-width:.95407pt;fill:url(#linearGradient1497)"
+ d="m137.27 36.952c-10.11-2.99-23.21-2.566-33.1-0.86 1.71-10.963 1.92-24.702-0.43-35.879l33.53 36.739z" />
+ <metadata
+ id="metadata31">
+ <rdf:RDF>
+ <cc:Work>
+ <dc:format>image/svg+xml</dc:format>
+ <dc:type
+ rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+ <cc:license
+ rdf:resource="http://creativecommons.org/licenses/publicdomain/" />
+ <dc:publisher>
+ <cc:Agent
+ rdf:about="http://openclipart.org/">
+ <dc:title>Openclipart</dc:title>
+ </cc:Agent>
+ </dc:publisher>
+ </cc:Work>
+ <cc:License
+ rdf:about="http://creativecommons.org/licenses/publicdomain/">
+ <cc:permits
+ rdf:resource="http://creativecommons.org/ns#Reproduction" />
+ <cc:permits
+ rdf:resource="http://creativecommons.org/ns#Distribution" />
+ <cc:permits
+ rdf:resource="http://creativecommons.org/ns#DerivativeWorks" />
+ </cc:License>
+ </rdf:RDF>
+ </metadata>
+ <text
+ xml:space="preserve"
+ style="font-style:normal;font-weight:normal;font-size:40px;line-height:125%;font-family:Sans;-inkscape-font-specification:Sans;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+ x="10.497868"
+ y="13.550389"
+ id="text4215"
+ sodipodi:linespacing="125%"><tspan
+ sodipodi:role="line"
+ id="tspan4217"
+ x="10.497868"
+ y="13.550389"
+ style="font-size:5px">Lab commands</tspan></text>
+ <text
+ xml:space="preserve"
+ style="font-style:normal;font-weight:normal;font-size:40px;line-height:125%;font-family:Sans;-inkscape-font-specification:Sans;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+ x="9.9887466"
+ y="29.650316"
+ id="text4215-3"
+ sodipodi:linespacing="125%"><tspan
+ sodipodi:role="line"
+ x="9.9887466"
+ y="29.650316"
+ style="font-size:5px"
+ id="tspan4309">Cross-compiling kernel:</tspan><tspan
+ sodipodi:role="line"
+ x="9.9887466"
+ y="35.900314"
+ style="font-size:5px"
+ id="tspan4307">export ARCH=arm</tspan><tspan
+ sodipodi:role="line"
+ x="9.9887466"
+ y="42.150314"
+ style="font-size:5px"
+ id="tspan4255">export CROSS_COMPILE=arm-linux-</tspan><tspan
+ sodipodi:role="line"
+ x="9.9887466"
+ y="48.400314"
+ style="font-size:5px"
+ id="tspan4257">make sama5_defconfig</tspan><tspan
+ sodipodi:role="line"
+ x="9.9887466"
+ y="54.650314"
+ style="font-size:5px"
+ id="tspan4259" /></text>
+ <text
+ xml:space="preserve"
+ style="font-style:normal;font-weight:normal;font-size:40px;line-height:125%;font-family:Sans;-inkscape-font-specification:Sans;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+ x="10.027682"
+ y="93.995598"
+ id="text4215-3-8-3"
+ sodipodi:linespacing="125%"><tspan
+ sodipodi:role="line"
+ x="10.027682"
+ y="93.995598"
+ style="font-size:5px"
+ id="tspan4263-5">Making ubifs images:</tspan><tspan
+ sodipodi:role="line"
+ x="10.027682"
+ y="100.2456"
+ style="font-size:5px"
+ id="tspan4174">mkfs.ubifs -d rootfs -o root.ubifs -e 124KiB</tspan><tspan
+ sodipodi:role="line"
+ x="10.027682"
+ y="106.4956"
+ style="font-size:5px"
+ id="tspan4305">-m 2048 -c 1024 </tspan></text>
+ <text
+ xml:space="preserve"
+ style="font-style:normal;font-weight:normal;font-size:40px;line-height:125%;font-family:Sans;-inkscape-font-specification:Sans;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+ x="17.303907"
+ y="75.492302"
+ id="text4313"
+ sodipodi:linespacing="125%"><tspan
+ sodipodi:role="line"
+ id="tspan4315"
+ x="17.303907"
+ y="75.492302" /></text>
+ <text
+ xml:space="preserve"
+ style="font-style:normal;font-weight:normal;font-size:40px;line-height:125%;font-family:Sans;-inkscape-font-specification:Sans;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+ x="10.206186"
+ y="118.34131"
+ id="text4215-3-8-3-4"
+ sodipodi:linespacing="125%"><tspan
+ sodipodi:role="line"
+ x="10.206186"
+ y="118.34131"
+ style="font-size:5px"
+ id="tspan4263-5-5">Encountered issues:</tspan><tspan
+ sodipodi:role="line"
+ x="10.206186"
+ y="124.59131"
+ style="font-size:5px"
+ id="tspan4305-2">Restart NFS server after editing /etc/exports! </tspan></text>
+</svg>
More information about the training-materials-updates
mailing list