mirror of
				https://github.com/smaeul/u-boot.git
				synced 2025-10-31 20:18:18 +00:00 
			
		
		
		
	Freescale's Layerscape Management Complex (MC) provide support various objects like DPRC, DPNI, DPBP and DPIO. Where: DPRC: Place holdes for other MC objectes like DPNI, DPBP, DPIO DPBP: Management of buffer pool DPIO: Used for used to QBMan portal DPNI: Represents standard network interface These objects are used for DPAA ethernet drivers. Signed-off-by: J. German Rivera <German.Rivera@freescale.com> Signed-off-by: Lijun Pan <Lijun.Pan@freescale.com> Signed-off-by: Stuart Yoder <stuart.yoder@freescale.com> Signed-off-by: Geoff Thorpe <Geoff.Thorpe@freescale.com> Signed-off-by: Haiying Wang <Haiying.Wang@freescale.com> Signed-off-by: Cristian Sovaiala <cristian.sovaiala@freescale.com> Signed-off-by: pankaj chauhan <pankaj.chauhan@freescale.com> Signed-off-by: Prabhakar Kushwaha <prabhakar@freescale.com> Reviewed-by: York Sun <yorksun@freescale.com>
		
			
				
	
	
		
			144 lines
		
	
	
		
			3.8 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			144 lines
		
	
	
		
			3.8 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /*
 | |
|  * Freescale Layerscape MC I/O wrapper
 | |
|  *
 | |
|  * Copyright (C) 2013-2015 Freescale Semiconductor, Inc.
 | |
|  * Author: German Rivera <German.Rivera@freescale.com>
 | |
|  *
 | |
|  * SPDX-License-Identifier:	GPL-2.0+
 | |
|  */
 | |
| /*!
 | |
|  *  @file    fsl_dpbp.h
 | |
|  *  @brief   Data Path Buffer Pool API
 | |
|  */
 | |
| #ifndef __FSL_DPBP_H
 | |
| #define __FSL_DPBP_H
 | |
| 
 | |
| /* DPBP Version */
 | |
| #define DPBP_VER_MAJOR				2
 | |
| #define DPBP_VER_MINOR				0
 | |
| 
 | |
| /* Command IDs */
 | |
| #define DPBP_CMDID_CLOSE				0x800
 | |
| #define DPBP_CMDID_OPEN					0x804
 | |
| 
 | |
| #define DPBP_CMDID_ENABLE				0x002
 | |
| #define DPBP_CMDID_DISABLE				0x003
 | |
| #define DPBP_CMDID_GET_ATTR				0x004
 | |
| #define DPBP_CMDID_RESET				0x005
 | |
| 
 | |
| /*                cmd, param, offset, width, type, arg_name */
 | |
| #define DPBP_CMD_OPEN(cmd, dpbp_id) \
 | |
| 	MC_CMD_OP(cmd, 0, 0,  32, int,	    dpbp_id)
 | |
| 
 | |
| /*                cmd, param, offset, width, type,	arg_name */
 | |
| #define DPBP_RSP_GET_ATTRIBUTES(cmd, attr) \
 | |
| do { \
 | |
| 	MC_RSP_OP(cmd, 0, 16, 16, uint16_t, attr->bpid); \
 | |
| 	MC_RSP_OP(cmd, 0, 32, 32, int,	    attr->id);\
 | |
| 	MC_RSP_OP(cmd, 1, 0,  16, uint16_t, attr->version.major);\
 | |
| 	MC_RSP_OP(cmd, 1, 16, 16, uint16_t, attr->version.minor);\
 | |
| } while (0)
 | |
| 
 | |
| /* Data Path Buffer Pool API
 | |
|  * Contains initialization APIs and runtime control APIs for DPBP
 | |
|  */
 | |
| 
 | |
| struct fsl_mc_io;
 | |
| 
 | |
| /**
 | |
|  * dpbp_open() - Open a control session for the specified object.
 | |
|  * @mc_io:	Pointer to MC portal's I/O object
 | |
|  * @dpbp_id:	DPBP 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 dpbp_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 dpbp_open(struct fsl_mc_io *mc_io, int dpbp_id, uint16_t *token);
 | |
| 
 | |
| /**
 | |
|  * dpbp_close() - Close the control session of the object
 | |
|  * @mc_io:	Pointer to MC portal's I/O object
 | |
|  * @token:	Token of DPBP 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 dpbp_close(struct fsl_mc_io *mc_io, uint16_t token);
 | |
| 
 | |
| /**
 | |
|  * dpbp_enable() - Enable the DPBP.
 | |
|  * @mc_io:	Pointer to MC portal's I/O object
 | |
|  * @token:	Token of DPBP object
 | |
|  *
 | |
|  * Return:	'0' on Success; Error code otherwise.
 | |
|  */
 | |
| 
 | |
| int dpbp_enable(struct fsl_mc_io *mc_io, uint16_t token);
 | |
| 
 | |
| /**
 | |
|  * dpbp_disable() - Disable the DPBP.
 | |
|  * @mc_io:	Pointer to MC portal's I/O object
 | |
|  * @token:	Token of DPBP object
 | |
|  *
 | |
|  * Return:	'0' on Success; Error code otherwise.
 | |
|  */
 | |
| int dpbp_disable(struct fsl_mc_io *mc_io, uint16_t token);
 | |
| 
 | |
| /**
 | |
|  * dpbp_reset() - Reset the DPBP, returns the object to initial state.
 | |
|  * @mc_io:	Pointer to MC portal's I/O object
 | |
|  * @token:	Token of DPBP object
 | |
|  *
 | |
|  * Return:	'0' on Success; Error code otherwise.
 | |
|  */
 | |
| int dpbp_reset(struct fsl_mc_io *mc_io, uint16_t token);
 | |
| 
 | |
| /**
 | |
|  * struct dpbp_attr - Structure representing DPBP attributes
 | |
|  * @id:		DPBP object ID
 | |
|  * @version:	DPBP version
 | |
|  * @bpid:	Hardware buffer pool ID; should be used as an argument in
 | |
|  *		acquire/release operations on buffers
 | |
|  */
 | |
| struct dpbp_attr {
 | |
| 	int id;
 | |
| 	/**
 | |
| 	 * struct version - Structure representing DPBP version
 | |
| 	 * @major:	DPBP major version
 | |
| 	 * @minor:	DPBP minor version
 | |
| 	 */
 | |
| 	struct {
 | |
| 		uint16_t major;
 | |
| 		uint16_t minor;
 | |
| 	} version;
 | |
| 	uint16_t bpid;
 | |
| };
 | |
| 
 | |
| 
 | |
| /**
 | |
|  * dpbp_get_attributes - Retrieve DPBP attributes.
 | |
|  *
 | |
|  * @mc_io:	Pointer to MC portal's I/O object
 | |
|  * @token:	Token of DPBP object
 | |
|  * @attr:	Returned object's attributes
 | |
|  *
 | |
|  * Return:	'0' on Success; Error code otherwise.
 | |
|  */
 | |
| int dpbp_get_attributes(struct fsl_mc_io	*mc_io,
 | |
| 			uint16_t		token,
 | |
| 			struct dpbp_attr	*attr);
 | |
| 
 | |
| /** @} */
 | |
| 
 | |
| #endif /* __FSL_DPBP_H */
 |