1 #+TITLE:hausner challenge-bot overview
2 #+SETUPFILE: org-html-themes/setup/theme-readtheorg.setup
3 * assembling the hardware
4 go to the [[file:0-mechanical-assembly/mechanical-assembly.html][mechanical assembly]] page to see excruciating detail
5 on how to put the mechanical parts together.
7 software is available as nice neat installable packages for
8 Mac OS X, GNU+Linux, and MS Windows.
10 it's also available in source code form, so you can compile it for
13 all software used in this robot is available for you to use for any
14 purpose, improve, and, share those improvements (if you want).
15 ** robot behavior: arduino
16 control how the robot gets information from sensors, and moves
19 https://www.arduino.cc/en/Main/Software
20 ** 3d modeling: openscad
23 use this program to view parts inside the "3d-printables"
24 directory. write code to modify the parts and create completely
27 http://www.openscad.org/downloads.html
31 you can also create your own circuit board layouts and get your
32 design fabricated by fritzing.
34 http://fritzing.org/download/?donation=0
36 extract the contents of .tgz files, like the content of this class.
38 this is needed on MS Windows(tm) only.
40 if you are on Mac OS X, or GNU (on top of cygwin or linux), then you
42 operating systems other than MS Windows can extract class content
43 with no extra software.
47 all the source code for the class is available here:
49 http://challenge-bot.com/repos/?p=challenge-bot;a=snapshot;h=232ff7a14f9d8be27362c268c6cdd1b67f59a24a;sf=tgz
51 what follows is a high level description of the contents of the most
52 important top level directories in the class content.
54 the parts of the robot that are 3d-printed are in this directory.
55 use openscad to open the parts in this directory.
57 all the wiring diagrams and arduino code live in this directory.
59 under this directory, there is one subdirectory for each
61 each build stage is prefixed with a letter to make it appear in
63 for example, =a_serial= contains the first build stage.
65 to troubleshoot a misbehaving robot, go through these stages
66 in order until you find a stage that does not work correctly.
68 first, in =a_serial=, you'll check whether the arduino can
69 communicate over the serial connection with the computer.
71 in each stage, make sure the wires shown in the fritzing
72 diagram are correctly connected on your robot.
73 then load the corresponding arduino sketch to your robot
74 and either check the serial monitor, or turn on the motor battery.
76 this will help you pinpoint exactly where the problem lies on your