ethdev: promote sibling iterators to stable
[dpdk.git] / drivers / net / dpaa2 / mc / dpni.c
index 362cd47..b254931 100644 (file)
@@ -1,7 +1,7 @@
 /* SPDX-License-Identifier: (BSD-3-Clause OR GPL-2.0)
  *
  * Copyright 2013-2016 Freescale Semiconductor Inc.
- * Copyright 2016 NXP
+ * Copyright 2016-2020 NXP
  *
  */
 #include <fsl_mc_sys.h>
@@ -200,6 +200,7 @@ int dpni_set_pools(struct fsl_mc_io *mc_io,
                                          token);
        cmd_params = (struct dpni_cmd_set_pools *)cmd.params;
        cmd_params->num_dpbp = cfg->num_dpbp;
+       cmd_params->pool_options = cfg->pool_options;
        for (i = 0; i < cmd_params->num_dpbp; i++) {
                cmd_params->pool[i].dpbp_id =
                        cpu_to_le16(cfg->pools[i].dpbp_id);
@@ -948,6 +949,46 @@ int dpni_get_link_state(struct fsl_mc_io *mc_io,
        return 0;
 }
 
+/**
+ * dpni_set_tx_shaping() - Set the transmit shaping
+ * @mc_io:             Pointer to MC portal's I/O object
+ * @cmd_flags:         Command flags; one or more of 'MC_CMD_FLAG_'
+ * @token:             Token of DPNI object
+ * @tx_cr_shaper:      TX committed rate shaping configuration
+ * @tx_er_shaper:      TX excess rate shaping configuration
+ * @coupled:           Committed and excess rate shapers are coupled
+ *
+ * Return:     '0' on Success; Error code otherwise.
+ */
+int dpni_set_tx_shaping(struct fsl_mc_io *mc_io,
+                       uint32_t cmd_flags,
+                       uint16_t token,
+                       const struct dpni_tx_shaping_cfg *tx_cr_shaper,
+                       const struct dpni_tx_shaping_cfg *tx_er_shaper,
+                       int coupled)
+{
+       struct dpni_cmd_set_tx_shaping *cmd_params;
+       struct mc_command cmd = { 0 };
+
+       /* prepare command */
+       cmd.header = mc_encode_cmd_header(DPNI_CMDID_SET_TX_SHAPING,
+                                         cmd_flags,
+                                         token);
+       cmd_params = (struct dpni_cmd_set_tx_shaping *)cmd.params;
+       cmd_params->tx_cr_max_burst_size =
+               cpu_to_le16(tx_cr_shaper->max_burst_size);
+       cmd_params->tx_er_max_burst_size =
+               cpu_to_le16(tx_er_shaper->max_burst_size);
+       cmd_params->tx_cr_rate_limit =
+               cpu_to_le32(tx_cr_shaper->rate_limit);
+       cmd_params->tx_er_rate_limit =
+               cpu_to_le32(tx_er_shaper->rate_limit);
+       dpni_set_field(cmd_params->coupled, COUPLED, coupled);
+
+       /* send command to mc*/
+       return mc_send_command(mc_io, &cmd);
+}
+
 /**
  * dpni_set_max_frame_length() - Set the maximum received frame length.
  * @mc_io:             Pointer to MC portal's I/O object
@@ -1211,13 +1252,24 @@ int dpni_get_primary_mac_addr(struct fsl_mc_io *mc_io,
  * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
  * @token:     Token of DPNI object
  * @mac_addr:  MAC address to add
- *
+ * @flags :    0 - tc_id and flow_id will be ignored.
+ *               Pkt with this mac_id will be passed to the next
+ *               classification stages
+ *             DPNI_MAC_SET_QUEUE_ACTION
+ *               Pkt with this mac will be forward directly to
+ *               queue defined by the tc_id and flow_id
+ * @tc_id : Traffic class selection (0-7)
+ * @flow_id : Selects the specific queue out of the set allocated for the
+ *            same as tc_id. Value must be in range 0 to NUM_QUEUES - 1
  * Return:     '0' on Success; Error code otherwise.
  */
 int dpni_add_mac_addr(struct fsl_mc_io *mc_io,
                      uint32_t cmd_flags,
                      uint16_t token,
-                     const uint8_t mac_addr[6])
+                     const uint8_t mac_addr[6],
+                         uint8_t flags,
+                         uint8_t tc_id,
+                         uint8_t flow_id)
 {
        struct mc_command cmd = { 0 };
        struct dpni_cmd_add_mac_addr *cmd_params;
@@ -1228,6 +1280,10 @@ int dpni_add_mac_addr(struct fsl_mc_io *mc_io,
                                          cmd_flags,
                                          token);
        cmd_params = (struct dpni_cmd_add_mac_addr *)cmd.params;
+       cmd_params->flags = flags;
+       cmd_params->tc_id = tc_id;
+       cmd_params->fq_id = flow_id;
+
        for (i = 0; i < 6; i++)
                cmd_params->mac_addr[i] = mac_addr[5 - i];
 
@@ -1371,13 +1427,26 @@ int dpni_enable_vlan_filter(struct fsl_mc_io *mc_io,
  * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
  * @token:     Token of DPNI object
  * @vlan_id:   VLAN ID to add
+ * @flags:     0 - tc_id and flow_id will be ignored.
+ *               Pkt with this vlan_id will be passed to the next
+ *               classification stages
+ *             DPNI_VLAN_SET_QUEUE_ACTION
+ *               Pkt with this vlan_id will be forward directly to
+ *               queue defined by the tc_id and flow_id
+ *
+ * @tc_id: Traffic class selection (0-7)
+ * @flow_id: Selects the specific queue out of the set allocated for the
+ *           same as tc_id. Value must be in range 0 to NUM_QUEUES - 1
  *
  * Return:     '0' on Success; Error code otherwise.
  */
 int dpni_add_vlan_id(struct fsl_mc_io *mc_io,
                     uint32_t cmd_flags,
                     uint16_t token,
-                    uint16_t vlan_id)
+                    uint16_t vlan_id,
+                        uint8_t flags,
+                        uint8_t tc_id,
+                        uint8_t flow_id)
 {
        struct dpni_cmd_vlan_id *cmd_params;
        struct mc_command cmd = { 0 };
@@ -1387,6 +1456,9 @@ int dpni_add_vlan_id(struct fsl_mc_io *mc_io,
                                          cmd_flags,
                                          token);
        cmd_params = (struct dpni_cmd_vlan_id *)cmd.params;
+       cmd_params->flags = flags;
+       cmd_params->tc_id = tc_id;
+       cmd_params->flow_id =  flow_id;
        cmd_params->vlan_id = cpu_to_le16(vlan_id);
 
        /* send command to mc*/
@@ -1444,6 +1516,55 @@ int dpni_clear_vlan_filters(struct fsl_mc_io *mc_io,
        return mc_send_command(mc_io, &cmd);
 }
 
+/**
+ * dpni_set_tx_priorities() - Set transmission TC priority 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 DPNI object
+ * @cfg:       Transmission selection configuration
+ *
+ * warning:    Allowed only when DPNI is disabled
+ *
+ * Return:     '0' on Success; Error code otherwise.
+ */
+int dpni_set_tx_priorities(struct fsl_mc_io *mc_io,
+                          uint32_t cmd_flags,
+                          uint16_t token,
+                          const struct dpni_tx_priorities_cfg *cfg)
+{
+       struct dpni_cmd_set_tx_priorities *cmd_params;
+       struct mc_command cmd = { 0 };
+       int i;
+
+       /* prepare command */
+       cmd.header = mc_encode_cmd_header(DPNI_CMDID_SET_TX_PRIORITIES,
+                                         cmd_flags,
+                                         token);
+       cmd_params = (struct dpni_cmd_set_tx_priorities *)cmd.params;
+       dpni_set_field(cmd_params->flags,
+                               SEPARATE_GRP,
+                               cfg->separate_groups);
+       cmd_params->prio_group_A = cfg->prio_group_A;
+       cmd_params->prio_group_B = cfg->prio_group_B;
+
+       for (i = 0; i + 1 < DPNI_MAX_TC; i = i + 2) {
+               dpni_set_field(cmd_params->modes[i / 2],
+                              MODE_1,
+                              cfg->tc_sched[i].mode);
+               dpni_set_field(cmd_params->modes[i / 2],
+                                  MODE_2,
+                                  cfg->tc_sched[i + 1].mode);
+       }
+
+       for (i = 0; i < DPNI_MAX_TC; i++) {
+               cmd_params->delta_bandwidth[i] =
+                               cpu_to_le16(cfg->tc_sched[i].delta_bandwidth);
+       }
+
+       /* send command to mc*/
+       return mc_send_command(mc_io, &cmd);
+}
+
 /**
  * dpni_set_rx_tc_dist() - Set Rx traffic class distribution configuration
  * @mc_io:     Pointer to MC portal's I/O object
@@ -1589,7 +1710,9 @@ int dpni_add_qos_entry(struct fsl_mc_io *mc_io,
                       uint16_t token,
                       const struct dpni_rule_cfg *cfg,
                       uint8_t tc_id,
-                      uint16_t index)
+                      uint16_t index,
+                          uint8_t flags,
+                          uint8_t flow_id)
 {
        struct dpni_cmd_add_qos_entry *cmd_params;
        struct mc_command cmd = { 0 };
@@ -1599,6 +1722,8 @@ int dpni_add_qos_entry(struct fsl_mc_io *mc_io,
                                          cmd_flags,
                                          token);
        cmd_params = (struct dpni_cmd_add_qos_entry *)cmd.params;
+       cmd_params->flags = flags;
+       cmd_params->flow_id = flow_id;
        cmd_params->tc_id = tc_id;
        cmd_params->key_size = cfg->key_size;
        cmd_params->index = cpu_to_le16(index);
@@ -1772,6 +1897,228 @@ int dpni_clear_fs_entries(struct fsl_mc_io *mc_io,
        return mc_send_command(mc_io, &cmd);
 }
 
+/**
+ * dpni_set_rx_tc_policing() - Set Rx traffic class policing 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 DPNI object
+ * @tc_id:     Traffic class selection (0-7)
+ * @cfg:       Traffic class policing configuration
+ *
+ * Return:     '0' on Success; error code otherwise.
+ */
+int dpni_set_rx_tc_policing(struct fsl_mc_io *mc_io,
+                           uint32_t cmd_flags,
+                           uint16_t token,
+                           uint8_t tc_id,
+                           const struct dpni_rx_tc_policing_cfg *cfg)
+{
+       struct dpni_cmd_set_rx_tc_policing *cmd_params;
+       struct mc_command cmd = { 0 };
+
+       /* prepare command */
+       cmd.header = mc_encode_cmd_header(DPNI_CMDID_SET_RX_TC_POLICING,
+                                         cmd_flags,
+                                         token);
+       cmd_params = (struct dpni_cmd_set_rx_tc_policing *)cmd.params;
+       dpni_set_field(cmd_params->mode_color, COLOR, cfg->default_color);
+       dpni_set_field(cmd_params->mode_color, MODE, cfg->mode);
+       dpni_set_field(cmd_params->units, UNITS, cfg->units);
+       cmd_params->options = cpu_to_le32(cfg->options);
+       cmd_params->cir = cpu_to_le32(cfg->cir);
+       cmd_params->cbs = cpu_to_le32(cfg->cbs);
+       cmd_params->eir = cpu_to_le32(cfg->eir);
+       cmd_params->ebs = cpu_to_le32(cfg->ebs);
+       cmd_params->tc_id = tc_id;
+
+       /* send command to mc*/
+       return mc_send_command(mc_io, &cmd);
+}
+
+/**
+ * dpni_get_rx_tc_policing() - Get Rx traffic class policing 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 DPNI object
+ * @tc_id:     Traffic class selection (0-7)
+ * @cfg:       Traffic class policing configuration
+ *
+ * Return:     '0' on Success; error code otherwise.
+ */
+int dpni_get_rx_tc_policing(struct fsl_mc_io *mc_io,
+                           uint32_t cmd_flags,
+                           uint16_t token,
+                           uint8_t tc_id,
+                           struct dpni_rx_tc_policing_cfg *cfg)
+{
+       struct dpni_rsp_get_rx_tc_policing *rsp_params;
+       struct dpni_cmd_get_rx_tc_policing *cmd_params;
+       struct mc_command cmd = { 0 };
+       int err;
+
+       /* prepare command */
+       cmd.header = mc_encode_cmd_header(DPNI_CMDID_GET_RX_TC_POLICING,
+                                         cmd_flags,
+                                         token);
+       cmd_params = (struct dpni_cmd_get_rx_tc_policing *)cmd.params;
+       cmd_params->tc_id = tc_id;
+
+
+       /* send command to mc*/
+       err =  mc_send_command(mc_io, &cmd);
+       if (err)
+               return err;
+
+       rsp_params =  (struct dpni_rsp_get_rx_tc_policing *)cmd.params;
+       cfg->options = le32_to_cpu(rsp_params->options);
+       cfg->cir = le32_to_cpu(rsp_params->cir);
+       cfg->cbs = le32_to_cpu(rsp_params->cbs);
+       cfg->eir = le32_to_cpu(rsp_params->eir);
+       cfg->ebs = le32_to_cpu(rsp_params->ebs);
+       cfg->units = dpni_get_field(rsp_params->units, UNITS);
+       cfg->mode = dpni_get_field(rsp_params->mode_color, MODE);
+       cfg->default_color = dpni_get_field(rsp_params->mode_color, COLOR);
+
+       return 0;
+}
+
+/**
+ * dpni_prepare_early_drop() - prepare an early drop.
+ * @cfg:               Early-drop configuration
+ * @early_drop_buf:    Zeroed 256 bytes of memory before mapping it to DMA
+ *
+ * This function has to be called before dpni_set_rx_tc_early_drop or
+ * dpni_set_tx_tc_early_drop
+ *
+ */
+void dpni_prepare_early_drop(const struct dpni_early_drop_cfg *cfg,
+                            uint8_t *early_drop_buf)
+{
+       struct dpni_early_drop *ext_params;
+
+       ext_params = (struct dpni_early_drop *)early_drop_buf;
+
+       dpni_set_field(ext_params->flags, DROP_ENABLE, cfg->enable);
+       dpni_set_field(ext_params->flags, DROP_UNITS, cfg->units);
+       ext_params->green_drop_probability = cfg->green.drop_probability;
+       ext_params->green_max_threshold = cpu_to_le64(cfg->green.max_threshold);
+       ext_params->green_min_threshold = cpu_to_le64(cfg->green.min_threshold);
+       ext_params->yellow_drop_probability = cfg->yellow.drop_probability;
+       ext_params->yellow_max_threshold =
+               cpu_to_le64(cfg->yellow.max_threshold);
+       ext_params->yellow_min_threshold =
+               cpu_to_le64(cfg->yellow.min_threshold);
+       ext_params->red_drop_probability = cfg->red.drop_probability;
+       ext_params->red_max_threshold = cpu_to_le64(cfg->red.max_threshold);
+       ext_params->red_min_threshold = cpu_to_le64(cfg->red.min_threshold);
+}
+
+/**
+ * dpni_extract_early_drop() - extract the early drop configuration.
+ * @cfg:               Early-drop configuration
+ * @early_drop_buf:    Zeroed 256 bytes of memory before mapping it to DMA
+ *
+ * This function has to be called after dpni_get_rx_tc_early_drop or
+ * dpni_get_tx_tc_early_drop
+ *
+ */
+void dpni_extract_early_drop(struct dpni_early_drop_cfg *cfg,
+                            const uint8_t *early_drop_buf)
+{
+       const struct dpni_early_drop *ext_params;
+
+       ext_params = (const struct dpni_early_drop *)early_drop_buf;
+
+       cfg->enable = dpni_get_field(ext_params->flags, DROP_ENABLE);
+       cfg->units = dpni_get_field(ext_params->flags, DROP_UNITS);
+       cfg->green.drop_probability = ext_params->green_drop_probability;
+       cfg->green.max_threshold = le64_to_cpu(ext_params->green_max_threshold);
+       cfg->green.min_threshold = le64_to_cpu(ext_params->green_min_threshold);
+       cfg->yellow.drop_probability = ext_params->yellow_drop_probability;
+       cfg->yellow.max_threshold =
+               le64_to_cpu(ext_params->yellow_max_threshold);
+       cfg->yellow.min_threshold =
+               le64_to_cpu(ext_params->yellow_min_threshold);
+       cfg->red.drop_probability = ext_params->red_drop_probability;
+       cfg->red.max_threshold = le64_to_cpu(ext_params->red_max_threshold);
+       cfg->red.min_threshold = le64_to_cpu(ext_params->red_min_threshold);
+}
+
+/**
+ * dpni_set_early_drop() - Set traffic class early-drop 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 DPNI object
+ * @qtype:     Type of queue - only Rx and Tx types are supported
+ * @tc_id:     Traffic class selection (0-7)
+ * @early_drop_iova:  I/O virtual address of 256 bytes DMA-able memory filled
+ *     with the early-drop configuration by calling dpni_prepare_early_drop()
+ *
+ * warning: Before calling this function, call dpni_prepare_early_drop() to
+ *                     prepare the early_drop_iova parameter
+ *
+ * Return:     '0' on Success; error code otherwise.
+ */
+int dpni_set_early_drop(struct fsl_mc_io *mc_io,
+                       uint32_t cmd_flags,
+                       uint16_t token,
+                       enum dpni_queue_type qtype,
+                       uint8_t tc_id,
+                       uint64_t early_drop_iova)
+{
+       struct dpni_cmd_early_drop *cmd_params;
+       struct mc_command cmd = { 0 };
+
+       /* prepare command */
+       cmd.header = mc_encode_cmd_header(DPNI_CMDID_SET_EARLY_DROP,
+                                         cmd_flags,
+                                         token);
+       cmd_params = (struct dpni_cmd_early_drop *)cmd.params;
+       cmd_params->qtype = qtype;
+       cmd_params->tc = tc_id;
+       cmd_params->early_drop_iova = cpu_to_le64(early_drop_iova);
+
+       /* send command to mc*/
+       return mc_send_command(mc_io, &cmd);
+}
+
+/**
+ * dpni_get_early_drop() - Get Rx traffic class early-drop 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 DPNI object
+ * @qtype:     Type of queue - only Rx and Tx types are supported
+ * @tc_id:     Traffic class selection (0-7)
+ * @early_drop_iova:  I/O virtual address of 256 bytes DMA-able memory
+ *
+ * warning: After calling this function, call dpni_extract_early_drop() to
+ *     get the early drop configuration
+ *
+ * Return:     '0' on Success; error code otherwise.
+ */
+int dpni_get_early_drop(struct fsl_mc_io *mc_io,
+                       uint32_t cmd_flags,
+                       uint16_t token,
+                       enum dpni_queue_type qtype,
+                       uint8_t tc_id,
+                       uint64_t early_drop_iova)
+{
+       struct dpni_cmd_early_drop *cmd_params;
+       struct mc_command cmd = { 0 };
+
+       /* prepare command */
+       cmd.header = mc_encode_cmd_header(DPNI_CMDID_GET_EARLY_DROP,
+                                         cmd_flags,
+                                         token);
+       cmd_params = (struct dpni_cmd_early_drop *)cmd.params;
+       cmd_params->qtype = qtype;
+       cmd_params->tc = tc_id;
+       cmd_params->early_drop_iova = cpu_to_le64(early_drop_iova);
+
+       /* send command to mc*/
+       return mc_send_command(mc_io, &cmd);
+}
+
 /**
  * dpni_set_congestion_notification() - Set traffic class congestion
  *     notification configuration
@@ -2031,7 +2378,7 @@ int dpni_get_queue(struct fsl_mc_io *mc_io,
  * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
  * @token:     Token of DPNI object
  * @page:      Selects the statistics page to retrieve, see
- *             DPNI_GET_STATISTICS output. Pages are numbered 0 to 3.
+ *             DPNI_GET_STATISTICS output. Pages are numbered 0 to 6.
  * @param:     Custom parameter for some pages used to select
  *             a certain statistic source, for example the TC.
  * @stat:      Structure containing the statistics
@@ -2484,3 +2831,120 @@ int dpni_get_custom_tpid(struct fsl_mc_io *mc_io, uint32_t cmd_flags,
 
        return err;
 }
+
+int dpni_load_sw_sequence(struct fsl_mc_io *mc_io,
+             uint32_t cmd_flags,
+             uint16_t token,
+                 struct dpni_load_ss_cfg *cfg)
+{
+       struct dpni_load_sw_sequence *cmd_params;
+       struct mc_command cmd = { 0 };
+
+       /* prepare command */
+       cmd.header = mc_encode_cmd_header(DPNI_CMDID_LOAD_SW_SEQUENCE,
+                                         cmd_flags,
+                                         token);
+       cmd_params = (struct dpni_load_sw_sequence *)cmd.params;
+       cmd_params->dest = cfg->dest;
+       cmd_params->ss_offset = cpu_to_le16(cfg->ss_offset);
+       cmd_params->ss_size = cpu_to_le16(cfg->ss_size);
+       cmd_params->ss_iova = cpu_to_le64(cfg->ss_iova);
+
+       /* send command to mc*/
+       return mc_send_command(mc_io, &cmd);
+}
+
+int dpni_enable_sw_sequence(struct fsl_mc_io *mc_io,
+             uint32_t cmd_flags,
+             uint16_t token,
+                 struct dpni_enable_ss_cfg *cfg)
+{
+       struct dpni_enable_sw_sequence *cmd_params;
+       struct mc_command cmd = { 0 };
+
+       /* prepare command */
+       cmd.header = mc_encode_cmd_header(DPNI_CMDID_ENABLE_SW_SEQUENCE,
+                                         cmd_flags,
+                                         token);
+       cmd_params = (struct dpni_enable_sw_sequence *)cmd.params;
+       cmd_params->dest = cfg->dest;
+       cmd_params->set_start = cfg->set_start;
+       cmd_params->hxs = cpu_to_le16(cfg->hxs);
+       cmd_params->ss_offset = cpu_to_le16(cfg->ss_offset);
+       cmd_params->param_offset = cfg->param_offset;
+       cmd_params->param_size = cfg->param_size;
+       cmd_params->param_iova = cpu_to_le64(cfg->param_iova);
+
+       /* send command to mc*/
+       return mc_send_command(mc_io, &cmd);
+}
+
+/**
+ * dpni_get_sw_sequence_layout() - Get the soft sequence layout
+ * @mc_io:     Pointer to MC portal's I/O object
+ * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
+ * @token:     Token of DPNI object
+ * @src:       Source of the layout (WRIOP Rx or Tx)
+ * @ss_layout_iova:  I/O virtual address of 264 bytes DMA-able memory
+ *
+ * warning: After calling this function, call dpni_extract_sw_sequence_layout()
+ *             to get the layout.
+ *
+ * Return:     '0' on Success; error code otherwise.
+ */
+int dpni_get_sw_sequence_layout(struct fsl_mc_io *mc_io,
+             uint32_t cmd_flags,
+             uint16_t token,
+                 enum dpni_soft_sequence_dest src,
+                 uint64_t ss_layout_iova)
+{
+       struct dpni_get_sw_sequence_layout *cmd_params;
+       struct mc_command cmd = { 0 };
+
+       /* prepare command */
+       cmd.header = mc_encode_cmd_header(DPNI_CMDID_GET_SW_SEQUENCE_LAYOUT,
+                                         cmd_flags,
+                                         token);
+
+       cmd_params = (struct dpni_get_sw_sequence_layout *)cmd.params;
+       cmd_params->src = src;
+       cmd_params->layout_iova = cpu_to_le64(ss_layout_iova);
+
+       /* send command to mc*/
+       return mc_send_command(mc_io, &cmd);
+}
+
+/**
+ * dpni_extract_sw_sequence_layout() - extract the software sequence layout
+ * @layout:            software sequence layout
+ * @sw_sequence_layout_buf:    Zeroed 264 bytes of memory before mapping it
+ *                             to DMA
+ *
+ * This function has to be called after dpni_get_sw_sequence_layout
+ *
+ */
+void dpni_extract_sw_sequence_layout(struct dpni_sw_sequence_layout *layout,
+                            const uint8_t *sw_sequence_layout_buf)
+{
+       const struct dpni_sw_sequence_layout_entry *ext_params;
+       int i;
+       uint16_t ss_size, ss_offset;
+
+       ext_params = (const struct dpni_sw_sequence_layout_entry *)
+                                               sw_sequence_layout_buf;
+
+       for (i = 0; i < DPNI_SW_SEQUENCE_LAYOUT_SIZE; i++) {
+               ss_offset = le16_to_cpu(ext_params[i].ss_offset);
+               ss_size = le16_to_cpu(ext_params[i].ss_size);
+
+               if (ss_offset == 0 && ss_size == 0) {
+                       layout->num_ss = i;
+                       return;
+               }
+
+               layout->ss[i].ss_offset = ss_offset;
+               layout->ss[i].ss_size = ss_size;
+               layout->ss[i].param_offset = ext_params[i].param_offset;
+               layout->ss[i].param_size = ext_params[i].param_size;
+       }
+}