MTB V2

E80

This repository includes Arduino sketches (.ino) for the Teensy on the E80 motherboard. The files for each lab are included in a separate folder. The .ino files in each lab folder share the same name as the folder (e.g., E80_Lab_01.ino is in a folder named E80_Lab_01.ino). This is a requirement for the Arduino IDE.

This respository also includes a folder of all the libraries you need for the various hardware peripherals on your motherboard (e.g., the GPS, and intertial measurement unit (IMU)).

The MATLAB folder contains the various MATLAB .m files which are used throughout the labs.

How to Use this Repository

Git Setup

You will need to configure Git on your machine. Git is a distributed version control system. This means you can download a local clone of a collection of source code files and easily track the changes that you make to your code. While we won't be using all the features of git in E80, we will introduce you to the main features that will enable you to interact with the code base for your robot.

First, you need to install Git on your computer. We recommend that for this class you use Git Desktop which provides a convenient GUI interface for interacting with the code.

1. Download and install the latest version of Git Desktop here.
2. Navigate to the E80 GitHub repository and click Code > Open with GitHub Desktop. You will get a prompt to clone/download the repo, and GitHub Desktop will ask you where to save the files. Choose a location on your hard drive where you want to save the files (i.e., NOT in a folder that is synchronized in the cloud like a Google Drive File Stream folder). You should choose a location on your hard drive to minimize the chances of having any data corrupted.
   • NOTE: If for some reason clicking Open with GitHub Desktop is not working properly, simply copy the URL for the repository (e.g., https://github.com/HMC-E80/E80) and then manually clone the repository in GitHub Desktop using File > Clone Repository. Enter the copied URL into the "Respository URL" field.

Arduino IDE Setup

Follow the instructions below to download and use this code within the Arduino IDE.

1. If you have not yet installed the Arduino IDE, install it from here. The version as of this writing is 2.0.3 but higher version numbers should also work fine.
2. Follow the instructions here to configure support for the Teensy board within the Arduino IDE.
3. After downloading the code, open the Arduino IDE and go to Arduino IDE > Settings if you are using a MAC and file > preferences if you are using Windows. Change the Sketchbook location to point to the folder you downloaded from GitHub.

4. Now you if you click on the Sketchbook icon in the toolbar on the left side of the Arduino IDE you should see all the code for your E80 motherboard listed and available. Open up the E80_Lab_01.ino sketch and Verify it to check that it compiles and all the libraries are properly downloaded.

Congratulations, you are now set up and have the default E80 source code downloaded! If you have any issues with these instructions, please reach out to one of the instructors.