====== Smart Alarm ======
  - Mihai Iusan
  - Camilo Cifuentes
  - Bhupesh Mudari

===== Idea =====
=== Problem ===

In our times people usually use their mobile phones too wake them up.

But stopping the alarm can be a problem:
  * The phone can be too far away
  * Other times it can get damaged (dropping the phone on the floor, hitting it...)
  * Or we just cannot touch it (dirty hands, has fallen under the drivers seat...)
  * If just you want to stop it in a fancy way and press no button.
  * Or you cannot press the button.

=== Solution ===

**//>> Stop your phone alarm using Sound, Shake or Flip it!!! <<//**

===== Features =====

== At the end the Sound Controlled Alarm will be able to: ==
  * Setup the alarm
  * Stop it using sound

== Other Features/Further improvements ==
  * Stop it by shaking the phone //>> implemented << //
  * Flip the device to stop //>> implemented <<//
  * The alarm should act differently according to you the location you are situated

===== Implementation Plan and Goals =====
=== Development process ===
//For creating the application we are using the spiral model.//

\\
^ Increment^ Description ^ File ^
|First | Creating the basic alarm application | {{:qt2010:grp3:first_iteration.zip|}} |
|Second | Adding the microphone input feature | {{:qt2010:grp3:second_iteration.zip|}} |
|Third  | Reading the sound level | {{:qt2010:grp3:third_iteration.zip|}} |
|Forth  | Integrating the features to stop by sound | {{:qt2010:grp3:forth_iteration.zip|}} |
| Fifth | Save settings to file | {{:qt2010:grp3:fifth_iteration.zip|}} |
| Sixth | Testing the application and repairing bugs | {{:qt2010:grp3:sixth_iteration.zip|}} |
| Seventh | Stop by Shake functionality | {{:qt2010:grp3:seventh_iteration.zip|}} |
| Eighth | Stop by Flip functionality | {{:qt2010:grp3:eighth_iteration.zip|}} |
| Ninth | Beta version | {{:qt2010:grp3:ninth_iteration.zip|}} |
| Tenth | Beta 2, if no alarm sound found, a browser appears | {{:qt2010:grp3:tenth_iteration.zip|}} |
| Eleventh | Beta 3, bug fixed | {{:qt2010:grp3:eleventh_iteration.zip|}} |

\\

==== At the end we should have: ====
=== Voice Controlled Alarm should have ===
  * Time reading
  * Sound playback
  * Sound reading
  * Sound analysis

=== Optional Features/Further improvements ===
  * Using calendar for alarm decisions
  * Location recognition
  * Movement
===== Design =====
=== Class Diagram ===
{{:qt2010:grp3:class.png|}}
=== Sequence Diagram ===
{{:qt2010:grp3:sequence.png|}}

===== Screen shots =====

| {{:qt2010:grp3:1p.png|}} | {{:qt2010:grp3:2p.png|}} | {{:qt2010:grp3:3p.png|}} |

\\

| {{:qt2010:grp3:1l.png|}} | {{:qt2010:grp3:2l.png|}} |
| {{:qt2010:grp3:3l.png|}} |

\\

===== Project Artefacts =====
==== Presentation slides ====
{{:qt2010:grp3:sound_controlled_alarm_presentation.pdf|Project Start Presentation}}
\\
{{:qt2010:grp3:final_qt_codecamp_presentation.pdf|Final Project Presentation}}

==== Report document ====
\\
{{:qt2010:grp3:smart_alarm_report.pdf|Smart Alarm Report}}
\\
{{:qt2010:grp3:smart_alarm_brochure.pdf|Smart Alarm Brochure}}

==== Source Package ====
Initial release: 
{{:qt2010:grp3:rc1.zip|}}

=== How to run the software ===

You need to open the project file in the Qt Creator.
in the simulation folder you need a folder with sounds and the name of the sounds should be warning.wav and ringin.wav.
When installing on the phone, you need to select a *.wav file from the browse if it doesn't find the sound automaticaly.
\\
\\
**Note:** You can copy the wav files from the package. They are located on the sounds folder from any of the root folders of the archive.
\\
**Note:** If you do not have the *.wav file the application lets you choose a file, but this will appear only if the configuration is wrong. You need to select *.wav files for the sound to work.
\\
**Note:** if you just want to install on a Symbian phone, you can just install it using ovi and uploading the sys file from the project folder. (tested on N8)

===== Conclusion =====
\\

During the developing of the application we found out that in Qt platform is easier to make more complex applications. For example connecting objects events you can use slots and signals which we believe is a very good concept that makes your work easier.
Using the mobility package we noticed that is easy to read the sensors. The only problem that we had at the beginning was that we didn’t know how to declare the mobility API in the project file.
\\
\\
Also the simulation is very useful when developing, like this you do not need to have the device for testing purpose. But also there is a drawback because there are functions that do not work in all the environments. For example the function isFinished() of QSound class.
Because the software doesn’t run the same in all the environments, we also noticed other problems, for example on Symbian, our microphone implementation does not work.
\\
\\
The final conclusion is that Qt is a powerful platform that helps the developer create software in a easier manner. Even though we found some problems, we believe that in time everything will run properly. In the future we predict that the platform will be used in a larger extent.