start numbering guide at 0
[challenge-bot] / guide / challenge-bot.scm
index cacc84d2c361e181f0b9bd8806c96ac4e3086ef7..993880cf58673bd8fe2723b2fd47c38dc49944b4 100644 (file)
@@ -3,11 +3,14 @@
 
 (document
  :title [challenge-bot]
+ (toc)
  (chapter
   :title [mechanical]
+  :number "0"
   (p [let's build your robot!])
   (section
    :title [arduino to deck]
+   :number "0"
    (p [let's attach the arduino to the deck.])
    (subsection
     :title [required materials]
      (item [what are we doing to reinforce the motor tabs mechanically?])
      (item [does hot glue make an electrical connection?])))
    (subsection
-    :title [deck attachment]))
-  (section
-   :title [wheels]
-   (subsection
-    :title [tread])
+    :title [motor mount]
+    (p [now let's attach the motor mount to the motor.])
+    (subsubsection
+     :title [angle bracket to motor mount]
+     (p [first, attach the angle brackets to the motor mounts with
+                #6-32x3/8 inch screws.])
+    (figure
+     :legend "motors / mount / angle bracket"
+     (video
+      :file "3-motor-assemblies/1-motor-mount/0-angle-brackets.ogv"))
+    (p [if you cover up 2 of the holes on the motor mount, the
+           remaining holes look like a surprised face.
+           these are the holes to attach the angle brackets.
+           make sure the angle brackets on one motor mount are attached
+           in a mirror image to the other.])
+    (p [check])
+    (enumerate
+     (item [should the motor mounts have angle brackets attached in
+                   a mirror image fashion?])
+     (item [why should the motor mounts have angle brackets attached in
+                   a mirror image fashion?])))
+    (subsubsection
+     :title [motor mount to motor]
+     (p [now attach the motor mount with angle brackets to the motor.])
+     (figure
+      :legend "motor / mount / mount to motor"
+      (video
+       :file
+       "3-motor-assemblies/1-motor-mount/1-motor-mount-to-motor.ogv"))
+     (p [we will attach the motor mount to the motor using #4 bolts.
+            these screws are thinner than the #6 bolts we have used.
+            to clamp down on the motor, we will use a #4 nut.
+            the white side of the nut should face outward.
+            this section of the nut will keep the nut from jiggling
+            loose off the bolt during normal operation.
+            the head of the #4 bolt is a philips head, so we will
+            use a philips head driver for it.])
+     (p [check])
+     (enumerate
+      (item [is the #4 bolt thicker or thinner than the #6?])
+      (item [do you have a ratcheting socket wrench, or not?]))))
    (subsection
-    :title [motor]))
+    :title [deck attachment]
+    (p [now that the motor assemblies are together, we will attach them
+            to the deck.])
+    (figure
+     :legend "motor / motor assembly to deck"
+     (video
+      :file "3-motor-assemblies/2-motor-assembly-to-deck.ogv"))
+    (p [when attaching the motor assembly to the deck, be sure to push
+             the assembly as far outward from the center of the robot
+             as you can while tightening it down.
+             this will give more clearance to the wheels of the robot
+             so they do not rub the deck.])))
   (section
    :title [caster]
-   (subsection
-    :title [deck placement]))
+   (p [the caster will go at the back of the robot and provide a third
+           point of contact for the robot, making it easier for it to
+           balance.])
+   (figure
+    :legend "caster"
+    (video :file "4-caster-to-deck.ogv"))
+   (p [check])
+   (enumerate
+    (item [what would happen if the robot did not have a caster?])))
+  (section
+   :title [wheels]
+   (p [now we will attach the wheels.
+           this makes the motor movement transform into robot movement!])
+   (figure
+    :legend "wheel"
+    (video :file "5-wheel-to-robot-assembly.ogv"))
+   (p [check])
+   (enumerate
+    (item [does the robot's wheels scrape the deck?])
+    (item [what would happen if the robot had no wheels?])
+    (item [what does the tread do?])
+    (item [what is  the tread?])
+    (item [what kind of screw is used?])))
   (section
    :title [sonars]
-   (subsection
-    :title [deck placement])))
+   (p [we are almost done with mechanical assembly!
+          this next step is to add the sonar sensors to the robot.
+          sonar sensors are what the robot uses to detect distances.
+          it sends out a signal, then listens for a response and
+          keeps track of how long it takes.])
+   (figure
+    :legend "sonar sensors"
+    (video :file "6-sonar-sensors-to-deck.ogv"))
+   (p [check])
+   (enumerate
+    (item [are your sonar sensors pointy pins facing in toward the
+               arduino?])
+    (item [was it difficult to get the sonar into the holder?])
+    (item [what would happen if it was easy to slip the sonar sensor
+                into the sonar holder?]))))
  (chapter
   :title [wiring and software]
   (section
    :title [serial]
+   :number "0"
    (subsection
     :title [software on computer]
     (subsubsection