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