2 ;; copyright info at bottom
8 (p [let's build your robot!])
10 :title [arduino to deck]
11 (p [let's attach the arduino to the deck.])
13 :title [required materials]
14 (p [you will need the things in this picture.])
16 :legend "arduino to deck / required materials"
18 "0-arduino-to-deck/0-required-materials.png"))
20 (item [medical kit with bandages])
21 (item [safety goggles])
22 (item [drill bit \(we will determine size in a moment\)])
27 (item [#6-32x3/8\", four of them])
28 (item [robot deck, the white thing with a grid of holes])))
32 :title [choosing drill bit]
33 (p [the arduino comes with holes in it already, so we will make
34 some choices around those holes.
35 choosing the right drill bit depends on what job you are
37 right now, we are making holes for screws to hold the
39 there are two constraints between the hole and screw.
40 each hole needs to be big enough for the screw body to fit
42 the holes also need to be smaller than the screw's thread.
43 since there are holes on the arduino already, the screw was
45 the screw was chosen so that the hole on the arduino was
46 bigger than the screw body and smaller than its thread.
47 we will choose the biggest drill bit that fits through the
48 hole on the arduino, then use that to drill holes in the
50 (p [here's a cross section of a screw in the deck])
51 (figure :legend "screw cross section"
53 "0-arduino-to-deck/screw-cross-section.png"))
57 [what would happen if the drill bit were larger than the
60 [what would happen if the drill bit were smaller than the
63 :title [inserting drill bit]
64 (figure :legend "arduino to deck / insert bit"
65 (image :file "0-arduino-to-deck/1-insert-bit.png"))
66 (p [insert the drill bit into the teeth of the drill.
67 insert it far enough that the teeth will clamp on the
68 smooth part of the bit when they are tightened.])
70 :legend "arduino to deck / twist tighten drill teeth"
72 :file "0-arduino-to-deck/2-twist-tighten-drill-teeth.png"))
73 (p [while holding the drill bit, twist end of the drill to tighten
75 make sure that the teeth end up gripping the flat part of
80 [where should the teeth clamp down on the drill bit?])
82 [what would happen if the teeth tightened on the recessed
83 part of the drill bit?])))
85 :title [holding drill]
86 (p [hold the drill with one hand on the handle and trigger.
87 put the other hand on the orange nozzle, before the
88 black spinning part.]))
90 :title [arduino placement]
91 (p [the arduino should be placed as shown in this picture.])
92 (figure :legend "arduino to deck / place arduino"
93 (image :file "0-arduino-to-deck/3-place-arduino.png"))
94 (p [here's a closeup])
95 (figure :legend "arduino to deck / place arduino closeup"
97 "0-arduino-to-deck/4-place-arduino-closeup.png"))
98 (p [the picture above shows where to place the arduino on the deck.
99 the arduino should line up with the holes on the deck.
100 this alignment line is highlighted in pink.
101 on the arduino, there's a hole on the top left, between the
102 orange reset button and black headers.
103 the green circle shows where the hole is.
104 the blue box encloses the arduino hole and two deck holes.
105 place the arduino hole mid-way between the two
110 [should the arduino be upside-down?])
112 [what should the upper side of the arduino align with?])
114 [why not place the arduino up along the left side of the
117 :title [drilling practice]
120 (item [put on safety goggles])
121 (item [unplug drill])
122 (item [hold drill in one hand])
123 (item [point drill at the ground])
124 (item [point drill at the wall]))
125 (p [steps for drilling into wood block])
127 (item [plug in the drill])
128 (item [place the drill bit in position])
129 (item [bring the drill up to full speed, and keep it at full
130 speed while lowering and raising the drill])
131 (item [push down until the drill bit has passed through an inch
133 (item [keep the drill at full speed])
134 (item [stop before the drill smashes into the wood block])
135 (item [keep the drill at full speed by holding the trigger])
136 (item [bring the drill straight back up])
137 (item [hold the trigger down to keep the drill at full speed])
138 (item [once the drill is back out of the hole, let go of the
143 [should the drill be at full speed while the drill bit is
144 going down into the wood and coming back up?])
146 [how do you keep the drill at full speed?])
148 [what would happen if the drill bit were not at full
151 [what would happen if the drill were twisted sideways while
152 the drill bit were in the wood?])))
154 :title [drilling the first screw hole]
156 (item [place the drill bit in position])
157 (item [bring the drill up to full speed, and keep it full speed])
158 (item [push down until the drill bit has passed through the
160 (item [keep the drill at full speed])
161 (item [stop before the drill smashes into the arduino])
162 (item [keep the drill at full speed by holding the trigger])
163 (item [bring the drill straight back up])
164 (item [hold the trigger down to keep the drill at full speed])
165 (item [once the drill is back out of the hole, let go of the
170 [should the drill be at full speed while the drill bit is
171 going down into the wood and coming back up?])
173 [what would happen if the drill bit were not at full speed?])
174 (item [how do you keep the drill at full speed?]))))
178 :title [fastening arduino to deck using #6-32x3/8\" screw]
179 (p [the "#6" part of "#6-32x3/8\"" is how big around the bolt is.
180 it is related to wire gauge.
181 bigger numbers mean larger screws.
182 smaller numbers means smaller screws.])
183 (figure :legend "arduino to deck / #6-32 screw"
184 (image :file "0-arduino-to-deck/6-32-screw.png"))
188 [in the motor assembly, there are #4-40x1.25\" screws.
189 are those fatter, thinner, or the same thickness as the
190 #6-32x3/8\" screws?]))
191 (p [the "32" part of "#6-32x3/8\"" is a measurement of how close
192 the threads are to each other.
193 this is related to the angle of the thread, which is also
195 it is a count of how many times the thread wraps around one
196 inch of the screw body.])
197 (p [the head is the flat part where some tool, like the alan
198 wrench, can exert force to spin the screw.])
201 (item [how many times will the thread wrap around one inch of
203 (item [what about 2 inches?
204 how many times will the thread wrap around two
205 inches of the screw body?])
206 (item [where can a tool exert turning force on the screw?])))
208 :title [fasten the arduino board to the deck]
209 (p [first we'll put the screw into the deck just enough so the deck
211 then we will hold the arduino up to the screw and finish
212 tightening the screw down.
213 with the screw partially in, we do not have hold it as
214 rigidly while we are also holding the arduino and
216 (p [push the #6-32 screw into the deck from the underside.
217 the underside is the brown side.
218 at the same time, spin the 6-32 screw so it rotates
219 clockwise while looking down on its head.
220 twist until the tip of the screw is about to stick out on
221 the top side of the deck.])
222 (p [hold the arduino board flat to the deck and line up the arduino
223 hole so the screw can come up through it.
224 continue tightening the screw into the deck, spinning the
225 same direction as before.
226 tighten until the screw head touches the deck.
227 do not continue tightening after that.])
228 (p [the arduino should still be flat against the deck still, just
229 as it was before tightening the screw.])
232 (item [why do we insert the first screw partially before
233 holding up the arduino?])
234 (item [which side of the deck is the top side?])))
236 :title [assessment of the first screw]
238 (item [,(bold [warning]), if you rotate the arduino board too
239 much,you will unscrew it from the deck and you'll have to
241 rotating a few degrees should be ok.])
242 (item [does the arduino stay with the deck when the deck moves?])
243 (item [can the arduino board still rotate a few degrees?]))))
245 :title [second hole and screw]
247 :title [arduino board move relative to deck]
248 (p [without any screws, the arduino board can move independently of
250 it can translate and rotate freely.
251 with the first screw, the arduino can rotate around one
252 point on the deck and can no longer translate much.])
253 (p [the second screw limits rotation a lot.
254 it also makes translation even more difficult.
255 it might even be too small to be detectable by directly
257 (p [to choose where the second hole and screw should go, we should
258 keep in mind that the goal is to attach the deck to the
260 this means minimizing rotation and translation.
261 the picture below shows that the second hole should be as
262 far as possible from the first hole, since that minimizes
265 :legend "arduino to deck / keep holes far apart"
267 :file "0-arduino-to-deck/keep-holes-far-apart.png")))
269 :title [drilling and attaching second screw]
270 (p [to drill the second hole, follow the same steps as drilling the
272 hold the arduino down as before, and drill through the hole
273 furthest away from the first hole.
274 then insert and tighten the screw as before.])))
276 :title [third and fourth hole and screw]
277 (p [even though the arduino is pretty well attached with just 2
278 screws, we will add a third and fourth.
279 this gives practice drilling and tightening screws.
280 it also keeps the arduino fixed even more rigidly.]))
282 :title [assessment of arduino deck attachment]
284 (item [you should now be able to grab the deck and shake it.
285 the arduino should stay firmly in place while you do.])
286 (item [the arduino should be close to but not touching an edge.])
287 (item [there should be no warping on the arduino.
288 this could happen if the screws are too tight.]))))
291 (p [next, let's attach other parts to the deck.
292 we'll start with the breadboard.
293 there are many ways to do this, but one handy approach is
295 glue dots can be placed easily, are good at attaching flat
296 surfaces that directly touch and do not get much stress.])
297 (figure :legend "breadboard to deck / required materials"
299 :file "1-breadboard-to-deck/0-required-materials.png"))
300 (p [for this section, we will need the deck with arduino attached,
301 breadboard, and glue dots.])
302 (figure :legend "breadboard to deck / video"
304 :file "1-breadboard-to-deck/0-breadboard-to-deck.ogv"))
306 (item [take your breadboard out of its bag.])
307 (item [peel the backing.])
308 (item [put the shiny medal plate on the back.])
309 (item [break 4 glue dots away from the rest. put the rest back
311 (item [break off a glue dot from the group of 4, and peel away the
312 backing, exposing a sticky side.])
313 (item [put the glue dot on one corner of the shiny side of the
315 make sure to push it down firmly.])
316 (item [repeat for the other corners.])
317 (item [put the breadboard on the center of the deck.
318 position it so the black chip is on the right, and the
319 blue line is up against the arduino.])
320 (item [press firmly in each of the corners.]))
323 (item [should the black chip be on the right or the left?])
324 (item [how many glue dots should be on the breadboard?])))
326 :title [battery packs]
331 (p ["leads" are the wires coming out of the battery pack.
332 prepare the leads of the batteries by stripping them and
333 placing heat shrink on them.
334 your battery packs are not attached to your deck yet,
335 but that will be the next step.])
336 (figure :legend "batteries / prepare leads / stripping"
338 :file "2-batteries/0-prepare-leads/0-strip.ogv"))
340 (item (bold [do not pick up batteries by their leads!]))
341 (item [strip the leads a tiny bit at a time.
342 keep stripping until a total of an inch is stripped.
343 the leads are made of tons of tiny wires that will
344 tear apart if too much insulation is stripped at
346 wire made of a bunch of tiny wires
347 is "stranded wire".])
348 (item [strip both leads of both batteries.])
349 (item [then place heat shrink on every lead.
350 make sure the heat shrink is either clear or matches
351 the color of the lead.]))
354 (item [should you pick up a battery by its leads?])
355 (item [should you strip the leads a large amount at a time?])
356 (item [what's the name of wires made of a bunch of tiny
360 (p [do the next 2 sections with just one lead at a time.
361 wrap, then solder one battery lead before moving on to the
363 wrap the stranded wire around a solid core wire, as shown
365 (figure :legend "batteries / prepare leads / wrap"
367 :file "2-batteries/0-prepare-leads/1-wrap.ogv"))
368 (p [the solid core wire is the stiff short wire.
369 it is much easier to poke into the breadboard.])
372 (item [why are we using a solid core wire?])))
375 (p [do this next section and the previous with just one lead at a
377 solder the stranded wire and solid core wire, as shown
379 (figure :legend "batteries / prepare leads / solder"
381 :file "2-batteries/0-prepare-leads/2-solder.ogv"))
382 (p [soldering is the process of joining 2 metal things with
385 (item [use the helping hands to grab the wires and hold them in
387 (item [clean off the tip of the soldering iron if it has been
388 sitting still for a while.
389 this cleans off corroded metal.])
390 (item [apply some solder directly to the tip of the soldering
392 this creates a pool of solder on the tip.
393 we will use this to transfer heat to the wires.])
394 (item [put the soldering iron up to the wires.
395 we want the wires to be hot enough to melt the
397 at the same time, poke the solder into the wire.
398 the solder will start melting and quickly spread to
399 hot parts of the wire.
400 there will be smoke.])
401 (item [move the solder away, then move the iron away.]))
404 (item [should the wires melt the solder?])
405 (item [why should we clean off the tip of the soldering iron?])
406 (item [why do we put more solder back on the tip of the iron?]))))
408 :title [deck attachment]
410 :title [motor battery pack attachment]
411 (p [attach the motor battery pack to the robot deck.])
413 :legend "batteries / placement / motor pack"
415 :file "2-batteries/1-placement/0-motor-battery-pack.ogv"))
416 (p [we will use glue dots to attach the motor battery pack to the
418 the pack could be placed anywhere, but we will place it
419 in the lower left side of the robot.
420 this battery pack has 4 AA batteries in it.
421 each battery has 1.5 volts difference between the positive
423 the batteries are connected in series.
424 the total voltage difference for the whole battery pack is
425 the sum of the individual voltages, which is 6 volts.])
427 (item [make sure you are placing dots on the side of the battery
428 pack without the on/off switch.])
429 (item [peel off a glue dot for each of the corners of the
431 (item [when placing the battery pack, make sure the screw hole
432 aligns with a hole on the deck.]))
435 (item [why place the glue dots on the side of the battery pack
436 without the on/off switch?])))))
444 :title [deck attachment]))
454 :title [deck placement]))
458 :title [deck placement])))
460 :title [wiring and software]
464 :title [software on computer]
470 :title [attach arduino and computer via cable])
472 :title [debugging common connection problems])
474 :title [arduino reset button]))
478 :title [breadboard connectivity])
482 :title [arduino headers])
484 :title [sound cm per microsecond at sea level]))
488 :title [breadboard power rail]
489 (p [power rail can provide power to more than one device.])))
493 :title [arduino digital output])
495 :title [quad half h bridge, aka motor controller])
497 :title [motor battery]))
501 :title [analogWrite]))
505 :title [arduino battery])
507 :title [off and on functions]))
511 :title [same wiring as untethered])
517 :title [determining speed]))
519 :title [stay on table]
525 :title [turn around]))))
527 ;; Copyright 2016 daniel watson
529 ;; This file is part of challenge-bot.
531 ;; challenge-bot is free software: you can redistribute it and/or modify
532 ;; it under the terms of the GNU Affero General Public License as
533 ;; published by the Free Software Foundation, either version 3 of the
534 ;; License, or (at your option) any later version.
536 ;; challenge-bot is distributed in the hope that it will be useful,
537 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
538 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
539 ;; GNU Affero General Public License for more details.
541 ;; You should have received a copy of the GNU Affero General Public
542 ;; License along with challenge-bot. If not, see
543 ;; <http://www.gnu.org/licenses/>.