1 files changed, 51 insertions, 0 deletions
diff --git a/README.txt b/README.txt
new file mode 100644
index 0000000..65594b1
--- /dev/null
+++ b/README.txt
@@ -0,0 +1,51 @@
+===================
+ Fuzzy Alarm Clock
+===================
+
+---------------------------------------------------
+ by Elena ``of Valhalla'' Grandi and Diego Roversi
+---------------------------------------------------
+
+The Fuzzy Alarm Clock is a device that conveys just the temporal informations 
+needed during the night, and nothing else.
+
+There is no time/date display, but coloured LEDs are used to show an 
+aproximation of the time until (and since) alarm time, and 
+an old PC speaker works as the Sound Emitting Device.
+
+Design notes and additional descriptions are available on the `web page
+<http://www.trueelena.org/computers/projects/fuzzy_alarm_clock.html>`_.
+
+Requirements
+============
+
+Arduino sketch
+--------------
+
+The arduino sketch ``fuzzy_alarm_clock_ds1307`` requires an old (<1.0) 
+version of the arduino tools and can be built outside the IDE 
+It also requires an old (pre 1.0 migration) version of the
+RealTimeClockDS1307_ library by davidhbrown.
+
+.. _arscons: http://code.google.com/p/arscons/
+.. _RealTimeClockDS1307: https://github.com/davidhbrown/RealTimeClockDS1307
+
+Conversion to arduino 1.0 is planned as soon as a compatible
+SConstruct file will be available.
+
+Schematics
+----------
+
+This repository includes the kicad project 
+
+Beside the standard libraries, I've used the `Arduino Shield Modules for 
+KiCad V3` by nicholasclewis; the needed component has been included by kicad 
+in the ``fuzzy_alarm_clock_ds1307-cache.lib`` file.
+
+.. _`Arduino Shield Modules for KiCad V3`: http://www.thingiverse.com/thing:9630
+
+An `SVG rendering of the schematics`_ is available on the web page, 
+but during active developement it could reflect an older version.
+
+.. _`SVG rendering of the schematics`: http://www.trueelena.org/computers/projects/fuzzy_alarm_clock/fuzzy_alarm_clock_ds1307.svg
+