i2omsg.h revision 82092
1/* $FreeBSD: head/sys/dev/asr/i2omsg.h 82092 2001-08-21 19:58:16Z scottl $ */
2/****************************************************************
3 * Copyright (c) 1996-2000 Distributed Processing Technology Corporation
4 * Copyright (c) 2000 Adaptec Corporation.
5 * All rights reserved.
6 *
7 * Copyright 1999 I2O Special Interest Group (I2O SIG).  All rights reserved.
8 * All rights reserved
9 *
10 * TERMS AND CONDITIONS OF USE
11 *
12 * Redistribution and use in source form, with or without modification, are
13 * permitted provided that redistributions of source code must retain the
14 * above copyright notice, this list of conditions and the following disclaimer.
15 *
16 * This software is provided `as is' by Distributed Processing Technology and
17 * any express or implied warranties, including, but not limited to, the
18 * implied warranties of merchantability and fitness for a particular purpose,
19 * are disclaimed. In no event shall Distributed Processing Technology be
20 * liable for any direct, indirect, incidental, special, exemplary or
21 * consequential damages (including, but not limited to, procurement of
22 * substitute goods or services; loss of use, data, or profits; or business
23 * interruptions) however caused and on any theory of liability, whether in
24 * contract, strict liability, or tort (including negligence or otherwise)
25 * arising in any way out of the use of this driver software, even if advised
26 * of the possibility of such damage.
27 *
28 * This header file, and any modifications of this header file, are provided
29 * contingent upon your agreement and adherence to the here-listed terms and
30 * conditions.  By accepting and/or using this header file, you agree to abide
31 * by these terms and conditions and that these terms and conditions will be
32 * construed and governed in accordance with the laws of the State of California,
33 * without reference to conflict-of-law provisions.  If you do not agree
34 * to these terms and conditions, please delete this file, and any copies,
35 * permanently, without making any use thereof.
36 *
37 * THIS HEADER FILE IS PROVIDED FREE OF CHARGE ON AN AS-IS BASIS WITHOUT
38 * WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
39 * TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
40 * PURPOSE.  I2O SIG DOES NOT WARRANT THAT THIS HEADER FILE WILL MEET THE
41 * USER'S REQUIREMENTS OR THAT ITS OPERATION WILL BE UNINTERRUPTED OR
42 * ERROR-FREE.
43 *
44 * I2O SIG DISCLAIMS ALL LIABILITY, INCLUDING LIABILITY FOR INFRINGEMENT OF
45 * ANY PROPRIETARY RIGHTS, RELATING TO THE IMPLEMENTATION OF THE I2O
46 * SPECIFICATIONS.  I2O SIG DOES NOT WARRANT OR REPRESENT THAT SUCH
47 * IMPLEMENTATIONS WILL NOT INFRINGE SUCH RIGHTS.
48 *
49 * THE USER OF THIS HEADER FILE SHALL HAVE NO RECOURSE TO I2O SIG FOR ANY
50 * ACTUAL OR CONSEQUENTIAL DAMAGES INCLUDING, BUT NOT LIMITED TO, LOST DATA
51 * OR LOST PROFITS ARISING OUT OF THE USE OR INABILITY TO USE THIS PROGRAM.
52 *
53 * I2O SIG grants the user of this header file a license to copy, distribute,
54 * and modify it, for any purpose, under the following terms.  Any copying,
55 * distribution, or modification of this header file must not delete or alter
56 * the copyright notice of I2O SIG or any of these Terms and Conditions.
57 *
58 * Any distribution of this header file must not include a charge for the
59 * header file (unless such charges are strictly for the physical acts of
60 * copying or transferring copies).  However, distribution of a product in
61 * which this header file is embedded may include a charge so long as any
62 * such charge does not include any charge for the header file itself.
63 *
64 * Any modification of this header file constitutes a derivative work based
65 * on this header file.  Any distribution of such derivative work: (1) must
66 * include prominent notices that the header file has been changed from the
67 * original, together with the dates of any changes; (2) automatically includes
68 * this same license to the original header file from I2O SIG, without any
69 * restriction thereon from the distributing user; and (3) must include a
70 * grant of license of the modified file under the same terms and conditions
71 * as these Terms and Conditions.
72 *
73 * The I2O SIG Web site can be found at: http://www.i2osig.org
74 *
75 * The I2O SIG encourages you to deposit derivative works based on this
76 * header file at the I2O SIG Web site.  Furthermore, to become a Registered
77 * Developer of the I2O SIG, sign up at the Web site or call 415.750.8352
78 * (United States).
79 ****************************************************************/
80
81/*********************************************************************
82 * I2OMsg.h -- I2O Message defintion file
83 *
84 * This file contains information presented in Chapter 3, 4 and 6 of
85 * the I2O(tm) Specification and most of the I2O Global defines and
86 * Typedefs.
87 **********************************************************************/
88
89#if !defined(I2O_MESSAGE_HDR)
90#define I2O_MESSAGE_HDR
91
92#define I2OMSG_REV 1_5_4  /* I2OMsg header file revision string */
93
94/*
95
96   NOTES:
97
98   Gets, reads, receives, etc. are all even numbered functions.
99   Sets, writes, sends, etc. are all odd numbered functions.
100   Functions that both send and receive data can be either but an attempt is
101   made to use the function number that indicates the greater transfer amount.
102   Functions that do not send or receive data use odd function numbers.
103
104   Some functions are synonyms like read, receive and send, write.
105
106   All common functions will have a code of less than 0x80.
107   Unique functions to a class will start at 0x80.
108   Executive Functions start at 0xA0.
109
110   Utility Message function codes range from 0 - 0x1f
111   Base Message function codes range from 0x20 - 0xfe
112   Private Message function code is 0xff.
113*/
114
115
116
117#if ((defined(KERNEL) || defined(_KERNEL)) && defined(__FreeBSD__))
118# if (KERN_VERSION < 3)
119#  include "i386/pci/i2otypes.h"
120# else
121#  include "dev/asr/i2otypes.h"
122# endif
123#else
124# include "i2otypes.h"
125#endif
126
127
128PRAGMA_ALIGN_PUSH
129
130PRAGMA_PACK_PUSH
131
132/* Set to 1 for 64 bit Context Fields */
133#define     I2O_64BIT_CONTEXT          0
134
135/****************************************************************************/
136
137/* Common functions accross all classes. */
138
139#define    I2O_PRIVATE_MESSAGE                         0xFF
140
141/****************************************************************************/
142/* Class ID and Code Assignments */
143
144
145#define    I2O_CLASS_VERSION_10                        0x00
146#define    I2O_CLASS_VERSION_11                        0x01
147
148/*    Class Code Names:  Table 6-1 Class Code Assignments. */
149#define    I2O_CLASS_EXECUTIVE                         0x000
150#define    I2O_CLASS_DDM                               0x001
151#define    I2O_CLASS_RANDOM_BLOCK_STORAGE              0x010
152#define    I2O_CLASS_SEQUENTIAL_STORAGE                0x011
153#define    I2O_CLASS_LAN                               0x020
154#define    I2O_CLASS_WAN                               0x030
155#define    I2O_CLASS_FIBRE_CHANNEL_PORT                0x040
156#define    I2O_CLASS_FIBRE_CHANNEL_PERIPHERAL          0x041
157#define    I2O_CLASS_SCSI_PERIPHERAL                   0x051
158#define    I2O_CLASS_ATE_PORT                          0x060
159#define    I2O_CLASS_ATE_PERIPHERAL                    0x061
160#define    I2O_CLASS_FLOPPY_CONTROLLER                 0x070
161#define    I2O_CLASS_FLOPPY_DEVICE                     0x071
162#define    I2O_CLASS_BUS_ADAPTER_PORT                  0x080
163/* Class Codes 0x090 - 0x09f are reserved for Peer-to-Peer classes */
164#define    I2O_CLASS_MATCH_ANYCLASS                    0xffffffff
165
166#define    I2O_SUBCLASS_i960                           0x001
167#define    I2O_SUBCLASS_HDM                            0x020
168#define    I2O_SUBCLASS_ISM                            0x021
169
170
171/****************************************************************************/
172/* Message Frame defines and structures  */
173
174/*   Defines for the Version_Status field. */
175
176#define    I2O_VERSION_10                              0x00
177#define    I2O_VERSION_11                              0x01
178
179#define    I2O_VERSION_OFFSET_NUMBER_MASK              0x07
180#define    I2O_VERSION_OFFSET_SGL_TRL_OFFSET_MASK      0xF0
181
182/*   Defines for the Message Flags Field. */
183/*   Please Note the the FAIL bit is only set in the Transport Fail Message. */
184#define    I2O_MESSAGE_FLAGS_STATIC                    0x01
185#define    I2O_MESSAGE_FLAGS_64BIT_CONTEXT             0x02
186#define    I2O_MESSAGE_FLAGS_MULTIPLE                  0x10
187#define    I2O_MESSAGE_FLAGS_FAIL                      0x20
188#define    I2O_MESSAGE_FLAGS_LAST                      0x40
189#define    I2O_MESSAGE_FLAGS_REPLY                     0x80
190
191/* Defines for Request Status Codes:  Table 3-1 Reply Status Codes.  */
192
193#define    I2O_REPLY_STATUS_SUCCESS                    0x00
194#define    I2O_REPLY_STATUS_ABORT_DIRTY                0x01
195#define    I2O_REPLY_STATUS_ABORT_NO_DATA_TRANSFER     0x02
196#define    I2O_REPLY_STATUS_ABORT_PARTIAL_TRANSFER     0x03
197#define    I2O_REPLY_STATUS_ERROR_DIRTY                0x04
198#define    I2O_REPLY_STATUS_ERROR_NO_DATA_TRANSFER     0x05
199#define    I2O_REPLY_STATUS_ERROR_PARTIAL_TRANSFER     0x06
200#define    I2O_REPLY_STATUS_PROCESS_ABORT_DIRTY        0x08
201#define    I2O_REPLY_STATUS_PROCESS_ABORT_NO_DATA_TRANSFER   0x09
202#define    I2O_REPLY_STATUS_PROCESS_ABORT_PARTIAL_TRANSFER   0x0A
203#define    I2O_REPLY_STATUS_TRANSACTION_ERROR          0x0B
204#define    I2O_REPLY_STATUS_PROGRESS_REPORT            0x80
205
206/* DetailedStatusCode defines for ALL messages: Table 3-2 Detailed Status Codes.  */
207
208#define    I2O_DETAIL_STATUS_SUCCESS                        0x0000
209#define    I2O_DETAIL_STATUS_BAD_KEY                        0x0002
210#define    I2O_DETAIL_STATUS_TCL_ERROR                      0x0003
211#define    I2O_DETAIL_STATUS_REPLY_BUFFER_FULL              0x0004
212#define    I2O_DETAIL_STATUS_NO_SUCH_PAGE                   0x0005
213#define    I2O_DETAIL_STATUS_INSUFFICIENT_RESOURCE_SOFT     0x0006
214#define    I2O_DETAIL_STATUS_INSUFFICIENT_RESOURCE_HARD     0x0007
215#define    I2O_DETAIL_STATUS_CHAIN_BUFFER_TOO_LARGE         0x0009
216#define    I2O_DETAIL_STATUS_UNSUPPORTED_FUNCTION           0x000A
217#define    I2O_DETAIL_STATUS_DEVICE_LOCKED                  0x000B
218#define    I2O_DETAIL_STATUS_DEVICE_RESET                   0x000C
219#define    I2O_DETAIL_STATUS_INAPPROPRIATE_FUNCTION         0x000D
220#define    I2O_DETAIL_STATUS_INVALID_INITIATOR_ADDRESS      0x000E
221#define    I2O_DETAIL_STATUS_INVALID_MESSAGE_FLAGS          0x000F
222#define    I2O_DETAIL_STATUS_INVALID_OFFSET                 0x0010
223#define    I2O_DETAIL_STATUS_INVALID_PARAMETER              0x0011
224#define    I2O_DETAIL_STATUS_INVALID_REQUEST                0x0012
225#define    I2O_DETAIL_STATUS_INVALID_TARGET_ADDRESS         0x0013
226#define    I2O_DETAIL_STATUS_MESSAGE_TOO_LARGE              0x0014
227#define    I2O_DETAIL_STATUS_MESSAGE_TOO_SMALL              0x0015
228#define    I2O_DETAIL_STATUS_MISSING_PARAMETER              0x0016
229#define    I2O_DETAIL_STATUS_TIMEOUT                        0x0017
230#define    I2O_DETAIL_STATUS_UNKNOWN_ERROR                  0x0018
231#define    I2O_DETAIL_STATUS_UNKNOWN_FUNCTION               0x0019
232#define    I2O_DETAIL_STATUS_UNSUPPORTED_VERSION            0x001A
233#define    I2O_DEATIL_STATUS_DEVICE_BUSY                    0x001B
234#define    I2O_DETAIL_STATUS_DEVICE_NOT_AVAILABLE           0x001C
235
236/* Common I2O Field sizes  */
237
238#define    I2O_TID_SZ                                  12
239#define    I2O_FUNCTION_SZ                             8
240#define    I2O_UNIT_ID_SZ                              16
241#define    I2O_SEGMENT_NUMBER_SZ                       12
242
243#define    I2O_IOP_ID_SZ                               12
244#define    I2O_GROUP_ID_SZ                             16
245#define    I2O_IOP_STATE_SZ                            8
246#define    I2O_MESSENGER_TYPE_SZ                       8
247
248#define    I2O_CLASS_ID_SZ                             12
249#define    I2O_CLASS_ORGANIZATION_ID_SZ                16
250
251#define    I2O_4BIT_VERSION_SZ                         4
252#define    I2O_8BIT_FLAGS_SZ                           8
253#define    I2O_COMMON_LENGTH_FIELD_SZ                  16
254
255#define    I2O_DEVID_DESCRIPTION_SZ                    16
256#define    I2O_DEVID_VENDOR_INFO_SZ                    16
257#define    I2O_DEVID_PRODUCT_INFO_SZ                   16
258#define    I2O_DEVID_REV_LEVEL_SZ                      8
259#define    I2O_MODULE_NAME_SZ                          24
260
261#define    I2O_BIOS_INFO_SZ                            8
262
263#define    I2O_RESERVED_4BITS                          4
264#define    I2O_RESERVED_8BITS                          8
265#define    I2O_RESERVED_12BITS                         12
266#define    I2O_RESERVED_16BITS                         16
267#define    I2O_RESERVED_20BITS                         20
268#define    I2O_RESERVED_24BITS                         24
269#define    I2O_RESERVED_28BITS                         28
270
271
272typedef    U32        I2O_PARAMETER_TID;
273
274
275#if     I2O_64BIT_CONTEXT
276typedef    U64        I2O_INITIATOR_CONTEXT;
277typedef    U64        I2O_TRANSACTION_CONTEXT;
278#else
279typedef    U32        I2O_INITIATOR_CONTEXT;
280typedef    U32        I2O_TRANSACTION_CONTEXT;
281#endif
282
283/*  Serial Number format defines */
284
285#define    I2O_SERIAL_FORMAT_UNKNOWN                   0
286#define    I2O_SERIAL_FORMAT_BINARY                    1
287#define    I2O_SERIAL_FORMAT_ASCII                     2
288#define    I2O_SERIAL_FORMAT_UNICODE                   3
289#define    I2O_SERIAL_FORMAT_LAN_MAC                   4
290#define    I2O_SERIAL_FORMAT_WAN                       5
291
292/* Special TID Assignments */
293
294#define    I2O_IOP_TID                                 0
295#define    I2O_HOST_TID                                1
296
297
298/****************************************************************************/
299
300/* I2O Message Frame common for all messages  */
301
302typedef struct _I2O_MESSAGE_FRAME {
303   U8                          VersionOffset;
304   U8                          MsgFlags;
305   U16                         MessageSize;
306#if  (defined(__BORLANDC__)) || defined(_DPT_BIG_ENDIAN) || (defined(sparc))
307   U32                         TargetAddress;
308#else
309   BF                          TargetAddress:I2O_TID_SZ;
310   BF                          InitiatorAddress:I2O_TID_SZ;
311   BF                          Function:I2O_FUNCTION_SZ;
312#endif
313   I2O_INITIATOR_CONTEXT       InitiatorContext;
314} I2O_MESSAGE_FRAME, *PI2O_MESSAGE_FRAME;
315
316
317/****************************************************************************/
318
319/* Transaction Reply Lists (TRL) Control Word structure */
320
321#define    I2O_TRL_FLAGS_SINGLE_FIXED_LENGTH           0x00
322#define    I2O_TRL_FLAGS_SINGLE_VARIABLE_LENGTH        0x40
323#define    I2O_TRL_FLAGS_MULTIPLE_FIXED_LENGTH         0x80
324
325typedef struct _I2O_TRL_CONTROL_WORD {
326   U8                          TrlCount;
327   U8                          TrlElementSize;
328   U8                          reserved;
329   U8                          TrlFlags;
330#if     I2O_64BIT_CONTEXT
331   U32                         Padding;           /* Padding for 64 bit */
332#endif
333} I2O_TRL_CONTROL_WORD, *PI2O_TRL_CONTROL_WORD;
334
335/****************************************************************************/
336
337/* I2O Successful Single Transaction Reply Message Frame structure. */
338
339typedef struct _I2O_SINGLE_REPLY_MESSAGE_FRAME {
340   I2O_MESSAGE_FRAME           StdMessageFrame;
341   I2O_TRANSACTION_CONTEXT     TransactionContext;
342   U16                         DetailedStatusCode;
343   U8                          reserved;
344   U8                          ReqStatus;
345/*                             ReplyPayload        */
346} I2O_SINGLE_REPLY_MESSAGE_FRAME, *PI2O_SINGLE_REPLY_MESSAGE_FRAME;
347
348
349/****************************************************************************/
350
351/* I2O Successful Multiple Transaction Reply Message Frame structure. */
352
353typedef struct _I2O_MULTIPLE_REPLY_MESSAGE_FRAME {
354   I2O_MESSAGE_FRAME           StdMessageFrame;
355   I2O_TRL_CONTROL_WORD        TrlControlWord;
356   U16                         DetailedStatusCode;
357   U8                          reserved;
358   U8                          ReqStatus;
359/*                             TransactionDetails[]        */
360} I2O_MULTIPLE_REPLY_MESSAGE_FRAME, *PI2O_MULTIPLE_REPLY_MESSAGE_FRAME;
361
362
363/****************************************************************************/
364
365/* I2O Private Message Frame structure. */
366
367typedef struct _I2O_PRIVATE_MESSAGE_FRAME {
368   I2O_MESSAGE_FRAME           StdMessageFrame;
369   I2O_TRANSACTION_CONTEXT     TransactionContext;
370   U16                         XFunctionCode;
371   U16                         OrganizationID;
372/*                             PrivatePayload[]        */
373} I2O_PRIVATE_MESSAGE_FRAME, *PI2O_PRIVATE_MESSAGE_FRAME;
374
375
376/****************************************************************************/
377
378/* Message Failure Severity Codes */
379
380#define    I2O_SEVERITY_FORMAT_ERROR                   0x1
381#define    I2O_SEVERITY_PATH_ERROR                     0x2
382#define    I2O_SEVERITY_PATH_STATE                     0x4
383#define    I2O_SEVERITY_CONGESTION                     0x8
384
385/* Transport Failure Codes: Table 3-3 Mesasge Failure Codes */
386
387#define    I2O_FAILURE_CODE_TRANSPORT_SERVICE_SUSPENDED    0x81
388#define    I2O_FAILURE_CODE_TRANSPORT_SERVICE_TERMINATED   0x82
389#define    I2O_FAILURE_CODE_TRANSPORT_CONGESTION           0x83
390#define    I2O_FAILURE_CODE_TRANSPORT_FAIL                 0x84
391#define    I2O_FAILURE_CODE_TRANSPORT_STATE_ERROR          0x85
392#define    I2O_FAILURE_CODE_TRANSPORT_TIME_OUT             0x86
393#define    I2O_FAILURE_CODE_TRANSPORT_ROUTING_FAILURE      0x87
394#define    I2O_FAILURE_CODE_TRANSPORT_INVALID_VERSION      0x88
395#define    I2O_FAILURE_CODE_TRANSPORT_INVALID_OFFSET       0x89
396#define    I2O_FAILURE_CODE_TRANSPORT_INVALID_MSG_FLAGS    0x8A
397#define    I2O_FAILURE_CODE_TRANSPORT_FRAME_TOO_SMALL      0x8B
398#define    I2O_FAILURE_CODE_TRANSPORT_FRAME_TOO_LARGE      0x8C
399#define    I2O_FAILURE_CODE_TRANSPORT_INVALID_TARGET_ID    0x8D
400#define    I2O_FAILURE_CODE_TRANSPORT_INVALID_INITIATOR_ID 0x8E
401#define    I2O_FAILURE_CODE_TRANSPORT_INVALID_INITIATOR_CONTEXT    0x8F
402#define    I2O_FAILURE_CODE_TRANSPORT_UNKNOWN_FAILURE      0xFF
403
404/* IOP_ID and Severity sizes */
405
406#define    I2O_FAILCODE_SEVERITY_SZ                        8
407#define    I2O_FAILCODE_CODE_SZ                            8
408
409/* I2O Transport Message Reply for Message Failure. */
410
411typedef struct _I2O_FAILURE_REPLY_MESSAGE_FRAME {
412    I2O_MESSAGE_FRAME           StdMessageFrame;
413    I2O_TRANSACTION_CONTEXT     TransactionContext;
414#   if (defined(_DPT_BIG_ENDIAN) || defined(sparc) || defined(__BORLANDC__))
415        U32                     LowestVersion;
416        U32                     reserved;
417#   else
418        U8                      LowestVersion;
419        U8                      HighestVersion;
420/*      BF                      Severity:I2O_FAILCODE_SEVERITY_SZ;
421//      BF                      FailureCode:I2O_FAILCODE_CODE_SZ;
422//
423// Due to our compiler padding this structure and making it larger than
424// it really is (4 bytes larger), we are re-defining these two fields
425*/
426        U8                      Severity;
427        U8                      FailureCode;
428        BF                      reserved:I2O_RESERVED_4BITS;
429        BF                      FailingHostUnitID:I2O_UNIT_ID_SZ;
430        BF                      reserved1:12;
431#   endif
432    U32                         AgeLimit;
433    U32                         PreservedMFA;
434} I2O_FAILURE_REPLY_MESSAGE_FRAME, *PI2O_FAILURE_REPLY_MESSAGE_FRAME;
435
436/* I2O Transport Message Reply for Transaction Error. */
437
438typedef struct _I2O_TRANSACTION_ERROR_REPLY_MESSAGE_FRAME {
439   I2O_MESSAGE_FRAME           StdMessageFrame;
440   I2O_TRANSACTION_CONTEXT     TransactionContext;
441   U16                         DetailedStatusCode;
442   U8                          reserved;
443   U8                          ReqStatus;   /* Should always be Transaction Error */
444   U32                         ErrorOffset;
445   U8                          BitOffset;
446   U8                          reserved1;
447   U16                         reserved2;
448} I2O_TRANSACTION_ERROR_REPLY_MESSAGE_FRAME, *PI2O_TRANSACTION_ERROR_REPLY_MESSAGE_FRAME;
449
450/****************************************************************************/
451
452/*  Misc. commonly used structures */
453
454/* Class ID Block */
455
456typedef struct _I2O_CLASS_ID {
457#if (defined(_DPT_BIG_ENDIAN) || defined(sparc))
458   U32                         Class;
459#else
460   BF                          Class:I2O_CLASS_ID_SZ;
461   BF                          Version:I2O_4BIT_VERSION_SZ;
462   BF                          OrganizationID:I2O_CLASS_ORGANIZATION_ID_SZ;
463#endif
464} I2O_CLASS_ID, *PI2O_CLASS_ID;
465
466
467#define    I2O_MAX_SERIAL_NUMBER_SZ                    256
468
469typedef struct _I2O_SERIAL_INFO {
470   U8                          SerialNumberLength;
471   U8                          SerialNumberFormat;
472   U8                          SerialNumber[I2O_MAX_SERIAL_NUMBER_SZ];
473} I2O_SERIAL_INFO, *PI2O_SERIAL_INFO;
474
475
476/****************************************************************************/
477/* Hardware Resource Table (HRT) and Logical Configuration Table (LCT) */
478/****************************************************************************/
479
480/* Bus Type Code defines */
481
482#define    I2O_LOCAL_BUS                               0
483#define    I2O_ISA_BUS                                 1
484#define    I2O_EISA_BUS                                2
485#define    I2O_MCA_BUS                                 3
486#define    I2O_PCI_BUS                                 4
487#define    I2O_PCMCIA_BUS                              5
488#define    I2O_NUBUS_BUS                               6
489#define    I2O_CARDBUS_BUS                             7
490#define    I2O_OTHER_BUS                               0x80
491
492#define    I2O_HRT_STATE_SZ                            4
493#define    I2O_HRT_BUS_NUMBER_SZ                       8
494#define    I2O_HRT_BUS_TYPE_SZ                         8
495
496
497/* Bus Structures */
498
499/* PCI Bus */
500typedef struct _I2O_PCI_BUS_INFO {
501   U8                          PciFunctionNumber;
502   U8                          PciDeviceNumber;
503   U8                          PciBusNumber;
504   U8                          reserved;
505   U16                         PciVendorID;
506   U16                         PciDeviceID;
507} I2O_PCI_BUS_INFO, *PI2O_PCI_BUS_INFO;
508
509/* Local Bus */
510typedef struct _I2O_LOCAL_BUS_INFO {
511   U16                         LbBaseIOPort;
512   U16                         reserved;
513   U32                         LbBaseMemoryAddress;
514} I2O_LOCAL_BUS_INFO, *PI2O_LOCAL_BUS_INFO;
515
516/* ISA Bus */
517typedef struct _I2O_ISA_BUS_INFO {
518   U16                         IsaBaseIOPort;
519   U8                          CSN;
520   U8                          reserved;
521   U32                         IsaBaseMemoryAddress;
522} I2O_ISA_BUS_INFO, *PI2O_ISA_BUS_INFO;
523
524/* EISA Bus */
525typedef struct _I2O_EISA_BUS_INFO {
526   U16                         EisaBaseIOPort;
527   U8                          reserved;
528   U8                          EisaSlotNumber;
529   U32                         EisaBaseMemoryAddress;
530} I2O_EISA_BUS_INFO, *PI2O_EISA_BUS_INFO;
531
532/* MCA Bus */
533typedef struct _I2O_MCA_BUS_INFO {
534   U16                         McaBaseIOPort;
535   U8                          reserved;
536   U8                          McaSlotNumber;
537   U32                         McaBaseMemoryAddress;
538} I2O_MCA_BUS_INFO, *PI2O_MCA_BUS_INFO;
539
540/* Other Bus */
541typedef struct _I2O_OTHER_BUS_INFO {
542   U16                         BaseIOPort;
543   U16                         reserved;
544   U32                         BaseMemoryAddress;
545} I2O_OTHER_BUS_INFO, *PI2O_OTHER_BUS_INFO;
546
547
548/* HRT Entry Block */
549
550typedef struct _I2O_HRT_ENTRY {
551   U32                         AdapterID;
552#if (defined(_DPT_BIG_ENDIAN) || defined(sparc))
553   U32                         ControllingTID;
554#else
555   BF                          ControllingTID:I2O_TID_SZ;
556   BF                          AdapterState:I2O_HRT_STATE_SZ;
557   BF                          BusNumber:I2O_HRT_BUS_NUMBER_SZ;
558   BF                          BusType:I2O_HRT_BUS_TYPE_SZ;
559#endif
560   union {
561       /* PCI Bus */
562       I2O_PCI_BUS_INFO        PCIBus;
563
564       /* Local Bus */
565       I2O_LOCAL_BUS_INFO      LocalBus;
566
567       /* ISA Bus */
568       I2O_ISA_BUS_INFO        ISABus;
569
570       /* EISA Bus */
571       I2O_EISA_BUS_INFO       EISABus;
572
573       /* MCA Bus */
574       I2O_MCA_BUS_INFO        MCABus;
575
576       /* Other. */
577       I2O_OTHER_BUS_INFO      OtherBus;
578   }uBus;
579} I2O_HRT_ENTRY, *PI2O_HRT_ENTRY;
580
581
582/* I2O Hardware Resource Table structure. */
583
584typedef struct _I2O_HRT {
585   U16                         NumberEntries;
586   U8                          EntryLength;
587   U8                          HRTVersion;
588   U32                         CurrentChangeIndicator;
589   I2O_HRT_ENTRY               HRTEntry[1];
590} I2O_HRT, *PI2O_HRT;
591
592
593/****************************************************************************/
594/* Logical Configuration Table  */
595/****************************************************************************/
596
597/* I2O Logical Configuration Table structures. */
598
599#define    I2O_IDENTITY_TAG_SZ                         8
600
601/* I2O Logical Configuration Table Device Flags */
602
603#define    I2O_LCT_DEVICE_FLAGS_CONF_DIALOG_REQUEST            0x01
604#define    I2O_LCT_DEVICE_FLAGS_MORE_THAN_1_USER               0x02
605#define    I2O_LCT_DEVICE_FLAGS_PEER_SERVICE_DISABLED          0x10
606#define    I2O_LCT_DEVICE_FLAGS_MANAGEMENT_SERVICE_DISABLED    0x20
607
608/* LCT Entry Block */
609
610typedef struct _I2O_LCT_ENTRY {
611#if (defined(_DPT_BIG_ENDIAN) || defined(sparc))
612   U32                         TableEntrySize;
613#else
614   BF                          TableEntrySize:I2O_COMMON_LENGTH_FIELD_SZ;
615   BF                          LocalTID:I2O_TID_SZ;
616   BF                          reserved:I2O_4BIT_VERSION_SZ;
617#endif
618   U32                         ChangeIndicator;
619   U32                         DeviceFlags;
620   I2O_CLASS_ID                ClassID;
621   U32                         SubClassInfo;
622#if (defined(__BORLANDC__)) || defined(_DPT_BIG_ENDIAN) || (defined(sparc))
623   U32                         UserTID;
624#else
625   BF                          UserTID:I2O_TID_SZ;
626   BF                          ParentTID:I2O_TID_SZ;
627   BF                          BiosInfo:I2O_BIOS_INFO_SZ;
628#endif
629   U8                          IdentityTag[I2O_IDENTITY_TAG_SZ];
630   U32                         EventCapabilities;
631} I2O_LCT_ENTRY, *PI2O_LCT_ENTRY;
632
633
634/* I2O Logical Configuration Table structure. */
635
636typedef struct _I2O_LCT {
637#if (defined(_DPT_BIG_ENDIAN) || defined(sparc))
638   U32                         TableSize;
639#else
640   BF                          TableSize:I2O_COMMON_LENGTH_FIELD_SZ;
641   BF                          BootDeviceTID:I2O_TID_SZ;
642   BF                          LctVer:I2O_4BIT_VERSION_SZ;
643#endif
644   U32                         IopFlags;
645   U32                         CurrentChangeIndicator;
646   I2O_LCT_ENTRY               LCTEntry[1];
647} I2O_LCT, *PI2O_LCT;
648
649
650/****************************************************************************/
651
652/* Memory Addressing structures and defines. */
653
654/* SglFlags defines. */
655
656#define    I2O_SGL_FLAGS_LAST_ELEMENT                  0x80
657#define    I2O_SGL_FLAGS_END_OF_BUFFER                 0x40
658
659#define    I2O_SGL_FLAGS_IGNORE_ELEMENT                0x00
660#define    I2O_SGL_FLAGS_TRANSPORT_ELEMENT             0x04
661#define    I2O_SGL_FLAGS_BIT_BUCKET_ELEMENT            0x08
662#define    I2O_SGL_FLAGS_IMMEDIATE_DATA_ELEMENT        0x0C
663#define    I2O_SGL_FLAGS_SIMPLE_ADDRESS_ELEMENT        0x10
664#define    I2O_SGL_FLAGS_PAGE_LIST_ADDRESS_ELEMENT     0x20
665#define    I2O_SGL_FLAGS_CHAIN_POINTER_ELEMENT         0x30
666#define    I2O_SGL_FLAGS_LONG_TRANSACTION_ELEMENT      0x40
667#define    I2O_SGL_FLAGS_SHORT_TRANSACTION_ELEMENT     0x70
668#define    I2O_SGL_FLAGS_SGL_ATTRIBUTES_ELEMENT        0x7C
669
670#define    I2O_SGL_FLAGS_BC0                           0x01
671#define    I2O_SGL_FLAGS_BC1                           0x02
672#define    I2O_SGL_FLAGS_DIR                           0x04
673#define    I2O_SGL_FLAGS_LOCAL_ADDRESS                 0x08
674
675#define    I2O_SGL_FLAGS_CONTEXT_COUNT_MASK            0x03
676#define    I2O_SGL_FLAGS_ADDRESS_MODE_MASK             0x3C
677#define    I2O_SGL_FLAGS_NO_CONTEXT                    0x00
678
679/*  Scatter/Gather Truth Table */
680
681/*
682
683typedef enum _SG_TYPE {
684   INVALID,
685   Ignore,
686   TransportDetails,
687   BitBucket,
688   ImmediateData,
689   Simple,
690   PageList,
691   ChainPointer,
692   ShortTransaction,
693   LongTransaction,
694   SGLAttributes,
695   INVALID/ReservedLongFormat,
696   INVALID/ReservedShortFormat
697} SG_TYPE, *PSG_TYPE;
698
699
700   0x00    Ignore;
701   0x04    TransportDetails;
702   0x08    BitBucket;
703   0x0C    ImmediateData;
704   0x10    Simple;
705   0x14    Simple;
706   0x18    Simple;
707   0x1C    Simple;
708   0x20    PageList;
709   0x24    PageList;
710   0x28    PageList;
711   0x2C    PageList;
712   0x30    ChainPointer;
713   0x34    INVALID;
714   0x38    ChainPointer;
715   0x3C    INVALID;
716   0x40    LongTransaction;
717   0x44    INVALID/ReservedLongFormat;
718   0x48    BitBucket;
719   0x4C    ImmediateData;
720   0x50    Simple;
721   0x54    Simple;
722   0x58    Simple;
723   0x5C    Simple;
724   0x60    PageList;
725   0x64    PageList;
726   0x68    PageList;
727   0x6C    PageList;
728   0x70    ShortTransaction;
729   0x74    INVALID/ReservedShortFormat;
730   0x78    INVALID/ReservedShortFormat;
731   0x7C    SGLAttributes;
732*/
733
734
735/* 32 Bit Context Field defines */
736
737#define    I2O_SGL_FLAGS_CONTEXT32_NULL                0x00
738#define    I2O_SGL_FLAGS_CONTEXT32_U32                 0x01
739#define    I2O_SGL_FLAGS_CONTEXT32_U64                 0x02
740#define    I2O_SGL_FLAGS_CONTEXT32_U96                 0x03
741
742#define    I2O_SGL_FLAGS_CONTEXT32_NULL_SZ             0x00
743#define    I2O_SGL_FLAGS_CONTEXT32_U32_SZ              0x04
744#define    I2O_SGL_FLAGS_CONTEXT32_U64_SZ              0x08
745#define    I2O_SGL_FLAGS_CONTEXT32_U96_SZ              0x0C
746
747/* 64 Bit Context Field defines */
748
749#define    I2O_SGL_FLAGS_CONTEXT64_NULL                0x00
750#define    I2O_SGL_FLAGS_CONTEXT64_U64                 0x01
751#define    I2O_SGL_FLAGS_CONTEXT64_U128                0x02
752#define    I2O_SGL_FLAGS_CONTEXT64_U192                0x03
753
754#define    I2O_SGL_FLAGS_CONTEXT64_NULL_SZ             0x00
755#define    I2O_SGL_FLAGS_CONTEXT64_U64_SZ              0x08
756#define    I2O_SGL_FLAGS_CONTEXT64_U128_SZ             0x10
757#define    I2O_SGL_FLAGS_CONTEXT64_U192_SZ             0x18
758
759/* SGL Attribute Element defines */
760
761#define    I2O_SGL_ATTRIBUTE_FLAGS_BIT_BUCKET_HINT     0x0400
762#define    I2O_SGL_ATTRIBUTE_FLAGS_IMMEDIATE_DATA_HINT 0x0200
763#define    I2O_SGL_ATTRIBUTE_FLAGS_LOCAL_ADDRESS_HINT  0x0100
764#define    I2O_SGL_ATTRIBUTE_FLAGS_32BIT_TRANSACTION   0x0000
765#define    I2O_SGL_ATTRIBUTE_FLAGS_64BIT_TRANSACTION   0x0004
766#define    I2O_SGL_ATTRIBUTE_FLAGS_32BIT_LOCAL_ADDRESS 0x0000
767
768/* SG Size defines */
769
770#define    I2O_SG_COUNT_SZ                             24
771#define    I2O_SG_FLAGS_SZ                             8
772
773/* Standard Flags and Count fields for SG Elements */
774
775typedef struct _I2O_FLAGS_COUNT {
776#if (defined(__BORLANDC__)) || defined(_DPT_BIG_ENDIAN) || (defined(sparc))
777   U32                         Count;
778#else
779   BF                          Count:I2O_SG_COUNT_SZ;
780   BF                          Flags:I2O_SG_FLAGS_SZ;
781#endif
782} I2O_FLAGS_COUNT, *PI2O_FLAGS_COUNT;
783
784/* Bit Bucket Element */
785
786typedef struct _I2O_SGE_BIT_BUCKET_ELEMENT {
787   I2O_FLAGS_COUNT             FlagsCount;
788   U32                         BufferContext;
789} I2O_SGE_BIT_BUCKET_ELEMENT, *PI2O_SGE_BIT_BUCKET_ELEMENT;
790
791/* Chain Addressing Scatter-Gather Element */
792
793typedef struct _I2O_SGE_CHAIN_ELEMENT {
794   I2O_FLAGS_COUNT             FlagsCount;
795   U32                         PhysicalAddress;
796} I2O_SGE_CHAIN_ELEMENT, *PI2O_SGE_CHAIN_ELEMENT;
797
798/* Chain Addressing with Context Scatter-Gather Element */
799
800typedef struct _I2O_SGE_CHAIN_CONTEXT_ELEMENT {
801   I2O_FLAGS_COUNT             FlagsCount;
802   U32                         Context[1];
803   U32                         PhysicalAddress;
804} I2O_SGE_CHAIN_CONTEXT_ELEMENT, *PI2O_SGE_CHAIN_CONTEXT_ELEMENT;
805
806/* Ignore Scatter-Gather Element */
807
808typedef struct _I2O_SGE_IGNORE_ELEMENT {
809   I2O_FLAGS_COUNT             FlagsCount;
810} I2O_SGE_IGNORE_ELEMENT, *PI2O_SGE_IGNORE_ELEMENT;
811
812/* Immediate Data Element */
813
814typedef struct _I2O_SGE_IMMEDIATE_DATA_ELEMENT {
815   I2O_FLAGS_COUNT             FlagsCount;
816} I2O_SGE_IMMEDIATE_DATA_ELEMENT, *PI2O_SGE_IMMEDIATE_DATA_ELEMENT;
817
818/* Immediate Data with Context Element */
819
820typedef struct _I2O_SGE_IMMEDIATE_DATA_CONTEXT_ELEMENT {
821   I2O_FLAGS_COUNT             FlagsCount;
822   U32                         BufferContext;
823} I2O_SGE_IMMEDIATE_DATA_CONTEXT_ELEMENT, *PI2O_SGE_IMMEDIATE_DATA_CONTEXT_ELEMENT;
824
825/* Long Transaction Parameters Element */
826
827typedef struct _I2O_SGE_LONG_TRANSACTION_ELEMENT {
828#if (defined(__BORLANDC__))
829   U32                         LongElementLength;
830#else
831   BF                          LongElementLength:I2O_SG_COUNT_SZ;
832   BF                          Flags:I2O_SG_FLAGS_SZ;
833#endif
834   U32                         BufferContext;
835} I2O_SGE_LONG_TRANSACTION_ELEMENT, *PI2O_SGE_LONG_TRANSACTION_ELEMENT;
836
837/* Page List Scatter-Gather Element */
838
839typedef struct _I2O_SGE_PAGE_ELEMENT {
840   I2O_FLAGS_COUNT             FlagsCount;
841   U32                         PhysicalAddress[1];
842} I2O_SGE_PAGE_ELEMENT , *PI2O_SGE_PAGE_ELEMENT ;
843
844/* Page List with Context Scatter-Gather Element */
845
846typedef struct _I2O_SGE_PAGE_CONTEXT_ELEMENT {
847   I2O_FLAGS_COUNT             FlagsCount;
848   U32                         BufferContext[1];
849   U32                         PhysicalAddress[1];
850} I2O_SGE_PAGE_CONTEXT_ELEMENT, *PI2O_SGE_PAGE_CONTEXT_ELEMENT;
851
852/* SGL Attribute Element */
853
854typedef struct _I2O_SGE_SGL_ATTRIBUTES_ELEMENT {
855   U16                         SglAttributeFlags;
856   U8                          ElementLength;
857   U8                          Flags;
858   U32                         PageFrameSize;
859} I2O_SGE_SGL_ATTRIBUTES_ELEMENT, *PI2O_SGE_SGL_ATTRIBUTES_ELEMENT;
860
861/* Short Transaction Parameters Element */
862
863typedef struct _I2O_SGE_SHORT_TRANSACTION_ELEMENT {
864   U16                         ClassFields;
865   U8                          ElementLength;
866   U8                          Flags;
867   U32                         BufferContext;
868} I2O_SGE_SHORT_TRANSACTION_ELEMENT, *PI2O_SGE_SHORT_TRANSACTION_ELEMENT;
869
870/* Simple Addressing Scatter-Gather Element */
871
872typedef struct _I2O_SGE_SIMPLE_ELEMENT {
873   I2O_FLAGS_COUNT             FlagsCount;
874   U32                         PhysicalAddress;
875} I2O_SGE_SIMPLE_ELEMENT, *PI2O_SGE_SIMPLE_ELEMENT;
876
877/* Simple Addressing with Context Scatter-Gather Element */
878
879typedef struct _I2O_SGE_SIMPLE_CONTEXT_ELEMENT {
880   I2O_FLAGS_COUNT             FlagsCount;
881   U32                         BufferContext[1];
882   U32                         PhysicalAddress;
883} I2O_SGE_SIMPLE_CONTEXT_ELEMENT, *PI2O_SGE_SIMPLE_CONTEXT_ELEMENT;
884
885/* Transport Detail Element */
886
887typedef struct _I2O_SGE_TRANSPORT_ELEMENT {
888#if (defined(__BORLANDC__))
889   U32                         LongElementLength;
890#else
891   BF                          LongElementLength:I2O_SG_COUNT_SZ;
892   BF                          Flags:I2O_SG_FLAGS_SZ;
893#endif
894} I2O_SGE_TRANSPORT_ELEMENT, *PI2O_SGE_TRANSPORT_ELEMENT;
895
896typedef struct _I2O_SG_ELEMENT {
897   union {
898       /* Bit Bucket Element */
899       I2O_SGE_BIT_BUCKET_ELEMENT          BitBucket;
900
901       /* Chain Addressing Element */
902       I2O_SGE_CHAIN_ELEMENT               Chain;
903
904       /* Chain Addressing with Context Element */
905       I2O_SGE_CHAIN_CONTEXT_ELEMENT       ChainContext;
906
907       /* Ignore Scatter-Gather Element */
908       I2O_SGE_IGNORE_ELEMENT              Ignore;
909
910       /* Immediate Data Element */
911       I2O_SGE_IMMEDIATE_DATA_ELEMENT      ImmediateData;
912
913       /* Immediate Data with Context Element */
914       I2O_SGE_IMMEDIATE_DATA_CONTEXT_ELEMENT  ImmediateDataContext;
915
916       /* Long Transaction Parameters Element */
917       I2O_SGE_LONG_TRANSACTION_ELEMENT    LongTransaction;
918
919       /* Page List Element */
920       I2O_SGE_PAGE_ELEMENT                Page;
921
922       /* Page List with Context Element */
923       I2O_SGE_PAGE_CONTEXT_ELEMENT        PageContext;
924
925       /* SGL Attribute Element */
926       I2O_SGE_SGL_ATTRIBUTES_ELEMENT      SGLAttribute;
927
928       /* Short Transaction Parameters Element */
929       I2O_SGE_SHORT_TRANSACTION_ELEMENT   ShortTransaction;
930
931       /* Simple Addressing Element */
932       I2O_SGE_SIMPLE_ELEMENT              Simple[1];
933
934       /* Simple Addressing with Context Element */
935       I2O_SGE_SIMPLE_CONTEXT_ELEMENT      SimpleContext[1];
936
937       /* Transport Detail Element */
938       I2O_SGE_TRANSPORT_ELEMENT           Transport;
939#if (defined(sun) && defined(u))
940// there is a macro defined in Solaris sys/user.h for u, rename this to uSG
941   } uSG ;
942#else
943   } u ;
944#endif
945} I2O_SG_ELEMENT, *PI2O_SG_ELEMENT;
946
947/****************************************************************************/
948/*  Basic Parameter Group Access */
949/****************************************************************************/
950
951/* Operation Function Numbers */
952
953#define   I2O_PARAMS_OPERATION_FIELD_GET               0x0001
954#define   I2O_PARAMS_OPERATION_LIST_GET                0x0002
955#define   I2O_PARAMS_OPERATION_MORE_GET                0x0003
956#define   I2O_PARAMS_OPERATION_SIZE_GET                0x0004
957#define   I2O_PARAMS_OPERATION_TABLE_GET               0x0005
958#define   I2O_PARAMS_OPERATION_FIELD_SET               0x0006
959#define   I2O_PARAMS_OPERATION_LIST_SET                0x0007
960#define   I2O_PARAMS_OPERATION_ROW_ADD                 0x0008
961#define   I2O_PARAMS_OPERATION_ROW_DELETE              0x0009
962#define   I2O_PARAMS_OPERATION_TABLE_CLEAR             0x000A
963
964/* Operations List Header */
965
966typedef struct _I2O_PARAM_OPERATIONS_LIST_HEADER {
967   U16                         OperationCount;
968   U16                         Reserved;
969} I2O_PARAM_OPERATIONS_LIST_HEADER, *PI2O_PARAM_OPERATIONS_LIST_HEADER;
970
971/* Results List Header */
972
973typedef struct _I2O_PARAM_RESULTS_LIST_HEADER {
974   U16                         ResultCount;
975   U16                         Reserved;
976} I2O_PARAM_RESULTS_LIST_HEADER, *PI2O_PARAM_RESULTS_LIST_HEADER;
977
978/* Read Operation Result Block Template Structure */
979
980typedef struct _I2O_PARAM_READ_OPERATION_RESULT {
981   U16                         BlockSize;
982   U8                          BlockStatus;
983   U8                          ErrorInfoSize;
984   /*                          Operations Results          */
985   /*                          Pad (if any)                */
986   /*                          ErrorInformation (if any)   */
987} I2O_PARAM_READ_OPERATION_RESULT, *PI2O_PARAM_READ_OPERATION_RESULT;
988
989typedef struct _I2O_TABLE_READ_OPERATION_RESULT {
990   U16                         BlockSize;
991   U8                          BlockStatus;
992   U8                          ErrorInfoSize;
993   U16                         RowCount;
994   U16                         MoreFlag;
995   /*                          Operations Results          */
996   /*                          Pad (if any)                */
997   /*                          ErrorInformation (if any)   */
998} I2O_TABLE_READ_OPERATION_RESULT, *PI2O_TABLE_READ_OPERATION_RESULT;
999
1000/* Error Information Template Structure */
1001
1002typedef struct _I2O_PARAM_ERROR_INFO_TEMPLATE {
1003   U16                         OperationCode;
1004   U16                         GroupNumber;
1005   U16                         FieldIdx;
1006   U8                          AdditionalStatus;
1007   U8                          NumberKeys;
1008   /*                          List of Key Values (variable)   */
1009   /*                          Pad (if any)                    */
1010} I2O_PARAM_ERROR_INFO_TEMPLATE, *PI2O_PARAM_ERROR_INFO_TEMPLATE;
1011
1012/* Operation Template for Specific Fields */
1013
1014typedef struct _I2O_PARAM_OPERATION_SPECIFIC_TEMPLATE {
1015   U16                         Operation;
1016   U16                         GroupNumber;
1017   U16                         FieldCount;
1018   U16                         FieldIdx[1];
1019   /*                          Pad (if any)                    */
1020} I2O_PARAM_OPERATION_SPECIFIC_TEMPLATE, *PI2O_PARAM_OPERATION_SPECIFIC_TEMPLATE;
1021
1022/* Operation Template for All Fields */
1023
1024typedef struct _I2O_PARAM_OPERATION_ALL_TEMPLATE {
1025   U16                         Operation;
1026   U16                         GroupNumber;
1027   U16                         FieldCount;
1028   /*                          Pad (if any)                    */
1029} I2O_PARAM_OPERATION_ALL_TEMPLATE, *PI2O_PARAM_OPERATION_ALL_TEMPLATE;
1030
1031/* Operation Template for All List Fields */
1032
1033typedef struct _I2O_PARAM_OPERATION_ALL_LIST_TEMPLATE {
1034   U16                         Operation;
1035   U16                         GroupNumber;
1036   U16                         FieldCount;
1037   U16                         KeyCount;
1038   U8                          KeyValue;
1039   /*                          Pad (if any)                    */
1040} I2O_PARAM_OPERATION_ALL_LIST_TEMPLATE, *PI2O_PARAM_OPERATION_ALL_LIST_TEMPLATE;
1041
1042/* Modify Operation Result Block Template Structure */
1043
1044typedef struct _I2O_PARAM_MODIFY_OPERATION_RESULT {
1045   U16                         BlockSize;
1046   U8                          BlockStatus;
1047   U8                          ErrorInfoSize;
1048   /*                          ErrorInformation (if any)   */
1049} I2O_PARAM_MODIFY_OPERATION_RESULT, *PI2O_PARAM_MODIFY_OPERATION_RESULT;
1050
1051/* Operation Template for Row Delete  */
1052
1053typedef struct _I2O_PARAM_OPERATION_ROW_DELETE_TEMPLATE {
1054   U16                         Operation;
1055   U16                         GroupNumber;
1056   U16                         RowCount;
1057   U8                          KeyValue;
1058} I2O_PARAM_OPERATION_ROW_DELETE_TEMPLATE, *PI2O_PARAM_OPERATION_ROW_DELETE_TEMPLATE;
1059
1060/* Operation Template for Table Clear  */
1061
1062typedef struct _I2O_PARAM_OPERATION_TABLE_CLEAR_TEMPLATE {
1063   U16                         Operation;
1064   U16                         GroupNumber;
1065} I2O_PARAM_OPERATION_TABLE_CLEAR_TEMPLATE, *PI2O_PARAM_OPERATION_TABLE_CLEAR_TEMPLATE;
1066
1067/* Status codes and Error Information for Parameter functions */
1068
1069#define   I2O_PARAMS_STATUS_SUCCESS                0x00
1070#define   I2O_PARAMS_STATUS_BAD_KEY_ABORT          0x01
1071#define   I2O_PARAMS_STATUS_BAD_KEY_CONTINUE       0x02
1072#define   I2O_PARAMS_STATUS_BUFFER_FULL            0x03
1073#define   I2O_PARAMS_STATUS_BUFFER_TOO_SMALL       0x04
1074#define   I2O_PARAMS_STATUS_FIELD_UNREADABLE       0x05
1075#define   I2O_PARAMS_STATUS_FIELD_UNWRITEABLE      0x06
1076#define   I2O_PARAMS_STATUS_INSUFFICIENT_FIELDS    0x07
1077#define   I2O_PARAMS_STATUS_INVALID_GROUP_ID       0x08
1078#define   I2O_PARAMS_STATUS_INVALID_OPERATION      0x09
1079#define   I2O_PARAMS_STATUS_NO_KEY_FIELD           0x0A
1080#define   I2O_PARAMS_STATUS_NO_SUCH_FIELD          0x0B
1081#define   I2O_PARAMS_STATUS_NON_DYNAMIC_GROUP      0x0C
1082#define   I2O_PARAMS_STATUS_OPERATION_ERROR        0x0D
1083#define   I2O_PARAMS_STATUS_SCALAR_ERROR           0x0E
1084#define   I2O_PARAMS_STATUS_TABLE_ERROR            0x0F
1085#define   I2O_PARAMS_STATUS_WRONG_GROUP_TYPE       0x10
1086
1087
1088/****************************************************************************/
1089/* GROUP Parameter Groups */
1090/****************************************************************************/
1091
1092/* GROUP Configuration and Operating Structures and Defines */
1093
1094/* Groups Numbers */
1095
1096#define    I2O_UTIL_PARAMS_DESCRIPTOR_GROUP_NO          0xF000
1097#define    I2O_UTIL_PHYSICAL_DEVICE_TABLE_GROUP_NO      0xF001
1098#define    I2O_UTIL_CLAIMED_TABLE_GROUP_NO              0xF002
1099#define    I2O_UTIL_USER_TABLE_GROUP_NO                 0xF003
1100#define    I2O_UTIL_PRIVATE_MESSAGE_EXTENSIONS_GROUP_NO 0xF005
1101#define    I2O_UTIL_AUTHORIZED_USER_TABLE_GROUP_NO      0xF006
1102#define    I2O_UTIL_DEVICE_IDENTITY_GROUP_NO            0xF100
1103#define    I2O_UTIL_DDM_IDENTITY_GROUP_NO               0xF101
1104#define    I2O_UTIL_USER_INFORMATION_GROUP_NO           0xF102
1105#define    I2O_UTIL_SGL_OPERATING_LIMITS_GROUP_NO       0xF103
1106#define    I2O_UTIL_SENSORS_GROUP_NO                    0xF200
1107
1108/* UTIL Group F000h - GROUP DESCRIPTORS Parameter Group */
1109
1110#define    I2O_UTIL_GROUP_PROPERTIES_GROUP_TABLE       0x01
1111#define    I2O_UTIL_GROUP_PROPERTIES_ROW_ADDITION      0x02
1112#define    I2O_UTIL_GROUP_PROPERTIES_ROW_DELETION      0x04
1113#define    I2O_UTIL_GROUP_PROPERTIES_CLEAR_OPERATION   0x08
1114
1115typedef struct _I2O_UTIL_GROUP_DESCRIPTOR_TABLE {
1116   U16                         GroupNumber;
1117   U16                         FieldCount;
1118   U16                         RowCount;
1119   U8                          Properties;
1120   U8                          reserved;
1121} I2O_UTIL_GROUP_DESCRIPTOR_TABLE, *PI2O_UTIL_GROUP_DESCRIPTOR_TABLE;
1122
1123/* UTIL Group F001h - Physical Device Table Parameter Group */
1124
1125typedef struct _I2O_UTIL_PHYSICAL_DEVICE_TABLE {
1126   U32                         AdapterID;
1127} I2O_UTIL_PHYSICAL_DEVICE_TABLE, *PI2O_UTIL_PHYSICAL_DEVICE_TABLE;
1128
1129/* UTIL Group F002h - Claimed Table Parameter Group */
1130
1131typedef struct _I2O_UTIL_CLAIMED_TABLE {
1132   U16                         ClaimedTID;
1133} I2O_UTIL_CLAIMED_TABLE, *PI2O_UTIL_CLAIMED_TABLE;
1134
1135/* UTIL Group F003h - User Table Parameter Group */
1136
1137typedef struct _I2O_UTIL_USER_TABLE {
1138   U16                         Instance;
1139   U16                         UserTID;
1140   U8                          ClaimType;
1141   U8                          reserved1;
1142   U16                         reserved2;
1143} I2O_UTIL_USER_TABLE, *PI2O_UTIL_USER_TABLE;
1144
1145/* UTIL Group F005h - Private Message Extensions Parameter Group */
1146
1147typedef struct _I2O_UTIL_PRIVATE_MESSAGE_EXTENSIONS_TABLE {
1148   U16                         ExtInstance;
1149   U16                         OrganizationID;
1150   U16                         XFunctionCode;
1151} I2O_UTIL_PRIVATE_MESSAGE_EXTENSIONS_TABLE, *PI2O_UTIL_PRIVATE_MESSAGE_EXTENSIONS_TABLE;
1152
1153/* UTIL Group F006h - Authorized User Table Parameter Group */
1154
1155typedef struct _I2O_UTIL_AUTHORIZED_USER_TABLE {
1156   U16                         AlternateTID;
1157} I2O_UTIL_AUTHORIZED_USER_TABLE, *PI2O_UTIL_AUTHORIZED_USER_TABLE;
1158
1159/* UTIL Group F100h - Device Identity Parameter Group */
1160
1161typedef struct _I2O_UTIL_DEVICE_IDENTITY_SCALAR {
1162   U32                         ClassID;
1163   U16                         OwnerTID;
1164   U16                         ParentTID;
1165   U8                          VendorInfo[I2O_DEVID_VENDOR_INFO_SZ];
1166   U8                          ProductInfo[I2O_DEVID_PRODUCT_INFO_SZ];
1167   U8                          Description[I2O_DEVID_DESCRIPTION_SZ];
1168   U8                          ProductRevLevel[I2O_DEVID_REV_LEVEL_SZ];
1169   U8                          SNFormat;
1170   U8                          SerialNumber[I2O_MAX_SERIAL_NUMBER_SZ];
1171} I2O_UTIL_DEVICE_IDENTITY_SCALAR, *PI2O_UTIL_DEVICE_IDENTITY_SCALAR;
1172
1173/* UTIL Group F101h - DDM Identity Parameter Group */
1174
1175typedef struct _I2O_UTIL_DDM_IDENTITY_SCALAR {
1176   U16                         DdmTID;
1177   U8                          ModuleName[I2O_MODULE_NAME_SZ];
1178   U8                          ModuleRevLevel[I2O_DEVID_REV_LEVEL_SZ];
1179   U8                          SNFormat;
1180   U8                          SerialNumber[I2O_MAX_SERIAL_NUMBER_SZ];
1181} I2O_UTIL_DDM_IDENTITY_SCALAR, *PI2O_UTIL_DDM_IDENTITY_SCALAR;
1182
1183/* UTIL Group F102h - User Information Parameter Group */
1184
1185#define    I2O_USER_DEVICE_NAME_SZ                     64
1186#define    I2O_USER_SERVICE_NAME_SZ                    64
1187#define    I2O_USER_PHYSICAL_LOCATION_SZ               64
1188
1189typedef struct _I2O_UTIL_USER_INFORMATION_SCALAR {
1190   U8                          DeviceName[I2O_USER_DEVICE_NAME_SZ];
1191   U8                          ServiceName[I2O_USER_SERVICE_NAME_SZ];
1192   U8                          PhysicalLocation[I2O_USER_PHYSICAL_LOCATION_SZ];
1193   U32                         InstanceNumber;
1194} I2O_UTIL_USER_INFORMATION_SCALAR, *PI2O_UTIL_USER_INFORMATION_SCALAR;
1195
1196/* UTIL Group F103h - SGL Operating Limits Parameter Group */
1197
1198typedef struct _I2O_UTIL_SGL_OPERATING_LIMITS_SCALAR {
1199   U32                         SglChainSize;
1200   U32                         SglChainSizeMax;
1201   U32                         SglChainSizeTarget;
1202   U16                         SglFragCount;
1203   U16                         SglFragCountMax;
1204   U16                         SglFragCountTarget;
1205} I2O_UTIL_SGL_OPERATING_LIMITS_SCALAR, *PI2O_UTIL_SGL_OPERATING_LIMITS_SCALAR;
1206
1207/* UTIL Group F200h - Sensors Parameter Group */
1208
1209#define    I2O_SENSOR_COMPONENT_OTHER                  0x00
1210#define    I2O_SENSOR_COMPONENT_PLANAR_LOGIC_BOARD     0x01
1211#define    I2O_SENSOR_COMPONENT_CPU                    0x02
1212#define    I2O_SENSOR_COMPONENT_CHASSIS                0x03
1213#define    I2O_SENSOR_COMPONENT_POWER_SUPPLY           0x04
1214#define    I2O_SENSOR_COMPONENT_STORAGE                0x05
1215#define    I2O_SENSOR_COMPONENT_EXTERNAL               0x06
1216
1217#define    I2O_SENSOR_SENSOR_CLASS_ANALOG              0x00
1218#define    I2O_SENSOR_SENSOR_CLASS_DIGITAL             0x01
1219
1220#define    I2O_SENSOR_SENSOR_TYPE_OTHER                0x00
1221#define    I2O_SENSOR_SENSOR_TYPE_THERMAL              0x01
1222#define    I2O_SENSOR_SENSOR_TYPE_DC_VOLTAGE           0x02
1223#define    I2O_SENSOR_SENSOR_TYPE_AC_VOLTAGE           0x03
1224#define    I2O_SENSOR_SENSOR_TYPE_DC_CURRENT           0x04
1225#define    I2O_SENSOR_SENSOR_TYPE_AC_CURRENT           0x05
1226#define    I2O_SENSOR_SENSOR_TYPE_DOOR_OPEN            0x06
1227#define    I2O_SENSOR_SENSOR_TYPE_FAN_OPERATIONAL      0x07
1228
1229#define    I2O_SENSOR_SENSOR_STATE_NORMAL              0x00
1230#define    I2O_SENSOR_SENSOR_STATE_ABNORMAL            0x01
1231#define    I2O_SENSOR_SENSOR_STATE_UNKNOWN             0x02
1232#define    I2O_SENSOR_SENSOR_STATE_LOW_CAT             0x03
1233#define    I2O_SENSOR_SENSOR_STATE_LOW                 0x04
1234#define    I2O_SENSOR_SENSOR_STATE_LOW_WARNING         0x05
1235#define    I2O_SENSOR_SENSOR_STATE_HIGH_WARNING        0x06
1236#define    I2O_SENSOR_SENSOR_STATE_HIGH                0x07
1237#define    I2O_SENSOR_SENSOR_STATE_HIGH_CAT            0x08
1238
1239#define    I2O_SENSOR_EVENT_ENABLE_STATE_CHANGE        0x0001
1240#define    I2O_SENSOR_EVENT_ENABLE_LOW_CATASTROPHIC    0x0002
1241#define    I2O_SENSOR_EVENT_ENABLE_LOW_READING         0x0004
1242#define    I2O_SENSOR_EVENT_ENABLE_LOW_WARNING         0x0008
1243#define    I2O_SENSOR_EVENT_ENABLE_CHANGE_TO_NORMAL    0x0010
1244#define    I2O_SENSOR_EVENT_ENABLE_HIGH_WARNING        0x0020
1245#define    I2O_SENSOR_EVENT_ENABLE_HIGH_READING        0x0040
1246#define    I2O_SENSOR_EVENT_ENABLE_HIGH_CATASTROPHIC   0x0080
1247
1248
1249typedef struct _I2O_UTIL_SENSORS_TABLE {
1250   U16                         SensorInstance;
1251   U8                          Component;
1252   U16                         ComponentInstance;
1253   U8                          SensorClass;
1254   U8                          SensorType;
1255   S8                          ScalingExponent;
1256   S32                         ActualReading;
1257   S32                         MinimumReading;
1258   S32                         Low2LowCatThreshold;
1259   S32                         LowCat2LowThreshold;
1260   S32                         LowWarn2LowThreshold;
1261   S32                         Low2LowWarnThreshold;
1262   S32                         Norm2LowWarnThreshold;
1263   S32                         LowWarn2NormThreshold;
1264   S32                         NominalReading;
1265   S32                         HiWarn2NormThreshold;
1266   S32                         Norm2HiWarnThreshold;
1267   S32                         High2HiWarnThreshold;
1268   S32                         HiWarn2HighThreshold;
1269   S32                         HiCat2HighThreshold;
1270   S32                         Hi2HiCatThreshold;
1271   S32                         MaximumReading;
1272   U8                          SensorState;
1273   U16                         EventEnable;
1274} I2O_UTIL_SENSORS_TABLE, *PI2O_UTIL_SENSORS_TABLE;
1275
1276
1277PRAGMA_PACK_POP
1278
1279PRAGMA_ALIGN_POP
1280
1281#endif    /* I2O_MESSAGE_HDR */
1282