17ec59eeaSAnirudh Venkataramanan /* SPDX-License-Identifier: GPL-2.0 */ 27ec59eeaSAnirudh Venkataramanan /* Copyright (c) 2018, Intel Corporation. */ 37ec59eeaSAnirudh Venkataramanan 47ec59eeaSAnirudh Venkataramanan #ifndef _ICE_CONTROLQ_H_ 57ec59eeaSAnirudh Venkataramanan #define _ICE_CONTROLQ_H_ 67ec59eeaSAnirudh Venkataramanan 77ec59eeaSAnirudh Venkataramanan #include "ice_adminq_cmd.h" 87ec59eeaSAnirudh Venkataramanan 9f31e4b6fSAnirudh Venkataramanan /* Maximum buffer lengths for all control queue types */ 10f31e4b6fSAnirudh Venkataramanan #define ICE_AQ_MAX_BUF_LEN 4096 1175d2b253SAnirudh Venkataramanan #define ICE_MBXQ_MAX_BUF_LEN 4096 128f5ee3c4SJacob Keller #define ICE_SBQ_MAX_BUF_LEN 512 13f31e4b6fSAnirudh Venkataramanan 147ec59eeaSAnirudh Venkataramanan #define ICE_CTL_Q_DESC(R, i) \ 157ec59eeaSAnirudh Venkataramanan (&(((struct ice_aq_desc *)((R).desc_buf.va))[i])) 167ec59eeaSAnirudh Venkataramanan 177ec59eeaSAnirudh Venkataramanan #define ICE_CTL_Q_DESC_UNUSED(R) \ 180c3e94c2SBruce Allan ((u16)((((R)->next_to_clean > (R)->next_to_use) ? 0 : (R)->count) + \ 190c3e94c2SBruce Allan (R)->next_to_clean - (R)->next_to_use - 1)) 207ec59eeaSAnirudh Venkataramanan 217ec59eeaSAnirudh Venkataramanan /* Defines that help manage the driver vs FW API checks. 227ec59eeaSAnirudh Venkataramanan * Take a look at ice_aq_ver_check in ice_controlq.c for actual usage. 237ec59eeaSAnirudh Venkataramanan */ 247dfefd0bSPaul Greenwalt #define EXP_FW_API_VER_MAJOR_E810 0x01 257dfefd0bSPaul Greenwalt #define EXP_FW_API_VER_MINOR_E810 0x05 267dfefd0bSPaul Greenwalt 277dfefd0bSPaul Greenwalt #define EXP_FW_API_VER_MAJOR_E830 0x01 287dfefd0bSPaul Greenwalt #define EXP_FW_API_VER_MINOR_E830 0x07 297dfefd0bSPaul Greenwalt 307dfefd0bSPaul Greenwalt #define EXP_FW_API_VER_MAJOR_BY_MAC(hw) ((hw)->mac_type == ICE_MAC_E830 ? \ 317dfefd0bSPaul Greenwalt EXP_FW_API_VER_MAJOR_E830 : \ 327dfefd0bSPaul Greenwalt EXP_FW_API_VER_MAJOR_E810) 337dfefd0bSPaul Greenwalt #define EXP_FW_API_VER_MINOR_BY_MAC(hw) ((hw)->mac_type == ICE_MAC_E830 ? \ 347dfefd0bSPaul Greenwalt EXP_FW_API_VER_MINOR_E830 : \ 357dfefd0bSPaul Greenwalt EXP_FW_API_VER_MINOR_E810) 367ec59eeaSAnirudh Venkataramanan 377ec59eeaSAnirudh Venkataramanan /* Different control queue types: These are mainly for SW consumption. */ 387ec59eeaSAnirudh Venkataramanan enum ice_ctl_q { 397ec59eeaSAnirudh Venkataramanan ICE_CTL_Q_UNKNOWN = 0, 407ec59eeaSAnirudh Venkataramanan ICE_CTL_Q_ADMIN, 4175d2b253SAnirudh Venkataramanan ICE_CTL_Q_MAILBOX, 428f5ee3c4SJacob Keller ICE_CTL_Q_SB, 437ec59eeaSAnirudh Venkataramanan }; 447ec59eeaSAnirudh Venkataramanan 45f88c529aSFabio Pricoco /* Control Queue timeout settings - max delay 1s */ 46*5f6df173SJacob Keller #define ICE_CTL_Q_SQ_CMD_TIMEOUT USEC_PER_SEC 47b5c7f857SEvan Swanson #define ICE_CTL_Q_ADMIN_INIT_TIMEOUT 10 /* Count 10 times */ 48b5c7f857SEvan Swanson #define ICE_CTL_Q_ADMIN_INIT_MSEC 100 /* Check every 100msec */ 497ec59eeaSAnirudh Venkataramanan 507ec59eeaSAnirudh Venkataramanan struct ice_ctl_q_ring { 512f2da36eSAnirudh Venkataramanan void *dma_head; /* Virtual address to DMA head */ 527ec59eeaSAnirudh Venkataramanan struct ice_dma_mem desc_buf; /* descriptor ring memory */ 537ec59eeaSAnirudh Venkataramanan 547ec59eeaSAnirudh Venkataramanan union { 557ec59eeaSAnirudh Venkataramanan struct ice_dma_mem *sq_bi; 567ec59eeaSAnirudh Venkataramanan struct ice_dma_mem *rq_bi; 577ec59eeaSAnirudh Venkataramanan } r; 587ec59eeaSAnirudh Venkataramanan 597ec59eeaSAnirudh Venkataramanan u16 count; /* Number of descriptors */ 607ec59eeaSAnirudh Venkataramanan 617ec59eeaSAnirudh Venkataramanan /* used for interrupt processing */ 627ec59eeaSAnirudh Venkataramanan u16 next_to_use; 637ec59eeaSAnirudh Venkataramanan u16 next_to_clean; 647ec59eeaSAnirudh Venkataramanan 657ec59eeaSAnirudh Venkataramanan /* used for queue tracking */ 667ec59eeaSAnirudh Venkataramanan u32 head; 677ec59eeaSAnirudh Venkataramanan u32 tail; 687ec59eeaSAnirudh Venkataramanan u32 len; 697ec59eeaSAnirudh Venkataramanan u32 bah; 707ec59eeaSAnirudh Venkataramanan u32 bal; 717ec59eeaSAnirudh Venkataramanan u32 len_mask; 727ec59eeaSAnirudh Venkataramanan u32 len_ena_mask; 73b5c7f857SEvan Swanson u32 len_crit_mask; 747ec59eeaSAnirudh Venkataramanan u32 head_mask; 757ec59eeaSAnirudh Venkataramanan }; 767ec59eeaSAnirudh Venkataramanan 777ec59eeaSAnirudh Venkataramanan /* sq transaction details */ 787ec59eeaSAnirudh Venkataramanan struct ice_sq_cd { 797ec59eeaSAnirudh Venkataramanan struct ice_aq_desc *wb_desc; 807ec59eeaSAnirudh Venkataramanan }; 817ec59eeaSAnirudh Venkataramanan 82940b61afSAnirudh Venkataramanan /* rq event information */ 83940b61afSAnirudh Venkataramanan struct ice_rq_event_info { 84940b61afSAnirudh Venkataramanan struct ice_aq_desc desc; 85940b61afSAnirudh Venkataramanan u16 msg_len; 86940b61afSAnirudh Venkataramanan u16 buf_len; 87940b61afSAnirudh Venkataramanan u8 *msg_buf; 88940b61afSAnirudh Venkataramanan }; 89940b61afSAnirudh Venkataramanan 907ec59eeaSAnirudh Venkataramanan /* Control Queue information */ 917ec59eeaSAnirudh Venkataramanan struct ice_ctl_q_info { 927ec59eeaSAnirudh Venkataramanan enum ice_ctl_q qtype; 937ec59eeaSAnirudh Venkataramanan struct ice_ctl_q_ring rq; /* receive queue */ 947ec59eeaSAnirudh Venkataramanan struct ice_ctl_q_ring sq; /* send queue */ 957ec59eeaSAnirudh Venkataramanan u16 num_rq_entries; /* receive queue depth */ 967ec59eeaSAnirudh Venkataramanan u16 num_sq_entries; /* send queue depth */ 977ec59eeaSAnirudh Venkataramanan u16 rq_buf_size; /* receive queue buffer size */ 987ec59eeaSAnirudh Venkataramanan u16 sq_buf_size; /* send queue buffer size */ 9906905270SJesse Brandeburg enum ice_aq_err sq_last_status; /* last status on send queue */ 1007ec59eeaSAnirudh Venkataramanan struct mutex sq_lock; /* Send queue lock */ 1017ec59eeaSAnirudh Venkataramanan struct mutex rq_lock; /* Receive queue lock */ 1027ec59eeaSAnirudh Venkataramanan }; 1037ec59eeaSAnirudh Venkataramanan 1047ec59eeaSAnirudh Venkataramanan #endif /* _ICE_CONTROLQ_H_ */ 105