include/asm-ia64/sn/klconfig.h

   1 /*
   2  * This file is subject to the terms and conditions of the GNU General Public
   3  * License.  See the file "COPYING" in the main directory of this archive
   4  * for more details.
   5  *
   6  * Derived from IRIX <sys/SN/klconfig.h>.
   7  *
   8  * Copyright (C) 1992-1997,1999,2001-2004 Silicon Graphics, Inc.  All Rights Reserved.
   9  * Copyright (C) 1999 by Ralf Baechle
  10  */
  11 #ifndef _ASM_IA64_SN_KLCONFIG_H
  12 #define _ASM_IA64_SN_KLCONFIG_H
  13
  14 /*
  15  * The KLCONFIG structures store info about the various BOARDs found
  16  * during Hardware Discovery. In addition, it stores info about the
  17  * components found on the BOARDs.
  18  */
  19
  20 typedef s32 klconf_off_t;
  21
  22
  23 /* Functions/macros needed to use this structure */
  24
  25 typedef struct kl_config_hdr {
  26         char            pad[20];
  27         klconf_off_t    ch_board_info;  /* the link list of boards */
  28         char            pad0[88];
  29 } kl_config_hdr_t;
  30
  31
  32 #define NODE_OFFSET_TO_LBOARD(nasid,off)        (lboard_t*)(GLOBAL_CAC_ADDR((nasid), (off)))
  33
  34 /*
  35  * The KLCONFIG area is organized as a LINKED LIST of BOARDs. A BOARD
  36  * can be either 'LOCAL' or 'REMOTE'. LOCAL means it is attached to
  37  * the LOCAL/current NODE. REMOTE means it is attached to a different
  38  * node.(TBD - Need a way to treat ROUTER boards.)
  39  *
  40  * There are 2 different structures to represent these boards -
  41  * lboard - Local board, rboard - remote board. These 2 structures
  42  * can be arbitrarily mixed in the LINKED LIST of BOARDs. (Refer
  43  * Figure below). The first byte of the rboard or lboard structure
  44  * is used to find out its type - no unions are used.
  45  * If it is a lboard, then the config info of this board will be found
  46  * on the local node. (LOCAL NODE BASE + offset value gives pointer to
  47  * the structure.
  48  * If it is a rboard, the local structure contains the node number
  49  * and the offset of the beginning of the LINKED LIST on the remote node.
  50  * The details of the hardware on a remote node can be built locally,
  51  * if required, by reading the LINKED LIST on the remote node and
  52  * ignoring all the rboards on that node.
  53  *
  54  * The local node uses the REMOTE NODE NUMBER + OFFSET to point to the
  55  * First board info on the remote node. The remote node list is
  56  * traversed as the local list, using the REMOTE BASE ADDRESS and not
  57  * the local base address and ignoring all rboard values.
  58  *
  59  *
  60  KLCONFIG
  61
  62  +------------+      +------------+      +------------+      +------------+
  63  |  lboard    |  +-->|   lboard   |  +-->|   rboard   |  +-->|   lboard   |
  64  +------------+  |   +------------+  |   +------------+  |   +------------+
  65  | board info |  |   | board info |  |   |errinfo,bptr|  |   | board info |
  66  +------------+  |   +------------+  |   +------------+  |   +------------+
  67  | offset     |--+   |  offset    |--+   |  offset    |--+   |offset=NULL |
  68  +------------+      +------------+      +------------+      +------------+
  69
  70
  71  +------------+
  72  | board info |
  73  +------------+       +--------------------------------+
  74  | compt 1    |------>| type, rev, diaginfo, size ...  |  (CPU)
  75  +------------+       +--------------------------------+
  76  | compt 2    |--+
  77  +------------+  |    +--------------------------------+
  78  |  ...       |  +--->| type, rev, diaginfo, size ...  |  (MEM_BANK)
  79  +------------+       +--------------------------------+
  80  | errinfo    |--+
  81  +------------+  |    +--------------------------------+
  82                  +--->|r/l brd errinfo,compt err flags |
  83                       +--------------------------------+
  84
  85  *
  86  * Each BOARD consists of COMPONENTs and the BOARD structure has
  87  * pointers (offsets) to its COMPONENT structure.
  88  * The COMPONENT structure has version info, size and speed info, revision,
  89  * error info and the NIC info. This structure can accommodate any
  90  * BOARD with arbitrary COMPONENT composition.
  91  *
  92  * The ERRORINFO part of each BOARD has error information
  93  * that describes errors about the BOARD itself. It also has flags to
  94  * indicate the COMPONENT(s) on the board that have errors. The error
  95  * information specific to the COMPONENT is present in the respective
  96  * COMPONENT structure.
  97  *
  98  * The ERRORINFO structure is also treated like a COMPONENT, ie. the
  99  * BOARD has pointers(offset) to the ERRORINFO structure. The rboard
 100  * structure also has a pointer to the ERRORINFO structure. This is
 101  * the place to store ERRORINFO about a REMOTE NODE, if the HUB on
 102  * that NODE is not working or if the REMOTE MEMORY is BAD. In cases where
 103  * only the CPU of the REMOTE NODE is disabled, the ERRORINFO pointer can
 104  * be a NODE NUMBER, REMOTE OFFSET combination, pointing to error info
 105  * which is present on the REMOTE NODE.(TBD)
 106  * REMOTE ERRINFO can be stored on any of the nearest nodes
 107  * or on all the nearest nodes.(TBD)
 108  * Like BOARD structures, REMOTE ERRINFO structures can be built locally
 109  * using the rboard errinfo pointer.
 110  *
 111  * In order to get useful information from this Data organization, a set of
 112  * interface routines are provided (TBD). The important thing to remember while
 113  * manipulating the structures, is that, the NODE number information should
 114  * be used. If the NODE is non-zero (remote) then each offset should
 115  * be added to the REMOTE BASE ADDR else it should be added to the LOCAL BASE ADDR.
 116  * This includes offsets for BOARDS, COMPONENTS and ERRORINFO.
 117  *
 118  * Note that these structures do not provide much info about connectivity.
 119  * That info will be part of HWGRAPH, which is an extension of the cfg_t
 120  * data structure. (ref IP27prom/cfg.h) It has to be extended to include
 121  * the IO part of the Network(TBD).
 122  *
 123  * The data structures below define the above concepts.
 124  */
 125
 126
 127 /*
 128  * BOARD classes
 129  */
 130
 131 #define KLCLASS_MASK    0xf0
 132 #define KLCLASS_NONE    0x00
 133 #define KLCLASS_NODE    0x10             /* CPU, Memory and HUB board */
 134 #define KLCLASS_CPU     KLCLASS_NODE
 135 #define KLCLASS_IO      0x20             /* BaseIO, 4 ch SCSI, ethernet, FDDI
 136                                             and the non-graphics widget boards */
 137 #define KLCLASS_ROUTER  0x30             /* Router board */
 138 #define KLCLASS_MIDPLANE 0x40            /* We need to treat this as a board
 139                                             so that we can record error info */
 140 #define KLCLASS_IOBRICK 0x70            /* IP35 iobrick */
 141 #define KLCLASS_MAX     8               /* Bump this if a new CLASS is added */
 142
 143 #define KLCLASS(_x) ((_x) & KLCLASS_MASK)
 144
 145
 146 /*
 147  * board types
 148  */
 149
 150 #define KLTYPE_MASK     0x0f
 151 #define KLTYPE(_x)      ((_x) & KLTYPE_MASK)
 152
 153 #define KLTYPE_SNIA     (KLCLASS_CPU | 0x1)
 154 #define KLTYPE_TIO      (KLCLASS_CPU | 0x2)
 155
 156 #define KLTYPE_ROUTER     (KLCLASS_ROUTER | 0x1)
 157 #define KLTYPE_META_ROUTER (KLCLASS_ROUTER | 0x3)
 158 #define KLTYPE_REPEATER_ROUTER (KLCLASS_ROUTER | 0x4)
 159
 160 #define KLTYPE_IOBRICK_XBOW     (KLCLASS_MIDPLANE | 0x2)
 161
 162 #define KLTYPE_IOBRICK          (KLCLASS_IOBRICK | 0x0)
 163 #define KLTYPE_NBRICK           (KLCLASS_IOBRICK | 0x4)
 164 #define KLTYPE_PXBRICK          (KLCLASS_IOBRICK | 0x6)
 165 #define KLTYPE_IXBRICK          (KLCLASS_IOBRICK | 0x7)
 166 #define KLTYPE_CGBRICK          (KLCLASS_IOBRICK | 0x8)
 167 #define KLTYPE_OPUSBRICK        (KLCLASS_IOBRICK | 0x9)
 168 #define KLTYPE_SABRICK          (KLCLASS_IOBRICK | 0xa)
 169 #define KLTYPE_IABRICK          (KLCLASS_IOBRICK | 0xb)
 170 #define KLTYPE_PABRICK          (KLCLASS_IOBRICK | 0xc)
 171 #define KLTYPE_GABRICK          (KLCLASS_IOBRICK | 0xd)
 172
 173
 174 /*
 175  * board structures
 176  */
 177
 178 #define MAX_COMPTS_PER_BRD 24
 179
 180 typedef struct lboard_s {
 181         klconf_off_t    brd_next_any;     /* Next BOARD */
 182         unsigned char   struct_type;      /* type of structure, local or remote */
 183         unsigned char   brd_type;         /* type+class */
 184         unsigned char   brd_sversion;     /* version of this structure */
 185         unsigned char   brd_brevision;    /* board revision */
 186         unsigned char   brd_promver;      /* board prom version, if any */
 187         unsigned char   brd_flags;        /* Enabled, Disabled etc */
 188         unsigned char   brd_slot;         /* slot number */
 189         unsigned short  brd_debugsw;      /* Debug switches */
 190         geoid_t         brd_geoid;        /* geo id */
 191         partid_t        brd_partition;    /* Partition number */
 192         unsigned short  brd_diagval;      /* diagnostic value */
 193         unsigned short  brd_diagparm;     /* diagnostic parameter */
 194         unsigned char   brd_inventory;    /* inventory history */
 195         unsigned char   brd_numcompts;    /* Number of components */
 196         nic_t           brd_nic;          /* Number in CAN */
 197         nasid_t         brd_nasid;        /* passed parameter */
 198         klconf_off_t    brd_compts[MAX_COMPTS_PER_BRD]; /* pointers to COMPONENTS */
 199         klconf_off_t    brd_errinfo;      /* Board's error information */
 200         struct lboard_s *brd_parent;      /* Logical parent for this brd */
 201         char            pad0[4];
 202         unsigned char   brd_confidence;   /* confidence that the board is bad */
 203         nasid_t         brd_owner;        /* who owns this board */
 204         unsigned char   brd_nic_flags;    /* To handle 8 more NICs */
 205         char            pad1[24];         /* future expansion */
 206         char            brd_name[32];
 207         nasid_t         brd_next_same_host; /* host of next brd w/same nasid */
 208         klconf_off_t    brd_next_same;    /* Next BOARD with same nasid */
 209 } lboard_t;
 210
 211 /*
 212  * Generic info structure. This stores common info about a
 213  * component.
 214  */
 215
 216 typedef struct klinfo_s {                  /* Generic info */
 217         unsigned char   struct_type;       /* type of this structure */
 218         unsigned char   struct_version;    /* version of this structure */
 219         unsigned char   flags;            /* Enabled, disabled etc */
 220         unsigned char   revision;         /* component revision */
 221         unsigned short  diagval;          /* result of diagnostics */
 222         unsigned short  diagparm;         /* diagnostic parameter */
 223         unsigned char   inventory;        /* previous inventory status */
 224         unsigned short  partid;            /* widget part number */
 225         nic_t           nic;              /* MUst be aligned properly */
 226         unsigned char   physid;           /* physical id of component */
 227         unsigned int    virtid;           /* virtual id as seen by system */
 228         unsigned char   widid;            /* Widget id - if applicable */
 229         nasid_t         nasid;            /* node number - from parent */
 230         char            pad1;             /* pad out structure. */
 231         char            pad2;             /* pad out structure. */
 232         void            *data;
 233         klconf_off_t    errinfo;          /* component specific errors */
 234         unsigned short  pad3;             /* pci fields have moved over to */
 235         unsigned short  pad4;             /* klbri_t */
 236 } klinfo_t ;
 237
 238
 239 static inline lboard_t *find_lboard_next(lboard_t * brd)
 240 {
 241         if (brd && brd->brd_next_any)
 242                 return NODE_OFFSET_TO_LBOARD(NASID_GET(brd), brd->brd_next_any);
 243         return NULL;
 244 }
 245
 246 #endif /* _ASM_IA64_SN_KLCONFIG_H */