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