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.