Library Description

The library covers all the necessary functions that enables the usage of the RTC 11 Click board. User can set or read time, date, day of the week, alarm, change settings, or use generic read and write functions.

Key functions:

• void rtc11_set_time ( uint8_t t_hrs, uint8_t t_min, uint8_t t_sec ); - Function is used to set system time.
• void rtc11_get_time ( uint8_t *t_hrs, uint8_t *t_min, uint8_t *t_sec ); - Function is used to get current system time.
• void rtc11_get_date ( uint8_t *w_day, uint8_t *d_day, uint8_t *d_mon, uint8_t *d_yrs ); - Function is used to get system date.

Examples description

The application is composed of three sections :

• System Initialization - Initializes GPIO, SPI and LOG structures, sets INT and PWM pins as input, and AN, RST and CS pins as output, and start to write log.
• Application Initialization - Initalizes SPI, performs software reset, sets system time and date, and starts clocking system.
• Application Task - Demonstrates use of RTC 11 click board by reading and displaying time and date via USART terminal.

void application_task ( )
{
    rtc11_get_time ( &t_hrs, &t_min, &t_sec );
    Delay_ms( 10 );
    rtc11_get_date ( &w_day, &d_day, &d_mon, &d_yrs );
    Delay_ms( 10 );
    if ( sec_flag != t_sec )
    {
        mikrobus_logWrite( " Time: ", _LOG_TEXT );
        ByteToStr( t_hrs, log_txt );
        ltrim( log_txt );
        mikrobus_logWrite( log_txt, _LOG_TEXT );
        mikrobus_logWrite( ":", _LOG_TEXT );
        ByteToStr( t_min, log_txt );
        ltrim( log_txt );
        mikrobus_logWrite( log_txt, _LOG_TEXT );
        mikrobus_logWrite( ":", _LOG_TEXT );
        ByteToStr( t_sec, log_txt );
        ltrim( log_txt );
        mikrobus_logWrite( log_txt, _LOG_TEXT );
        mikrobus_logWrite( "", _LOG_LINE );
        mikrobus_logWrite( " Date: ", _LOG_TEXT );
        disp_day_of_the_week( w_day );
        mikrobus_logWrite( "/", _LOG_TEXT );
        ByteToStr( d_day, log_txt );
        ltrim( log_txt );
        mikrobus_logWrite( log_txt, _LOG_TEXT );
        mikrobus_logWrite( "/", _LOG_TEXT );
        ByteToStr( d_mon, log_txt );
        ltrim( log_txt );
        mikrobus_logWrite( log_txt, _LOG_TEXT );
        mikrobus_logWrite( "/", _LOG_TEXT );
        ByteToStr( d_yrs, log_txt );
        ltrim( log_txt );
        mikrobus_logWrite( "20", _LOG_TEXT );
        mikrobus_logWrite( log_txt, _LOG_TEXT );
        mikrobus_logWrite( "/", _LOG_TEXT );
        mikrobus_logWrite( "", _LOG_LINE );
    }
    sec_flag =  t_sec;
}

Additional Function :

• void disp_day_of_the_week ( uint8_t w_day ) - Writes the day of the week on USART terminal.

Other mikroE Libraries used in the example:

• SPI
• 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.