nvethernetrm/include/ivc_core.h

/*
 * SPDX-FileCopyrightText: Copyright (c) 2020-2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
 * SPDX-License-Identifier: MIT
 *
 * Permission is hereby granted, free of charge, to any person obtaining a
 * copy of this software and associated documentation files (the "Software"),
 * to deal in the Software without restriction, including without limitation
 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
 * and/or sell copies of the Software, and to permit persons to whom the
 * Software is furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
 * DEALINGS IN THE SOFTWARE.
 */

#ifndef INCLUDED_IVC_CORE_H
#define INCLUDED_IVC_CORE_H

#include <osi_macsec.h>

/**
 * @brief Ethernet Maximum IVC BUF
 */
#define ETHER_MAX_IVC_BUF	2048U

/**
 * @brief IVC maximum arguments
 */
#define MAX_ARGS	10

/**
 * @brief IVC commands between OSD & OSI.
 */
typedef enum {
	core_init = 1,
	core_deinit,
	write_phy_reg,
	read_phy_reg,
	handle_ioctl,
	init_macsec,
	deinit_macsec,
	handle_irq_macsec,
	lut_config_macsec,
	kt_config_macsec,
	coe_lc_macsec,
	coe_config_macsec,
	cipher_config,
	loopback_config_macsec,
	config_macsec,
	read_mmc_macsec,
	dbg_buf_config_macsec,
	dbg_events_config_macsec,
	macsec_get_sc_lut_key_index,
	nvethmgr_get_status,
	nvethmgr_verify_ts,
	nvethmgr_get_avb_perf,
}ivc_cmd;

/**
 * @brief IVC arguments structure.
 */
typedef struct {
	/** Number of arguments
	 * valid vaues are from 0 to NVETHERNETRM_PIF$MAX_ARGS */
	nveu32_t count;
	/** arguments
	 * valid values are from 0 to UINT32_MAX for each array element */
	nveu32_t arguments[MAX_ARGS];
} ivc_args;

/**
 * @brief IVC core argument structure.
 */
typedef struct {
	/** Number of MTL queues enabled in MAC
	 * max value for EQOS is NVETHERNETRM_PIF$OSI_EQOS_MAX_NUM_QUEUES
	 * max value for MGBE is NVETHERNETRM_PIF$OSI_MGBE_MAX_NUM_QUEUES*/
	nveu32_t num_mtl_queues;
	/** Array of MTL queues
	 * each array element has max value same as num_mtl_queues */
	nveu32_t mtl_queues[OSI_EQOS_MAX_NUM_CHANS];
	/** List of MTL Rx queue mode that need to be enabled */
	nveu32_t rxq_ctrl[OSI_EQOS_MAX_NUM_CHANS];
	/** Rx MTl Queue mapping based on User Priority field
	 * valid values are from 1 to 0xFF */
	nveu32_t rxq_prio[OSI_EQOS_MAX_NUM_CHANS];
	/** Ethernet MAC address
	 * valid values are from 0 to 0xFF for each array element */
	nveu8_t mac_addr[OSI_ETH_ALEN];
	/** VLAN tag stripping enable(1) or disable(0) */
	nveu32_t strip_vlan_tag;
	/** pause frame support
	 * valid values are NVETHERNETRM_PIF$OSI_PAUSE_FRAMES_DISABLE
	 * and NVETHERNETRM_PIF$OSI_PAUSE_FRAMES_ENABLE */
	nveu32_t pause_frames;
	/** Current flow control settings
	 * valid values are 0(disable flow control)
	 * NVETHERNETRM_PIF$OSI_FLOW_CTRL_TX and NVETHERNETRM_PIF$OSI_FLOW_CTRL_RX */
	nveu32_t flow_ctrl;
	/** Rx fifo size
	 * maximum value is 0x1F */
	nveu32_t rx_fifo_size;
	/** Tx fifo size
	 * maximum value is 0x1F */
	nveu32_t tx_fifo_size;
} ivc_core_args;

/**
 * @brief macsec config structure.
 */
#ifdef MACSEC_SUPPORT
typedef struct {
	/** MACsec secure channel basic information
	 * for more details refer NVETHERNETRM_PIF$osi_macsec_sc_info*/
	struct osi_macsec_sc_info sc_info;
	/** MACsec enable or disable
	 * valid values are 0(disable) and 1(enable)*/
	nveu32_t enable;
	/** MACsec controller
	 * valid values are NVETHERNETRM_PIF$OSI_CTLR_SEL_RX and
	* NVETHERNETRM_PIF$OSI_CTLR_SEL_TX */
	nveu16_t ctlr;
	/** MACsec KT index
	 * valid values are from 0 to NVETHERNETRM_PIF$OSI_TABLE_INDEX_MAX */
	nveu16_t kt_idx;
	/** MACsec KT index
	 * valid values are from 0 to NVETHERNETRM_PIF$OSI_TABLE_INDEX_MAX */
	nveu32_t key_index;
	/** MACsec SCI
	 * valid values are from 0 to 0xF for each array element */
	nveu8_t sci[OSI_SCI_LEN];
} macsec_config;
#endif

/**
 * @brief IVC message structure.
 */
typedef struct ivc_msg_common {
	/**
	 * Status code returned as part of response message of IVC messages.
	 * Status code value is "0" for success and "< 0" for failure.
	 */
	nve32_t status;
	/** ID of the CMD. */
	ivc_cmd cmd;
	/** message count, used for debug */
	nveu32_t count;

	/** IVC argument structure */
	ivc_args args;

	union {
		/** avb algorithm structure */
		struct osi_core_avb_algorithm avb_algo;
		/** OSI filter structure */
		struct osi_filter filter;
		/** OSI HW features */
		struct osi_hw_features hw_feat;
		/** MMC counters */
		struct osi_mmc_counters mmc_s;
		/** OSI stats counters */
		struct osi_stats stats_s;
		/** core argument structure */
		ivc_core_args init_args;
		/** ioctl command structure */
		struct osi_ioctl ioctl_data;
#ifdef MACSEC_SUPPORT
		/** lut config */
		struct osi_macsec_lut_config lut_config;
#ifdef MACSEC_KEY_PROGRAM
		/** kt config */
		struct osi_macsec_kt_config kt_config;
#endif
#ifdef DEBUG_MACSEC
		/** MACsec Debug buffer data structure */
		struct osi_macsec_dbg_buf_config dbg_buf_config;
#endif
		/** MACsec config */
		macsec_config macsec_cfg;
		/** macsec mmc counters */
		struct osi_macsec_mmc_counters macsec_mmc;
		/** macsec IRQ stats */
		struct osi_macsec_irq_stats macsec_irq_stats;
		/** MACSEC Ethernet MAC address
		 * valid values are from 0 to 0xFF for each array element */
		nveu8_t macsec_mac_addr[OSI_ETH_ALEN];
#endif
	}data;
} ivc_msg_common_t;

#endif /* INCLUDED_IVC_CORE_H */