Library Description

The library covers all the necessary functions to control RTC Click board.
RTC Click communicates with the target board via I2C protocol. 
This library contains drivers for write and read data from PCF8583 chip, functions for sets time and date, gets time and date, enable and disable counting, for enable and disable alarms, for sets time and date alarms, etc. 

Key functions:

• void rtc_setTime( uint8_t timeHours, uint8_t timeMinutes, uint8_t timeSeconds, uint8_t timeHunSec ) - Set time hours, minutes, seconds and hundredth of a seconds function.

• void rtc_getTime( uint8_t *timeHours, uint8_t *timeMinutes, uint8_t *timeSeconds, uint8_t *timeHunSec ) - Get time hours, minutes, seconds and hundredth of a seconds function.

Examples description

The application is composed of the three sections :

• System Initialization - Initializes GPIO, I2C and LOG structures, set INT pin as input.
• Application Initialization - Initialization driver enable's - I2C,
       set start time, enable counting and start write log.
• Application Task - (code snippet) This is a example which demonstrates the use of RTC Click board.
       RTC Click communicates with register via I2C by write to register and read from register.
       This is an example of how time is displayed when the value of timeSeconds is changed.
       Results are being sent to the Usart Terminal where you can track their changes.
       All data logs write on usb uart changes for every 1 sec.

void applicationTask()
{   
    rtc_getTime( &timeHours, &timeMinutes, &timeSeconds, &timeHunSec );

    if ( timeSecondsNew != timeSeconds )
    {
        mikrobus_logWrite( " Time : ", _LOG_TEXT );
        displayLogUart( timeHours );
        mikrobus_logWrite( ":", _LOG_TEXT );
       
        displayLogUart( timeMinutes );
        mikrobus_logWrite( ":", _LOG_TEXT );
  
        displayLogUart( timeSeconds );
        mikrobus_logWrite( "", _LOG_LINE );
        mikrobus_logWrite( "------------------", _LOG_LINE );

        timeSecondsNew = timeSeconds; 
    } 
    Delay_1ms();
}

Additional Functions :

• void displayLogUart( uint8_t value ) - Write the value of time or date as a two-digit number.

Other mikroE Libraries used in the example:

• I2C
• UART
• Conversions

Additional notes and information

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.