blob: c2676d1126f9e5181ef40827ad3f4ede8b463fe0 [file] [log] [blame]
This file contains instructions on how to set up a computer to build the code.
[OS]
Most of these instructions assume 64 bit Debian Wheezy.
[Install Packages]
First, you have to download and follow the directions in
<http://robotics.mvla.net/files/frc971/packages/frc971.list>.
Then, run `apt-get install python3`.
The build script will tell you what other packages to install when you run it.
It's pretty smart about not checking for things it doesn't need, so you might
want to build 'deploy all' to see everything it wants.
You will have to accept the
"WARNING: The following packages cannot be authenticated!" warning for
various packages downloaded from our package repository.
This works for amd64 Wheezy, no guarantees or support for anything else.
[Running Locally]
If you want to be able to run the realtime code on your development machine
without just disabling the realtime part (set the AOS_NO_REALTIME environment
variable), follow the directions in //aos/config/aos.conf.
If you want to run the clang or gcc_4.8 amd64 code, add /opt/clang-3.5/lib64/ to
LD_LIBRARY_PATH. Using the system gcc-compiled versions should just work.
[Compiling and Downloading]
Run //frc971/*/build.sh.
Give it clean, tests, or deploy as a first argument to do something other
than just build.
Each action (build (the default), clean, tests, or deploy) has a different
default set of versions of the code it builds. You can change those by
passing another argument. Some popular ones are 'all' (build everything),
'clang-amd64-none' (the most basic one for local testing), and
'gcc_frc-arm-nodebug' (the one that gets downloaded). See its --help for
more details.
[Communicating with the cRIO]
Use netconsole (in the amd64 outputs directories) to communicate directly with
the cRIO.
Use "reboot" from within netconsole.sh will reboot the cRIO. ^C will
stop the netconsole program. "version" will tell you the the
VxWorks and WIND versions and "help" will give you a list of VxWorks
commands that you can use.
Make sure your computer is on the right subnet first.