brians | a39ed32 | 2013-02-14 23:00:51 +0000 | [diff] [blame] | 1 | This file contains instructions on how to set up a computer to build the code. |
| 2 | |
jerrym | 1e9e180 | 2013-03-11 08:00:20 +0000 | [diff] [blame] | 3 | [OS] |
| 4 | Most of these instructions assume 64 bit Debian Squeeze. |
| 5 | |
brians | a39ed32 | 2013-02-14 23:00:51 +0000 | [diff] [blame] | 6 | [Install Packages] |
| 7 | First, you have to download and follow the directions in |
| 8 | <http://robotics.mvla.net/files/frc971/packages/frc971.list>. |
Brian Silverman | 9b7a684 | 2014-05-05 16:19:11 -0700 | [diff] [blame^] | 9 | Then, run `apt-get install python3`. |
| 10 | The 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. |
brians | a39ed32 | 2013-02-14 23:00:51 +0000 | [diff] [blame] | 13 | You will have to accept the |
Brian Silverman | 9b7a684 | 2014-05-05 16:19:11 -0700 | [diff] [blame^] | 14 | "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. |
brians | a39ed32 | 2013-02-14 23:00:51 +0000 | [diff] [blame] | 17 | |
| 18 | [Running Locally] |
| 19 | If 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. |
michael | a91ebd9 | 2013-02-23 06:01:00 +0000 | [diff] [blame] | 22 | |
| 23 | [Compiling and Downloading] |
Brian Silverman | 9b7a684 | 2014-05-05 16:19:11 -0700 | [diff] [blame^] | 24 | Run 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. |
michael | a91ebd9 | 2013-02-23 06:01:00 +0000 | [diff] [blame] | 33 | |
| 34 | [Communicating with the cRIO] |
Brian Silverman | 9b7a684 | 2014-05-05 16:19:11 -0700 | [diff] [blame^] | 35 | Use netconsole (in the amd64 outputs directories) to communicate directly with |
| 36 | the cRIO. |
michael | a91ebd9 | 2013-02-23 06:01:00 +0000 | [diff] [blame] | 37 | Use "reboot" from within netconsole.sh will reboot the cRIO. ^C will |
Brian Silverman | 9b7a684 | 2014-05-05 16:19:11 -0700 | [diff] [blame^] | 38 | 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. |
| 41 | Make sure your computer is on the right subnet first. |