close in on arduino placement
[challenge-bot] / curriculum / challenge-bot.scm
index 76dc7781a7133f338a04b10881f3e582af333956..8a15f31974df5e0072691f479c3564810376f2a5 100644 (file)
@@ -6,11 +6,23 @@
  (chapter
   :title [mechanical]
   (section
-   :title [arduino]
-   (subsection
-    :title [arduino placement])
-   (subsection
-    :title [first hole and screw]
+   :title [arduino to deck]
+   (subsection
+    :title [required materials]
+    (p [you will need the things in this picture.
+            ,(figure :legend "arduino to deck / required materials"
+                    (image :file "arduino-to-deck/0-required-materials.png"))
+            ,(itemize
+              (item [medical kit with bandages])
+              (item [safety goggles])
+              (item [drill bit \(we will determine size in a moment\)])
+              (item [drill])
+              (item [alan wrench])
+              (item [wood block])
+              (item [arduino])
+              (item [#6-32x3/8\", four of them]))]))
+   (subsection
+    :title [first hole]
     (subsubsection
      :title [choosing drill bit])
     (subsubsection
     (subsubsection
      :title [holding drill])
     (subsubsection
-     :title [drilling])
+     :title [arduino placement]
+     (p [the arduino should be placed as shown in this picture.]
+        (figure :legend "arduino to deck / place arduino"
+                (image :file "arduino-to-deck/3-place-arduino.png"))
+        [here's a closeup]
+        (figure :legend "arduino to deck / place arduino closeup"
+                (image :file "arduino-to-deck/4-place-arduino-closeup.png"))
+        [the top edge of the arduino should line up with the underside
+             of the holes closest to the edge of the deck.
+             on the arduino, there's a hole on the top left.
+             that hole should be mid-way between two of the holes in the
+             grid of holes on the deck.
+             put the arduino hole between the third and fourth holes
+             from the left side of the deck.]))
+    (subsubsection
+     :title [drilling]))
+   (subsection
+    :title [first screw]
     (subsubsection
-     :title [6-32 by 3/8\" screw]
-     (p [the "6" part is how big around it is.])
-     (p [the "32" part is how close the threads are to each other.])
-     (p [the "head" is the flat part where some tool, like the alan
-             wrench, can exert force to spin the screw.]))
+     :title [fastening arduino to deck using #6-32x3/8\" screw]
+     (p [the "#6" part of "#6-32x3/8\"" is how big around the bolt is.
+             it is related to wire gauge.
+             bigger numbers mean larger screw.
+             smaller numbers means smaller screws.])
+     (p [check
+         ,(itemize
+           (item
+            [in the motor assembly, there are #4-40x1.25\" screws.
+                are those fatter, thinner, or the same thickness as the
+                #6-32x3/8\" screws?]))])
+     (p [the "32" part is a measurement of how close the threads are to
+             each other.
+             this is related to the angle of the thread, which is also
+             called pitch.
+             it is a count of how many times the thread wraps around one
+             inch of the screw body.])
+     (p [the head is the flat part where some tool, like the alan
+             wrench, can exert force to spin the screw.])
+     (p [check
+         ,(itemize
+           (item [how many times will the thread wrap around one inch of
+                      the screw body?])
+           (item [what about 2 inches?
+                       how many times will the thread wrap around two
+                       inches of the screw body?]))]))
     (subsubsection
      :title [fasten the arduino board to the deck]
      (p [push the 6-32 screw into the deck from the underside and at the
               same time, spin the 6-32 screw clockwise while looking
-              down on its head.  twist until the bottom of the screw is
+              down on its head.
+              twist until the bottom of the screw is
               about to stick out on the top side of the deck.])
      (p [hold the arduino board flat to the deck and line up the arduino
-              hole so the screw can come up through it.  continue
-              tightening the screw into the deck, spinning the same
-              direction as before.  tighten until the screw head touches
-              the deck.  do not continue tightening])
+              hole so the screw can come up through it.
+              continue tightening the screw into the deck, spinning the same
+              direction as before.
+              tighten until the screw head touches the deck.
+              do not continue tightening after that.])
      (p [the arduino should still be flat against the deck still, just
              as it was before tightening the screw.]))
     (subsubsection
@@ -44,7 +96,8 @@
               can the arduino board still rotate a few degrees?
               warning, if you rotate the arduino board too much, you
               will unscrew it from the deck and you'll have to screw it
-              back in.  rotating a few degrees should be ok.]))
+              back in.
+              rotating a few degrees should be ok.]))
     (subsubsection
      :title [arduino board move relative to deck]
      (p [without any screws, the arduino board can move independently of