efa_admin_cmds_defs.h (23560B)
1/* SPDX-License-Identifier: GPL-2.0 OR BSD-2-Clause */ 2/* 3 * Copyright 2018-2021 Amazon.com, Inc. or its affiliates. All rights reserved. 4 */ 5 6#ifndef _EFA_ADMIN_CMDS_H_ 7#define _EFA_ADMIN_CMDS_H_ 8 9#define EFA_ADMIN_API_VERSION_MAJOR 0 10#define EFA_ADMIN_API_VERSION_MINOR 1 11 12/* EFA admin queue opcodes */ 13enum efa_admin_aq_opcode { 14 EFA_ADMIN_CREATE_QP = 1, 15 EFA_ADMIN_MODIFY_QP = 2, 16 EFA_ADMIN_QUERY_QP = 3, 17 EFA_ADMIN_DESTROY_QP = 4, 18 EFA_ADMIN_CREATE_AH = 5, 19 EFA_ADMIN_DESTROY_AH = 6, 20 EFA_ADMIN_REG_MR = 7, 21 EFA_ADMIN_DEREG_MR = 8, 22 EFA_ADMIN_CREATE_CQ = 9, 23 EFA_ADMIN_DESTROY_CQ = 10, 24 EFA_ADMIN_GET_FEATURE = 11, 25 EFA_ADMIN_SET_FEATURE = 12, 26 EFA_ADMIN_GET_STATS = 13, 27 EFA_ADMIN_ALLOC_PD = 14, 28 EFA_ADMIN_DEALLOC_PD = 15, 29 EFA_ADMIN_ALLOC_UAR = 16, 30 EFA_ADMIN_DEALLOC_UAR = 17, 31 EFA_ADMIN_CREATE_EQ = 18, 32 EFA_ADMIN_DESTROY_EQ = 19, 33 EFA_ADMIN_MAX_OPCODE = 19, 34}; 35 36enum efa_admin_aq_feature_id { 37 EFA_ADMIN_DEVICE_ATTR = 1, 38 EFA_ADMIN_AENQ_CONFIG = 2, 39 EFA_ADMIN_NETWORK_ATTR = 3, 40 EFA_ADMIN_QUEUE_ATTR = 4, 41 EFA_ADMIN_HW_HINTS = 5, 42 EFA_ADMIN_HOST_INFO = 6, 43 EFA_ADMIN_EVENT_QUEUE_ATTR = 7, 44}; 45 46/* QP transport type */ 47enum efa_admin_qp_type { 48 /* Unreliable Datagram */ 49 EFA_ADMIN_QP_TYPE_UD = 1, 50 /* Scalable Reliable Datagram */ 51 EFA_ADMIN_QP_TYPE_SRD = 2, 52}; 53 54/* QP state */ 55enum efa_admin_qp_state { 56 EFA_ADMIN_QP_STATE_RESET = 0, 57 EFA_ADMIN_QP_STATE_INIT = 1, 58 EFA_ADMIN_QP_STATE_RTR = 2, 59 EFA_ADMIN_QP_STATE_RTS = 3, 60 EFA_ADMIN_QP_STATE_SQD = 4, 61 EFA_ADMIN_QP_STATE_SQE = 5, 62 EFA_ADMIN_QP_STATE_ERR = 6, 63}; 64 65enum efa_admin_get_stats_type { 66 EFA_ADMIN_GET_STATS_TYPE_BASIC = 0, 67 EFA_ADMIN_GET_STATS_TYPE_MESSAGES = 1, 68 EFA_ADMIN_GET_STATS_TYPE_RDMA_READ = 2, 69}; 70 71enum efa_admin_get_stats_scope { 72 EFA_ADMIN_GET_STATS_SCOPE_ALL = 0, 73 EFA_ADMIN_GET_STATS_SCOPE_QUEUE = 1, 74}; 75 76/* 77 * QP allocation sizes, converted by fabric QueuePair (QP) create command 78 * from QP capabilities. 79 */ 80struct efa_admin_qp_alloc_size { 81 /* Send descriptor ring size in bytes */ 82 u32 send_queue_ring_size; 83 84 /* Max number of WQEs that can be outstanding on send queue. */ 85 u32 send_queue_depth; 86 87 /* 88 * Recv descriptor ring size in bytes, sufficient for user-provided 89 * number of WQEs 90 */ 91 u32 recv_queue_ring_size; 92 93 /* Max number of WQEs that can be outstanding on recv queue */ 94 u32 recv_queue_depth; 95}; 96 97struct efa_admin_create_qp_cmd { 98 /* Common Admin Queue descriptor */ 99 struct efa_admin_aq_common_desc aq_common_desc; 100 101 /* Protection Domain associated with this QP */ 102 u16 pd; 103 104 /* QP type */ 105 u8 qp_type; 106 107 /* 108 * 0 : sq_virt - If set, SQ ring base address is 109 * virtual (IOVA returned by MR registration) 110 * 1 : rq_virt - If set, RQ ring base address is 111 * virtual (IOVA returned by MR registration) 112 * 7:2 : reserved - MBZ 113 */ 114 u8 flags; 115 116 /* 117 * Send queue (SQ) ring base physical address. This field is not 118 * used if this is a Low Latency Queue(LLQ). 119 */ 120 u64 sq_base_addr; 121 122 /* Receive queue (RQ) ring base address. */ 123 u64 rq_base_addr; 124 125 /* Index of CQ to be associated with Send Queue completions */ 126 u32 send_cq_idx; 127 128 /* Index of CQ to be associated with Recv Queue completions */ 129 u32 recv_cq_idx; 130 131 /* 132 * Memory registration key for the SQ ring, used only when not in 133 * LLQ mode and base address is virtual 134 */ 135 u32 sq_l_key; 136 137 /* 138 * Memory registration key for the RQ ring, used only when base 139 * address is virtual 140 */ 141 u32 rq_l_key; 142 143 /* Requested QP allocation sizes */ 144 struct efa_admin_qp_alloc_size qp_alloc_size; 145 146 /* UAR number */ 147 u16 uar; 148 149 /* MBZ */ 150 u16 reserved; 151 152 /* MBZ */ 153 u32 reserved2; 154}; 155 156struct efa_admin_create_qp_resp { 157 /* Common Admin Queue completion descriptor */ 158 struct efa_admin_acq_common_desc acq_common_desc; 159 160 /* 161 * Opaque handle to be used for consequent admin operations on the 162 * QP 163 */ 164 u32 qp_handle; 165 166 /* 167 * QP number in the given EFA virtual device. Least-significant bits (as 168 * needed according to max_qp) carry unique QP ID 169 */ 170 u16 qp_num; 171 172 /* MBZ */ 173 u16 reserved; 174 175 /* Index of sub-CQ for Send Queue completions */ 176 u16 send_sub_cq_idx; 177 178 /* Index of sub-CQ for Receive Queue completions */ 179 u16 recv_sub_cq_idx; 180 181 /* SQ doorbell address, as offset to PCIe DB BAR */ 182 u32 sq_db_offset; 183 184 /* RQ doorbell address, as offset to PCIe DB BAR */ 185 u32 rq_db_offset; 186 187 /* 188 * low latency send queue ring base address as an offset to PCIe 189 * MMIO LLQ_MEM BAR 190 */ 191 u32 llq_descriptors_offset; 192}; 193 194struct efa_admin_modify_qp_cmd { 195 /* Common Admin Queue descriptor */ 196 struct efa_admin_aq_common_desc aq_common_desc; 197 198 /* 199 * Mask indicating which fields should be updated 200 * 0 : qp_state 201 * 1 : cur_qp_state 202 * 2 : qkey 203 * 3 : sq_psn 204 * 4 : sq_drained_async_notify 205 * 5 : rnr_retry 206 * 31:6 : reserved 207 */ 208 u32 modify_mask; 209 210 /* QP handle returned by create_qp command */ 211 u32 qp_handle; 212 213 /* QP state */ 214 u32 qp_state; 215 216 /* Override current QP state (before applying the transition) */ 217 u32 cur_qp_state; 218 219 /* QKey */ 220 u32 qkey; 221 222 /* SQ PSN */ 223 u32 sq_psn; 224 225 /* Enable async notification when SQ is drained */ 226 u8 sq_drained_async_notify; 227 228 /* Number of RNR retries (valid only for SRD QPs) */ 229 u8 rnr_retry; 230 231 /* MBZ */ 232 u16 reserved2; 233}; 234 235struct efa_admin_modify_qp_resp { 236 /* Common Admin Queue completion descriptor */ 237 struct efa_admin_acq_common_desc acq_common_desc; 238}; 239 240struct efa_admin_query_qp_cmd { 241 /* Common Admin Queue descriptor */ 242 struct efa_admin_aq_common_desc aq_common_desc; 243 244 /* QP handle returned by create_qp command */ 245 u32 qp_handle; 246}; 247 248struct efa_admin_query_qp_resp { 249 /* Common Admin Queue completion descriptor */ 250 struct efa_admin_acq_common_desc acq_common_desc; 251 252 /* QP state */ 253 u32 qp_state; 254 255 /* QKey */ 256 u32 qkey; 257 258 /* SQ PSN */ 259 u32 sq_psn; 260 261 /* Indicates that draining is in progress */ 262 u8 sq_draining; 263 264 /* Number of RNR retries (valid only for SRD QPs) */ 265 u8 rnr_retry; 266 267 /* MBZ */ 268 u16 reserved2; 269}; 270 271struct efa_admin_destroy_qp_cmd { 272 /* Common Admin Queue descriptor */ 273 struct efa_admin_aq_common_desc aq_common_desc; 274 275 /* QP handle returned by create_qp command */ 276 u32 qp_handle; 277}; 278 279struct efa_admin_destroy_qp_resp { 280 /* Common Admin Queue completion descriptor */ 281 struct efa_admin_acq_common_desc acq_common_desc; 282}; 283 284/* 285 * Create Address Handle command parameters. Must not be called more than 286 * once for the same destination 287 */ 288struct efa_admin_create_ah_cmd { 289 /* Common Admin Queue descriptor */ 290 struct efa_admin_aq_common_desc aq_common_desc; 291 292 /* Destination address in network byte order */ 293 u8 dest_addr[16]; 294 295 /* PD number */ 296 u16 pd; 297 298 /* MBZ */ 299 u16 reserved; 300}; 301 302struct efa_admin_create_ah_resp { 303 /* Common Admin Queue completion descriptor */ 304 struct efa_admin_acq_common_desc acq_common_desc; 305 306 /* Target interface address handle (opaque) */ 307 u16 ah; 308 309 /* MBZ */ 310 u16 reserved; 311}; 312 313struct efa_admin_destroy_ah_cmd { 314 /* Common Admin Queue descriptor */ 315 struct efa_admin_aq_common_desc aq_common_desc; 316 317 /* Target interface address handle (opaque) */ 318 u16 ah; 319 320 /* PD number */ 321 u16 pd; 322}; 323 324struct efa_admin_destroy_ah_resp { 325 /* Common Admin Queue completion descriptor */ 326 struct efa_admin_acq_common_desc acq_common_desc; 327}; 328 329/* 330 * Registration of MemoryRegion, required for QP working with Virtual 331 * Addresses. In standard verbs semantics, region length is limited to 2GB 332 * space, but EFA offers larger MR support for large memory space, to ease 333 * on users working with very large datasets (i.e. full GPU memory mapping). 334 */ 335struct efa_admin_reg_mr_cmd { 336 /* Common Admin Queue descriptor */ 337 struct efa_admin_aq_common_desc aq_common_desc; 338 339 /* Protection Domain */ 340 u16 pd; 341 342 /* MBZ */ 343 u16 reserved16_w1; 344 345 /* Physical Buffer List, each element is page-aligned. */ 346 union { 347 /* 348 * Inline array of guest-physical page addresses of user 349 * memory pages (optimization for short region 350 * registrations) 351 */ 352 u64 inline_pbl_array[4]; 353 354 /* points to PBL (direct or indirect, chained if needed) */ 355 struct efa_admin_ctrl_buff_info pbl; 356 } pbl; 357 358 /* Memory region length, in bytes. */ 359 u64 mr_length; 360 361 /* 362 * flags and page size 363 * 4:0 : phys_page_size_shift - page size is (1 << 364 * phys_page_size_shift). Page size is used for 365 * building the Virtual to Physical address mapping 366 * 6:5 : reserved - MBZ 367 * 7 : mem_addr_phy_mode_en - Enable bit for physical 368 * memory registration (no translation), can be used 369 * only by privileged clients. If set, PBL must 370 * contain a single entry. 371 */ 372 u8 flags; 373 374 /* 375 * permissions 376 * 0 : local_write_enable - Local write permissions: 377 * must be set for RQ buffers and buffers posted for 378 * RDMA Read requests 379 * 1 : reserved1 - MBZ 380 * 2 : remote_read_enable - Remote read permissions: 381 * must be set to enable RDMA read from the region 382 * 7:3 : reserved2 - MBZ 383 */ 384 u8 permissions; 385 386 /* MBZ */ 387 u16 reserved16_w5; 388 389 /* number of pages in PBL (redundant, could be calculated) */ 390 u32 page_num; 391 392 /* 393 * IO Virtual Address associated with this MR. If 394 * mem_addr_phy_mode_en is set, contains the physical address of 395 * the region. 396 */ 397 u64 iova; 398}; 399 400struct efa_admin_reg_mr_resp { 401 /* Common Admin Queue completion descriptor */ 402 struct efa_admin_acq_common_desc acq_common_desc; 403 404 /* 405 * L_Key, to be used in conjunction with local buffer references in 406 * SQ and RQ WQE, or with virtual RQ/CQ rings 407 */ 408 u32 l_key; 409 410 /* 411 * R_Key, to be used in RDMA messages to refer to remotely accessed 412 * memory region 413 */ 414 u32 r_key; 415}; 416 417struct efa_admin_dereg_mr_cmd { 418 /* Common Admin Queue descriptor */ 419 struct efa_admin_aq_common_desc aq_common_desc; 420 421 /* L_Key, memory region's l_key */ 422 u32 l_key; 423}; 424 425struct efa_admin_dereg_mr_resp { 426 /* Common Admin Queue completion descriptor */ 427 struct efa_admin_acq_common_desc acq_common_desc; 428}; 429 430struct efa_admin_create_cq_cmd { 431 struct efa_admin_aq_common_desc aq_common_desc; 432 433 /* 434 * 4:0 : reserved5 - MBZ 435 * 5 : interrupt_mode_enabled - if set, cq operates 436 * in interrupt mode (i.e. CQ events and EQ elements 437 * are generated), otherwise - polling 438 * 6 : virt - If set, ring base address is virtual 439 * (IOVA returned by MR registration) 440 * 7 : reserved6 - MBZ 441 */ 442 u8 cq_caps_1; 443 444 /* 445 * 4:0 : cq_entry_size_words - size of CQ entry in 446 * 32-bit words, valid values: 4, 8. 447 * 7:5 : reserved7 - MBZ 448 */ 449 u8 cq_caps_2; 450 451 /* completion queue depth in # of entries. must be power of 2 */ 452 u16 cq_depth; 453 454 /* EQ number assigned to this cq */ 455 u16 eqn; 456 457 /* MBZ */ 458 u16 reserved; 459 460 /* 461 * CQ ring base address, virtual or physical depending on 'virt' 462 * flag 463 */ 464 struct efa_common_mem_addr cq_ba; 465 466 /* 467 * Memory registration key for the ring, used only when base 468 * address is virtual 469 */ 470 u32 l_key; 471 472 /* 473 * number of sub cqs - must be equal to sub_cqs_per_cq of queue 474 * attributes. 475 */ 476 u16 num_sub_cqs; 477 478 /* UAR number */ 479 u16 uar; 480}; 481 482struct efa_admin_create_cq_resp { 483 struct efa_admin_acq_common_desc acq_common_desc; 484 485 u16 cq_idx; 486 487 /* actual cq depth in number of entries */ 488 u16 cq_actual_depth; 489 490 /* CQ doorbell address, as offset to PCIe DB BAR */ 491 u32 db_offset; 492 493 /* 494 * 0 : db_valid - If set, doorbell offset is valid. 495 * Always set when interrupts are requested. 496 */ 497 u32 flags; 498}; 499 500struct efa_admin_destroy_cq_cmd { 501 struct efa_admin_aq_common_desc aq_common_desc; 502 503 u16 cq_idx; 504 505 /* MBZ */ 506 u16 reserved1; 507}; 508 509struct efa_admin_destroy_cq_resp { 510 struct efa_admin_acq_common_desc acq_common_desc; 511}; 512 513/* 514 * EFA AQ Get Statistics command. Extended statistics are placed in control 515 * buffer pointed by AQ entry 516 */ 517struct efa_admin_aq_get_stats_cmd { 518 struct efa_admin_aq_common_desc aq_common_descriptor; 519 520 union { 521 /* command specific inline data */ 522 u32 inline_data_w1[3]; 523 524 struct efa_admin_ctrl_buff_info control_buffer; 525 } u; 526 527 /* stats type as defined in enum efa_admin_get_stats_type */ 528 u8 type; 529 530 /* stats scope defined in enum efa_admin_get_stats_scope */ 531 u8 scope; 532 533 u16 scope_modifier; 534}; 535 536struct efa_admin_basic_stats { 537 u64 tx_bytes; 538 539 u64 tx_pkts; 540 541 u64 rx_bytes; 542 543 u64 rx_pkts; 544 545 u64 rx_drops; 546}; 547 548struct efa_admin_messages_stats { 549 u64 send_bytes; 550 551 u64 send_wrs; 552 553 u64 recv_bytes; 554 555 u64 recv_wrs; 556}; 557 558struct efa_admin_rdma_read_stats { 559 u64 read_wrs; 560 561 u64 read_bytes; 562 563 u64 read_wr_err; 564 565 u64 read_resp_bytes; 566}; 567 568struct efa_admin_acq_get_stats_resp { 569 struct efa_admin_acq_common_desc acq_common_desc; 570 571 union { 572 struct efa_admin_basic_stats basic_stats; 573 574 struct efa_admin_messages_stats messages_stats; 575 576 struct efa_admin_rdma_read_stats rdma_read_stats; 577 } u; 578}; 579 580struct efa_admin_get_set_feature_common_desc { 581 /* MBZ */ 582 u8 reserved0; 583 584 /* as appears in efa_admin_aq_feature_id */ 585 u8 feature_id; 586 587 /* MBZ */ 588 u16 reserved16; 589}; 590 591struct efa_admin_feature_device_attr_desc { 592 /* Bitmap of efa_admin_aq_feature_id */ 593 u64 supported_features; 594 595 /* Bitmap of supported page sizes in MR registrations */ 596 u64 page_size_cap; 597 598 u32 fw_version; 599 600 u32 admin_api_version; 601 602 u32 device_version; 603 604 /* Bar used for SQ and RQ doorbells */ 605 u16 db_bar; 606 607 /* Indicates how many bits are used on physical address access */ 608 u8 phys_addr_width; 609 610 /* Indicates how many bits are used on virtual address access */ 611 u8 virt_addr_width; 612 613 /* 614 * 0 : rdma_read - If set, RDMA Read is supported on 615 * TX queues 616 * 1 : rnr_retry - If set, RNR retry is supported on 617 * modify QP command 618 * 31:2 : reserved - MBZ 619 */ 620 u32 device_caps; 621 622 /* Max RDMA transfer size in bytes */ 623 u32 max_rdma_size; 624}; 625 626struct efa_admin_feature_queue_attr_desc { 627 /* The maximum number of queue pairs supported */ 628 u32 max_qp; 629 630 /* Maximum number of WQEs per Send Queue */ 631 u32 max_sq_depth; 632 633 /* Maximum size of data that can be sent inline in a Send WQE */ 634 u32 inline_buf_size; 635 636 /* Maximum number of buffer descriptors per Recv Queue */ 637 u32 max_rq_depth; 638 639 /* The maximum number of completion queues supported per VF */ 640 u32 max_cq; 641 642 /* Maximum number of CQEs per Completion Queue */ 643 u32 max_cq_depth; 644 645 /* Number of sub-CQs to be created for each CQ */ 646 u16 sub_cqs_per_cq; 647 648 /* Minimum number of WQEs per SQ */ 649 u16 min_sq_depth; 650 651 /* Maximum number of SGEs (buffers) allowed for a single send WQE */ 652 u16 max_wr_send_sges; 653 654 /* Maximum number of SGEs allowed for a single recv WQE */ 655 u16 max_wr_recv_sges; 656 657 /* The maximum number of memory regions supported */ 658 u32 max_mr; 659 660 /* The maximum number of pages can be registered */ 661 u32 max_mr_pages; 662 663 /* The maximum number of protection domains supported */ 664 u32 max_pd; 665 666 /* The maximum number of address handles supported */ 667 u32 max_ah; 668 669 /* The maximum size of LLQ in bytes */ 670 u32 max_llq_size; 671 672 /* Maximum number of SGEs for a single RDMA read WQE */ 673 u16 max_wr_rdma_sges; 674 675 /* 676 * Maximum number of bytes that can be written to SQ between two 677 * consecutive doorbells (in units of 64B). Driver must ensure that only 678 * complete WQEs are written to queue before issuing a doorbell. 679 * Examples: max_tx_batch=16 and WQE size = 64B, means up to 16 WQEs can 680 * be written to SQ between two consecutive doorbells. max_tx_batch=11 681 * and WQE size = 128B, means up to 5 WQEs can be written to SQ between 682 * two consecutive doorbells. Zero means unlimited. 683 */ 684 u16 max_tx_batch; 685}; 686 687struct efa_admin_event_queue_attr_desc { 688 /* The maximum number of event queues supported */ 689 u32 max_eq; 690 691 /* Maximum number of EQEs per Event Queue */ 692 u32 max_eq_depth; 693 694 /* Supported events bitmask */ 695 u32 event_bitmask; 696}; 697 698struct efa_admin_feature_aenq_desc { 699 /* bitmask for AENQ groups the device can report */ 700 u32 supported_groups; 701 702 /* bitmask for AENQ groups to report */ 703 u32 enabled_groups; 704}; 705 706struct efa_admin_feature_network_attr_desc { 707 /* Raw address data in network byte order */ 708 u8 addr[16]; 709 710 /* max packet payload size in bytes */ 711 u32 mtu; 712}; 713 714/* 715 * When hint value is 0, hints capabilities are not supported or driver 716 * should use its own predefined value 717 */ 718struct efa_admin_hw_hints { 719 /* value in ms */ 720 u16 mmio_read_timeout; 721 722 /* value in ms */ 723 u16 driver_watchdog_timeout; 724 725 /* value in ms */ 726 u16 admin_completion_timeout; 727 728 /* poll interval in ms */ 729 u16 poll_interval; 730}; 731 732struct efa_admin_get_feature_cmd { 733 struct efa_admin_aq_common_desc aq_common_descriptor; 734 735 struct efa_admin_ctrl_buff_info control_buffer; 736 737 struct efa_admin_get_set_feature_common_desc feature_common; 738 739 u32 raw[11]; 740}; 741 742struct efa_admin_get_feature_resp { 743 struct efa_admin_acq_common_desc acq_common_desc; 744 745 union { 746 u32 raw[14]; 747 748 struct efa_admin_feature_device_attr_desc device_attr; 749 750 struct efa_admin_feature_aenq_desc aenq; 751 752 struct efa_admin_feature_network_attr_desc network_attr; 753 754 struct efa_admin_feature_queue_attr_desc queue_attr; 755 756 struct efa_admin_event_queue_attr_desc event_queue_attr; 757 758 struct efa_admin_hw_hints hw_hints; 759 } u; 760}; 761 762struct efa_admin_set_feature_cmd { 763 struct efa_admin_aq_common_desc aq_common_descriptor; 764 765 struct efa_admin_ctrl_buff_info control_buffer; 766 767 struct efa_admin_get_set_feature_common_desc feature_common; 768 769 union { 770 u32 raw[11]; 771 772 /* AENQ configuration */ 773 struct efa_admin_feature_aenq_desc aenq; 774 } u; 775}; 776 777struct efa_admin_set_feature_resp { 778 struct efa_admin_acq_common_desc acq_common_desc; 779 780 union { 781 u32 raw[14]; 782 } u; 783}; 784 785struct efa_admin_alloc_pd_cmd { 786 struct efa_admin_aq_common_desc aq_common_descriptor; 787}; 788 789struct efa_admin_alloc_pd_resp { 790 struct efa_admin_acq_common_desc acq_common_desc; 791 792 /* PD number */ 793 u16 pd; 794 795 /* MBZ */ 796 u16 reserved; 797}; 798 799struct efa_admin_dealloc_pd_cmd { 800 struct efa_admin_aq_common_desc aq_common_descriptor; 801 802 /* PD number */ 803 u16 pd; 804 805 /* MBZ */ 806 u16 reserved; 807}; 808 809struct efa_admin_dealloc_pd_resp { 810 struct efa_admin_acq_common_desc acq_common_desc; 811}; 812 813struct efa_admin_alloc_uar_cmd { 814 struct efa_admin_aq_common_desc aq_common_descriptor; 815}; 816 817struct efa_admin_alloc_uar_resp { 818 struct efa_admin_acq_common_desc acq_common_desc; 819 820 /* UAR number */ 821 u16 uar; 822 823 /* MBZ */ 824 u16 reserved; 825}; 826 827struct efa_admin_dealloc_uar_cmd { 828 struct efa_admin_aq_common_desc aq_common_descriptor; 829 830 /* UAR number */ 831 u16 uar; 832 833 /* MBZ */ 834 u16 reserved; 835}; 836 837struct efa_admin_dealloc_uar_resp { 838 struct efa_admin_acq_common_desc acq_common_desc; 839}; 840 841struct efa_admin_create_eq_cmd { 842 struct efa_admin_aq_common_desc aq_common_descriptor; 843 844 /* Size of the EQ in entries, must be power of 2 */ 845 u16 depth; 846 847 /* MSI-X table entry index */ 848 u8 msix_vec; 849 850 /* 851 * 4:0 : entry_size_words - size of EQ entry in 852 * 32-bit words 853 * 7:5 : reserved - MBZ 854 */ 855 u8 caps; 856 857 /* EQ ring base address */ 858 struct efa_common_mem_addr ba; 859 860 /* 861 * Enabled events on this EQ 862 * 0 : completion_events - Enable completion events 863 * 31:1 : reserved - MBZ 864 */ 865 u32 event_bitmask; 866 867 /* MBZ */ 868 u32 reserved; 869}; 870 871struct efa_admin_create_eq_resp { 872 struct efa_admin_acq_common_desc acq_common_desc; 873 874 /* EQ number */ 875 u16 eqn; 876 877 /* MBZ */ 878 u16 reserved; 879}; 880 881struct efa_admin_destroy_eq_cmd { 882 struct efa_admin_aq_common_desc aq_common_descriptor; 883 884 /* EQ number */ 885 u16 eqn; 886 887 /* MBZ */ 888 u16 reserved; 889}; 890 891struct efa_admin_destroy_eq_resp { 892 struct efa_admin_acq_common_desc acq_common_desc; 893}; 894 895/* asynchronous event notification groups */ 896enum efa_admin_aenq_group { 897 EFA_ADMIN_FATAL_ERROR = 1, 898 EFA_ADMIN_WARNING = 2, 899 EFA_ADMIN_NOTIFICATION = 3, 900 EFA_ADMIN_KEEP_ALIVE = 4, 901 EFA_ADMIN_AENQ_GROUPS_NUM = 5, 902}; 903 904struct efa_admin_mmio_req_read_less_resp { 905 u16 req_id; 906 907 u16 reg_off; 908 909 /* value is valid when poll is cleared */ 910 u32 reg_val; 911}; 912 913enum efa_admin_os_type { 914 EFA_ADMIN_OS_LINUX = 0, 915}; 916 917struct efa_admin_host_info { 918 /* OS distribution string format */ 919 u8 os_dist_str[128]; 920 921 /* Defined in enum efa_admin_os_type */ 922 u32 os_type; 923 924 /* Kernel version string format */ 925 u8 kernel_ver_str[32]; 926 927 /* Kernel version numeric format */ 928 u32 kernel_ver; 929 930 /* 931 * 7:0 : driver_module_type 932 * 15:8 : driver_sub_minor 933 * 23:16 : driver_minor 934 * 31:24 : driver_major 935 */ 936 u32 driver_ver; 937 938 /* 939 * Device's Bus, Device and Function 940 * 2:0 : function 941 * 7:3 : device 942 * 15:8 : bus 943 */ 944 u16 bdf; 945 946 /* 947 * Spec version 948 * 7:0 : spec_minor 949 * 15:8 : spec_major 950 */ 951 u16 spec_ver; 952 953 /* 954 * 0 : intree - Intree driver 955 * 1 : gdr - GPUDirect RDMA supported 956 * 31:2 : reserved2 957 */ 958 u32 flags; 959}; 960 961/* create_qp_cmd */ 962#define EFA_ADMIN_CREATE_QP_CMD_SQ_VIRT_MASK BIT(0) 963#define EFA_ADMIN_CREATE_QP_CMD_RQ_VIRT_MASK BIT(1) 964 965/* modify_qp_cmd */ 966#define EFA_ADMIN_MODIFY_QP_CMD_QP_STATE_MASK BIT(0) 967#define EFA_ADMIN_MODIFY_QP_CMD_CUR_QP_STATE_MASK BIT(1) 968#define EFA_ADMIN_MODIFY_QP_CMD_QKEY_MASK BIT(2) 969#define EFA_ADMIN_MODIFY_QP_CMD_SQ_PSN_MASK BIT(3) 970#define EFA_ADMIN_MODIFY_QP_CMD_SQ_DRAINED_ASYNC_NOTIFY_MASK BIT(4) 971#define EFA_ADMIN_MODIFY_QP_CMD_RNR_RETRY_MASK BIT(5) 972 973/* reg_mr_cmd */ 974#define EFA_ADMIN_REG_MR_CMD_PHYS_PAGE_SIZE_SHIFT_MASK GENMASK(4, 0) 975#define EFA_ADMIN_REG_MR_CMD_MEM_ADDR_PHY_MODE_EN_MASK BIT(7) 976#define EFA_ADMIN_REG_MR_CMD_LOCAL_WRITE_ENABLE_MASK BIT(0) 977#define EFA_ADMIN_REG_MR_CMD_REMOTE_READ_ENABLE_MASK BIT(2) 978 979/* create_cq_cmd */ 980#define EFA_ADMIN_CREATE_CQ_CMD_INTERRUPT_MODE_ENABLED_MASK BIT(5) 981#define EFA_ADMIN_CREATE_CQ_CMD_VIRT_MASK BIT(6) 982#define EFA_ADMIN_CREATE_CQ_CMD_CQ_ENTRY_SIZE_WORDS_MASK GENMASK(4, 0) 983 984/* create_cq_resp */ 985#define EFA_ADMIN_CREATE_CQ_RESP_DB_VALID_MASK BIT(0) 986 987/* feature_device_attr_desc */ 988#define EFA_ADMIN_FEATURE_DEVICE_ATTR_DESC_RDMA_READ_MASK BIT(0) 989#define EFA_ADMIN_FEATURE_DEVICE_ATTR_DESC_RNR_RETRY_MASK BIT(1) 990 991/* create_eq_cmd */ 992#define EFA_ADMIN_CREATE_EQ_CMD_ENTRY_SIZE_WORDS_MASK GENMASK(4, 0) 993#define EFA_ADMIN_CREATE_EQ_CMD_VIRT_MASK BIT(6) 994#define EFA_ADMIN_CREATE_EQ_CMD_COMPLETION_EVENTS_MASK BIT(0) 995 996/* host_info */ 997#define EFA_ADMIN_HOST_INFO_DRIVER_MODULE_TYPE_MASK GENMASK(7, 0) 998#define EFA_ADMIN_HOST_INFO_DRIVER_SUB_MINOR_MASK GENMASK(15, 8) 999#define EFA_ADMIN_HOST_INFO_DRIVER_MINOR_MASK GENMASK(23, 16) 1000#define EFA_ADMIN_HOST_INFO_DRIVER_MAJOR_MASK GENMASK(31, 24) 1001#define EFA_ADMIN_HOST_INFO_FUNCTION_MASK GENMASK(2, 0) 1002#define EFA_ADMIN_HOST_INFO_DEVICE_MASK GENMASK(7, 3) 1003#define EFA_ADMIN_HOST_INFO_BUS_MASK GENMASK(15, 8) 1004#define EFA_ADMIN_HOST_INFO_SPEC_MINOR_MASK GENMASK(7, 0) 1005#define EFA_ADMIN_HOST_INFO_SPEC_MAJOR_MASK GENMASK(15, 8) 1006#define EFA_ADMIN_HOST_INFO_INTREE_MASK BIT(0) 1007#define EFA_ADMIN_HOST_INFO_GDR_MASK BIT(1) 1008 1009#endif /* _EFA_ADMIN_CMDS_H_ */