LTlib LaurTec Library
4.0.1
Open Source C Library for Microchip Microcontrollers based on XC8 Compiler
|
#include "MCP7940.h"
Go to the source code of this file.
Functions | |
void | RTCC_initialize (unsigned int baud_rate_KHz) |
signed char | RTCC_set_seconds (unsigned char seconds) |
unsigned char | RTCC_get_seconds (void) |
signed char | RTCC_set_minutes (unsigned char minutes) |
unsigned char | RTCC_get_minutes (void) |
signed char | RTCC_set_hours (unsigned char hours) |
unsigned char | RTCC_get_hours (void) |
unsigned char * | RTCC_get_time_seconds (void) |
unsigned char * | RTCC_get_time (void) |
signed char | RTCC_set_days (unsigned char days) |
unsigned char | RTCC_get_days (void) |
signed char | RTCC_set_months (unsigned char months) |
unsigned char | RTCC_get_months (void) |
signed char | RTCC_set_years (unsigned char years) |
unsigned char | RTCC_get_years (void) |
unsigned char * | RTCC_get_date (void) |
signed char | RTCC_set_seconds_alarm (unsigned char seconds, unsigned char alarm_enable) |
signed char | RTCC_set_minutes_alarm (unsigned char minutes, unsigned char alarm_enable) |
signed char | RTCC_set_hours_alarm (unsigned char hours, unsigned char alarm_enable) |
signed char | RTCC_set_days_alarm (unsigned char days, unsigned char alarm_enable) |
signed char | RTCC_enable_alarm_interrupt (void) |
signed char | RTCC_disable_alarm_interrupt (void) |
unsigned char | RTCC_is_alarm_ON (void) |
signed char | RTCC_increment_minutes (void) |
signed char | RTCC_increment_hours (void) |
signed char | RTCC_increment_years (void) |
signed char | RTCC_increment_months (void) |
signed char | RTCC_increment_days (void) |
signed char RTCC_disable_alarm_interrupt | ( | void | ) |
This function disable the interrupt pin functionality.
Definition at line 392 of file MCP7940.c.
References MCP7940_I2C_read_byte_from_external_device, MCP7940_I2C_write_byte_to_external_device, RTCC_CONFIGURATION_REG_ADDR, and RTCC_WRITE_ADD.
signed char RTCC_enable_alarm_interrupt | ( | void | ) |
This function enables the interrupt pin functionality.
Definition at line 378 of file MCP7940.c.
References MCP7940_I2C_read_byte_from_external_device, MCP7940_I2C_write_byte_to_external_device, RTCC_CONFIGURATION_REG_ADDR, and RTCC_WRITE_ADD.
unsigned char* RTCC_get_date | ( | void | ) |
This function reads the Date from the RTC. The Format DD/MM/YY
Definition at line 272 of file MCP7940.c.
References RTCC_get_days(), RTCC_get_months(), and RTCC_get_years().
unsigned char RTCC_get_days | ( | void | ) |
This function reads the day from the RTC.
Definition at line 214 of file MCP7940.c.
References MCP7940_I2C_read_byte_from_external_device, RTCC_DAYS_ADDR, and RTCC_WRITE_ADD.
unsigned char RTCC_get_hours | ( | void | ) |
This function reads the hours from the RTC.
Definition at line 130 of file MCP7940.c.
References MCP7940_I2C_read_byte_from_external_device, RTCC_HOURS_ADDR, and RTCC_WRITE_ADD.
unsigned char RTCC_get_minutes | ( | void | ) |
This function reads the minutes from the RTC.
Definition at line 107 of file MCP7940.c.
References MCP7940_I2C_read_byte_from_external_device, RTCC_MINUTES_ADDR, and RTCC_WRITE_ADD.
unsigned char RTCC_get_months | ( | void | ) |
This function reads the months from the RTC.
Definition at line 238 of file MCP7940.c.
References MCP7940_I2C_read_byte_from_external_device, RTCC_MONTHS_ADDR, and RTCC_WRITE_ADD.
unsigned char RTCC_get_seconds | ( | void | ) |
This function reads the second from the RTC.
Definition at line 80 of file MCP7940.c.
References MCP7940_I2C_read_byte_from_external_device, RTCC_SECONDS_ADDR, and RTCC_WRITE_ADD.
unsigned char* RTCC_get_time | ( | void | ) |
This function reads the time from the RTC. The format is HH:MM (without seconds)
Definition at line 177 of file MCP7940.c.
References RTCC_get_hours(), and RTCC_get_minutes().
unsigned char* RTCC_get_time_seconds | ( | void | ) |
This function reads the time from the RTC. The format is HH:MM.ss
Definition at line 144 of file MCP7940.c.
References RTCC_get_hours(), RTCC_get_minutes(), and RTCC_get_seconds().
unsigned char RTCC_get_years | ( | void | ) |
This function reads the Year from the RTC.
Definition at line 261 of file MCP7940.c.
References MCP7940_I2C_read_byte_from_external_device, RTCC_WRITE_ADD, and RTCC_YEARS_ADDR.
signed char RTCC_increment_days | ( | void | ) |
This function increments the Days inside the RTCC.
Definition at line 556 of file MCP7940.c.
References RTCC_get_days(), RTCC_MAX_DAYS, and RTCC_set_days().
signed char RTCC_increment_hours | ( | void | ) |
This function increments the hours inside the RTCC.
Definition at line 452 of file MCP7940.c.
References RTCC_get_hours(), RTCC_MAX_HOURS, and RTCC_set_hours().
signed char RTCC_increment_minutes | ( | void | ) |
This function increments the minutes inside the RTCC.
Definition at line 417 of file MCP7940.c.
References RTCC_get_minutes(), RTCC_MAX_MINUTES, and RTCC_set_minutes().
signed char RTCC_increment_months | ( | void | ) |
This function increments the Months inside the RTCC.
Definition at line 522 of file MCP7940.c.
References RTCC_get_months(), RTCC_MAX_MONTHS, and RTCC_set_months().
signed char RTCC_increment_years | ( | void | ) |
This function increments the Years inside the RTCC.
Definition at line 487 of file MCP7940.c.
References RTCC_get_years(), RTCC_MAX_YEARS, and RTCC_set_years().
void RTCC_initialize | ( | unsigned int | baud_rate_KHz | ) |
This function initialize the I2C module accordingly to the clock and baud rate.
baud_rate_KHz | Baud rate expressed in KHz |
Definition at line 60 of file MCP7940.c.
References I2C_MASTER, MCP7940_I2C_baud_rate, and MCP7940_I2C_open.
unsigned char RTCC_is_alarm_ON | ( | void | ) |
signed char RTCC_set_days | ( | unsigned char | days | ) |
This function writes the days in the RTC.
days | Day to be written, as 2 digits BCD format (eg. 12 is 0x12 or 0b00010010). |
Definition at line 205 of file MCP7940.c.
References MCP7940_I2C_write_byte_to_external_device, RTCC_DAYS_ADDR, and RTCC_WRITE_ADD.
signed char RTCC_set_days_alarm | ( | unsigned char | days, |
unsigned char | alarm_enable | ||
) |
This function writes the Days for the alarm, in the RTC.
days | Days to be written, as 2 digits BCD format (eg. 12 is 0x12 or 0b00010010). |
alarmEnable | Enable the alarm or not (for matching) [ENABLE_ON , ENABLE_OFF] |
Definition at line 359 of file MCP7940.c.
References MCP7940_I2C_read_byte_from_external_device, MCP7940_I2C_write_byte_to_external_device, RTCC_ALARM_CONTROL_REG_1_ADDR, RTCC_DAYS_ALARM_ADDR, RTCC_ENABLE_ON, and RTCC_WRITE_ADD.
signed char RTCC_set_hours | ( | unsigned char | hours | ) |
This function writes the hours in the RTC.
hours | Hours to be written, as 2 digits BCD format (eg. 12 is 0x12 or 0b00010010). |
Definition at line 121 of file MCP7940.c.
References MCP7940_I2C_write_byte_to_external_device, RTCC_HOURS_ADDR, and RTCC_WRITE_ADD.
signed char RTCC_set_hours_alarm | ( | unsigned char | hours, |
unsigned char | alarm_enable | ||
) |
This function writes the hours for the alarm, in the RTC.
hours | Hours to be written, as 2 digits BCD format (eg. 12 is 0x12 or 0b00010010). |
alarmEnable | Enable the alarm or not (for matching) [ENABLE_ON , ENABLE_OFF] |
Definition at line 341 of file MCP7940.c.
References MCP7940_I2C_read_byte_from_external_device, MCP7940_I2C_write_byte_to_external_device, RTCC_ALARM_CONTROL_REG_1_ADDR, RTCC_ENABLE_ON, RTCC_HOURS_ALARM_ADDR, and RTCC_WRITE_ADD.
signed char RTCC_set_minutes | ( | unsigned char | minutes | ) |
This function writes the seconds in the RTC.
minutes | Minutes to be written, as 2 digits BCD format (eg. 22 min. is 0x22 or 0b00100010). |
Definition at line 97 of file MCP7940.c.
References MCP7940_I2C_write_byte_to_external_device, RTCC_MINUTES_ADDR, and RTCC_WRITE_ADD.
signed char RTCC_set_minutes_alarm | ( | unsigned char | minutes, |
unsigned char | alarm_enable | ||
) |
This function writes the minutes for the alarm, in the RTC.
minutes | Minutes to be written, as 2 digits BCD format (eg. 12 is 0x12 or 0b00010010). |
alarmEnable | Enable the alarm or not (for matching) [ENABLE_ON , ENABLE_OFF] |
Definition at line 324 of file MCP7940.c.
References MCP7940_I2C_read_byte_from_external_device, MCP7940_I2C_write_byte_to_external_device, RTCC_ALARM_CONTROL_REG_1_ADDR, RTCC_ENABLE_ON, RTCC_MINUTES_ALARM_ADDR, and RTCC_WRITE_ADD.
signed char RTCC_set_months | ( | unsigned char | months | ) |
This function writes the moths in the RTC.
months | Months to be written, as 2 digits BCD format (eg. 12 is 0x12 or 0b00010010). |
Definition at line 228 of file MCP7940.c.
References MCP7940_I2C_write_byte_to_external_device, RTCC_MONTHS_ADDR, and RTCC_WRITE_ADD.
signed char RTCC_set_seconds | ( | unsigned char | seconds | ) |
This function writes the seconds in the RTC.
seconds | Seconds to be written, as 2 digits BCD format (eg. 22 sec. is 0x22 or 0b00100010). |
Definition at line 69 of file MCP7940.c.
References MCP7940_I2C_write_byte_to_external_device, RTCC_SECONDS_ADDR, and RTCC_WRITE_ADD.
signed char RTCC_set_seconds_alarm | ( | unsigned char | seconds, |
unsigned char | alarm_enable | ||
) |
This function writes the seconds for the alarm, in the RTC.
seconds | Seconds to be written, as 2 digits BCD format (eg. 12 is 0x12 or 0b00010010). |
alarmEnable | Enable the alarm or not (for matching) [ENABLE_ON , ENABLE_OFF] |
Definition at line 306 of file MCP7940.c.
References MCP7940_I2C_read_byte_from_external_device, MCP7940_I2C_write_byte_to_external_device, RTCC_ALARM_CONTROL_REG_1_ADDR, RTCC_ENABLE_ON, RTCC_SECONDS_ALARM_ADDR, and RTCC_WRITE_ADD.
signed char RTCC_set_years | ( | unsigned char | years | ) |
This function writes the Year in the RTC.
years | Year to be written, as 2 digits BCD format (eg. 2012 is only 0x12 or 0b00010010). |
Definition at line 252 of file MCP7940.c.
References MCP7940_I2C_write_byte_to_external_device, RTCC_WRITE_ADD, and RTCC_YEARS_ADDR.