63aa0d0cd2d6d5dcb5d3c1642e47bc3d735c551c
[challenge-bot] / curriculum / challenge-bot.scm
1 ;; tldr; AGPLv3+
2 ;; copyright info at bottom
3
4 (document
5 :title [challenge-bot]
6 (chapter
7 :title [mechanical]
8 (section
9 :title [arduino to deck]
10 (subsection
11 :title [required materials]
12 (p [you will need the things in this picture.
13 ,(figure :legend "arduino to deck / required materials"
14 (image :file "arduino-to-deck/0-required-materials.png"))
15 ,(itemize
16 (item [medical kit with bandages])
17 (item [safety goggles])
18 (item [drill bit \(we will determine size in a moment\)])
19 (item [drill])
20 (item [alan wrench])
21 (item [wood block])
22 (item [arduino])
23 (item [#6-32x3/8\", four of them]))]))
24 (subsection
25 :title [first hole]
26 (subsubsection
27 :title [choosing drill bit])
28 (subsubsection
29 :title [inserting drill bit])
30 (subsubsection
31 :title [holding drill])
32 (subsubsection
33 :title [arduino placement]
34 (p [the arduino should be placed as shown in this picture.]
35 (figure :legend "arduino to deck / place arduino"
36 (image :file "arduino-to-deck/3-place-arduino.png"))
37 [the top edge of the arduino should line up with the underside
38 of the holes closest to the edge of the deck.
39 on the arduino, there's a hole on the top left.
40 that hole should be mid-way between two of the holes in the
41 grid of holes on the deck.
42 put the arduino hole between the third and fourth holes
43 from the left side of the deck.]))
44 (subsubsection
45 :title [drilling]))
46 (subsection
47 :title [first screw]
48 (subsubsection
49 :title [fastening arduino to deck using #6-32x3/8\" screw]
50 (p [the "#6" part of "#6-32x3/8\"" is how big around the bolt is.
51 it is related to wire gauge.
52 bigger numbers mean larger screw.
53 smaller numbers means smaller screws.])
54 (p [check
55 ,(itemize
56 (item
57 [in the motor assembly, there are #4-40x1.25\" screws.
58 are those fatter, thinner, or the same thickness as the
59 #6-32x3/8\" screws?]))])
60 (p [the "32" part is a measurement of how close the threads are to
61 each other.
62 this is related to the angle of the thread, which is also
63 called pitch.
64 it is a count of how many times the thread wraps around one
65 inch of the screw body.])
66 (p [the head is the flat part where some tool, like the alan
67 wrench, can exert force to spin the screw.])
68 (p [check
69 ,(itemize
70 (item [how many times will the thread wrap around one inch of
71 the screw body?])
72 (item [what about 2 inches?
73 how many times will the thread wrap around two
74 inches of the screw body?]))]))
75 (subsubsection
76 :title [fasten the arduino board to the deck]
77 (p [push the 6-32 screw into the deck from the underside and at the
78 same time, spin the 6-32 screw clockwise while looking
79 down on its head.
80 twist until the bottom of the screw is
81 about to stick out on the top side of the deck.])
82 (p [hold the arduino board flat to the deck and line up the arduino
83 hole so the screw can come up through it.
84 continue tightening the screw into the deck, spinning the same
85 direction as before.
86 tighten until the screw head touches the deck.
87 do not continue tightening after that.])
88 (p [the arduino should still be flat against the deck still, just
89 as it was before tightening the screw.]))
90 (subsubsection
91 :title [assessment]
92 (p [does the arduino stay with the deck when the deck moves?
93 can the arduino board still rotate a few degrees?
94 warning, if you rotate the arduino board too much, you
95 will unscrew it from the deck and you'll have to screw it
96 back in.
97 rotating a few degrees should be ok.]))
98 (subsubsection
99 :title [arduino board move relative to deck]
100 (p [without any screws, the arduino board can move independently of
101 the deck.])
102 (p [with the first screw, the arduino can rotate around one point
103 on the deck.])))
104 (subsection
105 :title [second hole and screw])
106 (subsection
107 :title [third and fourth hole and screw]))
108 (section
109 :title [breadboard])
110 (section
111 :title [battery packs]
112 (subsection
113 :title [leads])
114 (subsection
115 :title [deck attachment]))
116 (section
117 :title [motors]
118 (subsection
119 :title [leads])
120 (subsection
121 :title [mount])
122 (subsection
123 :title [deck attachment]))
124 (section
125 :title [wheels]
126 (subsection
127 :title [tread])
128 (subsection
129 :title [motor]))
130 (section
131 :title [caster]
132 (subsection
133 :title [deck placement]))
134 (section
135 :title [sonars]
136 (subsection
137 :title [deck placement])))
138 (chapter
139 :title [wiring and software]
140 (section
141 :title [serial]
142 (subsection
143 :title [software on computer]
144 (subsubsection
145 :title [arduino])
146 (subsubsection
147 :title [fritzing]))
148 (subsection
149 :title [attach arduino and computer via cable])
150 (subsection
151 :title [debugging common connection problems])
152 (subsection
153 :title [arduino reset button]))
154 (section
155 :title [left sonar]
156 (subsection
157 :title [breadboard connectivity])
158 (subsection
159 :title [cable])
160 (subsection
161 :title [arduino headers])
162 (subsection
163 :title [sound cm per microsecond at sea level]))
164 (section
165 :title [both sonars]
166 (subsection
167 :title [breadboard power rail]
168 (p [power rail can provide power to more than one device.])))
169 (section
170 :title [left motor]
171 (subsection
172 :title [arduino digital output])
173 (subsection
174 :title [quad half h bridge, aka motor controller])
175 (subsection
176 :title [motor battery]))
177 (section
178 :title [both motors]
179 (subsection
180 :title [analogWrite]))
181 (section
182 :title [untethered]
183 (subsection
184 :title [arduino battery])
185 (subsection
186 :title [off and on functions]))
187 (section
188 :title [follow]
189 (subsection
190 :title [same wiring as untethered])
191 (subsection
192 :title [set motor])
193 (subsection
194 :title [go])
195 (subsection
196 :title [determining speed]))
197 (section
198 :title [stay on table]
199 (subsection
200 :title [stop])
201 (subsection
202 :title [backup])
203 (subsection
204 :title [turn around]))))
205
206 ;; Copyright 2016 daniel watson
207
208 ;; This file is part of challenge-bot.
209
210 ;; challenge-bot is free software: you can redistribute it and/or modify
211 ;; it under the terms of the GNU Affero General Public License as
212 ;; published by the Free Software Foundation, either version 3 of the
213 ;; License, or (at your option) any later version.
214
215 ;; challenge-bot is distributed in the hope that it will be useful,
216 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
217 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
218 ;; GNU Affero General Public License for more details.
219
220 ;; You should have received a copy of the GNU Affero General Public
221 ;; License along with challenge-bot. If not, see
222 ;; <http://www.gnu.org/licenses/>.