a8c9291affd9f9814bafa70672ba6a7ebcc1d834
[challenge-bot] / guide / hausner / overview.org
1 #+TITLE:hausner challenge-bot overview
2 * videos for assembling the hardware
3 * software
4 software is available as nice neat installable packages for
5 Mac OS X, GNU+Linux, and MS Windows.
6
7 it's also available in source code form, so you can compile it for
8 other platforms.
9
10 all software used in this robot is available for you to use for any
11 purpose, improve, and, share those improvements (if you want).
12 ** arduino
13 *** summary
14 control how the robot gets information from sensors, and moves
15 its motors.
16 *** download
17 https://www.arduino.cc/en/Main/Software
18 ** openscad
19 *** summary
20 create robot parts!
21
22 use this program to view parts inside the "3d-printables"
23 directory. write code to modify the parts and create completely
24 new ones.
25 *** download
26 http://www.openscad.org/downloads.html
27 ** fritzing
28 *** summary
29 wire up components!
30 *** download
31 http://fritzing.org/download/?donation=0
32 ** 7-zip
33 *** summary
34 extract the contents of .tgz files, like the content of this class.
35
36 this is needed on MS Windows(tm) only.
37
38 if you are on Mac OS X, or GNU (on cygwin or linux), then you do
39 not need this. your software will be able to extract the
40 class content
41 *** download
42 http://7-zip.org/
43 * class content
44 all the source code for the class is available here:
45
46 http://challenge-bot.com/repos/?p=challenge-bot;a=snapshot;h=232ff7a14f9d8be27362c268c6cdd1b67f59a24a;sf=tgz
47
48 what follows is a high level description of the contents of the most
49 important top level directories in the class content.
50 ** 3d-printables
51 the parts of the robot that are 3d-printed are in this directory.
52 use openscad to open the parts in this directory.
53 ** build-stages
54 all the wiring diagrams and arduino code live in this directory.
55
56 under this directory, there is one subdirectory for each
57 build stage.
58 each build stage is prefixed with a letter to make it appear in
59 order.
60 for example, =a_serial= contains the first build stage.
61 * troubleshooting
62 to troubleshoot a misbehaving robot, go through these stages
63 in order until you find a stage that does not work correctly.
64
65 first, in =a_serial=, you'll check whether the arduino can
66 communicate over the serial connection with the computer.
67
68 in each stage, make sure the wires shown in the fritzing
69 diagram are correctly connected on your robot.
70 then load the corresponding arduino sketch to your robot
71 and either check the serial monitor, or turn on the motor battery.
72
73 this will help you pinpoint exactly where the problem lies on your
74 robot.