Fixing the frcsim installer script

URL for simulation zip changed as of gerrit 1264
script argument name changed from INSTALLER to INSTALL
fixed jar and logo paths for sim_ds

to use the script, it's now simply:
./frcsim-installer.sh INSTALL

You can optionally supply a promotion status from which to install, such as
./frcsim-installer.sh INSTALL beta
./frcsim-installer.sh INSTALL development

Also added some information to the README

Also allow any type of file install-resources since it may contain
libraries and jars

Change-Id: Ie876a05c88d3d48b8592f1800959988ae66edd04
This commit is contained in:
Peter_Mitrano
2015-12-29 19:16:52 -05:00
parent c01146eb02
commit 70bc630f1f
8 changed files with 140 additions and 55 deletions

View File

@@ -1,27 +1,32 @@
## Simulation Directory
## Components and Location
Observe the following directory structure:
.
|-- frc_gazebo_plugins (contains Gazebo Plugins)
| |-- clock
| |-- dc_motor
| |-- encoder
| |-- gyro
| |-- plugins
| |-- pneumatic_piston
| |-- potentiometer
| |-- rangefinder
| |-- servo
|
|-- frcsim (launches gazebo with model/plugin paths on linux)
|-- JavaGazebo (java library used by java simulation. Equivelant of the C++ gazebo_transport)
|-- SimDS (linux driverstation)
Simluation is a mix of wpilib and other components.
The wpilib components are in their respective locations in the /wpilibc and /wpilibj directories.
The gazbeo plugins are currently built with CMake.
Eventually they will be built with gradle.
All of this is delivered to students via a zip file.
## Simulation delivery and installation
For 2016 FRCSim is only officially supported on Ubuntu 14.04 or greater.
However it is possible on any platform that runs Gazebo.
FRCSim is currently delivered via a zip file published by this project,
and is available at first.wpi.edu/FRC/roborio/maven/PROMOTION_STATUS/edu/wpi/first/wpilib/simulation/simulation/1.0.0/simulation-1.0.0.zip
where PROMOTION_STATUS is one of:
- development (the latest commit merged into wpilib)
- beta (used periodically before release)
- release (used just before kick-off and possibly a few other times)
- stable (used for old releases we want to keep around)
The zip contains most of the contents of ~/wpilib/simulation, such as C++ libraries, jars, and scripts
The exmple robot model files are seperate, and can be found under "file releases" on collabnet.
All together you need eclipse, gazebo, those two zips, g++ 4.9, java8, and a few other small packages.
See the frcsim-installer script or the screensteps on manual install for all the nitty-gritty details
The frcsim-installer script is meant for quick and painless setup on Ubuntu 14.04, 15.04, or 15.10
A manual install is a more tedious process, so this is an easy option for students.
## Building
See the top level README.md.