]> git.dujemihanovic.xyz Git - u-boot.git/commitdiff
net: fsl-mc: sync DPMAC MC APIs
authorIoana Ciornei <ioana.ciornei@nxp.com>
Wed, 31 May 2023 16:04:31 +0000 (19:04 +0300)
committerPeng Fan <peng.fan@nxp.com>
Thu, 15 Jun 2023 09:58:53 +0000 (17:58 +0800)
Sync the Data Path MAC APIs to their latest form, this means the
layout of each command is created based on structures which clearly
describe the endianness of each field rather than some macros.

The command version is kept in place, meaning that the minimum MC
version accepted is not changed in any way.

Signed-off-by: Ioana Ciornei <ioana.ciornei@nxp.com>
Signed-off-by: Peng Fan <peng.fan@nxp.com>
drivers/net/fsl-mc/dpmac.c
include/fsl-mc/fsl_dpmac.h

index f6def987c10b3f18faa5d4cdf2eaef2a5af8924a..5d4f6c67fd0b4a0fa3fb95e3ee973df9176f2905 100644 (file)
 #include <fsl-mc/fsl_mc_cmd.h>
 #include <fsl-mc/fsl_dpmac.h>
 
-int dpmac_open(struct fsl_mc_io *mc_io,
-              uint32_t cmd_flags,
-              int dpmac_id,
-              uint16_t *token)
+/**
+ * dpmac_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_'
+ * @dpmac_id:  DPMAC 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 dpmac_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 dpmac_open(struct fsl_mc_io *mc_io, u32 cmd_flags, int dpmac_id, u16 *token)
 {
+       struct dpmac_cmd_open *cmd_params;
        struct mc_command cmd = { 0 };
        int err;
 
        /* prepare command */
-       cmd.header = mc_encode_cmd_header(DPMAC_CMDID_OPEN,
-                                         cmd_flags,
-                                         0);
-       DPMAC_CMD_OPEN(cmd, dpmac_id);
+       cmd.header = mc_encode_cmd_header(DPMAC_CMDID_OPEN, cmd_flags, 0);
+       cmd_params = (struct dpmac_cmd_open *)cmd.params;
+       cmd_params->dpmac_id = cpu_to_le32(dpmac_id);
 
        /* send command to mc*/
        err = mc_send_command(mc_io, &cmd);
@@ -31,39 +45,63 @@ int dpmac_open(struct fsl_mc_io *mc_io,
                return err;
 
        /* retrieve response parameters */
-       *token = MC_CMD_HDR_READ_TOKEN(cmd.header);
+       *token = mc_cmd_hdr_read_token(&cmd);
 
        return err;
 }
 
-int dpmac_close(struct fsl_mc_io *mc_io,
-               uint32_t cmd_flags,
-               uint16_t token)
+/**
+ * dpmac_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 DPMAC 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 dpmac_close(struct fsl_mc_io *mc_io, u32 cmd_flags, u16 token)
 {
        struct mc_command cmd = { 0 };
 
        /* prepare command */
-       cmd.header = mc_encode_cmd_header(DPMAC_CMDID_CLOSE, cmd_flags,
-                                         token);
+       cmd.header = mc_encode_cmd_header(DPMAC_CMDID_CLOSE, cmd_flags, token);
 
        /* send command to mc*/
        return mc_send_command(mc_io, &cmd);
 }
 
-int dpmac_create(struct fsl_mc_io *mc_io,
-                uint16_t dprc_token,
-                uint32_t cmd_flags,
-                const struct dpmac_cfg *cfg,
-                uint32_t *obj_id)
+/**
+ * dpmac_create() - Create the DPMAC object.
+ * @mc_io:     Pointer to MC portal's I/O object
+ * @dprc_token: Parent container token; '0' for default container
+ * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
+ * @cfg:       Configuration structure
+ * @obj_id:    Returned object id
+ *
+ * Create the DPMAC object, allocate required resources and
+ * perform required initialization.
+ *
+ * The function accepts an authentication token of a parent
+ * container that this object should be assigned to. The token
+ * can be '0' so the object will be assigned to the default container.
+ * The newly created object can be opened with the returned
+ * object id and using the container's associated tokens and MC portals.
+ *
+ * Return:     '0' on Success; Error code otherwise.
+ */
+int dpmac_create(struct fsl_mc_io *mc_io, u16 dprc_token, u32 cmd_flags,
+                const struct dpmac_cfg *cfg, u32 *obj_id)
 {
+       struct dpmac_cmd_create *cmd_params;
        struct mc_command cmd = { 0 };
        int err;
 
        /* prepare command */
-       cmd.header = mc_encode_cmd_header(DPMAC_CMDID_CREATE,
-                                         cmd_flags,
-                                         dprc_token);
-       DPMAC_CMD_CREATE(cmd, cfg);
+       cmd.header = mc_encode_cmd_header(DPMAC_CMDID_CREATE, cmd_flags, dprc_token);
+       cmd_params = (struct dpmac_cmd_create *)cmd.params;
+       cmd_params->mac_id = cpu_to_le32(cfg->mac_id);
 
        /* send command to mc*/
        err = mc_send_command(mc_io, &cmd);
@@ -71,53 +109,87 @@ int dpmac_create(struct fsl_mc_io *mc_io,
                return err;
 
        /* retrieve response parameters */
-       MC_CMD_READ_OBJ_ID(cmd, *obj_id);
+       *obj_id = mc_cmd_read_object_id(&cmd);
 
        return 0;
 }
 
-int dpmac_destroy(struct fsl_mc_io *mc_io,
-                 uint16_t dprc_token,
-                 uint32_t cmd_flags,
-                 uint32_t obj_id)
+/**
+ * dpmac_destroy() - Destroy the DPMAC object and release all its resources.
+ * @mc_io:     Pointer to MC portal's I/O object
+ * @dprc_token: Parent container token; '0' for default container
+ * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
+ * @object_id: The object id; it must be a valid id within the container that
+ * created this object;
+ *
+ * The function accepts the authentication token of the parent container that
+ * created the object (not the one that currently owns the object). The object
+ * is searched within parent using the provided 'object_id'.
+ * All tokens to the object must be closed before calling destroy.
+ *
+ * Return:     '0' on Success; error code otherwise.
+ */
+int dpmac_destroy(struct fsl_mc_io *mc_io, u16 dprc_token, u32 cmd_flags,
+                 u32 object_id)
 {
+       struct dpmac_cmd_destroy *cmd_params;
        struct mc_command cmd = { 0 };
 
        /* prepare command */
        cmd.header = mc_encode_cmd_header(DPMAC_CMDID_DESTROY,
                                          cmd_flags,
                                          dprc_token);
-
-       /* set object id to destroy */
-       CMD_DESTROY_SET_OBJ_ID_PARAM0(cmd, obj_id);
+       cmd_params = (struct dpmac_cmd_destroy *)cmd.params;
+       cmd_params->dpmac_id = cpu_to_le32(object_id);
 
        /* send command to mc*/
        return mc_send_command(mc_io, &cmd);
 }
 
-int dpmac_set_link_state(struct fsl_mc_io *mc_io,
-                        uint32_t cmd_flags,
-                        uint16_t token,
+/**
+ * dpmac_set_link_state() - Set the Ethernet link status
+ * @mc_io:     Pointer to opaque I/O object
+ * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
+ * @token:     Token of DPMAC object
+ * @link_state:        Link state configuration
+ *
+ * Return:     '0' on Success; Error code otherwise.
+ */
+int dpmac_set_link_state(struct fsl_mc_io *mc_io, u32 cmd_flags, u16 token,
                         struct dpmac_link_state *link_state)
 {
+       struct dpmac_cmd_set_link_state *cmd_params;
        struct mc_command cmd = { 0 };
 
        /* prepare command */
-       cmd.header = mc_encode_cmd_header(DPMAC_CMDID_SET_LINK_STATE,
-                                         cmd_flags,
-                                         token);
-       DPMAC_CMD_SET_LINK_STATE(cmd, link_state);
+       cmd.header = mc_encode_cmd_header(DPMAC_CMDID_SET_LINK_STATE, cmd_flags, token);
+       cmd_params = (struct dpmac_cmd_set_link_state *)cmd.params;
+       cmd_params->options = cpu_to_le64(link_state->options);
+       cmd_params->rate = cpu_to_le32(link_state->rate);
+       cmd_params->up = dpmac_get_field(link_state->up, STATE);
+       dpmac_set_field(cmd_params->up, STATE_VALID, link_state->state_valid);
+       cmd_params->supported = cpu_to_le64(link_state->supported);
+       cmd_params->advertising = cpu_to_le64(link_state->advertising);
 
        /* send command to mc*/
        return mc_send_command(mc_io, &cmd);
 }
 
-int dpmac_get_counter(struct fsl_mc_io *mc_io,
-                     uint32_t cmd_flags,
-                     uint16_t token,
-                     enum dpmac_counter type,
-                     uint64_t *counter)
+/**
+ * dpmac_get_counter() - Read a specific DPMAC counter
+ * @mc_io:     Pointer to opaque I/O object
+ * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
+ * @token:     Token of DPMAC object
+ * @type:      The requested counter
+ * @counter:   Returned counter value
+ *
+ * Return:     The requested counter; '0' otherwise.
+ */
+int dpmac_get_counter(struct fsl_mc_io *mc_io, u32 cmd_flags, u16 token,
+                     enum dpmac_counter type, uint64_t *counter)
 {
+       struct dpmac_cmd_get_counter *dpmac_cmd;
+       struct dpmac_rsp_get_counter *dpmac_rsp;
        struct mc_command cmd = { 0 };
        int err = 0;
 
@@ -125,36 +197,43 @@ int dpmac_get_counter(struct fsl_mc_io *mc_io,
        cmd.header = mc_encode_cmd_header(DPMAC_CMDID_GET_COUNTER,
                                          cmd_flags,
                                          token);
-       DPMAC_CMD_GET_COUNTER(cmd, type);
+       dpmac_cmd = (struct dpmac_cmd_get_counter *)cmd.params;
+       dpmac_cmd->type = type;
 
        /* send command to mc*/
        err = mc_send_command(mc_io, &cmd);
        if (err)
                return err;
 
-       DPMAC_RSP_GET_COUNTER(cmd, *counter);
+       dpmac_rsp = (struct dpmac_rsp_get_counter *)cmd.params;
+       *counter = le64_to_cpu(dpmac_rsp->counter);
 
        return 0;
 }
 
-int dpmac_get_api_version(struct fsl_mc_io *mc_io,
-                        u32 cmd_flags,
-                        u16 *major_ver,
-                        u16 *minor_ver)
+/**
+ * dpmac_get_api_version() - Get Data Path MAC version
+ * @mc_io:     Pointer to MC portal's I/O object
+ * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
+ * @major_ver: Major version of data path mac API
+ * @minor_ver: Minor version of data path mac API
+ *
+ * Return:  '0' on Success; Error code otherwise.
+ */
+int dpmac_get_api_version(struct fsl_mc_io *mc_io, u32 cmd_flags,
+                         u16 *major_ver, u16 *minor_ver)
 {
        struct mc_command cmd = { 0 };
        int err;
 
-       /* prepare command */
        cmd.header = mc_encode_cmd_header(DPMAC_CMDID_GET_API_VERSION,
-                                         cmd_flags, 0);
+                                       cmd_flags,
+                                       0);
 
-       /* send command to mc */
        err = mc_send_command(mc_io, &cmd);
        if (err)
                return err;
 
-       /* retrieve response parameters */
        mc_cmd_read_api_version(&cmd, major_ver, minor_ver);
 
        return 0;
index eebfe548cc6e419da7ce10d860df887633261f36..a8e9e4684a51dfb131df5fea08fa67d10b93af04 100644 (file)
 #define DPMAC_CMDID_SET_LINK_STATE             0x0c31
 #define DPMAC_CMDID_GET_COUNTER                        0x0c41
 
-/*                cmd, param, offset, width, type, arg_name */
-#define DPMAC_CMD_CREATE(cmd, cfg) \
-       MC_CMD_OP(cmd, 0, 0,  16, uint16_t,      cfg->mac_id)
-
-/*                cmd, param, offset, width, type, arg_name */
-#define DPMAC_CMD_OPEN(cmd, dpmac_id) \
-       MC_CMD_OP(cmd, 0, 0,  32, int,      dpmac_id)
-
-/*                cmd, param, offset, width, type, arg_name */
-#define DPMAC_CMD_SET_LINK_STATE(cmd, cfg) \
-do { \
-       MC_CMD_OP(cmd, 0, 0,  64, uint64_t, cfg->options); \
-       MC_CMD_OP(cmd, 1, 0,  32, uint32_t, cfg->rate); \
-       MC_CMD_OP(cmd, 2, 0,  1,  int,      cfg->up); \
-} while (0)
-
-/*                cmd, param, offset, width, type, arg_name */
-#define DPMAC_CMD_GET_COUNTER(cmd, type) \
-       MC_CMD_OP(cmd, 0, 0,  8, enum dpmac_counter, type)
-
-/*                cmd, param, offset, width, type, arg_name */
-#define DPMAC_RSP_GET_COUNTER(cmd, counter) \
-       MC_RSP_OP(cmd, 1, 0, 64, uint64_t, counter)
+/* Macros for accessing command fields smaller than 1byte */
+#define DPMAC_MASK(field)        \
+       GENMASK(DPMAC_##field##_SHIFT + DPMAC_##field##_SIZE - 1, \
+               DPMAC_##field##_SHIFT)
+#define dpmac_set_field(var, field, val) \
+       ((var) |= (((val) << DPMAC_##field##_SHIFT) & DPMAC_MASK(field)))
+#define dpmac_get_field(var, field)      \
+       (((var) & DPMAC_MASK(field)) >> DPMAC_##field##_SHIFT)
+
+#pragma pack(push, 1)
+struct dpmac_cmd_open {
+       __le32 dpmac_id;
+};
+
+struct dpmac_cmd_create {
+       __le32 mac_id;
+};
+
+struct dpmac_cmd_destroy {
+       __le32 dpmac_id;
+};
+
+#define DPMAC_STATE_SIZE               1
+#define DPMAC_STATE_SHIFT              0
+#define DPMAC_STATE_VALID_SIZE         1
+#define DPMAC_STATE_VALID_SHIFT                1
+
+struct dpmac_cmd_set_link_state {
+       __le64 options;
+       __le32 rate;
+       __le32 pad;
+       /* only least significant bit is valid */
+       u8 up;
+       u8 pad0[7];
+       __le64 supported;
+       __le64 advertising;
+};
+
+struct dpmac_cmd_get_counter {
+       u8 type;
+};
+
+struct dpmac_rsp_get_counter {
+       __le64 pad;
+       __le64 counter;
+};
+
+#pragma pack(pop)
 
 /* Data Path MAC API
  * Contains initialization APIs and runtime control APIs for DPMAC
@@ -56,42 +81,27 @@ do { \
 
 struct fsl_mc_io;
 
-/**
- * dpmac_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_'
- * @dpmac_id:  DPMAC 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 dpmac_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 dpmac_open(struct fsl_mc_io        *mc_io,
-              uint32_t         cmd_flags,
-              int                      dpmac_id,
-              uint16_t         *token);
+int dpmac_open(struct fsl_mc_io *mc_io, u32 cmd_flags, int dpmac_id, u16 *token);
+
+int dpmac_close(struct fsl_mc_io *mc_io, u32 cmd_flags, u16 token);
 
 /**
- * dpmac_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 DPMAC 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.
+ * struct dpmac_cfg - Structure representing DPMAC configuration
+ * @mac_id:    Represents the Hardware MAC ID; in case of multiple WRIOP,
+ *             the MAC IDs are continuous.
+ *             For example:  2 WRIOPs, 16 MACs in each:
+ *                             MAC IDs for the 1st WRIOP: 1-16,
+ *                             MAC IDs for the 2nd WRIOP: 17-32.
  */
-int dpmac_close(struct fsl_mc_io       *mc_io,
-               uint32_t                cmd_flags,
-               uint16_t                token);
+struct dpmac_cfg {
+       int mac_id;
+};
+
+int dpmac_create(struct fsl_mc_io *mc_io, u16 dprc_token, u32 cmd_flags,
+                const struct dpmac_cfg *cfg, u32 *obj_id);
+
+int dpmac_destroy(struct fsl_mc_io *mc_io, u16 dprc_token, u32 cmd_flags,
+                 u32 object_id);
 
 /**
  * enum dpmac_link_type -  DPMAC link type
@@ -131,60 +141,6 @@ enum dpmac_eth_if {
        DPMAC_ETH_IF_XFI
 };
 
-/**
- * struct dpmac_cfg - Structure representing DPMAC configuration
- * @mac_id:    Represents the Hardware MAC ID; in case of multiple WRIOP,
- *             the MAC IDs are continuous.
- *             For example:  2 WRIOPs, 16 MACs in each:
- *                             MAC IDs for the 1st WRIOP: 1-16,
- *                             MAC IDs for the 2nd WRIOP: 17-32.
- */
-struct dpmac_cfg {
-       int mac_id;
-};
-
-/**
- * dpmac_create() - Create the DPMAC object.
- * @mc_io:     Pointer to MC portal's I/O object
- * @token:     Authentication token.
- * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
- * @cfg:       Configuration structure
- * @obj_id:    Returned obj_id; use in subsequent API calls
- *
- * Create the DPMAC 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 dpmac_open function to get an authentication
- * token first.
- *
- * Return:     '0' on Success; Error code otherwise.
- */
-int dpmac_create(struct fsl_mc_io      *mc_io,
-                uint16_t               token,
-                uint32_t               cmd_flags,
-                const struct dpmac_cfg *cfg,
-                uint32_t               *obj_id);
-
-/**
- * dpmac_destroy() - Destroy the DPMAC object and release all its resources.
- * @mc_io:     Pointer to MC portal's I/O object
- * @token:     Authentication token.
- * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
- * @obj_id:    DPMAC object id
- *
- * Return:     '0' on Success; error code otherwise.
- */
-int dpmac_destroy(struct fsl_mc_io     *mc_io,
-                 uint16_t              token,
-                 uint32_t              cmd_flags,
-                 uint32_t              obj_id);
-
 /* DPMAC IRQ Index and Events */
 
 /* IRQ index */
@@ -208,7 +164,7 @@ struct dpmac_attr {
        int                     phy_id;
        enum dpmac_link_type    link_type;
        enum dpmac_eth_if       eth_if;
-       uint32_t                max_rate;
+       u32             max_rate;
 };
 
 /* DPMAC link configuration/state options */
@@ -227,27 +183,21 @@ struct dpmac_attr {
  * @rate: Rate in Mbps
  * @options: Enable/Disable DPMAC link cfg features (bitmap)
  * @up: Link state
+ * @state_valid: Ignore/Update the state of the link
+ * @supported: Speeds capability of the phy (bitmap)
+ * @advertising: Speeds that are advertised for autoneg (bitmap)
  */
 struct dpmac_link_state {
-       uint32_t        rate;
-       uint64_t        options;
-       int             up;
+       u32 rate;
+       u64 options;
+       int up;
+       int state_valid;
+       u64 supported;
+       u64 advertising;
 };
 
-/**
- * dpmac_set_link_state() - Set the Ethernet link status
- * @mc_io:     Pointer to opaque I/O object
- * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
- * @token:     Token of DPMAC object
- * @link_state:        Link state configuration
- *
- * Return:     '0' on Success; Error code otherwise.
- */
-int dpmac_set_link_state(struct fsl_mc_io              *mc_io,
-                        uint32_t                       cmd_flags,
-                        uint16_t                       token,
-                        struct dpmac_link_state        *link_state);
-
+int dpmac_set_link_state(struct fsl_mc_io *mc_io, u32 cmd_flags, u16 token,
+                        struct dpmac_link_state *link_state);
 /**
  * enum dpni_counter - DPNI counter types
  * @DPMAC_CNT_ING_FRAME_64: counts 64-octet frame, good or bad.
@@ -326,34 +276,10 @@ enum dpmac_counter {
        DPMAC_CNT_EGR_GOOD_FRAME,
 };
 
-/**
- * dpmac_get_counter() - Read a specific DPMAC counter
- * @mc_io:     Pointer to opaque I/O object
- * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
- * @token:     Token of DPMAC object
- * @type:      The requested counter
- * @counter:   Returned counter value
- *
- * Return:     The requested counter; '0' otherwise.
- */
-int dpmac_get_counter(struct fsl_mc_io         *mc_io,
-                     uint32_t                  cmd_flags,
-                     uint16_t                  token,
-                     enum dpmac_counter         type,
-                     uint64_t                  *counter);
-/**
- * dpmac_get_api_version - Retrieve DPMAC 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: DPMAC major version
- * @minor_ver: DPMAC minor version
- *
- * Return:     '0' on Success; Error code otherwise.
- */
-int dpmac_get_api_version(struct fsl_mc_io *mc_io,
-                         uint32_t cmd_flags,
-                         uint16_t *major_ver,
-                         uint16_t *minor_ver);
+int dpmac_get_counter(struct fsl_mc_io *mc_io, u32 cmd_flags, u16 token,
+                     enum dpmac_counter type, u64 *counter);
+
+int dpmac_get_api_version(struct fsl_mc_io *mc_io, u32 cmd_flags,
+                         u16 *major_ver, u16 *minor_ver);
 
 #endif /* __FSL_DPMAC_H */