DS1307 Class Reference

C++ API for the DS1307 Real Time CLock. More...

Detailed Description

• ID: ds1307
• Name: Grove RTC (Real Time Clock)
• Other Names: DS1307
• Category: time
• Manufacturer: seeed
• Connection: i2c

UPM module for the DS1307 based RTC. The clock can provide information about the seconds, minutes, hours, day of the week, day of the month, month, and year. It can operate in either 24-hour or 12-hour format. This device can also output a square wave at 1Khz, 4Khz, 8Khz, and 32Khz. However, this capability is not implemented in this module.

  // Instantiate a DS1037 on I2C bus 0
  upm::DS1307 *rtc = new upm::DS1307(0);
  
  // always do this first
  cout << "Loading the current time... " << endl;
  if (!rtc->loadTime())
    {
      cerr << "rtc->loadTime() failed." << endl;
      return 0;
    }
  
  printTime(rtc);

  // set the year as an example
  cout << "setting the year to 50" << endl;
  rtc->year = 50;

  rtc->setTime();

  // reload the time and print it
  rtc->loadTime();
  printTime(rtc);

Public Member Functions
	DS1307 (int bus)
	~DS1307 ()
bool	loadTime ()
bool	setTime ()
mraa_result_t	enableClock ()
mraa_result_t	disableClock ()
mraa_result_t	writeBytes (uint8_t reg, uint8_t *buffer, unsigned int len)
uint8_t	readBytes (uint8_t reg, uint8_t *buffer, unsigned int len)
unsigned int	bcdToDec (uint8_t val)
uint8_t	decToBcd (unsigned int val)

Data Fields
unsigned int	seconds
unsigned int	minutes
unsigned int	hours
unsigned int	dayOfWeek
unsigned int	dayOfMonth
unsigned int	month
unsigned int	year
bool	amPmMode
bool	pm

Constructor & Destructor Documentation

DS1307

(

int

bus

)

ds1307 Real Time Clock constructor

Parameters

bus	i2c bus to use

~DS1307

(

)

DS1307 Destructor

Member Function Documentation

bool loadTime

(

)

Load all of the time values

Returns

True if time data loaded successfully

bool setTime

(

)

Set the time. You should call loadTime() beforehand to maintain consistency

Returns

True if time saved successfully

mraa_result_t enableClock

(

)

Enable the oscillator on the clock.

Returns

0 (MRAA_SUCCESS) if successful; non-zero otherwise

mraa_result_t disableClock

(

)

Disable the oscillator on the clock. This will prevent the clock from updating any time/date values

Returns

0 (MRAA_SUCCESS) if successful; non-zero otherwise

mraa_result_t writeBytes	(	uint8_t	reg,
		uint8_t *	buffer,
		unsigned int	len
	)

Write value(s) into registers

Parameters

reg	register location to start writing into
buffer	buffer for data storage
len	number of bytes to write

Returns

0 (MRAA_SUCCESS) if successful; non-zero otherwise

uint8_t readBytes	(	uint8_t	reg,
		uint8_t *	buffer,
		unsigned int	len
	)

Read value(s) from registers

Parameters

reg	register location to start reading from
buffer	buffer for data storage
len	number of bytes to read

Returns

number of bytes read

unsigned int bcdToDec

(

uint8_t

val

)

Convert a BCD value into decimal

Parameters

val	BCD value to convert

Returns

the converted value in decimal

uint8_t decToBcd

(

unsigned int

val

)

Convert a decimal value into BCD

Parameters

val	decimal value to convert

Returns

the converted value in BCD

Field Documentation

unsigned int seconds

holds the seconds

unsigned int minutes

holds the minutes

unsigned int hours

holds the hours, 1-12 in am/pm mode, 0-23 otherwise

unsigned int dayOfWeek

holds the day of the week, 1-7 where 1 is Sunday

unsigned int dayOfMonth

holds the day of the month, 1-31

unsigned int month

holds the month, 1-12

unsigned int year

holds the year, 0-99

bool amPmMode

True if in AM/PM mode, false if 24h format.

bool pm

If in AmPmMode (12-hr), then this is true if it's PM, clear if AM

---

The documentation for this class was generated from the following files:

• /var/lib/jenkins/workspace/upm-doc-stable/src/ds1307/ds1307.h
• /var/lib/jenkins/workspace/upm-doc-stable/src/ds1307/ds1307.cxx