(document
:title [challenge-bot]
(chapter
- :title [mechanical]))
+ :title [mechanical]
+ (section
+ :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"))
+ [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 [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
+ :title [third and fourth hole and screw]))
+ (section
+ :title [breadboard])
+ (section
+ :title [battery packs]
+ (subsection
+ :title [leads])
+ (subsection
+ :title [deck attachment]))
+ (section
+ :title [motors]
+ (subsection
+ :title [leads])
+ (subsection
+ :title [mount])
+ (subsection
+ :title [deck attachment]))
+ (section
+ :title [wheels]
+ (subsection
+ :title [tread])
+ (subsection
+ :title [motor]))
+ (section
+ :title [caster]
+ (subsection
+ :title [deck placement]))
+ (section
+ :title [sonars]
+ (subsection
+ :title [deck placement])))
+ (chapter
+ :title [wiring and software]
+ (section
+ :title [serial]
+ (subsection
+ :title [software on computer]
+ (subsubsection
+ :title [arduino])
+ (subsubsection
+ :title [fritzing]))
+ (subsection
+ :title [attach arduino and computer via cable])
+ (subsection
+ :title [debugging common connection problems])
+ (subsection
+ :title [arduino reset button]))
+ (section
+ :title [left sonar]
+ (subsection
+ :title [breadboard connectivity])
+ (subsection
+ :title [cable])
+ (subsection
+ :title [arduino headers])
+ (subsection
+ :title [sound cm per microsecond at sea level]))
+ (section
+ :title [both sonars]
+ (subsection
+ :title [breadboard power rail]
+ (p [power rail can provide power to more than one device.])))
+ (section
+ :title [left motor]
+ (subsection
+ :title [arduino digital output])
+ (subsection
+ :title [quad half h bridge, aka motor controller])
+ (subsection
+ :title [motor battery]))
+ (section
+ :title [both motors]
+ (subsection
+ :title [analogWrite]))
+ (section
+ :title [untethered]
+ (subsection
+ :title [arduino battery])
+ (subsection
+ :title [off and on functions]))
+ (section
+ :title [follow]
+ (subsection
+ :title [same wiring as untethered])
+ (subsection
+ :title [set motor])
+ (subsection
+ :title [go])
+ (subsection
+ :title [determining speed]))
+ (section
+ :title [stay on table]
+ (subsection
+ :title [stop])
+ (subsection
+ :title [backup])
+ (subsection
+ :title [turn around]))))
;; Copyright 2016 daniel watson