dmaengine: fsl-dpaa2-qdma: Add the DPDMAI(Data Path DMA Interface) support
PATCH v5 1/2 dmaengine: fsl-dpaa2-qdma: Add the DPDMAI(Data Path DMA Interface) support
The MC(Management Complex) exports the DPDMAI(Data Path DMA Interface) object as an interface to operate the DPAA2(Data Path Acceleration Architecture 2) qDMA Engine. The DPDMAI enables sending frame-based requests to qDMA and receiving back confirmation response on transaction completion, utilizing the DPAA2 QBMan(Queue Manager and Buffer Manager hardware) infrastructure. DPDMAI object provides up to two priorities for processing qDMA requests.
The following list summarizes the DPDMAI main features and capabilities:
1. Supports up to two scheduling priorities for processing service requests.
- Each DPDMAI transmit queue is mapped to one of two service priorities, allowing further prioritization in hardware between requests from different DPDMAI objects.
2. Supports up to two receive queues for incoming transaction completion confirmations.
- Each DPDMAI receive queue is mapped to one of two receive priorities, allowing further prioritization between other interfaces when associating the DPDMAI receive queues to DPIO or DPCON(Data Path Concentrator) objects.
3. Supports different scheduling options for processing received packets:
- Queues can be configured either in 'parked' mode (default), or attached to a DPIO object, or attached to DPCON object.
4. Allows interaction with one or more DPIO objects for dequeueing/enqueueing frame descriptors(FD) and for acquiring/releasing buffers.
5. Supports enable, disable, and reset operations.
Add dpdmai to support some platforms with dpaa2 qdma engine.
---
changed for v5:
- Clean up the format.
- Delete some useless struct and macro.
- Fix spell.
- Move the description of function from header to C file.
drivers/dma/fsl-dpaa2-qdma/dpdmai.c | 366 +++++++++++++++++++++++++++++++++++ drivers/dma/fsl-dpaa2-qdma/dpdmai.h | 177 +++++++++++++++++ 2 files changed, 543 insertions(+), 0 deletions(-) create mode 100644 drivers/dma/fsl-dpaa2-qdma/dpdmai.c create mode 100644 drivers/dma/fsl-dpaa2-qdma/dpdmai.h
drivers/dma/fsl-dpaa2-qdma/dpdmai.c new file +366 -0
@@ -0,0 +1,366 @@ +// SPDX-License-Identifier: GPL-2.0 +// Copyright 2019 NXP + +#include <linux/types.h> +#include <linux/io.h> +#include <linux/fsl/mc.h> +#include "dpdmai.h" + +struct dpdmai_rsp_get_attributes { +__le32 id; +u8 num_of_priorities; +u8 pad0[3 ]; +__le16 major; +__le16 minor; +}; + +struct dpdmai_cmd_queue { +__le32 dest_id; +u8 priority; +u8 queue; +u8 dest_type; +u8 pad; +__le64 user_ctx; +union { +__le32 options; +__le32 fqid; + }; +}; + +struct dpdmai_rsp_get_tx_queue { +__le64 pad; +__le32 fqid; +}; + +#define MC_CMD_OP (_cmd, _param, _offset, _width, _type, _arg) \ + ((_cmd).params[_param] |= mc_enc((_offset), (_width), _arg)) + +/* cmd, param, offset, width, type, arg_name */ +#define DPDMAI_CMD_CREATE (_cmd, _cfg) \ +do { \ + typeof(_cmd) (cmd) = (_cmd); \ + typeof(_cfg) (cfg) = (_cfg); \ + MC_CMD_OP(cmd, 0, 8, 8, u8, (cfg)->priorities[0]);\ + MC_CMD_OP(cmd, 0, 16, 8, u8, (cfg)->priorities[1]);\ +} while (0) + +static inline u64 mc_enc (int lsoffset,int width,u64 val) +{ +return (val &MAKE_UMASK64 (width)) << lsoffset; +} + +/** +* dpdmai_open() - Open a control session for the specified object +* @mc_io: Pointer to MC portal's I/O object +* @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_' +* @dpdmai_id: DPDMAI unique ID +* @token: Returned token; use in subsequent API calls +* +* This function can be used to open a control session for an +* already created object; an object may have been declared in +* the DPL or by calling the dpdmai_create() function. +* This function returns a unique authentication token, +* associated with the specific object ID and the specific MC +* portal; this token must be used in all subsequent commands for +* this specific object. +* +* Return: '0' on Success; Error code otherwise. +*/ +int dpdmai_open (struct fsl_mc_io *mc_io,u32 cmd_flags, +int dpdmai_id,u16 *token) +{ +struct fsl_mc_command cmd = {0 }; +__le64 *cmd_dpdmai_id; +int err; + +/* prepare command */ + cmd.header =mc_encode_cmd_header (DPDMAI_CMDID_OPEN , + cmd_flags,0 ); + + cmd_dpdmai_id = cmd.params; + *cmd_dpdmai_id =cpu_to_le32 (dpdmai_id); + +/* send command to mc*/ + err =mc_send_command (mc_io, &cmd); +if (err) +return err; + +/* retrieve response parameters */ + *token =mc_cmd_hdr_read_token (&cmd); + +return 0 ; +} + +/** +* dpdmai_close() - Close the control session of the object +* @mc_io: Pointer to MC portal's I/O object +* @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_' +* @token: Token of DPDMAI object +* +* After this function is called, no further operations are +* allowed on the object without opening a new control session. +* +* Return: '0' on Success; Error code otherwise. +*/ +int dpdmai_close (struct fsl_mc_io *mc_io,u32 cmd_flags,u16 token) +{ +struct fsl_mc_command cmd = {0 }; + +/* prepare command */ + cmd.header =mc_encode_cmd_header (DPDMAI_CMDID_CLOSE , + cmd_flags, token); + +/* send command to mc*/ +return mc_send_command (mc_io, &cmd); +} + +/** +* dpdmai_create() - Create the DPDMAI object +* @mc_io: Pointer to MC portal's I/O object +* @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_' +* @cfg: Configuration structure +* @token: Returned token; use in subsequent API calls +* +* Create the DPDMAI object, allocate required resources and +* perform required initialization. +* +* The object can be created either by declaring it in the +* DPL file, or by calling this function. +* +* This function returns a unique authentication token, +* associated with the specific object ID and the specific MC +* portal; this token must be used in all subsequent calls to +* this specific object. For objects that are created using the +* DPL file, call dpdmai_open() function to get an authentication +* token first. +* +* Return: '0' on Success; Error code otherwise. +*/ +int dpdmai_create (struct fsl_mc_io *mc_io,u32 cmd_flags, +const struct dpdmai_cfg *cfg,u16 *token) +{ +struct fsl_mc_command cmd = {0 }; +int err; + +/* prepare command */ + cmd.header =mc_encode_cmd_header (DPDMAI_CMDID_CREATE , + cmd_flags,0 ); +DPDMAI_CMD_CREATE (cmd, cfg); + +/* send command to mc*/ + err =mc_send_command (mc_io, &cmd); +if (err) +return err; + +/* retrieve response parameters */ + *token =mc_cmd_hdr_read_token (&cmd); + +return 0 ; +} + +/** +* dpdmai_enable() - Enable the DPDMAI, allow sending and receiving frames. +* @mc_io: Pointer to MC portal's I/O object +* @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_' +* @token: Token of DPDMAI object +* +* Return: '0' on Success; Error code otherwise. +*/ +int dpdmai_enable (struct fsl_mc_io *mc_io,u32 cmd_flags,u16 token) +{ +struct fsl_mc_command cmd = {0 }; + +/* prepare command */ + cmd.header =mc_encode_cmd_header (DPDMAI_CMDID_ENABLE , + cmd_flags, token); + +/* send command to mc*/ +return mc_send_command (mc_io, &cmd); +} + +/** +* dpdmai_disable() - Disable the DPDMAI, stop sending and receiving frames. +* @mc_io: Pointer to MC portal's I/O object +* @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_' +* @token: Token of DPDMAI object +* +* Return: '0' on Success; Error code otherwise. +*/ +int dpdmai_disable (struct fsl_mc_io *mc_io,u32 cmd_flags,u16 token) +{ +struct fsl_mc_command cmd = {0 }; + +/* prepare command */ + cmd.header =mc_encode_cmd_header (DPDMAI_CMDID_DISABLE , + cmd_flags, token); + +/* send command to mc*/ +return mc_send_command (mc_io, &cmd); +} + +/** +* dpdmai_reset() - Reset the DPDMAI, returns the object to initial state. +* @mc_io: Pointer to MC portal's I/O object +* @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_' +* @token: Token of DPDMAI object +* +* Return: '0' on Success; Error code otherwise. +*/ +int dpdmai_reset (struct fsl_mc_io *mc_io,u32 cmd_flags,u16 token) +{ +struct fsl_mc_command cmd = {0 }; + +/* prepare command */ + cmd.header =mc_encode_cmd_header (DPDMAI_CMDID_RESET , + cmd_flags, token); + +/* send command to mc*/ +return mc_send_command (mc_io, &cmd); +} + +/** +* dpdmai_get_attributes() - Retrieve DPDMAI attributes. +* @mc_io: Pointer to MC portal's I/O object +* @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_' +* @token: Token of DPDMAI object +* @attr: Returned object's attributes +* +* Return: '0' on Success; Error code otherwise. +*/ +int dpdmai_get_attributes (struct fsl_mc_io *mc_io,u32 cmd_flags, +u16 token,struct dpdmai_attr *attr) +{ +struct dpdmai_rsp_get_attributes *rsp_params; +struct fsl_mc_command cmd = {0 }; +int err; + +/* prepare command */ + cmd.header =mc_encode_cmd_header (DPDMAI_CMDID_GET_ATTR , + cmd_flags, token); + +/* send command to mc*/ + err =mc_send_command (mc_io, &cmd); +if (err) +return err; + +/* retrieve response parameters */ + rsp_params = (struct dpdmai_rsp_get_attributes *)cmd.params; + attr->id =le32_to_cpu (rsp_params->id); + attr->version.major =le16_to_cpu (rsp_params->major); + attr->version.minor =le16_to_cpu (rsp_params->minor); + attr->num_of_priorities = rsp_params->num_of_priorities; + +return 0 ; +} + +/** +* dpdmai_set_rx_queue() - Set Rx queue configuration +* @mc_io: Pointer to MC portal's I/O object +* @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_' +* @token: Token of DPDMAI object +* @priority: Select the queue relative to number of +* priorities configured at DPDMAI creation +* @cfg: Rx queue configuration +* +* Return: '0' on Success; Error code otherwise. +*/ +int dpdmai_set_rx_queue (struct fsl_mc_io *mc_io,u32 cmd_flags,u16 token, +u8 priority,const struct dpdmai_rx_queue_cfg *cfg) +{ +struct dpdmai_cmd_queue *cmd_params; +struct fsl_mc_command cmd = {0 }; + +/* prepare command */ + cmd.header =mc_encode_cmd_header (DPDMAI_CMDID_SET_RX_QUEUE , + cmd_flags, token); + + cmd_params = (struct dpdmai_cmd_queue *)cmd.params; + cmd_params->dest_id =cpu_to_le32 (cfg->dest_cfg.dest_id); + cmd_params->priority = cfg->dest_cfg.priority; + cmd_params->queue = priority; + cmd_params->dest_type = cfg->dest_cfg.dest_type; + cmd_params->user_ctx =cpu_to_le64 (cfg->user_ctx); + cmd_params->options =cpu_to_le32 (cfg->options); + +/* send command to mc*/ +return mc_send_command (mc_io, &cmd); +} + +/** +* dpdmai_get_rx_queue() - Retrieve Rx queue attributes. +* @mc_io: Pointer to MC portal's I/O object +* @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_' +* @token: Token of DPDMAI object +* @priority: Select the queue relative to number of +* priorities configured at DPDMAI creation +* @attr: Returned Rx queue attributes +* +* Return: '0' on Success; Error code otherwise. +*/ +int dpdmai_get_rx_queue (struct fsl_mc_io *mc_io,u32 cmd_flags,u16 token, +u8 priority,struct dpdmai_rx_queue_attr *attr) +{ +struct dpdmai_cmd_queue *cmd_params; +struct fsl_mc_command cmd = {0 }; +int err; + +/* prepare command */ + cmd.header =mc_encode_cmd_header (DPDMAI_CMDID_GET_RX_QUEUE , + cmd_flags, token); + + cmd_params = (struct dpdmai_cmd_queue *)cmd.params; + cmd_params->queue = priority; + +/* send command to mc*/ + err =mc_send_command (mc_io, &cmd); +if (err) +return err; + +/* retrieve response parameters */ + attr->dest_cfg.dest_id =le32_to_cpu (cmd_params->dest_id); + attr->dest_cfg.priority = cmd_params->priority; + attr->dest_cfg.dest_type = cmd_params->dest_type; + attr->user_ctx =le64_to_cpu (cmd_params->user_ctx); + attr->fqid =le32_to_cpu (cmd_params->fqid); + +return 0 ; +} + +/** +* dpdmai_get_tx_queue() - Retrieve Tx queue attributes. +* @mc_io: Pointer to MC portal's I/O object +* @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_' +* @token: Token of DPDMAI object +* @priority: Select the queue relative to number of +* priorities configured at DPDMAI creation +* @fqid: Returned Tx queue +* +* Return: '0' on Success; Error code otherwise. +*/ +int dpdmai_get_tx_queue (struct fsl_mc_io *mc_io,u32 cmd_flags, +u16 token,u8 priority,u32 *fqid) +{ +struct dpdmai_rsp_get_tx_queue *rsp_params; +struct dpdmai_cmd_queue *cmd_params; +struct fsl_mc_command cmd = {0 }; +int err; + +/* prepare command */ + cmd.header =mc_encode_cmd_header (DPDMAI_CMDID_GET_TX_QUEUE , + cmd_flags, token); + + cmd_params = (struct dpdmai_cmd_queue *)cmd.params; + cmd_params->queue = priority; + +/* send command to mc*/ + err =mc_send_command (mc_io, &cmd); +if (err) +return err; + +/* retrieve response parameters */ + + rsp_params = (struct dpdmai_rsp_get_tx_queue *)cmd.params; + *fqid =le32_to_cpu (rsp_params->fqid); + +return 0 ; +}
drivers/dma/fsl-dpaa2-qdma/dpdmai.h new file +177 -0
177 lines not on this page · raw message
Signature · 1 line
1.7.1
PATCH v5 2/2 dmaengine: fsl-dpaa2-qdma: Add NXP dpaa2 qDMA controller driver for Layerscape SoCs
DPPA2(Data Path Acceleration Architecture 2) qDMA supports virtualized channel by allowing DMA jobs to be enqueued into different work queues. Core can initiate a DMA transaction by preparing a frame descriptor(FD) for each DMA job and enqueuing this job through a hardware portal. DPAA2 components can also prepare a FD and enqueue a DMA job through a hardware portal. The qDMA prefetches DMA jobs through DPAA2 hardware portal. It then schedules and dispatches to internal DMA hardware engines, which generate read and write requests. Both qDMA source data and destination data can be either contiguous or non-contiguous using one or more scatter/gather tables.
The qDMA supports global bandwidth flow control where all DMA transactions are stalled if the bandwidth threshold has been reached. Also supported are transaction based read throttling.
Add NXP dppa2 qDMA to support some of Layerscape SoCs. such as: LS1088A, LS208xA, LX2, etc.
---
changed for v5:
- Clean up the format and code.
- Update comments.
- Add error logs.
drivers/dma/Kconfig | 2 + drivers/dma/Makefile | 1 + drivers/dma/fsl-dpaa2-qdma/Kconfig | 9 + drivers/dma/fsl-dpaa2-qdma/Makefile | 3 + drivers/dma/fsl-dpaa2-qdma/dpaa2-qdma.c | 825 +++++++++++++++++++++++++++++++ drivers/dma/fsl-dpaa2-qdma/dpaa2-qdma.h | 153 ++++++ 6 files changed, 993 insertions(+), 0 deletions(-) create mode 100644 drivers/dma/fsl-dpaa2-qdma/Kconfig create mode 100644 drivers/dma/fsl-dpaa2-qdma/Makefile create mode 100644 drivers/dma/fsl-dpaa2-qdma/dpaa2-qdma.c create mode 100644 drivers/dma/fsl-dpaa2-qdma/dpaa2-qdma.h
drivers/dma/Kconfig +2 -0
@@ -673,6 +673,8 @@ source "drivers/dma/sh/Kconfig" source "drivers/dma/ti/Kconfig" +source "drivers/dma/fsl-dpaa2-qdma/Kconfig" + # clients comment "DMA Clients" depends on DMA_ENGINE
drivers/dma/Makefile +1 -0
@@ -76,6 +76,7 @@ obj-$(CONFIG_UNIPHIER_MDMAC) += uniphier-mdmac.o obj-$(CONFIG_XGENE_DMA) += xgene-dma.o obj-$(CONFIG_ZX_DMA) += zx_dma.o obj-$(CONFIG_ST_FDMA) += st_fdma.o +obj-$(CONFIG_FSL_DPAA2_QDMA) += fsl-dpaa2-qdma/ obj-y += mediatek/ obj-y += qcom/
drivers/dma/fsl-dpaa2-qdma/Kconfig new file +9 -0
@@ -0,0 +1,9 @@ +menuconfig FSL_DPAA2_QDMA + tristate "NXP DPAA2 QDMA" + depends on ARM64 + depends on FSL_MC_BUS && FSL_MC_DPIO + select DMA_ENGINE + select DMA_VIRTUAL_CHANNELS + help + NXP Data Path Acceleration Architecture 2 QDMA driver, + using the NXP MC bus driver.
drivers/dma/fsl-dpaa2-qdma/Makefile new file +3 -0
@@ -0,0 +1,3 @@ +# SPDX-License-Identifier: GPL-2.0 +# Makefile for the NXP DPAA2 qDMA controllers +obj-$(CONFIG_FSL_DPAA2_QDMA) += dpaa2-qdma.o dpdmai.o
drivers/dma/fsl-dpaa2-qdma/dpaa2-qdma.c new file +825 -0
825 lines not on this page · raw message
drivers/dma/fsl-dpaa2-qdma/dpaa2-qdma.h new file +153 -0
153 lines not on this page · raw message
Signature · 1 line
1.7.1