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