Zodiac
Zodiac is FRC Team 1816's robot for the 2020 FRC season, FIRST Infinite Recharge. This software uses Java 11, the WPILib library, and the CTRE Phoenix library.
Prerequisites
- You must have Java 11 installed on your system. You can download OpenJDK 11 here or download Oracle's JDK 11 here. Alternatively, this will be installed through the WPILib One-Click Installer.
- You must have an IDE of your choice installed. Visual Studio Code or IntelliJ IDEA are recommended as official and unofficial options. VSCode can be optionally installed using the WPILib One-Click Installer.
- You must have Git installed.
- It is recommended that you run the WPILib One-Click Installer. This includes the VSCode plugins as well as all NI software tools. It does NOT include any CTRE software tools.
Cloning
Open a new Bash shell and clone:
$ git clone https://github.com/TheGreenMachine/Zodiac.git
Importing
Importing into IntelliJ IDEA
- Clone the project into your desired folder.
- Open IntelliJ IDEA to the welcome screen.
- Do NOT select 'Open Project'. Instead, select 'Import Project'.
- Select
Import project from external model
. Then select 'Gradle'.
- Configure your Gradle options:
- Make sure to select the "Use gradle 'wrapper' task configuration' option.
- Verify that the Gradle JVM is set to 'Use Project JDK' (which should be Java 11).
- Keep other options as their defaults.
- Select 'Finish'. Your project should load in and be set up without issues.
Importing into Visual Studio Code
- Make sure Visual Studio Code is properly set up with the Java Development Toolchains. Refer to the WPILib Screensteps Guide for further instructions.
- Clone the project into your desired folder.
- The WPILib VSCode extension should automatically detect and setup your project.
Build and Deploy
Build the project by running the build task through the Gradle wrapper. Just issue the following command in a Bash shell:
$ ./gradlew build
This command isn't always necessary as it is often run by your IDE.
Deploy the project to the robot by first connecting to the robot's wi-fi network and then running the following command:
$ ./gradlew deploy
The deploy task will call the build task automatically.
To clear previous built binaries and minimize the possibility of bugs, it is recommended to run the clean task before deploying:
$ ./gradlew clean deploy
2020 - FRC Team 1816 The Green Machine