Merge branch 'next'
[oweals/u-boot.git] / include / fsl-mc / fsl_dprc.h
index 26a4598b610cc44fa620d88ea24c425ee30ba225..950ecb0756980f3281c4a073fc89f7f410c2df49 100644 (file)
@@ -1,35 +1,38 @@
+/* SPDX-License-Identifier: GPL-2.0+ */
 /*
  * 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+
+ * Copyright 2013-2016 Freescale Semiconductor, Inc.
+ * Copyright 2017 NXP
  */
 #ifndef _FSL_DPRC_H
 #define _FSL_DPRC_H
 
 /* DPRC Version */
-#define DPRC_VER_MAJOR                         4
-#define DPRC_VER_MINOR                         0
+#define DPRC_VER_MAJOR                         6
+#define DPRC_VER_MINOR                         1
 
 /* Command IDs */
-#define DPRC_CMDID_CLOSE                       0x800
-#define DPRC_CMDID_OPEN                                0x805
-
-#define DPRC_CMDID_GET_ATTR                    0x004
-#define DPRC_CMDID_RESET_CONT                  0x005
-
-#define DPRC_CMDID_GET_CONT_ID                 0x830
-#define DPRC_CMDID_GET_OBJ_COUNT               0x159
-#define DPRC_CMDID_GET_OBJ                     0x15A
-#define DPRC_CMDID_GET_RES_COUNT               0x15B
-#define DPRC_CMDID_GET_RES_IDS                 0x15C
-#define DPRC_CMDID_GET_OBJ_REG                 0x15E
-
-#define DPRC_CMDID_CONNECT                     0x167
-#define DPRC_CMDID_DISCONNECT                  0x168
-#define DPRC_CMDID_GET_CONNECTION              0x16C
+#define DPRC_CMDID_CLOSE                       0x8001
+#define DPRC_CMDID_OPEN                                0x8051
+#define DPRC_CMDID_CREATE                      0x9051
+
+#define DPRC_CMDID_GET_ATTR                    0x0041
+#define DPRC_CMDID_RESET_CONT                  0x0051
+#define DPRC_CMDID_GET_API_VERSION              0xa051
+
+#define DPRC_CMDID_CREATE_CONT                 0x1511
+#define DPRC_CMDID_DESTROY_CONT                        0x1521
+#define DPRC_CMDID_GET_CONT_ID                 0x8301
+#define DPRC_CMDID_GET_OBJ_COUNT               0x1591
+#define DPRC_CMDID_GET_OBJ                     0x15A1
+#define DPRC_CMDID_GET_RES_COUNT               0x15B1
+#define DPRC_CMDID_GET_RES_IDS                 0x15C1
+#define DPRC_CMDID_GET_OBJ_REG                 0x15E1
+
+#define DPRC_CMDID_CONNECT                     0x1671
+#define DPRC_CMDID_DISCONNECT                  0x1681
+#define DPRC_CMDID_GET_CONNECTION              0x16C1
 
 /*                cmd, param, offset, width, type, arg_name */
 #define DPRC_RSP_GET_CONTAINER_ID(cmd, container_id) \
 #define DPRC_CMD_OPEN(cmd, container_id) \
        MC_CMD_OP(cmd, 0, 0,  32, int,      container_id)
 
+/*                cmd, param, offset, width, type, arg_name */
+#define DPRC_CMD_CREATE_CONTAINER(cmd, cfg) \
+do { \
+       MC_CMD_OP(cmd, 0, 32, 16, uint16_t, cfg->icid); \
+       MC_CMD_OP(cmd, 0, 0,  32, uint32_t, cfg->options); \
+       MC_CMD_OP(cmd, 1, 32, 32, int,      cfg->portal_id); \
+       MC_CMD_OP(cmd, 2, 0,  8,  char,     cfg->label[0]);\
+       MC_CMD_OP(cmd, 2, 8,  8,  char,     cfg->label[1]);\
+       MC_CMD_OP(cmd, 2, 16, 8,  char,     cfg->label[2]);\
+       MC_CMD_OP(cmd, 2, 24, 8,  char,     cfg->label[3]);\
+       MC_CMD_OP(cmd, 2, 32, 8,  char,     cfg->label[4]);\
+       MC_CMD_OP(cmd, 2, 40, 8,  char,     cfg->label[5]);\
+       MC_CMD_OP(cmd, 2, 48, 8,  char,     cfg->label[6]);\
+       MC_CMD_OP(cmd, 2, 56, 8,  char,     cfg->label[7]);\
+       MC_CMD_OP(cmd, 3, 0,  8,  char,     cfg->label[8]);\
+       MC_CMD_OP(cmd, 3, 8,  8,  char,     cfg->label[9]);\
+       MC_CMD_OP(cmd, 3, 16, 8,  char,     cfg->label[10]);\
+       MC_CMD_OP(cmd, 3, 24, 8,  char,     cfg->label[11]);\
+       MC_CMD_OP(cmd, 3, 32, 8,  char,     cfg->label[12]);\
+       MC_CMD_OP(cmd, 3, 40, 8,  char,     cfg->label[13]);\
+       MC_CMD_OP(cmd, 3, 48, 8,  char,     cfg->label[14]);\
+       MC_CMD_OP(cmd, 3, 56, 8,  char,     cfg->label[15]);\
+} while (0)
+
+/*                cmd, param, offset, width, type, arg_name */
+#define DPRC_RSP_CREATE_CONTAINER(cmd, child_container_id, child_portal_offset)\
+do { \
+       MC_RSP_OP(cmd, 1, 0,  32, int,     child_container_id); \
+       MC_RSP_OP(cmd, 2, 0,  64, uint64_t, child_portal_offset);\
+} while (0)
+
+/*                cmd, param, offset, width, type, arg_name */
+#define DPRC_CMD_DESTROY_CONTAINER(cmd, child_container_id) \
+       MC_CMD_OP(cmd, 0, 0,  32, int,      child_container_id)
+
 /*                cmd, param, offset, width, type, arg_name */
 #define DPRC_CMD_RESET_CONTAINER(cmd, child_container_id) \
        MC_CMD_OP(cmd, 0, 0,  32, int,      child_container_id)
@@ -50,8 +88,6 @@ do { \
        MC_RSP_OP(cmd, 0, 32, 16, uint16_t, attr->icid); \
        MC_RSP_OP(cmd, 1, 0,  32, uint32_t, attr->options);\
        MC_RSP_OP(cmd, 1, 32, 32, int,      attr->portal_id); \
-       MC_RSP_OP(cmd, 2, 0,  16, uint16_t, attr->version.major);\
-       MC_RSP_OP(cmd, 2, 16, 16, uint16_t, attr->version.minor);\
 } while (0)
 
 /*                cmd, param, offset, width, type, arg_name */
@@ -72,6 +108,74 @@ do { \
        MC_RSP_OP(cmd, 1, 32, 32, uint32_t, obj_desc->state);\
        MC_RSP_OP(cmd, 2, 0,  16, uint16_t, obj_desc->ver_major);\
        MC_RSP_OP(cmd, 2, 16, 16, uint16_t, obj_desc->ver_minor);\
+       MC_RSP_OP(cmd, 2, 32, 16, uint16_t, obj_desc->flags); \
+       MC_RSP_OP(cmd, 3, 0,  8,  char,     obj_desc->type[0]);\
+       MC_RSP_OP(cmd, 3, 8,  8,  char,     obj_desc->type[1]);\
+       MC_RSP_OP(cmd, 3, 16, 8,  char,     obj_desc->type[2]);\
+       MC_RSP_OP(cmd, 3, 24, 8,  char,     obj_desc->type[3]);\
+       MC_RSP_OP(cmd, 3, 32, 8,  char,     obj_desc->type[4]);\
+       MC_RSP_OP(cmd, 3, 40, 8,  char,     obj_desc->type[5]);\
+       MC_RSP_OP(cmd, 3, 48, 8,  char,     obj_desc->type[6]);\
+       MC_RSP_OP(cmd, 3, 56, 8,  char,     obj_desc->type[7]);\
+       MC_RSP_OP(cmd, 4, 0,  8,  char,     obj_desc->type[8]);\
+       MC_RSP_OP(cmd, 4, 8,  8,  char,     obj_desc->type[9]);\
+       MC_RSP_OP(cmd, 4, 16, 8,  char,     obj_desc->type[10]);\
+       MC_RSP_OP(cmd, 4, 24, 8,  char,     obj_desc->type[11]);\
+       MC_RSP_OP(cmd, 4, 32, 8,  char,     obj_desc->type[12]);\
+       MC_RSP_OP(cmd, 4, 40, 8,  char,     obj_desc->type[13]);\
+       MC_RSP_OP(cmd, 4, 48, 8,  char,     obj_desc->type[14]);\
+       MC_RSP_OP(cmd, 4, 56, 8,  char,     obj_desc->type[15]);\
+       MC_RSP_OP(cmd, 5, 0,  8,  char,     obj_desc->label[0]);\
+       MC_RSP_OP(cmd, 5, 8,  8,  char,     obj_desc->label[1]);\
+       MC_RSP_OP(cmd, 5, 16, 8,  char,     obj_desc->label[2]);\
+       MC_RSP_OP(cmd, 5, 24, 8,  char,     obj_desc->label[3]);\
+       MC_RSP_OP(cmd, 5, 32, 8,  char,     obj_desc->label[4]);\
+       MC_RSP_OP(cmd, 5, 40, 8,  char,     obj_desc->label[5]);\
+       MC_RSP_OP(cmd, 5, 48, 8,  char,     obj_desc->label[6]);\
+       MC_RSP_OP(cmd, 5, 56, 8,  char,     obj_desc->label[7]);\
+       MC_RSP_OP(cmd, 6, 0,  8,  char,     obj_desc->label[8]);\
+       MC_RSP_OP(cmd, 6, 8,  8,  char,     obj_desc->label[9]);\
+       MC_RSP_OP(cmd, 6, 16, 8,  char,     obj_desc->label[10]);\
+       MC_RSP_OP(cmd, 6, 24, 8,  char,     obj_desc->label[11]);\
+       MC_RSP_OP(cmd, 6, 32, 8,  char,     obj_desc->label[12]);\
+       MC_RSP_OP(cmd, 6, 40, 8,  char,     obj_desc->label[13]);\
+       MC_RSP_OP(cmd, 6, 48, 8,  char,     obj_desc->label[14]);\
+       MC_RSP_OP(cmd, 6, 56, 8,  char,     obj_desc->label[15]);\
+} while (0)
+
+/*                cmd, param, offset, width, type, arg_name */
+#define DPRC_CMD_GET_OBJ_DESC(cmd, obj_type, obj_id) \
+do { \
+       MC_CMD_OP(cmd, 0, 0,  32, int,      obj_id);\
+       MC_CMD_OP(cmd, 1, 0,  8,  char,     obj_type[0]);\
+       MC_CMD_OP(cmd, 1, 8,  8,  char,     obj_type[1]);\
+       MC_CMD_OP(cmd, 1, 16, 8,  char,     obj_type[2]);\
+       MC_CMD_OP(cmd, 1, 24, 8,  char,     obj_type[3]);\
+       MC_CMD_OP(cmd, 1, 32, 8,  char,     obj_type[4]);\
+       MC_CMD_OP(cmd, 1, 40, 8,  char,     obj_type[5]);\
+       MC_CMD_OP(cmd, 1, 48, 8,  char,     obj_type[6]);\
+       MC_CMD_OP(cmd, 1, 56, 8,  char,     obj_type[7]);\
+       MC_CMD_OP(cmd, 2, 0,  8,  char,     obj_type[8]);\
+       MC_CMD_OP(cmd, 2, 8,  8,  char,     obj_type[9]);\
+       MC_CMD_OP(cmd, 2, 16, 8,  char,     obj_type[10]);\
+       MC_CMD_OP(cmd, 2, 24, 8,  char,     obj_type[11]);\
+       MC_CMD_OP(cmd, 2, 32, 8,  char,     obj_type[12]);\
+       MC_CMD_OP(cmd, 2, 40, 8,  char,     obj_type[13]);\
+       MC_CMD_OP(cmd, 2, 48, 8,  char,     obj_type[14]);\
+       MC_CMD_OP(cmd, 2, 56, 8,  char,     obj_type[15]);\
+} while (0)
+
+/*                cmd, param, offset, width, type, arg_name */
+#define DPRC_RSP_GET_OBJ_DESC(cmd, obj_desc) \
+do { \
+       MC_RSP_OP(cmd, 0, 32, 32, int,      obj_desc->id); \
+       MC_RSP_OP(cmd, 1, 0,  16, uint16_t, obj_desc->vendor); \
+       MC_RSP_OP(cmd, 1, 16, 8,  uint8_t,  obj_desc->irq_count); \
+       MC_RSP_OP(cmd, 1, 24, 8,  uint8_t,  obj_desc->region_count); \
+       MC_RSP_OP(cmd, 1, 32, 32, uint32_t, obj_desc->state);\
+       MC_RSP_OP(cmd, 2, 0,  16, uint16_t, obj_desc->ver_major);\
+       MC_RSP_OP(cmd, 2, 16, 16, uint16_t, obj_desc->ver_minor);\
+       MC_RSP_OP(cmd, 2, 32, 16, uint16_t, obj_desc->flags); \
        MC_RSP_OP(cmd, 3, 0,  8,  char,     obj_desc->type[0]);\
        MC_RSP_OP(cmd, 3, 8,  8,  char,     obj_desc->type[1]);\
        MC_RSP_OP(cmd, 3, 16, 8,  char,     obj_desc->type[2]);\
@@ -191,14 +295,16 @@ do { \
 /*     param, offset, width,   type,           arg_name */
 #define DPRC_RSP_GET_OBJ_REGION(cmd, region_desc) \
 do { \
-       MC_RSP_OP(cmd, 1, 0,  64, uint64_t, region_desc->base_offset);\
+       MC_RSP_OP(cmd, 1, 0,  32, uint32_t, region_desc->base_offset);\
        MC_RSP_OP(cmd, 2, 0,  32, uint32_t, region_desc->size); \
+       MC_RSP_OP(cmd, 2, 32, 4,  enum dprc_region_type, region_desc->type);\
+       MC_RSP_OP(cmd, 3, 0,  32, uint32_t, region_desc->flags);\
 } while (0)
 
 /*                cmd, param, offset, width, type, arg_name */
-#define DPRC_CMD_SET_OBJ_LABEL(cmd, obj_index, label) \
+#define DPRC_CMD_SET_OBJ_LABEL(cmd, obj_type, obj_id, label) \
 do { \
-       MC_CMD_OP(cmd, 0, 0,  32, int,      obj_index); \
+       MC_CMD_OP(cmd, 0, 0,  32, int,      obj_id); \
        MC_CMD_OP(cmd, 1, 0,  8,  char,     label[0]);\
        MC_CMD_OP(cmd, 1, 8,  8,  char,     label[1]);\
        MC_CMD_OP(cmd, 1, 16, 8,  char,     label[2]);\
@@ -215,15 +321,31 @@ do { \
        MC_CMD_OP(cmd, 2, 40, 8,  char,     label[13]);\
        MC_CMD_OP(cmd, 2, 48, 8,  char,     label[14]);\
        MC_CMD_OP(cmd, 2, 56, 8,  char,     label[15]);\
+       MC_CMD_OP(cmd, 3, 0,  8,  char,     obj_type[0]);\
+       MC_CMD_OP(cmd, 3, 8,  8,  char,     obj_type[1]);\
+       MC_CMD_OP(cmd, 3, 16, 8,  char,     obj_type[2]);\
+       MC_CMD_OP(cmd, 3, 24, 8,  char,     obj_type[3]);\
+       MC_CMD_OP(cmd, 3, 32, 8,  char,     obj_type[4]);\
+       MC_CMD_OP(cmd, 3, 40, 8,  char,     obj_type[5]);\
+       MC_CMD_OP(cmd, 3, 48, 8,  char,     obj_type[6]);\
+       MC_CMD_OP(cmd, 3, 56, 8,  char,     obj_type[7]);\
+       MC_CMD_OP(cmd, 4, 0,  8,  char,     obj_type[8]);\
+       MC_CMD_OP(cmd, 4, 8,  8,  char,     obj_type[9]);\
+       MC_CMD_OP(cmd, 4, 16, 8,  char,     obj_type[10]);\
+       MC_CMD_OP(cmd, 4, 24, 8,  char,     obj_type[11]);\
+       MC_CMD_OP(cmd, 4, 32, 8,  char,     obj_type[12]);\
+       MC_CMD_OP(cmd, 4, 40, 8,  char,     obj_type[13]);\
+       MC_CMD_OP(cmd, 4, 48, 8,  char,     obj_type[14]);\
+       MC_CMD_OP(cmd, 4, 56, 8,  char,     obj_type[15]);\
 } while (0)
 
 /*                cmd, param, offset, width, type, arg_name */
-#define DPRC_CMD_CONNECT(cmd, endpoint1, endpoint2) \
+#define DPRC_CMD_CONNECT(cmd, endpoint1, endpoint2, cfg) \
 do { \
        MC_CMD_OP(cmd, 0, 0,  32, int,      endpoint1->id); \
-       MC_CMD_OP(cmd, 0, 32, 32, int,      endpoint1->interface_id); \
+       MC_CMD_OP(cmd, 0, 32, 32, int, endpoint1->if_id); \
        MC_CMD_OP(cmd, 1, 0,  32, int,      endpoint2->id); \
-       MC_CMD_OP(cmd, 1, 32, 32, int,      endpoint2->interface_id); \
+       MC_CMD_OP(cmd, 1, 32, 32, int, endpoint2->if_id); \
        MC_CMD_OP(cmd, 2, 0,  8,  char,     endpoint1->type[0]); \
        MC_CMD_OP(cmd, 2, 8,  8,  char,     endpoint1->type[1]); \
        MC_CMD_OP(cmd, 2, 16, 8,  char,     endpoint1->type[2]); \
@@ -240,6 +362,8 @@ do { \
        MC_CMD_OP(cmd, 3, 40, 8,  char,     endpoint1->type[13]); \
        MC_CMD_OP(cmd, 3, 48, 8,  char,     endpoint1->type[14]); \
        MC_CMD_OP(cmd, 3, 56, 8,  char,     endpoint1->type[15]); \
+       MC_CMD_OP(cmd, 4, 0,  32, uint32_t, cfg->max_rate); \
+       MC_CMD_OP(cmd, 4, 32, 32, uint32_t, cfg->committed_rate); \
        MC_CMD_OP(cmd, 5, 0,  8,  char,     endpoint2->type[0]); \
        MC_CMD_OP(cmd, 5, 8,  8,  char,     endpoint2->type[1]); \
        MC_CMD_OP(cmd, 5, 16, 8,  char,     endpoint2->type[2]); \
@@ -262,7 +386,7 @@ do { \
 #define DPRC_CMD_DISCONNECT(cmd, endpoint) \
 do { \
        MC_CMD_OP(cmd, 0, 0,  32, int,      endpoint->id); \
-       MC_CMD_OP(cmd, 0, 32, 32, int,      endpoint->interface_id); \
+       MC_CMD_OP(cmd, 0, 32, 16, uint16_t, endpoint->if_id); \
        MC_CMD_OP(cmd, 1, 0,  8,  char,     endpoint->type[0]); \
        MC_CMD_OP(cmd, 1, 8,  8,  char,     endpoint->type[1]); \
        MC_CMD_OP(cmd, 1, 16, 8,  char,     endpoint->type[2]); \
@@ -284,8 +408,8 @@ do { \
 /*                cmd, param, offset, width, type, arg_name */
 #define DPRC_CMD_GET_CONNECTION(cmd, endpoint1) \
 do { \
-       MC_CMD_OP(cmd, 0, 0,  32, int,      endpoint1->id); \
-       MC_CMD_OP(cmd, 0, 32, 32, int,      endpoint1->interface_id); \
+       MC_CMD_OP(cmd, 0, 0,  32, int,      endpoint1->id); \
+       MC_CMD_OP(cmd, 0, 32, 32, int,      endpoint1->if_id); \
        MC_CMD_OP(cmd, 1, 0,  8,  char,     endpoint1->type[0]); \
        MC_CMD_OP(cmd, 1, 8,  8,  char,     endpoint1->type[1]); \
        MC_CMD_OP(cmd, 1, 16, 8,  char,     endpoint1->type[2]); \
@@ -304,12 +428,11 @@ do { \
        MC_CMD_OP(cmd, 2, 56, 8,  char,     endpoint1->type[15]); \
 } while (0)
 
-
 /*                cmd, param, offset, width, type, arg_name */
 #define DPRC_RSP_GET_CONNECTION(cmd, endpoint2, state) \
 do { \
        MC_RSP_OP(cmd, 3, 0,  32, int,      endpoint2->id); \
-       MC_RSP_OP(cmd, 3, 32, 32, int,      endpoint2->interface_id); \
+       MC_RSP_OP(cmd, 3, 32, 16, uint16_t, endpoint2->if_id); \
        MC_RSP_OP(cmd, 4, 0,  8,  char,     endpoint2->type[0]); \
        MC_RSP_OP(cmd, 4, 8,  8,  char,     endpoint2->type[1]); \
        MC_RSP_OP(cmd, 4, 16, 8,  char,     endpoint2->type[2]); \
@@ -351,16 +474,20 @@ struct fsl_mc_io;
 
 /**
  * dprc_get_container_id() - Get container ID associated with a given portal.
- * @mc_io:             Pointer to MC portal's I/O object
+ * @mc_io:     Pointer to MC portal's I/O object
+ * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
  * @container_id:      Requested container ID
  *
  * Return:     '0' on Success; Error code otherwise.
  */
-int dprc_get_container_id(struct fsl_mc_io *mc_io, int *container_id);
+int dprc_get_container_id(struct fsl_mc_io     *mc_io,
+                         uint32_t              cmd_flags,
+                         int                   *container_id);
 
 /**
  * dprc_open() - Open DPRC object for use
  * @mc_io:     Pointer to MC portal's I/O object
+ * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
  * @container_id: Container ID to open
  * @token:     Returned token of DPRC object
  *
@@ -368,11 +495,15 @@ int dprc_get_container_id(struct fsl_mc_io *mc_io, int *container_id);
  *
  * @warning    Required before any operation on the object.
  */
-int dprc_open(struct fsl_mc_io *mc_io, int container_id, uint16_t *token);
+int dprc_open(struct fsl_mc_io *mc_io,
+             uint32_t          cmd_flags,
+             int               container_id,
+             uint16_t          *token);
 
 /**
  * dprc_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 DPRC object
  *
  * After this function is called, no further operations are
@@ -380,7 +511,9 @@ int dprc_open(struct fsl_mc_io *mc_io, int container_id, uint16_t *token);
  *
  * Return:     '0' on Success; Error code otherwise.
  */
-int dprc_close(struct fsl_mc_io *mc_io, uint16_t token);
+int dprc_close(struct fsl_mc_io        *mc_io,
+              uint32_t         cmd_flags,
+              uint16_t         token);
 
 /**
  * Container general options
@@ -413,14 +546,13 @@ int dprc_close(struct fsl_mc_io *mc_io, uint16_t token);
  */
 #define DPRC_CFG_OPT_TOPOLOGY_CHANGES_ALLOWED  0x00000008
 
-/* IOMMU bypass - indicates whether objects of this container are permitted
- * to bypass the IOMMU.
- */
-#define DPRC_CFG_OPT_IOMMU_BYPASS              0x00000010
 
-/* AIOP - Indicates that container belongs to AIOP.  */
+/* AIOP - Indicates that container belongs to AIOP. */
 #define DPRC_CFG_OPT_AIOP                      0x00000020
 
+/* IRQ Config - Indicates that the container allowed to configure its IRQs.*/
+#define DPRC_CFG_OPT_IRQ_CFG_ALLOWED           0x00000040
+
 /**
  * struct dprc_cfg - Container configuration options
  * @icid: Container's ICID; if set to 'DPRC_GET_ICID_FROM_POOL', a free
@@ -437,9 +569,56 @@ struct dprc_cfg {
        char label[16];
 };
 
+/**
+ * dprc_create_container() - Create child container
+ * @mc_io:     Pointer to MC portal's I/O object
+ * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
+ * @token:     Token of DPRC object
+ * @cfg:       Child container configuration
+ * @child_container_id:        Returned child container ID
+ * @child_portal_offset: Returned child portal offset from MC portal base
+ *
+ *
+ * Return:     '0' on Success; Error code otherwise.
+ */
+int dprc_create_container(struct fsl_mc_io     *mc_io,
+                         uint32_t              cmd_flags,
+                         uint16_t              token,
+                         struct dprc_cfg       *cfg,
+                         int                   *child_container_id,
+                         uint64_t              *child_portal_offset);
+
+/**
+ * dprc_destroy_container() - Destroy child container.
+ * @mc_io:     Pointer to MC portal's I/O object
+ * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
+ * @token:     Token of DPRC object
+ * @child_container_id:        ID of the container to destroy
+ *
+ * This function terminates the child container, so following this call the
+ * child container ID becomes invalid.
+ *
+ * Notes:
+ * - All resources and objects of the destroyed container are returned to the
+ * parent container or destroyed if were created be the destroyed container.
+ * - This function destroy all the child containers of the specified
+ *   container prior to destroying the container itself.
+ *
+ * warning: Only the parent container is allowed to destroy a child policy
+ *             Container 0 can't be destroyed
+ *
+ * Return:     '0' on Success; Error code otherwise.
+ *
+ */
+int dprc_destroy_container(struct fsl_mc_io    *mc_io,
+                          uint32_t             cmd_flags,
+                          uint16_t             token,
+                          int                  child_container_id);
+
 /**
  * dprc_reset_container - Reset child container.
  * @mc_io:     Pointer to MC portal's I/O object
+ * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
  * @token:     Token of DPRC object
  * @child_container_id:        ID of the container to reset
  *
@@ -458,9 +637,10 @@ struct dprc_cfg {
  *
  * Return:     '0' on Success; Error code otherwise.
  */
-int dprc_reset_container(struct fsl_mc_io *mc_io,
-                        uint16_t token,
-                        int child_container_id);
+int dprc_reset_container(struct fsl_mc_io      *mc_io,
+                        uint32_t               cmd_flags,
+                        uint16_t               token,
+                        int                    child_container_id);
 
 /**
  * struct dprc_attributes - Container attributes
@@ -475,38 +655,35 @@ struct dprc_attributes {
        uint16_t icid;
        int portal_id;
        uint64_t options;
-       /**
-        * struct version - DPRC version
-        * @major: DPRC major version
-        * @minor: DPRC minor version
-        */
-       struct {
-               uint16_t major;
-               uint16_t minor;
-       } version;
 };
 
 /**
  * dprc_get_attributes() - Obtains container 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 DPRC object
- * @attributes Returned container attributes
+ * @attributes:        Returned container attributes
  *
  * Return:     '0' on Success; Error code otherwise.
  */
 int dprc_get_attributes(struct fsl_mc_io       *mc_io,
+                       uint32_t                cmd_flags,
                        uint16_t                token,
                        struct dprc_attributes  *attributes);
 
 /**
  * dprc_get_obj_count() - Obtains the number of objects in the DPRC
  * @mc_io:     Pointer to MC portal's I/O object
+ * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
  * @token:     Token of DPRC object
  * @obj_count: Number of objects assigned to the DPRC
  *
  * Return:     '0' on Success; Error code otherwise.
  */
-int dprc_get_obj_count(struct fsl_mc_io *mc_io, uint16_t token, int *obj_count);
+int dprc_get_obj_count(struct fsl_mc_io        *mc_io,
+                      uint32_t         cmd_flags,
+                      uint16_t         token,
+                      int                      *obj_count);
 
 /* Objects Attributes Flags */
 
@@ -515,6 +692,14 @@ int dprc_get_obj_count(struct fsl_mc_io *mc_io, uint16_t token, int *obj_count);
 /* Plugged state - Indicates that the object is plugged */
 #define DPRC_OBJ_STATE_PLUGGED         0x00000002
 
+/**
+ * Shareability flag - Object flag indicating no memory shareability.
+ *  the object generates memory accesses that are non coherent with other
+ *  masters;
+ *  user is responsible for proper memory handling through IOMMU configuration.
+ */
+#define DPRC_OBJ_FLAG_NO_MEM_SHAREABILITY              0x0001
+
 /**
  * struct dprc_obj_desc - Object descriptor, returned from dprc_get_obj()
  * @type: Type of object: NULL terminated string
@@ -526,6 +711,7 @@ int dprc_get_obj_count(struct fsl_mc_io *mc_io, uint16_t token, int *obj_count);
  * @region_count: Number of mappable regions supported by the object
  * @state: Object state: combination of DPRC_OBJ_STATE_ states
  * @label: Object label
+ * @flags: Object's flags
  */
 struct dprc_obj_desc {
        char type[16];
@@ -537,11 +723,13 @@ struct dprc_obj_desc {
        uint8_t region_count;
        uint32_t state;
        char label[16];
+       uint16_t        flags;
 };
 
 /**
  * dprc_get_obj() - Get general information on an 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 DPRC object
  * @obj_index: Index of the object to be queried (< obj_count)
  * @obj_desc:  Returns the requested object descriptor
@@ -554,6 +742,7 @@ struct dprc_obj_desc {
  * Return:     '0' on Success; Error code otherwise.
  */
 int dprc_get_obj(struct fsl_mc_io      *mc_io,
+                uint32_t               cmd_flags,
                 uint16_t               token,
                 int                    obj_index,
                 struct dprc_obj_desc   *obj_desc);
@@ -562,6 +751,7 @@ int dprc_get_obj(struct fsl_mc_io   *mc_io,
  * dprc_get_res_count() - Obtains the number of free resources that are
  *             assigned to this container, by pool type
  * @mc_io:     Pointer to MC portal's I/O object
+ * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
  * @token:     Token of DPRC object
  * @type:      pool type
  * @res_count: Returned number of free resources of the given
@@ -569,7 +759,8 @@ int dprc_get_obj(struct fsl_mc_io   *mc_io,
  *
  * Return:     '0' on Success; Error code otherwise.
  */
-int dprc_get_res_count(struct fsl_mc_io        *mc_io,
+int dprc_get_res_count(struct fsl_mc_io *mc_io,
+                      uint32_t cmd_flags,
                       uint16_t         token,
                       char             *type,
                       int              *res_count);
@@ -604,6 +795,7 @@ struct dprc_res_ids_range_desc {
 /**
  * dprc_get_res_ids() - Obtains IDs of free resources in the container
  * @mc_io:     Pointer to MC portal's I/O object
+ * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
  * @token:     Token of DPRC object
  * @type:      pool type
  * @range_desc:        range descriptor
@@ -611,10 +803,25 @@ struct dprc_res_ids_range_desc {
  * Return:     '0' on Success; Error code otherwise.
  */
 int dprc_get_res_ids(struct fsl_mc_io                  *mc_io,
+                    uint32_t                           cmd_flags,
                     uint16_t                           token,
                     char                               *type,
                     struct dprc_res_ids_range_desc     *range_desc);
 
+/* Region flags */
+/* Cacheable - Indicates that region should be mapped as cacheable */
+#define DPRC_REGION_CACHEABLE  0x00000001
+
+/**
+ * enum dprc_region_type - Region type
+ * @DPRC_REGION_TYPE_MC_PORTAL: MC portal region
+ * @DPRC_REGION_TYPE_QBMAN_PORTAL: Qbman portal region
+ */
+enum dprc_region_type {
+       DPRC_REGION_TYPE_MC_PORTAL,
+       DPRC_REGION_TYPE_QBMAN_PORTAL
+};
+
 /**
  * struct dprc_region_desc - Mappable region descriptor
  * @base_offset: Region offset from region's base address.
@@ -622,17 +829,22 @@ int dprc_get_res_ids(struct fsl_mc_io                     *mc_io,
  *     base address; For DPIO, region base is offset from SoC QMan portals
  *     base address
  * @size: Region size (in bytes)
+ * @flags: Region attributes
+ * @type: Portal region type
  */
 struct dprc_region_desc {
-       uint64_t base_offset;
+       uint32_t base_offset;
        uint32_t size;
+       uint32_t flags;
+       enum dprc_region_type type;
 };
 
 /**
  * dprc_get_obj_region() - Get region information for a specified 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 DPRC object
- * @obj_type;  Object type as returned in dprc_get_obj()
+ * @obj_type:  Object type as returned in dprc_get_obj()
  * @obj_id:    Unique object instance as returned in dprc_get_obj()
  * @region_index: The specific region to query
  * @region_desc:  Returns the requested region descriptor
@@ -640,6 +852,7 @@ struct dprc_region_desc {
  * Return:     '0' on Success; Error code otherwise.
  */
 int dprc_get_obj_region(struct fsl_mc_io       *mc_io,
+                       uint32_t                cmd_flags,
                        uint16_t                token,
                        char                    *obj_type,
                        int                     obj_id,
@@ -650,56 +863,95 @@ int dprc_get_obj_region(struct fsl_mc_io  *mc_io,
  *                     operations
  * @type: Endpoint object type: NULL terminated string
  * @id: Endpoint object ID
- * @interface_id: Interface ID; should be set for endpoints with multiple
+ * @if_id: Interface ID; should be set for endpoints with multiple
  *             interfaces ("dpsw", "dpdmux"); for others, always set to 0
  */
 struct dprc_endpoint {
-       char type[16];
-       int id;
-       int interface_id;
+       char            type[16];
+       int             id;
+       uint16_t        if_id;
+};
+
+/**
+ * struct dprc_connection_cfg - Connection configuration.
+ *                             Used for virtual connections only
+ * @committed_rate: Committed rate (Mbits/s)
+ * @max_rate: Maximum rate (Mbits/s)
+ */
+struct dprc_connection_cfg {
+       uint32_t committed_rate;
+       uint32_t max_rate;
 };
 
 /**
  * dprc_connect() - Connect two endpoints to create a network link between them
  * @mc_io:     Pointer to MC portal's I/O object
+ * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
  * @token:     Token of DPRC object
  * @endpoint1: Endpoint 1 configuration parameters
  * @endpoint2: Endpoint 2 configuration parameters
+ * @cfg: Connection configuration. The connection configuration is ignored for
+ *     connections made to DPMAC objects, where rate is retrieved from the
+ *     MAC configuration.
  *
  * Return:     '0' on Success; Error code otherwise.
  */
-int dprc_connect(struct fsl_mc_io              *mc_io,
-                uint16_t                       token,
-                const struct dprc_endpoint     *endpoint1,
-                const struct dprc_endpoint     *endpoint2);
+int dprc_connect(struct fsl_mc_io                      *mc_io,
+                uint32_t                               cmd_flags,
+                uint16_t                               token,
+                const struct dprc_endpoint             *endpoint1,
+                const struct dprc_endpoint             *endpoint2,
+                const struct dprc_connection_cfg       *cfg);
 
 /**
  * dprc_disconnect() - Disconnect one endpoint to remove its network connection
  * @mc_io:     Pointer to MC portal's I/O object
+ * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
  * @token:     Token of DPRC object
  * @endpoint:  Endpoint configuration parameters
  *
  * Return:     '0' on Success; Error code otherwise.
  */
 int dprc_disconnect(struct fsl_mc_io           *mc_io,
+                   uint32_t                    cmd_flags,
                    uint16_t                    token,
                    const struct dprc_endpoint  *endpoint);
 
 /**
 * dprc_get_connection() - Get connected endpoint and link status if connection
 *                      exists.
-* @mc_io       Pointer to MC portal's I/O object
-* @token       Token of DPRC object
-* @endpoint1   Endpoint 1 configuration parameters
-* @endpoint2   Returned endpoint 2 configuration parameters
-* @state:      Returned link state: 1 - link is up, 0 - link is down
+* @mc_io:      Pointer to MC portal's I/O object
+* @cmd_flags:  Command flags; one or more of 'MC_CMD_FLAG_'
+* @token:      Token of DPRC object
+* @endpoint1:  Endpoint 1 configuration parameters
+* @endpoint2:  Returned endpoint 2 configuration parameters
+* @state:      Returned link state:
+*           1 - link is up;
+*           0 - link is down;
+*           -1 - no connection (endpoint2 information is irrelevant)
 *
 * Return:     '0' on Success; -ENAVAIL if connection does not exist.
 */
 int dprc_get_connection(struct fsl_mc_io               *mc_io,
+                       uint32_t                        cmd_flags,
                        uint16_t                        token,
                        const struct dprc_endpoint      *endpoint1,
                        struct dprc_endpoint            *endpoint2,
                        int                             *state);
 
+/**
+ * dprc_get_api_version - Retrieve DPRC Major and Minor version info.
+ *
+ * @mc_io:     Pointer to MC portal's I/O object
+ * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
+ * @major_ver: DPRC major version
+ * @minor_ver: DPRC minor version
+ *
+ * Return:     '0' on Success; Error code otherwise.
+ */
+int dprc_get_api_version(struct fsl_mc_io *mc_io,
+                        u32 cmd_flags,
+                        u16 *major_ver,
+                        u16 *minor_ver);
+
 #endif /* _FSL_DPRC_H */