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