Welcome to our code for 2017! This repo contains code for both FTC Team 4042 "Nonstandard Deviation" and for Team 12788 "Ultraviolet".

This is an Android Studio project to create the FTC Robot Controller app.

This repository is no longer current! For our code from the 2018-19 FTC season "Rover Ruckus", see this repo.

A quick summary, visit our website or contact us for more info.

• Uses OpenCV and Vuforia to identify the pictograph and opposing alliance's jewel
• Reads instructions from files
• Uses an array of IRs and sonars to navigate the field
• Every movement uses a PID controller
• Uses a gyroscope to identify when we've driven off the balancing stone
• Autonomously opens the intakes
• Autonomously collects glyphs and aligns them

• Glyph placing system is entirely autonomous. It determines glyph color, then uses artificial intelligence to place it in an efficient and strategic place depending on the cipher and previously placed glyphs. Based on that, the glyph placer indexes vertically using encoders and horizontally using limit switches, then places the glyph and indexes back to the home position - all automatically.
• Four different glyph placing modes (AI, automated drive, manual drive, and reset)
• Four different drive modes (regular, regular tank, extendo, and extendo crawl)
• The robot gets really long.

These instructions are applicable for nearly any GitHub project, but our project has its own quirks and oddities so please read through the directions carefully.

To get a local copy of the repo which can accept your changes, go to our GitHub page, then click the green Clone or download button. Copy the URL which appears ("https://github.com/dawgbotics/ftc_app2017.git").

Download Git Bash onto your computer and open it. Use standard Windows Shell commands (cd, dir, ls, etc.) to navigate to a folder you want to put the project in. Use git clone, then right click and paste your url and hit enter. You should see something like this:

$ git clone https://github.com/dawgbotics/ftc_app2017.git
Cloning into 'ftc_app2017'...
remote: Counting objects: 11354, done.
remote: Compressing objects: 100% (307/307), done.
remote: Total 11354 (delta 286), reused 546 (delta 168), pack-reused 10676
Receiving objects: 100% (11354/11354), 574.00 MiB | 3.40 MiB/s, done.
Resolving deltas: 100% (6038/6038), done.
Checking connectivity... done.
Checking out files: 100% (2246/2246), done.

Now you've got the code on your computer! Download and open Android Studio. Choose Open Existing Android Studio Project. Navigate to ftc_app2017 on your computer. DO NOT OPEN FTC_APP2017, since that doesn't contain the code. Instead, open ftc_app-master inside of ftc_app2017. Now open this project. You will be prompted to download Build Tools. Click the link to do so.

You will be prompted to update the gradle project. DO NOT UPDATE THE GRADLE PROJECT. This is very important, as our gradle is very fragile and doesn't work under the newer versions.

Congratulations! You should now have the project on your computer.

Note: As the repo consists of code for two different teams, the code base is split into Team4042 and Team12788 folders. The TeamCode folder is unused. To choose which team's code to download, navigate to the top of Android Studio. In the toolbar along the top, next to the play button, there's a dropdown menu with the option to select either Team4042 or Team12788. Select your target and hit play.

When you next want to interact with GitHub, you can use the GitHub cheat sheet to get you started.

If you would like to use our code, feel free to fork the repo using the Fork button in the upper right on our GitHub page. Be sure to tell us how you used it at [email protected]!

If you want to contribute to our project, go through the Garfield Robotics members steps to download a local copy of the repo. Submit a pull request when you're done and we'll consider it!

Our code is licensed under the GNU General Public License version 3.0. This means a couple of things if you want to use our code.

1. You have to credit us with a link to our GitHub
2. Provide our copyright notice, which is "Copyright (C) 2017 Garfield Robotics"
3. License your code under the same license, which is the GNU GPLv3. Literally copy-paste our LICENSE.md into your project. No changes required. ALSO: put the "legalese" section of our README.md in your README.md. Remember to change the contact link to contact you, not us!
4. Document the changes you make to our code. This can be a super informal bullet list.
5. You don't get a warranty. And we're not liable.

But, in exchange, you can:

1. Use our code commercially
2. Distribute it
3. Modify it
4. Patent it
5. Use it privately

Copyright (C) 2017 Garfield Robotics

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

You can contact us with any questions about licensing here.