From 6a5ec040682f95519d05aee3fc1ee1be870f7e48 Mon Sep 17 00:00:00 2001 From: Rhys Weatherley Date: Mon, 18 Jun 2012 10:58:09 +1000 Subject: [PATCH] Add a picture of the completed clock --- doc/alarm-clock.dox | 13 +++++++++++-- .../RTC/examples/AlarmClock/alarm_clock.jpg | Bin 0 -> 38231 bytes 2 files changed, 11 insertions(+), 2 deletions(-) create mode 100644 libraries/RTC/examples/AlarmClock/alarm_clock.jpg diff --git a/doc/alarm-clock.dox b/doc/alarm-clock.dox index 24205763..a3522d69 100644 --- a/doc/alarm-clock.dox +++ b/doc/alarm-clock.dox @@ -34,7 +34,7 @@ Field, SoftI2C, DS1307RTC (or DS3232RTC), Melody and \li Displays both the time and date. \li 12 hour and 24 hour time display modes. \li Up to 4 configurable alarm times, plus a snooze alarm. -\li Three alarm sounds to choose from. +\li Three alarm sounds to choose from, plus an option to use a radio alarm. \li Configurable alarm timeout between 2 and 10 seconds. \li Alarms can be configured to only sound on Monday to Friday or on Saturday and Sunday. @@ -45,7 +45,7 @@ Field, SoftI2C, DS1307RTC (or DS3232RTC), Melody and \section clock_main_circuit Main circuit The main clock circuit consists of an Arduino Uno compatible board, a 16x2 -LCD module, a realtime clock chip, a piezo buzzer for the alarm, and an +LCD module, a realtime clock chip, a piezo buzzer for the alarm, and a MOSFET for controlling the radio: \image html alarm_circuit.png @@ -129,4 +129,13 @@ as follows: \li SCL connected to A5. \li BAT, 32K, and RST left unconnected. +\section clock_completed Completed Clock + +The following picture shows the completed clock prototype, built into a +UB1 jiffy box with the radio. Being the prototype, it is a little rough +and ready, but rugged enough to take a pounding each morning as a bedside +alarm clock: + +\image html alarm_clock.jpg + */ diff --git a/libraries/RTC/examples/AlarmClock/alarm_clock.jpg b/libraries/RTC/examples/AlarmClock/alarm_clock.jpg new file mode 100644 index 0000000000000000000000000000000000000000..721c7174e09e3d351df8ca0d94fbaebe039f4bc0 GIT binary patch literal 38231 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 j58dqr