📄 rtc_au1000.c
字号:
/************************************************************************
*
* rtc_au1000.c
*
* The 'RTC' module implements a device driver
* for MC146818A/DS1685/DS1687 compatible RTCs.
*
* IO services are handled the following way :
*
* 1) init serial device: configure and initialize RTC driver
* 2) open serial device: not used
* 3) close serial device: not used
* 4) read serial device: get RTC
* 5) write serial device: set RTC
* 6) ctrl serial device: not used
*
*
* ######################################################################
*
* Copyright (c) 1999-2000 MIPS Technologies, Inc. All rights reserved.
*
* Unpublished rights reserved under the Copyright Laws of the United States of
* America.
*
* This document contains information that is proprietary to MIPS Technologies,
* Inc. ("MIPS Technologies"). Any copying, modifying or use of this information
* (in whole or in part) which is not expressly permitted in writing by MIPS
* Technologies or a contractually-authorized third party is strictly
* prohibited. At a minimum, this information is protected under unfair
* competition laws and the expression of the information contained herein is
* protected under federal copyright laws. Violations thereof may result in
* criminal penalties and fines.
* MIPS Technologies or any contractually-authorized third party reserves the
* right to change the information contained in this document to improve
* function, design or otherwise. MIPS Technologies does not assume any
* liability arising out of the application or use of this information. Any
* license under patent rights or any other intellectual property rights owned
* by MIPS Technologies or third parties shall be conveyed by MIPS Technologies
* or any contractually-authorized third party in a separate license agreement
* between the parties.
* The information contained in this document constitutes one or more of the
* following: commercial computer software, commercial computer software
* documentation or other commercial items. If the user of this information, or
* any related documentation of any kind, including related technical data or
* manuals, is an agency, department, or other entity of the United States
* government ("Government"), the use, duplication, reproduction, release,
* modification, disclosure, or transfer of this information, or any related
* documentation of any kind, is restricted in accordance with Federal
* Acquisition Regulation 12.212 for civilian agencies and Defense Federal
* Acquisition Regulation Supplement 227.7202 for military agencies. The use of
* this information by the Government is further restricted in accordance with
* the terms of the license agreement(s) and/or applicable contract terms and
* conditions covering this information from MIPS Technologies or any
* contractually-authorized third party.
*
************************************************************************/
/************************************************************************
* Include files
************************************************************************/
#include <sysdefs.h>
#include <syserror.h>
#include <sysdev.h>
#include <io_api.h>
#include <syscon_api.h>
#include <rtc_api.h>
#include <pb1000.h>
#include <stdio.h>
/************************************************************************
* Definitions
************************************************************************/
/* Register access */
#define SETREG(reg, data) \
REG32(reg) = (data);
#define GETREG(reg) \
REG32(reg)
/************************************************************************
* Macro Definitions
*************************************************************************/
/************************************************************************
* Public variables
************************************************************************/
/************************************************************************
* Static variables
************************************************************************/
static UINT16 monthdays[13] =
{ 0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334, 365 };
static UINT16 leapyeardays[13] =
{ 0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 335, 366 };
/************************************************************************
* Static function prototypes
************************************************************************/
/************************************************************************
*
* rtc_au1000_init
* Description :
* -------------
* This service initializes the RTC driver.
*
*
* Parameters :
* ------------
*
* 'major', IN, major device number
* 'minor', IN, not used
* 'p_param', INOUT, not used
*
*
* Return values :
* ---------------
*
* 'OK'(=0)
*
*
*
************************************************************************/
static INT32
rtc_au1000_init(
UINT32 major, /* IN: major device number */
UINT32 minor, /* IN: minor device number */
void *p_param ); /* INOUT: device parameter block */
/************************************************************************
*
* rtc_au1000_read
* Description :
* -------------
* This service reads the current value of the Real Time Clock.
*
*
* Parameters :
* ------------
*
* 'major', IN, major device number
* 'minor', IN, minor device number for multi device drivers
* 'p_param', INOUT, RTC variable of type, t_RTC_calendar.
*
*
* Return values :
* ---------------
*
* 'OK'(=0)
*
*
************************************************************************/
static INT32
rtc_au1000_read(
UINT32 major, /* IN: major device number */
UINT32 minor, /* IN: minor device number */
t_RTC_calendar *p_param ); /* INOUT: current RTC value */
/************************************************************************
*
* rtc_au1000_write
* Description :
* -------------
* This service sets the current value of the Real Time Clock.
*
*
* Parameters :
* ------------
*
* 'major', IN, major device number
* 'minor', IN, minor device number for multi device drivers
* 'p_param', INOUT, RTC variable of type, t_RTC_calendar.
*
*
* Return values :
* ---------------
*
* 'OK'(=0)
*
*
************************************************************************/
static INT32
rtc_au1000_write(
UINT32 major, /* IN: major device number */
UINT32 minor, /* IN: minor device number */
t_RTC_calendar *p_param ); /* INOUT: current RTC value */
/************************************************************************
* Implementation : Public functions
************************************************************************/
/************************************************************************
*
* rtc_au1000_install
* Description :
* -------------
*
* Installs the RTC device drivers services in the IO system
* at the reserved device slot, found in the 'sys_dev.h' file,
* which defines all major device numbers.
*
* Note:
* This service is the only public declared interface function; all
* provided device driver services are static declared, but this
* function installs the function pointers in the io-system to
* enable the provided public driver services.
*
* Parameters :
* ------------
*
* None
*
* Return values :
* ---------------
*
* 'OK'(=0)
* 'ERROR_IO_ILLEGAL_MAJOR': Illegal major device number
* 'ERROR_IO_NO_SPACE': Device slot already allocated
*
************************************************************************/
INT32
RTC_install( void )
{
/* pre-initialize local variables and install device services */
return( IO_install( SYS_MAJOR_RTC, /* major device number */
(t_io_service) rtc_au1000_init, /* 'init' service */
NULL, /* 'open' service N/A */
NULL, /* 'close' service N/A */
(t_io_service) rtc_au1000_read, /* 'read' service */
(t_io_service) rtc_au1000_write, /* 'write' service */
NULL ) ); /* 'ctrl' service N/A */
}
/************************************************************************
* Implementation : Static functions
************************************************************************/
/************************************************************************
*
* rtc_au1000_init
* Description :
* -------------
* This service initializes the RTC driver.
*
*
* Parameters :
* ------------
*
* 'major', IN, major device number
* 'minor', IN, not used
* 'p_param', INOUT, not used
*
*
* Return values :
* ---------------
*
* 'OK'(=0)
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -