View source for Joystick Lantern (X02)

[[File:Joystick Latern Project.jpg|right|thumb|Joystick Latern Project Build]]
=About=
This project uses the '''[[Joystick trinket (X02)|Joystick trinket]]''' to change the colors of a color '''[[ColorLED (X02)|ColorLED]]''' or '''[[mCookie-LED_Matrix|LED Matrix]]'''. Changing the direction of the Joystick will directly change the colors on the ColorLED or LED Matrix..

This project was designed for the second generation mCookie Maker kits (202 Advanced and 302 Expert kits).

=Required Materials=
This project can be built in two ways. Either using the LED Matrix (202 Advanced Kit & 302 Expert Kit compatible) or ColorLED (302 Expert Kit compatible only) as the color changing latern.
==202 Advanced Kit / 302 Expert Kit Compatible==
*1 x mCookie Core
*1 x mBattery (202/302 Kit)
*1 x mCookie Sensor Hub
*1 x LED Matrix
*1 x Joystick
*1 x MicroUSB Cable

==302 Expert Kit Compatible ONLY==
*1 x mCookie Core
*1 x mBattery (202/302 Kit)
*1 x mCookie Sensor Hub
*1 x ColorLED
*1 x Joystick
*1 x MicroUSB Cable

=Build=
==Assembly==
#Stack all three of the modules, mCookie Core, mCookie RTC, and mCookie OLED onto mBattery. Ensure that mCookie OLED is on top of the stack.
#Plug in the MicroUSB cable to the mBattery to a computer.

=Program=
1. Connect [[mCookie-Core|mCookie Core]] to the PC with the USB Cable. Open the Microduino IDE.

2. Copy and paste the code below and upload.

<source lang="cpp">

</source>

3. Find this code section and set the initial time of the RTC module. 
<source lang="cpp">
setRtcTime(15, 5, 18, 1, 00, 00, 00);
</source>
The function signature is as follows: '''setRtcTime(year, month, day, week, hour, minute, sec);'''. 

Replace the value of the time you wish to set. Once set, the module will maintain the time even when the power is off.

4. Select the board, processor and port:
*Go to '''Tools > Board'''  and select '''Microduino/mCookie-Core (328p)'''
*Go to '''Tools > Processor''' and select '''Atmega328P16M,5V'''
*Go to '''Tools > Port''' and select the available port

'''NOTE''': If not using the default Core module included in the kits, please follow the '''[[Selecting_board,_processor,_and_port|selecting the board and processor guide]]'''.

5. Upload the program by clicking on the '''right arrow icon''' on the top left of the window. Or under '''Sketch > Upload'''.

6. Once the program is uploaded. The line of code in step number 3 will set the time on the Real Time Clock module. But this occurs every time the Core module starts up. Which is undesired in keep track of the time. Go back to the code and disable that line by commenting it out with '''//''' as follows. Then re-upload the program.
<source lang="cpp">
//setRtcTime(15, 5, 18, 1, 00, 00, 00);
</source>

==Debugging==
==Tweaking==

=Usage=
Turn on the project and the time stored on the Real Time Clock (RTC) module will be retrieved and displayed on the OLED screen. Powering off the project will maintain the time since the Real Time Clock (RTC) has a capacitor that enables keeping track of the time even when the power source is off. (Please comment out the '''setRtcTime''' line so that the time does not get overwritten every time the Core module starts up).