/*
 *  This file contains the definitions for the following real-time clocks:
 *
 *    + Harris Semiconduction ICM7170
 *
 *  COPYRIGHT (c) 1989-1999.
 *  On-Line Applications Research Corporation (OAR).
 *
 *  The license and distribution terms for this file may be
 *  found in the file LICENSE in this distribution or at
 *  http://www.rtems.com/license/LICENSE.
 *
 *  $Id$
 */

#ifndef __LIBCHIP_ICM7170_h
#define __LIBCHIP_ICM7170_h

/*
 *  Register indices
 */

#define ICM7170_CONTROL             0x11


#define ICM7170_COUNTER_HUNDREDTHS  0x00
#define ICM7170_HOUR                0x01
#define ICM7170_MINUTE              0x02
#define ICM7170_SECOND              0x03
#define ICM7170_MONTH               0x04
#define ICM7170_DATE                0x05
#define ICM7170_YEAR                0x06
#define ICM7170_DAY_OF_WEEK         0x07

/*
 *  Configuration information in the parameters field
 */

#define ICM7170_AT_32_KHZ  0x00
#define ICM7170_AT_1_MHZ   0x01
#define ICM7170_AT_2_MHZ   0x02
#define ICM7170_AT_4_MHZ   0x03

/*
 *  Driver function table
 */

extern rtc_fns icm7170_fns;

/*
 * Default register access routines
 */

uint32_t   icm7170_get_register(    /* registers are at 1 byte boundaries */
  uint32_t    ulCtrlPort,           /*   and accessed as bytes            */
  uint8_t     ucRegNum
);

void  icm7170_set_register(
  uint32_t    ulCtrlPort,
  uint8_t     ucRegNum,
  uint32_t    ucData
);

uint32_t   icm7170_get_register_2(  /* registers are at 2 byte boundaries */
  uint32_t    ulCtrlPort,           /*   and accessed as bytes            */
  uint8_t     ucRegNum
);

void  icm7170_set_register_2(
  uint32_t    ulCtrlPort,
  uint8_t     ucRegNum,
  uint32_t    ucData
);

uint32_t   icm7170_get_register_4(  /* registers are at 4 byte boundaries */
  uint32_t    ulCtrlPort,           /*   and accessed as bytes            */
  uint8_t     ucRegNum
);

void  icm7170_set_register_4(
  uint32_t    ulCtrlPort,
  uint8_t     ucRegNum,
  uint32_t    ucData
);

uint32_t   icm7170_get_register_8(  /* registers are at 8 byte boundaries */
  uint32_t    ulCtrlPort,           /*   and accessed as bytes            */
  uint8_t     ucRegNum
);

void  icm7170_set_register_8(
  uint32_t    ulCtrlPort,
  uint8_t     ucRegNum,
  uint32_t    ucData
);

#endif
/* end of include file */
