175 lines
7.4 KiB
C
175 lines
7.4 KiB
C
/* SPDX-License-Identifier: GPL-2.0+ */
|
|
/*
|
|
* Copyright (C) 2014 Freescale Semiconductor
|
|
*/
|
|
|
|
#ifndef _FSL_QBMAN_PORTAL_H
|
|
#define _FSL_QBMAN_PORTAL_H
|
|
|
|
#include <fsl-mc/fsl_qbman_base.h>
|
|
|
|
/* Create and destroy a functional object representing the given QBMan portal
|
|
* descriptor. */
|
|
struct qbman_swp *qbman_swp_init(const struct qbman_swp_desc *);
|
|
|
|
/************/
|
|
/* Dequeues */
|
|
/************/
|
|
|
|
/* See the QBMan driver API documentation for details on the enqueue
|
|
* mechanisms. NB: the use of a 'ldpaa_' prefix for this type is because it is
|
|
* primarily used by the "DPIO" layer that sits above (and hides) the QBMan
|
|
* driver. The structure is defined in the DPIO interface, but to avoid circular
|
|
* dependencies we just pre/re-declare it here opaquely. */
|
|
struct ldpaa_dq;
|
|
|
|
|
|
/* ------------------- */
|
|
/* Pull-mode dequeuing */
|
|
/* ------------------- */
|
|
|
|
struct qbman_pull_desc {
|
|
uint32_t dont_manipulate_directly[6];
|
|
};
|
|
|
|
/* Clear the contents of a descriptor to default/starting state. */
|
|
void qbman_pull_desc_clear(struct qbman_pull_desc *);
|
|
/* If not called, or if called with 'storage' as NULL, the result pull dequeues
|
|
* will produce results to DQRR. If 'storage' is non-NULL, then results are
|
|
* produced to the given memory location (using the physical/DMA address which
|
|
* the caller provides in 'storage_phys'), and 'stash' controls whether or not
|
|
* those writes to main-memory express a cache-warming attribute. */
|
|
void qbman_pull_desc_set_storage(struct qbman_pull_desc *,
|
|
struct ldpaa_dq *storage,
|
|
dma_addr_t storage_phys,
|
|
int stash);
|
|
/* numframes must be between 1 and 16, inclusive */
|
|
void qbman_pull_desc_set_numframes(struct qbman_pull_desc *, uint8_t numframes);
|
|
/* token is the value that shows up in the dequeue results that can be used to
|
|
* detect when the results have been published, and is not really used when
|
|
* dequeue results go to DQRR. The easiest technique is to zero result "storage"
|
|
* before issuing a pull dequeue, and use any non-zero 'token' value. */
|
|
void qbman_pull_desc_set_token(struct qbman_pull_desc *, uint8_t token);
|
|
/* Exactly one of the following descriptor "actions" should be set. (Calling any
|
|
* one of these will replace the effect of any prior call to one of these.)
|
|
* - pull dequeue from the given frame queue (FQ)
|
|
* - pull dequeue from any FQ in the given work queue (WQ)
|
|
* - pull dequeue from any FQ in any WQ in the given channel
|
|
*/
|
|
void qbman_pull_desc_set_fq(struct qbman_pull_desc *, uint32_t fqid);
|
|
|
|
/* Issue the pull dequeue command */
|
|
int qbman_swp_pull(struct qbman_swp *, struct qbman_pull_desc *);
|
|
|
|
/* -------------------------------- */
|
|
/* Polling DQRR for dequeue results */
|
|
/* -------------------------------- */
|
|
|
|
/* NULL return if there are no unconsumed DQRR entries. Returns a DQRR entry
|
|
* only once, so repeated calls can return a sequence of DQRR entries, without
|
|
* requiring they be consumed immediately or in any particular order. */
|
|
const struct ldpaa_dq *qbman_swp_dqrr_next(struct qbman_swp *);
|
|
/* Consume DQRR entries previously returned from qbman_swp_dqrr_next(). */
|
|
void qbman_swp_dqrr_consume(struct qbman_swp *, const struct ldpaa_dq *);
|
|
|
|
/* ------------------------------------------------- */
|
|
/* Polling user-provided storage for dequeue results */
|
|
/* ------------------------------------------------- */
|
|
|
|
/* Only used for user-provided storage of dequeue results, not DQRR. Prior to
|
|
* being used, the storage must set "oldtoken", so that the driver notices when
|
|
* hardware has filled it in with results using a "newtoken". NB, for efficiency
|
|
* purposes, the driver will perform any required endianness conversion to
|
|
* ensure that the user's dequeue result storage is in host-endian format
|
|
* (whether or not that is the same as the little-endian format that hardware
|
|
* DMA'd to the user's storage). As such, once the user has called
|
|
* qbman_dq_entry_has_newtoken() and been returned a valid dequeue result, they
|
|
* should not call it again on the same memory location (except of course if
|
|
* another dequeue command has been executed to produce a new result to that
|
|
* location).
|
|
*/
|
|
void qbman_dq_entry_set_oldtoken(struct ldpaa_dq *,
|
|
unsigned int num_entries,
|
|
uint8_t oldtoken);
|
|
int qbman_dq_entry_has_newtoken(struct qbman_swp *,
|
|
const struct ldpaa_dq *,
|
|
uint8_t newtoken);
|
|
|
|
/* -------------------------------------------------------- */
|
|
/* Parsing dequeue entries (DQRR and user-provided storage) */
|
|
/* -------------------------------------------------------- */
|
|
|
|
/* DQRR entries may contain non-dequeue results, ie. notifications */
|
|
int qbman_dq_entry_is_DQ(const struct ldpaa_dq *);
|
|
|
|
/************/
|
|
/* Enqueues */
|
|
/************/
|
|
|
|
struct qbman_eq_desc {
|
|
uint32_t dont_manipulate_directly[8];
|
|
};
|
|
|
|
|
|
/* Clear the contents of a descriptor to default/starting state. */
|
|
void qbman_eq_desc_clear(struct qbman_eq_desc *);
|
|
/* Exactly one of the following descriptor "actions" should be set. (Calling
|
|
* any one of these will replace the effect of any prior call to one of these.)
|
|
* - enqueue without order-restoration
|
|
* - enqueue with order-restoration
|
|
* - fill a hole in the order-restoration sequence, without any enqueue
|
|
* - advance NESN (Next Expected Sequence Number), without any enqueue
|
|
* 'respond_success' indicates whether an enqueue response should be DMA'd
|
|
* after success (otherwise a response is DMA'd only after failure).
|
|
* 'incomplete' indicates that other fragments of the same 'seqnum' are yet to
|
|
* be enqueued.
|
|
*/
|
|
void qbman_eq_desc_set_no_orp(struct qbman_eq_desc *, int respond_success);
|
|
void qbman_eq_desc_set_response(struct qbman_eq_desc *,
|
|
dma_addr_t storage_phys,
|
|
int stash);
|
|
/* token is the value that shows up in an enqueue response that can be used to
|
|
* detect when the results have been published. The easiest technique is to zero
|
|
* result "storage" before issuing an enqueue, and use any non-zero 'token'
|
|
* value. */
|
|
void qbman_eq_desc_set_token(struct qbman_eq_desc *, uint8_t token);
|
|
/* Exactly one of the following descriptor "targets" should be set. (Calling any
|
|
* one of these will replace the effect of any prior call to one of these.)
|
|
* - enqueue to a frame queue
|
|
* - enqueue to a queuing destination
|
|
* Note, that none of these will have any affect if the "action" type has been
|
|
* set to "orp_hole" or "orp_nesn".
|
|
*/
|
|
void qbman_eq_desc_set_fq(struct qbman_eq_desc *, uint32_t fqid);
|
|
void qbman_eq_desc_set_qd(struct qbman_eq_desc *, uint32_t qdid,
|
|
uint32_t qd_bin, uint32_t qd_prio);
|
|
|
|
/* Issue an enqueue command. ('fd' should only be NULL if the "action" of the
|
|
* descriptor is "orp_hole" or "orp_nesn".) */
|
|
int qbman_swp_enqueue(struct qbman_swp *, const struct qbman_eq_desc *,
|
|
const struct qbman_fd *fd);
|
|
|
|
/*******************/
|
|
/* Buffer releases */
|
|
/*******************/
|
|
|
|
struct qbman_release_desc {
|
|
uint32_t dont_manipulate_directly[1];
|
|
};
|
|
|
|
/* Clear the contents of a descriptor to default/starting state. */
|
|
void qbman_release_desc_clear(struct qbman_release_desc *);
|
|
/* Set the ID of the buffer pool to release to */
|
|
void qbman_release_desc_set_bpid(struct qbman_release_desc *, uint32_t bpid);
|
|
/* Issue a release command. 'num_buffers' must be less than 8. */
|
|
int qbman_swp_release(struct qbman_swp *, const struct qbman_release_desc *,
|
|
const uint64_t *buffers, unsigned int num_buffers);
|
|
|
|
/*******************/
|
|
/* Buffer acquires */
|
|
/*******************/
|
|
|
|
int qbman_swp_acquire(struct qbman_swp *, uint32_t bpid, uint64_t *buffers,
|
|
unsigned int num_buffers);
|
|
#endif /* !_FSL_QBMAN_PORTAL_H */
|