linux/drivers/net/ethernet/qlogic/qed/qed_ll2.h

/* 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