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 #define CMOS_AREA_OUT_OF_RANGE (CMOS_RESULT_START + 0)
  38 #define CMOS_AREA_OVERLAPS_RTC (CMOS_RESULT_START + 1)
  39 #define CMOS_AREA_TOO_WIDE (CMOS_RESULT_START + 2)
  40
  41 unsigned long long cmos_read(const cmos_entry_t * e);
  42 void cmos_write(const cmos_entry_t * e, unsigned long long value);
  43 unsigned char cmos_read_byte(unsigned index);
  44 void cmos_write_byte(unsigned index, unsigned char value);
  45 void cmos_read_all(unsigned char data[]);
  46 void cmos_write_all(unsigned char data[]);
  47 void set_iopl(int level);
  48 int verify_cmos_op(unsigned bit, unsigned length, cmos_entry_config_t config);
  49
  50 #define CMOS_SIZE 256           /* size of CMOS memory in bytes */
  51 #define CMOS_RTC_AREA_SIZE 14   /* first 14 bytes control real time clock */
  52
  53 /****************************************************************************
  54  * verify_cmos_byte_index
  55  *
  56  * Return 1 if 'index' does NOT specify a valid CMOS memory location.  Else
  57  * return 0.
  58  ****************************************************************************/
  59 static inline int verify_cmos_byte_index(unsigned index)
  60 {
  61         return (index < CMOS_RTC_AREA_SIZE) || (index >= CMOS_SIZE);
  62 }
  63
  64 #endif                          /* NVRAMTOOL_CMOS_LOWLEVEL_H */