put battery pack soldering after deck drilling
[challenge-bot] / guide / challenge-bot.scm
index da614d50dfe9b505dba0c5faaee74a4fed9cebf6..a157c3148d1e03e6e7fc432447bcdae426719773 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 [the arduino should be close to but not touching an edge.])
      (item [there should be no warping on the arduino.
                   this could happen if the screws are too tight.]))))
-  (section
-   :title [breadboard]
-   (p [next, let's attach other parts to the deck.
-             we'll start with the breadboard.
-             there are many ways to do this, but one handy approach is
-             glue dots.
-             glue dots can be placed easily, are good at attaching flat
-             surfaces that directly touch and do not get much stress.])
-   (figure :legend "breadboard to deck / required materials"
-           (image
-            :file "1-breadboard-to-deck/0-required-materials.png"))
-   (p [for this section, we will need the deck with arduino attached,
-           breadboard, and glue dots.])
-   (figure :legend "breadboard to deck / video"
-           (video
-            :file "1-breadboard-to-deck/0-breadboard-to-deck.ogv"))
-   (enumerate
-    (item [take your breadboard out of its bag.])
-    (item [peel the backing.])
-    (item [put the shiny medal plate on the back.])
-    (item [break 4 glue dots away from the rest.  put the rest back
-                 into the bag.])
-    (item [break off a glue dot from the group of 4, and peel away the
-                 backing, exposing a sticky side.])
-    (item [put the glue dot on one corner of the shiny side of the
-               breadboard.
-               make sure to push it down firmly.])
-    (item [repeat for the other corners.])
-    (item [put the breadboard on the center of the deck.
-               position it so the black chip is on the right, and the
-               blue line is up against the arduino.])
-    (item [press firmly in each of the corners.]))
-   (p [check])
-   (enumerate
-    (item [should the black chip be on the right or the left?])
-    (item [how many glue dots should be on the breadboard?])))
   (section
    :title [battery packs]
    (subsection
      (p [check])
      (enumerate
       (item [why align the screw with a hole on the deck?])))))
+  (section
+   :title [breadboard]
+   (p [next, let's attach other parts to the deck.
+             we'll start with the breadboard.
+             there are many ways to do this, but one handy approach is
+             glue dots.
+             glue dots can be placed easily, are good at attaching flat
+             surfaces that directly touch and do not get much stress.])
+   (figure :legend "breadboard to deck / required materials"
+           (image
+            :file "1-breadboard-to-deck/0-required-materials.png"))
+   (p [for this section, we will need the deck with arduino attached,
+           breadboard, and glue dots.])
+   (figure :legend "breadboard to deck / video"
+           (video
+            :file "1-breadboard-to-deck/0-breadboard-to-deck.ogv"))
+   (enumerate
+    (item [take your breadboard out of its bag.])
+    (item [peel the backing.])
+    (item [put the shiny medal plate on the back.])
+    (item [break 4 glue dots away from the rest.  put the rest back
+                 into the bag.])
+    (item [break off a glue dot from the group of 4, and peel away the
+                 backing, exposing a sticky side.])
+    (item [put the glue dot on one corner of the shiny side of the
+               breadboard.
+               make sure to push it down firmly.])
+    (item [repeat for the other corners.])
+    (item [put the breadboard on the center of the deck.
+               position it so the black chip is on the right, and the
+               blue line is up against the arduino.])
+    (item [press firmly in each of the corners.]))
+   (p [check])
+   (enumerate
+    (item [should the black chip be on the right or the left?])
+    (item [how many glue dots should be on the breadboard?])))
   (section
    :title [motors]
    (subsection
              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 [wheels]
-   (subsection
-    :title [tread])
-   (subsection
-    :title [motor]))
   (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