freebsd-dev/sys/dev/dpaa/qman.h

247 lines
7.3 KiB
C
Raw Normal View History

Add support for the Freescale dTSEC DPAA-based ethernet controller. Freescale's QorIQ line includes a new ethernet controller, based on their Datapath Acceleration Architecture (DPAA). This uses a combination of a Frame manager, Buffer manager, and Queue manager to improve performance across all interfaces by being able to pass data directly between hardware acceleration interfaces. As part of this import, Freescale's Netcomm Software (ncsw) driver is imported. This was an attempt by Freescale to create an OS-agnostic sub-driver for managing the hardware, using shims to interface to the OS-specific APIs. This work was abandoned, and Freescale's primary work is in the Linux driver (dual BSD/GPL license). Hence, this was imported directly to sys/contrib, rather than going through the vendor area. Going forward, FreeBSD-specific changes may be made to the ncsw code, diverging from the upstream in potentially incompatible ways. An alternative could be to import the Linux driver itself, using the linuxKPI layer, as that would maintain parity with the vendor-maintained driver. However, the Linux driver has not been evaluated for reliability yet, and may have issues with the import, whereas the ncsw-based driver in this commit was completed by Semihalf 4 years ago, and is very stable. Other SoC modules based on DPAA, which could be added in the future: * Security and Encryption engine (SEC4.x, SEC5.x) * RAID engine Additional work to be done: * Implement polling mode * Test vlan support * Add support for the Pattern Matching Engine, which can do regular expression matching on packets. This driver has been tested on the P5020 QorIQ SoC. Others listed in the dtsec(4) manual page are expected to work as the same DPAA engine is included in all. Obtained from: Semihalf Relnotes: Yes Sponsored by: Alex Perez/Inertial Computing
2016-02-29 03:38:00 +00:00
/*-
* Copyright (c) 2011-2012 Semihalf.
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
*
* $FreeBSD$
*/
#ifndef _QMAN_H
#define _QMAN_H
#include <machine/vmparam.h>
#include <contrib/ncsw/inc/Peripherals/qm_ext.h>
/**
* @group QMan private defines/declarations
* @{
*/
/**
* Maximum number of frame queues in all QMans.
*/
#define QMAN_MAX_FQIDS 16
/**
* Pool channel common to all software portals.
* @note Value of 0 reflects the e_QM_FQ_CHANNEL_POOL1 from e_QmFQChannel
* type used in qman_fqr_create().
*/
#define QMAN_COMMON_POOL_CHANNEL 0
#define QMAN_FQID_BASE 1
#define QMAN_CCSR_SIZE 0x1000
/*
* Portal defines
*/
#define QMAN_CE_PA(base) (base)
#define QMAN_CI_PA(base) ((base) + 0x100000)
#define QMAN_PORTAL_CE_PA(base, n) \
(QMAN_CE_PA(base) + ((n) * QMAN_PORTAL_CE_SIZE))
#define QMAN_PORTAL_CI_PA(base, n) \
(QMAN_CI_PA(base) + ((n) * QMAN_PORTAL_CI_SIZE))
struct qman_softc {
device_t sc_dev; /* device handle */
int sc_rrid; /* register rid */
struct resource *sc_rres; /* register resource */
int sc_irid; /* interrupt rid */
struct resource *sc_ires; /* interrupt resource */
bool sc_regs_mapped[MAXCPU];
t_Handle sc_qh; /* QMAN handle */
t_Handle sc_qph[MAXCPU]; /* QMAN portal handles */
vm_paddr_t sc_qp_pa; /* QMAN portal PA */
int sc_fqr_cpu[QMAN_MAX_FQIDS];
};
/** @> */
/**
* @group QMan bus interface
* @{
*/
int qman_attach(device_t dev);
int qman_detach(device_t dev);
int qman_suspend(device_t dev);
int qman_resume(device_t dev);
int qman_shutdown(device_t dev);
/** @> */
/**
* @group QMan API
* @{
*/
/**
* Create Frame Queue Range.
*
* @param fqids_num Number of frame queues in the range.
*
* @param channel Dedicated channel serviced by this
* Frame Queue Range.
*
* @param wq Work Queue Number within the channel.
*
* @param force_fqid If TRUE, fore allocation of specific
* FQID. Notice that there can not be two
* frame queues with the same ID in the
* system.
*
* @param fqid_or_align FQID if @force_fqid == TRUE, alignment
* of FQIDs entries otherwise.
*
* @param init_parked If TRUE, FQ state is initialized to
* "parked" state on creation. Otherwise,
* to "scheduled" state.
*
* @param hold_active If TRUE, the FQ may be held in the
* portal in "held active" state in
* anticipation of more frames being
* dequeued from it after the head frame
* is removed from the FQ and the dequeue
* response is returned. If FALSE the
* "held_active" state of the FQ is not
* allowed. This affects only on queues
* destined to software portals. Refer to
* the 6.3.4.6 of DPAA Reference Manual.
*
* @param prefer_in_cache If TRUE, prefer this FQR to be in QMan
* internal cache memory for all states.
*
* @param congst_avoid_ena If TRUE, enable congestion avoidance
* mechanism.
*
* @param congst_group A handle to the congestion group. Only
* relevant when @congst_avoid_ena == TRUE.
*
* @param overhead_accounting_len For each frame add this number for CG
* calculation (may be negative), if 0 -
* disable feature.
*
* @param tail_drop_threshold If not 0 - enable tail drop on this
* FQR.
*
* @return A handle to newly created FQR object.
*/
t_Handle qman_fqr_create(uint32_t fqids_num, e_QmFQChannel channel, uint8_t wq,
bool force_fqid, uint32_t fqid_or_align, bool init_parked,
bool hold_active, bool prefer_in_cache, bool congst_avoid_ena,
t_Handle congst_group, int8_t overhead_accounting_len,
uint32_t tail_drop_threshold);
/**
* Free Frame Queue Range.
*
* @param fqr A handle to FQR to be freed.
* @return E_OK on success; error code otherwise.
*/
t_Error qman_fqr_free(t_Handle fqr);
/**
* Register the callback function.
* The callback function will be called when a frame comes from this FQR.
*
* @param fqr A handle to FQR.
* @param callback A pointer to the callback function.
* @param app A pointer to the user's data.
* @return E_OK on success; error code otherwise.
*/
t_Error qman_fqr_register_cb(t_Handle fqr, t_QmReceivedFrameCallback *callback,
t_Handle app);
/**
* Enqueue a frame on a given FQR.
*
* @param fqr A handle to FQR.
* @param fqid_off FQID offset wihin the FQR.
* @param frame A frame to be enqueued to the transmission.
* @return E_OK on success; error code otherwise.
*/
t_Error qman_fqr_enqueue(t_Handle fqr, uint32_t fqid_off, t_DpaaFD *frame);
/**
* Get one of the FQR counter's value.
*
* @param fqr A handle to FQR.
* @param fqid_off FQID offset within the FQR.
* @param counter The requested counter.
* @return Counter's current value.
*/
uint32_t qman_fqr_get_counter(t_Handle fqr, uint32_t fqid_off,
e_QmFqrCounters counter);
/**
* Pull frame from FQR.
*
* @param fqr A handle to FQR.
* @param fqid_off FQID offset within the FQR.
* @param frame The received frame.
* @return E_OK on success; error code otherwise.
*/
t_Error qman_fqr_pull_frame(t_Handle fqr, uint32_t fqid_off, t_DpaaFD *frame);
/**
* Get base FQID of the FQR.
* @param fqr A handle to FQR.
* @return Base FQID of the FQR.
*/
uint32_t qman_fqr_get_base_fqid(t_Handle fqr);
/**
* Poll frames from QMan.
* This polls frames from the current software portal.
*
* @param source Type of frames to be polled.
* @return E_OK on success; error otherwise.
*/
t_Error qman_poll(e_QmPortalPollSource source);
/**
* General received frame callback.
* This is called, when user did not register his own callback for a given
* frame queue range (fqr).
*/
e_RxStoreResponse qman_received_frame_callback(t_Handle app, t_Handle qm_fqr,
t_Handle qm_portal, uint32_t fqid_offset, t_DpaaFD *frame);
/**
* General rejected frame callback.
* This is called, when user did not register his own callback for a given
* frame queue range (fqr).
*/
e_RxStoreResponse qman_rejected_frame_callback(t_Handle app, t_Handle qm_fqr,
t_Handle qm_portal, uint32_t fqid_offset, t_DpaaFD *frame,
t_QmRejectedFrameInfo *qm_rejected_frame_info);
/** @} */
#endif /* QMAN_H */