Embedded Systems Learning Academy - User contributions [en]

S13: Solar Panel Tracker

2013-05-23T20:05:04Z

Matt s13: /* Pulse Width Modulation */

=== Grading Criteria ===
<font color="green">
* How well is Software & Hardware Design described?
* How well can this report be used to reproduce this project?
* Code Quality
* Overall Report Quality:
** Software Block Diagrams
** Hardware Block Diagrams
**: Schematic Quality
** Quality of technical challenges and solutions adopted.
</font>

== Solar Panel Tracker ==

== Abstract ==
The objective of this project is to create a solar panel that tracks the sun. The project will consist of two stepper motors that control the position of the solar panels by using the photo resistors to detect the sun location.

== Objectives & Introduction ==
Solar Panel Sun tracker uses the inputted voltage from photo resistors in order to adjust the position of the solar panel. The project uses and Analog to digital converter. The servo motors are controlled using a pulse; this controls the position of various angles. The servo uses in this project is a standard servo which can only position between 0 and 180 degrees.

The project required the following objectives to be accomplished:
* Read the voltage from photo resistors
* Control servo to move from 0 to 180 degrees
* Compute the location which has the greatest light intensity
* Determine algorithm to convert digital value into servo position

=== Team Members & Responsibilities ===
* Arturo Montoya
** Light Sensors (PWM driver) , Servo motor(ADC driver) , and Matrix (Spi driver)
* Matthew Balhorn
** FreeRTOS Software Design

== Schedule ==

<table class="wikitable">
<th>Week</th><th>Planned Tasks</th><th>Status</th>
<tr>
<td> <center>
1
</center> </td>
<td>
* Order parts

</td>
<td>
* Completed

</td>
</tr>

<tr>
<td> <center>
2
</center> </td>
<td>
* Look over datasheet(s)
* Test Servos
* Design System Logics
</td>
<td>
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
3
</center> </td>
<td>

* Test Light-sensing circuit
* Create System Schematics
* Code Servo Task
* Create Structure Design (Autodesk Inventor)

</td>
<td>
* Completed
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
4
</center> </td>
<td>

* Code Light-sensing Task
* Build/Machine Structure
* Code Glue Logics (Directional Logic)
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
5
</center> </td>
<td>
* Integrate system
* Test System
* Project report
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
6
</center> </td>
<td>
* Finalize project
* Finalize report
</td>
<td>
* Completed
* Completed
</td>
</tr>

</table>

== Parts List & Cost ==

<table class = "wikitable">
<th>Part</th> <th>Quuantity</th><th>Cost</th><th>Link</th>

<tr>
<td>LPC 1758 SJSU Dev Board</td>
<td align = "right"> 1 </td>
<td align = "right"> $60 </td>
<td align = "right"> </td>

<tr>
<td>180 Degree Servo </td>
<td align = "right"> 2 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>

<tr>
<td>Solar Panel</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>

<tr>
<td>LED Matrix</td>
<td align = "right"> 1 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Resistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $.25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Photoresistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $1.50 </td>
<td align = "right"> </td>

<tr>
<tr>
<td>Jumper wires(x50)</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Servo belt</td>
<td align = "right"> 2 </td>
<td align = "right"> $2 </td>
<td align = "right"> </td>
<tr>

</table>

== Design & Implementation ==

[[File:CmpE146_S13_SPT_ProjectFlowchart.png|center|frame]]
<div style="text-align: center;">'''Figure 1:''' Design Flowchart </div>
=== Hardware Design ===

=====Structure Design=====
The structure of the Solar Panel Tracker consists of a 'base' servo to rotate the solar cell to a position in a 180 degree arch, and a 'top' servo which tilts the 'arm' which holds the solar cell and a photoresistor circuit. A second photoresistor circuit, used for the base direction logic, is located on top of the structure and angled in the same direction of the base rotational range. The base servo rotates the structure using servo belts and pulleys which move the structure resting on an old computer fan bearing. This provides for a smooth rotation.

=====Light Sensor=====
The Solar Panel Sun Tracker consists of the following hardware:
* Resistors
*Photo resistors
This section is responsible for interpreting the voltage of the photo resistors. The diagram below shows the circuit needed in order to get a voltage division of the two photo resistors. This voltage divider consists of two resistors on each side of the voltage divider output (ADC pin). When the top photo resistor has a greater resistance then the bottom resistor the voltage output will drop. When they both have the same resistance will hold in the middle.

[[File:CmpE146_S13_SPT_LightSensorConnection.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' LightSensorConnection </div>

=====Servo Motor=====
The servo section consists of the following hardware:
* Servo Motors / Servo Belts
* Solar Panel

This section is responsible for positioning the solar panels perpendicular to the light source. The panel is mounted to a frame that pivots according to the top servo. In order to perform a full scan the top servo motor was mounted on pivoting bases that is controlled by the second motor. The diagram below describes the complete setup in order to properly track the sun from sun rise to sun set.

[[File:CmpE146_S13_SPT_SJOneBoardSchematic.png|center|frame]]
<div style="text-align: center;">'''Figure 3:''' SjOne Board Schematic </div>

=== Hardware Interface ===
[[File:CmpE146_S13_SPT_SjOneInterface.png|center|frame]]
<div style="text-align: center;">'''Figure 4:''' SjOneInterface </div>
<table class = "wikitable">
<th> SJSU Dev Board Pin</th> <th> Destination Pin</th><th>Description</th>

<tr>
<td> PWM1.4(p1.23) </td>
<td align = "right"> Servo Base Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> PWM1.5(p1.24) </td>
<td align = "right"> Servo Top Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> AD0.4(p1.30) </td>
<td align = "right"> Light Sensor Base</td>
<td align = "right"> Analog Input </td>
<tr>
<td> AD0.5(p1.31) </td>
<td align = "right"> Light Sensor Top </td>
<td align = "right"> Analog Input </td>
</table>

==== Pulse Width Modulation ====
PWM, or Pulse Width Modulation, was used to control the two 180 degree positional servos. The servos required a 50 Hz (20 ms) duty cycle, and the duration of the high duty cycle (in milliseconds) would control the position to move to. Typically, the valid high duty cycles are between 1.0 and 2.0 milliseconds, with 1.0 representing '0 degrees', 1.5 representing '90 degrees' and 2.0 representing '180 degrees.' However, we found that the valid duty cycle range was larger, ranging from 0.2 ms to 3.3 ms. Knowing this, we expanded the range of the duty cycle and converted the range into a degree range with the <i>change_direction_with_Degree()</i> function. The servos were connected to a 5V power supply and were controlled by PWM1-4(P1.23)and PWM1-5(P1.24).

[[File:146ServoPWM.png|center|frame]]
<div style="text-align: center;">'''Figure 5:''' PWM duty cycle example </div>

==== Analog-to-Digital-Converter ====
ADC, or Analog-to-Digital-Converter, was used to convert the analog photoresistor circuit voltage into a digital value for processing. The pins ADC-4 and ADC-5 were used in the system, each connected to the output of one of the photoresistor circuits. The raw value was tough to work with, so a conversion to a more manageable range of values was implemented in higher level code.

=== Software Design ===

Our software design centered on using two tasks to pass data used to track the sun. One task was a Light Sensor task, which is used to load data into the Queue, destined for the other task, a Servo Motor task. The Servo Motor task then calls a function to change the servo position. In order to support the tasks, and bridge the gap between them and the drivers, the LightSensors.cpp and ServoMotor.cpp source files were created.

[[File:CmpE146_S13_SPT_FreeRTOS.png|center|frame]]
<div style="text-align: center;">'''Figure 6:''' FreeRTOS </div>

[[File:CmpE146_S13_SPT_SoftwareFlowchart.png|center|frame]]
<div style="text-align: center;">'''Figure 7:''' Flowchart of the Software Design </div>

=== Implementation ===

[[File:CmpE146_S13_SPT_SjOneIO.png|center|frame]]
<div style="text-align: center;">'''Figure 8:''' Pins used for ADC and PWM </div>

[[File:CmpE146_S13_SPT_SJOneBoardPWMblockDiagram.png|center|frame]]
<div style="text-align: center;">'''Figure 9:''' PWM Match Register block diagram </div>

==== Light sensor Logic ====
The <i>LightSensors.cpp</i> file contains the functions that the Light-sensing task calls. These functions are <i>getDirection()</i>, which reads the referenced Analog-to-Digital Converter pin (ADC-4 or ADC-5), and returns a value which is the new change in direction for the respective servo motor (Top or Base). The <i>getDirection()</i> function reads the ADC pin value and uses it to decide which direction the servo should move towards, and returns either a positive <i>degreeChange</i>, a negative <i>degreeChange</i>, or a 0 for no change. For this project, we decided to use 5 degrees as the degree change. The <i>getDirection()</i> function can be seen below:

[[File:146getDirectionBaseCodeSnippet.png|center|frame]]
<div style="text-align: center;">'''Figure 10:''' getDirection function </div>
==== Servo motor Logic ====
The <i>ServoMotors.cpp</i> file contains the <i>change_direction_withDegree()</i> function, which updates the PWM Match Register for the given PWM signal and the degree. This function takes the degree value, ensures that it is within range, then converts it into milliseconds so it can be written to the respective Match Register, using the <i>PWMUpdateMR()</i> function defined in the PWM driver file. We used the definitions <i>Max_degree</i>, <i>Servo_Width</i>, <i>Servo_Start</i>, and <i>freq_ms</i>, whose values may need to be changed if a different servo motor is used. <i>Max_degree</i> is the farthest degree available to the servo motor (180), <i>freq_ms</i> is the duty cycle (20 ms), and the <i>Servo_Width</i> and <i>Servo_Start</i> are derived from the duty cycle thresholds (in ms) mapped to the degree range (0 - 180) of the servo motor.

[[File:146changeDirectionCodeSnippet.png‎ |center|frame]]
<div style="text-align: center;">'''Figure 11:''' change_direction_withDegree function </div>

==== Light-sensing Task ====
The Light-sensing task was very simple. To keep it this way, all of the 'heavy lifting' was completed in lower level code in the <i>LightSensors.cpp</i> file. Therefore, the only function that the Light-sensing task needs to use is the <i>getDirection()</i> function. However, there is a small amount of code to prevent the degree values from going out of range (0-180 degrees). The task reads the <i>getDirection()</i> values for both the top and base servo motors, which have valid values of negative five (-5), zero (0), or positive five (5). These values are added to the current positional value to obtain updated values to pass to the Servo Motor task through the Queue.

==== Servo Task ====
The Servo Task is even simpler. It takes the top and base positional values from the Queue, then passes the value to the servo motors using the <i>change_direction_withDegree()</i> function, which is defined in the <i>ServoMotors.cpp</i> file.

[[File:CmpE146_S13_SPT_ServoTask.png‎ |center|frame]]
<div style="text-align: center;">'''Figure 12:''' Servo Task </div>

== Testing & Technical Challenges ==
Describe the challenges of your project. What advise would you give yourself or someone else if your project can be started from scratch again?
Make a smooth transition to testing section and described what it took to test your project.

=== Servo Motor Mounting challenge ===
Initially, the base servo was mounted directly to the base, holding up the other servo, solar cell, etc. The base was unsteady and had a risk of damaging the servo. To fix this, the top servo, solar cell, etc. were mounted on an old computer fan bearing. The base servo motor was moved off to the side, with 2 belts and pulleys used to translate the rotation to the structure on the base.

=== Servo Motors Testing ===
We tested the Servo motors by sending an increasing range of active duty cycle time until the full range was found. Normally, servo motors have an active duty cycle range of 1.0 ms to 2.0 ms. Our servo motors had an actual range of 0.2 ms to 3.3 ms. Once we found this range, we had no problems with the servo motors.

=== Photoresistor Circuit Testing ===
We tested the photoresistor circuit by connecting it to an ADC pin and monitoring the digital values. Varying amounts of light were given to the circuit and appropriate changes in values were observed. For example, when the photoresistor connected to 5V receives more light than the other photoresistor(connected to ground), the voltage to the ADC pin drops. A corresponding drop in value was observed with the digital value. The same comparison was true with a spike in voltage and the spike in digital value, when the other photoresistor receives more light.

=== Integrated Testing ===
We tested the system after full integration by using a flashlight as a simulated sun. The Solar Panel Tracker correctly adjusted for every sun movement.

== Conclusion ==

Ultimately, we were not able to make it completely battery powered. Otherwise, the project turned out well. The Solar Panel Tracker correctly sensed the light and adjusted accordingly. The main difficulties were with mounting the servos, keeping the wires protected, and other minor adjustments to the design, which wasted an unfortunate amount of time. Had we been able to finish the design and made it portable earlier, we would have had time to add other features, such as an LED matrix to display status values. Despite the structural difficulties, we learned and experienced much from the project, such as FreeRTOS implementation, driver development, how to implement Pulse Width Modulation and Analog-to-Digital Conversion, how to use servo motors and photoresistors. Overall, it was a successful project without extra functions.

=== Project Video ===
[http://youtu.be/hmtO0O_00to Demonstration Video]<BR/>

=== Project Source Code ===
Send me your zipped source code and I will upload this to SourceForge and link it for you.

== References ==
=== Acknowledgement ===
Preet Kang

Dr. Haluk Ozemek

=== References Used ===
List any references used in project.

=== Appendix ===
You can list the references you used.

S13: Solar Panel Tracker

2013-05-23T19:59:22Z

Matt s13: /* Conclusion */

=== Grading Criteria ===
<font color="green">
* How well is Software & Hardware Design described?
* How well can this report be used to reproduce this project?
* Code Quality
* Overall Report Quality:
** Software Block Diagrams
** Hardware Block Diagrams
**: Schematic Quality
** Quality of technical challenges and solutions adopted.
</font>

== Solar Panel Tracker ==

== Abstract ==
The objective of this project is to create a solar panel that tracks the sun. The project will consist of two stepper motors that control the position of the solar panels by using the photo resistors to detect the sun location.

== Objectives & Introduction ==
Solar Panel Sun tracker uses the inputted voltage from photo resistors in order to adjust the position of the solar panel. The project uses and Analog to digital converter. The servo motors are controlled using a pulse; this controls the position of various angles. The servo uses in this project is a standard servo which can only position between 0 and 180 degrees.

The project required the following objectives to be accomplished:
* Read the voltage from photo resistors
* Control servo to move from 0 to 180 degrees
* Compute the location which has the greatest light intensity
* Determine algorithm to convert digital value into servo position

=== Team Members & Responsibilities ===
* Arturo Montoya
** Light Sensors (PWM driver) , Servo motor(ADC driver) , and Matrix (Spi driver)
* Matthew Balhorn
** FreeRTOS Software Design

== Schedule ==

<table class="wikitable">
<th>Week</th><th>Planned Tasks</th><th>Status</th>
<tr>
<td> <center>
1
</center> </td>
<td>
* Order parts

</td>
<td>
* Completed

</td>
</tr>

<tr>
<td> <center>
2
</center> </td>
<td>
* Look over datasheet(s)
* Test Servos
* Design System Logics
</td>
<td>
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
3
</center> </td>
<td>

* Test Light-sensing circuit
* Create System Schematics
* Code Servo Task
* Create Structure Design (Autodesk Inventor)

</td>
<td>
* Completed
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
4
</center> </td>
<td>

* Code Light-sensing Task
* Build/Machine Structure
* Code Glue Logics (Directional Logic)
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
5
</center> </td>
<td>
* Integrate system
* Test System
* Project report
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
6
</center> </td>
<td>
* Finalize project
* Finalize report
</td>
<td>
* Completed
* Completed
</td>
</tr>

</table>

== Parts List & Cost ==

<table class = "wikitable">
<th>Part</th> <th>Quuantity</th><th>Cost</th><th>Link</th>

<tr>
<td>LPC 1758 SJSU Dev Board</td>
<td align = "right"> 1 </td>
<td align = "right"> $60 </td>
<td align = "right"> </td>

<tr>
<td>180 Degree Servo </td>
<td align = "right"> 2 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>

<tr>
<td>Solar Panel</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>

<tr>
<td>LED Matrix</td>
<td align = "right"> 1 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Resistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $.25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Photoresistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $1.50 </td>
<td align = "right"> </td>

<tr>
<tr>
<td>Jumper wires(x50)</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Servo belt</td>
<td align = "right"> 2 </td>
<td align = "right"> $2 </td>
<td align = "right"> </td>
<tr>

</table>

== Design & Implementation ==

[[File:CmpE146_S13_SPT_ProjectFlowchart.png|center|frame]]
<div style="text-align: center;">'''Figure 1:''' Design Flowchart </div>
=== Hardware Design ===

=====Structure Design=====
The structure of the Solar Panel Tracker consists of a 'base' servo to rotate the solar cell to a position in a 180 degree arch, and a 'top' servo which tilts the 'arm' which holds the solar cell and a photoresistor circuit. A second photoresistor circuit, used for the base direction logic, is located on top of the structure and angled in the same direction of the base rotational range. The base servo rotates the structure using servo belts and pulleys which move the structure resting on an old computer fan bearing. This provides for a smooth rotation.

=====Light Sensor=====
The Solar Panel Sun Tracker consists of the following hardware:
* Resistors
*Photo resistors
This section is responsible for interpreting the voltage of the photo resistors. The diagram below shows the circuit needed in order to get a voltage division of the two photo resistors. This voltage divider consists of two resistors on each side of the voltage divider output (ADC pin). When the top photo resistor has a greater resistance then the bottom resistor the voltage output will drop. When they both have the same resistance will hold in the middle.

[[File:CmpE146_S13_SPT_LightSensorConnection.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' LightSensorConnection </div>

=====Servo Motor=====
The servo section consists of the following hardware:
* Servo Motors / Servo Belts
* Solar Panel

This section is responsible for positioning the solar panels perpendicular to the light source. The panel is mounted to a frame that pivots according to the top servo. In order to perform a full scan the top servo motor was mounted on pivoting bases that is controlled by the second motor. The diagram below describes the complete setup in order to properly track the sun from sun rise to sun set.

[[File:CmpE146_S13_SPT_SJOneBoardSchematic.png|center|frame]]
<div style="text-align: center;">'''Figure 3:''' SjOne Board Schematic </div>

=== Hardware Interface ===
[[File:CmpE146_S13_SPT_SjOneInterface.png|center|frame]]
<div style="text-align: center;">'''Figure 4:''' SjOneInterface </div>
<table class = "wikitable">
<th> SJSU Dev Board Pin</th> <th> Destination Pin</th><th>Description</th>

<tr>
<td> PWM1.4(p1.23) </td>
<td align = "right"> Servo Base Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> PWM1.5(p1.24) </td>
<td align = "right"> Servo Top Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> AD0.4(p1.30) </td>
<td align = "right"> Light Sensor Base</td>
<td align = "right"> Analog Input </td>
<tr>
<td> AD0.5(p1.31) </td>
<td align = "right"> Light Sensor Top </td>
<td align = "right"> Analog Input </td>
</table>

==== Pulse Width Modulation ====
PWM, or Pulse Width Modulation, was used to control the two 180 degree positional servos. The servos required a 50 Hz (20 ms) duty cycle, and the duration of the high duty cycle (in milliseconds) would control the position to move to. Typically, the valid high duty cycles are between 1.0 and 2.0 milliseconds, with 1.0 representing '0 degrees', 1.5 representing '90 degrees' and 2.0 representing '180 degrees.' However, we found that the valid duty cycle range was larger, ranging from [INSERT FULL RANGE]. Knowing this, we expanded the range of the duty cycle and converted the range into a degree range with the <i>change_direction_with_Degree()</i> function. The servos were connected to a 5V power supply and were controlled by PWM1-4(P1.23)and PWM1-5(P1.24).

[[File:146ServoPWM.png|center|frame]]
<div style="text-align: center;">'''Figure 5:''' PWM duty cycle example </div>

==== Analog-to-Digital-Converter ====
ADC, or Analog-to-Digital-Converter, was used to convert the analog photoresistor circuit voltage into a digital value for processing. The pins ADC-4 and ADC-5 were used in the system, each connected to the output of one of the photoresistor circuits. The raw value was tough to work with, so a conversion to a more manageable range of values was implemented in higher level code.

=== Software Design ===

Our software design centered on using two tasks to pass data used to track the sun. One task was a Light Sensor task, which is used to load data into the Queue, destined for the other task, a Servo Motor task. The Servo Motor task then calls a function to change the servo position. In order to support the tasks, and bridge the gap between them and the drivers, the LightSensors.cpp and ServoMotor.cpp source files were created.

[[File:CmpE146_S13_SPT_FreeRTOS.png|center|frame]]
<div style="text-align: center;">'''Figure 6:''' FreeRTOS </div>

[[File:CmpE146_S13_SPT_SoftwareFlowchart.png|center|frame]]
<div style="text-align: center;">'''Figure 7:''' Flowchart of the Software Design </div>

=== Implementation ===

[[File:CmpE146_S13_SPT_SjOneIO.png|center|frame]]
<div style="text-align: center;">'''Figure 8:''' Pins used for ADC and PWM </div>

[[File:CmpE146_S13_SPT_SJOneBoardPWMblockDiagram.png|center|frame]]
<div style="text-align: center;">'''Figure 9:''' PWM Match Register block diagram </div>

==== Light sensor Logic ====
The <i>LightSensors.cpp</i> file contains the functions that the Light-sensing task calls. These functions are <i>getDirection()</i>, which reads the referenced Analog-to-Digital Converter pin (ADC-4 or ADC-5), and returns a value which is the new change in direction for the respective servo motor (Top or Base). The <i>getDirection()</i> function reads the ADC pin value and uses it to decide which direction the servo should move towards, and returns either a positive <i>degreeChange</i>, a negative <i>degreeChange</i>, or a 0 for no change. For this project, we decided to use 5 degrees as the degree change. The <i>getDirection()</i> function can be seen below:

[[File:146getDirectionBaseCodeSnippet.png|center|frame]]
<div style="text-align: center;">'''Figure 10:''' getDirection function </div>
==== Servo motor Logic ====
The <i>ServoMotors.cpp</i> file contains the <i>change_direction_withDegree()</i> function, which updates the PWM Match Register for the given PWM signal and the degree. This function takes the degree value, ensures that it is within range, then converts it into milliseconds so it can be written to the respective Match Register, using the <i>PWMUpdateMR()</i> function defined in the PWM driver file. We used the definitions <i>Max_degree</i>, <i>Servo_Width</i>, <i>Servo_Start</i>, and <i>freq_ms</i>, whose values may need to be changed if a different servo motor is used. <i>Max_degree</i> is the farthest degree available to the servo motor (180), <i>freq_ms</i> is the duty cycle (20 ms), and the <i>Servo_Width</i> and <i>Servo_Start</i> are derived from the duty cycle thresholds (in ms) mapped to the degree range (0 - 180) of the servo motor.

[[File:146changeDirectionCodeSnippet.png‎ |center|frame]]
<div style="text-align: center;">'''Figure 11:''' change_direction_withDegree function </div>

==== Light-sensing Task ====
The Light-sensing task was very simple. To keep it this way, all of the 'heavy lifting' was completed in lower level code in the <i>LightSensors.cpp</i> file. Therefore, the only function that the Light-sensing task needs to use is the <i>getDirection()</i> function. However, there is a small amount of code to prevent the degree values from going out of range (0-180 degrees). The task reads the <i>getDirection()</i> values for both the top and base servo motors, which have valid values of negative five (-5), zero (0), or positive five (5). These values are added to the current positional value to obtain updated values to pass to the Servo Motor task through the Queue.

==== Servo Task ====
The Servo Task is even simpler. It takes the top and base positional values from the Queue, then passes the value to the servo motors using the <i>change_direction_withDegree()</i> function, which is defined in the <i>ServoMotors.cpp</i> file.

[[File:CmpE146_S13_SPT_ServoTask.png‎ |center|frame]]
<div style="text-align: center;">'''Figure 12:''' Servo Task </div>

== Testing & Technical Challenges ==
Describe the challenges of your project. What advise would you give yourself or someone else if your project can be started from scratch again?
Make a smooth transition to testing section and described what it took to test your project.

=== Servo Motor Mounting challenge ===
Initially, the base servo was mounted directly to the base, holding up the other servo, solar cell, etc. The base was unsteady and had a risk of damaging the servo. To fix this, the top servo, solar cell, etc. were mounted on an old computer fan bearing. The base servo motor was moved off to the side, with 2 belts and pulleys used to translate the rotation to the structure on the base.

=== Servo Motors Testing ===
We tested the Servo motors by sending an increasing range of active duty cycle time until the full range was found. Normally, servo motors have an active duty cycle range of 1.0 ms to 2.0 ms. Our servo motors had an actual range of 0.2 ms to 3.3 ms. Once we found this range, we had no problems with the servo motors.

=== Photoresistor Circuit Testing ===
We tested the photoresistor circuit by connecting it to an ADC pin and monitoring the digital values. Varying amounts of light were given to the circuit and appropriate changes in values were observed. For example, when the photoresistor connected to 5V receives more light than the other photoresistor(connected to ground), the voltage to the ADC pin drops. A corresponding drop in value was observed with the digital value. The same comparison was true with a spike in voltage and the spike in digital value, when the other photoresistor receives more light.

=== Integrated Testing ===
We tested the system after full integration by using a flashlight as a simulated sun. The Solar Panel Tracker correctly adjusted for every sun movement.

== Conclusion ==

Ultimately, we were not able to make it completely battery powered. Otherwise, the project turned out well. The Solar Panel Tracker correctly sensed the light and adjusted accordingly. The main difficulties were with mounting the servos, keeping the wires protected, and other minor adjustments to the design, which wasted an unfortunate amount of time. Had we been able to finish the design and made it portable earlier, we would have had time to add other features, such as an LED matrix to display status values. Despite the structural difficulties, we learned and experienced much from the project, such as FreeRTOS implementation, driver development, how to implement Pulse Width Modulation and Analog-to-Digital Conversion, how to use servo motors and photoresistors. Overall, it was a successful project without extra functions.

=== Project Video ===
[http://youtu.be/hmtO0O_00to Demonstration Video]<BR/>

=== Project Source Code ===
Send me your zipped source code and I will upload this to SourceForge and link it for you.

== References ==
=== Acknowledgement ===
Preet Kang

Dr. Haluk Ozemek

=== References Used ===
List any references used in project.

=== Appendix ===
You can list the references you used.

S13: Solar Panel Tracker

2013-05-23T19:36:09Z

Matt s13: /* Implementation */

=== Grading Criteria ===
<font color="green">
* How well is Software & Hardware Design described?
* How well can this report be used to reproduce this project?
* Code Quality
* Overall Report Quality:
** Software Block Diagrams
** Hardware Block Diagrams
**: Schematic Quality
** Quality of technical challenges and solutions adopted.
</font>

== Solar Panel Tracker ==

== Abstract ==
The objective of this project is to create a solar panel that tracks the sun. The project will consist of two stepper motors that control the position of the solar panels by using the photo resistors to detect the sun location.

== Objectives & Introduction ==
Solar Panel Sun tracker uses the inputted voltage from photo resistors in order to adjust the position of the solar panel. The project uses and Analog to digital converter. The servo motors are controlled using a pulse; this controls the position of various angles. The servo uses in this project is a standard servo which can only position between 0 and 180 degrees.

The project required the following objectives to be accomplished:
* Read the voltage from photo resistors
* Control servo to move from 0 to 180 degrees
* Compute the location which has the greatest light intensity
* Determine algorithm to convert digital value into servo position

=== Team Members & Responsibilities ===
* Arturo Montoya
** Light Sensors (PWM driver) , Servo motor(ADC driver) , and Matrix (Spi driver)
* Matthew Balhorn
** FreeRTOS Software Design

== Schedule ==

<table class="wikitable">
<th>Week</th><th>Planned Tasks</th><th>Status</th>
<tr>
<td> <center>
1
</center> </td>
<td>
* Order parts

</td>
<td>
* Completed

</td>
</tr>

<tr>
<td> <center>
2
</center> </td>
<td>
* Look over datasheet(s)
* Test Servos
* Design System Logics
</td>
<td>
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
3
</center> </td>
<td>

* Test Light-sensing circuit
* Create System Schematics
* Code Servo Task
* Create Structure Design (Autodesk Inventor)

</td>
<td>
* Completed
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
4
</center> </td>
<td>

* Code Light-sensing Task
* Build/Machine Structure
* Code Glue Logics (Directional Logic)
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
5
</center> </td>
<td>
* Integrate system
* Test System
* Project report
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
6
</center> </td>
<td>
* Finalize project
* Finalize report
</td>
<td>
* Completed
* Completed
</td>
</tr>

</table>

== Parts List & Cost ==

<table class = "wikitable">
<th>Part</th> <th>Quuantity</th><th>Cost</th><th>Link</th>

<tr>
<td>LPC 1758 SJSU Dev Board</td>
<td align = "right"> 1 </td>
<td align = "right"> $60 </td>
<td align = "right"> </td>

<tr>
<td>180 Degree Servo </td>
<td align = "right"> 2 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>

<tr>
<td>Solar Panel</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>

<tr>
<td>LED Matrix</td>
<td align = "right"> 1 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Resistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $.25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Photoresistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $1.50 </td>
<td align = "right"> </td>

<tr>
<tr>
<td>Jumper wires(x50)</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Servo belt</td>
<td align = "right"> 2 </td>
<td align = "right"> $2 </td>
<td align = "right"> </td>
<tr>

</table>

== Design & Implementation ==

[[File:CmpE146_S13_SPT_ProjectFlowchart.png|center|frame]]
<div style="text-align: center;">'''Figure 1:''' Design Flowchart </div>
=== Hardware Design ===

=====Structure Design=====
The structure of the Solar Panel Tracker consists of a 'base' servo to rotate the solar cell to a position in a 180 degree arch, and a 'top' servo which tilts the 'arm' which holds the solar cell and a photoresistor circuit. A second photoresistor circuit, used for the base direction logic, is located on top of the structure and angled in the same direction of the base rotational range. The base servo rotates the structure using servo belts and pulleys which move the structure resting on an old computer fan bearing. This provides for a smooth rotation.

=====Light Sensor=====
The Solar Panel Sun Tracker consists of the following hardware:
* Resistors
*Photo resistors
This section is responsible for interpreting the voltage of the photo resistors. The diagram below shows the circuit needed in order to get a voltage division of the two photo resistors. This voltage divider consists of two resistors on each side of the voltage divider output (ADC pin). When the top photo resistor has a greater resistance then the bottom resistor the voltage output will drop. When they both have the same resistance will hold in the middle.

[[File:CmpE146_S13_SPT_LightSensorConnection.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' LightSensorConnection </div>

=====Servo Motor=====
The servo section consists of the following hardware:
* Servo Motors / Servo Belts
* Solar Panel

This section is responsible for positioning the solar panels perpendicular to the light source. The panel is mounted to a frame that pivots according to the top servo. In order to perform a full scan the top servo motor was mounted on pivoting bases that is controlled by the second motor. The diagram below describes the complete setup in order to properly track the sun from sun rise to sun set.

[[File:CmpE146_S13_SPT_SJOneBoardSchematic.png|center|frame]]
<div style="text-align: center;">'''Figure 3:''' SjOne Board Schematic </div>

=== Hardware Interface ===
[[File:CmpE146_S13_SPT_SjOneInterface.png|center|frame]]
<div style="text-align: center;">'''Figure 4:''' SjOneInterface </div>
<table class = "wikitable">
<th> SJSU Dev Board Pin</th> <th> Destination Pin</th><th>Description</th>

<tr>
<td> PWM1.4(p1.23) </td>
<td align = "right"> Servo Base Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> PWM1.5(p1.24) </td>
<td align = "right"> Servo Top Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> AD0.4(p1.30) </td>
<td align = "right"> Light Sensor Base</td>
<td align = "right"> Analog Input </td>
<tr>
<td> AD0.5(p1.31) </td>
<td align = "right"> Light Sensor Top </td>
<td align = "right"> Analog Input </td>
</table>

==== Pulse Width Modulation ====
PWM, or Pulse Width Modulation, was used to control the two 180 degree positional servos. The servos required a 50 Hz (20 ms) duty cycle, and the duration of the high duty cycle (in milliseconds) would control the position to move to. Typically, the valid high duty cycles are between 1.0 and 2.0 milliseconds, with 1.0 representing '0 degrees', 1.5 representing '90 degrees' and 2.0 representing '180 degrees.' However, we found that the valid duty cycle range was larger, ranging from [INSERT FULL RANGE]. Knowing this, we expanded the range of the duty cycle and converted the range into a degree range with the <i>change_direction_with_Degree()</i> function. The servos were connected to a 5V power supply and were controlled by PWM1-4(P1.23)and PWM1-5(P1.24).

[[File:146ServoPWM.png|center|frame]]
<div style="text-align: center;">'''Figure 5:''' PWM duty cycle example </div>

==== Analog-to-Digital-Converter ====
ADC, or Analog-to-Digital-Converter, was used to convert the analog photoresistor circuit voltage into a digital value for processing. The pins ADC-4 and ADC-5 were used in the system, each connected to the output of one of the photoresistor circuits. The raw value was tough to work with, so a conversion to a more manageable range of values was implemented in higher level code.

=== Software Design ===

Our software design centered on using two tasks to pass data used to track the sun. One task was a Light Sensor task, which is used to load data into the Queue, destined for the other task, a Servo Motor task. The Servo Motor task then calls a function to change the servo position. In order to support the tasks, and bridge the gap between them and the drivers, the LightSensors.cpp and ServoMotor.cpp source files were created.

[[File:CmpE146_S13_SPT_FreeRTOS.png|center|frame]]
<div style="text-align: center;">'''Figure 6:''' FreeRTOS </div>

[[File:CmpE146_S13_SPT_SoftwareFlowchart.png|center|frame]]
<div style="text-align: center;">'''Figure 7:''' Flowchart of the Software Design </div>

=== Implementation ===

[[File:CmpE146_S13_SPT_SjOneIO.png|center|frame]]
<div style="text-align: center;">'''Figure 8:''' Pins used for ADC and PWM </div>

[[File:CmpE146_S13_SPT_SJOneBoardPWMblockDiagram.png|center|frame]]
<div style="text-align: center;">'''Figure 9:''' PWM Match Register block diagram </div>

==== Light sensor Logic ====
The <i>LightSensors.cpp</i> file contains the functions that the Light-sensing task calls. These functions are <i>getDirection()</i>, which reads the referenced Analog-to-Digital Converter pin (ADC-4 or ADC-5), and returns a value which is the new change in direction for the respective servo motor (Top or Base). The <i>getDirection()</i> function reads the ADC pin value and uses it to decide which direction the servo should move towards, and returns either a positive <i>degreeChange</i>, a negative <i>degreeChange</i>, or a 0 for no change. For this project, we decided to use 5 degrees as the degree change. The <i>getDirection()</i> function can be seen below:

[[File:146getDirectionBaseCodeSnippet.png|center|frame]]
<div style="text-align: center;">'''Figure 10:''' getDirection function </div>
==== Servo motor Logic ====
The <i>ServoMotors.cpp</i> file contains the <i>change_direction_withDegree()</i> function, which updates the PWM Match Register for the given PWM signal and the degree. This function takes the degree value, ensures that it is within range, then converts it into milliseconds so it can be written to the respective Match Register, using the <i>PWMUpdateMR()</i> function defined in the PWM driver file. We used the definitions <i>Max_degree</i>, <i>Servo_Width</i>, <i>Servo_Start</i>, and <i>freq_ms</i>, whose values may need to be changed if a different servo motor is used. <i>Max_degree</i> is the farthest degree available to the servo motor (180), <i>freq_ms</i> is the duty cycle (20 ms), and the <i>Servo_Width</i> and <i>Servo_Start</i> are derived from the duty cycle thresholds (in ms) mapped to the degree range (0 - 180) of the servo motor.

[[File:146changeDirectionCodeSnippet.png‎ |center|frame]]
<div style="text-align: center;">'''Figure 11:''' change_direction_withDegree function </div>

==== Light-sensing Task ====
The Light-sensing task was very simple. To keep it this way, all of the 'heavy lifting' was completed in lower level code in the <i>LightSensors.cpp</i> file. Therefore, the only function that the Light-sensing task needs to use is the <i>getDirection()</i> function. However, there is a small amount of code to prevent the degree values from going out of range (0-180 degrees). The task reads the <i>getDirection()</i> values for both the top and base servo motors, which have valid values of negative five (-5), zero (0), or positive five (5). These values are added to the current positional value to obtain updated values to pass to the Servo Motor task through the Queue.

==== Servo Task ====
The Servo Task is even simpler. It takes the top and base positional values from the Queue, then passes the value to the servo motors using the <i>change_direction_withDegree()</i> function, which is defined in the <i>ServoMotors.cpp</i> file.

[[File:CmpE146_S13_SPT_ServoTask.png‎ |center|frame]]
<div style="text-align: center;">'''Figure 12:''' Servo Task </div>

== Testing & Technical Challenges ==
Describe the challenges of your project. What advise would you give yourself or someone else if your project can be started from scratch again?
Make a smooth transition to testing section and described what it took to test your project.

=== Servo Motor Mounting challenge ===
Initially, the base servo was mounted directly to the base, holding up the other servo, solar cell, etc. The base was unsteady and had a risk of damaging the servo. To fix this, the top servo, solar cell, etc. were mounted on an old computer fan bearing. The base servo motor was moved off to the side, with 2 belts and pulleys used to translate the rotation to the structure on the base.

=== Servo Motors Testing ===
We tested the Servo motors by sending an increasing range of active duty cycle time until the full range was found. Normally, servo motors have an active duty cycle range of 1.0 ms to 2.0 ms. Our servo motors had an actual range of 0.2 ms to 3.3 ms. Once we found this range, we had no problems with the servo motors.

=== Photoresistor Circuit Testing ===
We tested the photoresistor circuit by connecting it to an ADC pin and monitoring the digital values. Varying amounts of light were given to the circuit and appropriate changes in values were observed. For example, when the photoresistor connected to 5V receives more light than the other photoresistor(connected to ground), the voltage to the ADC pin drops. A corresponding drop in value was observed with the digital value. The same comparison was true with a spike in voltage and the spike in digital value, when the other photoresistor receives more light.

=== Integrated Testing ===
We tested the system after full integration by using a flashlight as a simulated sun. The Solar Panel Tracker correctly adjusted for every sun movement.

== Conclusion ==
Conclude your project here. You can recap your testing and problems. You should address the "so what" part here to indicate what you ultimately learnt from this project. How has this project increased your knowledge?

=== Project Video ===
[http://youtu.be/hmtO0O_00to Demonstration Video]<BR/>

=== Project Source Code ===
Send me your zipped source code and I will upload this to SourceForge and link it for you.

== References ==
=== Acknowledgement ===
Preet Kang

Dr. Haluk Ozemek

=== References Used ===
List any references used in project.

=== Appendix ===
You can list the references you used.

S13: Solar Panel Tracker

2013-05-23T05:22:41Z

Matt s13: /* Project Video */

=== Grading Criteria ===
<font color="green">
* How well is Software & Hardware Design described?
* How well can this report be used to reproduce this project?
* Code Quality
* Overall Report Quality:
** Software Block Diagrams
** Hardware Block Diagrams
**: Schematic Quality
** Quality of technical challenges and solutions adopted.
</font>

== Solar Panel Tracker ==

== Abstract ==
The objective of this project is to create a solar panel that tracks the sun. The project will consist of two stepper motors that control the position of the solar panels by using the photo resistors to detect the sun location.

== Objectives & Introduction ==
Solar Panel Sun tracker uses the inputted voltage from photo resistors in order to adjust the position of the solar panel. The project uses and Analog to digital converter. The servo motors are controlled using a pulse; this controls the position of various angles. The servo uses in this project is a standard servo which can only position between 0 and 180 degrees.

The project required the following objectives to be accomplished:
* Read the voltage from photo resistors
* Control servo to move from 0 to 180 degrees
* Compute the location which has the greatest light intensity
* Determine algorithm to convert digital value into servo position

=== Team Members & Responsibilities ===
* Arturo Montoya
** Light Sensors (PWM driver) , Servo motor(ADC driver) , and Matrix (Spi driver)
* Matthew Balhorn
** FreeRTOS Software Design

== Schedule ==

<table class="wikitable">
<th>Week</th><th>Planned Tasks</th><th>Status</th>
<tr>
<td> <center>
1
</center> </td>
<td>
* Order parts

</td>
<td>
* Completed

</td>
</tr>

<tr>
<td> <center>
2
</center> </td>
<td>
* Look over datasheet(s)
* Test Servos
* Design System Logics
</td>
<td>
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
3
</center> </td>
<td>

* Test Light-sensing circuit
* Create System Schematics
* Code Servo Task
* Create Structure Design (Autodesk Inventor)

</td>
<td>
* Completed
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
4
</center> </td>
<td>

* Code Light-sensing Task
* Build/Machine Structure
* Code Glue Logics (Directional Logic)
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
5
</center> </td>
<td>
* Integrate system
* Test System
* Project report
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
6
</center> </td>
<td>
* Finalize project
* Finalize report
</td>
<td>
* Completed
* Completed
</td>
</tr>

</table>

== Parts List & Cost ==

<table class = "wikitable">
<th>Part</th> <th>Quuantity</th><th>Cost</th><th>Link</th>

<tr>
<td>LPC 1758 SJSU Dev Board</td>
<td align = "right"> 1 </td>
<td align = "right"> $60 </td>
<td align = "right"> </td>

<tr>
<td>180 Degree Servo </td>
<td align = "right"> 2 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>

<tr>
<td>Solar Panel</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>

<tr>
<td>LED Matrix</td>
<td align = "right"> 1 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Resistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $.25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Photoresistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $1.50 </td>
<td align = "right"> </td>

<tr>
<tr>
<td>Jumper wires(x50)</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Servo belt</td>
<td align = "right"> 2 </td>
<td align = "right"> $2 </td>
<td align = "right"> </td>
<tr>

</table>

== Design & Implementation ==

[[File:CmpE146_S13_SPT_ProjectFlowchart.png|center|frame]]
<div style="text-align: center;">'''Figure 1:''' Design Flowchart </div>
=== Hardware Design ===

=====Structure Design=====
The structure of the Solar Panel Tracker consists of a 'base' servo to rotate the solar cell to a position in a 180 degree arch, and a 'top' servo which tilts the 'arm' which holds the solar cell and a photoresistor circuit. A second photoresistor circuit, used for the base direction logic, is located on top of the structure and angled in the same direction of the base rotational range. The base servo rotates the structure using servo belts and pulleys which move the structure resting on an old computer fan bearing. This provides for a smooth rotation.

=====Light Sensor=====
The Solar Panel Sun Tracker consists of the following hardware:
* Resistors
*Photo resistors
This section is responsible for interpreting the voltage of the photo resistors. The diagram below shows the circuit needed in order to get a voltage division of the two photo resistors. This voltage divider consists of two resistors on each side of the voltage divider output (ADC pin). When the top photo resistor has a greater resistance then the bottom resistor the voltage output will drop. When they both have the same resistance will hold in the middle.

[[File:CmpE146_S13_SPT_LightSensorConnection.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' LightSensorConnection </div>

=====Servo Motor=====
The servo section consists of the following hardware:
* Servo Motors / Servo Belts
* Solar Panel

This section is responsible for positioning the solar panels perpendicular to the light source. The panel is mounted to a frame that pivots according to the top servo. In order to perform a full scan the top servo motor was mounted on pivoting bases that is controlled by the second motor. The diagram below describes the complete setup in order to properly track the sun from sun rise to sun set.

[[File:CmpE146_S13_SPT_SJOneBoardSchematic.png|center|frame]]
<div style="text-align: center;">'''Figure 3:''' SjOne Board Schematic </div>

=== Hardware Interface ===
[[File:CmpE146_S13_SPT_SjOneInterface.png|center|frame]]
<div style="text-align: center;">'''Figure 4:''' SjOneInterface </div>
<table class = "wikitable">
<th> SJSU Dev Board Pin</th> <th> Destination Pin</th><th>Description</th>

<tr>
<td> PWM1.4(p1.23) </td>
<td align = "right"> Servo Base Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> PWM1.5(p1.24) </td>
<td align = "right"> Servo Top Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> AD0.4(p1.30) </td>
<td align = "right"> Light Sensor Base</td>
<td align = "right"> Analog Input </td>
<tr>
<td> AD0.5(p1.31) </td>
<td align = "right"> Light Sensor Top </td>
<td align = "right"> Analog Input </td>
</table>

==== Pulse Width Modulation ====
PWM, or Pulse Width Modulation, was used to control the two 180 degree positional servos. The servos required a 50 Hz (20 ms) duty cycle, and the duration of the high duty cycle (in milliseconds) would control the position to move to. Typically, the valid high duty cycles are between 1.0 and 2.0 milliseconds, with 1.0 representing '0 degrees', 1.5 representing '90 degrees' and 2.0 representing '180 degrees.' However, we found that the valid duty cycle range was larger, ranging from [INSERT FULL RANGE]. Knowing this, we expanded the range of the duty cycle and converted the range into a degree range with the <i>change_direction_with_Degree()</i> function. The servos were connected to a 5V power supply and were controlled by PWM1-4(P1.23)and PWM1-5(P1.24).

[[File:146ServoPWM.png|center|frame]]
<div style="text-align: center;">'''Figure 5:''' PWM duty cycle example </div>

==== Analog-to-Digital-Converter ====
ADC, or Analog-to-Digital-Converter, was used to convert the analog photoresistor circuit voltage into a digital value for processing. The pins ADC-4 and ADC-5 were used in the system, each connected to the output of one of the photoresistor circuits. The raw value was tough to work with, so a conversion to a more manageable range of values was implemented in higher level code.

=== Software Design ===

Our software design centered on using two tasks to pass data used to track the sun. One task was a Light Sensor task, which is used to load data into the Queue, destined for the other task, a Servo Motor task. The Servo Motor task then calls a function to change the servo position. In order to support the tasks, and bridge the gap between them and the drivers, the LightSensors.cpp and ServoMotor.cpp source files were created.

[[File:CmpE146_S13_SPT_FreeRTOS.png|center|frame]]
<div style="text-align: center;">'''Figure 6:''' FreeRTOS </div>

[[File:CmpE146_S13_SPT_SoftwareFlowchart.png|center|frame]]
<div style="text-align: center;">'''Figure 7:''' Flowchart of the Software Design </div>

=== Implementation ===
This section includes implementation, but again, not the details, just the high level. For example, you can list the steps it takes to communicate over a sensor, or the steps needed to write a page of memory onto SPI Flash. You can include sub-sections for each of your component implementation.

[[File:CmpE146_S13_SPT_SjOneIO.png|center|frame]]
<div style="text-align: center;">'''Figure 8:''' Pins used for ADC and PWM </div>

[[File:CmpE146_S13_SPT_SJOneBoardPWMblockDiagram.png|center|frame]]
<div style="text-align: center;">'''Figure 9:''' PWM Match Register block diagram </div>

==== Light sensor Logic ====
The <i>LightSensors.cpp</i> file contains the functions that the Light-sensing task calls. These functions are <i>getDirection()</i>, which reads the referenced Analog-to-Digital Converter pin (ADC-4 or ADC-5), and returns a value which is the new change in direction for the respective servo motor (Top or Base). The <i>getDirection()</i> function reads the ADC pin value and uses it to decide which direction the servo should move towards, and returns either a positive <i>degreeChange</i>, a negative <i>degreeChange</i>, or a 0 for no change. For this project, we decided to use 5 degrees as the degree change. The <i>getDirection()</i> function can be seen below:

[[File:146getDirectionBaseCodeSnippet.png|center|frame]]
<div style="text-align: center;">'''Figure 10:''' getDirection function </div>
==== Servo motor Logic ====
The <i>ServoMotors.cpp</i> file contains the <i>change_direction_withDegree()</i> function, which updates the PWM Match Register for the given PWM signal and the degree. This function takes the degree value, ensures that it is within range, then converts it into milliseconds so it can be written to the respective Match Register, using the <i>PWMUpdateMR()</i> function defined in the PWM driver file. We used the definitions <i>Max_degree</i>, <i>Servo_Width</i>, <i>Servo_Start</i>, and <i>freq_ms</i>, whose values may need to be changed if a different servo motor is used. <i>Max_degree</i> is the farthest degree available to the servo motor (180), <i>freq_ms</i> is the duty cycle (20 ms), and the <i>Servo_Width</i> and <i>Servo_Start</i> are derived from the duty cycle thresholds (in ms) mapped to the degree range (0 - 180) of the servo motor.

[[File:146changeDirectionCodeSnippet.png‎ |center|frame]]
<div style="text-align: center;">'''Figure 11:''' change_direction_withDegree function </div>

==== Light-sensing Task ====
The Light-sensing task was very simple. To keep it this way, all of the 'heavy lifting' was completed in lower level code in the <i>LightSensors.cpp</i> file. Therefore, the only function that the Light-sensing task needs to use is the <i>getDirection()</i> function. However, there is a small amount of code to prevent the degree values from going out of range (0-180 degrees). The task reads the <i>getDirection()</i> values for both the top and base servo motors, which have valid values of negative five (-5), zero (0), or positive five (5). These values are added to the current positional value to obtain updated values to pass to the Servo Motor task through the Queue.

==== Servo Task ====
The Servo Task is even simpler. It takes the top and base positional values from the Queue, then passes the value to the servo motors using the <i>change_direction_withDegree()</i> function, which is defined in the <i>ServoMotors.cpp</i> file.

[[File:CmpE146_S13_SPT_ServoTask.png‎ |center|frame]]
<div style="text-align: center;">'''Figure 12:''' Servo Task </div>

== Testing & Technical Challenges ==
Describe the challenges of your project. What advise would you give yourself or someone else if your project can be started from scratch again?
Make a smooth transition to testing section and described what it took to test your project.

=== Servo Motor Mounting challenge ===
Initially, the base servo was mounted directly to the base, holding up the other servo, solar cell, etc. The base was unsteady and had a risk of damaging the servo. To fix this, the top servo, solar cell, etc. were mounted on an old computer fan bearing. The base servo motor was moved off to the side, with 2 belts and pulleys used to translate the rotation to the structure on the base.

=== Servo Motors Testing ===
We tested the Servo motors by sending an increasing range of active duty cycle time until the full range was found. Normally, servo motors have an active duty cycle range of 1.0 ms to 2.0 ms. Our servo motors had an actual range of 0.2 ms to 3.3 ms. Once we found this range, we had no problems with the servo motors.

=== Photoresistor Circuit Testing ===
We tested the photoresistor circuit by connecting it to an ADC pin and monitoring the digital values. Varying amounts of light were given to the circuit and appropriate changes in values were observed. For example, when the photoresistor connected to 5V receives more light than the other photoresistor(connected to ground), the voltage to the ADC pin drops. A corresponding drop in value was observed with the digital value. The same comparison was true with a spike in voltage and the spike in digital value, when the other photoresistor receives more light.

=== Integrated Testing ===
We tested the system after full integration by using a flashlight as a simulated sun. The Solar Panel Tracker correctly adjusted for every sun movement.

== Conclusion ==
Conclude your project here. You can recap your testing and problems. You should address the "so what" part here to indicate what you ultimately learnt from this project. How has this project increased your knowledge?

=== Project Video ===
[http://youtu.be/hmtO0O_00to Demonstration Video]<BR/>

=== Project Source Code ===
Send me your zipped source code and I will upload this to SourceForge and link it for you.

== References ==
=== Acknowledgement ===
Preet Kang

Dr. Haluk Ozemek

=== References Used ===
List any references used in project.

=== Appendix ===
You can list the references you used.

File:CmpE146 S13 SPT SoftwareFlowchart.png

2013-05-22T06:24:11Z

Matt s13: uploaded a new version of "File:CmpE146 S13 SPT SoftwareFlowchart.png"

S13: Solar Panel Tracker

2013-05-22T06:21:20Z

Matt s13: /* Design & Implementation */

=== Grading Criteria ===
<font color="green">
* How well is Software & Hardware Design described?
* How well can this report be used to reproduce this project?
* Code Quality
* Overall Report Quality:
** Software Block Diagrams
** Hardware Block Diagrams
**: Schematic Quality
** Quality of technical challenges and solutions adopted.
</font>

== Solar Panel Tracker ==

== Abstract ==
The objective of this project is to create a solar panel that tracks the sun. The project will consist of two stepper motors that control the position of the solar panels by using the photo resistors to detect the sun location.

== Objectives & Introduction ==
Solar Panel Sun tracker uses the inputted voltage from photo resistors in order to adjust the position of the solar panel. The project uses and Analog to digital converter. The servo motors are controlled using a pulse; this controls the position of various angles. The servo uses in this project is a standard servo which can only position between 0 and 180 degrees.

The project required the following objectives to be accomplished:
* Read the voltage from photo resistors
* Control servo to move from 0 to 180 degrees
* Compute the location which has the greatest light intensity
* Determine algorithm to convert digital value into servo position

=== Team Members & Responsibilities ===
* Arturo Montoya
** Light Sensors (PWM driver) , Servo motor(ADC driver) , and Matrix (Spi driver)
* Matthew Balhorn
** FreeRTOS Software Design

== Schedule ==

<table class="wikitable">
<th>Week</th><th>Planned Tasks</th><th>Status</th>
<tr>
<td> <center>
1
</center> </td>
<td>
* Order parts

</td>
<td>
* Completed

</td>
</tr>

<tr>
<td> <center>
2
</center> </td>
<td>
* Look over datasheet(s)
* Test Servos
* Design System Logics
</td>
<td>
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
3
</center> </td>
<td>

* Test Light-sensing circuit
* Create System Schematics
* Code Servo Task
* Create Structure Design (Autodesk Inventor)

</td>
<td>
* Completed
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
4
</center> </td>
<td>

* Code Light-sensing Task
* Build/Machine Structure
* Code Glue Logics (Directional Logic)
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
5
</center> </td>
<td>
* Integrate system
* Test System
* Project report
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
6
</center> </td>
<td>
* Finalize project
* Finalize report
</td>
<td>
* Completed
* Completed
</td>
</tr>

</table>

== Parts List & Cost ==

<table class = "wikitable">
<th>Part</th> <th>Quuantity</th><th>Cost</th><th>Link</th>

<tr>
<td>LPC 1758 SJSU Dev Board</td>
<td align = "right"> 1 </td>
<td align = "right"> $60 </td>
<td align = "right"> </td>

<tr>
<td>180 Degree Servo </td>
<td align = "right"> 2 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>

<tr>
<td>Solar Panel</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>

<tr>
<td>LED Matrix</td>
<td align = "right"> 1 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Resistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $.25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Photoresistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $1.50 </td>
<td align = "right"> </td>

<tr>
<tr>
<td>Jumper wires(x50)</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Servo belt</td>
<td align = "right"> 2 </td>
<td align = "right"> $2 </td>
<td align = "right"> </td>
<tr>

</table>

== Design & Implementation ==

[[File:CmpE146_S13_SPT_ProjectFlowchart.png|center|frame]]
<div style="text-align: center;">'''Figure 1:''' Design Flowchart </div>
=== Hardware Design ===

=====Structure Design=====
The structure of the Solar Panel Tracker consists of a 'base' servo to rotate the solar cell to a position in a 180 degree arch, and a 'top' servo which tilts the 'arm' which holds the solar cell and a photoresistor circuit. A second photoresistor circuit, used for the base direction logic, is located on top of the structure and angled in the same direction of the base rotational range. The base servo rotates the structure using servo belts and pulleys which move the structure resting on an old computer fan bearing. This provides for a smooth rotation.

=====Light Sensor=====
The Solar Panel Sun Tracker consists of the following hardware:
* Resistors
*Photo resistors
This section is responsible for interpreting the voltage of the photo resistors. The diagram below shows the circuit needed in order to get a voltage division of the two photo resistors. This voltage divider consists of two resistors on each side of the voltage divider output (ADC pin). When the top photo resistor has a greater resistance then the bottom resistor the voltage output will drop. When they both have the same resistance will hold in the middle.

[[File:CmpE146_S13_SPT_LightSensorConnection.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' LightSensorConnection </div>

=====Servo Motor=====
The servo section consists of the following hardware:
* Servo Motors / Servo Belts
* Solar Panel

This section is responsible for positioning the solar panels perpendicular to the light source. The panel is mounted to a frame that pivots according to the top servo. In order to perform a full scan the top servo motor was mounted on pivoting bases that is controlled by the second motor. The diagram below describes the complete setup in order to properly track the sun from sun rise to sun set.

[[File:CmpE146_S13_SPT_SJOneBoardSchematic.png|center|frame]]
<div style="text-align: center;">'''Figure 3:''' SjOne Board Schematic </div>

=== Hardware Interface ===
[[File:CmpE146_S13_SPT_SjOneInterface.png|center|frame]]
<div style="text-align: center;">'''Figure 4:''' SjOneInterface </div>
<table class = "wikitable">
<th> SJSU Dev Board Pin</th> <th> Destination Pin</th><th>Description</th>

<tr>
<td> PWM1.4(p1.23) </td>
<td align = "right"> Servo Base Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> PWM1.5(p1.24) </td>
<td align = "right"> Servo Top Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> AD0.4(p1.30) </td>
<td align = "right"> Light Sensor Base</td>
<td align = "right"> Analog Input </td>
<tr>
<td> AD0.5(p1.31) </td>
<td align = "right"> Light Sensor Top </td>
<td align = "right"> Analog Input </td>
</table>

==== Pulse Width Modulation ====
PWM, or Pulse Width Modulation, was used to control the two 180 degree positional servos. The servos required a 50 Hz (20 ms) duty cycle, and the duration of the high duty cycle (in milliseconds) would control the position to move to. Typically, the valid high duty cycles are between 1.0 and 2.0 milliseconds, with 1.0 representing '0 degrees', 1.5 representing '90 degrees' and 2.0 representing '180 degrees.' However, we found that the valid duty cycle range was larger, ranging from [INSERT FULL RANGE]. Knowing this, we expanded the range of the duty cycle and converted the range into a degree range with the <i>change_direction_with_Degree()</i> function. The servos were connected to a 5V power supply and were controlled by PWM1-4(P1.23)and PWM1-5(P1.24).

[[File:146ServoPWM.png|center|frame]]
<div style="text-align: center;">'''Figure 5:''' PWM duty cycle example </div>

==== Analog-to-Digital-Converter ====
ADC, or Analog-to-Digital-Converter, was used to convert the analog photoresistor circuit voltage into a digital value for processing. The pins ADC-4 and ADC-5 were used in the system, each connected to the output of one of the photoresistor circuits. The raw value was tough to work with, so a conversion to a more manageable range of values was implemented in higher level code.

=== Software Design ===

Our software design centered on using two tasks to pass data used to track the sun. One task was a Light Sensor task, which is used to load data into the Queue, destined for the other task, a Servo Motor task. The Servo Motor task then calls a function to change the servo position. In order to support the tasks, and bridge the gap between them and the drivers, the LightSensors.cpp and ServoMotor.cpp source files were created.

[[File:CmpE146_S13_SPT_FreeRTOS.png|center|frame]]
<div style="text-align: center;">'''Figure 6:''' FreeRTOS </div>

[[File:CmpE146_S13_SPT_SoftwareFlowchart.png|center|frame]]
<div style="text-align: center;">'''Figure 7:''' Flowchart of the Software Design </div>

=== Implementation ===
This section includes implementation, but again, not the details, just the high level. For example, you can list the steps it takes to communicate over a sensor, or the steps needed to write a page of memory onto SPI Flash. You can include sub-sections for each of your component implementation.

[[File:CmpE146_S13_SPT_SjOneIO.png|center|frame]]
<div style="text-align: center;">'''Figure 8:''' Pins used for ADC and PWM </div>

[[File:CmpE146_S13_SPT_SJOneBoardPWMblockDiagram.png|center|frame]]
<div style="text-align: center;">'''Figure 9:''' PWM Match Register block diagram </div>

==== Light sensor Logic ====
The <i>LightSensors.cpp</i> file contains the functions that the Light-sensing task calls. These functions are <i>getDirection()</i>, which reads the referenced Analog-to-Digital Converter pin (ADC-4 or ADC-5), and returns a value which is the new change in direction for the respective servo motor (Top or Base). The <i>getDirection()</i> function reads the ADC pin value and uses it to decide which direction the servo should move towards, and returns either a positive <i>degreeChange</i>, a negative <i>degreeChange</i>, or a 0 for no change. For this project, we decided to use 5 degrees as the degree change. The <i>getDirection()</i> function can be seen below:

[[File:146getDirectionBaseCodeSnippet.png|center|frame]]
<div style="text-align: center;">'''Figure 10:''' getDirection function </div>
==== Servo motor Logic ====
The <i>ServoMotors.cpp</i> file contains the <i>change_direction_withDegree()</i> function, which updates the PWM Match Register for the given PWM signal and the degree. This function takes the degree value, ensures that it is within range, then converts it into milliseconds so it can be written to the respective Match Register, using the <i>PWMUpdateMR()</i> function defined in the PWM driver file. We used the definitions <i>Max_degree</i>, <i>Servo_Width</i>, <i>Servo_Start</i>, and <i>freq_ms</i>, whose values may need to be changed if a different servo motor is used. <i>Max_degree</i> is the farthest degree available to the servo motor (180), <i>freq_ms</i> is the duty cycle (20 ms), and the <i>Servo_Width</i> and <i>Servo_Start</i> are derived from the duty cycle thresholds (in ms) mapped to the degree range (0 - 180) of the servo motor.

[[File:146changeDirectionCodeSnippet.png‎ |center|frame]]
<div style="text-align: center;">'''Figure 11:''' change_direction_withDegree function </div>

==== Light-sensing Task ====
The Light-sensing task was very simple. To keep it this way, all of the 'heavy lifting' was completed in lower level code in the <i>LightSensors.cpp</i> file. Therefore, the only function that the Light-sensing task needs to use is the <i>getDirection()</i> function. However, there is a small amount of code to prevent the degree values from going out of range (0-180 degrees). The task reads the <i>getDirection()</i> values for both the top and base servo motors, which have valid values of negative five (-5), zero (0), or positive five (5). These values are added to the current positional value to obtain updated values to pass to the Servo Motor task through the Queue.

==== Servo Task ====
The Servo Task is even simpler. It takes the top and base positional values from the Queue, then passes the value to the servo motors using the <i>change_direction_withDegree()</i> function, which is defined in the <i>ServoMotors.cpp</i> file.

[[File:CmpE146_S13_SPT_ServoTask.png‎ |center|frame]]
<div style="text-align: center;">'''Figure 12:''' Servo Task </div>

== Testing & Technical Challenges ==
Describe the challenges of your project. What advise would you give yourself or someone else if your project can be started from scratch again?
Make a smooth transition to testing section and described what it took to test your project.

=== Servo Motor Mounting challenge ===
Initially, the base servo was mounted directly to the base, holding up the other servo, solar cell, etc. The base was unsteady and had a risk of damaging the servo. To fix this, the top servo, solar cell, etc. were mounted on an old computer fan bearing. The base servo motor was moved off to the side, with 2 belts and pulleys used to translate the rotation to the structure on the base.

=== Servo Motors Testing ===
We tested the Servo motors by sending an increasing range of active duty cycle time until the full range was found. Normally, servo motors have an active duty cycle range of 1.0 ms to 2.0 ms. Our servo motors had an actual range of 0.2 ms to 3.3 ms. Once we found this range, we had no problems with the servo motors.

=== Photoresistor Circuit Testing ===
We tested the photoresistor circuit by connecting it to an ADC pin and monitoring the digital values. Varying amounts of light were given to the circuit and appropriate changes in values were observed. For example, when the photoresistor connected to 5V receives more light than the other photoresistor(connected to ground), the voltage to the ADC pin drops. A corresponding drop in value was observed with the digital value. The same comparison was true with a spike in voltage and the spike in digital value, when the other photoresistor receives more light.

=== Integrated Testing ===
We tested the system after full integration by using a flashlight as a simulated sun. The Solar Panel Tracker correctly adjusted for every sun movement.

== Conclusion ==
Conclude your project here. You can recap your testing and problems. You should address the "so what" part here to indicate what you ultimately learnt from this project. How has this project increased your knowledge?

=== Project Video ===
Upload a video of your project and post the link here.

=== Project Source Code ===
Send me your zipped source code and I will upload this to SourceForge and link it for you.

== References ==
=== Acknowledgement ===
Preet Kang

Dr. Haluk Ozemek

=== References Used ===
List any references used in project.

=== Appendix ===
You can list the references you used.

File:CmpE146 S13 SPT ProjectFlowchart.png

2013-05-22T06:18:55Z

Matt s13:

S13: Solar Panel Tracker

2013-05-22T05:57:44Z

Matt s13: /* Design & Implementation */

=== Grading Criteria ===
<font color="green">
* How well is Software & Hardware Design described?
* How well can this report be used to reproduce this project?
* Code Quality
* Overall Report Quality:
** Software Block Diagrams
** Hardware Block Diagrams
**: Schematic Quality
** Quality of technical challenges and solutions adopted.
</font>

== Solar Panel Tracker ==

== Abstract ==
The objective of this project is to create a solar panel that tracks the sun. The project will consist of two stepper motors that control the position of the solar panels by using the photo resistors to detect the sun location.

== Objectives & Introduction ==
Solar Panel Sun tracker uses the inputted voltage from photo resistors in order to adjust the position of the solar panel. The project uses and Analog to digital converter. The servo motors are controlled using a pulse; this controls the position of various angles. The servo uses in this project is a standard servo which can only position between 0 and 180 degrees.

The project required the following objectives to be accomplished:
* Read the voltage from photo resistors
* Control servo to move from 0 to 180 degrees
* Compute the location which has the greatest light intensity
* Determine algorithm to convert digital value into servo position

=== Team Members & Responsibilities ===
* Arturo Montoya
** Light Sensors (PWM driver) , Servo motor(ADC driver) , and Matrix (Spi driver)
* Matthew Balhorn
** FreeRTOS Software Design

== Schedule ==

<table class="wikitable">
<th>Week</th><th>Planned Tasks</th><th>Status</th>
<tr>
<td> <center>
1
</center> </td>
<td>
* Order parts

</td>
<td>
* Completed

</td>
</tr>

<tr>
<td> <center>
2
</center> </td>
<td>
* Look over datasheet(s)
* Test Servos
* Design System Logics
</td>
<td>
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
3
</center> </td>
<td>

* Test Light-sensing circuit
* Create System Schematics
* Code Servo Task
* Create Structure Design (Autodesk Inventor)

</td>
<td>
* Completed
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
4
</center> </td>
<td>

* Code Light-sensing Task
* Build/Machine Structure
* Code Glue Logics (Directional Logic)
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
5
</center> </td>
<td>
* Integrate system
* Test System
* Project report
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
6
</center> </td>
<td>
* Finalize project
* Finalize report
</td>
<td>
* Completed
* Completed
</td>
</tr>

</table>

== Parts List & Cost ==

<table class = "wikitable">
<th>Part</th> <th>Quuantity</th><th>Cost</th><th>Link</th>

<tr>
<td>LPC 1758 SJSU Dev Board</td>
<td align = "right"> 1 </td>
<td align = "right"> $60 </td>
<td align = "right"> </td>

<tr>
<td>180 Degree Servo </td>
<td align = "right"> 2 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>

<tr>
<td>Solar Panel</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>

<tr>
<td>LED Matrix</td>
<td align = "right"> 1 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Resistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $.25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Photoresistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $1.50 </td>
<td align = "right"> </td>

<tr>
<tr>
<td>Jumper wires(x50)</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Servo belt</td>
<td align = "right"> 2 </td>
<td align = "right"> $2 </td>
<td align = "right"> </td>
<tr>

</table>

== Design & Implementation ==

=== Hardware Design ===

=====Structure Design=====
The structure of the Solar Panel Tracker consists of a 'base' servo to rotate the solar cell to a position in a 180 degree arch, and a 'top' servo which tilts the 'arm' which holds the solar cell and a photoresistor circuit. A second photoresistor circuit, used for the base direction logic, is located on top of the structure and angled in the same direction of the base rotational range. The base servo rotates the structure using servo belts and pulleys which move the structure resting on an old computer fan bearing. This provides for a smooth rotation.

=====Light Sensor=====
The Solar Panel Sun Tracker consists of the following hardware:
* Resistors
*Photo resistors
This section is responsible for interpreting the voltage of the photo resistors. The diagram below shows the circuit needed in order to get a voltage division of the two photo resistors. This voltage divider consists of two resistors on each side of the voltage divider output (ADC pin). When the top photo resistor has a greater resistance then the bottom resistor the voltage output will drop. When they both have the same resistance will hold in the middle.

[[File:CmpE146_S13_SPT_LightSensorConnection.png|center|frame]]
<div style="text-align: center;">'''Figure 1:''' LightSensorConnection </div>

=====Servo Motor=====
The servo section consists of the following hardware:
* Servo Motors / Servo Belts
* Solar Panel

This section is responsible for positioning the solar panels perpendicular to the light source. The panel is mounted to a frame that pivots according to the top servo. In order to perform a full scan the top servo motor was mounted on pivoting bases that is controlled by the second motor. The diagram below describes the complete setup in order to properly track the sun from sun rise to sun set.

[[File:CmpE146_S13_SPT_SJOneBoardSchematic.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOne Board Schematic </div>

=== Hardware Interface ===
[[File:CmpE146_S13_SPT_SjOneInterface.png|center|frame]]
<div style="text-align: center;">'''Figure 3:''' SjOneInterface </div>
<table class = "wikitable">
<th> SJSU Dev Board Pin</th> <th> Destination Pin</th><th>Description</th>

<tr>
<td> PWM1.4(p1.23) </td>
<td align = "right"> Servo Base Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> PWM1.5(p1.24) </td>
<td align = "right"> Servo Top Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> AD0.4(p1.30) </td>
<td align = "right"> Light Sensor Base</td>
<td align = "right"> Analog Input </td>
<tr>
<td> AD0.5(p1.31) </td>
<td align = "right"> Light Sensor Top </td>
<td align = "right"> Analog Input </td>
</table>

==== Pulse Width Modulation ====
PWM, or Pulse Width Modulation, was used to control the two 180 degree positional servos. The servos required a 50 Hz (20 ms) duty cycle, and the duration of the high duty cycle (in milliseconds) would control the position to move to. Typically, the valid high duty cycles are between 1.0 and 2.0 milliseconds, with 1.0 representing '0 degrees', 1.5 representing '90 degrees' and 2.0 representing '180 degrees.' However, we found that the valid duty cycle range was larger, ranging from [INSERT FULL RANGE]. Knowing this, we expanded the range of the duty cycle and converted the range into a degree range with the <i>change_direction_with_Degree()</i> function. The servos were connected to a 5V power supply and were controlled by PWM1-4(P1.23)and PWM1-5(P1.24).

[[File:146ServoPWM.png|center|frame]]
<div style="text-align: center;">'''Figure 4:''' PWM duty cycle example </div>

==== Analog-to-Digital-Converter ====
ADC, or Analog-to-Digital-Converter, was used to convert the analog photoresistor circuit voltage into a digital value for processing. The pins ADC-4 and ADC-5 were used in the system, each connected to the output of one of the photoresistor circuits. The raw value was tough to work with, so a conversion to a more manageable range of values was implemented in higher level code.

=== Software Design ===

Our software design centered on using two tasks to pass data used to track the sun. One task was a Light Sensor task, which is used to load data into the Queue, destined for the other task, a Servo Motor task. The Servo Motor task then calls a function to change the servo position. In order to support the tasks, and bridge the gap between them and the drivers, the LightSensors.cpp and ServoMotor.cpp source files were created.

[[File:CmpE146_S13_SPT_FreeRTOS.png|center|frame]]
<div style="text-align: center;">'''Figure 5:''' FreeRTOS </div>

[[File:CmpE146_S13_SPT_SoftwareFlowchart.png|center|frame]]
<div style="text-align: center;">'''Figure 6:''' Flowchart of the Software Design </div>

=== Implementation ===
This section includes implementation, but again, not the details, just the high level. For example, you can list the steps it takes to communicate over a sensor, or the steps needed to write a page of memory onto SPI Flash. You can include sub-sections for each of your component implementation.

[[File:CmpE146_S13_SPT_SjOneIO.png|center|frame]]
<div style="text-align: center;">'''Figure 7:''' Pins used for ADC and PWM </div>

[[File:CmpE146_S13_SPT_SJOneBoardPWMblockDiagram.png|center|frame]]
<div style="text-align: center;">'''Figure 8:''' PWM Match Register block diagram </div>

==== Light sensor Logic ====
The <i>LightSensors.cpp</i> file contains the functions that the Light-sensing task calls. These functions are <i>getDirection()</i>, which reads the referenced Analog-to-Digital Converter pin (ADC-4 or ADC-5), and returns a value which is the new change in direction for the respective servo motor (Top or Base). The <i>getDirection()</i> function reads the ADC pin value and uses it to decide which direction the servo should move towards, and returns either a positive <i>degreeChange</i>, a negative <i>degreeChange</i>, or a 0 for no change. For this project, we decided to use 5 degrees as the degree change. The <i>getDirection()</i> function can be seen below:

[[File:146getDirectionBaseCodeSnippet.png|center|frame]]
<div style="text-align: center;">'''Figure 9:''' getDirection function </div>
==== Servo motor Logic ====
The <i>ServoMotors.cpp</i> file contains the <i>change_direction_withDegree()</i> function, which updates the PWM Match Register for the given PWM signal and the degree. This function takes the degree value, ensures that it is within range, then converts it into milliseconds so it can be written to the respective Match Register, using the <i>PWMUpdateMR()</i> function defined in the PWM driver file. We used the definitions <i>Max_degree</i>, <i>Servo_Width</i>, <i>Servo_Start</i>, and <i>freq_ms</i>, whose values may need to be changed if a different servo motor is used. <i>Max_degree</i> is the farthest degree available to the servo motor (180), <i>freq_ms</i> is the duty cycle (20 ms), and the <i>Servo_Width</i> and <i>Servo_Start</i> are derived from the duty cycle thresholds (in ms) mapped to the degree range (0 - 180) of the servo motor.

[[File:146changeDirectionCodeSnippet.png‎ |center|frame]]
<div style="text-align: center;">'''Figure 10:''' change_direction_withDegree function </div>

==== Light-sensing Task ====
The Light-sensing task was very simple. To keep it this way, all of the 'heavy lifting' was completed in lower level code in the <i>LightSensors.cpp</i> file. Therefore, the only function that the Light-sensing task needs to use is the <i>getDirection()</i> function. However, there is a small amount of code to prevent the degree values from going out of range (0-180 degrees). The task reads the <i>getDirection()</i> values for both the top and base servo motors, which have valid values of negative five (-5), zero (0), or positive five (5). These values are added to the current positional value to obtain updated values to pass to the Servo Motor task through the Queue.

==== Servo Task ====
The Servo Task is even simpler. It takes the top and base positional values from the Queue, then passes the value to the servo motors using the <i>change_direction_withDegree()</i> function, which is defined in the <i>ServoMotors.cpp</i> file.

[[File:CmpE146_S13_SPT_ServoTask.png‎ |center|frame]]
<div style="text-align: center;">'''Figure 11:''' Servo Task </div>

== Testing & Technical Challenges ==
Describe the challenges of your project. What advise would you give yourself or someone else if your project can be started from scratch again?
Make a smooth transition to testing section and described what it took to test your project.

=== Servo Motor Mounting challenge ===
Initially, the base servo was mounted directly to the base, holding up the other servo, solar cell, etc. The base was unsteady and had a risk of damaging the servo. To fix this, the top servo, solar cell, etc. were mounted on an old computer fan bearing. The base servo motor was moved off to the side, with 2 belts and pulleys used to translate the rotation to the structure on the base.

=== Servo Motors Testing ===
We tested the Servo motors by sending an increasing range of active duty cycle time until the full range was found. Normally, servo motors have an active duty cycle range of 1.0 ms to 2.0 ms. Our servo motors had an actual range of 0.2 ms to 3.3 ms. Once we found this range, we had no problems with the servo motors.

=== Photoresistor Circuit Testing ===
We tested the photoresistor circuit by connecting it to an ADC pin and monitoring the digital values. Varying amounts of light were given to the circuit and appropriate changes in values were observed. For example, when the photoresistor connected to 5V receives more light than the other photoresistor(connected to ground), the voltage to the ADC pin drops. A corresponding drop in value was observed with the digital value. The same comparison was true with a spike in voltage and the spike in digital value, when the other photoresistor receives more light.

=== Integrated Testing ===
We tested the system after full integration by using a flashlight as a simulated sun. The Solar Panel Tracker correctly adjusted for every sun movement.

== Conclusion ==
Conclude your project here. You can recap your testing and problems. You should address the "so what" part here to indicate what you ultimately learnt from this project. How has this project increased your knowledge?

=== Project Video ===
Upload a video of your project and post the link here.

=== Project Source Code ===
Send me your zipped source code and I will upload this to SourceForge and link it for you.

== References ==
=== Acknowledgement ===
Preet Kang

Dr. Haluk Ozemek

=== References Used ===
List any references used in project.

=== Appendix ===
You can list the references you used.

S13: Solar Panel Tracker

2013-05-22T05:47:45Z

Matt s13: /* Design & Implementation */

=== Grading Criteria ===
<font color="green">
* How well is Software & Hardware Design described?
* How well can this report be used to reproduce this project?
* Code Quality
* Overall Report Quality:
** Software Block Diagrams
** Hardware Block Diagrams
**: Schematic Quality
** Quality of technical challenges and solutions adopted.
</font>

== Solar Panel Tracker ==

== Abstract ==
The objective of this project is to create a solar panel that tracks the sun. The project will consist of two stepper motors that control the position of the solar panels by using the photo resistors to detect the sun location.

== Objectives & Introduction ==
Solar Panel Sun tracker uses the inputted voltage from photo resistors in order to adjust the position of the solar panel. The project uses and Analog to digital converter. The servo motors are controlled using a pulse; this controls the position of various angles. The servo uses in this project is a standard servo which can only position between 0 and 180 degrees.

The project required the following objectives to be accomplished:
* Read the voltage from photo resistors
* Control servo to move from 0 to 180 degrees
* Compute the location which has the greatest light intensity
* Determine algorithm to convert digital value into servo position

=== Team Members & Responsibilities ===
* Arturo Montoya
** Light Sensors (PWM driver) , Servo motor(ADC driver) , and Matrix (Spi driver)
* Matthew Balhorn
** FreeRTOS Software Design

== Schedule ==

<table class="wikitable">
<th>Week</th><th>Planned Tasks</th><th>Status</th>
<tr>
<td> <center>
1
</center> </td>
<td>
* Order parts

</td>
<td>
* Completed

</td>
</tr>

<tr>
<td> <center>
2
</center> </td>
<td>
* Look over datasheet(s)
* Test Servos
* Design System Logics
</td>
<td>
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
3
</center> </td>
<td>

* Test Light-sensing circuit
* Create System Schematics
* Code Servo Task
* Create Structure Design (Autodesk Inventor)

</td>
<td>
* Completed
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
4
</center> </td>
<td>

* Code Light-sensing Task
* Build/Machine Structure
* Code Glue Logics (Directional Logic)
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
5
</center> </td>
<td>
* Integrate system
* Test System
* Project report
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
6
</center> </td>
<td>
* Finalize project
* Finalize report
</td>
<td>
* Completed
* Completed
</td>
</tr>

</table>

== Parts List & Cost ==

<table class = "wikitable">
<th>Part</th> <th>Quuantity</th><th>Cost</th><th>Link</th>

<tr>
<td>LPC 1758 SJSU Dev Board</td>
<td align = "right"> 1 </td>
<td align = "right"> $60 </td>
<td align = "right"> </td>

<tr>
<td>180 Degree Servo </td>
<td align = "right"> 2 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>

<tr>
<td>Solar Panel</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>

<tr>
<td>LED Matrix</td>
<td align = "right"> 1 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Resistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $.25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Photoresistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $1.50 </td>
<td align = "right"> </td>

<tr>
<tr>
<td>Jumper wires(x50)</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Servo belt</td>
<td align = "right"> 2 </td>
<td align = "right"> $2 </td>
<td align = "right"> </td>
<tr>

</table>

== Design & Implementation ==

=== Hardware Design ===

=====Structure Design=====
The structure of the Solar Panel Tracker consists of a 'base' servo to rotate the solar cell to a position in a 180 degree arch, and a 'top' servo which tilts the 'arm' which holds the solar cell and a photoresistor circuit. A second photoresistor circuit, used for the base direction logic, is located on top of the structure and angled in the same direction of the base rotational range. The base servo rotates the structure using servo belts and pulleys which move the structure resting on an old computer fan bearing. This provides for a smooth rotation.

=====Light Sensor=====
The Solar Panel Sun Tracker consists of the following hardware:
* Resistors
*Photo resistors
This section is responsible for interpreting the voltage of the photo resistors. The diagram below shows the circuit needed in order to get a voltage division of the two photo resistors. This voltage divider consists of two resistors on each side of the voltage divider output (ADC pin). When the top photo resistor has a greater resistance then the bottom resistor the voltage output will drop. When they both have the same resistance will hold in the middle.

[[File:CmpE146_S13_SPT_LightSensorConnection.png|center|frame]]
<div style="text-align: center;">'''Figure 1:''' LightSensorConnection </div>

=====Servo Motor=====
The servo section consists of the following hardware:
* Servo Motors / Servo Belts
* Solar Panel

This section is responsible for positioning the solar panels perpendicular to the light source. The panel is mounted to a frame that pivots according to the top servo. In order to perform a full scan the top servo motor was mounted on pivoting bases that is controlled by the second motor. The diagram below describes the complete setup in order to properly track the sun from sun rise to sun set.

[[File:CmpE146_S13_SPT_SJOneBoardSchematic.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>

=== Hardware Interface ===
[[File:CmpE146_S13_SPT_SjOneInterface.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>
<table class = "wikitable">
<th> SJSU Dev Board Pin</th> <th> Destination Pin</th><th>Description</th>

<tr>
<td> PWM1.4(p1.23) </td>
<td align = "right"> Servo Base Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> PWM1.5(p1.24) </td>
<td align = "right"> Servo Top Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> AD0.4(p1.30) </td>
<td align = "right"> Light Sensor Base</td>
<td align = "right"> Analog Input </td>
<tr>
<td> AD0.5(p1.31) </td>
<td align = "right"> Light Sensor Top </td>
<td align = "right"> Analog Input </td>
</table>

==== Pulse Width Modulation ====
PWM, or Pulse Width Modulation, was used to control the two 180 degree positional servos. The servos required a 50 Hz (20 ms) duty cycle, and the duration of the high duty cycle (in milliseconds) would control the position to move to. Typically, the valid high duty cycles are between 1.0 and 2.0 milliseconds, with 1.0 representing '0 degrees', 1.5 representing '90 degrees' and 2.0 representing '180 degrees.' However, we found that the valid duty cycle range was larger, ranging from [INSERT FULL RANGE]. Knowing this, we expanded the range of the duty cycle and converted the range into a degree range with the <i>change_direction_with_Degree()</i> function. The servos were connected to a 5V power supply and were controlled by PWM1-4(P1.23)and PWM1-5(P1.24).

[[File:146ServoPWM.png|center|frame]]

==== Analog-to-Digital-Converter ====
ADC, or Analog-to-Digital-Converter, was used to convert the analog photoresistor circuit voltage into a digital value for processing. The pins ADC-4 and ADC-5 were used in the system, each connected to the output of one of the photoresistor circuits. The raw value was tough to work with, so a conversion to a more manageable range of values was implemented in higher level code.

=== Software Design ===
Show your software design. For example, if you are designing an MP3 Player, show the tasks that you are using, and what they are doing at a high level. Do not show the details of the code. For example, do not show exact code, but you may show psuedocode and fragments of code. Keep in mind that you are showing DESIGN of your software, not the inner workings of it.

Our software design centered on using two tasks to pass data used to track the sun. One task was a Light Sensor task, which is used to load data into the Queue, destined for the other task, a Servo Motor task. The Servo Motor task then calls a function to change the servo position. In order to support the tasks, and bridge the gap between them and the drivers, the LightSensors.cpp and ServoMotor.cpp source files were created.

[[File:CmpE146_S13_SPT_FreeRTOS.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

[[File:CmpE146_S13_SPT_SoftwareFlowchart.png|center|frame]]
<div style="text-align: center;">'''Figure :''' Flowchart of the Software Design </div>

=== Implementation ===
This section includes implementation, but again, not the details, just the high level. For example, you can list the steps it takes to communicate over a sensor, or the steps needed to write a page of memory onto SPI Flash. You can include sub-sections for each of your component implementation.

[[File:CmpE146_S13_SPT_SjOneIO.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' Pins used for ADC and PWM </div>

[[File:CmpE146_S13_SPT_SJOneBoardPWMblockDiagram.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

==== Light sensor Logic ====
The <i>LightSensors.cpp</i> file contains the functions that the Light-sensing task calls. These functions are <i>getDirection()</i>, which reads the referenced Analog-to-Digital Converter pin (ADC-4 or ADC-5), and returns a value which is the new change in direction for the respective servo motor (Top or Base). The <i>getDirection()</i> function reads the ADC pin value and uses it to decide which direction the servo should move towards, and returns either a positive <i>degreeChange</i>, a negative <i>degreeChange</i>, or a 0 for no change. For this project, we decided to use 5 degrees as the degree change. The <i>getDirection()</i> function can be seen below:

[[File:146getDirectionBaseCodeSnippet.png|center|frame]]
==== Servo motor Logic ====
The <i>ServoMotors.cpp</i> file contains the <i>change_direction_withDegree()</i> function, which updates the PWM Match Register for the given PWM signal and the degree. This function takes the degree value, ensures that it is within range, then converts it into milliseconds so it can be written to the respective Match Register, using the <i>PWMUpdateMR()</i> function defined in the PWM driver file. We used the definitions <i>Max_degree</i>, <i>Servo_Width</i>, <i>Servo_Start</i>, and <i>freq_ms</i>, whose values may need to be changed if a different servo motor is used. <i>Max_degree</i> is the farthest degree available to the servo motor (180), <i>freq_ms</i> is the duty cycle (20 ms), and the <i>Servo_Width</i> and <i>Servo_Start</i> are derived from the duty cycle thresholds (in ms) mapped to the degree range (0 - 180) of the servo motor.

[[File:146changeDirectionCodeSnippet.png‎ |center|frame]]
==== Light-sensing Task ====
The Light-sensing task was very simple. To keep it this way, all of the 'heavy lifting' was completed in lower level code in the <i>LightSensors.cpp</i> file. Therefore, the only function that the Light-sensing task needs to use is the <i>getDirection()</i> function. However, there is a small amount of code to prevent the degree values from going out of range (0-180 degrees). The task reads the <i>getDirection()</i> values for both the top and base servo motors, which have valid values of negative five (-5), zero (0), or positive five (5). These values are added to the current positional value to obtain updated values to pass to the Servo Motor task through the Queue.

==== Servo Task ====
The Servo Task is even simpler. It takes the top and base positional values from the Queue, then passes the value to the servo motors using the <i>change_direction_withDegree()</i> function, which is defined in the <i>ServoMotors.cpp</i> file.

[[File:CmpE146_S13_SPT_ServoTask.png‎ |center|frame]]

== Testing & Technical Challenges ==
Describe the challenges of your project. What advise would you give yourself or someone else if your project can be started from scratch again?
Make a smooth transition to testing section and described what it took to test your project.

=== Servo Motor Mounting challenge ===
Initially, the base servo was mounted directly to the base, holding up the other servo, solar cell, etc. The base was unsteady and had a risk of damaging the servo. To fix this, the top servo, solar cell, etc. were mounted on an old computer fan bearing. The base servo motor was moved off to the side, with 2 belts and pulleys used to translate the rotation to the structure on the base.

=== Servo Motors Testing ===
We tested the Servo motors by sending an increasing range of active duty cycle time until the full range was found. Normally, servo motors have an active duty cycle range of 1.0 ms to 2.0 ms. Our servo motors had an actual range of 0.2 ms to 3.3 ms. Once we found this range, we had no problems with the servo motors.

=== Photoresistor Circuit Testing ===
We tested the photoresistor circuit by connecting it to an ADC pin and monitoring the digital values. Varying amounts of light were given to the circuit and appropriate changes in values were observed. For example, when the photoresistor connected to 5V receives more light than the other photoresistor(connected to ground), the voltage to the ADC pin drops. A corresponding drop in value was observed with the digital value. The same comparison was true with a spike in voltage and the spike in digital value, when the other photoresistor receives more light.

=== Integrated Testing ===
We tested the system after full integration by using a flashlight as a simulated sun. The Solar Panel Tracker correctly adjusted for every sun movement.

== Conclusion ==
Conclude your project here. You can recap your testing and problems. You should address the "so what" part here to indicate what you ultimately learnt from this project. How has this project increased your knowledge?

=== Project Video ===
Upload a video of your project and post the link here.

=== Project Source Code ===
Send me your zipped source code and I will upload this to SourceForge and link it for you.

== References ==
=== Acknowledgement ===
Preet Kang

Dr. Haluk Ozemek

=== References Used ===
List any references used in project.

=== Appendix ===
You can list the references you used.

S13: Solar Panel Tracker

2013-05-22T05:30:31Z

Matt s13: /* Project Title */

=== Grading Criteria ===
<font color="green">
* How well is Software & Hardware Design described?
* How well can this report be used to reproduce this project?
* Code Quality
* Overall Report Quality:
** Software Block Diagrams
** Hardware Block Diagrams
**: Schematic Quality
** Quality of technical challenges and solutions adopted.
</font>

== Solar Panel Tracker ==

== Abstract ==
The objective of this project is to create a solar panel that tracks the sun. The project will consist of two stepper motors that control the position of the solar panels by using the photo resistors to detect the sun location.

== Objectives & Introduction ==
Solar Panel Sun tracker uses the inputted voltage from photo resistors in order to adjust the position of the solar panel. The project uses and Analog to digital converter. The servo motors are controlled using a pulse; this controls the position of various angles. The servo uses in this project is a standard servo which can only position between 0 and 180 degrees.

The project required the following objectives to be accomplished:
* Read the voltage from photo resistors
* Control servo to move from 0 to 180 degrees
* Compute the location which has the greatest light intensity
* Determine algorithm to convert digital value into servo position

=== Team Members & Responsibilities ===
* Arturo Montoya
** Light Sensors (PWM driver) , Servo motor(ADC driver) , and Matrix (Spi driver)
* Matthew Balhorn
** FreeRTOS Software Design

== Schedule ==

<table class="wikitable">
<th>Week</th><th>Planned Tasks</th><th>Status</th>
<tr>
<td> <center>
1
</center> </td>
<td>
* Order parts

</td>
<td>
* Completed

</td>
</tr>

<tr>
<td> <center>
2
</center> </td>
<td>
* Look over datasheet(s)
* Test Servos
* Design System Logics
</td>
<td>
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
3
</center> </td>
<td>

* Test Light-sensing circuit
* Create System Schematics
* Code Servo Task
* Create Structure Design (Autodesk Inventor)

</td>
<td>
* Completed
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
4
</center> </td>
<td>

* Code Light-sensing Task
* Build/Machine Structure
* Code Glue Logics (Directional Logic)
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
5
</center> </td>
<td>
* Integrate system
* Test System
* Project report
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
6
</center> </td>
<td>
* Finalize project
* Finalize report
</td>
<td>
* Completed
* Completed
</td>
</tr>

</table>

== Parts List & Cost ==

<table class = "wikitable">
<th>Part</th> <th>Quuantity</th><th>Cost</th><th>Link</th>

<tr>
<td>LPC 1758 SJSU Dev Board</td>
<td align = "right"> 1 </td>
<td align = "right"> $60 </td>
<td align = "right"> </td>

<tr>
<td>180 Degree Servo </td>
<td align = "right"> 2 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>

<tr>
<td>Solar Panel</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>

<tr>
<td>LED Matrix</td>
<td align = "right"> 1 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Resistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $.25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Photoresistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $1.50 </td>
<td align = "right"> </td>

<tr>
<tr>
<td>Jumper wires(x50)</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Servo belt</td>
<td align = "right"> 2 </td>
<td align = "right"> $2 </td>
<td align = "right"> </td>
<tr>

</table>

== Design & Implementation ==
The design section can go over your hardware and software design. Organize this section using sub-sections that go over your design and implementation.

=== Hardware Design ===
=====Structure Design=====
The structure of the Solar Panel Tracker consists of a 'base' servo to rotate the solar cell to a position in a 180 degree arch, and a 'top' servo which tilts the 'arm' which holds the solar cell and a photoresistor circuit. A second photoresistor circuit, used for the base direction logic, is located on top of the structure and angled in the same direction of the base rotational range. The base servo rotates the structure using belts and pulleys which move the structure resting on an old computer fan bearing. This provides for a smooth rotation.

=====Light Sensor=====
The Solar Panel Sun Tracker consists of the following hardware:
* Resistors
*Photo resistors
This section is responsible for interpreting the voltage of the photo resistors. The diagram below shows the circuit needed in order to get a voltage division of the two photo resistors. This voltage divider consists of two resistors on each side of the voltage divider output (ADC pin). When the top photo resistor has a greater resistance then the bottom resistor the voltage output will drop. When they both have the same resistance will hold in the middle.

[[File:CmpE146_S13_SPT_LightSensorConnection.png|center|frame]]
<div style="text-align: center;">'''Figure 1:''' LightSensorConnection </div>

=====Servo Motor=====
The servo section consists of the following hardware:
* Servo Motors / Servo Belts
* Solar Panel

This section is responsible for positioning the solar panels perpendicular to the light source. The panel is mounted to a frame that pivots according to the top servo. In order to perform a full scan the top servo motor was mounted on pivoting bases that is controlled by the second motor. The diagram below describes the complete setup in order to properly track the sun from sun rise to sun set.

[[File:CmpE146_S13_SPT_SJOneBoardSchematic.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>

=== Hardware Interface ===
[[File:CmpE146_S13_SPT_SjOneInterface.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>
<table class = "wikitable">
<th> SJSU Dev Board Pin</th> <th> Destination Pin</th><th>Description</th>

<tr>
<td> PWM1.4(p1.23) </td>
<td align = "right"> Servo Base Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> PWM1.5(p1.24) </td>
<td align = "right"> Servo Top Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> AD0.4(p1.30) </td>
<td align = "right"> Light Sensor Base</td>
<td align = "right"> Analog Input </td>
<tr>
<td> AD0.5(p1.31) </td>
<td align = "right"> Light Sensor Top </td>
<td align = "right"> Analog Input </td>
</table>

==== PWM ====
PWM, or Pulse Width Modulation, was used to control the two 180 degree positional servos. The servos required a 50 Hz (20 ms) duty cycle, and the duration of the high duty cycle (in milliseconds) would control the position to move to. Typically, the valid high duty cycles are between 1.0 and 2.0 milliseconds, with 1.0 representing '0 degrees', 1.5 representing '90 degrees' and 2.0 representing '180 degrees.' However, we found that the valid duty cycle range was larger, ranging from [INSERT FULL RANGE]. Knowing this, we expanded the range of the duty cycle and converted the range into a degree range with the <i>change_direction_with_Degree()</i> function. The servos were connected to a 5V power supply and were controlled by PWM1-4(P1.23)and PWM1-5(P1.24).

[[File:146ServoPWM.png|center|frame]]

==== ADC ====

=== Software Design ===
Show your software design. For example, if you are designing an MP3 Player, show the tasks that you are using, and what they are doing at a high level. Do not show the details of the code. For example, do not show exact code, but you may show psuedocode and fragments of code. Keep in mind that you are showing DESIGN of your software, not the inner workings of it.

Our software design centered on using two tasks to pass data used to track the sun. One task was a Light Sensor task, which is used to load data into the Queue, destined for the other task, a Servo Motor task. The Servo Motor task then calls a function to change the servo position. In order to support the tasks, and bridge the gap between them and the drivers, the LightSensors.cpp and ServoMotor.cpp source files were created.

[[File:CmpE146_S13_SPT_FreeRTOS.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

[[File:CmpE146_S13_SPT_SoftwareFlowchart.png|center|frame]]
<div style="text-align: center;">'''Figure :''' Flowchart of the Software Design </div>

=== Implementation ===
This section includes implementation, but again, not the details, just the high level. For example, you can list the steps it takes to communicate over a sensor, or the steps needed to write a page of memory onto SPI Flash. You can include sub-sections for each of your component implementation.

[[File:CmpE146_S13_SPT_SjOneIO.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' Pins used for ADC and PWM </div>

[[File:CmpE146_S13_SPT_SJOneBoardPWMblockDiagram.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

==== Light sensor Logic ====
The <i>LightSensors.cpp</i> file contains the functions that the Light-sensing task calls. These functions are <i>getDirection()</i>, which reads the referenced Analog-to-Digital Converter pin (ADC-4 or ADC-5), and returns a value which is the new change in direction for the respective servo motor (Top or Base). The <i>getDirection()</i> function reads the ADC pin value and uses it to decide which direction the servo should move towards, and returns either a positive <i>degreeChange</i>, a negative <i>degreeChange</i>, or a 0 for no change. For this project, we decided to use 5 degrees as the degree change. The <i>getDirection()</i> function can be seen below:

[[File:146getDirectionBaseCodeSnippet.png|center|frame]]
==== Servo motor Logic ====
The <i>ServoMotors.cpp</i> file contains the <i>change_direction_withDegree()</i> function, which updates the PWM Match Register for the given PWM signal and the degree. This function takes the degree value, ensures that it is within range, then converts it into milliseconds so it can be written to the respective Match Register, using the <i>PWMUpdateMR()</i> function defined in the PWM driver file. We used the definitions <i>Max_degree</i>, <i>Servo_Width</i>, <i>Servo_Start</i>, and <i>freq_ms</i>, whose values may need to be changed if a different servo motor is used. <i>Max_degree</i> is the farthest degree available to the servo motor (180), <i>freq_ms</i> is the duty cycle (20 ms), and the <i>Servo_Width</i> and <i>Servo_Start</i> are derived from the duty cycle thresholds (in ms) mapped to the degree range (0 - 180) of the servo motor.

[[File:146changeDirectionCodeSnippet.png‎ |center|frame]]
==== Light-sensing Task ====
The Light-sensing task was very simple. To keep it this way, all of the 'heavy lifting' was completed in lower level code in the <i>LightSensors.cpp</i> file. Therefore, the only function that the Light-sensing task needs to use is the <i>getDirection()</i> function. However, there is a small amount of code to prevent the degree values from going out of range (0-180 degrees). The task reads the <i>getDirection()</i> values for both the top and base servo motors, which have valid values of negative five (-5), zero (0), or positive five (5). These values are added to the current positional value to obtain updated values to pass to the Servo Motor task through the Queue.

==== Servo Task ====
The Servo Task is even simpler. It takes the top and base positional values from the Queue, then passes the value to the servo motors using the <i>change_direction_withDegree()</i> function, which is defined in the <i>ServoMotors.cpp</i> file.

[[File:CmpE146_S13_SPT_ServoTask.png‎ |center|frame]]

== Testing & Technical Challenges ==
Describe the challenges of your project. What advise would you give yourself or someone else if your project can be started from scratch again?
Make a smooth transition to testing section and described what it took to test your project.

=== Servo Motor Mounting challenge ===
Initially, the base servo was mounted directly to the base, holding up the other servo, solar cell, etc. The base was unsteady and had a risk of damaging the servo. To fix this, the top servo, solar cell, etc. were mounted on an old computer fan bearing. The base servo motor was moved off to the side, with 2 belts and pulleys used to translate the rotation to the structure on the base.

=== Servo Motors Testing ===
We tested the Servo motors by sending an increasing range of active duty cycle time until the full range was found. Normally, servo motors have an active duty cycle range of 1.0 ms to 2.0 ms. Our servo motors had an actual range of 0.2 ms to 3.3 ms. Once we found this range, we had no problems with the servo motors.

=== Photoresistor Circuit Testing ===
We tested the photoresistor circuit by connecting it to an ADC pin and monitoring the digital values. Varying amounts of light were given to the circuit and appropriate changes in values were observed. For example, when the photoresistor connected to 5V receives more light than the other photoresistor(connected to ground), the voltage to the ADC pin drops. A corresponding drop in value was observed with the digital value. The same comparison was true with a spike in voltage and the spike in digital value, when the other photoresistor receives more light.

=== Integrated Testing ===
We tested the system after full integration by using a flashlight as a simulated sun. The Solar Panel Tracker correctly adjusted for every sun movement.

== Conclusion ==
Conclude your project here. You can recap your testing and problems. You should address the "so what" part here to indicate what you ultimately learnt from this project. How has this project increased your knowledge?

=== Project Video ===
Upload a video of your project and post the link here.

=== Project Source Code ===
Send me your zipped source code and I will upload this to SourceForge and link it for you.

== References ==
=== Acknowledgement ===
Preet Kang

Dr. Haluk Ozemek

=== References Used ===
List any references used in project.

=== Appendix ===
You can list the references you used.

S13: Solar Panel Tracker

2013-05-22T05:28:57Z

Matt s13: /* Hardware Design */

=== Grading Criteria ===
<font color="green">
* How well is Software & Hardware Design described?
* How well can this report be used to reproduce this project?
* Code Quality
* Overall Report Quality:
** Software Block Diagrams
** Hardware Block Diagrams
**: Schematic Quality
** Quality of technical challenges and solutions adopted.
</font>

== Project Title ==

== Abstract ==
The objective of this project is to create a solar panel that tracks the sun. The project will consist of two stepper motors that control the position of the solar panels by using the photo resistors to detect the sun location.

== Objectives & Introduction ==
Solar Panel Sun tracker uses the inputted voltage from photo resistors in order to adjust the position of the solar panel. The project uses and Analog to digital converter. The servo motors are controlled using a pulse; this controls the position of various angles. The servo uses in this project is a standard servo which can only position between 0 and 180 degrees.

The project required the following objectives to be accomplished:
* Read the voltage from photo resistors
* Control servo to move from 0 to 180 degrees
* Compute the location which has the greatest light intensity
* Determine algorithm to convert digital value into servo position

=== Team Members & Responsibilities ===
* Arturo Montoya
** Light Sensors (PWM driver) , Servo motor(ADC driver) , and Matrix (Spi driver)
* Matthew Balhorn
** FreeRTOS Software Design

== Schedule ==

<table class="wikitable">
<th>Week</th><th>Planned Tasks</th><th>Status</th>
<tr>
<td> <center>
1
</center> </td>
<td>
* Order parts

</td>
<td>
* Completed

</td>
</tr>

<tr>
<td> <center>
2
</center> </td>
<td>
* Look over datasheet(s)
* Test Servos
* Design System Logics
</td>
<td>
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
3
</center> </td>
<td>

* Test Light-sensing circuit
* Create System Schematics
* Code Servo Task
* Create Structure Design (Autodesk Inventor)

</td>
<td>
* Completed
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
4
</center> </td>
<td>

* Code Light-sensing Task
* Build/Machine Structure
* Code Glue Logics (Directional Logic)
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
5
</center> </td>
<td>
* Integrate system
* Test System
* Project report
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
6
</center> </td>
<td>
* Finalize project
* Finalize report
</td>
<td>
* Completed
* Completed
</td>
</tr>

</table>

== Parts List & Cost ==

<table class = "wikitable">
<th>Part</th> <th>Quuantity</th><th>Cost</th><th>Link</th>

<tr>
<td>LPC 1758 SJSU Dev Board</td>
<td align = "right"> 1 </td>
<td align = "right"> $60 </td>
<td align = "right"> </td>

<tr>
<td>180 Degree Servo </td>
<td align = "right"> 2 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>

<tr>
<td>Solar Panel</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>

<tr>
<td>LED Matrix</td>
<td align = "right"> 1 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Resistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $.25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Photoresistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $1.50 </td>
<td align = "right"> </td>

<tr>
<tr>
<td>Jumper wires(x50)</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Servo belt</td>
<td align = "right"> 2 </td>
<td align = "right"> $2 </td>
<td align = "right"> </td>
<tr>

</table>

== Design & Implementation ==
The design section can go over your hardware and software design. Organize this section using sub-sections that go over your design and implementation.

=== Hardware Design ===
=====Structure Design=====
The structure of the Solar Panel Tracker consists of a 'base' servo to rotate the solar cell to a position in a 180 degree arch, and a 'top' servo which tilts the 'arm' which holds the solar cell and a photoresistor circuit. A second photoresistor circuit, used for the base direction logic, is located on top of the structure and angled in the same direction of the base rotational range. The base servo rotates the structure using belts and pulleys which move the structure resting on an old computer fan bearing. This provides for a smooth rotation.

=====Light Sensor=====
The Solar Panel Sun Tracker consists of the following hardware:
* Resistors
*Photo resistors
This section is responsible for interpreting the voltage of the photo resistors. The diagram below shows the circuit needed in order to get a voltage division of the two photo resistors. This voltage divider consists of two resistors on each side of the voltage divider output (ADC pin). When the top photo resistor has a greater resistance then the bottom resistor the voltage output will drop. When they both have the same resistance will hold in the middle.

[[File:CmpE146_S13_SPT_LightSensorConnection.png|center|frame]]
<div style="text-align: center;">'''Figure 1:''' LightSensorConnection </div>

=====Servo Motor=====
The servo section consists of the following hardware:
* Servo Motors / Servo Belts
* Solar Panel

This section is responsible for positioning the solar panels perpendicular to the light source. The panel is mounted to a frame that pivots according to the top servo. In order to perform a full scan the top servo motor was mounted on pivoting bases that is controlled by the second motor. The diagram below describes the complete setup in order to properly track the sun from sun rise to sun set.

[[File:CmpE146_S13_SPT_SJOneBoardSchematic.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>

=== Hardware Interface ===
[[File:CmpE146_S13_SPT_SjOneInterface.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>
<table class = "wikitable">
<th> SJSU Dev Board Pin</th> <th> Destination Pin</th><th>Description</th>

<tr>
<td> PWM1.4(p1.23) </td>
<td align = "right"> Servo Base Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> PWM1.5(p1.24) </td>
<td align = "right"> Servo Top Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> AD0.4(p1.30) </td>
<td align = "right"> Light Sensor Base</td>
<td align = "right"> Analog Input </td>
<tr>
<td> AD0.5(p1.31) </td>
<td align = "right"> Light Sensor Top </td>
<td align = "right"> Analog Input </td>
</table>

==== PWM ====
PWM, or Pulse Width Modulation, was used to control the two 180 degree positional servos. The servos required a 50 Hz (20 ms) duty cycle, and the duration of the high duty cycle (in milliseconds) would control the position to move to. Typically, the valid high duty cycles are between 1.0 and 2.0 milliseconds, with 1.0 representing '0 degrees', 1.5 representing '90 degrees' and 2.0 representing '180 degrees.' However, we found that the valid duty cycle range was larger, ranging from [INSERT FULL RANGE]. Knowing this, we expanded the range of the duty cycle and converted the range into a degree range with the <i>change_direction_with_Degree()</i> function. The servos were connected to a 5V power supply and were controlled by PWM1-4(P1.23)and PWM1-5(P1.24).

[[File:146ServoPWM.png|center|frame]]

==== ADC ====

=== Software Design ===
Show your software design. For example, if you are designing an MP3 Player, show the tasks that you are using, and what they are doing at a high level. Do not show the details of the code. For example, do not show exact code, but you may show psuedocode and fragments of code. Keep in mind that you are showing DESIGN of your software, not the inner workings of it.

Our software design centered on using two tasks to pass data used to track the sun. One task was a Light Sensor task, which is used to load data into the Queue, destined for the other task, a Servo Motor task. The Servo Motor task then calls a function to change the servo position. In order to support the tasks, and bridge the gap between them and the drivers, the LightSensors.cpp and ServoMotor.cpp source files were created.

[[File:CmpE146_S13_SPT_FreeRTOS.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

[[File:CmpE146_S13_SPT_SoftwareFlowchart.png|center|frame]]
<div style="text-align: center;">'''Figure :''' Flowchart of the Software Design </div>

=== Implementation ===
This section includes implementation, but again, not the details, just the high level. For example, you can list the steps it takes to communicate over a sensor, or the steps needed to write a page of memory onto SPI Flash. You can include sub-sections for each of your component implementation.

[[File:CmpE146_S13_SPT_SjOneIO.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' Pins used for ADC and PWM </div>

[[File:CmpE146_S13_SPT_SJOneBoardPWMblockDiagram.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

==== Light sensor Logic ====
The <i>LightSensors.cpp</i> file contains the functions that the Light-sensing task calls. These functions are <i>getDirection()</i>, which reads the referenced Analog-to-Digital Converter pin (ADC-4 or ADC-5), and returns a value which is the new change in direction for the respective servo motor (Top or Base). The <i>getDirection()</i> function reads the ADC pin value and uses it to decide which direction the servo should move towards, and returns either a positive <i>degreeChange</i>, a negative <i>degreeChange</i>, or a 0 for no change. For this project, we decided to use 5 degrees as the degree change. The <i>getDirection()</i> function can be seen below:

[[File:146getDirectionBaseCodeSnippet.png|center|frame]]
==== Servo motor Logic ====
The <i>ServoMotors.cpp</i> file contains the <i>change_direction_withDegree()</i> function, which updates the PWM Match Register for the given PWM signal and the degree. This function takes the degree value, ensures that it is within range, then converts it into milliseconds so it can be written to the respective Match Register, using the <i>PWMUpdateMR()</i> function defined in the PWM driver file. We used the definitions <i>Max_degree</i>, <i>Servo_Width</i>, <i>Servo_Start</i>, and <i>freq_ms</i>, whose values may need to be changed if a different servo motor is used. <i>Max_degree</i> is the farthest degree available to the servo motor (180), <i>freq_ms</i> is the duty cycle (20 ms), and the <i>Servo_Width</i> and <i>Servo_Start</i> are derived from the duty cycle thresholds (in ms) mapped to the degree range (0 - 180) of the servo motor.

[[File:146changeDirectionCodeSnippet.png‎ |center|frame]]
==== Light-sensing Task ====
The Light-sensing task was very simple. To keep it this way, all of the 'heavy lifting' was completed in lower level code in the <i>LightSensors.cpp</i> file. Therefore, the only function that the Light-sensing task needs to use is the <i>getDirection()</i> function. However, there is a small amount of code to prevent the degree values from going out of range (0-180 degrees). The task reads the <i>getDirection()</i> values for both the top and base servo motors, which have valid values of negative five (-5), zero (0), or positive five (5). These values are added to the current positional value to obtain updated values to pass to the Servo Motor task through the Queue.

==== Servo Task ====
The Servo Task is even simpler. It takes the top and base positional values from the Queue, then passes the value to the servo motors using the <i>change_direction_withDegree()</i> function, which is defined in the <i>ServoMotors.cpp</i> file.

[[File:CmpE146_S13_SPT_ServoTask.png‎ |center|frame]]

== Testing & Technical Challenges ==
Describe the challenges of your project. What advise would you give yourself or someone else if your project can be started from scratch again?
Make a smooth transition to testing section and described what it took to test your project.

=== Servo Motor Mounting challenge ===
Initially, the base servo was mounted directly to the base, holding up the other servo, solar cell, etc. The base was unsteady and had a risk of damaging the servo. To fix this, the top servo, solar cell, etc. were mounted on an old computer fan bearing. The base servo motor was moved off to the side, with 2 belts and pulleys used to translate the rotation to the structure on the base.

=== Servo Motors Testing ===
We tested the Servo motors by sending an increasing range of active duty cycle time until the full range was found. Normally, servo motors have an active duty cycle range of 1.0 ms to 2.0 ms. Our servo motors had an actual range of 0.2 ms to 3.3 ms. Once we found this range, we had no problems with the servo motors.

=== Photoresistor Circuit Testing ===
We tested the photoresistor circuit by connecting it to an ADC pin and monitoring the digital values. Varying amounts of light were given to the circuit and appropriate changes in values were observed. For example, when the photoresistor connected to 5V receives more light than the other photoresistor(connected to ground), the voltage to the ADC pin drops. A corresponding drop in value was observed with the digital value. The same comparison was true with a spike in voltage and the spike in digital value, when the other photoresistor receives more light.

=== Integrated Testing ===
We tested the system after full integration by using a flashlight as a simulated sun. The Solar Panel Tracker correctly adjusted for every sun movement.

== Conclusion ==
Conclude your project here. You can recap your testing and problems. You should address the "so what" part here to indicate what you ultimately learnt from this project. How has this project increased your knowledge?

=== Project Video ===
Upload a video of your project and post the link here.

=== Project Source Code ===
Send me your zipped source code and I will upload this to SourceForge and link it for you.

== References ==
=== Acknowledgement ===
Preet Kang

Dr. Haluk Ozemek

=== References Used ===
List any references used in project.

=== Appendix ===
You can list the references you used.

S13: Solar Panel Tracker

2013-05-22T05:16:54Z

Matt s13: /* Software Design */

=== Grading Criteria ===
<font color="green">
* How well is Software & Hardware Design described?
* How well can this report be used to reproduce this project?
* Code Quality
* Overall Report Quality:
** Software Block Diagrams
** Hardware Block Diagrams
**: Schematic Quality
** Quality of technical challenges and solutions adopted.
</font>

== Project Title ==

== Abstract ==
The objective of this project is to create a solar panel that tracks the sun. The project will consist of two stepper motors that control the position of the solar panels by using the photo resistors to detect the sun location.

== Objectives & Introduction ==
Solar Panel Sun tracker uses the inputted voltage from photo resistors in order to adjust the position of the solar panel. The project uses and Analog to digital converter. The servo motors are controlled using a pulse; this controls the position of various angles. The servo uses in this project is a standard servo which can only position between 0 and 180 degrees.

The project required the following objectives to be accomplished:
* Read the voltage from photo resistors
* Control servo to move from 0 to 180 degrees
* Compute the location which has the greatest light intensity
* Determine algorithm to convert digital value into servo position

=== Team Members & Responsibilities ===
* Arturo Montoya
** Light Sensors (PWM driver) , Servo motor(ADC driver) , and Matrix (Spi driver)
* Matthew Balhorn
** FreeRTOS Software Design

== Schedule ==

<table class="wikitable">
<th>Week</th><th>Planned Tasks</th><th>Status</th>
<tr>
<td> <center>
1
</center> </td>
<td>
* Order parts

</td>
<td>
* Completed

</td>
</tr>

<tr>
<td> <center>
2
</center> </td>
<td>
* Look over datasheet(s)
* Test Servos
* Design System Logics
</td>
<td>
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
3
</center> </td>
<td>

* Test Light-sensing circuit
* Create System Schematics
* Code Servo Task
* Create Structure Design (Autodesk Inventor)

</td>
<td>
* Completed
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
4
</center> </td>
<td>

* Code Light-sensing Task
* Build/Machine Structure
* Code Glue Logics (Directional Logic)
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
5
</center> </td>
<td>
* Integrate system
* Test System
* Project report
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
6
</center> </td>
<td>
* Finalize project
* Finalize report
</td>
<td>
* Completed
* Completed
</td>
</tr>

</table>

== Parts List & Cost ==

<table class = "wikitable">
<th>Part</th> <th>Quuantity</th><th>Cost</th><th>Link</th>

<tr>
<td>LPC 1758 SJSU Dev Board</td>
<td align = "right"> 1 </td>
<td align = "right"> $60 </td>
<td align = "right"> </td>

<tr>
<td>180 Degree Servo </td>
<td align = "right"> 2 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>

<tr>
<td>Solar Panel</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>

<tr>
<td>LED Matrix</td>
<td align = "right"> 1 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Resistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $.25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Photoresistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $1.50 </td>
<td align = "right"> </td>

<tr>
<tr>
<td>Jumper wires(x50)</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Servo belt</td>
<td align = "right"> 2 </td>
<td align = "right"> $2 </td>
<td align = "right"> </td>
<tr>

</table>

== Design & Implementation ==
The design section can go over your hardware and software design. Organize this section using sub-sections that go over your design and implementation.

=== Hardware Design ===
=====Light Sensor=====
The Solar Panel Sun Tracker consists of the following hardware:
* Resistors
*Photo resistors
This section is responsible for interpreting the voltage of the photo resistors. The diagram below shows the circuit needed in order to get a voltage division of the two photo resistors. This voltage divider consists of two resistors on each side of the voltage divider output (ADC pin). When the top photo resistor has a greater resistance then the bottom resistor the voltage output will drop. When they both have the same resistance will hold in the middle.

[[File:CmpE146_S13_SPT_LightSensorConnection.png|center|frame]]
<div style="text-align: center;">'''Figure 1:''' LightSensorConnection </div>

=====Servo Motor=====
The servo section consists of the following hardware:
* Servo Motors / Servo Belts
* Solar Panel

This section is responsible for positioning the solar panels perpendicular to the light source. The panel is mounted to a frame that pivots according to the top servo. In order to perform a full scan the top servo motor was mounted on pivoting bases that is controlled by the second motor. The diagram below describes the complete setup in order to properly track the sun from sun rise to sun set.

[[File:CmpE146_S13_SPT_SJOneBoardSchematic.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>

=== Hardware Interface ===
[[File:CmpE146_S13_SPT_SjOneInterface.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>
<table class = "wikitable">
<th> SJSU Dev Board Pin</th> <th> Destination Pin</th><th>Description</th>

<tr>
<td> PWM1.4(p1.23) </td>
<td align = "right"> Servo Base Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> PWM1.5(p1.24) </td>
<td align = "right"> Servo Top Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> AD0.4(p1.30) </td>
<td align = "right"> Light Sensor Base</td>
<td align = "right"> Analog Input </td>
<tr>
<td> AD0.5(p1.31) </td>
<td align = "right"> Light Sensor Top </td>
<td align = "right"> Analog Input </td>
</table>

==== PWM ====
PWM, or Pulse Width Modulation, was used to control the two 180 degree positional servos. The servos required a 50 Hz (20 ms) duty cycle, and the duration of the high duty cycle (in milliseconds) would control the position to move to. Typically, the valid high duty cycles are between 1.0 and 2.0 milliseconds, with 1.0 representing '0 degrees', 1.5 representing '90 degrees' and 2.0 representing '180 degrees.' However, we found that the valid duty cycle range was larger, ranging from [INSERT FULL RANGE]. Knowing this, we expanded the range of the duty cycle and converted the range into a degree range with the <i>change_direction_with_Degree()</i> function. The servos were connected to a 5V power supply and were controlled by PWM1-4(P1.23)and PWM1-5(P1.24).

[[File:146ServoPWM.png|center|frame]]

==== ADC ====

=== Software Design ===
Show your software design. For example, if you are designing an MP3 Player, show the tasks that you are using, and what they are doing at a high level. Do not show the details of the code. For example, do not show exact code, but you may show psuedocode and fragments of code. Keep in mind that you are showing DESIGN of your software, not the inner workings of it.

Our software design centered on using two tasks to pass data used to track the sun. One task was a Light Sensor task, which is used to load data into the Queue, destined for the other task, a Servo Motor task. The Servo Motor task then calls a function to change the servo position. In order to support the tasks, and bridge the gap between them and the drivers, the LightSensors.cpp and ServoMotor.cpp source files were created.

[[File:CmpE146_S13_SPT_FreeRTOS.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

[[File:CmpE146_S13_SPT_SoftwareFlowchart.png|center|frame]]
<div style="text-align: center;">'''Figure :''' Flowchart of the Software Design </div>

=== Implementation ===
This section includes implementation, but again, not the details, just the high level. For example, you can list the steps it takes to communicate over a sensor, or the steps needed to write a page of memory onto SPI Flash. You can include sub-sections for each of your component implementation.

[[File:CmpE146_S13_SPT_SjOneIO.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' Pins used for ADC and PWM </div>

[[File:CmpE146_S13_SPT_SJOneBoardPWMblockDiagram.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

==== Light sensor Logic ====
The <i>LightSensors.cpp</i> file contains the functions that the Light-sensing task calls. These functions are <i>getDirection()</i>, which reads the referenced Analog-to-Digital Converter pin (ADC-4 or ADC-5), and returns a value which is the new change in direction for the respective servo motor (Top or Base). The <i>getDirection()</i> function reads the ADC pin value and uses it to decide which direction the servo should move towards, and returns either a positive <i>degreeChange</i>, a negative <i>degreeChange</i>, or a 0 for no change. For this project, we decided to use 5 degrees as the degree change. The <i>getDirection()</i> function can be seen below:

[[File:146getDirectionBaseCodeSnippet.png|center|frame]]
==== Servo motor Logic ====
The <i>ServoMotors.cpp</i> file contains the <i>change_direction_withDegree()</i> function, which updates the PWM Match Register for the given PWM signal and the degree. This function takes the degree value, ensures that it is within range, then converts it into milliseconds so it can be written to the respective Match Register, using the <i>PWMUpdateMR()</i> function defined in the PWM driver file. We used the definitions <i>Max_degree</i>, <i>Servo_Width</i>, <i>Servo_Start</i>, and <i>freq_ms</i>, whose values may need to be changed if a different servo motor is used. <i>Max_degree</i> is the farthest degree available to the servo motor (180), <i>freq_ms</i> is the duty cycle (20 ms), and the <i>Servo_Width</i> and <i>Servo_Start</i> are derived from the duty cycle thresholds (in ms) mapped to the degree range (0 - 180) of the servo motor.

[[File:146changeDirectionCodeSnippet.png‎ |center|frame]]
==== Light-sensing Task ====
The Light-sensing task was very simple. To keep it this way, all of the 'heavy lifting' was completed in lower level code in the <i>LightSensors.cpp</i> file. Therefore, the only function that the Light-sensing task needs to use is the <i>getDirection()</i> function. However, there is a small amount of code to prevent the degree values from going out of range (0-180 degrees). The task reads the <i>getDirection()</i> values for both the top and base servo motors, which have valid values of negative five (-5), zero (0), or positive five (5). These values are added to the current positional value to obtain updated values to pass to the Servo Motor task through the Queue.

==== Servo Task ====
The Servo Task is even simpler. It takes the top and base positional values from the Queue, then passes the value to the servo motors using the <i>change_direction_withDegree()</i> function, which is defined in the <i>ServoMotors.cpp</i> file.

[[File:CmpE146_S13_SPT_ServoTask.png‎ |center|frame]]

== Testing & Technical Challenges ==
Describe the challenges of your project. What advise would you give yourself or someone else if your project can be started from scratch again?
Make a smooth transition to testing section and described what it took to test your project.

=== Servo Motor Mounting challenge ===
Initially, the base servo was mounted directly to the base, holding up the other servo, solar cell, etc. The base was unsteady and had a risk of damaging the servo. To fix this, the top servo, solar cell, etc. were mounted on an old computer fan bearing. The base servo motor was moved off to the side, with 2 belts and pulleys used to translate the rotation to the structure on the base.

=== Servo Motors Testing ===
We tested the Servo motors by sending an increasing range of active duty cycle time until the full range was found. Normally, servo motors have an active duty cycle range of 1.0 ms to 2.0 ms. Our servo motors had an actual range of 0.2 ms to 3.3 ms. Once we found this range, we had no problems with the servo motors.

=== Photoresistor Circuit Testing ===
We tested the photoresistor circuit by connecting it to an ADC pin and monitoring the digital values. Varying amounts of light were given to the circuit and appropriate changes in values were observed. For example, when the photoresistor connected to 5V receives more light than the other photoresistor(connected to ground), the voltage to the ADC pin drops. A corresponding drop in value was observed with the digital value. The same comparison was true with a spike in voltage and the spike in digital value, when the other photoresistor receives more light.

=== Integrated Testing ===
We tested the system after full integration by using a flashlight as a simulated sun. The Solar Panel Tracker correctly adjusted for every sun movement.

== Conclusion ==
Conclude your project here. You can recap your testing and problems. You should address the "so what" part here to indicate what you ultimately learnt from this project. How has this project increased your knowledge?

=== Project Video ===
Upload a video of your project and post the link here.

=== Project Source Code ===
Send me your zipped source code and I will upload this to SourceForge and link it for you.

== References ==
=== Acknowledgement ===
Preet Kang

Dr. Haluk Ozemek

=== References Used ===
List any references used in project.

=== Appendix ===
You can list the references you used.

S13: Solar Panel Tracker

2013-05-22T05:15:42Z

Matt s13: /* Testing & Technical Challenges */

=== Grading Criteria ===
<font color="green">
* How well is Software & Hardware Design described?
* How well can this report be used to reproduce this project?
* Code Quality
* Overall Report Quality:
** Software Block Diagrams
** Hardware Block Diagrams
**: Schematic Quality
** Quality of technical challenges and solutions adopted.
</font>

== Project Title ==

== Abstract ==
The objective of this project is to create a solar panel that tracks the sun. The project will consist of two stepper motors that control the position of the solar panels by using the photo resistors to detect the sun location.

== Objectives & Introduction ==
Solar Panel Sun tracker uses the inputted voltage from photo resistors in order to adjust the position of the solar panel. The project uses and Analog to digital converter. The servo motors are controlled using a pulse; this controls the position of various angles. The servo uses in this project is a standard servo which can only position between 0 and 180 degrees.

The project required the following objectives to be accomplished:
* Read the voltage from photo resistors
* Control servo to move from 0 to 180 degrees
* Compute the location which has the greatest light intensity
* Determine algorithm to convert digital value into servo position

=== Team Members & Responsibilities ===
* Arturo Montoya
** Light Sensors (PWM driver) , Servo motor(ADC driver) , and Matrix (Spi driver)
* Matthew Balhorn
** FreeRTOS Software Design

== Schedule ==

<table class="wikitable">
<th>Week</th><th>Planned Tasks</th><th>Status</th>
<tr>
<td> <center>
1
</center> </td>
<td>
* Order parts

</td>
<td>
* Completed

</td>
</tr>

<tr>
<td> <center>
2
</center> </td>
<td>
* Look over datasheet(s)
* Test Servos
* Design System Logics
</td>
<td>
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
3
</center> </td>
<td>

* Test Light-sensing circuit
* Create System Schematics
* Code Servo Task
* Create Structure Design (Autodesk Inventor)

</td>
<td>
* Completed
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
4
</center> </td>
<td>

* Code Light-sensing Task
* Build/Machine Structure
* Code Glue Logics (Directional Logic)
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
5
</center> </td>
<td>
* Integrate system
* Test System
* Project report
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
6
</center> </td>
<td>
* Finalize project
* Finalize report
</td>
<td>
* Completed
* Completed
</td>
</tr>

</table>

== Parts List & Cost ==

<table class = "wikitable">
<th>Part</th> <th>Quuantity</th><th>Cost</th><th>Link</th>

<tr>
<td>LPC 1758 SJSU Dev Board</td>
<td align = "right"> 1 </td>
<td align = "right"> $60 </td>
<td align = "right"> </td>

<tr>
<td>180 Degree Servo </td>
<td align = "right"> 2 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>

<tr>
<td>Solar Panel</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>

<tr>
<td>LED Matrix</td>
<td align = "right"> 1 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Resistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $.25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Photoresistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $1.50 </td>
<td align = "right"> </td>

<tr>
<tr>
<td>Jumper wires(x50)</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Servo belt</td>
<td align = "right"> 2 </td>
<td align = "right"> $2 </td>
<td align = "right"> </td>
<tr>

</table>

== Design & Implementation ==
The design section can go over your hardware and software design. Organize this section using sub-sections that go over your design and implementation.

=== Hardware Design ===
=====Light Sensor=====
The Solar Panel Sun Tracker consists of the following hardware:
* Resistors
*Photo resistors
This section is responsible for interpreting the voltage of the photo resistors. The diagram below shows the circuit needed in order to get a voltage division of the two photo resistors. This voltage divider consists of two resistors on each side of the voltage divider output (ADC pin). When the top photo resistor has a greater resistance then the bottom resistor the voltage output will drop. When they both have the same resistance will hold in the middle.

[[File:CmpE146_S13_SPT_LightSensorConnection.png|center|frame]]
<div style="text-align: center;">'''Figure 1:''' LightSensorConnection </div>

=====Servo Motor=====
The servo section consists of the following hardware:
* Servo Motors / Servo Belts
* Solar Panel

This section is responsible for positioning the solar panels perpendicular to the light source. The panel is mounted to a frame that pivots according to the top servo. In order to perform a full scan the top servo motor was mounted on pivoting bases that is controlled by the second motor. The diagram below describes the complete setup in order to properly track the sun from sun rise to sun set.

[[File:CmpE146_S13_SPT_SJOneBoardSchematic.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>

=== Hardware Interface ===
[[File:CmpE146_S13_SPT_SjOneInterface.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>
<table class = "wikitable">
<th> SJSU Dev Board Pin</th> <th> Destination Pin</th><th>Description</th>

<tr>
<td> PWM1.4(p1.23) </td>
<td align = "right"> Servo Base Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> PWM1.5(p1.24) </td>
<td align = "right"> Servo Top Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> AD0.4(p1.30) </td>
<td align = "right"> Light Sensor Base</td>
<td align = "right"> Analog Input </td>
<tr>
<td> AD0.5(p1.31) </td>
<td align = "right"> Light Sensor Top </td>
<td align = "right"> Analog Input </td>
</table>

==== PWM ====
PWM, or Pulse Width Modulation, was used to control the two 180 degree positional servos. The servos required a 50 Hz (20 ms) duty cycle, and the duration of the high duty cycle (in milliseconds) would control the position to move to. Typically, the valid high duty cycles are between 1.0 and 2.0 milliseconds, with 1.0 representing '0 degrees', 1.5 representing '90 degrees' and 2.0 representing '180 degrees.' However, we found that the valid duty cycle range was larger, ranging from [INSERT FULL RANGE]. Knowing this, we expanded the range of the duty cycle and converted the range into a degree range with the <i>change_direction_with_Degree()</i> function. The servos were connected to a 5V power supply and were controlled by PWM1-4(P1.23)and PWM1-5(P1.24).

[[File:146ServoPWM.png|center|frame]]

==== ADC ====

=== Software Design ===
Show your software design. For example, if you are designing an MP3 Player, show the tasks that you are using, and what they are doing at a high level. Do not show the details of the code. For example, do not show exact code, but you may show psuedocode and fragments of code. Keep in mind that you are showing DESIGN of your software, not the inner workings of it.

[[File:CmpE146_S13_SPT_FreeRTOS.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

[[File:CmpE146_S13_SPT_SoftwareFlowchart.png|center|frame]]
<div style="text-align: center;">'''Figure :''' </div>

=== Implementation ===
This section includes implementation, but again, not the details, just the high level. For example, you can list the steps it takes to communicate over a sensor, or the steps needed to write a page of memory onto SPI Flash. You can include sub-sections for each of your component implementation.

[[File:CmpE146_S13_SPT_SjOneIO.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' Pins used for ADC and PWM </div>

[[File:CmpE146_S13_SPT_SJOneBoardPWMblockDiagram.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

==== Light sensor Logic ====
The <i>LightSensors.cpp</i> file contains the functions that the Light-sensing task calls. These functions are <i>getDirection()</i>, which reads the referenced Analog-to-Digital Converter pin (ADC-4 or ADC-5), and returns a value which is the new change in direction for the respective servo motor (Top or Base). The <i>getDirection()</i> function reads the ADC pin value and uses it to decide which direction the servo should move towards, and returns either a positive <i>degreeChange</i>, a negative <i>degreeChange</i>, or a 0 for no change. For this project, we decided to use 5 degrees as the degree change. The <i>getDirection()</i> function can be seen below:

[[File:146getDirectionBaseCodeSnippet.png|center|frame]]
==== Servo motor Logic ====
The <i>ServoMotors.cpp</i> file contains the <i>change_direction_withDegree()</i> function, which updates the PWM Match Register for the given PWM signal and the degree. This function takes the degree value, ensures that it is within range, then converts it into milliseconds so it can be written to the respective Match Register, using the <i>PWMUpdateMR()</i> function defined in the PWM driver file. We used the definitions <i>Max_degree</i>, <i>Servo_Width</i>, <i>Servo_Start</i>, and <i>freq_ms</i>, whose values may need to be changed if a different servo motor is used. <i>Max_degree</i> is the farthest degree available to the servo motor (180), <i>freq_ms</i> is the duty cycle (20 ms), and the <i>Servo_Width</i> and <i>Servo_Start</i> are derived from the duty cycle thresholds (in ms) mapped to the degree range (0 - 180) of the servo motor.

[[File:146changeDirectionCodeSnippet.png‎ |center|frame]]
==== Light-sensing Task ====
The Light-sensing task was very simple. To keep it this way, all of the 'heavy lifting' was completed in lower level code in the <i>LightSensors.cpp</i> file. Therefore, the only function that the Light-sensing task needs to use is the <i>getDirection()</i> function. However, there is a small amount of code to prevent the degree values from going out of range (0-180 degrees). The task reads the <i>getDirection()</i> values for both the top and base servo motors, which have valid values of negative five (-5), zero (0), or positive five (5). These values are added to the current positional value to obtain updated values to pass to the Servo Motor task through the Queue.

==== Servo Task ====
The Servo Task is even simpler. It takes the top and base positional values from the Queue, then passes the value to the servo motors using the <i>change_direction_withDegree()</i> function, which is defined in the <i>ServoMotors.cpp</i> file.

[[File:CmpE146_S13_SPT_ServoTask.png‎ |center|frame]]

== Testing & Technical Challenges ==
Describe the challenges of your project. What advise would you give yourself or someone else if your project can be started from scratch again?
Make a smooth transition to testing section and described what it took to test your project.

=== Servo Motor Mounting challenge ===
Initially, the base servo was mounted directly to the base, holding up the other servo, solar cell, etc. The base was unsteady and had a risk of damaging the servo. To fix this, the top servo, solar cell, etc. were mounted on an old computer fan bearing. The base servo motor was moved off to the side, with 2 belts and pulleys used to translate the rotation to the structure on the base.

=== Servo Motors Testing ===
We tested the Servo motors by sending an increasing range of active duty cycle time until the full range was found. Normally, servo motors have an active duty cycle range of 1.0 ms to 2.0 ms. Our servo motors had an actual range of 0.2 ms to 3.3 ms. Once we found this range, we had no problems with the servo motors.

=== Photoresistor Circuit Testing ===
We tested the photoresistor circuit by connecting it to an ADC pin and monitoring the digital values. Varying amounts of light were given to the circuit and appropriate changes in values were observed. For example, when the photoresistor connected to 5V receives more light than the other photoresistor(connected to ground), the voltage to the ADC pin drops. A corresponding drop in value was observed with the digital value. The same comparison was true with a spike in voltage and the spike in digital value, when the other photoresistor receives more light.

=== Integrated Testing ===
We tested the system after full integration by using a flashlight as a simulated sun. The Solar Panel Tracker correctly adjusted for every sun movement.

== Conclusion ==
Conclude your project here. You can recap your testing and problems. You should address the "so what" part here to indicate what you ultimately learnt from this project. How has this project increased your knowledge?

=== Project Video ===
Upload a video of your project and post the link here.

=== Project Source Code ===
Send me your zipped source code and I will upload this to SourceForge and link it for you.

== References ==
=== Acknowledgement ===
Preet Kang

Dr. Haluk Ozemek

=== References Used ===
List any references used in project.

=== Appendix ===
You can list the references you used.

S13: Solar Panel Tracker

2013-05-22T05:06:52Z

Matt s13: /* Testing & Technical Challenges */

=== Grading Criteria ===
<font color="green">
* How well is Software & Hardware Design described?
* How well can this report be used to reproduce this project?
* Code Quality
* Overall Report Quality:
** Software Block Diagrams
** Hardware Block Diagrams
**: Schematic Quality
** Quality of technical challenges and solutions adopted.
</font>

== Project Title ==

== Abstract ==
The objective of this project is to create a solar panel that tracks the sun. The project will consist of two stepper motors that control the position of the solar panels by using the photo resistors to detect the sun location.

== Objectives & Introduction ==
Solar Panel Sun tracker uses the inputted voltage from photo resistors in order to adjust the position of the solar panel. The project uses and Analog to digital converter. The servo motors are controlled using a pulse; this controls the position of various angles. The servo uses in this project is a standard servo which can only position between 0 and 180 degrees.

The project required the following objectives to be accomplished:
* Read the voltage from photo resistors
* Control servo to move from 0 to 180 degrees
* Compute the location which has the greatest light intensity
* Determine algorithm to convert digital value into servo position

=== Team Members & Responsibilities ===
* Arturo Montoya
** Light Sensors (PWM driver) , Servo motor(ADC driver) , and Matrix (Spi driver)
* Matthew Balhorn
** FreeRTOS Software Design

== Schedule ==

<table class="wikitable">
<th>Week</th><th>Planned Tasks</th><th>Status</th>
<tr>
<td> <center>
1
</center> </td>
<td>
* Order parts

</td>
<td>
* Completed

</td>
</tr>

<tr>
<td> <center>
2
</center> </td>
<td>
* Look over datasheet(s)
* Test Servos
* Design System Logics
</td>
<td>
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
3
</center> </td>
<td>

* Test Light-sensing circuit
* Create System Schematics
* Code Servo Task
* Create Structure Design (Autodesk Inventor)

</td>
<td>
* Completed
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
4
</center> </td>
<td>

* Code Light-sensing Task
* Build/Machine Structure
* Code Glue Logics (Directional Logic)
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
5
</center> </td>
<td>
* Integrate system
* Test System
* Project report
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
6
</center> </td>
<td>
* Finalize project
* Finalize report
</td>
<td>
* Completed
* Completed
</td>
</tr>

</table>

== Parts List & Cost ==

<table class = "wikitable">
<th>Part</th> <th>Quuantity</th><th>Cost</th><th>Link</th>

<tr>
<td>LPC 1758 SJSU Dev Board</td>
<td align = "right"> 1 </td>
<td align = "right"> $60 </td>
<td align = "right"> </td>

<tr>
<td>180 Degree Servo </td>
<td align = "right"> 2 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>

<tr>
<td>Solar Panel</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>

<tr>
<td>LED Matrix</td>
<td align = "right"> 1 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Resistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $.25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Photoresistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $1.50 </td>
<td align = "right"> </td>

<tr>
<tr>
<td>Jumper wires(x50)</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Servo belt</td>
<td align = "right"> 2 </td>
<td align = "right"> $2 </td>
<td align = "right"> </td>
<tr>

</table>

== Design & Implementation ==
The design section can go over your hardware and software design. Organize this section using sub-sections that go over your design and implementation.

=== Hardware Design ===
=====Light Sensor=====
The Solar Panel Sun Tracker consists of the following hardware:
* Resistors
*Photo resistors
This section is responsible for interpreting the voltage of the photo resistors. The diagram below shows the circuit needed in order to get a voltage division of the two photo resistors. This voltage divider consists of two resistors on each side of the voltage divider output (ADC pin). When the top photo resistor has a greater resistance then the bottom resistor the voltage output will drop. When they both have the same resistance will hold in the middle.

[[File:CmpE146_S13_SPT_LightSensorConnection.png|center|frame]]
<div style="text-align: center;">'''Figure 1:''' LightSensorConnection </div>

=====Servo Motor=====
The servo section consists of the following hardware:
* Servo Motors / Servo Belts
* Solar Panel

This section is responsible for positioning the solar panels perpendicular to the light source. The panel is mounted to a frame that pivots according to the top servo. In order to perform a full scan the top servo motor was mounted on pivoting bases that is controlled by the second motor. The diagram below describes the complete setup in order to properly track the sun from sun rise to sun set.

[[File:CmpE146_S13_SPT_SJOneBoardSchematic.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>

=== Hardware Interface ===
[[File:CmpE146_S13_SPT_SjOneInterface.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>
<table class = "wikitable">
<th> SJSU Dev Board Pin</th> <th> Destination Pin</th><th>Description</th>

<tr>
<td> PWM1.4(p1.23) </td>
<td align = "right"> Servo Base Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> PWM1.5(p1.24) </td>
<td align = "right"> Servo Top Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> AD0.4(p1.30) </td>
<td align = "right"> Light Sensor Base</td>
<td align = "right"> Analog Input </td>
<tr>
<td> AD0.5(p1.31) </td>
<td align = "right"> Light Sensor Top </td>
<td align = "right"> Analog Input </td>
</table>

==== PWM ====
PWM, or Pulse Width Modulation, was used to control the two 180 degree positional servos. The servos required a 50 Hz (20 ms) duty cycle, and the duration of the high duty cycle (in milliseconds) would control the position to move to. Typically, the valid high duty cycles are between 1.0 and 2.0 milliseconds, with 1.0 representing '0 degrees', 1.5 representing '90 degrees' and 2.0 representing '180 degrees.' However, we found that the valid duty cycle range was larger, ranging from [INSERT FULL RANGE]. Knowing this, we expanded the range of the duty cycle and converted the range into a degree range with the <i>change_direction_with_Degree()</i> function. The servos were connected to a 5V power supply and were controlled by PWM1-4(P1.23)and PWM1-5(P1.24).

[[File:146ServoPWM.png|center|frame]]

==== ADC ====

=== Software Design ===
Show your software design. For example, if you are designing an MP3 Player, show the tasks that you are using, and what they are doing at a high level. Do not show the details of the code. For example, do not show exact code, but you may show psuedocode and fragments of code. Keep in mind that you are showing DESIGN of your software, not the inner workings of it.

[[File:CmpE146_S13_SPT_FreeRTOS.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

[[File:CmpE146_S13_SPT_SoftwareFlowchart.png|center|frame]]
<div style="text-align: center;">'''Figure :''' </div>

=== Implementation ===
This section includes implementation, but again, not the details, just the high level. For example, you can list the steps it takes to communicate over a sensor, or the steps needed to write a page of memory onto SPI Flash. You can include sub-sections for each of your component implementation.

[[File:CmpE146_S13_SPT_SjOneIO.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' Pins used for ADC and PWM </div>

[[File:CmpE146_S13_SPT_SJOneBoardPWMblockDiagram.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

==== Light sensor Logic ====
The <i>LightSensors.cpp</i> file contains the functions that the Light-sensing task calls. These functions are <i>getDirection()</i>, which reads the referenced Analog-to-Digital Converter pin (ADC-4 or ADC-5), and returns a value which is the new change in direction for the respective servo motor (Top or Base). The <i>getDirection()</i> function reads the ADC pin value and uses it to decide which direction the servo should move towards, and returns either a positive <i>degreeChange</i>, a negative <i>degreeChange</i>, or a 0 for no change. For this project, we decided to use 5 degrees as the degree change. The <i>getDirection()</i> function can be seen below:

[[File:146getDirectionBaseCodeSnippet.png|center|frame]]
==== Servo motor Logic ====
The <i>ServoMotors.cpp</i> file contains the <i>change_direction_withDegree()</i> function, which updates the PWM Match Register for the given PWM signal and the degree. This function takes the degree value, ensures that it is within range, then converts it into milliseconds so it can be written to the respective Match Register, using the <i>PWMUpdateMR()</i> function defined in the PWM driver file. We used the definitions <i>Max_degree</i>, <i>Servo_Width</i>, <i>Servo_Start</i>, and <i>freq_ms</i>, whose values may need to be changed if a different servo motor is used. <i>Max_degree</i> is the farthest degree available to the servo motor (180), <i>freq_ms</i> is the duty cycle (20 ms), and the <i>Servo_Width</i> and <i>Servo_Start</i> are derived from the duty cycle thresholds (in ms) mapped to the degree range (0 - 180) of the servo motor.

[[File:146changeDirectionCodeSnippet.png‎ |center|frame]]
==== Light-sensing Task ====
The Light-sensing task was very simple. To keep it this way, all of the 'heavy lifting' was completed in lower level code in the <i>LightSensors.cpp</i> file. Therefore, the only function that the Light-sensing task needs to use is the <i>getDirection()</i> function. However, there is a small amount of code to prevent the degree values from going out of range (0-180 degrees). The task reads the <i>getDirection()</i> values for both the top and base servo motors, which have valid values of negative five (-5), zero (0), or positive five (5). These values are added to the current positional value to obtain updated values to pass to the Servo Motor task through the Queue.

==== Servo Task ====
The Servo Task is even simpler. It takes the top and base positional values from the Queue, then passes the value to the servo motors using the <i>change_direction_withDegree()</i> function, which is defined in the <i>ServoMotors.cpp</i> file.

[[File:CmpE146_S13_SPT_ServoTask.png‎ |center|frame]]

== Testing & Technical Challenges ==
Describe the challenges of your project. What advise would you give yourself or someone else if your project can be started from scratch again?
Make a smooth transition to testing section and described what it took to test your project.

=== Servo Motors Testing ===
We tested the Servo motors by sending an increasing range of active duty cycle time until the full range was found. Normally, servo motors have an active duty cycle range of 1.0 ms to 2.0 ms. Our servo motors had an actual range of 0.2 ms to 3.3 ms. Once we found this range, we had no problems with the servo motors.

=== Photoresistor Circuit Testing ===
We tested the photoresistor circuit by connecting it to an ADC pin and monitoring the digital values. Varying amounts of light were given to the circuit and appropriate changes in values were observed. For example, when the photoresistor connected to 5V receives more light than the other photoresistor(connected to ground), the voltage to the ADC pin drops. A corresponding drop in value was observed with the digital value. The same comparison was true with a spike in voltage and the spike in digital value, when the other photoresistor receives more light.

=== Integrated Testing ===

== Conclusion ==
Conclude your project here. You can recap your testing and problems. You should address the "so what" part here to indicate what you ultimately learnt from this project. How has this project increased your knowledge?

=== Project Video ===
Upload a video of your project and post the link here.

=== Project Source Code ===
Send me your zipped source code and I will upload this to SourceForge and link it for you.

== References ==
=== Acknowledgement ===
Preet Kang

Dr. Haluk Ozemek

=== References Used ===
List any references used in project.

=== Appendix ===
You can list the references you used.

S13: Solar Panel Tracker

2013-05-22T04:46:44Z

Matt s13: /* Acknowledgement */

=== Grading Criteria ===
<font color="green">
* How well is Software & Hardware Design described?
* How well can this report be used to reproduce this project?
* Code Quality
* Overall Report Quality:
** Software Block Diagrams
** Hardware Block Diagrams
**: Schematic Quality
** Quality of technical challenges and solutions adopted.
</font>

== Project Title ==

== Abstract ==
The objective of this project is to create a solar panel that tracks the sun. The project will consist of two stepper motors that control the position of the solar panels by using the photo resistors to detect the sun location.

== Objectives & Introduction ==
Solar Panel Sun tracker uses the inputted voltage from photo resistors in order to adjust the position of the solar panel. The project uses and Analog to digital converter. The servo motors are controlled using a pulse; this controls the position of various angles. The servo uses in this project is a standard servo which can only position between 0 and 180 degrees.

The project required the following objectives to be accomplished:
* Read the voltage from photo resistors
* Control servo to move from 0 to 180 degrees
* Compute the location which has the greatest light intensity
* Determine algorithm to convert digital value into servo position

=== Team Members & Responsibilities ===
* Arturo Montoya
** Light Sensors (PWM driver) , Servo motor(ADC driver) , and Matrix (Spi driver)
* Matthew Balhorn
** FreeRTOS Software Design

== Schedule ==

<table class="wikitable">
<th>Week</th><th>Planned Tasks</th><th>Status</th>
<tr>
<td> <center>
1
</center> </td>
<td>
* Order parts

</td>
<td>
* Completed

</td>
</tr>

<tr>
<td> <center>
2
</center> </td>
<td>
* Look over datasheet(s)
* Test Servos
* Design System Logics
</td>
<td>
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
3
</center> </td>
<td>

* Test Light-sensing circuit
* Create System Schematics
* Code Servo Task
* Create Structure Design (Autodesk Inventor)

</td>
<td>
* Completed
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
4
</center> </td>
<td>

* Code Light-sensing Task
* Build/Machine Structure
* Code Glue Logics (Directional Logic)
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
5
</center> </td>
<td>
* Integrate system
* Test System
* Project report
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
6
</center> </td>
<td>
* Finalize project
* Finalize report
</td>
<td>
* Completed
* Completed
</td>
</tr>

</table>

== Parts List & Cost ==

<table class = "wikitable">
<th>Part</th> <th>Quuantity</th><th>Cost</th><th>Link</th>

<tr>
<td>LPC 1758 SJSU Dev Board</td>
<td align = "right"> 1 </td>
<td align = "right"> $60 </td>
<td align = "right"> </td>

<tr>
<td>180 Degree Servo </td>
<td align = "right"> 2 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>

<tr>
<td>Solar Panel</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>

<tr>
<td>LED Matrix</td>
<td align = "right"> 1 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Resistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $.25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Photoresistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $1.50 </td>
<td align = "right"> </td>

<tr>
<tr>
<td>Jumper wires(x50)</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Servo belt</td>
<td align = "right"> 2 </td>
<td align = "right"> $2 </td>
<td align = "right"> </td>
<tr>

</table>

== Design & Implementation ==
The design section can go over your hardware and software design. Organize this section using sub-sections that go over your design and implementation.

=== Hardware Design ===
=====Light Sensor=====
The Solar Panel Sun Tracker consists of the following hardware:
* Resistors
*Photo resistors
This section is responsible for interpreting the voltage of the photo resistors. The diagram below shows the circuit needed in order to get a voltage division of the two photo resistors. This voltage divider consists of two resistors on each side of the voltage divider output (ADC pin). When the top photo resistor has a greater resistance then the bottom resistor the voltage output will drop. When they both have the same resistance will hold in the middle.

[[File:CmpE146_S13_SPT_LightSensorConnection.png|center|frame]]
<div style="text-align: center;">'''Figure 1:''' LightSensorConnection </div>

=====Servo Motor=====
The servo section consists of the following hardware:
* Servo Motors / Servo Belts
* Solar Panel

This section is responsible for positioning the solar panels perpendicular to the light source. The panel is mounted to a frame that pivots according to the top servo. In order to perform a full scan the top servo motor was mounted on pivoting bases that is controlled by the second motor. The diagram below describes the complete setup in order to properly track the sun from sun rise to sun set.

[[File:CmpE146_S13_SPT_SJOneBoardSchematic.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>

=== Hardware Interface ===
[[File:CmpE146_S13_SPT_SjOneInterface.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>
<table class = "wikitable">
<th> SJSU Dev Board Pin</th> <th> Destination Pin</th><th>Description</th>

<tr>
<td> PWM1.4(p1.23) </td>
<td align = "right"> Servo Base Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> PWM1.5(p1.24) </td>
<td align = "right"> Servo Top Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> AD0.4(p1.30) </td>
<td align = "right"> Light Sensor Base</td>
<td align = "right"> Analog Input </td>
<tr>
<td> AD0.5(p1.31) </td>
<td align = "right"> Light Sensor Top </td>
<td align = "right"> Analog Input </td>
</table>

==== PWM ====
PWM, or Pulse Width Modulation, was used to control the two 180 degree positional servos. The servos required a 50 Hz (20 ms) duty cycle, and the duration of the high duty cycle (in milliseconds) would control the position to move to. Typically, the valid high duty cycles are between 1.0 and 2.0 milliseconds, with 1.0 representing '0 degrees', 1.5 representing '90 degrees' and 2.0 representing '180 degrees.' However, we found that the valid duty cycle range was larger, ranging from [INSERT FULL RANGE]. Knowing this, we expanded the range of the duty cycle and converted the range into a degree range with the <i>change_direction_with_Degree()</i> function. The servos were connected to a 5V power supply and were controlled by PWM1-4(P1.23)and PWM1-5(P1.24).

[[File:146ServoPWM.png|center|frame]]

==== ADC ====

=== Software Design ===
Show your software design. For example, if you are designing an MP3 Player, show the tasks that you are using, and what they are doing at a high level. Do not show the details of the code. For example, do not show exact code, but you may show psuedocode and fragments of code. Keep in mind that you are showing DESIGN of your software, not the inner workings of it.

[[File:CmpE146_S13_SPT_FreeRTOS.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

[[File:CmpE146_S13_SPT_SoftwareFlowchart.png|center|frame]]
<div style="text-align: center;">'''Figure :''' </div>

=== Implementation ===
This section includes implementation, but again, not the details, just the high level. For example, you can list the steps it takes to communicate over a sensor, or the steps needed to write a page of memory onto SPI Flash. You can include sub-sections for each of your component implementation.

[[File:CmpE146_S13_SPT_SjOneIO.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' Pins used for ADC and PWM </div>

[[File:CmpE146_S13_SPT_SJOneBoardPWMblockDiagram.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

==== Light sensor Logic ====
The <i>LightSensors.cpp</i> file contains the functions that the Light-sensing task calls. These functions are <i>getDirection()</i>, which reads the referenced Analog-to-Digital Converter pin (ADC-4 or ADC-5), and returns a value which is the new change in direction for the respective servo motor (Top or Base). The <i>getDirection()</i> function reads the ADC pin value and uses it to decide which direction the servo should move towards, and returns either a positive <i>degreeChange</i>, a negative <i>degreeChange</i>, or a 0 for no change. For this project, we decided to use 5 degrees as the degree change. The <i>getDirection()</i> function can be seen below:

[[File:146getDirectionBaseCodeSnippet.png|center|frame]]
==== Servo motor Logic ====
The <i>ServoMotors.cpp</i> file contains the <i>change_direction_withDegree()</i> function, which updates the PWM Match Register for the given PWM signal and the degree. This function takes the degree value, ensures that it is within range, then converts it into milliseconds so it can be written to the respective Match Register, using the <i>PWMUpdateMR()</i> function defined in the PWM driver file. We used the definitions <i>Max_degree</i>, <i>Servo_Width</i>, <i>Servo_Start</i>, and <i>freq_ms</i>, whose values may need to be changed if a different servo motor is used. <i>Max_degree</i> is the farthest degree available to the servo motor (180), <i>freq_ms</i> is the duty cycle (20 ms), and the <i>Servo_Width</i> and <i>Servo_Start</i> are derived from the duty cycle thresholds (in ms) mapped to the degree range (0 - 180) of the servo motor.

[[File:146changeDirectionCodeSnippet.png‎ |center|frame]]
==== Light-sensing Task ====
The Light-sensing task was very simple. To keep it this way, all of the 'heavy lifting' was completed in lower level code in the <i>LightSensors.cpp</i> file. Therefore, the only function that the Light-sensing task needs to use is the <i>getDirection()</i> function. However, there is a small amount of code to prevent the degree values from going out of range (0-180 degrees). The task reads the <i>getDirection()</i> values for both the top and base servo motors, which have valid values of negative five (-5), zero (0), or positive five (5). These values are added to the current positional value to obtain updated values to pass to the Servo Motor task through the Queue.

==== Servo Task ====
The Servo Task is even simpler. It takes the top and base positional values from the Queue, then passes the value to the servo motors using the <i>change_direction_withDegree()</i> function, which is defined in the <i>ServoMotors.cpp</i> file.

[[File:CmpE146_S13_SPT_ServoTask.png‎ |center|frame]]

== Testing & Technical Challenges ==
Describe the challenges of your project. What advise would you give yourself or someone else if your project can be started from scratch again?
Make a smooth transition to testing section and described what it took to test your project.

Include sub-sections that list out a problem and solution, such as:

=== Wifi Connection Issues ===
Many wifi connection issues were encountered. To solve this problem, a dedicated task was created to re-connect to wifi if the connection was ever lost.

== Conclusion ==
Conclude your project here. You can recap your testing and problems. You should address the "so what" part here to indicate what you ultimately learnt from this project. How has this project increased your knowledge?

=== Project Video ===
Upload a video of your project and post the link here.

=== Project Source Code ===
Send me your zipped source code and I will upload this to SourceForge and link it for you.

== References ==
=== Acknowledgement ===
Preet Kang

Dr. Haluk Ozemek

=== References Used ===
List any references used in project.

=== Appendix ===
You can list the references you used.

S13: Solar Panel Tracker

2013-05-22T04:46:19Z

Matt s13: /* Acknowledgement */

=== Grading Criteria ===
<font color="green">
* How well is Software & Hardware Design described?
* How well can this report be used to reproduce this project?
* Code Quality
* Overall Report Quality:
** Software Block Diagrams
** Hardware Block Diagrams
**: Schematic Quality
** Quality of technical challenges and solutions adopted.
</font>

== Project Title ==

== Abstract ==
The objective of this project is to create a solar panel that tracks the sun. The project will consist of two stepper motors that control the position of the solar panels by using the photo resistors to detect the sun location.

== Objectives & Introduction ==
Solar Panel Sun tracker uses the inputted voltage from photo resistors in order to adjust the position of the solar panel. The project uses and Analog to digital converter. The servo motors are controlled using a pulse; this controls the position of various angles. The servo uses in this project is a standard servo which can only position between 0 and 180 degrees.

The project required the following objectives to be accomplished:
* Read the voltage from photo resistors
* Control servo to move from 0 to 180 degrees
* Compute the location which has the greatest light intensity
* Determine algorithm to convert digital value into servo position

=== Team Members & Responsibilities ===
* Arturo Montoya
** Light Sensors (PWM driver) , Servo motor(ADC driver) , and Matrix (Spi driver)
* Matthew Balhorn
** FreeRTOS Software Design

== Schedule ==

<table class="wikitable">
<th>Week</th><th>Planned Tasks</th><th>Status</th>
<tr>
<td> <center>
1
</center> </td>
<td>
* Order parts

</td>
<td>
* Completed

</td>
</tr>

<tr>
<td> <center>
2
</center> </td>
<td>
* Look over datasheet(s)
* Test Servos
* Design System Logics
</td>
<td>
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
3
</center> </td>
<td>

* Test Light-sensing circuit
* Create System Schematics
* Code Servo Task
* Create Structure Design (Autodesk Inventor)

</td>
<td>
* Completed
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
4
</center> </td>
<td>

* Code Light-sensing Task
* Build/Machine Structure
* Code Glue Logics (Directional Logic)
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
5
</center> </td>
<td>
* Integrate system
* Test System
* Project report
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
6
</center> </td>
<td>
* Finalize project
* Finalize report
</td>
<td>
* Completed
* Completed
</td>
</tr>

</table>

== Parts List & Cost ==

<table class = "wikitable">
<th>Part</th> <th>Quuantity</th><th>Cost</th><th>Link</th>

<tr>
<td>LPC 1758 SJSU Dev Board</td>
<td align = "right"> 1 </td>
<td align = "right"> $60 </td>
<td align = "right"> </td>

<tr>
<td>180 Degree Servo </td>
<td align = "right"> 2 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>

<tr>
<td>Solar Panel</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>

<tr>
<td>LED Matrix</td>
<td align = "right"> 1 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Resistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $.25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Photoresistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $1.50 </td>
<td align = "right"> </td>

<tr>
<tr>
<td>Jumper wires(x50)</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Servo belt</td>
<td align = "right"> 2 </td>
<td align = "right"> $2 </td>
<td align = "right"> </td>
<tr>

</table>

== Design & Implementation ==
The design section can go over your hardware and software design. Organize this section using sub-sections that go over your design and implementation.

=== Hardware Design ===
=====Light Sensor=====
The Solar Panel Sun Tracker consists of the following hardware:
* Resistors
*Photo resistors
This section is responsible for interpreting the voltage of the photo resistors. The diagram below shows the circuit needed in order to get a voltage division of the two photo resistors. This voltage divider consists of two resistors on each side of the voltage divider output (ADC pin). When the top photo resistor has a greater resistance then the bottom resistor the voltage output will drop. When they both have the same resistance will hold in the middle.

[[File:CmpE146_S13_SPT_LightSensorConnection.png|center|frame]]
<div style="text-align: center;">'''Figure 1:''' LightSensorConnection </div>

=====Servo Motor=====
The servo section consists of the following hardware:
* Servo Motors / Servo Belts
* Solar Panel

This section is responsible for positioning the solar panels perpendicular to the light source. The panel is mounted to a frame that pivots according to the top servo. In order to perform a full scan the top servo motor was mounted on pivoting bases that is controlled by the second motor. The diagram below describes the complete setup in order to properly track the sun from sun rise to sun set.

[[File:CmpE146_S13_SPT_SJOneBoardSchematic.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>

=== Hardware Interface ===
[[File:CmpE146_S13_SPT_SjOneInterface.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>
<table class = "wikitable">
<th> SJSU Dev Board Pin</th> <th> Destination Pin</th><th>Description</th>

<tr>
<td> PWM1.4(p1.23) </td>
<td align = "right"> Servo Base Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> PWM1.5(p1.24) </td>
<td align = "right"> Servo Top Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> AD0.4(p1.30) </td>
<td align = "right"> Light Sensor Base</td>
<td align = "right"> Analog Input </td>
<tr>
<td> AD0.5(p1.31) </td>
<td align = "right"> Light Sensor Top </td>
<td align = "right"> Analog Input </td>
</table>

==== PWM ====
PWM, or Pulse Width Modulation, was used to control the two 180 degree positional servos. The servos required a 50 Hz (20 ms) duty cycle, and the duration of the high duty cycle (in milliseconds) would control the position to move to. Typically, the valid high duty cycles are between 1.0 and 2.0 milliseconds, with 1.0 representing '0 degrees', 1.5 representing '90 degrees' and 2.0 representing '180 degrees.' However, we found that the valid duty cycle range was larger, ranging from [INSERT FULL RANGE]. Knowing this, we expanded the range of the duty cycle and converted the range into a degree range with the <i>change_direction_with_Degree()</i> function. The servos were connected to a 5V power supply and were controlled by PWM1-4(P1.23)and PWM1-5(P1.24).

[[File:146ServoPWM.png|center|frame]]

==== ADC ====

=== Software Design ===
Show your software design. For example, if you are designing an MP3 Player, show the tasks that you are using, and what they are doing at a high level. Do not show the details of the code. For example, do not show exact code, but you may show psuedocode and fragments of code. Keep in mind that you are showing DESIGN of your software, not the inner workings of it.

[[File:CmpE146_S13_SPT_FreeRTOS.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

[[File:CmpE146_S13_SPT_SoftwareFlowchart.png|center|frame]]
<div style="text-align: center;">'''Figure :''' </div>

=== Implementation ===
This section includes implementation, but again, not the details, just the high level. For example, you can list the steps it takes to communicate over a sensor, or the steps needed to write a page of memory onto SPI Flash. You can include sub-sections for each of your component implementation.

[[File:CmpE146_S13_SPT_SjOneIO.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' Pins used for ADC and PWM </div>

[[File:CmpE146_S13_SPT_SJOneBoardPWMblockDiagram.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

==== Light sensor Logic ====
The <i>LightSensors.cpp</i> file contains the functions that the Light-sensing task calls. These functions are <i>getDirection()</i>, which reads the referenced Analog-to-Digital Converter pin (ADC-4 or ADC-5), and returns a value which is the new change in direction for the respective servo motor (Top or Base). The <i>getDirection()</i> function reads the ADC pin value and uses it to decide which direction the servo should move towards, and returns either a positive <i>degreeChange</i>, a negative <i>degreeChange</i>, or a 0 for no change. For this project, we decided to use 5 degrees as the degree change. The <i>getDirection()</i> function can be seen below:

[[File:146getDirectionBaseCodeSnippet.png|center|frame]]
==== Servo motor Logic ====
The <i>ServoMotors.cpp</i> file contains the <i>change_direction_withDegree()</i> function, which updates the PWM Match Register for the given PWM signal and the degree. This function takes the degree value, ensures that it is within range, then converts it into milliseconds so it can be written to the respective Match Register, using the <i>PWMUpdateMR()</i> function defined in the PWM driver file. We used the definitions <i>Max_degree</i>, <i>Servo_Width</i>, <i>Servo_Start</i>, and <i>freq_ms</i>, whose values may need to be changed if a different servo motor is used. <i>Max_degree</i> is the farthest degree available to the servo motor (180), <i>freq_ms</i> is the duty cycle (20 ms), and the <i>Servo_Width</i> and <i>Servo_Start</i> are derived from the duty cycle thresholds (in ms) mapped to the degree range (0 - 180) of the servo motor.

[[File:146changeDirectionCodeSnippet.png‎ |center|frame]]
==== Light-sensing Task ====
The Light-sensing task was very simple. To keep it this way, all of the 'heavy lifting' was completed in lower level code in the <i>LightSensors.cpp</i> file. Therefore, the only function that the Light-sensing task needs to use is the <i>getDirection()</i> function. However, there is a small amount of code to prevent the degree values from going out of range (0-180 degrees). The task reads the <i>getDirection()</i> values for both the top and base servo motors, which have valid values of negative five (-5), zero (0), or positive five (5). These values are added to the current positional value to obtain updated values to pass to the Servo Motor task through the Queue.

==== Servo Task ====
The Servo Task is even simpler. It takes the top and base positional values from the Queue, then passes the value to the servo motors using the <i>change_direction_withDegree()</i> function, which is defined in the <i>ServoMotors.cpp</i> file.

[[File:CmpE146_S13_SPT_ServoTask.png‎ |center|frame]]

== Testing & Technical Challenges ==
Describe the challenges of your project. What advise would you give yourself or someone else if your project can be started from scratch again?
Make a smooth transition to testing section and described what it took to test your project.

Include sub-sections that list out a problem and solution, such as:

=== Wifi Connection Issues ===
Many wifi connection issues were encountered. To solve this problem, a dedicated task was created to re-connect to wifi if the connection was ever lost.

== Conclusion ==
Conclude your project here. You can recap your testing and problems. You should address the "so what" part here to indicate what you ultimately learnt from this project. How has this project increased your knowledge?

=== Project Video ===
Upload a video of your project and post the link here.

=== Project Source Code ===
Send me your zipped source code and I will upload this to SourceForge and link it for you.

== References ==
=== Acknowledgement ===
Preet Kang
Dr. Haluk Ozemek

=== References Used ===
List any references used in project.

=== Appendix ===
You can list the references you used.

S13: Solar Panel Tracker

2013-05-22T03:53:11Z

Matt s13: /* Implementation */

=== Grading Criteria ===
<font color="green">
* How well is Software & Hardware Design described?
* How well can this report be used to reproduce this project?
* Code Quality
* Overall Report Quality:
** Software Block Diagrams
** Hardware Block Diagrams
**: Schematic Quality
** Quality of technical challenges and solutions adopted.
</font>

== Project Title ==

== Abstract ==
The objective of this project is to create a solar panel that tracks the sun. The project will consist of two stepper motors that control the position of the solar panels by using the photo resistors to detect the sun location.

== Objectives & Introduction ==
Solar Panel Sun tracker uses the inputted voltage from photo resistors in order to adjust the position of the solar panel. The project uses and Analog to digital converter. The servo motors are controlled using a pulse; this controls the position of various angles. The servo uses in this project is a standard servo which can only position between 0 and 180 degrees.

The project required the following objectives to be accomplished:
* Read the voltage from photo resistors
* Control servo to move from 0 to 180 degrees
* Compute the location which has the greatest light intensity
* Determine algorithm to convert digital value into servo position

=== Team Members & Responsibilities ===
* Arturo Montoya
** Light Sensors (PWM driver) , Servo motor(ADC driver) , and Matrix (Spi driver)
* Matthew Balhorn
** FreeRTOS Software Design

== Schedule ==

<table class="wikitable">
<th>Week</th><th>Planned Tasks</th><th>Status</th>
<tr>
<td> <center>
1
</center> </td>
<td>
* Order parts

</td>
<td>
* Completed

</td>
</tr>

<tr>
<td> <center>
2
</center> </td>
<td>
* Look over datasheet(s)
* Test Servos
* Design System Logics
</td>
<td>
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
3
</center> </td>
<td>

* Test Light-sensing circuit
* Create System Schematics
* Code Servo Task
* Create Structure Design (Autodesk Inventor)

</td>
<td>
* Completed
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
4
</center> </td>
<td>

* Code Light-sensing Task
* Build/Machine Structure
* Code Glue Logics (Directional Logic)
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
5
</center> </td>
<td>
* Integrate system
* Test System
* Project report
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
6
</center> </td>
<td>
* Finalize project
* Finalize report
</td>
<td>
* Completed
* Completed
</td>
</tr>

</table>

== Parts List & Cost ==

<table class = "wikitable">
<th>Part</th> <th>Quuantity</th><th>Cost</th><th>Link</th>

<tr>
<td>LPC 1758 SJSU Dev Board</td>
<td align = "right"> 1 </td>
<td align = "right"> $60 </td>
<td align = "right"> </td>

<tr>
<td>180 Degree Servo </td>
<td align = "right"> 2 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>

<tr>
<td>Solar Panel</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>

<tr>
<td>LED Matrix</td>
<td align = "right"> 1 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Resistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $.25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Photoresistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $1.50 </td>
<td align = "right"> </td>

<tr>
<tr>
<td>Jumper wires(x50)</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Servo belt</td>
<td align = "right"> 2 </td>
<td align = "right"> $2 </td>
<td align = "right"> </td>
<tr>

</table>

== Design & Implementation ==
The design section can go over your hardware and software design. Organize this section using sub-sections that go over your design and implementation.

=== Hardware Design ===
=====Light Sensor=====
The Solar Panel Sun Tracker consists of the following hardware:
* Resistors
*Photo resistors
This section is responsible for interpreting the voltage of the photo resistors. The diagram below shows the circuit needed in order to get a voltage division of the two photo resistors. This voltage divider consists of two resistors on each side of the voltage divider output (ADC pin). When the top photo resistor has a greater resistance then the bottom resistor the voltage output will drop. When they both have the same resistance will hold in the middle.

[[File:CmpE146_S13_SPT_LightSensorConnection.png|center|frame]]
<div style="text-align: center;">'''Figure 1:''' LightSensorConnection </div>

=====Servo Motor=====
The servo section consists of the following hardware:
* Servo Motors / Servo Belts
* Solar Panel

This section is responsible for positioning the solar panels perpendicular to the light source. The panel is mounted to a frame that pivots according to the top servo. In order to perform a full scan the top servo motor was mounted on pivoting bases that is controlled by the second motor. The diagram below describes the complete setup in order to properly track the sun from sun rise to sun set.

[[File:CmpE146_S13_SPT_SJOneBoardSchematic.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>

=== Hardware Interface ===
[[File:CmpE146_S13_SPT_SjOneInterface.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>
<table class = "wikitable">
<th> SJSU Dev Board Pin</th> <th> Destination Pin</th><th>Description</th>

<tr>
<td> PWM1.4(p1.23) </td>
<td align = "right"> Servo Base Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> PWM1.5(p1.24) </td>
<td align = "right"> Servo Top Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> AD0.4(p1.30) </td>
<td align = "right"> Light Sensor Base</td>
<td align = "right"> Analog Input </td>
<tr>
<td> AD0.5(p1.31) </td>
<td align = "right"> Light Sensor Top </td>
<td align = "right"> Analog Input </td>
</table>

==== PWM ====
PWM, or Pulse Width Modulation, was used to control the two 180 degree positional servos. The servos required a 50 Hz (20 ms) duty cycle, and the duration of the high duty cycle (in milliseconds) would control the position to move to. Typically, the valid high duty cycles are between 1.0 and 2.0 milliseconds, with 1.0 representing '0 degrees', 1.5 representing '90 degrees' and 2.0 representing '180 degrees.' However, we found that the valid duty cycle range was larger, ranging from [INSERT FULL RANGE]. Knowing this, we expanded the range of the duty cycle and converted the range into a degree range with the <i>change_direction_with_Degree()</i> function. The servos were connected to a 5V power supply and were controlled by PWM1-4(P1.23)and PWM1-5(P1.24).

[[File:146ServoPWM.png|center|frame]]

==== ADC ====

=== Software Design ===
Show your software design. For example, if you are designing an MP3 Player, show the tasks that you are using, and what they are doing at a high level. Do not show the details of the code. For example, do not show exact code, but you may show psuedocode and fragments of code. Keep in mind that you are showing DESIGN of your software, not the inner workings of it.

[[File:CmpE146_S13_SPT_FreeRTOS.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

[[File:CmpE146_S13_SPT_SoftwareFlowchart.png|center|frame]]
<div style="text-align: center;">'''Figure :''' </div>

=== Implementation ===
This section includes implementation, but again, not the details, just the high level. For example, you can list the steps it takes to communicate over a sensor, or the steps needed to write a page of memory onto SPI Flash. You can include sub-sections for each of your component implementation.

[[File:CmpE146_S13_SPT_SjOneIO.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' Pins used for ADC and PWM </div>

[[File:CmpE146_S13_SPT_SJOneBoardPWMblockDiagram.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

==== Light sensor Logic ====
The <i>LightSensors.cpp</i> file contains the functions that the Light-sensing task calls. These functions are <i>getDirection()</i>, which reads the referenced Analog-to-Digital Converter pin (ADC-4 or ADC-5), and returns a value which is the new change in direction for the respective servo motor (Top or Base). The <i>getDirection()</i> function reads the ADC pin value and uses it to decide which direction the servo should move towards, and returns either a positive <i>degreeChange</i>, a negative <i>degreeChange</i>, or a 0 for no change. For this project, we decided to use 5 degrees as the degree change. The <i>getDirection()</i> function can be seen below:

[[File:146getDirectionBaseCodeSnippet.png|center|frame]]
==== Servo motor Logic ====
The <i>ServoMotors.cpp</i> file contains the <i>change_direction_withDegree()</i> function, which updates the PWM Match Register for the given PWM signal and the degree. This function takes the degree value, ensures that it is within range, then converts it into milliseconds so it can be written to the respective Match Register, using the <i>PWMUpdateMR()</i> function defined in the PWM driver file. We used the definitions <i>Max_degree</i>, <i>Servo_Width</i>, <i>Servo_Start</i>, and <i>freq_ms</i>, whose values may need to be changed if a different servo motor is used. <i>Max_degree</i> is the farthest degree available to the servo motor (180), <i>freq_ms</i> is the duty cycle (20 ms), and the <i>Servo_Width</i> and <i>Servo_Start</i> are derived from the duty cycle thresholds (in ms) mapped to the degree range (0 - 180) of the servo motor.

[[File:146changeDirectionCodeSnippet.png‎ |center|frame]]
==== Light-sensing Task ====
The Light-sensing task was very simple. To keep it this way, all of the 'heavy lifting' was completed in lower level code in the <i>LightSensors.cpp</i> file. Therefore, the only function that the Light-sensing task needs to use is the <i>getDirection()</i> function. However, there is a small amount of code to prevent the degree values from going out of range (0-180 degrees). The task reads the <i>getDirection()</i> values for both the top and base servo motors, which have valid values of negative five (-5), zero (0), or positive five (5). These values are added to the current positional value to obtain updated values to pass to the Servo Motor task through the Queue.

==== Servo Task ====
The Servo Task is even simpler. It takes the top and base positional values from the Queue, then passes the value to the servo motors using the <i>change_direction_withDegree()</i> function, which is defined in the <i>ServoMotors.cpp</i> file.

[[File:CmpE146_S13_SPT_ServoTask.png‎ |center|frame]]

== Testing & Technical Challenges ==
Describe the challenges of your project. What advise would you give yourself or someone else if your project can be started from scratch again?
Make a smooth transition to testing section and described what it took to test your project.

Include sub-sections that list out a problem and solution, such as:

=== Wifi Connection Issues ===
Many wifi connection issues were encountered. To solve this problem, a dedicated task was created to re-connect to wifi if the connection was ever lost.

== Conclusion ==
Conclude your project here. You can recap your testing and problems. You should address the "so what" part here to indicate what you ultimately learnt from this project. How has this project increased your knowledge?

=== Project Video ===
Upload a video of your project and post the link here.

=== Project Source Code ===
Send me your zipped source code and I will upload this to SourceForge and link it for you.

== References ==
=== Acknowledgement ===
Any acknowledgement that you may wish to provide can be included here.

=== References Used ===
List any references used in project.

=== Appendix ===
You can list the references you used.

File:CmpE146 S13 SPT ServoTask.png

2013-05-22T03:50:27Z

Matt s13:

S13: Solar Panel Tracker

2013-05-22T03:42:48Z

Matt s13: /* Implementation */

=== Grading Criteria ===
<font color="green">
* How well is Software & Hardware Design described?
* How well can this report be used to reproduce this project?
* Code Quality
* Overall Report Quality:
** Software Block Diagrams
** Hardware Block Diagrams
**: Schematic Quality
** Quality of technical challenges and solutions adopted.
</font>

== Project Title ==

== Abstract ==
The objective of this project is to create a solar panel that tracks the sun. The project will consist of two stepper motors that control the position of the solar panels by using the photo resistors to detect the sun location.

== Objectives & Introduction ==
Solar Panel Sun tracker uses the inputted voltage from photo resistors in order to adjust the position of the solar panel. The project uses and Analog to digital converter. The servo motors are controlled using a pulse; this controls the position of various angles. The servo uses in this project is a standard servo which can only position between 0 and 180 degrees.

The project required the following objectives to be accomplished:
* Read the voltage from photo resistors
* Control servo to move from 0 to 180 degrees
* Compute the location which has the greatest light intensity
* Determine algorithm to convert digital value into servo position

=== Team Members & Responsibilities ===
* Arturo Montoya
** Light Sensors (PWM driver) , Servo motor(ADC driver) , and Matrix (Spi driver)
* Matthew Balhorn
** FreeRTOS Software Design

== Schedule ==

<table class="wikitable">
<th>Week</th><th>Planned Tasks</th><th>Status</th>
<tr>
<td> <center>
1
</center> </td>
<td>
* Order parts

</td>
<td>
* Completed

</td>
</tr>

<tr>
<td> <center>
2
</center> </td>
<td>
* Look over datasheet(s)
* Test Servos
* Design System Logics
</td>
<td>
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
3
</center> </td>
<td>

* Test Light-sensing circuit
* Create System Schematics
* Code Servo Task
* Create Structure Design (Autodesk Inventor)

</td>
<td>
* Completed
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
4
</center> </td>
<td>

* Code Light-sensing Task
* Build/Machine Structure
* Code Glue Logics (Directional Logic)
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
5
</center> </td>
<td>
* Integrate system
* Test System
* Project report
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
6
</center> </td>
<td>
* Finalize project
* Finalize report
</td>
<td>
* Completed
* Completed
</td>
</tr>

</table>

== Parts List & Cost ==

<table class = "wikitable">
<th>Part</th> <th>Quuantity</th><th>Cost</th><th>Link</th>

<tr>
<td>LPC 1758 SJSU Dev Board</td>
<td align = "right"> 1 </td>
<td align = "right"> $60 </td>
<td align = "right"> </td>

<tr>
<td>180 Degree Servo </td>
<td align = "right"> 2 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>

<tr>
<td>Solar Panel</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>

<tr>
<td>LED Matrix</td>
<td align = "right"> 1 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Resistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $.25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Photoresistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $1.50 </td>
<td align = "right"> </td>

<tr>
<tr>
<td>Jumper wires(x50)</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Servo belt</td>
<td align = "right"> 2 </td>
<td align = "right"> $2 </td>
<td align = "right"> </td>
<tr>

</table>

== Design & Implementation ==
The design section can go over your hardware and software design. Organize this section using sub-sections that go over your design and implementation.

=== Hardware Design ===
=====Light Sensor=====
The Solar Panel Sun Tracker consists of the following hardware:
* Resistors
*Photo resistors
This section is responsible for interpreting the voltage of the photo resistors. The diagram below shows the circuit needed in order to get a voltage division of the two photo resistors. This voltage divider consists of two resistors on each side of the voltage divider output (ADC pin). When the top photo resistor has a greater resistance then the bottom resistor the voltage output will drop. When they both have the same resistance will hold in the middle.

[[File:CmpE146_S13_SPT_LightSensorConnection.png|center|frame]]
<div style="text-align: center;">'''Figure 1:''' LightSensorConnection </div>

=====Servo Motor=====
The servo section consists of the following hardware:
* Servo Motors / Servo Belts
* Solar Panel

This section is responsible for positioning the solar panels perpendicular to the light source. The panel is mounted to a frame that pivots according to the top servo. In order to perform a full scan the top servo motor was mounted on pivoting bases that is controlled by the second motor. The diagram below describes the complete setup in order to properly track the sun from sun rise to sun set.

[[File:CmpE146_S13_SPT_SJOneBoardSchematic.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>

=== Hardware Interface ===
[[File:CmpE146_S13_SPT_SjOneInterface.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>
<table class = "wikitable">
<th> SJSU Dev Board Pin</th> <th> Destination Pin</th><th>Description</th>

<tr>
<td> PWM1.4(p1.23) </td>
<td align = "right"> Servo Base Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> PWM1.5(p1.24) </td>
<td align = "right"> Servo Top Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> AD0.4(p1.30) </td>
<td align = "right"> Light Sensor Base</td>
<td align = "right"> Analog Input </td>
<tr>
<td> AD0.5(p1.31) </td>
<td align = "right"> Light Sensor Top </td>
<td align = "right"> Analog Input </td>
</table>

==== PWM ====
PWM, or Pulse Width Modulation, was used to control the two 180 degree positional servos. The servos required a 50 Hz (20 ms) duty cycle, and the duration of the high duty cycle (in milliseconds) would control the position to move to. Typically, the valid high duty cycles are between 1.0 and 2.0 milliseconds, with 1.0 representing '0 degrees', 1.5 representing '90 degrees' and 2.0 representing '180 degrees.' However, we found that the valid duty cycle range was larger, ranging from [INSERT FULL RANGE]. Knowing this, we expanded the range of the duty cycle and converted the range into a degree range with the <i>change_direction_with_Degree()</i> function. The servos were connected to a 5V power supply and were controlled by PWM1-4(P1.23)and PWM1-5(P1.24).

[[File:146ServoPWM.png|center|frame]]

==== ADC ====

=== Software Design ===
Show your software design. For example, if you are designing an MP3 Player, show the tasks that you are using, and what they are doing at a high level. Do not show the details of the code. For example, do not show exact code, but you may show psuedocode and fragments of code. Keep in mind that you are showing DESIGN of your software, not the inner workings of it.

[[File:CmpE146_S13_SPT_FreeRTOS.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

[[File:CmpE146_S13_SPT_SoftwareFlowchart.png|center|frame]]
<div style="text-align: center;">'''Figure :''' </div>

=== Implementation ===
This section includes implementation, but again, not the details, just the high level. For example, you can list the steps it takes to communicate over a sensor, or the steps needed to write a page of memory onto SPI Flash. You can include sub-sections for each of your component implementation.

[[File:CmpE146_S13_SPT_SjOneIO.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' Pins used for ADC and PWM </div>

[[File:CmpE146_S13_SPT_SJOneBoardPWMblockDiagram.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

==== Light sensor Logic ====
The <i>LightSensors.cpp</i> file contains the functions that the Light-sensing task calls. These functions are <i>getDirection()</i>, which reads the referenced Analog-to-Digital Converter pin (ADC-4 or ADC-5), and returns a value which is the new change in direction for the respective servo motor (Top or Base). The <i>getDirection()</i> function reads the ADC pin value and uses it to decide which direction the servo should move towards, and returns either a positive <i>degreeChange</i>, a negative <i>degreeChange</i>, or a 0 for no change. For this project, we decided to use 5 degrees as the degree change. The <i>getDirection()</i> function can be seen below:

[[File:146getDirectionBaseCodeSnippet.png|center|frame]]
==== Servo motor Logic ====
The <i>ServoMotors.cpp</i> file contains the <i>change_direction_withDegree()</i> function, which updates the PWM Match Register for the given PWM signal and the degree. This function takes the degree value, ensures that it is within range, then converts it into milliseconds so it can be written to the respective Match Register, using the <i>PWMUpdateMR()</i> function defined in the PWM driver file. We used the definitions <i>Max_degree</i>, <i>Servo_Width</i>, <i>Servo_Start</i>, and <i>freq_ms</i>, whose values may need to be changed if a different servo motor is used. <i>Max_degree</i> is the farthest degree available to the servo motor (180), <i>freq_ms</i> is the duty cycle (20 ms), and the <i>Servo_Width</i> and <i>Servo_Start</i> are derived from the duty cycle thresholds (in ms) mapped to the degree range (0 - 180) of the servo motor.

[[File:146changeDirectionCodeSnippet.png‎ |center|frame]]
==== Light-sensing Task ====
The Light-sensing task was very simple. To keep it this way, all of the 'heavy lifting' was completed in lower level code in the <i>LightSensors.cpp</i> file. Therefore, the only function that the Light-sensing task needs to use is the <i>getDirection()</i> function. However, there is a small amount of code to prevent the degree values from going out of range (0-180 degrees). The task reads the <i>getDirection()</i> values for both the top and base servo motors, which have valid values of negative five (-5), zero (0), or positive five (5). These values are added to the current positional value to obtain updated values to pass to the Servo Motor task through the Queue.

==== Servo Task ====
The Servo Task is even simpler. It takes the top and base positional values from the Queue, then passes the value to the servo motors using the <i>change_direction_withDegree()</i> function, which is defined in the <i>ServoMotors.cpp</i> file.

== Testing & Technical Challenges ==
Describe the challenges of your project. What advise would you give yourself or someone else if your project can be started from scratch again?
Make a smooth transition to testing section and described what it took to test your project.

Include sub-sections that list out a problem and solution, such as:

=== Wifi Connection Issues ===
Many wifi connection issues were encountered. To solve this problem, a dedicated task was created to re-connect to wifi if the connection was ever lost.

== Conclusion ==
Conclude your project here. You can recap your testing and problems. You should address the "so what" part here to indicate what you ultimately learnt from this project. How has this project increased your knowledge?

=== Project Video ===
Upload a video of your project and post the link here.

=== Project Source Code ===
Send me your zipped source code and I will upload this to SourceForge and link it for you.

== References ==
=== Acknowledgement ===
Any acknowledgement that you may wish to provide can be included here.

=== References Used ===
List any references used in project.

=== Appendix ===
You can list the references you used.

S13: Solar Panel Tracker

2013-05-22T03:39:21Z

Matt s13: /* Light-sensing Task */

=== Grading Criteria ===
<font color="green">
* How well is Software & Hardware Design described?
* How well can this report be used to reproduce this project?
* Code Quality
* Overall Report Quality:
** Software Block Diagrams
** Hardware Block Diagrams
**: Schematic Quality
** Quality of technical challenges and solutions adopted.
</font>

== Project Title ==

== Abstract ==
The objective of this project is to create a solar panel that tracks the sun. The project will consist of two stepper motors that control the position of the solar panels by using the photo resistors to detect the sun location.

== Objectives & Introduction ==
Solar Panel Sun tracker uses the inputted voltage from photo resistors in order to adjust the position of the solar panel. The project uses and Analog to digital converter. The servo motors are controlled using a pulse; this controls the position of various angles. The servo uses in this project is a standard servo which can only position between 0 and 180 degrees.

The project required the following objectives to be accomplished:
* Read the voltage from photo resistors
* Control servo to move from 0 to 180 degrees
* Compute the location which has the greatest light intensity
* Determine algorithm to convert digital value into servo position

=== Team Members & Responsibilities ===
* Arturo Montoya
** Light Sensors (PWM driver) , Servo motor(ADC driver) , and Matrix (Spi driver)
* Matthew Balhorn
** FreeRTOS Software Design

== Schedule ==

<table class="wikitable">
<th>Week</th><th>Planned Tasks</th><th>Status</th>
<tr>
<td> <center>
1
</center> </td>
<td>
* Order parts

</td>
<td>
* Completed

</td>
</tr>

<tr>
<td> <center>
2
</center> </td>
<td>
* Look over datasheet(s)
* Test Servos
* Design System Logics
</td>
<td>
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
3
</center> </td>
<td>

* Test Light-sensing circuit
* Create System Schematics
* Code Servo Task
* Create Structure Design (Autodesk Inventor)

</td>
<td>
* Completed
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
4
</center> </td>
<td>

* Code Light-sensing Task
* Build/Machine Structure
* Code Glue Logics (Directional Logic)
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
5
</center> </td>
<td>
* Integrate system
* Test System
* Project report
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
6
</center> </td>
<td>
* Finalize project
* Finalize report
</td>
<td>
* Completed
* Completed
</td>
</tr>

</table>

== Parts List & Cost ==

<table class = "wikitable">
<th>Part</th> <th>Quuantity</th><th>Cost</th><th>Link</th>

<tr>
<td>LPC 1758 SJSU Dev Board</td>
<td align = "right"> 1 </td>
<td align = "right"> $60 </td>
<td align = "right"> </td>

<tr>
<td>180 Degree Servo </td>
<td align = "right"> 2 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>

<tr>
<td>Solar Panel</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>

<tr>
<td>LED Matrix</td>
<td align = "right"> 1 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Resistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $.25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Photoresistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $1.50 </td>
<td align = "right"> </td>

<tr>
<tr>
<td>Jumper wires(x50)</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Servo belt</td>
<td align = "right"> 2 </td>
<td align = "right"> $2 </td>
<td align = "right"> </td>
<tr>

</table>

== Design & Implementation ==
The design section can go over your hardware and software design. Organize this section using sub-sections that go over your design and implementation.

=== Hardware Design ===
=====Light Sensor=====
The Solar Panel Sun Tracker consists of the following hardware:
* Resistors
*Photo resistors
This section is responsible for interpreting the voltage of the photo resistors. The diagram below shows the circuit needed in order to get a voltage division of the two photo resistors. This voltage divider consists of two resistors on each side of the voltage divider output (ADC pin). When the top photo resistor has a greater resistance then the bottom resistor the voltage output will drop. When they both have the same resistance will hold in the middle.

[[File:CmpE146_S13_SPT_LightSensorConnection.png|center|frame]]
<div style="text-align: center;">'''Figure 1:''' LightSensorConnection </div>

=====Servo Motor=====
The servo section consists of the following hardware:
* Servo Motors / Servo Belts
* Solar Panel

This section is responsible for positioning the solar panels perpendicular to the light source. The panel is mounted to a frame that pivots according to the top servo. In order to perform a full scan the top servo motor was mounted on pivoting bases that is controlled by the second motor. The diagram below describes the complete setup in order to properly track the sun from sun rise to sun set.

[[File:CmpE146_S13_SPT_SJOneBoardSchematic.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>

=== Hardware Interface ===
[[File:CmpE146_S13_SPT_SjOneInterface.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>
<table class = "wikitable">
<th> SJSU Dev Board Pin</th> <th> Destination Pin</th><th>Description</th>

<tr>
<td> PWM1.4(p1.23) </td>
<td align = "right"> Servo Base Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> PWM1.5(p1.24) </td>
<td align = "right"> Servo Top Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> AD0.4(p1.30) </td>
<td align = "right"> Light Sensor Base</td>
<td align = "right"> Analog Input </td>
<tr>
<td> AD0.5(p1.31) </td>
<td align = "right"> Light Sensor Top </td>
<td align = "right"> Analog Input </td>
</table>

==== PWM ====
PWM, or Pulse Width Modulation, was used to control the two 180 degree positional servos. The servos required a 50 Hz (20 ms) duty cycle, and the duration of the high duty cycle (in milliseconds) would control the position to move to. Typically, the valid high duty cycles are between 1.0 and 2.0 milliseconds, with 1.0 representing '0 degrees', 1.5 representing '90 degrees' and 2.0 representing '180 degrees.' However, we found that the valid duty cycle range was larger, ranging from [INSERT FULL RANGE]. Knowing this, we expanded the range of the duty cycle and converted the range into a degree range with the <i>change_direction_with_Degree()</i> function. The servos were connected to a 5V power supply and were controlled by PWM1-4(P1.23)and PWM1-5(P1.24).

[[File:146ServoPWM.png|center|frame]]

==== ADC ====

=== Software Design ===
Show your software design. For example, if you are designing an MP3 Player, show the tasks that you are using, and what they are doing at a high level. Do not show the details of the code. For example, do not show exact code, but you may show psuedocode and fragments of code. Keep in mind that you are showing DESIGN of your software, not the inner workings of it.

[[File:CmpE146_S13_SPT_FreeRTOS.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

[[File:CmpE146_S13_SPT_SoftwareFlowchart.png|center|frame]]
<div style="text-align: center;">'''Figure :''' </div>

=== Implementation ===
This section includes implementation, but again, not the details, just the high level. For example, you can list the steps it takes to communicate over a sensor, or the steps needed to write a page of memory onto SPI Flash. You can include sub-sections for each of your component implementation.

[[File:CmpE146_S13_SPT_SjOneIO.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

[[File:CmpE146_S13_SPT_SJOneBoardPWMblockDiagram.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

==== Light sensor Logic ====
The <i>LightSensors.cpp</i> file contains the functions that the Light-sensing task calls. These functions are <i>getDirection()</i>, which reads the referenced Analog-to-Digital Converter pin (ADC-4 or ADC-5), and returns a value which is the new change in direction for the respective servo motor (Top or Base). The <i>getDirection()</i> function reads the ADC pin value and uses it to decide which direction the servo should move towards, and returns either a positive <i>degreeChange</i>, a negative <i>degreeChange</i>, or a 0 for no change. For this project, we decided to use 5 degrees as the degree change. The <i>getDirection()</i> function can be seen below:

[[File:146getDirectionBaseCodeSnippet.png|center|frame]]
==== Servo motor Logic ====
The <i>ServoMotors.cpp</i> file contains the <i>change_direction_withDegree()</i> function, which updates the PWM Match Register for the given PWM signal and the degree. This function takes the degree value, ensures that it is within range, then converts it into milliseconds so it can be written to the respective Match Register, using the <i>PWMUpdateMR()</i> function defined in the PWM driver file. We used the definitions <i>Max_degree</i>, <i>Servo_Width</i>, <i>Servo_Start</i>, and <i>freq_ms</i>, whose values may need to be changed if a different servo motor is used. <i>Max_degree</i> is the farthest degree available to the servo motor (180), <i>freq_ms</i> is the duty cycle (20 ms), and the <i>Servo_Width</i> and <i>Servo_Start</i> are derived from the duty cycle thresholds (in ms) mapped to the degree range (0 - 180) of the servo motor.

[[File:146changeDirectionCodeSnippet.png‎ |center|frame]]
==== Light-sensing Task ====
The Light-sensing task was very simple. To keep it this way, all of the 'heavy lifting' was completed in lower level code in the <i>LightSensors.cpp</i> file. Therefore, the only function that the Light-sensing task needs to use is the <i>getDirection()</i> function. However, there is a small amount of code to prevent the degree values from going out of range (0-180 degrees). The task reads the <i>getDirection()</i> values for both the top and base servo motors, which have valid values of negative five (-5), zero (0), or positive five (5). These values are added to the current positional value to obtain updated values to pass to the Servo Motor task through the Queue.

==== Servo Task ====
The Servo Task is even simpler. It takes the top and base positional values from the Queue, then passes the value to the servo motors using the <i>change_direction_withDegree()</i> function, which is defined in the <i>ServoMotors.cpp</i> file.

== Testing & Technical Challenges ==
Describe the challenges of your project. What advise would you give yourself or someone else if your project can be started from scratch again?
Make a smooth transition to testing section and described what it took to test your project.

Include sub-sections that list out a problem and solution, such as:

=== Wifi Connection Issues ===
Many wifi connection issues were encountered. To solve this problem, a dedicated task was created to re-connect to wifi if the connection was ever lost.

== Conclusion ==
Conclude your project here. You can recap your testing and problems. You should address the "so what" part here to indicate what you ultimately learnt from this project. How has this project increased your knowledge?

=== Project Video ===
Upload a video of your project and post the link here.

=== Project Source Code ===
Send me your zipped source code and I will upload this to SourceForge and link it for you.

== References ==
=== Acknowledgement ===
Any acknowledgement that you may wish to provide can be included here.

=== References Used ===
List any references used in project.

=== Appendix ===
You can list the references you used.

S13: Solar Panel Tracker

2013-05-22T00:58:40Z

Matt s13: /* Software Design */

=== Grading Criteria ===
<font color="green">
* How well is Software & Hardware Design described?
* How well can this report be used to reproduce this project?
* Code Quality
* Overall Report Quality:
** Software Block Diagrams
** Hardware Block Diagrams
**: Schematic Quality
** Quality of technical challenges and solutions adopted.
</font>

== Project Title ==

== Abstract ==
The objective of this project is to create a solar panel that tracks the sun. The project will consist of two stepper motors that control the position of the solar panels by using the photo resistors to detect the sun location.

== Objectives & Introduction ==
Solar Panel Sun tracker uses the inputted voltage from photo resistors in order to adjust the position of the solar panel. The project uses and Analog to digital converter. The servo motors are controlled using a pulse; this controls the position of various angles. The servo uses in this project is a standard servo which can only position between 0 and 180 degrees.

The project required the following objectives to be accomplished:
* Read the voltage from photo resistors
* Control servo to move from 0 to 180 degrees
* Compute the location which has the greatest light intensity
* Determine algorithm to convert digital value into servo position

=== Team Members & Responsibilities ===
* Arturo Montoya
** Light Sensors (PWM driver) , Servo motor(ADC driver) , and Matrix (Spi driver)
* Matthew Balhorn
** FreeRTOS Software Design

== Schedule ==

<table class="wikitable">
<th>Week</th><th>Planned Tasks</th><th>Status</th>
<tr>
<td> <center>
1
</center> </td>
<td>
* Order parts

</td>
<td>
* Completed

</td>
</tr>

<tr>
<td> <center>
2
</center> </td>
<td>
* Look over datasheet(s)
* Test Servos
* Design System Logics
</td>
<td>
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
3
</center> </td>
<td>

* Test Light-sensing circuit
* Create System Schematics
* Code Servo Task
* Create Structure Design (Autodesk Inventor)

</td>
<td>
* Completed
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
4
</center> </td>
<td>

* Code Light-sensing Task
* Build/Machine Structure
* Code Glue Logics (Directional Logic)
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
5
</center> </td>
<td>
* Integrate system
* Test System
* Project report
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
6
</center> </td>
<td>
* Finalize project
* Finalize report
</td>
<td>
* Completed
* Completed
</td>
</tr>

</table>

== Parts List & Cost ==

<table class = "wikitable">
<th>Part</th> <th>Quuantity</th><th>Cost</th><th>Link</th>

<tr>
<td>LPC 1758 SJSU Dev Board</td>
<td align = "right"> 1 </td>
<td align = "right"> $60 </td>
<td align = "right"> </td>

<tr>
<td>180 Degree Servo </td>
<td align = "right"> 2 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>

<tr>
<td>Solar Panel</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>

<tr>
<td>LED Matrix</td>
<td align = "right"> 1 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Resistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $.25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Photoresistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $1.50 </td>
<td align = "right"> </td>

<tr>
<tr>
<td>Jumper wires(x50)</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Servo belt</td>
<td align = "right"> 2 </td>
<td align = "right"> $2 </td>
<td align = "right"> </td>
<tr>

</table>

== Design & Implementation ==
The design section can go over your hardware and software design. Organize this section using sub-sections that go over your design and implementation.

=== Hardware Design ===
=====Light Sensor=====
The Solar Panel Sun Tracker consists of the following hardware:
* Resistors
*Photo resistors
This section is responsible for interpreting the voltage of the photo resistors. The diagram below shows the circuit needed in order to get a voltage division of the two photo resistors. This voltage divider consists of two resistors on each side of the voltage divider output (ADC pin). When the top photo resistor has a greater resistance then the bottom resistor the voltage output will drop. When they both have the same resistance will hold in the middle.

[[File:CmpE146_S13_SPT_LightSensorConnection.png|center|frame]]
<div style="text-align: center;">'''Figure 1:''' LightSensorConnection </div>

=====Servo Motor=====
The servo section consists of the following hardware:
* Servo Motors / Servo Belts
* Solar Panel

This section is responsible for positioning the solar panels perpendicular to the light source. The panel is mounted to a frame that pivots according to the top servo. In order to perform a full scan the top servo motor was mounted on pivoting bases that is controlled by the second motor. The diagram below describes the complete setup in order to properly track the sun from sun rise to sun set.

[[File:CmpE146_S13_SPT_SJOneBoardSchematic.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>

=== Hardware Interface ===
[[File:CmpE146_S13_SPT_SjOneInterface.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>
<table class = "wikitable">
<th> SJSU Dev Board Pin</th> <th> Destination Pin</th><th>Description</th>

<tr>
<td> PWM1.4(p1.23) </td>
<td align = "right"> Servo Base Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> PWM1.5(p1.24) </td>
<td align = "right"> Servo Top Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> AD0.4(p1.30) </td>
<td align = "right"> Light Sensor Base</td>
<td align = "right"> Analog Input </td>
<tr>
<td> AD0.5(p1.31) </td>
<td align = "right"> Light Sensor Top </td>
<td align = "right"> Analog Input </td>
</table>

==== PWM ====
PWM, or Pulse Width Modulation, was used to control the two 180 degree positional servos. The servos required a 50 Hz (20 ms) duty cycle, and the duration of the high duty cycle (in milliseconds) would control the position to move to. Typically, the valid high duty cycles are between 1.0 and 2.0 milliseconds, with 1.0 representing '0 degrees', 1.5 representing '90 degrees' and 2.0 representing '180 degrees.' However, we found that the valid duty cycle range was larger, ranging from [INSERT FULL RANGE]. Knowing this, we expanded the range of the duty cycle and converted the range into a degree range with the <i>change_direction_with_Degree()</i> function. The servos were connected to a 5V power supply and were controlled by PWM1-4(P1.23)and PWM1-5(P1.24).

[[File:146ServoPWM.png|center|frame]]

==== ADC ====

=== Software Design ===
Show your software design. For example, if you are designing an MP3 Player, show the tasks that you are using, and what they are doing at a high level. Do not show the details of the code. For example, do not show exact code, but you may show psuedocode and fragments of code. Keep in mind that you are showing DESIGN of your software, not the inner workings of it.

[[File:CmpE146_S13_SPT_FreeRTOS.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

[[File:CmpE146_S13_SPT_SoftwareFlowchart.png|center|frame]]
<div style="text-align: center;">'''Figure :''' </div>

=== Implementation ===
This section includes implementation, but again, not the details, just the high level. For example, you can list the steps it takes to communicate over a sensor, or the steps needed to write a page of memory onto SPI Flash. You can include sub-sections for each of your component implementation.

[[File:CmpE146_S13_SPT_SjOneIO.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

[[File:CmpE146_S13_SPT_SJOneBoardPWMblockDiagram.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

==== Light sensor Logic ====
The <i>LightSensors.cpp</i> file contains the functions that the Light-sensing task calls. These functions are <i>getDirection()</i>, which reads the referenced Analog-to-Digital Converter pin (ADC-4 or ADC-5), and returns a value which is the new change in direction for the respective servo motor (Top or Base). The <i>getDirection()</i> function reads the ADC pin value and uses it to decide which direction the servo should move towards, and returns either a positive <i>degreeChange</i>, a negative <i>degreeChange</i>, or a 0 for no change. For this project, we decided to use 5 degrees as the degree change. The <i>getDirection()</i> function can be seen below:

[[File:146getDirectionBaseCodeSnippet.png|center|frame]]
==== Servo motor Logic ====
The <i>ServoMotors.cpp</i> file contains the <i>change_direction_withDegree()</i> function, which updates the PWM Match Register for the given PWM signal and the degree. This function takes the degree value, ensures that it is within range, then converts it into milliseconds so it can be written to the respective Match Register, using the <i>PWMUpdateMR()</i> function defined in the PWM driver file. We used the definitions <i>Max_degree</i>, <i>Servo_Width</i>, <i>Servo_Start</i>, and <i>freq_ms</i>, whose values may need to be changed if a different servo motor is used. <i>Max_degree</i> is the farthest degree available to the servo motor (180), <i>freq_ms</i> is the duty cycle (20 ms), and the <i>Servo_Width</i> and <i>Servo_Start</i> are derived from the duty cycle thresholds (in ms) mapped to the degree range (0 - 180) of the servo motor.

[[File:146changeDirectionCodeSnippet.png‎ |center|frame]]
==== Light-sensing Task ====
The Light-sensing task was very simple. To keep it this way, all of the 'heavy lifting' was completed in lower level code in the <i>LightSensors.cpp</i> file. Therefore, the only functions that the Light-sensing task needs to deal with is the <i>getDirectionTop()</i> and <i>getDirectionBase()</i> functions. However, there is a small amount of code to prevent the degree values from going out of range (0-180 degrees). The task reads the <i>getDirection()</i> values for both the top and base servo motors, which have valid values of negative five (-5), zero (0), or positive five (5). These values are added to the current positional value to obtain updated values to pass to the Servo Motor task through the Queue.

==== Servo Task ====
The Servo Task is even simpler. It takes the top and base positional values from the Queue, then passes the value to the servo motors using the <i>change_direction_withDegree()</i> function, which is defined in the <i>ServoMotors.cpp</i> file.

== Testing & Technical Challenges ==
Describe the challenges of your project. What advise would you give yourself or someone else if your project can be started from scratch again?
Make a smooth transition to testing section and described what it took to test your project.

Include sub-sections that list out a problem and solution, such as:

=== Wifi Connection Issues ===
Many wifi connection issues were encountered. To solve this problem, a dedicated task was created to re-connect to wifi if the connection was ever lost.

== Conclusion ==
Conclude your project here. You can recap your testing and problems. You should address the "so what" part here to indicate what you ultimately learnt from this project. How has this project increased your knowledge?

=== Project Video ===
Upload a video of your project and post the link here.

=== Project Source Code ===
Send me your zipped source code and I will upload this to SourceForge and link it for you.

== References ==
=== Acknowledgement ===
Any acknowledgement that you may wish to provide can be included here.

=== References Used ===
List any references used in project.

=== Appendix ===
You can list the references you used.

File:CmpE146 S13 SPT SoftwareFlowchart.png

2013-05-22T00:57:01Z

Matt s13:

File:146SoftwareFlowchart.png

2013-05-22T00:51:52Z

Matt s13:

S13: Solar Panel Tracker

2013-05-22T00:24:54Z

Matt s13: /* Implementation */

=== Grading Criteria ===
<font color="green">
* How well is Software & Hardware Design described?
* How well can this report be used to reproduce this project?
* Code Quality
* Overall Report Quality:
** Software Block Diagrams
** Hardware Block Diagrams
**: Schematic Quality
** Quality of technical challenges and solutions adopted.
</font>

== Project Title ==

== Abstract ==
The objective of this project is to create a solar panel that tracks the sun. The project will consist of two stepper motors that control the position of the solar panels by using the photo resistors to detect the sun location.

== Objectives & Introduction ==
Solar Panel Sun tracker uses the inputted voltage from photo resistors in order to adjust the position of the solar panel. The project uses and Analog to digital converter. The servo motors are controlled using a pulse; this controls the position of various angles. The servo uses in this project is a standard servo which can only position between 0 and 180 degrees.

The project required the following objectives to be accomplished:
* Read the voltage from photo resistors
* Control servo to move from 0 to 180 degrees
* Compute the location which has the greatest light intensity
* Determine algorithm to convert digital value into servo position

=== Team Members & Responsibilities ===
* Arturo Montoya
** Light Sensors (PWM driver) , Servo motor(ADC driver) , and Matrix (Spi driver)
* Matthew Balhorn
** FreeRTOS Software Design

== Schedule ==

<table class="wikitable">
<th>Week</th><th>Planned Tasks</th><th>Status</th>
<tr>
<td> <center>
1
</center> </td>
<td>
* Order parts

</td>
<td>
* Completed

</td>
</tr>

<tr>
<td> <center>
2
</center> </td>
<td>
* Look over datasheet(s)
* Test Servos
* Design System Logics
</td>
<td>
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
3
</center> </td>
<td>

* Test Light-sensing circuit
* Create System Schematics
* Code Servo Task
* Create Structure Design (Autodesk Inventor)

</td>
<td>
* Completed
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
4
</center> </td>
<td>

* Code Light-sensing Task
* Build/Machine Structure
* Code Glue Logics (Directional Logic)
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
5
</center> </td>
<td>
* Integrate system
* Test System
* Project report
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
6
</center> </td>
<td>
* Finalize project
* Finalize report
</td>
<td>
* Completed
* Completed
</td>
</tr>

</table>

== Parts List & Cost ==

<table class = "wikitable">
<th>Part</th> <th>Quuantity</th><th>Cost</th><th>Link</th>

<tr>
<td>LPC 1758 SJSU Dev Board</td>
<td align = "right"> 1 </td>
<td align = "right"> $60 </td>
<td align = "right"> </td>

<tr>
<td>180 Degree Servo </td>
<td align = "right"> 2 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>

<tr>
<td>Solar Panel</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>

<tr>
<td>LED Matrix</td>
<td align = "right"> 1 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Resistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $.25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Photoresistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $1.50 </td>
<td align = "right"> </td>

<tr>
<tr>
<td>Jumper wires(x50)</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Servo belt</td>
<td align = "right"> 2 </td>
<td align = "right"> $2 </td>
<td align = "right"> </td>
<tr>

</table>

== Design & Implementation ==
The design section can go over your hardware and software design. Organize this section using sub-sections that go over your design and implementation.

=== Hardware Design ===
=====Light Sensor=====
The Solar Panel Sun Tracker consists of the following hardware:
* Resistors
*Photo resistors
This section is responsible for interpreting the voltage of the photo resistors. The diagram below shows the circuit needed in order to get a voltage division of the two photo resistors. This voltage divider consists of two resistors on each side of the voltage divider output (ADC pin). When the top photo resistor has a greater resistance then the bottom resistor the voltage output will drop. When they both have the same resistance will hold in the middle.

[[File:CmpE146_S13_SPT_LightSensorConnection.png|center|frame]]
<div style="text-align: center;">'''Figure 1:''' LightSensorConnection </div>

=====Servo Motor=====
The servo section consists of the following hardware:
* Servo Motors / Servo Belts
* Solar Panel

This section is responsible for positioning the solar panels perpendicular to the light source. The panel is mounted to a frame that pivots according to the top servo. In order to perform a full scan the top servo motor was mounted on pivoting bases that is controlled by the second motor. The diagram below describes the complete setup in order to properly track the sun from sun rise to sun set.

[[File:CmpE146_S13_SPT_SJOneBoardSchematic.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>

=== Hardware Interface ===
[[File:CmpE146_S13_SPT_SjOneInterface.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>
<table class = "wikitable">
<th> SJSU Dev Board Pin</th> <th> Destination Pin</th><th>Description</th>

<tr>
<td> PWM1.4(p1.23) </td>
<td align = "right"> Servo Base Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> PWM1.5(p1.24) </td>
<td align = "right"> Servo Top Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> AD0.4(p1.30) </td>
<td align = "right"> Light Sensor Base</td>
<td align = "right"> Analog Input </td>
<tr>
<td> AD0.5(p1.31) </td>
<td align = "right"> Light Sensor Top </td>
<td align = "right"> Analog Input </td>
</table>

==== PWM ====
PWM, or Pulse Width Modulation, was used to control the two 180 degree positional servos. The servos required a 50 Hz (20 ms) duty cycle, and the duration of the high duty cycle (in milliseconds) would control the position to move to. Typically, the valid high duty cycles are between 1.0 and 2.0 milliseconds, with 1.0 representing '0 degrees', 1.5 representing '90 degrees' and 2.0 representing '180 degrees.' However, we found that the valid duty cycle range was larger, ranging from [INSERT FULL RANGE]. Knowing this, we expanded the range of the duty cycle and converted the range into a degree range with the <i>change_direction_with_Degree()</i> function. The servos were connected to a 5V power supply and were controlled by PWM1-4(P1.23)and PWM1-5(P1.24).

[[File:146ServoPWM.png|center|frame]]

==== ADC ====

=== Software Design ===
Show your software design. For example, if you are designing an MP3 Player, show the tasks that you are using, and what they are doing at a high level. Do not show the details of the code. For example, do not show exact code, but you may show psuedocode and fragments of code. Keep in mind that you are showing DESIGN of your software, not the inner workings of it.

[[File:CmpE146_S13_SPT_FreeRTOS.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

=== Implementation ===
This section includes implementation, but again, not the details, just the high level. For example, you can list the steps it takes to communicate over a sensor, or the steps needed to write a page of memory onto SPI Flash. You can include sub-sections for each of your component implementation.

[[File:CmpE146_S13_SPT_SjOneIO.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

[[File:CmpE146_S13_SPT_SJOneBoardPWMblockDiagram.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

==== Light sensor Logic ====
The <i>LightSensors.cpp</i> file contains the functions that the Light-sensing task calls. These functions are <i>getDirection()</i>, which reads the referenced Analog-to-Digital Converter pin (ADC-4 or ADC-5), and returns a value which is the new change in direction for the respective servo motor (Top or Base). The <i>getDirection()</i> function reads the ADC pin value and uses it to decide which direction the servo should move towards, and returns either a positive <i>degreeChange</i>, a negative <i>degreeChange</i>, or a 0 for no change. For this project, we decided to use 5 degrees as the degree change. The <i>getDirection()</i> function can be seen below:

[[File:146getDirectionBaseCodeSnippet.png|center|frame]]
==== Servo motor Logic ====
The <i>ServoMotors.cpp</i> file contains the <i>change_direction_withDegree()</i> function, which updates the PWM Match Register for the given PWM signal and the degree. This function takes the degree value, ensures that it is within range, then converts it into milliseconds so it can be written to the respective Match Register, using the <i>PWMUpdateMR()</i> function defined in the PWM driver file. We used the definitions <i>Max_degree</i>, <i>Servo_Width</i>, <i>Servo_Start</i>, and <i>freq_ms</i>, whose values may need to be changed if a different servo motor is used. <i>Max_degree</i> is the farthest degree available to the servo motor (180), <i>freq_ms</i> is the duty cycle (20 ms), and the <i>Servo_Width</i> and <i>Servo_Start</i> are derived from the duty cycle thresholds (in ms) mapped to the degree range (0 - 180) of the servo motor.

[[File:146changeDirectionCodeSnippet.png‎ |center|frame]]
==== Light-sensing Task ====
The Light-sensing task was very simple. To keep it this way, all of the 'heavy lifting' was completed in lower level code in the <i>LightSensors.cpp</i> file. Therefore, the only functions that the Light-sensing task needs to deal with is the <i>getDirectionTop()</i> and <i>getDirectionBase()</i> functions. However, there is a small amount of code to prevent the degree values from going out of range (0-180 degrees). The task reads the <i>getDirection()</i> values for both the top and base servo motors, which have valid values of negative five (-5), zero (0), or positive five (5). These values are added to the current positional value to obtain updated values to pass to the Servo Motor task through the Queue.

==== Servo Task ====
The Servo Task is even simpler. It takes the top and base positional values from the Queue, then passes the value to the servo motors using the <i>change_direction_withDegree()</i> function, which is defined in the <i>ServoMotors.cpp</i> file.

== Testing & Technical Challenges ==
Describe the challenges of your project. What advise would you give yourself or someone else if your project can be started from scratch again?
Make a smooth transition to testing section and described what it took to test your project.

Include sub-sections that list out a problem and solution, such as:

=== Wifi Connection Issues ===
Many wifi connection issues were encountered. To solve this problem, a dedicated task was created to re-connect to wifi if the connection was ever lost.

== Conclusion ==
Conclude your project here. You can recap your testing and problems. You should address the "so what" part here to indicate what you ultimately learnt from this project. How has this project increased your knowledge?

=== Project Video ===
Upload a video of your project and post the link here.

=== Project Source Code ===
Send me your zipped source code and I will upload this to SourceForge and link it for you.

== References ==
=== Acknowledgement ===
Any acknowledgement that you may wish to provide can be included here.

=== References Used ===
List any references used in project.

=== Appendix ===
You can list the references you used.

S13: Solar Panel Tracker

2013-05-22T00:23:03Z

Matt s13: /* Servo motor Logic */

=== Grading Criteria ===
<font color="green">
* How well is Software & Hardware Design described?
* How well can this report be used to reproduce this project?
* Code Quality
* Overall Report Quality:
** Software Block Diagrams
** Hardware Block Diagrams
**: Schematic Quality
** Quality of technical challenges and solutions adopted.
</font>

== Project Title ==

== Abstract ==
The objective of this project is to create a solar panel that tracks the sun. The project will consist of two stepper motors that control the position of the solar panels by using the photo resistors to detect the sun location.

== Objectives & Introduction ==
Solar Panel Sun tracker uses the inputted voltage from photo resistors in order to adjust the position of the solar panel. The project uses and Analog to digital converter. The servo motors are controlled using a pulse; this controls the position of various angles. The servo uses in this project is a standard servo which can only position between 0 and 180 degrees.

The project required the following objectives to be accomplished:
* Read the voltage from photo resistors
* Control servo to move from 0 to 180 degrees
* Compute the location which has the greatest light intensity
* Determine algorithm to convert digital value into servo position

=== Team Members & Responsibilities ===
* Arturo Montoya
** Light Sensors (PWM driver) , Servo motor(ADC driver) , and Matrix (Spi driver)
* Matthew Balhorn
** FreeRTOS Software Design

== Schedule ==

<table class="wikitable">
<th>Week</th><th>Planned Tasks</th><th>Status</th>
<tr>
<td> <center>
1
</center> </td>
<td>
* Order parts

</td>
<td>
* Completed

</td>
</tr>

<tr>
<td> <center>
2
</center> </td>
<td>
* Look over datasheet(s)
* Test Servos
* Design System Logics
</td>
<td>
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
3
</center> </td>
<td>

* Test Light-sensing circuit
* Create System Schematics
* Code Servo Task
* Create Structure Design (Autodesk Inventor)

</td>
<td>
* Completed
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
4
</center> </td>
<td>

* Code Light-sensing Task
* Build/Machine Structure
* Code Glue Logics (Directional Logic)
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
5
</center> </td>
<td>
* Integrate system
* Test System
* Project report
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
6
</center> </td>
<td>
* Finalize project
* Finalize report
</td>
<td>
* Completed
* Completed
</td>
</tr>

</table>

== Parts List & Cost ==

<table class = "wikitable">
<th>Part</th> <th>Quuantity</th><th>Cost</th><th>Link</th>

<tr>
<td>LPC 1758 SJSU Dev Board</td>
<td align = "right"> 1 </td>
<td align = "right"> $60 </td>
<td align = "right"> </td>

<tr>
<td>180 Degree Servo </td>
<td align = "right"> 2 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>

<tr>
<td>Solar Panel</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>

<tr>
<td>LED Matrix</td>
<td align = "right"> 1 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Resistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $.25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Photoresistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $1.50 </td>
<td align = "right"> </td>

<tr>
<tr>
<td>Jumper wires(x50)</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Servo belt</td>
<td align = "right"> 2 </td>
<td align = "right"> $2 </td>
<td align = "right"> </td>
<tr>

</table>

== Design & Implementation ==
The design section can go over your hardware and software design. Organize this section using sub-sections that go over your design and implementation.

=== Hardware Design ===
=====Light Sensor=====
The Solar Panel Sun Tracker consists of the following hardware:
* Resistors
*Photo resistors
This section is responsible for interpreting the voltage of the photo resistors. The diagram below shows the circuit needed in order to get a voltage division of the two photo resistors. This voltage divider consists of two resistors on each side of the voltage divider output (ADC pin). When the top photo resistor has a greater resistance then the bottom resistor the voltage output will drop. When they both have the same resistance will hold in the middle.

[[File:CmpE146_S13_SPT_LightSensorConnection.png|center|frame]]
<div style="text-align: center;">'''Figure 1:''' LightSensorConnection </div>

=====Servo Motor=====
The servo section consists of the following hardware:
* Servo Motors / Servo Belts
* Solar Panel

This section is responsible for positioning the solar panels perpendicular to the light source. The panel is mounted to a frame that pivots according to the top servo. In order to perform a full scan the top servo motor was mounted on pivoting bases that is controlled by the second motor. The diagram below describes the complete setup in order to properly track the sun from sun rise to sun set.

[[File:CmpE146_S13_SPT_SJOneBoardSchematic.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>

=== Hardware Interface ===
[[File:CmpE146_S13_SPT_SjOneInterface.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>
<table class = "wikitable">
<th> SJSU Dev Board Pin</th> <th> Destination Pin</th><th>Description</th>

<tr>
<td> PWM1.4(p1.23) </td>
<td align = "right"> Servo Base Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> PWM1.5(p1.24) </td>
<td align = "right"> Servo Top Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> AD0.4(p1.30) </td>
<td align = "right"> Light Sensor Base</td>
<td align = "right"> Analog Input </td>
<tr>
<td> AD0.5(p1.31) </td>
<td align = "right"> Light Sensor Top </td>
<td align = "right"> Analog Input </td>
</table>

==== PWM ====
PWM, or Pulse Width Modulation, was used to control the two 180 degree positional servos. The servos required a 50 Hz (20 ms) duty cycle, and the duration of the high duty cycle (in milliseconds) would control the position to move to. Typically, the valid high duty cycles are between 1.0 and 2.0 milliseconds, with 1.0 representing '0 degrees', 1.5 representing '90 degrees' and 2.0 representing '180 degrees.' However, we found that the valid duty cycle range was larger, ranging from [INSERT FULL RANGE]. Knowing this, we expanded the range of the duty cycle and converted the range into a degree range with the <i>change_direction_with_Degree()</i> function. The servos were connected to a 5V power supply and were controlled by PWM1-4(P1.23)and PWM1-5(P1.24).

[[File:146ServoPWM.png|center|frame]]

==== ADC ====

=== Software Design ===
Show your software design. For example, if you are designing an MP3 Player, show the tasks that you are using, and what they are doing at a high level. Do not show the details of the code. For example, do not show exact code, but you may show psuedocode and fragments of code. Keep in mind that you are showing DESIGN of your software, not the inner workings of it.

[[File:CmpE146_S13_SPT_FreeRTOS.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

=== Implementation ===
This section includes implementation, but again, not the details, just the high level. For example, you can list the steps it takes to communicate over a sensor, or the steps needed to write a page of memory onto SPI Flash. You can include sub-sections for each of your component implementation.

[[File:CmpE146_S13_SPT_SjOneIO.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

[[File:CmpE146_S13_SPT_SJOneBoardPWMblockDiagram.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

==== Light sensor Logic ====
The <i>LightSensors.cpp</i> file contains the functions that the Light-sensing task calls. These functions are <i>getDirection()</i>, which reads the referenced Analog-to-Digital Converter pin (ADC-4 or ADC-5), and returns a value which is the new change in direction for the respective servo motor (Top or Base). The <i>getDirection()</i> function reads the ADC pin value and uses it to decide which direction the servo should move towards, and returns either a positive <i>degreeChange</i>, a negative <i>degreeChange</i>, or a 0 for no change. For this project, we decided to use 5 degrees as the degree change. The <i>getDirection()</i> function can be seen below:

[[File:146getDirectionBaseCodeSnippet.png|center|frame]]
==== Servo motor Logic ====
The <i>ServoMotors.cpp</i> file contains the <i>change_direction_withDegree()</i> function, which updates the PWM Match Register for the given PWM signal and the degree. This function takes the degree value, ensures that it is within range, then converts it into milliseconds so it can be written to the respective Match Register, using the <i>PWMUpdateMR()</i> function defined in the PWM driver file. We used the definitions <i>Max_degree</i>, <i>Servo_Width</i>, <i>Servo_Start</i>, and <i>freq_ms</i>, whose values may need to be changed if a different servo motor is used. <i>Max_degree</i> is the farthest degree available to the servo motor (180), <i>freq_ms</i> is the duty cycle (20 ms), and the <i>Servo_Width</i> and <i>Servo_Start</i> are derived from the duty cycle thresholds (in ms) mapped to the degree range (0 - 180) of the servo motor.

==== Light-sensing Task ====
The Light-sensing task was very simple. To keep it this way, all of the 'heavy lifting' was completed in lower level code in the <i>LightSensors.cpp</i> file. Therefore, the only functions that the Light-sensing task needs to deal with is the <i>getDirectionTop()</i> and <i>getDirectionBase()</i> functions. However, there is a small amount of code to prevent the degree values from going out of range (0-180 degrees). The task reads the <i>getDirection()</i> values for both the top and base servo motors, which have valid values of negative five (-5), zero (0), or positive five (5). These values are added to the current positional value to obtain updated values to pass to the Servo Motor task through the Queue.

==== Servo Task ====
The Servo Task is even simpler. It takes the top and base positional values from the Queue, then passes the value to the servo motors using the <i>change_direction_withDegree()</i> function, which is defined in the <i>ServoMotors.cpp</i> file.

== Testing & Technical Challenges ==
Describe the challenges of your project. What advise would you give yourself or someone else if your project can be started from scratch again?
Make a smooth transition to testing section and described what it took to test your project.

Include sub-sections that list out a problem and solution, such as:

=== Wifi Connection Issues ===
Many wifi connection issues were encountered. To solve this problem, a dedicated task was created to re-connect to wifi if the connection was ever lost.

== Conclusion ==
Conclude your project here. You can recap your testing and problems. You should address the "so what" part here to indicate what you ultimately learnt from this project. How has this project increased your knowledge?

=== Project Video ===
Upload a video of your project and post the link here.

=== Project Source Code ===
Send me your zipped source code and I will upload this to SourceForge and link it for you.

== References ==
=== Acknowledgement ===
Any acknowledgement that you may wish to provide can be included here.

=== References Used ===
List any references used in project.

=== Appendix ===
You can list the references you used.

File:146changeDirectionCodeSnippet.png

2013-05-22T00:12:20Z

Matt s13: uploaded a new version of "File:146changeDirectionCodeSnippet.png"

File:146changeDirectionCodeSnippet.png

2013-05-22T00:11:27Z

Matt s13:

S13: Solar Panel Tracker

2013-05-21T23:55:24Z

Matt s13: /* Implementation */

=== Grading Criteria ===
<font color="green">
* How well is Software & Hardware Design described?
* How well can this report be used to reproduce this project?
* Code Quality
* Overall Report Quality:
** Software Block Diagrams
** Hardware Block Diagrams
**: Schematic Quality
** Quality of technical challenges and solutions adopted.
</font>

== Project Title ==

== Abstract ==
The objective of this project is to create a solar panel that tracks the sun. The project will consist of two stepper motors that control the position of the solar panels by using the photo resistors to detect the sun location.

== Objectives & Introduction ==
Solar Panel Sun tracker uses the inputted voltage from photo resistors in order to adjust the position of the solar panel. The project uses and Analog to digital converter. The servo motors are controlled using a pulse; this controls the position of various angles. The servo uses in this project is a standard servo which can only position between 0 and 180 degrees.

The project required the following objectives to be accomplished:
* Read the voltage from photo resistors
* Control servo to move from 0 to 180 degrees
* Compute the location which has the greatest light intensity
* Determine algorithm to convert digital value into servo position

=== Team Members & Responsibilities ===
* Arturo Montoya
** Light Sensors (PWM driver) , Servo motor(ADC driver) , and Matrix (Spi driver)
* Matthew Balhorn
** FreeRTOS Software Design

== Schedule ==

<table class="wikitable">
<th>Week</th><th>Planned Tasks</th><th>Status</th>
<tr>
<td> <center>
1
</center> </td>
<td>
* Order parts

</td>
<td>
* Completed

</td>
</tr>

<tr>
<td> <center>
2
</center> </td>
<td>
* Look over datasheet(s)
* Test Servos
* Design System Logics
</td>
<td>
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
3
</center> </td>
<td>

* Test Light-sensing circuit
* Create System Schematics
* Code Servo Task
* Create Structure Design (Autodesk Inventor)

</td>
<td>
* Completed
* Completed
* Completed
* Completed

</td>
</tr>

<tr>
<td> <center>
4
</center> </td>
<td>

* Code Light-sensing Task
* Build/Machine Structure
* Code Glue Logics (Directional Logic)
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
5
</center> </td>
<td>
* Integrate system
* Test System
* Project report
</td>
<td>
* Completed
* Completed
* Completed
</td>
</tr>

<tr>
<td> <center>
6
</center> </td>
<td>
* Finalize project
* Finalize report
</td>
<td>
* Completed
* Completed
</td>
</tr>

</table>

== Parts List & Cost ==

<table class = "wikitable">
<th>Part</th> <th>Quuantity</th><th>Cost</th><th>Link</th>

<tr>
<td>LPC 1758 SJSU Dev Board</td>
<td align = "right"> 1 </td>
<td align = "right"> $60 </td>
<td align = "right"> </td>

<tr>
<td>180 Degree Servo </td>
<td align = "right"> 2 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>

<tr>
<td>Solar Panel</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>

<tr>
<td>LED Matrix</td>
<td align = "right"> 1 </td>
<td align = "right"> $25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Resistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $.25 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Photoresistors </td>
<td align = "right"> 4 </td>
<td align = "right"> $1.50 </td>
<td align = "right"> </td>

<tr>
<tr>
<td>Jumper wires(x50)</td>
<td align = "right"> 1 </td>
<td align = "right"> $15 </td>
<td align = "right"> </td>
<tr>
<tr>
<td>Servo belt</td>
<td align = "right"> 2 </td>
<td align = "right"> $2 </td>
<td align = "right"> </td>
<tr>

</table>

== Design & Implementation ==
The design section can go over your hardware and software design. Organize this section using sub-sections that go over your design and implementation.

=== Hardware Design ===
=====Light Sensor=====
The Solar Panel Sun Tracker consists of the following hardware:
* Resistors
*Photo resistors
This section is responsible for interpreting the voltage of the photo resistors. The diagram below shows the circuit needed in order to get a voltage division of the two photo resistors. This voltage divider consists of two resistors on each side of the voltage divider output (ADC pin). When the top photo resistor has a greater resistance then the bottom resistor the voltage output will drop. When they both have the same resistance will hold in the middle.

[[File:CmpE146_S13_SPT_LightSensorConnection.png|center|frame]]
<div style="text-align: center;">'''Figure 1:''' LightSensorConnection </div>

=====Servo Motor=====
The servo section consists of the following hardware:
* Servo Motors / Servo Belts
* Solar Panel

This section is responsible for positioning the solar panels perpendicular to the light source. The panel is mounted to a frame that pivots according to the top servo. In order to perform a full scan the top servo motor was mounted on pivoting bases that is controlled by the second motor. The diagram below describes the complete setup in order to properly track the sun from sun rise to sun set.

[[File:CmpE146_S13_SPT_SJOneBoardSchematic.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>

=== Hardware Interface ===
[[File:CmpE146_S13_SPT_SjOneInterface.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' SjOneInterface </div>
<table class = "wikitable">
<th> SJSU Dev Board Pin</th> <th> Destination Pin</th><th>Description</th>

<tr>
<td> PWM1.4(p1.23) </td>
<td align = "right"> Servo Base Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> PWM1.5(p1.24) </td>
<td align = "right"> Servo Top Control </td>
<td align = "right"> Set pivot </td>
<tr>
<td> AD0.4(p1.30) </td>
<td align = "right"> Light Sensor Base</td>
<td align = "right"> Analog Input </td>
<tr>
<td> AD0.5(p1.31) </td>
<td align = "right"> Light Sensor Top </td>
<td align = "right"> Analog Input </td>
</table>

==== PWM ====
PWM, or Pulse Width Modulation, was used to control the two 180 degree positional servos. The servos required a 50 Hz (20 ms) duty cycle, and the duration of the high duty cycle (in milliseconds) would control the position to move to. Typically, the valid high duty cycles are between 1.0 and 2.0 milliseconds, with 1.0 representing '0 degrees', 1.5 representing '90 degrees' and 2.0 representing '180 degrees.' However, we found that the valid duty cycle range was larger, ranging from [INSERT FULL RANGE]. Knowing this, we expanded the range of the duty cycle and converted the range into a degree range with the <i>change_direction_with_Degree()</i> function. The servos were connected to a 5V power supply and were controlled by PWM1-4(P1.23)and PWM1-5(P1.24).

[[File:146ServoPWM.png|center|frame]]

==== ADC ====

=== Software Design ===
Show your software design. For example, if you are designing an MP3 Player, show the tasks that you are using, and what they are doing at a high level. Do not show the details of the code. For example, do not show exact code, but you may show psuedocode and fragments of code. Keep in mind that you are showing DESIGN of your software, not the inner workings of it.

[[File:CmpE146_S13_SPT_FreeRTOS.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

=== Implementation ===
This section includes implementation, but again, not the details, just the high level. For example, you can list the steps it takes to communicate over a sensor, or the steps needed to write a page of memory onto SPI Flash. You can include sub-sections for each of your component implementation.

[[File:CmpE146_S13_SPT_SjOneIO.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

[[File:CmpE146_S13_SPT_SJOneBoardPWMblockDiagram.png|center|frame]]
<div style="text-align: center;">'''Figure 2:''' FreeRTOS </div>

==== Light sensor Logic ====
The <i>LightSensors.cpp</i> file contains the functions that the Light-sensing task calls. These functions are <i>getDirection()</i>, which reads the referenced Analog-to-Digital Converter pin (ADC-4 or ADC-5), and returns a value which is the new change in direction for the respective servo motor (Top or Base). The <i>getDirection()</i> function reads the ADC pin value and uses it to decide which direction the servo should move towards, and returns either a positive <i>degreeChange</i>, a negative <i>degreeChange</i>, or a 0 for no change. For this project, we decided to use 5 degrees as the degree change. The <i>getDirection()</i> function can be seen below:

[[File:146getDirectionBaseCodeSnippet.png|center|frame]]
==== Servo motor Logic ====

==== Light-sensing Task ====
The Light-sensing task was very simple. To keep it this way, all of the 'heavy lifting' was completed in lower level code in the <i>LightSensors.cpp</i> file. Therefore, the only functions that the Light-sensing task needs to deal with is the <i>getDirectionTop()</i> and <i>getDirectionBase()</i> functions. However, there is a small amount of code to prevent the degree values from going out of range (0-180 degrees). The task reads the <i>getDirection()</i> values for both the top and base servo motors, which have valid values of negative five (-5), zero (0), or positive five (5). These values are added to the current positional value to obtain updated values to pass to the Servo Motor task through the Queue.

==== Servo Task ====
The Servo Task is even simpler. It takes the top and base positional values from the Queue, then passes the value to the servo motors using the <i>change_direction_withDegree()</i> function, which is defined in the <i>ServoMotors.cpp</i> file.

== Testing & Technical Challenges ==
Describe the challenges of your project. What advise would you give yourself or someone else if your project can be started from scratch again?
Make a smooth transition to testing section and described what it took to test your project.

Include sub-sections that list out a problem and solution, such as:

=== Wifi Connection Issues ===
Many wifi connection issues were encountered. To solve this problem, a dedicated task was created to re-connect to wifi if the connection was ever lost.

== Conclusion ==
Conclude your project here. You can recap your testing and problems. You should address the "so what" part here to indicate what you ultimately learnt from this project. How has this project increased your knowledge?

=== Project Video ===
Upload a video of your project and post the link here.

=== Project Source Code ===
Send me your zipped source code and I will upload this to SourceForge and link it for you.

== References ==
=== Acknowledgement ===
Any acknowledgement that you may wish to provide can be included here.

=== References Used ===
List any references used in project.

=== Appendix ===
You can list the references you used.

File:146getDirectionBaseCodeSnippet.png

2013-05-21T23:52:31Z

Matt s13: uploaded a new version of "File:146getDirectionBaseCodeSnippet.png"

File:146getDirectionBaseCodeSnippet.png

2013-05-21T23:41:51Z

Matt s13: uploaded a new version of "File:146getDirectionBaseCodeSnippet.png"

File:146getDirectionBaseCodeSnippet.png

2013-05-21T23:32:40Z

Matt s13:

File:146ServoPWM.png

2013-05-20T05:15:21Z

Matt s13: uploaded a new version of "File:146ServoPWM.png"

S13: Solar Panel Tracker

2013-05-20T05:13:15Z

Matt s13: /* Implementation */

S13: Solar Panel Tracker

2013-05-18T20:56:21Z

Matt s13: /* PWM */

File:146ServoPWM.png

2013-05-18T20:50:54Z

Matt s13:

S13: Solar Panel Tracker

2013-05-18T20:19:22Z

Matt s13: /* Hardware Design */

S13: Solar Panel Tracker

2013-05-18T20:12:00Z

Matt s13: /* Design & Implementation */

S13: Solar Panel Tracker

2013-05-18T20:10:20Z

Matt s13: /* Hardware Interface */

S13: Solar Panel Tracker

2013-05-18T20:08:56Z

Matt s13: /* Hardware Interface */

File:CmpE146 S13 SPT SjOneIO.png

2013-05-17T23:19:12Z

Matt s13: SjOneIO

SjOneIO

S13: Solar Panel Tracker

2013-05-17T23:17:52Z

Matt s13: /* Design & Implementation */

S13: Solar Panel Tracker

2013-05-17T23:13:56Z

Matt s13: /* Software Design */

S13: Solar Panel Tracker

2013-05-17T23:12:31Z

Matt s13: /* Hardware Design */

File:CmpE146 S13 SPT SJOneBoardSchematic.png

2013-05-17T23:09:29Z

Matt s13: SJOneBoardSchematic

SJOneBoardSchematic

File:CmpE146 S13 SPT SJOneBoardPWMblockDiagram.png

2013-05-17T23:08:45Z

Matt s13: SJOneBoardPWMblockDiagram

SJOneBoardPWMblockDiagram

File:CmpE146 S13 SPT FreeRTOS.png

2013-05-17T23:07:54Z

Matt s13: FreeRTOS

FreeRTOS

File:CmpE146 S13 SPT LightSensorConnection.png

2013-05-17T23:06:59Z

Matt s13: LightSensorConnection

LightSensorConnection

File:CmpE146 S13 SPT SjOneInterface.png

2013-05-17T23:05:46Z

Matt s13: Interface

Interface

S13: Solar Panel Tracker

2013-05-17T22:50:06Z

Matt s13: /* Schedule */

S13: Solar Panel Tracker

2013-05-17T22:46:53Z

Matt s13: /* Hardware Interface */