= Welcome to Software! =

== Gear Needed
To start developing robot software for team 2537 you will need the following
   * A laptop running Windows 7 or Windows 10
   * USB [https://www.amazon.com/dp/B0769GFWCZ A-B cable]
   * USB [https://www.amazon.com/PXN-PRO-2113-Professional-Controller/dp/B01JY0RAW2 Joystick] or USB [https://www.amazon.com/Logitech-940-000110-Gamepad-F310/dp/B003VAHYQY XBox controller]
   * Optional: USB [https://www.amazon.com/Genius-120-degree-Conference-Webcam-WideCam/dp/B0080CE5M4 webcam]
   * One of:
       * A robot 
       * A RoboRIO (the computer that controls the robot) and a 12v power supply 

== Setup your laptop:
   1. Install the Java [https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html JDK 8]
   2. Install Microsoft [https://code.visualstudio.com/download VSCode] and the [https://github.com/wpilibsuite/vscode-wpilib/releases latest WPILib] extension.  Detailed instructions are [https://wpilib.screenstepslive.com/s/currentCS/m/79833/l/932382-installing-vs-code here]
   3. Install the National Instruments (NI) FRC 2018 Update Suite [http://www.ni.com/download/first-robotics-software-2015/5112/en/ here].  Detailed instructions are [https://wpilib.screenstepslive.com/s/4485/m/getting_started/l/599670-installing-the-frc-update-suite-all-languages here]

== Start with an example
The best way to learn about robot programming a robot is to start with a simple example program, run it, study what it does, and incrementally expand its functionality.  The WPILib software you installed includes example programs that you can compile and run on a RoboRIO.  Review [https://wpilib.screenstepslive.com/s/currentCS/m/79833/l/941601-vs-code-basics-and-wpilib-in-vs-code how to use VSCode] and then try [https://wpilib.screenstepslive.com/s/currentCS/m/79833/l/932465-creating-a-new-wpilib-project-in-vs-code creating a new robot project].

* WPILib provides [https://wpilib.screenstepslive.com/s/currentCS/m/java/l/599697-choosing-a-base-class 3 frameworks] for building robot programs.  Build your first program using the iterative robot framework as described [https://wpilib.screenstepslive.com/s/currentCS/m/java/l/145307-creating-your-benchtop-test-program here].

   * Connect your laptop to the RoboRIO USB port
   * Connect your joystick or xbox controller to another USB port on your laptop
   * Launch the NI Driver Station Software.  For details see [https://wpilib.screenstepslive.com/s/4485/m/24192/l/144976-frc-driver-station-powered-by-ni-labview here]
   * Confirm that the software detects your joystick/controller and responds to button presses and stick movement 
   * Use Microsoft Internet Explorer (not Chrome or Firefox) to connect to the RoboRIO's web interface (usually at http://172.22.11.2) and confirm that you have connectivity with the RobORIO
   * Create a test project and follow [https://wpilib.screenstepslive.com/s/currentCS/m/79833/l/932465-creating-a-new-wpilib-project-in-vs-code these instructions] to build, load, and run it on your RoboRIO/Robot

**Congratulations**, you've just built and run your first robot program.

* Create another WPILib project based on the IterativeRobot framework 
   * Start with the base program

* You can learn more about FRC robot programming [https://frc-pdr.readthedocs.io/en/latest/index.html here]
* You can learn more about game controllers [https://github.com/MTHSRoboticsClub/Documentation/wiki/Drive-Controller-Comparison here]