Back to home page

LXR

 
 

    


Warning, /bsps/shared/dev/rtc/README.md is written in an unsupported language. File is not indexed.

0001 Real Time Clock
0002 ===============
0003 
0004 + It would be nice to utilize the interrupt capabilities of some
0005   RTC parts.  This could be used to trigger checking the software
0006   clock against the hardware clock.
0007 
0008 + The periodic capability of most RTCs is not suitable for use
0009   as a general purpose flexible clock tick source.  For example,
0010   many RTCs generate only a handful of periods with 100 Hz being the
0011   most frequent. 
0012 
0013 + The tick field is not set on get.  Anything smaller than a second
0014   is ignored on set and get operations.
0015 
0016 + Day of week is ignored since RTEMS does not set it internally.
0017 
0018 + There is no attempt in RTEMS to know about time zones.
0019 
0020 
0021 Harris ICM7170
0022 --------------
0023 
0024 + Tested on a DMV177.
0025 
0026 + Interrupt capabilities are ignored.
0027 
0028 
0029 Mostek 48T08
0030 ------------
0031 
0032 + Untested.
0033 
0034 + NVRAM is ignored.
0035 
0036 
0037 ds1643
0038 ------
0039 The Mostek M48T08 is compatible with the Dallas Semiconductor DS1643.  Please
0040 use that driver.
0041 
0042 
0043 icm7170 Configuration Table Use
0044 --------------------------------
0045 sDeviceName
0046 
0047    The name of this device.
0048 
0049 deviceType
0050 
0051    This field must be RTC_ICM7170.
0052 
0053 pDeviceFns
0054 
0055    The device interface control table.  This must be icm7170_fns.
0056 
0057 deviceProbe
0058 
0059    This is the address of the routine which probes to see if the device
0060    is present.
0061 
0062 pDeviceParams
0063 
0064     This field specifies the clock frequency.  It may be one of the
0065     following:
0066         ICM7170_AT_32_KHZ
0067         ICM7170_AT_1_MHZ
0068         ICM7170_AT_2_MHZ
0069         ICM7170_AT_4_MHZ
0070 
0071 ulCtrlPort1
0072 
0073    This field is the base address of the RTC area of the chip.
0074 
0075 ulCtrlPort2
0076 
0077    This field is ignored.
0078 
0079 ulDataPort
0080 
0081    This field is ignored.
0082 
0083 
0084 getRegister
0085 setRegister
0086 
0087    These follow standard conventions.
0088 
0089 
0090 m48t08 Configuration Table Use
0091 ------------------------------
0092 
0093 sDeviceName
0094 
0095    The name of this device.
0096 
0097 deviceType
0098 
0099    This field must be RTC_M48T08.
0100 
0101 pDeviceFns
0102 
0103    The device interface control table.  This must be m48t08_fns.
0104 
0105 deviceProbe
0106 
0107    This is the address of the routine which probes to see if the device
0108    is present.
0109 
0110 pDeviceParams
0111 
0112     This is ignored and should be NULL.
0113 
0114 ulCtrlPort1
0115 
0116    This field is the base address of the RTC area of the chip.  The
0117    NVRAM portion of the chip is ignored.
0118 
0119 ulCtrlPort2
0120 
0121    This field is ignored.
0122 
0123 ulDataPort
0124 
0125    This field is ignored.
0126 
0127 
0128 getRegister
0129 setRegister
0130 
0131    These follow standard conventions.
0132 
0133 
0134 m48t18
0135 ------
0136 This is supported by the m48t08 driver.
0137 
0138 
0139 mc146818a
0140 ---------
0141 This is supported by the mc146818a driver.