create written instructions

diff --git a/instructions.org b/instructions.org
new file mode 100644 (file)
index 0000000..4274d8f
--- /dev/null
+++ b/instructions.org
@@ -0,0 +1,151 @@
+* build robot
+** attach arduino to deck
+*** TODO: redo video with safety goggles
+   #+BEGIN_HTML
+   <iframe width="560" height="315" src="https://www.youtube.com/embed/fCKTvFn4hdU" frameborder="0" allowfullscreen></iframe>
+   #+END_HTML
+   [[https://youtu.be/fCKTvFn4hdU][attach arduino to deck video]]
+*** keep in mind a few things while drilling holes
+**** wear safety goggles
+**** don't put new holes near existing holes
+**** orient the arduino with usb toward front left corner of deck
+**** center arduino left-right wise
+**** a little back from the front most to make room to plug in usb
+** attach breadboard to deck
+   #+BEGIN_HTML
+   <iframe width="560" height="315" src="https://www.youtube.com/embed/JfFI6C1OLig" frameborder="0" allowfullscreen></iframe>
+   #+END_HTML
+   [[https://youtu.be/JfFI6C1OLig][attach breadboard to deck video]]
+   make sure the blue line is close to the arduino header,
+   and the h-bridge is to the right
+** build motor assembly
+*** solder motor leads
+**** TODO: redo video to include electrical taping under wires
+    #+BEGIN_HTML
+    <iframe width="560" height="315" src="https://www.youtube.com/embed/tcC-Al8zxlM" frameborder="0" allowfullscreen></iframe>
+    #+END_HTML
+    [[https://youtu.be/tcC-Al8zxlM][solder motor leads video]]
+**** put electrical tape under wires (not shown in video)
+**** zip tie wires to motor body
+*** test the motor lead soldering
+    #+BEGIN_HTML
+    <iframe width="560" height="315" src="https://www.youtube.com/embed/HPwlmW3UkqQ" frameborder="0" allowfullscreen></iframe>
+    #+END_HTML
+    [[https://youtu.be/HPwlmW3UkqQ][motor test video]]
+*** attach motor to motor mount
+    #+BEGIN_HTML
+    <iframe width="560" height="315" src="https://www.youtube.com/embed/Tgndz5hH8tU" frameborder="0" allowfullscreen></iframe>
+    #+END_HTML
+    [[https://youtu.be/Tgndz5hH8tU][motor to motor mount video]]
+** attach motor assembly to deck
+   #+BEGIN_HTML
+   <iframe width="560" height="315" src="https://www.youtube.com/embed/4JT3nX-__eI" frameborder="0" allowfullscreen></iframe>
+   #+END_HTML
+   [[https://youtu.be/Tgndz5hH8tU][motor mount to deck video]]
+** attach caster to deck
+   #+BEGIN_HTML
+   <iframe width="560" height="315" src="https://www.youtube.com/embed/BogX2-5BYLQ" frameborder="0" allowfullscreen></iframe>
+   #+END_HTML
+   [[https://youtu.be/BogX2-5BYLQ][attach caster to deck video]]
+** attach wheel to motor
+   #+BEGIN_HTML
+   <iframe width="560" height="315" src="https://www.youtube.com/embed/jq2YKoxc46M" frameborder="0" allowfullscreen></iframe>
+   #+END_HTML
+   [[https://youtu.be/jq2YKoxc46M][attach wheel to motor video]]
+** solder solid core wire to battery pack leads
+   #+BEGIN_HTML
+   <iframe width="560" height="315" src="https://www.youtube.com/embed/Zuj5s_G_Rq4" frameborder="0" allowfullscreen></iframe>
+   #+END_HTML
+   [[https://youtu.be.com/Zuj5s_G_Rq4][battery wire leads video]]
+** attach the battery packs to the deck
+   #+BEGIN_HTML
+   <iframe width="560" height="315" src="https://www.youtube.com/embed/I9E-8ism_Es" frameborder="0" allowfullscreen></iframe>
+   #+END_HTML
+   [[https://youtu.be.com/I9E-8ism_Es][attach battery packs to deck video]]
+*** attach 4xAA battery pack to deck
+*** attach 9v battery to deck
+** attach sonar to deck
+   #+BEGIN_HTML
+   <iframe width="560" height="315" src="https://www.youtube.com/embed/5PPpd3P8G8Q" frameborder="0" allowfullscreen></iframe>
+   #+END_HTML
+   [[https://youtu.be.com/5PPpd3P8G8Q][attach sonar to deck video]]
+* wire & program robot
+** make the arduino blink
+   #+BEGIN_HTML
+   <iframe width="560" height="315" src="https://www.youtube.com/embed/EOPU1hPpqXI" frameborder="0" allowfullscreen></iframe>
+   #+END_HTML
+   [[https://youtu.be.com/EOPU1hPpqXI][make arduino blink video]]
+*** troubleshooting
+    if your arduino doesn't blink, make sure you have the right
+    board and port selected
+   #+BEGIN_HTML
+   <iframe width="560" height="315" src="https://www.youtube.com/embed/msfuZ8UldFA" frameborder="0" allowfullscreen></iframe>
+   #+END_HTML
+   [[https://youtu.be.com/msfuZ8UldFA][arduino pick board and port settings video]]
+** set up arduino sketchbook
+   you can set arduino's default location to look for libraries
+   #+BEGIN_HTML
+   <iframe width="560" height="315" src="https://www.youtube.com/embed/Torsycgv5Ag" frameborder="0" allowfullscreen></iframe>
+   #+END_HTML
+   [[https://youtu.be.com/Torsycgv5Ag][arduino sketchbook location setting video]]
+** arduino serial communication with computer
+   #+BEGIN_HTML
+   <iframe width="560" height="315" src="https://www.youtube.com/embed/gy9ef4aaNfw" frameborder="0" allowfullscreen></iframe>
+   #+END_HTML
+   [[https://youtu.be.com/gy9ef4aaNfw][arduino serial communication video]]
+** left sonar
+   #+BEGIN_HTML
+   <iframe width="560" height="315" src="https://www.youtube.com/embed/wqRsIbiNaWY" frameborder="0" allowfullscreen></iframe>
+   #+END_HTML
+   [[https://youtu.be.com/wqRsIbiNaWY][hook up left sonar video]]
+*** wire up left sonar
+*** test left sonar
+*** troubleshooting continuity
+    here's how to identify exactly where the problem is, if the
+    sonar doesn't work correctly.
+**** TODO: make new video with sonar cable instead of individual sonar wires
+   #+BEGIN_HTML
+   <iframe width="560" height="315" src="https://www.youtube.com/embed/QRTVVxo6Q00" frameborder="0" allowfullscreen></iframe>
+   #+END_HTML
+   [[https://youtu.be.com/QRTVVxo6Q00][troubleshooting continuity video]]
+** both sonars
+   #+BEGIN_HTML
+   <iframe width="560" height="315" src="https://www.youtube.com/embed/qitvbDJVe0o" frameborder="0" allowfullscreen></iframe>
+   #+END_HTML
+   [[https://youtu.be.com/qitvbDJVe0o][both sonars video]]
+*** wire up right sonar
+*** test both sonars
+** left motor
+   #+BEGIN_HTML
+   <iframe width="560" height="315" src="https://www.youtube.com/embed/NpH8WCneN4g" frameborder="0" allowfullscreen></iframe>
+   #+END_HTML
+   [[https://youtu.be.com/NpH8WCneN4g][left motor video]]
+*** wire up left motor
+*** test left motor
+** both motors
+   #+BEGIN_HTML
+   <iframe width="560" height="315" src="https://www.youtube.com/embed/YBmu9ioP4bw" frameborder="0" allowfullscreen></iframe>
+   #+END_HTML
+   [[https://youtu.be.com/YBmu9ioP4bw][both motors video]]
+*** wire up right motor
+*** test both motors
+** untethered robot
+   #+BEGIN_HTML
+   <iframe width="560" height="315" src="https://www.youtube.com/embed/7wVVx8pjqdY" frameborder="0" allowfullscreen></iframe>
+   #+END_HTML
+   [[https://youtu.be.com/7wVVx8pjqdY][untethered robot video]]
+*** wire up 9v battery pack
+*** unplug usb from arduino
+*** turn on both battery packs
+** follow
+   #+BEGIN_HTML
+   <iframe width="560" height="315" src="https://www.youtube.com/embed/oL6qntiHEEA" frameborder="0" allowfullscreen></iframe>
+   #+END_HTML
+   [[https://youtu.be.com/oL6qntiHEEA][follow video]]
+** stay on table
+   #+BEGIN_HTML
+   <iframe width="560" height="315" src="https://www.youtube.com/embed/xMGoUElyPzg" frameborder="0" allowfullscreen></iframe>
+   #+END_HTML
+   [[https://youtu.be.com/xMGoUElyPzg][stay on table video]]
+* TODO: don't say "so now" at the beginning of every video
+* TODO: say title of video as first words