blob: fc3a7ae84323b074709d6844951511ee24b7de30 [file] [log] [blame]
briansa39ed322013-02-14 23:00:51 +00001This file contains instructions on how to set up a computer to build the code.
2
jerrym1e9e1802013-03-11 08:00:20 +00003[OS]
4Most of these instructions assume 64 bit Debian Squeeze.
5
briansa39ed322013-02-14 23:00:51 +00006[Install Packages]
7First, you have to download and follow the directions in
8 <http://robotics.mvla.net/files/frc971/packages/frc971.list>.
Brian Silverman9b7a6842014-05-05 16:19:11 -07009Then, run `apt-get install python3`.
10The build script will tell you what other packages to install when you run it.
11 It's pretty smart about not checking for things it doesn't need, so you might
12 want to build 'deploy all' to see everything it wants.
briansa39ed322013-02-14 23:00:51 +000013 You will have to accept the
Brian Silverman9b7a6842014-05-05 16:19:11 -070014 "WARNING: The following packages cannot be authenticated!" warning for
15 various packages downloaded from our package repository.
16 This works for amd64 Wheezy, no guarantees or support for anything else.
briansa39ed322013-02-14 23:00:51 +000017
18[Running Locally]
19If you want to be able to run the realtime code on your development machine
20 without just disabling the realtime part (set the AOS_NO_REALTIME environment
21 variable), follow the directions in /src/aos/config/aos.conf.
michaela91ebd92013-02-23 06:01:00 +000022
23[Compiling and Downloading]
Brian Silverman9b7a6842014-05-05 16:19:11 -070024Run src/frc971/{atom_code,crio}/build.sh.
25 Give it clean, tests, or deploy as a first argument to do something other
26 than just build.
27 Each action (build (the default), clean, tests, or deploy) has a different
28 default set of versions of the code it builds. You can change those by
29 passing another argument. Some popular ones are 'all' (build everything),
30 'clang-amd64-none' (the most basic one for local testing), and
31 'gcc-arm-nodebug' (the one that gets downloaded). See its --help for
32 more details.
michaela91ebd92013-02-23 06:01:00 +000033
34[Communicating with the cRIO]
Brian Silverman9b7a6842014-05-05 16:19:11 -070035Use netconsole (in the amd64 outputs directories) to communicate directly with
36 the cRIO.
michaela91ebd92013-02-23 06:01:00 +000037Use "reboot" from within netconsole.sh will reboot the cRIO. ^C will
Brian Silverman9b7a6842014-05-05 16:19:11 -070038 stop the netconsole program. "version" will tell you the the
39 VxWorks and WIND versions and "help" will give you a list of VxWorks
40 commands that you can use.
41Make sure your computer is on the right subnet first.