]> git.ipfire.org Git - people/ms/u-boot.git/blobdiff - include/fsl-mc/fsl_dpio.h
arc/cache: really do invalidate_dcache_all() even if IOC exists
[people/ms/u-boot.git] / include / fsl-mc / fsl_dpio.h
index e779909ccce6eee523d5e7ce4009e75202184275..d8c458fb4fc270d6ed83afa442df0454eb536d64 100644 (file)
@@ -9,11 +9,13 @@
 
 /* DPIO Version */
 #define DPIO_VER_MAJOR                         3
-#define DPIO_VER_MINOR                         0
+#define DPIO_VER_MINOR                         2
 
 /* Command IDs */
 #define DPIO_CMDID_CLOSE                                       0x800
 #define DPIO_CMDID_OPEN                                                0x803
+#define DPIO_CMDID_CREATE                                      0x903
+#define DPIO_CMDID_DESTROY                                     0x900
 
 #define DPIO_CMDID_ENABLE                                      0x002
 #define DPIO_CMDID_DISABLE                                     0x003
 #define DPIO_CMD_OPEN(cmd, dpio_id) \
        MC_CMD_OP(cmd, 0, 0,  32, int,     dpio_id)
 
+/*                cmd, param, offset, width, type, arg_name */
+#define DPIO_CMD_CREATE(cmd, cfg) \
+do { \
+       MC_CMD_OP(cmd, 0, 16, 2,  enum dpio_channel_mode,       \
+                                          cfg->channel_mode);\
+       MC_CMD_OP(cmd, 0, 32, 8,  uint8_t, cfg->num_priorities);\
+} while (0)
+
 /*                cmd, param, offset, width, type, arg_name */
 #define DPIO_RSP_GET_ATTR(cmd, attr) \
 do { \
@@ -35,6 +45,7 @@ do { \
        MC_RSP_OP(cmd, 2, 0,  64, uint64_t, attr->qbman_portal_ci_offset);\
        MC_RSP_OP(cmd, 3, 0,  16, uint16_t, attr->version.major);\
        MC_RSP_OP(cmd, 3, 16, 16, uint16_t, attr->version.minor);\
+       MC_RSP_OP(cmd, 3, 32, 32, uint32_t, attr->qbman_version);\
 } while (0)
 
 /* Data Path I/O Portal API
@@ -46,6 +57,7 @@ struct fsl_mc_io;
 /**
  * dpio_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_'
  * @dpio_id:   DPIO unique ID
  * @token:     Returned token; use in subsequent API calls
  *
@@ -59,16 +71,22 @@ struct fsl_mc_io;
  *
  * Return:     '0' on Success; Error code otherwise.
  */
-int dpio_open(struct fsl_mc_io *mc_io, int dpio_id, uint16_t *token);
+int dpio_open(struct fsl_mc_io *mc_io,
+             uint32_t          cmd_flags,
+             int               dpio_id,
+             uint16_t          *token);
 
 /**
  * dpio_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 DPIO object
  *
  * Return:     '0' on Success; Error code otherwise.
  */
-int dpio_close(struct fsl_mc_io *mc_io, uint16_t token);
+int dpio_close(struct fsl_mc_io        *mc_io,
+              uint32_t         cmd_flags,
+              uint16_t         token);
 
 /**
  * enum dpio_channel_mode - DPIO notification channel mode
@@ -82,32 +100,91 @@ enum dpio_channel_mode {
        DPIO_LOCAL_CHANNEL = 1,
 };
 
+/**
+ * struct dpio_cfg - Structure representing DPIO configuration
+ * @channel_mode: Notification channel mode
+ * @num_priorities: Number of priorities for the notification channel (1-8);
+ *                     relevant only if 'channel_mode = DPIO_LOCAL_CHANNEL'
+ */
+struct dpio_cfg {
+       enum dpio_channel_mode  channel_mode;
+       uint8_t         num_priorities;
+};
+
+/**
+ * dpio_create() - Create the DPIO 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 DPIO 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 dpio_open() function to get an authentication
+ * token first.
+ *
+ * Return:     '0' on Success; Error code otherwise.
+ */
+int dpio_create(struct fsl_mc_io       *mc_io,
+               uint32_t                cmd_flags,
+               const struct dpio_cfg   *cfg,
+               uint16_t                *token);
+
+/**
+ * dpio_destroy() - Destroy the DPIO object and release all its resources.
+ * @mc_io:     Pointer to MC portal's I/O object
+ * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
+ * @token:     Token of DPIO object
+ *
+ * Return:     '0' on Success; Error code otherwise
+ */
+int dpio_destroy(struct fsl_mc_io      *mc_io,
+                uint32_t               cmd_flags,
+                uint16_t               token);
+
 /**
  * dpio_enable() - Enable the DPIO, allow I/O portal operations.
  * @mc_io:     Pointer to MC portal's I/O object
+ * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
  * @token:     Token of DPIO object
  *
  * Return:     '0' on Success; Error code otherwise
  */
-int dpio_enable(struct fsl_mc_io *mc_io, uint16_t token);
+int dpio_enable(struct fsl_mc_io       *mc_io,
+               uint32_t                cmd_flags,
+               uint16_t                token);
 
 /**
  * dpio_disable() - Disable the DPIO, stop any I/O portal operation.
  * @mc_io:     Pointer to MC portal's I/O object
+ * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
  * @token:     Token of DPIO object
  *
  * Return:     '0' on Success; Error code otherwise
  */
-int dpio_disable(struct fsl_mc_io *mc_io, uint16_t token);
+int dpio_disable(struct fsl_mc_io      *mc_io,
+                uint32_t               cmd_flags,
+                uint16_t               token);
 
 /**
  * dpio_reset() - Reset the DPIO, 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 DPIO object
  *
  * Return:     '0' on Success; Error code otherwise.
  */
-int dpio_reset(struct fsl_mc_io *mc_io, uint16_t token);
+int dpio_reset(struct fsl_mc_io        *mc_io,
+              uint32_t                 cmd_flags,
+              uint16_t         token);
 
 /**
  * struct dpio_attr - Structure representing DPIO attributes
@@ -119,6 +196,7 @@ int dpio_reset(struct fsl_mc_io *mc_io, uint16_t token);
  * @channel_mode: Notification channel mode
  * @num_priorities: Number of priorities for the notification channel (1-8);
  *                     relevant only if 'channel_mode = DPIO_LOCAL_CHANNEL'
+ * @qbman_version: QBMAN version
  */
 struct dpio_attr {
        int id;
@@ -136,17 +214,20 @@ struct dpio_attr {
        uint16_t qbman_portal_id;
        enum dpio_channel_mode channel_mode;
        uint8_t num_priorities;
+       uint32_t                qbman_version;
 };
 
 /**
  * dpio_get_attributes() - Retrieve DPIO 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 DPIO object
  * @attr:      Returned object's attributes
  *
  * Return:     '0' on Success; Error code otherwise
  */
 int dpio_get_attributes(struct fsl_mc_io       *mc_io,
+                       uint32_t                cmd_flags,
                        uint16_t                token,
                        struct dpio_attr        *attr);