109 lines
3.9 KiB
C
109 lines
3.9 KiB
C
/*-
|
|
* SPDX-License-Identifier: BSD-2-Clause-FreeBSD
|
|
*
|
|
* Copyright (C) 2006-2008 Semihalf, Grzegorz Bernacki
|
|
* All rights reserved.
|
|
*
|
|
* 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.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``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 AUTHOR OR CONTRIBUTORS 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.
|
|
*
|
|
* $FreeBSD$
|
|
*/
|
|
|
|
#ifndef _DEV_RTC_DS1553_H_
|
|
#define _DEV_RTC_DS1553_H_
|
|
|
|
/* DS1553 registers */
|
|
#define DS1553_NVRAM_SIZE 0x1ff0
|
|
#define DS1553_OFF_FLAGS 0x1ff0
|
|
#define DS1553_OFF_ALARM_SECONDS 0x1ff2
|
|
#define DS1553_OFF_ALARM_MINUTES 0x1ff3
|
|
#define DS1553_OFF_ALARM_HOURS 0x1ff4
|
|
#define DS1553_OFF_ALARM_DATE 0x1ff5
|
|
#define DS1553_OFF_INTERRUPTS 0x1ff6
|
|
#define DS1553_OFF_WATCHDOG 0x1ff7
|
|
#define DS1553_OFF_CONTROL 0x1ff8
|
|
#define DS1553_OFF_SECONDS 0x1ff9
|
|
#define DS1553_OFF_MINUTES 0x1ffa
|
|
#define DS1553_OFF_HOURS 0x1ffb
|
|
#define DS1553_OFF_DAYOFWEEK 0x1ffc
|
|
#define DS1553_OFF_DATE 0x1ffd
|
|
#define DS1553_OFF_MONTH 0x1ffe
|
|
#define DS1553_OFF_YEAR 0x1fff
|
|
|
|
/* dayofweek register's bits */
|
|
#define DS1553_BIT_FREQ_TEST 0x40 /* frequency test bit */
|
|
|
|
/* seconds register's bit */
|
|
#define DS1553_BIT_OSC 0x80 /* oscillator start/stop bit */
|
|
|
|
/* control register's bits */
|
|
#define DS1553_BIT_WRITE 0x80 /* write */
|
|
#define DS1553_BIT_READ 0x40 /* read */
|
|
|
|
/* watchdog register's bits */
|
|
#define DS1553_BIT_WATCHDOG 0x80 /* watchdog steering bit */
|
|
#define DS1553_BIT_BMB4 0x40 /* watchdog multiplier bit4 */
|
|
#define DS1553_BIT_BMB3 0x20 /* watchdog multiplier bit3 */
|
|
#define DS1553_BIT_BMB2 0x10 /* watchdog multiplier bit2 */
|
|
#define DS1553_BIT_BMB1 0x8 /* watchdog multiplier bit1 */
|
|
#define DS1553_BIT_BMB0 0x4 /* watchdog multiplier bit0 */
|
|
#define DS1553_BIT_RB1 0x2 /* watchdog resolution bit1 */
|
|
#define DS1553_BIT_RB0 0x1 /* watchdog resolution bit0 */
|
|
|
|
/* alarm seconds/minutes/hours/date register's bit */
|
|
#define DS1553_BIT_AM 0x80 /* alarm mask bit */
|
|
|
|
/* flag register's bits */
|
|
#define DS1553_BIT_BLF 0x10 /* battery flag */
|
|
#define DS1553_BIT_WF 0x80 /* watchdog flag */
|
|
|
|
/* register's mask */
|
|
#define DS1553_MASK_MONTH 0x1f
|
|
#define DS1553_MASK_DATE 0x3f
|
|
#define DS1553_MASK_DAYOFWEEK 0x7
|
|
#define DS1553_MASK_HOUR 0x3f
|
|
#define DS1553_MASK_MINUTES 0x7f
|
|
#define DS1553_MASK_SECONDS 0x7f
|
|
|
|
struct ds1553_softc {
|
|
bus_space_tag_t sc_bst; /* bus space tag */
|
|
bus_space_handle_t sc_bsh; /* bus space handle */
|
|
|
|
int rid; /* resource id */
|
|
struct resource *res;
|
|
struct mtx sc_mtx; /* hardware mutex */
|
|
|
|
uint32_t year_offset;
|
|
/* read/write functions */
|
|
uint8_t (*sc_read)(device_t, bus_size_t);
|
|
void (*sc_write)(device_t, bus_size_t, uint8_t);
|
|
};
|
|
|
|
/* device interface */
|
|
int ds1553_attach(device_t);
|
|
|
|
/* clock interface */
|
|
int ds1553_gettime(device_t, struct timespec *);
|
|
int ds1553_settime(device_t, struct timespec *);
|
|
|
|
#endif /* _DEV_RTC_DS1553_H_ */
|