AME 3623: Project 1

All components of the project are due by Thursday, February 12th at 8:00 am
Groups are composed of 2-3 students.
Discussion within groups is fine.
Discussion across groups may not be about the specifics of the solution (general programming/circuit issues are fine to discuss).

At the end of this project, you should be able to:

create simple microcontroller-based circuits,
read digital information from a switch,
convey information using a set of LEDs.

Circuit Overview

By the end of the semester, you will have a circuit on a single breadboard that includes the following components:

one atmel mega2560 with supporting hardware,
one motor driver board for control of the fans,
one analog gyroscope sensor,
two switches,
four LEDs arranged in a circle (for indicating orientation and orientation error), and
ten LEDs arranged in a line (for indicating rotation rate or sensed distances).

Not on the breadboard, but connected to it will be:

three ducted fans,
a compass module,
two analog distance sensors, and
a power system.

Component 1: Microcontroller Circuit

Create a mega2560-based circuit on a solderless breadboard.

See the bottom of the Atmel HOWTO for a circuit starting point. This contains everything that you need to create a program for your mega2560.
Double-stick tape your mega2560 board to the solderless breadboard. Minimize the area of the breadboard that is covered.
Add a set of 4 LEDs that will be used to display the current orientation of the craft (organized in a circle). Each of these LEDs should be driven by a digital output pin (all of the same port).
Add another set of ten LEDs that will be used to display the orientation velocity (we are supplying 10-LED "bar graph" modules). Each of these LEDs should be driven by a digital output pin.
Add a switch. One end of the switch will be connected to ground, the other to a digital input pin. This pin should also be "pulled up" to +5V using a 10 K-Ohm resistor.

Component 2

Implement the following functions:

void display_orientation(int16_t theta) changes the state of the orientation LEDs to reflect an orientation. The range of the input parameter is -1799 and 1800, encoding tenths of a degree in a left-handed coordinate system
Note: at least eight different orientations should be displayed with the four LEDs
void display_rotation_rate(int16_t rate) will change the state of the ten LEDs (and no others) to reflect the current rotation rate. rate is in 10ths of a degree per second and has a range of +/- 3000.
In your main() function:
- If the input switch is in one state: slowly increment orientation from its minimum to its maximum value in 1-degree increments and display it. This value wraps-around when it reaches its maximum value.
- If the switch is in the other state: slowly increase the rotation rate from its minimum to its maximum value in 1-degree-per-second increments. This value wraps around when it reaches its maximum.

What to Hand In

All components of the project are due by Thursday, February 12th at 8:00 am.

Demonstration/Code Review: All group members must be present. Given time, this can be done during class.
Code: Check your documented code into your group dropbox on D2L.
Remember that documentation is about helping you and others looking at your code to understand what it is doing. Therefore, it will generally describe the logic of the code (and not-necessarily the low-level details). For this class:
1. At the top of your C file, document the project number, group members, date and the group member responsible for the code.
2. Each function must be documented (at the top of the function) as to what it does logically, what the meaning is of its inputs, and what the returned value is. If the function has external effects (e.g., commanding an actuator or modifying a global variable, these should also be documented here)
3. In-line comments should be used to describe logically what is happening at that line or group of lines.
See an example.
Personal report: fill out the CATME survey.

Grading

Personal programming credit:

Each person must accumulate at least three personal programming credits over the course of the semester (this project offers one)
To receive credit, you must be the primary designer, implementer and debugger of the component. This does not mean that your other group members should not be looking over your shoulder. But: you must do the "driving."

Group grade distribution:

35%: Project implementation
30%: Demonstration of working project (to either of the TA or the instructor)
35%: Code documentation

Group Grading Rubric

Grades for individuals will be based on the group grade, but weighted by the assessed contributions of the group members to the non-personal programming items.

andrewhfagg -- gmail.com

Last modified: Sun Feb 8 23:45:36 2015