3 * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
5 * SPDX-License-Identifier: GPL-2.0+
9 * Generic RTC interface.
14 /* bcd<->bin functions are needed by almost all the RTC drivers, let's include
15 * it there instead of in evey single driver */
20 * The struct used to pass data from the generic interface code to
21 * the hardware dependend low-level code ande vice versa. Identical
22 * to struct rtc_time used by the Linux kernel.
24 * Note that there are small but significant differences to the
25 * common "struct time":
27 * struct time: struct rtc_time:
28 * tm_mon 0 ... 11 1 ... 12
29 * tm_year years since 1900 years since 0
44 int rtc_get (struct rtc_time *);
45 int rtc_set (struct rtc_time *);
46 void rtc_reset (void);
48 void to_tm (int, struct rtc_time *);
49 unsigned long mktime (unsigned int, unsigned int, unsigned int,
50 unsigned int, unsigned int, unsigned int);
53 * rtc_read8() - Read an 8-bit register
55 * @reg: Register to read
58 int rtc_read8(int reg);
61 * rtc_write8() - Write an 8-bit register
63 * @reg: Register to write
64 * @value: Value to write
66 void rtc_write8(int reg, uchar val);
69 * rtc_read32() - Read a 32-bit value from the RTC
71 * @reg: Offset to start reading from
74 u32 rtc_read32(int reg);
77 * rtc_write32() - Write a 32-bit value to the RTC
79 * @reg: Register to start writing to
80 * @value: Value to write
82 void rtc_write32(int reg, u32 value);
85 * rtc_init() - Set up the real time clock ready for use
90 * rtc_calc_weekday() - Work out the weekday from a time
92 * This only works for the Gregorian calendar - i.e. after 1752 (in the UK).
93 * It sets time->tm_wdaay to the correct day of the week.
95 * @time: Time to inspect. tm_wday is updated
96 * @return 0 if OK, -EINVAL if the weekday could not be determined
98 int rtc_calc_weekday(struct rtc_time *time);