Quelle  dpni-cmd.h   Sprache: C

/* SPDX-License-Identifier: (GPL-2.0+ OR BSD-3-Clause) */
/* Copyright 2013-2016 Freescale Semiconductor Inc.
 * Copyright 2016 NXP
 * Copyright 2020 NXP
 */
#ifndef _FSL_DPNI_CMD_H
#define _FSL_DPNI_CMD_H

#include "dpni.h"

/* DPNI Version */
#define DPNI_VER_MAJOR    7
#define DPNI_VER_MINOR    0
#define DPNI_CMD_BASE_VERSION   1
#define DPNI_CMD_2ND_VERSION   2
#define DPNI_CMD_3RD_VERSION   3
#define DPNI_CMD_ID_OFFSET   4

#define DPNI_CMD(id) (((id) << DPNI_CMD_ID_OFFSET) | DPNI_CMD_BASE_VERSION)
#define DPNI_CMD_V2(id) (((id) << DPNI_CMD_ID_OFFSET) | DPNI_CMD_2ND_VERSION)
#define DPNI_CMD_V3(id) (((id) << DPNI_CMD_ID_OFFSET) | DPNI_CMD_3RD_VERSION)

#define DPNI_CMDID_OPEN     DPNI_CMD(0x801)
#define DPNI_CMDID_CLOSE    DPNI_CMD(0x800)
#define DPNI_CMDID_CREATE    DPNI_CMD(0x901)
#define DPNI_CMDID_DESTROY    DPNI_CMD(0x900)
#define DPNI_CMDID_GET_API_VERSION   DPNI_CMD(0xa01)

#define DPNI_CMDID_ENABLE    DPNI_CMD(0x002)
#define DPNI_CMDID_DISABLE    DPNI_CMD(0x003)
#define DPNI_CMDID_GET_ATTR    DPNI_CMD(0x004)
#define DPNI_CMDID_RESET    DPNI_CMD(0x005)
#define DPNI_CMDID_IS_ENABLED    DPNI_CMD(0x006)

#define DPNI_CMDID_SET_IRQ    DPNI_CMD(0x010)
#define DPNI_CMDID_GET_IRQ    DPNI_CMD(0x011)
#define DPNI_CMDID_SET_IRQ_ENABLE   DPNI_CMD(0x012)
#define DPNI_CMDID_GET_IRQ_ENABLE   DPNI_CMD(0x013)
#define DPNI_CMDID_SET_IRQ_MASK    DPNI_CMD(0x014)
#define DPNI_CMDID_GET_IRQ_MASK    DPNI_CMD(0x015)
#define DPNI_CMDID_GET_IRQ_STATUS   DPNI_CMD(0x016)
#define DPNI_CMDID_CLEAR_IRQ_STATUS   DPNI_CMD(0x017)

#define DPNI_CMDID_SET_POOLS    DPNI_CMD_V3(0x200)
#define DPNI_CMDID_SET_ERRORS_BEHAVIOR   DPNI_CMD(0x20B)

#define DPNI_CMDID_GET_QDID    DPNI_CMD(0x210)
#define DPNI_CMDID_GET_TX_DATA_OFFSET   DPNI_CMD(0x212)
#define DPNI_CMDID_GET_LINK_STATE   DPNI_CMD(0x215)
#define DPNI_CMDID_SET_MAX_FRAME_LENGTH   DPNI_CMD(0x216)
#define DPNI_CMDID_GET_MAX_FRAME_LENGTH   DPNI_CMD(0x217)
#define DPNI_CMDID_SET_LINK_CFG    DPNI_CMD(0x21A)
#define DPNI_CMDID_SET_TX_SHAPING   DPNI_CMD_V2(0x21B)

#define DPNI_CMDID_SET_MCAST_PROMISC   DPNI_CMD(0x220)
#define DPNI_CMDID_GET_MCAST_PROMISC   DPNI_CMD(0x221)
#define DPNI_CMDID_SET_UNICAST_PROMISC   DPNI_CMD(0x222)
#define DPNI_CMDID_GET_UNICAST_PROMISC   DPNI_CMD(0x223)
#define DPNI_CMDID_SET_PRIM_MAC    DPNI_CMD(0x224)
#define DPNI_CMDID_GET_PRIM_MAC    DPNI_CMD(0x225)
#define DPNI_CMDID_ADD_MAC_ADDR    DPNI_CMD(0x226)
#define DPNI_CMDID_REMOVE_MAC_ADDR   DPNI_CMD(0x227)
#define DPNI_CMDID_CLR_MAC_FILTERS   DPNI_CMD(0x228)

#define DPNI_CMDID_SET_RX_TC_DIST   DPNI_CMD(0x235)

#define DPNI_CMDID_ENABLE_VLAN_FILTER   DPNI_CMD(0x230)
#define DPNI_CMDID_ADD_VLAN_ID    DPNI_CMD_V2(0x231)
#define DPNI_CMDID_REMOVE_VLAN_ID   DPNI_CMD(0x232)

#define DPNI_CMDID_SET_QOS_TBL    DPNI_CMD(0x240)
#define DPNI_CMDID_ADD_QOS_ENT    DPNI_CMD(0x241)
#define DPNI_CMDID_REMOVE_QOS_ENT   DPNI_CMD(0x242)
#define DPNI_CMDID_CLR_QOS_TBL    DPNI_CMD(0x243)
#define DPNI_CMDID_ADD_FS_ENT    DPNI_CMD(0x244)
#define DPNI_CMDID_REMOVE_FS_ENT   DPNI_CMD(0x245)
#define DPNI_CMDID_CLR_FS_ENT    DPNI_CMD(0x246)

#define DPNI_CMDID_GET_STATISTICS   DPNI_CMD(0x25D)
#define DPNI_CMDID_GET_QUEUE    DPNI_CMD(0x25F)
#define DPNI_CMDID_SET_QUEUE    DPNI_CMD(0x260)
#define DPNI_CMDID_GET_TAILDROP    DPNI_CMD(0x261)
#define DPNI_CMDID_SET_TAILDROP    DPNI_CMD(0x262)

#define DPNI_CMDID_GET_PORT_MAC_ADDR   DPNI_CMD(0x263)

#define DPNI_CMDID_GET_BUFFER_LAYOUT   DPNI_CMD(0x264)
#define DPNI_CMDID_SET_BUFFER_LAYOUT   DPNI_CMD(0x265)

#define DPNI_CMDID_SET_TX_CONFIRMATION_MODE  DPNI_CMD(0x266)
#define DPNI_CMDID_SET_CONGESTION_NOTIFICATION  DPNI_CMD(0x267)
#define DPNI_CMDID_GET_CONGESTION_NOTIFICATION  DPNI_CMD(0x268)
#define DPNI_CMDID_SET_EARLY_DROP   DPNI_CMD(0x269)
#define DPNI_CMDID_GET_EARLY_DROP   DPNI_CMD(0x26A)
#define DPNI_CMDID_GET_OFFLOAD    DPNI_CMD(0x26B)
#define DPNI_CMDID_SET_OFFLOAD    DPNI_CMD(0x26C)

#define DPNI_CMDID_SET_RX_FS_DIST   DPNI_CMD(0x273)
#define DPNI_CMDID_SET_RX_HASH_DIST   DPNI_CMD(0x274)
#define DPNI_CMDID_GET_LINK_CFG    DPNI_CMD(0x278)

#define DPNI_CMDID_SET_SINGLE_STEP_CFG   DPNI_CMD(0x279)
#define DPNI_CMDID_GET_SINGLE_STEP_CFG   DPNI_CMD_V2(0x27a)

/* Macros for accessing command fields smaller than 1byte */
#define DPNI_MASK(field) \
 GENMASK(DPNI_##field##_SHIFT + DPNI_##field##_SIZE - 1, \
  DPNI_##field##_SHIFT)

#define dpni_set_field(var, field, val) \
 ((var) |= (((val) << DPNI_##field##_SHIFT) & DPNI_MASK(field)))
#define dpni_get_field(var, field) \
 (((var) & DPNI_MASK(field)) >> DPNI_##field##_SHIFT)

struct dpni_cmd_open {
 __le32 dpni_id;
};

#define DPNI_BACKUP_POOL(val, order) (((val) & 0x1) << (order))

struct dpni_cmd_pool {
 __le16 dpbp_id;
 u8 priority_mask;
 u8 pad;
};

struct dpni_cmd_set_pools {
 u8 num_dpbp;
 u8 backup_pool_mask;
 u8 pad;
 u8 pool_options;
 struct dpni_cmd_pool pool[DPNI_MAX_DPBP];
 __le16 buffer_size[DPNI_MAX_DPBP];
};

/* The enable indication is always the least significant bit */
#define DPNI_ENABLE_SHIFT  0
#define DPNI_ENABLE_SIZE  1

struct dpni_rsp_is_enabled {
 u8 enabled;
};

struct dpni_rsp_get_irq {
 /* response word 0 */
 __le32 irq_val;
 __le32 pad;
 /* response word 1 */
 __le64 irq_addr;
 /* response word 2 */
 __le32 irq_num;
 __le32 type;
};

struct dpni_cmd_set_irq_enable {
 u8 enable;
 u8 pad[3];
 u8 irq_index;
};

struct dpni_cmd_get_irq_enable {
 __le32 pad;
 u8 irq_index;
};

struct dpni_rsp_get_irq_enable {
 u8 enabled;
};

struct dpni_cmd_set_irq_mask {
 __le32 mask;
 u8 irq_index;
};

struct dpni_cmd_get_irq_mask {
 __le32 pad;
 u8 irq_index;
};

struct dpni_rsp_get_irq_mask {
 __le32 mask;
};

struct dpni_cmd_get_irq_status {
 __le32 status;
 u8 irq_index;
};

struct dpni_rsp_get_irq_status {
 __le32 status;
};

struct dpni_cmd_clear_irq_status {
 __le32 status;
 u8 irq_index;
};

struct dpni_rsp_get_attr {
 /* response word 0 */
 __le32 options;
 u8 num_queues;
 u8 num_tcs;
 u8 mac_filter_entries;
 u8 pad0;
 /* response word 1 */
 u8 vlan_filter_entries;
 u8 pad1;
 u8 qos_entries;
 u8 pad2;
 __le16 fs_entries;
 __le16 pad3;
 /* response word 2 */
 u8 qos_key_size;
 u8 fs_key_size;
 __le16 wriop_version;
};

#define DPNI_ERROR_ACTION_SHIFT  0
#define DPNI_ERROR_ACTION_SIZE  4
#define DPNI_FRAME_ANN_SHIFT  4
#define DPNI_FRAME_ANN_SIZE  1

struct dpni_cmd_set_errors_behavior {
 __le32 errors;
 /* from least significant bit: error_action:4, set_frame_annotation:1 */
 u8 flags;
};

/* There are 3 separate commands for configuring Rx, Tx and Tx confirmation
 * buffer layouts, but they all share the same parameters.
 * If one of the functions changes, below structure needs to be split.
 */

#define DPNI_PASS_TS_SHIFT  0
#define DPNI_PASS_TS_SIZE  1
#define DPNI_PASS_PR_SHIFT  1
#define DPNI_PASS_PR_SIZE  1
#define DPNI_PASS_FS_SHIFT  2
#define DPNI_PASS_FS_SIZE  1

struct dpni_cmd_get_buffer_layout {
 u8 qtype;
};

struct dpni_rsp_get_buffer_layout {
 /* response word 0 */
 u8 pad0[6];
 /* from LSB: pass_timestamp:1, parser_result:1, frame_status:1 */
 u8 flags;
 u8 pad1;
 /* response word 1 */
 __le16 private_data_size;
 __le16 data_align;
 __le16 head_room;
 __le16 tail_room;
};

struct dpni_cmd_set_buffer_layout {
 /* cmd word 0 */
 u8 qtype;
 u8 pad0[3];
 __le16 options;
 /* from LSB: pass_timestamp:1, parser_result:1, frame_status:1 */
 u8 flags;
 u8 pad1;
 /* cmd word 1 */
 __le16 private_data_size;
 __le16 data_align;
 __le16 head_room;
 __le16 tail_room;
};

struct dpni_cmd_set_offload {
 u8 pad[3];
 u8 dpni_offload;
 __le32 config;
};

struct dpni_cmd_get_offload {
 u8 pad[3];
 u8 dpni_offload;
};

struct dpni_rsp_get_offload {
 __le32 pad;
 __le32 config;
};

struct dpni_cmd_get_qdid {
 u8 qtype;
};

struct dpni_rsp_get_qdid {
 __le16 qdid;
};

struct dpni_rsp_get_tx_data_offset {
 __le16 data_offset;
};

struct dpni_cmd_get_statistics {
 u8 page_number;
};

struct dpni_rsp_get_statistics {
 __le64 counter[DPNI_STATISTICS_CNT];
};

struct dpni_cmd_link_cfg {
 /* cmd word 0 */
 __le64 pad0;
 /* cmd word 1 */
 __le32 rate;
 __le32 pad1;
 /* cmd word 2 */
 __le64 options;
};

#define DPNI_LINK_STATE_SHIFT  0
#define DPNI_LINK_STATE_SIZE  1

struct dpni_rsp_get_link_state {
 /* response word 0 */
 __le32 pad0;
 /* from LSB: up:1 */
 u8 flags;
 u8 pad1[3];
 /* response word 1 */
 __le32 rate;
 __le32 pad2;
 /* response word 2 */
 __le64 options;
};

struct dpni_cmd_set_max_frame_length {
 __le16 max_frame_length;
};

struct dpni_rsp_get_max_frame_length {
 __le16 max_frame_length;
};

struct dpni_cmd_set_multicast_promisc {
 u8 enable;
};

struct dpni_rsp_get_multicast_promisc {
 u8 enabled;
};

struct dpni_cmd_set_unicast_promisc {
 u8 enable;
};

struct dpni_rsp_get_unicast_promisc {
 u8 enabled;
};

struct dpni_cmd_set_primary_mac_addr {
 __le16 pad;
 u8 mac_addr[6];
};

struct dpni_rsp_get_primary_mac_addr {
 __le16 pad;
 u8 mac_addr[6];
};

struct dpni_rsp_get_port_mac_addr {
 __le16 pad;
 u8 mac_addr[6];
};

struct dpni_cmd_add_mac_addr {
 __le16 pad;
 u8 mac_addr[6];
};

struct dpni_cmd_remove_mac_addr {
 __le16 pad;
 u8 mac_addr[6];
};

#define DPNI_UNICAST_FILTERS_SHIFT 0
#define DPNI_UNICAST_FILTERS_SIZE 1
#define DPNI_MULTICAST_FILTERS_SHIFT 1
#define DPNI_MULTICAST_FILTERS_SIZE 1

struct dpni_cmd_clear_mac_filters {
 /* from LSB: unicast:1, multicast:1 */
 u8 flags;
};

#define DPNI_DIST_MODE_SHIFT  0
#define DPNI_DIST_MODE_SIZE  4
#define DPNI_MISS_ACTION_SHIFT  4
#define DPNI_MISS_ACTION_SIZE  4

struct dpni_cmd_set_rx_tc_dist {
 /* cmd word 0 */
 __le16 dist_size;
 u8 tc_id;
 /* from LSB: dist_mode:4, miss_action:4 */
 u8 flags;
 __le16 pad0;
 __le16 default_flow_id;
 /* cmd word 1..5 */
 __le64 pad1[5];
 /* cmd word 6 */
 __le64 key_cfg_iova;
};

/* dpni_set_rx_tc_dist extension (structure of the DMA-able memory at
 * key_cfg_iova)
 */
struct dpni_mask_cfg {
 u8 mask;
 u8 offset;
};

#define DPNI_EFH_TYPE_SHIFT  0
#define DPNI_EFH_TYPE_SIZE  4
#define DPNI_EXTRACT_TYPE_SHIFT  0
#define DPNI_EXTRACT_TYPE_SIZE  4

struct dpni_dist_extract {
 /* word 0 */
 u8 prot;
 /* EFH type stored in the 4 least significant bits */
 u8 efh_type;
 u8 size;
 u8 offset;
 __le32 field;
 /* word 1 */
 u8 hdr_index;
 u8 constant;
 u8 num_of_repeats;
 u8 num_of_byte_masks;
 /* Extraction type is stored in the 4 LSBs */
 u8 extract_type;
 u8 pad[3];
 /* word 2 */
 struct dpni_mask_cfg masks[4];
};

struct dpni_ext_set_rx_tc_dist {
 /* extension word 0 */
 u8 num_extracts;
 u8 pad[7];
 /* words 1..25 */
 struct dpni_dist_extract extracts[DPKG_MAX_NUM_OF_EXTRACTS];
};

struct dpni_cmd_get_queue {
 u8 qtype;
 u8 tc;
 u8 index;
};

#define DPNI_DEST_TYPE_SHIFT  0
#define DPNI_DEST_TYPE_SIZE  4
#define DPNI_STASH_CTRL_SHIFT  6
#define DPNI_STASH_CTRL_SIZE  1
#define DPNI_HOLD_ACTIVE_SHIFT  7
#define DPNI_HOLD_ACTIVE_SIZE  1

struct dpni_rsp_get_queue {
 /* response word 0 */
 __le64 pad0;
 /* response word 1 */
 __le32 dest_id;
 __le16 pad1;
 u8 dest_prio;
 /* From LSB: dest_type:4, pad:2, flc_stash_ctrl:1, hold_active:1 */
 u8 flags;
 /* response word 2 */
 __le64 flc;
 /* response word 3 */
 __le64 user_context;
 /* response word 4 */
 __le32 fqid;
 __le16 qdbin;
};

struct dpni_cmd_set_queue {
 /* cmd word 0 */
 u8 qtype;
 u8 tc;
 u8 index;
 u8 options;
 __le32 pad0;
 /* cmd word 1 */
 __le32 dest_id;
 __le16 pad1;
 u8 dest_prio;
 u8 flags;
 /* cmd word 2 */
 __le64 flc;
 /* cmd word 3 */
 __le64 user_context;
};

struct dpni_cmd_set_taildrop {
 /* cmd word 0 */
 u8 congestion_point;
 u8 qtype;
 u8 tc;
 u8 index;
 __le32 pad0;
 /* cmd word 1 */
 /* Only least significant bit is relevant */
 u8 enable;
 u8 pad1;
 u8 units;
 u8 pad2;
 __le32 threshold;
};

struct dpni_cmd_get_taildrop {
 u8 congestion_point;
 u8 qtype;
 u8 tc;
 u8 index;
};

struct dpni_rsp_get_taildrop {
 /* cmd word 0 */
 __le64 pad0;
 /* cmd word 1 */
 /* only least significant bit is relevant */
 u8 enable;
 u8 pad1;
 u8 units;
 u8 pad2;
 __le32 threshold;
};

struct dpni_rsp_get_api_version {
 __le16 major;
 __le16 minor;
};

#define DPNI_RX_FS_DIST_ENABLE_SHIFT 0
#define DPNI_RX_FS_DIST_ENABLE_SIZE 1
struct dpni_cmd_set_rx_fs_dist {
 __le16 dist_size;
 u8 enable;
 u8 tc;
 __le16 miss_flow_id;
 __le16 pad;
 __le64 key_cfg_iova;
};

#define DPNI_RX_HASH_DIST_ENABLE_SHIFT 0
#define DPNI_RX_HASH_DIST_ENABLE_SIZE 1
struct dpni_cmd_set_rx_hash_dist {
 __le16 dist_size;
 u8 enable;
 u8 tc;
 __le32 pad;
 __le64 key_cfg_iova;
};

struct dpni_cmd_add_fs_entry {
 /* cmd word 0 */
 __le16 options;
 u8 tc_id;
 u8 key_size;
 __le16 index;
 __le16 flow_id;
 /* cmd word 1 */
 __le64 key_iova;
 /* cmd word 2 */
 __le64 mask_iova;
 /* cmd word 3 */
 __le64 flc;
};

struct dpni_cmd_remove_fs_entry {
 /* cmd word 0 */
 __le16 pad0;
 u8 tc_id;
 u8 key_size;
 __le32 pad1;
 /* cmd word 1 */
 __le64 key_iova;
 /* cmd word 2 */
 __le64 mask_iova;
};

#define DPNI_DISCARD_ON_MISS_SHIFT 0
#define DPNI_DISCARD_ON_MISS_SIZE 1

struct dpni_cmd_set_qos_table {
 __le32 pad;
 u8 default_tc;
 /* only the LSB */
 u8 discard_on_miss;
 __le16 pad1[21];
 __le64 key_cfg_iova;
};

struct dpni_cmd_add_qos_entry {
 __le16 pad;
 u8 tc_id;
 u8 key_size;
 __le16 index;
 __le16 pad1;
 __le64 key_iova;
 __le64 mask_iova;
};

struct dpni_cmd_remove_qos_entry {
 u8 pad[3];
 u8 key_size;
 __le32 pad1;
 __le64 key_iova;
 __le64 mask_iova;
};

#define DPNI_DEST_TYPE_SHIFT  0
#define DPNI_DEST_TYPE_SIZE  4
#define DPNI_CONG_UNITS_SHIFT  4
#define DPNI_CONG_UNITS_SIZE  2

struct dpni_cmd_set_congestion_notification {
 /* cmd word 0 */
 u8 qtype;
 u8 tc;
 u8 pad[6];
 /* cmd word 1 */
 __le32 dest_id;
 __le16 notification_mode;
 u8 dest_priority;
 /* from LSB: dest_type: 4 units:2 */
 u8 type_units;
 /* cmd word 2 */
 __le64 message_iova;
 /* cmd word 3 */
 __le64 message_ctx;
 /* cmd word 4 */
 __le32 threshold_entry;
 __le32 threshold_exit;
};

#define DPNI_COUPLED_SHIFT 0
#define DPNI_COUPLED_SIZE 1

struct dpni_cmd_set_tx_shaping {
 __le16 tx_cr_max_burst_size;
 __le16 tx_er_max_burst_size;
 __le32 pad;
 __le32 tx_cr_rate_limit;
 __le32 tx_er_rate_limit;
 /* from LSB: coupled:1 */
 u8 coupled;
};

#define DPNI_PTP_ENABLE_SHIFT   0
#define DPNI_PTP_ENABLE_SIZE   1
#define DPNI_PTP_CH_UPDATE_SHIFT  1
#define DPNI_PTP_CH_UPDATE_SIZE   1

struct dpni_cmd_single_step_cfg {
 __le16 flags;
 __le16 offset;
 __le32 peer_delay;
 __le32 ptp_onestep_reg_base;
 __le32 pad0;
};

struct dpni_rsp_single_step_cfg {
 __le16 flags;
 __le16 offset;
 __le32 peer_delay;
 __le32 ptp_onestep_reg_base;
 __le32 pad0;
};

struct dpni_cmd_enable_vlan_filter {
 /* only the LSB */
 u8 en;
};

struct dpni_cmd_vlan_id {
 u8 flags;
 u8 tc_id;
 u8 flow_id;
 u8 pad;
 __le16 vlan_id;
};

#endif /* _FSL_DPNI_CMD_H */