util/nvramtool/cmos_lowlevel.h

   1 /*****************************************************************************\
   2  * cmos_lowlevel.h
   3  *****************************************************************************
   4  *  Copyright (C) 2002-2005 The Regents of the University of California.
   5  *  Produced at the Lawrence Livermore National Laboratory.
   6  *  Written by David S. Peterson <dsp@llnl.gov> <dave_peterson@pobox.com>.
   7  *  UCRL-CODE-2003-012
   8  *  All rights reserved.
   9  *
  10  *  This file is part of nvramtool, a utility for reading/writing coreboot
  11  *  parameters and displaying information from the coreboot table.
  12  *  For details, see http://coreboot.org/nvramtool.
  13  *
  14  *  Please also read the file DISCLAIMER which is included in this software
  15  *  distribution.
  16  *
  17  *  This program is free software; you can redistribute it and/or modify it
  18  *  under the terms of the GNU General Public License (as published by the
  19  *  Free Software Foundation) version 2, dated June 1991.
  20  *
  21  *  This program is distributed in the hope that it will be useful, but
  22  *  WITHOUT ANY WARRANTY; without even the IMPLIED WARRANTY OF
  23  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the terms and
  24  *  conditions of the GNU General Public License for more details.
  25  *
  26  *  You should have received a copy of the GNU General Public License along
  27  *  with this program; if not, write to the Free Software Foundation, Inc.,
  28  *  51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  29 \*****************************************************************************/
  30
  31 #ifndef NVRAMTOOL_CMOS_LOWLEVEL_H
  32 #define NVRAMTOOL_CMOS_LOWLEVEL_H
  33
  34 #include "common.h"
  35 #include "layout.h"
  36
  37 typedef struct {
  38         void (*init)(void* data);
  39         unsigned char (*read)(unsigned addr);
  40         void (*write)(unsigned addr, unsigned char value);
  41         void (*set_iopl)(int level);
  42 } cmos_access_t;
  43
  44 typedef enum { HAL_CMOS, HAL_MEMORY } hal_t;
  45 void select_hal(hal_t hal, void *data);
  46
  47 #define CMOS_AREA_OUT_OF_RANGE (CMOS_RESULT_START + 0)
  48 #define CMOS_AREA_OVERLAPS_RTC (CMOS_RESULT_START + 1)
  49 #define CMOS_AREA_TOO_WIDE (CMOS_RESULT_START + 2)
  50
  51 unsigned long long cmos_read(const cmos_entry_t * e);
  52 void cmos_write(const cmos_entry_t * e, unsigned long long value);
  53 unsigned char cmos_read_byte(unsigned index);
  54 void cmos_write_byte(unsigned index, unsigned char value);
  55 void cmos_read_all(unsigned char data[]);
  56 void cmos_write_all(unsigned char data[]);
  57 void set_iopl(int level);
  58 int verify_cmos_op(unsigned bit, unsigned length, cmos_entry_config_t config);
  59
  60 #define CMOS_SIZE 256           /* size of CMOS memory in bytes */
  61 #define CMOS_RTC_AREA_SIZE 14   /* first 14 bytes control real time clock */
  62
  63 /****************************************************************************
  64  * verify_cmos_byte_index
  65  *
  66  * Return 1 if 'index' does NOT specify a valid CMOS memory location.  Else
  67  * return 0.
  68  ****************************************************************************/
  69 static inline int verify_cmos_byte_index(unsigned index)
  70 {
  71         return (index < CMOS_RTC_AREA_SIZE) || (index >= CMOS_SIZE);
  72 }
  73
  74 #endif                          /* NVRAMTOOL_CMOS_LOWLEVEL_H */