/* SPDX-License-Identifier: (GPL-2.0-only OR BSD-3-Clause) */ /* QLogic qed NIC Driver * Copyright (c) 2015-2017 QLogic Corporation * Copyright (c) 2019-2020 Marvell International Ltd. */ #ifndef _QED_LL2_H #define _QED_LL2_H #include <linux/types.h> #include <linux/kernel.h> #include <linux/list.h> #include <linux/mutex.h> #include <linux/slab.h> #include <linux/spinlock.h> #include <linux/qed/qed_chain.h> #include <linux/qed/qed_ll2_if.h> #include "qed.h" #include "qed_hsi.h" #include "qed_sp.h" #define QED_MAX_NUM_OF_LL2_CONNECTIONS … /* LL2 queues handles will be split as follows: * first will be legacy queues, and then the ctx based queues. */ #define QED_MAX_NUM_OF_LL2_CONNS_PF … #define QED_MAX_NUM_OF_LEGACY_LL2_CONNS_PF … #define QED_MAX_NUM_OF_CTX_LL2_CONNS_PF … #define QED_LL2_LEGACY_CONN_BASE_PF … #define QED_LL2_CTX_CONN_BASE_PF … struct qed_ll2_rx_packet { … }; struct qed_ll2_tx_packet { … }; struct qed_ll2_rx_queue { … }; struct qed_ll2_tx_queue { … }; struct qed_ll2_info { … }; extern const struct qed_ll2_ops qed_ll2_ops_pass; /** * qed_ll2_acquire_connection(): Allocate resources, * starts rx & tx (if relevant) queues pair. * Provides connecion handler as output * parameter. * * @cxt: Pointer to the hw-function [opaque to some]. * @data: Describes connection parameters. * * Return: Int. */ int qed_ll2_acquire_connection(void *cxt, struct qed_ll2_acquire_data *data); /** * qed_ll2_establish_connection(): start previously allocated LL2 queues pair * * @cxt: Pointer to the hw-function [opaque to some]. * @connection_handle: LL2 connection's handle obtained from * qed_ll2_require_connection. * * Return: 0 on success, failure otherwise. */ int qed_ll2_establish_connection(void *cxt, u8 connection_handle); /** * qed_ll2_post_rx_buffer(): Submit buffers to LL2 Rx queue. * * @cxt: Pointer to the hw-function [opaque to some]. * @connection_handle: LL2 connection's handle obtained from * qed_ll2_require_connection. * @addr: RX (physical address) buffers to submit. * @buf_len: Buffer Len. * @cookie: Cookie. * @notify_fw: Produce corresponding Rx BD immediately. * * Return: 0 on success, failure otherwise. */ int qed_ll2_post_rx_buffer(void *cxt, u8 connection_handle, dma_addr_t addr, u16 buf_len, void *cookie, u8 notify_fw); /** * qed_ll2_prepare_tx_packet(): Request for start Tx BD * to prepare Tx packet submission to FW. * * @cxt: Pointer to the hw-function [opaque to some]. * @connection_handle: Connection handle. * @pkt: Info regarding the tx packet. * @notify_fw: Issue doorbell to fw for this packet. * * Return: 0 on success, failure otherwise. */ int qed_ll2_prepare_tx_packet(void *cxt, u8 connection_handle, struct qed_ll2_tx_pkt_info *pkt, bool notify_fw); /** * qed_ll2_release_connection(): Releases resources allocated for LL2 * connection. * * @cxt: Pointer to the hw-function [opaque to some]. * @connection_handle: LL2 connection's handle obtained from * qed_ll2_require_connection. * * Return: Void. */ void qed_ll2_release_connection(void *cxt, u8 connection_handle); /** * qed_ll2_set_fragment_of_tx_packet(): Provides fragments to fill * Tx BD of BDs requested by * qed_ll2_prepare_tx_packet * * @cxt: Pointer to the hw-function [opaque to some]. * @connection_handle: LL2 connection's handle obtained from * qed_ll2_require_connection. * @addr: Address. * @nbytes: Number of bytes. * * Return: 0 on success, failure otherwise. */ int qed_ll2_set_fragment_of_tx_packet(void *cxt, u8 connection_handle, dma_addr_t addr, u16 nbytes); /** * qed_ll2_terminate_connection(): Stops Tx/Rx queues * * @cxt: Pointer to the hw-function [opaque to some]. * @connection_handle: LL2 connection's handle obtained from * qed_ll2_require_connection. * * Return: 0 on success, failure otherwise. */ int qed_ll2_terminate_connection(void *cxt, u8 connection_handle); /** * qed_ll2_get_stats(): Get LL2 queue's statistics * * @cxt: Pointer to the hw-function [opaque to some]. * @connection_handle: LL2 connection's handle obtained from * qed_ll2_require_connection. * @p_stats: Pointer Status. * * Return: 0 on success, failure otherwise. */ int qed_ll2_get_stats(void *cxt, u8 connection_handle, struct qed_ll2_stats *p_stats); /** * qed_ll2_alloc(): Allocates LL2 connections set. * * @p_hwfn: HW device data. * * Return: Int. */ int qed_ll2_alloc(struct qed_hwfn *p_hwfn); /** * qed_ll2_setup(): Inits LL2 connections set. * * @p_hwfn: HW device data. * * Return: Void. * */ void qed_ll2_setup(struct qed_hwfn *p_hwfn); /** * qed_ll2_free(): Releases LL2 connections set * * @p_hwfn: HW device data. * * Return: Void. * */ void qed_ll2_free(struct qed_hwfn *p_hwfn); #endif