add picture for arduino placement
[challenge-bot] / curriculum / challenge-bot.scm
index 1afa7e98925be156c8c60e1825a61aee2800f4e2..aae56ec9e49d5bbd222448f34b74b8e9b80cb708 100644 (file)
  (chapter
   :title [mechanical]
   (section
-   :title [arduino]
-   (subsection
-    :title [arduino placement])
+   :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
+     :title [inserting drill bit])
+    (subsubsection
+     :title [holding drill])
+    (subsubsection
+     :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 picture above shows where to place the arduino on the deck.
+             the arduino should line up with the holes on the deck.
+             this alignment line is highlighted in pink.
+             on the arduino, there's a hole on the top left, between the
+             orange reset button and black headers.
+             the green circle shows where the hole is.
+             the blue box encloses the arduino hole and two deck holes.
+             place the arduino hole mid-way between the two
+             deck holes.]))
+    (subsubsection
+     :title [drilling]))
    (subsection
-    :title [first hole and screw])
+    :title [first screw]
+    (subsubsection
+     :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
+              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 after that.])
+     (p [the arduino should still be flat against the deck still, just
+             as it was before tightening the screw.]))
+    (subsubsection
+     :title [assessment]
+     (p [does the arduino stay with the deck when the deck moves?
+              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.]))
+    (subsubsection
+     :title [arduino board move relative to deck]
+     (p [without any screws, the arduino board can move independently of
+                 the deck.])
+     (p [with the first screw, the arduino can rotate around one point
+              on the deck.])))
    (subsection
     :title [second hole and screw])
    (subsection
    (subsection
     :title [cable])
    (subsection
-    :title [arduino headers]))
+    :title [arduino headers])
+   (subsection
+    :title [sound cm per microsecond at sea level]))
   (section
    :title [both sonars]
    (subsection