/**
  \example alarm1.cpp 

  This sketch uses an alarm to print "I'm awake already" thirty
  seconds after it is powered up.

  The core software has support for 'alarms', which you can use to
  perform an event at some future time.  When the alarm 'goes off',
  your function gets called, and it can do whatever it wants.

  Alarms are created and accessed using the special \c Alarms object.
  Several alarms are used by the core software itself, but there's
  room for you to create at least a few dozen alarms as well, if you
  need that many!

  This sketch shows the three basic steps to using an alarm: 
  -# Write your 'alarm handler' function
  -# Create an alarm and pass it the name of your alarm handler.  Each
     alarm has an associated 'alarm number', which you use to refer to
     it later.
  -# Use the alarm number to set the alarm.

 */
