1 /* SPDX-License-Identifier: GPL-2.0 OR BSD-2-Clause */ 2 /* 3 * Copyright 2018-2024 Amazon.com, Inc. or its affiliates. All rights reserved. 4 */ 5 6 #ifndef _EFA_ADMIN_H_ 7 #define _EFA_ADMIN_H_ 8 9 enum efa_admin_aq_completion_status { 10 EFA_ADMIN_SUCCESS = 0, 11 EFA_ADMIN_RESOURCE_ALLOCATION_FAILURE = 1, 12 EFA_ADMIN_BAD_OPCODE = 2, 13 EFA_ADMIN_UNSUPPORTED_OPCODE = 3, 14 EFA_ADMIN_MALFORMED_REQUEST = 4, 15 /* Additional status is provided in ACQ entry extended_status */ 16 EFA_ADMIN_ILLEGAL_PARAMETER = 5, 17 EFA_ADMIN_UNKNOWN_ERROR = 6, 18 EFA_ADMIN_RESOURCE_BUSY = 7, 19 }; 20 21 struct efa_admin_aq_common_desc { 22 /* 23 * 11:0 : command_id 24 * 15:12 : reserved12 25 */ 26 u16 command_id; 27 28 /* as appears in efa_admin_aq_opcode */ 29 u8 opcode; 30 31 /* 32 * 0 : phase 33 * 1 : ctrl_data - control buffer address valid 34 * 2 : ctrl_data_indirect - control buffer address 35 * points to list of pages with addresses of control 36 * buffers 37 * 7:3 : reserved3 38 */ 39 u8 flags; 40 }; 41 42 /* 43 * used in efa_admin_aq_entry. Can point directly to control data, or to a 44 * page list chunk. Used also at the end of indirect mode page list chunks, 45 * for chaining. 46 */ 47 struct efa_admin_ctrl_buff_info { 48 u32 length; 49 50 struct efa_common_mem_addr address; 51 }; 52 53 struct efa_admin_aq_entry { 54 struct efa_admin_aq_common_desc aq_common_descriptor; 55 56 union { 57 u32 inline_data_w1[3]; 58 59 struct efa_admin_ctrl_buff_info control_buffer; 60 } u; 61 62 u32 inline_data_w4[12]; 63 }; 64 65 struct efa_admin_acq_common_desc { 66 /* 67 * command identifier to associate it with the aq descriptor 68 * 11:0 : command_id 69 * 15:12 : reserved12 70 */ 71 u16 command; 72 73 u8 status; 74 75 /* 76 * 0 : phase 77 * 7:1 : reserved1 78 */ 79 u8 flags; 80 81 u16 extended_status; 82 83 /* 84 * indicates to the driver which AQ entry has been consumed by the 85 * device and could be reused 86 */ 87 u16 sq_head_indx; 88 }; 89 90 struct efa_admin_acq_entry { 91 struct efa_admin_acq_common_desc acq_common_descriptor; 92 93 u32 response_specific_data[14]; 94 }; 95 96 struct efa_admin_aenq_common_desc { 97 u16 group; 98 99 u16 syndrome; 100 101 /* 102 * 0 : phase 103 * 7:1 : reserved - MBZ 104 */ 105 u8 flags; 106 107 u8 reserved1[3]; 108 109 u32 timestamp_low; 110 111 u32 timestamp_high; 112 }; 113 114 struct efa_admin_aenq_entry { 115 struct efa_admin_aenq_common_desc aenq_common_desc; 116 117 /* command specific inline data */ 118 u32 inline_data_w4[12]; 119 }; 120 121 enum efa_admin_eqe_event_type { 122 EFA_ADMIN_EQE_EVENT_TYPE_COMPLETION = 0, 123 }; 124 125 /* Completion event */ 126 struct efa_admin_comp_event { 127 /* CQ number */ 128 u16 cqn; 129 130 /* MBZ */ 131 u16 reserved; 132 133 /* MBZ */ 134 u32 reserved2; 135 }; 136 137 /* Event Queue Element */ 138 struct efa_admin_eqe { 139 /* 140 * 0 : phase 141 * 8:1 : event_type - Event type 142 * 31:9 : reserved - MBZ 143 */ 144 u32 common; 145 146 /* MBZ */ 147 u32 reserved; 148 149 union { 150 /* Event data */ 151 u32 event_data[2]; 152 153 /* Completion Event */ 154 struct efa_admin_comp_event comp_event; 155 } u; 156 }; 157 158 /* aq_common_desc */ 159 #define EFA_ADMIN_AQ_COMMON_DESC_COMMAND_ID_MASK GENMASK(11, 0) 160 #define EFA_ADMIN_AQ_COMMON_DESC_PHASE_MASK BIT(0) 161 #define EFA_ADMIN_AQ_COMMON_DESC_CTRL_DATA_MASK BIT(1) 162 #define EFA_ADMIN_AQ_COMMON_DESC_CTRL_DATA_INDIRECT_MASK BIT(2) 163 164 /* acq_common_desc */ 165 #define EFA_ADMIN_ACQ_COMMON_DESC_COMMAND_ID_MASK GENMASK(11, 0) 166 #define EFA_ADMIN_ACQ_COMMON_DESC_PHASE_MASK BIT(0) 167 168 /* aenq_common_desc */ 169 #define EFA_ADMIN_AENQ_COMMON_DESC_PHASE_MASK BIT(0) 170 171 /* eqe */ 172 #define EFA_ADMIN_EQE_PHASE_MASK BIT(0) 173 #define EFA_ADMIN_EQE_EVENT_TYPE_MASK GENMASK(8, 1) 174 175 #endif /* _EFA_ADMIN_H_ */ 176