NetBSD/sys/dev/ic/ds1687reg.h

250 lines
10 KiB
C

/* $NetBSD: ds1687reg.h,v 1.7 2005/02/27 00:27:01 perry Exp $ */
/*
* Copyright (c) 2003 The NetBSD Foundation, Inc.
* All rights reserved.
*
* This code is derived from software contributed to The NetBSD Foundation
* by Rafal K. Boni.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
* 3. All advertising materials mentioning features or use of this software
* must display the following acknowledgement:
* This product includes software developed by the NetBSD
* Foundation, Inc. and its contributors.
* 4. The name of the author may not be used to endorse or promote products
* derived from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
/*
* Originally based on mc146818reg.h, with the following license:
*
* Copyright (c) 1995 Carnegie-Mellon University.
* All rights reserved.
*
* Permission to use, copy, modify and distribute this software and
* its documentation is hereby granted, provided that both the copyright
* notice and this permission notice appear in all copies of the
* software, derivative works or modified versions, and any portions
* thereof, and that both notices appear in supporting documentation.
*
* CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
* CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND
* FOR ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
*
* Carnegie Mellon requests users of this software to return to
*
* Software Distribution Coordinator or Software.Distribution@CS.CMU.EDU
* School of Computer Science
* Carnegie Mellon University
* Pittsburgh PA 15213-3890
*
* any improvements or extensions that they make and grant Carnegie the
* rights to redistribute these changes.
*/
/*
* Definitions for the Dallas Semiconductor DS1687 Real Time Clock.
*
* The DS1687 and follow-on RTC chips are Y2k-compliant successors to the
* DS1287, which in turn is register-compatible with the MC146818 and/or
* MC146818A RTCs.
*
* Plucked right from the Dallas Semicomductor specs available at:
* http://pdfserv.maxim-ic.com/arpdf/DS1685-DS1687.pdf
*
* The DS1686 contains 14 basic clock-related registers and 50 bytes of
* user RAM laid out for compatibility with the register layout of the
* DS1287/MC14818 chips. It also includes an extended mode which allows
* access to these same basic registers as well an an extended register
* set and NVRAM area; this extended register set includes a century
* register for Y2k compliant date storage.
*
* Since the locations of these ports and the method used to access them
* can be machine-dependent, the low-level details of reading and writing
* writing the RTC's registers are handled by machine-specific functions.
*
* The Dallas chip can store time-of-day and alarm data in BCD or binary;
* this setting applies to *all* values stored in the clock chip and a
* change from one mode to the other requires *all* of the clock data to
* be re-written. The "hours" time-of-year and alarm registers can be
* stored either in an AM/PM or a 24-hour format; the format is set
* globally and changing it requires re-writing both the hours time-of-
* year and alarm registers. In AM/PM mode, the hour must be in the
* range of 1-12 (and stored as either BCD or binary), with the high-
* bit cleared to indicate AM and set to indicate PM. In 24-hour mode,
* hours must be in the range 0-23.
*
* In order to support extended features like the century register and
* an embedded silicon serial number while keeping backwards compatibility
* with the DS1287/MC146818, the DS1687 provides a bank-switching method
* which allows the user to switch the RTC between a "compatible" mode in
* bank 0 and an extended mode in bank 1.
*
* Both banks provide access to the 14 timekeeping/alarm registers and
* to 50 bytes of user RAM. In addition, bank 0 provides access to an
* additional 64 bytes of user RAM in the upper half of the RTC address
* space.
*
* Bank 1, on the other hand, provides access to an extended register set,
* including a silicon serial number -- including a model ID byte, century
* register for Y2k compatibility and memory address/data registers which
* allow indirect access to a larger extended user RAM address space. It
* is worth noting that the extended user RAM is distinct from the "basic"
* 114 bytes of user RAM which are accesible in bank 0.
*/
/*
* The registers, and the bits within each register.
*/
#define DS1687_SEC 0x00 /* Time of year: seconds (0-59) */
#define DS1687_ASEC 0x01 /* Alarm: seconds */
#define DS1687_MIN 0x02 /* Time of year: minutes (0-59) */
#define DS1687_AMIN 0x03 /* Alarm: minutes */
#define DS1687_HOUR 0x04 /* Time of year: hour (see above) */
#define DS1687_AHOUR 0x05 /* Alarm: hour (see above) */
#define DS1687_DOW 0x06 /* Time of year: day of week (1-7, 1 = Sun) */
#define DS1687_DOM 0x07 /* Time of year: day of month (1-31) */
#define DS1687_MONTH 0x08 /* Time of year: month (1-12) */
#define DS1687_YEAR 0x09 /* Time of year: year in century (0-99) */
#define DS1687_CONTROLA 0x0a /* Control Register A */
#define DS1687_UIP 0x80 /* Update in progress: RO */
#define DS1687_DV2 0x40 /* Countdown chain: 0 = on, 1 = reset if DV1 */
#define DS1687_DV1 0x20 /* Oscillator enable */
#define DS1687_BANK1 0x10 /* Bank select: 0 = bank0, 1 = bank1 */
#define DS1687_RATEMASK 0x0f /* Rate select bits for sq. wave and PIE */
#define DS1687_CONTROLB 0x0b /* Control Register B */
#define DS1687_SET 0x80 /* Clock update control: 1 = disable update */
#define DS1687_PIE 0x40 /* Periodic interrupt enable */
#define DS1687_AIE 0x20 /* Alarm interrupt enable */
#define DS1687_UIE 0x10 /* Update-ended interrupt enable */
#define DS1687_SQWE 0x08 /* Enable sq. wave output on SQW pin */
#define DS1687_BINARY 0x04 /* Data mode: 0 = BCD, 1 = binary data */
#define DS1687_24HRS 0x02 /* Hour format: 1 = 24hrs, 0 = 12hrs */
#define DS1687_DSE 0x01 /* Daylight savings enable */
#define DS1687_CONTROLC 0x0c /* Control register C: Read-only */
/* Note: PF, AF, UF cleared on read */
#define DS1687_IRQF 0x80 /* IRQ present: set when any IRQ is active */
#define DS1687_PF 0x40 /* Periodic interrupt: independent of PIE */
#define DS1687_AF 0x20 /* Alarm reached: independent of AIE */
#define DS1687_UF 0x10 /* Update ended: independent of UIE */
#define DS1687_CONTROLD 0x0d /* Control register D: Read-only */
#define DS1687_VRT 0x80 /* Valid RAM and time: battery bad if 0 */
#define DS1687_NVRAM_START 0x0e /* Start of user ram: offset 14 */
#define DS1687_NVRAM_SIZE 0x72 /* 114 bytes of user RAM */
#define DS1687_BANK1_START 0x40 /* BANK1: Start of BANK1 registers */
#define DS1687_BANK1_CENTURY 0x48 /* BANK1: Time of yr: Century (0-99) */
#define DS1687_BANK1_ADATE 0x49 /* BANK1: Alarm: Date (1-31) */
#define DS1687_NBASEREGS 0x0d /* 14 registers; CMOS follows */
/* Layout of software shadow copy of TOD registers */
#define DS1687_NHDW_TODREGS 0x0a /* 10 basic TOD registers */
#define DS1687_NSOFT_TODREGS 0x0c /* ...plus shadow CENTURY, ADATE */
#define DS1687_SOFT_SEC 0x00
#define DS1687_SOFT_ASEC 0x01
#define DS1687_SOFT_MIN 0x02
#define DS1687_SOFT_AMIN 0x03
#define DS1687_SOFT_HOUR 0x04
#define DS1687_SOFT_AHOUR 0x05
#define DS1687_SOFT_DOW 0x06
#define DS1687_SOFT_DOM 0x07
#define DS1687_SOFT_MONTH 0x08
#define DS1687_SOFT_YEAR 0x09
#define DS1687_SOFT_CENTURY 0x0a
#define DS1687_SOFT_ADATE 0x0b
/*
* RTC register/NVRAM read and write functions -- machine-dependent.
* Appropriately manipulate RTC registers to get/put data values.
*/
u_int ds1687_read(void *, u_int);
void ds1687_write(void *, u_int, u_int);
/*
* A collection of TOD/Alarm registers.
*/
typedef u_int ds1687_todregs[DS1687_NSOFT_TODREGS];
/*
* Get all of the TOD/Alarm registers
* Must be called at splhigh(), and with the RTC properly set up.
*/
#define DS1687_GETTOD(sc, regs) \
do { \
int i; \
u_int ctl; \
\
/* turn off update for now */ \
ctl = ds1687_read(sc, DS1687_CONTROLB); \
ds1687_write(sc, DS1687_CONTROLB, ctl | DS1687_SET); \
\
/* read all of the tod/alarm regs */ \
for (i = 0; i < DS1687_NHDW_TODREGS; i++) \
(*regs)[i] = ds1687_read(sc, i); \
\
(*regs)[DS1687_SOFT_CENTURY] = \
ds1687_read(sc, DS1687_BANK1_CENTURY); \
(*regs)[DS1687_SOFT_ADATE] = \
ds1687_read(sc, DS1687_BANK1_ADATE); \
\
/* turn update back on */ \
ds1687_write(sc, DS1687_CONTROLB, ctl); \
} while (0);
/*
* Set all of the TOD/Alarm registers
* Must be called at splhigh(), and with the RTC properly set up.
*/
#define DS1687_PUTTOD(sc, regs) \
do { \
int i; \
u_int ctl; \
\
/* turn off update for now */ \
ctl = ds1687_read(sc, DS1687_CONTROLB); \
ds1687_write(sc, DS1687_CONTROLB, ctl | DS1687_SET); \
\
/* write all of the tod/alarm regs */ \
for (i = 0; i < DS1687_NHDW_TODREGS; i++) \
ds1687_write(sc, i, (*regs)[i]); \
\
ds1687_write(sc, DS1687_BANK1_CENTURY, \
(*regs)[DS1687_SOFT_CENTURY]); \
ds1687_write(sc, DS1687_BANK1_ADATE, \
(*regs)[DS1687_SOFT_ADATE]); \
\
/* turn update back on */ \
ds1687_write(sc, DS1687_CONTROLB, ctl); \
} while (0);