1/*-
2 *  Copyright 2000-2020 Broadcom Inc. All rights reserved.
3 *
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions
6 * are met:
7 * 1. Redistributions of source code must retain the above copyright
8 *    notice, this list of conditions and the following disclaimer.
9 * 2. Redistributions in binary form must reproduce the above copyright
10 *    notice, this list of conditions and the following disclaimer in the
11 *    documentation and/or other materials provided with the distribution.
12 * 3. Neither the name of the author nor the names of any co-contributors
13 *    may be used to endorse or promote products derived from this software
14 *    without specific prior written permission.
15 *
16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' 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 THE AUTHOR OR CONTRIBUTORS BE LIABLE
20 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26 * SUCH DAMAGE.
27 *
28 * Broadcom Inc. (LSI) MPT-Fusion Host Adapter FreeBSD
29 *
30 * $FreeBSD$
31 */
32
33/*
34 *  Copyright 2000-2020 Broadcom Inc. All rights reserved.
35 *
36 *
37 *           Name:  mpi2_hbd.h
38 *          Title:  MPI Host Based Discovery messages and structures
39 *  Creation Date:  October 21, 2009
40 *
41 *  mpi2_hbd.h Version:  02.00.04
42 *
43 *  NOTE: Names (typedefs, defines, etc.) beginning with an MPI25 or Mpi25
44 *        prefix are for use only on MPI v2.5 products, and must not be used
45 *        with MPI v2.0 products. Unless otherwise noted, names beginning with
46 *        MPI2 or Mpi2 are for use with both MPI v2.0 and MPI v2.5 products.
47 *
48 *  Version History
49 *  ---------------
50 *
51 *  Date      Version   Description
52 *  --------  --------  ------------------------------------------------------
53 *  10-28-09  02.00.00  Initial version.
54 *  08-11-10  02.00.01  Removed PortGroups, DmaGroup, and ControlGroup from
55 *                      HBD Action request, replaced by AdditionalInfo field.
56 *  11-18-11  02.00.02  Incorporating additions for MPI v2.5.
57 *  11-18-14  02.00.03  Updated copyright information.
58 *  02-17-16  02.00.04  Added SAS 4 22.5 gbs speed support.
59 *  --------------------------------------------------------------------------
60 */
61
62#ifndef MPI2_HBD_H
63#define MPI2_HBD_H
64
65/****************************************************************************
66*  Host Based Discovery Action messages
67****************************************************************************/
68
69/* Host Based Discovery Action Request Message */
70typedef struct _MPI2_HBD_ACTION_REQUEST
71{
72    U8                      Operation;          /* 0x00 */
73    U8                      Reserved1;          /* 0x01 */
74    U8                      ChainOffset;        /* 0x02 */
75    U8                      Function;           /* 0x03 */
76    U16                     DevHandle;          /* 0x04 */
77    U8                      Reserved2;          /* 0x06 */
78    U8                      MsgFlags;           /* 0x07 */
79    U8                      VP_ID;              /* 0x08 */
80    U8                      VF_ID;              /* 0x09 */
81    U16                     Reserved3;          /* 0x0A */
82    U32                     Reserved4;          /* 0x0C */
83    U64                     SASAddress;         /* 0x10 */
84    U32                     Reserved5;          /* 0x18 */
85    U32                     HbdDeviceInfo;      /* 0x1C */
86    U16                     ParentDevHandle;    /* 0x20 */
87    U16                     MaxQDepth;          /* 0x22 */
88    U8                      FirstPhyIdentifier; /* 0x24 */
89    U8                      Port;               /* 0x25 */
90    U8                      MaxConnections;     /* 0x26 */
91    U8                      MaxRate;            /* 0x27 */
92    U32                     AdditionalInfo;     /* 0x28 */
93    U16                     InitialAWT;         /* 0x2C */
94    U16                     Reserved7;          /* 0x2E */
95    U32                     Reserved8;          /* 0x30 */
96} MPI2_HBD_ACTION_REQUEST, MPI2_POINTER PTR_MPI2_HBD_ACTION_REQUEST,
97  Mpi2HbdActionRequest_t, MPI2_POINTER pMpi2HbdActionRequest_t;
98
99/* values for the Operation field */
100#define MPI2_HBD_OP_ADD_DEVICE                  (0x01)
101#define MPI2_HBD_OP_REMOVE_DEVICE               (0x02)
102#define MPI2_HBD_OP_UPDATE_DEVICE               (0x03)
103
104/* values for the HbdDeviceInfo field */
105#define MPI2_HBD_DEVICE_INFO_VIRTUAL_DEVICE     (0x00004000)
106#define MPI2_HBD_DEVICE_INFO_ATAPI_DEVICE       (0x00002000)
107#define MPI2_HBD_DEVICE_INFO_DIRECT_ATTACH      (0x00000800)
108#define MPI2_HBD_DEVICE_INFO_SSP_TARGET         (0x00000400)
109#define MPI2_HBD_DEVICE_INFO_STP_TARGET         (0x00000200)
110#define MPI2_HBD_DEVICE_INFO_SMP_TARGET         (0x00000100)
111#define MPI2_HBD_DEVICE_INFO_SATA_DEVICE        (0x00000080)
112#define MPI2_HBD_DEVICE_INFO_SSP_INITIATOR      (0x00000040)
113#define MPI2_HBD_DEVICE_INFO_STP_INITIATOR      (0x00000020)
114#define MPI2_HBD_DEVICE_INFO_SMP_INITIATOR      (0x00000010)
115#define MPI2_HBD_DEVICE_INFO_SATA_HOST          (0x00000008)
116
117#define MPI2_HBD_DEVICE_INFO_MASK_DEVICE_TYPE   (0x00000007)
118#define MPI2_HBD_DEVICE_INFO_NO_DEVICE          (0x00000000)
119#define MPI2_HBD_DEVICE_INFO_END_DEVICE         (0x00000001)
120#define MPI2_HBD_DEVICE_INFO_EDGE_EXPANDER      (0x00000002)
121#define MPI2_HBD_DEVICE_INFO_FANOUT_EXPANDER    (0x00000003)
122
123/* values for the MaxRate field */
124#define MPI2_HBD_MAX_RATE_MASK                  (0x0F)
125#define MPI2_HBD_MAX_RATE_1_5                   (0x08)
126#define MPI2_HBD_MAX_RATE_3_0                   (0x09)
127#define MPI2_HBD_MAX_RATE_6_0                   (0x0A)
128#define MPI25_HBD_MAX_RATE_12_0                 (0x0B)
129#define MPI26_HBD_MAX_RATE_22_5                 (0x0C)
130
131/* Host Based Discovery Action Reply Message */
132typedef struct _MPI2_HBD_ACTION_REPLY
133{
134    U8                      Operation;          /* 0x00 */
135    U8                      Reserved1;          /* 0x01 */
136    U8                      MsgLength;          /* 0x02 */
137    U8                      Function;           /* 0x03 */
138    U16                     DevHandle;          /* 0x04 */
139    U8                      Reserved2;          /* 0x06 */
140    U8                      MsgFlags;           /* 0x07 */
141    U8                      VP_ID;              /* 0x08 */
142    U8                      VF_ID;              /* 0x09 */
143    U16                     Reserved3;          /* 0x0A */
144    U16                     Reserved4;          /* 0x0C */
145    U16                     IOCStatus;          /* 0x0E */
146    U32                     IOCLogInfo;         /* 0x10 */
147} MPI2_HBD_ACTION_REPLY, MPI2_POINTER PTR_MPI2_HBD_ACTION_REPLY,
148  Mpi2HbdActionReply_t, MPI2_POINTER pMpi2HbdActionReply_t;
149
150#endif
151