Library Description

The library covers all the necessary functions to control RTC 10 click board. A library performs a standard I2C interface communication.

Key functions:

• void rtc10_setTime( uint8_t timeHours, uint8_t timeMinutes, uint8_t timeSeconds ) - Set time hours, minutes and seconds function.
• void rtc10_getTime( uint8_t *timeHours, uint8_t *timeMinutes, uint8_t *timeSeconds ) - Get time hours, minutes and seconds function.
• void rtc10_setDate( uint8_t dayOfTheWeek, uint8_t dateDay, uint8_t dateMonth, uint16_t dateYear ) - Set date hours, minutes and seconds function.

Examples description

The application is composed of three sections :

• System Initialization - Initializes GPIO, I2C and LOG structures, sets INT pin as input and RST pin as output and start to write log.
• Application Initialization - Initialization driver enable's - I2C, hardware reset, set start time and date, enable counting also, write log.
• Application Task - (code snippet) This is an example which demonstrates the use of RTC 10 Click board. RTC 10 Click communicates with register via I2C interface, set time and date, enable counting and display time and date values, also, display temperature value for every 1 sec. Results are being sent to the Usart Terminal where you can track their changes. All data logs write on Usart Terminal changes for every 1 sec.

void applicationTask()
{
    rtc10_getTime( &timeHours, &timeMinutes, &timeSeconds );
    Delay_10ms();

    rtc10_getDate( &dayOfTheWeek, &dateDay, &dateMonth, &dateYear );
    Delay_10ms();

    if ( secFlag !=  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( " Date: ", _LOG_TEXT );

        displayLogUart( dateDay );
        mikrobus_logWrite( ".", _LOG_TEXT );

        displayLogUart( dateMonth );
        mikrobus_logWrite( ".", _LOG_TEXT );

        mikrobus_logWrite( "20", _LOG_TEXT );

        displayLogUart( dateYear );
        mikrobus_logWrite( ".", _LOG_LINE );
        
        displayDayOfTheWeek( dayOfTheWeek );
        
        if ( timeSeconds == 0 )
        {
            temperature = rtc10_getTemperature();

            mikrobus_logWrite( " Temp.: ", _LOG_TEXT );
            FloatToStr( temperature, logText );
            ltrim( logText );
            rtrim( logText );
            mikrobus_logWrite( logText, _LOG_TEXT );
            mikrobus_logWrite( degCel, _LOG_LINE );
        }

        mikrobus_logWrite( "-------------------", _LOG_LINE );

        secFlag =  timeSeconds;
    }
}

Additional Functions :

• void displayLogDayOfTheWeek( uint8_t dayOfTheWeek ) - Write day of the week log on USART terminal.
• 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 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.