git.oblomov.eu Git - linux-2.6/blob - drivers/char/ipmi/ipmi_si_sm.h

   1 /*
   2  * ipmi_si_sm.h
   3  *
   4  * State machine interface for low-level IPMI system management
   5  * interface state machines.  This code is the interface between
   6  * the ipmi_smi code (that handles the policy of a KCS, SMIC, or
   7  * BT interface) and the actual low-level state machine.
   8  *
   9  * Author: MontaVista Software, Inc.
  10  *         Corey Minyard <minyard@mvista.com>
  11  *         source@mvista.com
  12  *
  13  * Copyright 2002 MontaVista Software Inc.
  14  *
  15  *  This program is free software; you can redistribute it and/or modify it
  16  *  under the terms of the GNU General Public License as published by the
  17  *  Free Software Foundation; either version 2 of the License, or (at your
  18  *  option) any later version.
  19  *
  20  *
  21  *  THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
  22  *  WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  23  *  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  24  *  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  25  *  INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
  26  *  BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
  27  *  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  28  *  ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
  29  *  TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
  30  *  USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  31  *
  32  *  You should have received a copy of the GNU General Public License along
  33  *  with this program; if not, write to the Free Software Foundation, Inc.,
  34  *  675 Mass Ave, Cambridge, MA 02139, USA.
  35  */
  36
  37 /* This is defined by the state machines themselves, it is an opaque
  38    data type for them to use. */
  39 struct si_sm_data;
  40
  41 /* The structure for doing I/O in the state machine.  The state
  42    machine doesn't have the actual I/O routines, they are done through
  43    this interface. */
  44 struct si_sm_io
  45 {
  46         unsigned char (*inputb)(struct si_sm_io *io, unsigned int offset);
  47         void (*outputb)(struct si_sm_io *io,
  48                         unsigned int  offset,
  49                         unsigned char b);
  50
  51         /* Generic info used by the actual handling routines, the
  52            state machine shouldn't touch these. */
  53         void *info;
  54         void __iomem *addr;
  55         int  regspacing;
  56         int  regsize;
  57         int  regshift;
  58 };
  59
  60 /* Results of SMI events. */
  61 enum si_sm_result
  62 {
  63         SI_SM_CALL_WITHOUT_DELAY, /* Call the driver again immediately */
  64         SI_SM_CALL_WITH_DELAY,  /* Delay some before calling again. */
  65         SI_SM_CALL_WITH_TICK_DELAY,     /* Delay at least 1 tick before calling again. */
  66         SI_SM_TRANSACTION_COMPLETE, /* A transaction is finished. */
  67         SI_SM_IDLE,             /* The SM is in idle state. */
  68         SI_SM_HOSED,            /* The hardware violated the state machine. */
  69         SI_SM_ATTN              /* The hardware is asserting attn and the
  70                                    state machine is idle. */
  71 };
  72
  73 /* Handlers for the SMI state machine. */
  74 struct si_sm_handlers
  75 {
  76         /* Put the version number of the state machine here so the
  77            upper layer can print it. */
  78         char *version;
  79
  80         /* Initialize the data and return the amount of I/O space to
  81            reserve for the space. */
  82         unsigned int (*init_data)(struct si_sm_data *smi,
  83                                   struct si_sm_io   *io);
  84
  85         /* Start a new transaction in the state machine.  This will
  86            return -2 if the state machine is not idle, -1 if the size
  87            is invalid (to large or too small), or 0 if the transaction
  88            is successfully completed. */
  89         int (*start_transaction)(struct si_sm_data *smi,
  90                                  unsigned char *data, unsigned int size);
  91
  92         /* Return the results after the transaction.  This will return
  93            -1 if the buffer is too small, zero if no transaction is
  94            present, or the actual length of the result data. */
  95         int (*get_result)(struct si_sm_data *smi,
  96                           unsigned char *data, unsigned int length);
  97
  98         /* Call this periodically (for a polled interface) or upon
  99            receiving an interrupt (for a interrupt-driven interface).
 100            If interrupt driven, you should probably poll this
 101            periodically when not in idle state.  This should be called
 102            with the time that passed since the last call, if it is
 103            significant.  Time is in microseconds. */
 104         enum si_sm_result (*event)(struct si_sm_data *smi, long time);
 105
 106         /* Attempt to detect an SMI.  Returns 0 on success or nonzero
 107            on failure. */
 108         int (*detect)(struct si_sm_data *smi);
 109
 110         /* The interface is shutting down, so clean it up. */
 111         void (*cleanup)(struct si_sm_data *smi);
 112
 113         /* Return the size of the SMI structure in bytes. */
 114         int (*size)(void);
 115 };
 116
 117 /* Current state machines that we can use. */
 118 extern struct si_sm_handlers kcs_smi_handlers;
 119 extern struct si_sm_handlers smic_smi_handlers;
 120 extern struct si_sm_handlers bt_smi_handlers;
 121