RTEMS 4.6.1 On-Line Library

Real-Time Clock Driver Introduction

BSP and Device Driver Development Guide

11.1: Introduction

The Real-Time Clock (RTC) driver is responsible for providing an interface to an RTC device. [NOTE: In this chapter, the abbreviation TOD is used for Time of Day.] The capabilities provided by this driver are:

Set the RTC TOD to RTEMS TOD
Set the RTEMS TOD to the RTC TOD
Get the RTC TOD
Set the RTC TOD to the Specified TOD
Get the Difference Between the RTEMS and RTC TOD

The reference implementation for a real-time clock driver can be found in c/src/lib/libbsp/shared/tod.c. This driver is based on the libchip concept and can be easily configured to work with any of the RTC chips supported by the RTC chip drivers in the directory c/src/lib/lib/libchip/rtc. There is a README file in this directory for each supported RTC chip. Each of these README explains how to configure the shared libchip implementation of the RTC driver for that particular RTC chip.

The DY-4 DMV177 BSP uses the shared libchip implementation of the RTC driver. Its RTC_Table configuration table can be found in c/src/lib/libbsp/powerpc/dmv177/tod/config.c.

BSP and Device Driver Development Guide