ds1307rtc.h File Reference

#include <dev/rtc.h>

Include dependency graph for ds1307rtc.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
int	DS1307Init (NUTRTC *rtc)
	Initialize the interface to an Dallas DS1307 hardware clock.
int	DS1307RtcGetClock (NUTRTC *rtc, struct _tm *tm)
	Get date and time from an DS1307 hardware clock.
int	DS1307RtcSetClock (NUTRTC *rtc, const struct _tm *tm)
	Set the DS1307 hardware clock.
int	DS1307RtcReadRegs (uint8_t addr, uint8_t *buff, size_t len)
	Read RTC registers.
int	DS1307RtcWrite (const uint8_t *buff, size_t len)
	Write to RTC registers.
int	DS1307RamRead (uint8_t addr, uint8_t *buff, size_t cnt)
	Read contents from DS1307 RAM.
int	DS1307RamWrite (uint8_t addr, const void *buff, size_t len)
	Store buffer contents in DS1307 RAM.
Variables
NUTRTC	rtcDs1307

---

Function Documentation

int DS1307Init

(

NUTRTC *

rtc

)

Initialize the interface to an Dallas DS1307 hardware clock.

Returns:

0 on success or -1 in case of an error.

References DS1307RtcReadRegs(), DS1307RtcWrite(), rc, and TwInit.

Here is the call graph for this function:

int DS1307RtcGetClock	(	NUTRTC *	rtc,
		struct _tm *	tm
	)

Get date and time from an DS1307 hardware clock.

Parameters:

tm	Points to a structure that receives the date and time information.

Returns:

0 on success or -1 in case of an error.

References BCD2BIN, DS1307RtcReadRegs(), rc, _tm::tm_hour, _tm::tm_mday, _tm::tm_min, _tm::tm_mon, _tm::tm_sec, _tm::tm_wday, and _tm::tm_year.

Here is the call graph for this function:

int DS1307RtcSetClock	(	NUTRTC *	rtc,
		const struct _tm *	tm
	)

Set the DS1307 hardware clock.

Parameters:

tm	Points to a structure which contains the date and time information.

Returns:

0 on success or -1 in case of an error.

References BIN2BCD, DS1307RtcWrite(), memset(), _tm::tm_hour, _tm::tm_mday, _tm::tm_min, _tm::tm_mon, _tm::tm_sec, _tm::tm_wday, and _tm::tm_year.

Here is the call graph for this function:

int DS1307RtcReadRegs	(	uint8_t	reg,
		uint8_t *	buff,
		size_t	cnt
	)

Read RTC registers.

Parameters:

reg	The first register to read.
buff	Pointer to a buffer that receives the register contents.
cnt	The number of registers to read.

Returns:

0 on success or -1 in case of an error.

References I2C_SLA_RTC, NUT_WAIT_INFINITE, rc, and TwMasterTransact.

Referenced by DS1307Init(), DS1307RamRead(), and DS1307RtcGetClock().

int DS1307RtcWrite	(	const uint8_t *	buff,
		size_t	cnt
	)

Write to RTC registers.

Parameters:

buff	This buffer must contain all bytes to be transfered to the RTC chip, including the register address.
cnt	Number of valid bytes in the buffer.

Returns:

0 on success or -1 in case of an error.

References I2C_SLA_RTC, NUT_WAIT_INFINITE, rc, and TwMasterTransact.

Referenced by DS1307Init(), and DS1307RtcSetClock().

int DS1307RamRead	(	uint8_t	addr,
		uint8_t *	buff,
		size_t	cnt
	)

Read contents from DS1307 RAM.

Parameters:

addr	Start location.
buff	Points to a buffer that receives the contents.
cnt	Number of bytes to read.

Returns:

0 on success or -1 in case of an error.

References DS1307RtcReadRegs(), and rc.

Here is the call graph for this function:

int DS1307RamWrite	(	uint8_t	addr,
		const void *	buff,
		size_t	len
	)

Store buffer contents in DS1307 RAM.

Parameters:

addr	Storage start location.
buff	Points to a buffer that contains the bytes to store.
len	Number of valid bytes in the buffer.

Returns:

0 on success or -1 in case of an error.

References free(), I2C_SLA_RTC, malloc(), memcpy(), NUT_WAIT_INFINITE, rc, and TwMasterTransact.

Here is the call graph for this function:

---

Variable Documentation

NUTRTC rtcDs1307