File content as of revision 1:64274190e842:

/* Rtc_Ds1307.h */
/*
Copyright (c) 2013 Henry Leinen (henry[dot]leinen [at] online [dot] de)
 
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
 
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
 
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
*/
#ifndef __RTC_DS1307_H__
#define __RTC_DS1307_H__

#include "mbed.h"

typedef struct {
    int sec;
    int min;
    int hour;
    int wday;
    int date;
    int mon;
    int year;
} Time;

/** Class Rtc_Ds1307 implements the real time clock module DS1307
 *
 * You can read the clock and set a new time and date.
 * It is also possible to start and stop the clock.
 * Rtc_Ds1307 allows you to display the time in a 12h or 24h format
 */
class Rtc_Ds1307
{
        I2C*    m_rtc;
        
        static const char *m_weekDays[];    
        
    public:
        /** public constructor which creates the real time clock object
         *
         * @param sda : specifies the pin for the SDA communication line.
         *
         * @param scl : the pin for the serial clock
         *
         */
        Rtc_Ds1307(PinName sda, PinName scl);
        
        ~Rtc_Ds1307();

        /** Read the current time from RTC chip
         *
         * @param time : reference to a struct tm which will be filled with the time from rtc
         *
         * @returns true if successful, otherwise an acknowledge error occured
         */
        bool getTime(Time& time);
        
        /** Write the given time onto the RTC chip
         *
         * @param time : refereence to a struct which contains valid date and time information
         *
         * @param start : contains true if the clock shall start (or keep on running).
         *
         * @param thm : 12-hour-mode if set to true, otherwise 24-hour-mode will be set.
         *
         * @returns true if successful, otherwise an acknowledge error occured
         */
        bool setTime(Time& time, bool start, bool thm);        
        
        
        /** Service function to convert a weekday into a string representation
         *
         * @param wday : day of week to convert (starting with sunday = 1, monday = 2, ..., saturday = 7
         *
         * @returns the corresponding string representation
         */
        const char* weekdayToString( int wday )
        { return m_weekDays[wday%7]; }

    private:
        bool read(int address, char* buffer, int len);
        bool write(int address, char* buffer, int len);
        
        static int bcdToDecimal(int bcd)
        { return ((bcd&0xF0)>>4)*10 + (bcd&0x0F); }
        
        static int decimalToBcd(int dec)
        { return (dec%10) + ((dec/10)<<4); }


};
        

#endif // __RTC_DS1307_H__