Library Description

The library contains basic functions for working with RTC 9 click. The user is enabled to adjust and read the time and date. it also has the ability to set alarms.

Key functions:

• void rtc9_set_time( uint8_t hour, uint8_t min, uint8_t sec ) - Set new time - 24 hour format.
• void rtc9_set_date ( uint8_t day, uint8_t day_of_week, uint8_t month, uint8_t year ) - Set new date.
• void rtc9_wakeup ( void ) - Wake-up process.

Examples description

The application is composed of three sections :

• System Initialization - Initializes the I2C module and all necessary gpio pins.
• Application Initialization - Starts waking the chip and sets the start time and date.
• Application Task - It reads current time and date and logs to usb uart every 1000 ms.

void application_init ( )
{
    rtc9_i2c_driver_init
    ( 
        ( rtc9_obj_t )&_MIKROBUS1_GPIO, 
        ( rtc9_obj_t )&_MIKROBUS1_I2C, 
        RTC9_SLAVE_ADDRESS
    );
    Delay_ms( 500 );

    rtc9_wakeup( );

    rtc9_set_time( 12, 15, 45 );
    rtc9_set_date ( 20, RTC9_DAY_FRIDAY, RTC9_MONTH_MARCH, 20 );
}

void application_task ( )
{
    time_process( );
    date_process( );
    mikrobus_logWrite( "----------------------------------------", _LOG_LINE );
    Delay_ms( 1000 );
}

Additional Functions :

• time_process ( ) - Reads and displays current time
• date_process ( ) - Reads and displays current date

Other mikroE Libraries used in the example:

• I2C
• UART

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.