Library Description

The library initializes and defines the I2C drivers and drivers that offer a choice of writing data in register and reading data from the register in BCD and DEC format. The library includes function for sets Time, Date, new Alarm and set/get UNIX time. The user can set and read Time and Date data, especially using the functions for reading and writing data. The library includes functions for setting the desired alarm, disabling alarm and checking whether an alarm has been activated.

Key functions:

• uint8_t rtc8_readData(uint8_t reg) - Read one byte data from register in DEC format.
• uint32_t rtc8_getUNIX() - Get current UNIX time.
• uint8_t rtc8_setTime(uint8_t _hours, uint8_t _minutes, uint8_t _seconds) - Set new start time - 24 hour format.
• uint8_t rtc8_setDate(uint8_t _date, uint8_t _month, uint8_t _year) - Set new start date.

Examples description

The application is composed of the three sections :

• System Initialization - Initializes I2C module and sets INT pin as INPUT and CS pin as OUTPUT.
• Application Initialization - Initialization driver init, settings RTC for work and sets start time/date and new alarm.
• Application Task - Read current Time, Date and UNIX time and checks if the alarm is active.

	void applicationTask()
{
    uint8_t seconds;
    uint8_t minutes;
    uint8_t hours;
    uint8_t _weekday;
    uint8_t date;
    uint8_t month;
    uint8_t year;
    uint8_t status;
    uint32_t UNIX_time;
    char demoText[50];
    
    // Time
    seconds = rtc8_readData(_RTC8_REG_SECONDS);
    minutes = rtc8_readData(_RTC8_REG_MINUTES);
    hours = rtc8_readData(_RTC8_REG_HOURS);
    // Date
    _weekday = rtc8_readData(_RTC8_REG_WEEKDAY);
    date = rtc8_readData(_RTC8_REG_DATE);
    month = rtc8_readData(_RTC8_REG_MONTH);
    year = rtc8_readData(_RTC8_REG_YEAR);
    status = rtc8_readByte(_RTC8_REG_STATUS);
    // Unix time
    UNIX_time = rtc8_getUNIX();
    
     
    mikrobus_logWrite( "Time:  ", _LOG_TEXT );
    // Houes
    IntToStr(hours, demoText);
    Ltrim(demoText);
    mikrobus_logWrite( demoText, _LOG_TEXT );
    // Minute
    mikrobus_logWrite(":", _LOG_TEXT);
    IntToStr(minutes, demoText);
    Ltrim(demoText);
    mikrobus_logWrite(demoText, _LOG_TEXT);
    // Seconds
    mikrobus_logWrite(":", _LOG_TEXT);
    IntToStr(seconds, demoText);
    Ltrim(demoText);
    mikrobus_logWrite(demoText, _LOG_LINE);

    mikrobus_logWrite( "Weekday: ", _LOG_TEXT );
    IntToStr(_weekday, demoText);
    Ltrim(demoText);
    mikrobus_logWrite( demoText, _LOG_LINE );
  
    mikrobus_logWrite( "Date:  ", _LOG_TEXT );
    // Date
    IntToStr(date, demoText);
    Ltrim(demoText);
    mikrobus_logWrite( demoText, _LOG_TEXT );
    // Month
    mikrobus_logWrite(".", _LOG_TEXT);
    IntToStr(month, demoText);
    Ltrim(demoText);
    mikrobus_logWrite(demoText, _LOG_TEXT);
    // Year
    mikrobus_logWrite(".", _LOG_TEXT);
    IntToStr(year, demoText);
    Ltrim(demoText);
    mikrobus_logWrite(demoText, _LOG_LINE);

    mikrobus_logWrite( "UNIX:  ", _LOG_TEXT );
    LongWordToStr(UNIX_time, demoText);
    Ltrim(demoText);
    mikrobus_logWrite( demoText, _LOG_LINE );

    if((status & 0x04)/4 != 0)
    {
        mikrobus_logWrite( " - Alarm Active!!!", _LOG_LINE );
        Delay_1sec();
        rtc8_writeByte(_RTC8_REG_STATUS, _RTC8_STATUS_REG_CLEAR); // Reset Alarm Flag
    }
    else
    {
        mikrobus_logWrite( " - No Alarm.", _LOG_LINE );
    }
 
    mikrobus_logWrite( "----------------------------------", _LOG_LINE );
    Delay_ms(1000);
}

Other mikroE Libraries used in the example:

• I2C
• UART
• Conversions

Additional notes and informations

Depending on the development board you are using, you may need USB UART click, USB UART 2 click or RS232 click to connect to your PC, for development systems with no UART to USB interface available on the board. The terminal available in all MikroElektronika compilers, or any other terminal application of your choice, can be used to read the message.