1 /* SPDX-License-Identifier: (BSD-3-Clause OR GPL-2.0-only) */ 2 /* Copyright(c) 2014 - 2020 Intel Corporation */ 3 #ifndef _ICP_QAT_FW_H_ 4 #define _ICP_QAT_FW_H_ 5 #include <linux/types.h> 6 #include "icp_qat_hw.h" 7 8 #define QAT_FIELD_SET(flags, val, bitpos, mask) \ 9 { (flags) = (((flags) & (~((mask) << (bitpos)))) | \ 10 (((val) & (mask)) << (bitpos))) ; } 11 12 #define QAT_FIELD_GET(flags, bitpos, mask) \ 13 (((flags) >> (bitpos)) & (mask)) 14 15 #define ICP_QAT_FW_REQ_DEFAULT_SZ 128 16 #define ICP_QAT_FW_RESP_DEFAULT_SZ 32 17 #define ICP_QAT_FW_COMN_ONE_BYTE_SHIFT 8 18 #define ICP_QAT_FW_COMN_SINGLE_BYTE_MASK 0xFF 19 #define ICP_QAT_FW_NUM_LONGWORDS_1 1 20 #define ICP_QAT_FW_NUM_LONGWORDS_2 2 21 #define ICP_QAT_FW_NUM_LONGWORDS_3 3 22 #define ICP_QAT_FW_NUM_LONGWORDS_4 4 23 #define ICP_QAT_FW_NUM_LONGWORDS_5 5 24 #define ICP_QAT_FW_NUM_LONGWORDS_6 6 25 #define ICP_QAT_FW_NUM_LONGWORDS_7 7 26 #define ICP_QAT_FW_NUM_LONGWORDS_10 10 27 #define ICP_QAT_FW_NUM_LONGWORDS_13 13 28 #define ICP_QAT_FW_NULL_REQ_SERV_ID 1 29 30 enum icp_qat_fw_comn_resp_serv_id { 31 ICP_QAT_FW_COMN_RESP_SERV_NULL, 32 ICP_QAT_FW_COMN_RESP_SERV_CPM_FW, 33 ICP_QAT_FW_COMN_RESP_SERV_DELIMITER 34 }; 35 36 enum icp_qat_fw_comn_request_id { 37 ICP_QAT_FW_COMN_REQ_NULL = 0, 38 ICP_QAT_FW_COMN_REQ_CPM_FW_PKE = 3, 39 ICP_QAT_FW_COMN_REQ_CPM_FW_LA = 4, 40 ICP_QAT_FW_COMN_REQ_CPM_FW_DMA = 7, 41 ICP_QAT_FW_COMN_REQ_CPM_FW_COMP = 9, 42 ICP_QAT_FW_COMN_REQ_DELIMITER 43 }; 44 45 struct icp_qat_fw_comn_req_hdr_cd_pars { 46 union { 47 struct { 48 __u64 content_desc_addr; 49 __u16 content_desc_resrvd1; 50 __u8 content_desc_params_sz; 51 __u8 content_desc_hdr_resrvd2; 52 __u32 content_desc_resrvd3; 53 } s; 54 struct { 55 __u32 serv_specif_fields[4]; 56 } s1; 57 } u; 58 }; 59 60 struct icp_qat_fw_comn_req_mid { 61 __u64 opaque_data; 62 __u64 src_data_addr; 63 __u64 dest_data_addr; 64 __u32 src_length; 65 __u32 dst_length; 66 }; 67 68 struct icp_qat_fw_comn_req_cd_ctrl { 69 __u32 content_desc_ctrl_lw[ICP_QAT_FW_NUM_LONGWORDS_5]; 70 }; 71 72 struct icp_qat_fw_comn_req_hdr { 73 __u8 resrvd1; 74 __u8 service_cmd_id; 75 __u8 service_type; 76 __u8 hdr_flags; 77 __u16 serv_specif_flags; 78 __u16 comn_req_flags; 79 }; 80 81 struct icp_qat_fw_comn_req_rqpars { 82 __u32 serv_specif_rqpars_lw[ICP_QAT_FW_NUM_LONGWORDS_13]; 83 }; 84 85 struct icp_qat_fw_comn_req { 86 struct icp_qat_fw_comn_req_hdr comn_hdr; 87 struct icp_qat_fw_comn_req_hdr_cd_pars cd_pars; 88 struct icp_qat_fw_comn_req_mid comn_mid; 89 struct icp_qat_fw_comn_req_rqpars serv_specif_rqpars; 90 struct icp_qat_fw_comn_req_cd_ctrl cd_ctrl; 91 }; 92 93 struct icp_qat_fw_comn_error { 94 __u8 xlat_err_code; 95 __u8 cmp_err_code; 96 }; 97 98 struct icp_qat_fw_comn_resp_hdr { 99 __u8 resrvd1; 100 __u8 service_id; 101 __u8 response_type; 102 __u8 hdr_flags; 103 struct icp_qat_fw_comn_error comn_error; 104 __u8 comn_status; 105 __u8 cmd_id; 106 }; 107 108 struct icp_qat_fw_comn_resp { 109 struct icp_qat_fw_comn_resp_hdr comn_hdr; 110 __u64 opaque_data; 111 __u32 resrvd[ICP_QAT_FW_NUM_LONGWORDS_4]; 112 }; 113 114 #define ICP_QAT_FW_COMN_REQ_FLAG_SET 1 115 #define ICP_QAT_FW_COMN_REQ_FLAG_CLR 0 116 #define ICP_QAT_FW_COMN_VALID_FLAG_BITPOS 7 117 #define ICP_QAT_FW_COMN_VALID_FLAG_MASK 0x1 118 #define ICP_QAT_FW_COMN_HDR_RESRVD_FLD_MASK 0x7F 119 #define ICP_QAT_FW_COMN_CNV_FLAG_BITPOS 6 120 #define ICP_QAT_FW_COMN_CNV_FLAG_MASK 0x1 121 #define ICP_QAT_FW_COMN_CNVNR_FLAG_BITPOS 5 122 #define ICP_QAT_FW_COMN_CNVNR_FLAG_MASK 0x1 123 124 #define ICP_QAT_FW_COMN_OV_SRV_TYPE_GET(icp_qat_fw_comn_req_hdr_t) \ 125 icp_qat_fw_comn_req_hdr_t.service_type 126 127 #define ICP_QAT_FW_COMN_OV_SRV_TYPE_SET(icp_qat_fw_comn_req_hdr_t, val) \ 128 icp_qat_fw_comn_req_hdr_t.service_type = val 129 130 #define ICP_QAT_FW_COMN_OV_SRV_CMD_ID_GET(icp_qat_fw_comn_req_hdr_t) \ 131 icp_qat_fw_comn_req_hdr_t.service_cmd_id 132 133 #define ICP_QAT_FW_COMN_OV_SRV_CMD_ID_SET(icp_qat_fw_comn_req_hdr_t, val) \ 134 icp_qat_fw_comn_req_hdr_t.service_cmd_id = val 135 136 #define ICP_QAT_FW_COMN_HDR_VALID_FLAG_GET(hdr_t) \ 137 ICP_QAT_FW_COMN_VALID_FLAG_GET(hdr_t.hdr_flags) 138 139 #define ICP_QAT_FW_COMN_HDR_CNVNR_FLAG_GET(hdr_flags) \ 140 QAT_FIELD_GET(hdr_flags, \ 141 ICP_QAT_FW_COMN_CNVNR_FLAG_BITPOS, \ 142 ICP_QAT_FW_COMN_CNVNR_FLAG_MASK) 143 144 #define ICP_QAT_FW_COMN_HDR_CNVNR_FLAG_SET(hdr_t, val) \ 145 QAT_FIELD_SET((hdr_t.hdr_flags), (val), \ 146 ICP_QAT_FW_COMN_CNVNR_FLAG_BITPOS, \ 147 ICP_QAT_FW_COMN_CNVNR_FLAG_MASK) 148 149 #define ICP_QAT_FW_COMN_HDR_CNV_FLAG_GET(hdr_flags) \ 150 QAT_FIELD_GET(hdr_flags, \ 151 ICP_QAT_FW_COMN_CNV_FLAG_BITPOS, \ 152 ICP_QAT_FW_COMN_CNV_FLAG_MASK) 153 154 #define ICP_QAT_FW_COMN_ST_BLK_FLAG_BITPOS 4 155 #define ICP_QAT_FW_COMN_ST_BLK_FLAG_MASK 0x1 156 #define ICP_QAT_FW_COMN_HDR_ST_BLK_FLAG_GET(hdr_flags) \ 157 QAT_FIELD_GET(hdr_flags, \ 158 ICP_QAT_FW_COMN_ST_BLK_FLAG_BITPOS, \ 159 ICP_QAT_FW_COMN_ST_BLK_FLAG_MASK) 160 161 #define ICP_QAT_FW_COMN_HDR_CNV_FLAG_SET(hdr_t, val) \ 162 QAT_FIELD_SET((hdr_t.hdr_flags), (val), \ 163 ICP_QAT_FW_COMN_CNV_FLAG_BITPOS, \ 164 ICP_QAT_FW_COMN_CNV_FLAG_MASK) 165 166 #define ICP_QAT_FW_COMN_HDR_VALID_FLAG_SET(hdr_t, val) \ 167 ICP_QAT_FW_COMN_VALID_FLAG_SET(hdr_t, val) 168 169 #define ICP_QAT_FW_COMN_VALID_FLAG_GET(hdr_flags) \ 170 QAT_FIELD_GET(hdr_flags, \ 171 ICP_QAT_FW_COMN_VALID_FLAG_BITPOS, \ 172 ICP_QAT_FW_COMN_VALID_FLAG_MASK) 173 174 #define ICP_QAT_FW_COMN_HDR_RESRVD_FLD_GET(hdr_flags) \ 175 (hdr_flags & ICP_QAT_FW_COMN_HDR_RESRVD_FLD_MASK) 176 177 #define ICP_QAT_FW_COMN_VALID_FLAG_SET(hdr_t, val) \ 178 QAT_FIELD_SET((hdr_t.hdr_flags), (val), \ 179 ICP_QAT_FW_COMN_VALID_FLAG_BITPOS, \ 180 ICP_QAT_FW_COMN_VALID_FLAG_MASK) 181 182 #define ICP_QAT_FW_COMN_HDR_FLAGS_BUILD(valid) \ 183 (((valid) & ICP_QAT_FW_COMN_VALID_FLAG_MASK) << \ 184 ICP_QAT_FW_COMN_VALID_FLAG_BITPOS) 185 186 #define QAT_COMN_PTR_TYPE_BITPOS 0 187 #define QAT_COMN_PTR_TYPE_MASK 0x1 188 #define QAT_COMN_CD_FLD_TYPE_BITPOS 1 189 #define QAT_COMN_CD_FLD_TYPE_MASK 0x1 190 #define QAT_COMN_PTR_TYPE_FLAT 0x0 191 #define QAT_COMN_PTR_TYPE_SGL 0x1 192 #define QAT_COMN_CD_FLD_TYPE_64BIT_ADR 0x0 193 #define QAT_COMN_CD_FLD_TYPE_16BYTE_DATA 0x1 194 195 #define ICP_QAT_FW_COMN_FLAGS_BUILD(cdt, ptr) \ 196 ((((cdt) & QAT_COMN_CD_FLD_TYPE_MASK) << QAT_COMN_CD_FLD_TYPE_BITPOS) \ 197 | (((ptr) & QAT_COMN_PTR_TYPE_MASK) << QAT_COMN_PTR_TYPE_BITPOS)) 198 199 #define ICP_QAT_FW_COMN_PTR_TYPE_GET(flags) \ 200 QAT_FIELD_GET(flags, QAT_COMN_PTR_TYPE_BITPOS, QAT_COMN_PTR_TYPE_MASK) 201 202 #define ICP_QAT_FW_COMN_CD_FLD_TYPE_GET(flags) \ 203 QAT_FIELD_GET(flags, QAT_COMN_CD_FLD_TYPE_BITPOS, \ 204 QAT_COMN_CD_FLD_TYPE_MASK) 205 206 #define ICP_QAT_FW_COMN_PTR_TYPE_SET(flags, val) \ 207 QAT_FIELD_SET(flags, val, QAT_COMN_PTR_TYPE_BITPOS, \ 208 QAT_COMN_PTR_TYPE_MASK) 209 210 #define ICP_QAT_FW_COMN_CD_FLD_TYPE_SET(flags, val) \ 211 QAT_FIELD_SET(flags, val, QAT_COMN_CD_FLD_TYPE_BITPOS, \ 212 QAT_COMN_CD_FLD_TYPE_MASK) 213 214 #define ICP_QAT_FW_COMN_NEXT_ID_BITPOS 4 215 #define ICP_QAT_FW_COMN_NEXT_ID_MASK 0xF0 216 #define ICP_QAT_FW_COMN_CURR_ID_BITPOS 0 217 #define ICP_QAT_FW_COMN_CURR_ID_MASK 0x0F 218 219 #define ICP_QAT_FW_COMN_NEXT_ID_GET(cd_ctrl_hdr_t) \ 220 ((((cd_ctrl_hdr_t)->next_curr_id) & ICP_QAT_FW_COMN_NEXT_ID_MASK) \ 221 >> (ICP_QAT_FW_COMN_NEXT_ID_BITPOS)) 222 223 #define ICP_QAT_FW_COMN_NEXT_ID_SET(cd_ctrl_hdr_t, val) \ 224 { ((cd_ctrl_hdr_t)->next_curr_id) = ((((cd_ctrl_hdr_t)->next_curr_id) \ 225 & ICP_QAT_FW_COMN_CURR_ID_MASK) | \ 226 ((val << ICP_QAT_FW_COMN_NEXT_ID_BITPOS) \ 227 & ICP_QAT_FW_COMN_NEXT_ID_MASK)); } 228 229 #define ICP_QAT_FW_COMN_CURR_ID_GET(cd_ctrl_hdr_t) \ 230 (((cd_ctrl_hdr_t)->next_curr_id) & ICP_QAT_FW_COMN_CURR_ID_MASK) 231 232 #define ICP_QAT_FW_COMN_CURR_ID_SET(cd_ctrl_hdr_t, val) \ 233 { ((cd_ctrl_hdr_t)->next_curr_id) = ((((cd_ctrl_hdr_t)->next_curr_id) \ 234 & ICP_QAT_FW_COMN_NEXT_ID_MASK) | \ 235 ((val) & ICP_QAT_FW_COMN_CURR_ID_MASK)); } 236 237 #define QAT_COMN_RESP_CRYPTO_STATUS_BITPOS 7 238 #define QAT_COMN_RESP_CRYPTO_STATUS_MASK 0x1 239 #define QAT_COMN_RESP_PKE_STATUS_BITPOS 6 240 #define QAT_COMN_RESP_PKE_STATUS_MASK 0x1 241 #define QAT_COMN_RESP_CMP_STATUS_BITPOS 5 242 #define QAT_COMN_RESP_CMP_STATUS_MASK 0x1 243 #define QAT_COMN_RESP_XLAT_STATUS_BITPOS 4 244 #define QAT_COMN_RESP_XLAT_STATUS_MASK 0x1 245 #define QAT_COMN_RESP_CMP_END_OF_LAST_BLK_BITPOS 3 246 #define QAT_COMN_RESP_CMP_END_OF_LAST_BLK_MASK 0x1 247 248 #define ICP_QAT_FW_COMN_RESP_STATUS_BUILD(crypto, comp, xlat, eolb) \ 249 ((((crypto) & QAT_COMN_RESP_CRYPTO_STATUS_MASK) << \ 250 QAT_COMN_RESP_CRYPTO_STATUS_BITPOS) | \ 251 (((comp) & QAT_COMN_RESP_CMP_STATUS_MASK) << \ 252 QAT_COMN_RESP_CMP_STATUS_BITPOS) | \ 253 (((xlat) & QAT_COMN_RESP_XLAT_STATUS_MASK) << \ 254 QAT_COMN_RESP_XLAT_STATUS_BITPOS) | \ 255 (((eolb) & QAT_COMN_RESP_CMP_END_OF_LAST_BLK_MASK) << \ 256 QAT_COMN_RESP_CMP_END_OF_LAST_BLK_BITPOS)) 257 258 #define ICP_QAT_FW_COMN_RESP_CRYPTO_STAT_GET(status) \ 259 QAT_FIELD_GET(status, QAT_COMN_RESP_CRYPTO_STATUS_BITPOS, \ 260 QAT_COMN_RESP_CRYPTO_STATUS_MASK) 261 262 #define ICP_QAT_FW_COMN_RESP_CMP_STAT_GET(status) \ 263 QAT_FIELD_GET(status, QAT_COMN_RESP_CMP_STATUS_BITPOS, \ 264 QAT_COMN_RESP_CMP_STATUS_MASK) 265 266 #define ICP_QAT_FW_COMN_RESP_XLAT_STAT_GET(status) \ 267 QAT_FIELD_GET(status, QAT_COMN_RESP_XLAT_STATUS_BITPOS, \ 268 QAT_COMN_RESP_XLAT_STATUS_MASK) 269 270 #define ICP_QAT_FW_COMN_RESP_CMP_END_OF_LAST_BLK_FLAG_GET(status) \ 271 QAT_FIELD_GET(status, QAT_COMN_RESP_CMP_END_OF_LAST_BLK_BITPOS, \ 272 QAT_COMN_RESP_CMP_END_OF_LAST_BLK_MASK) 273 274 #define ICP_QAT_FW_COMN_STATUS_FLAG_OK 0 275 #define ICP_QAT_FW_COMN_STATUS_FLAG_ERROR 1 276 #define ICP_QAT_FW_COMN_STATUS_CMP_END_OF_LAST_BLK_FLAG_CLR 0 277 #define ICP_QAT_FW_COMN_STATUS_CMP_END_OF_LAST_BLK_FLAG_SET 1 278 #define ERR_CODE_NO_ERROR 0 279 #define ERR_CODE_INVALID_BLOCK_TYPE -1 280 #define ERR_CODE_NO_MATCH_ONES_COMP -2 281 #define ERR_CODE_TOO_MANY_LEN_OR_DIS -3 282 #define ERR_CODE_INCOMPLETE_LEN -4 283 #define ERR_CODE_RPT_LEN_NO_FIRST_LEN -5 284 #define ERR_CODE_RPT_GT_SPEC_LEN -6 285 #define ERR_CODE_INV_LIT_LEN_CODE_LEN -7 286 #define ERR_CODE_INV_DIS_CODE_LEN -8 287 #define ERR_CODE_INV_LIT_LEN_DIS_IN_BLK -9 288 #define ERR_CODE_DIS_TOO_FAR_BACK -10 289 #define ERR_CODE_OVERFLOW_ERROR -11 290 #define ERR_CODE_SOFT_ERROR -12 291 #define ERR_CODE_FATAL_ERROR -13 292 #define ERR_CODE_SSM_ERROR -14 293 #define ERR_CODE_ENDPOINT_ERROR -15 294 295 enum icp_qat_fw_slice { 296 ICP_QAT_FW_SLICE_NULL = 0, 297 ICP_QAT_FW_SLICE_CIPHER = 1, 298 ICP_QAT_FW_SLICE_AUTH = 2, 299 ICP_QAT_FW_SLICE_DRAM_RD = 3, 300 ICP_QAT_FW_SLICE_DRAM_WR = 4, 301 ICP_QAT_FW_SLICE_COMP = 5, 302 ICP_QAT_FW_SLICE_XLAT = 6, 303 ICP_QAT_FW_SLICE_DELIMITER 304 }; 305 #endif 306