openwrt/target/linux/mediatek/files/drivers/net/phy/rtk/rtl8367c/include/l2.h

1182 lines
38 KiB
C

/*
* Copyright (C) 2013 Realtek Semiconductor Corp.
* All Rights Reserved.
*
* Unless you and Realtek execute a separate written software license
* agreement governing use of this software, this software is licensed
* to you under the terms of the GNU General Public License version 2,
* available at https://www.gnu.org/licenses/old-licenses/gpl-2.0.txt
*
* Purpose : RTL8367/RTL8367C switch high-level API
*
* Feature : The file includes L2 module high-layer API definition
*
*/
#ifndef __RTK_API_L2_H__
#define __RTK_API_L2_H__
/*
* Data Type Declaration
*/
#define RTK_MAX_NUM_OF_LEARN_LIMIT (rtk_switch_maxLutAddrNumber_get())
#define RTK_MAC_ADDR_LEN 6
#define RTK_MAX_LUT_ADDRESS (RTK_MAX_NUM_OF_LEARN_LIMIT)
#define RTK_MAX_LUT_ADDR_ID (RTK_MAX_LUT_ADDRESS - 1)
typedef rtk_uint32 rtk_l2_age_time_t;
typedef enum rtk_l2_flood_type_e
{
FLOOD_UNKNOWNDA = 0,
FLOOD_UNKNOWNMC,
FLOOD_BC,
FLOOD_END
} rtk_l2_flood_type_t;
typedef rtk_uint32 rtk_l2_flushItem_t;
typedef enum rtk_l2_flushType_e
{
FLUSH_TYPE_BY_PORT = 0, /* physical port */
FLUSH_TYPE_BY_PORT_VID, /* physical port + VID */
FLUSH_TYPE_BY_PORT_FID, /* physical port + FID */
FLUSH_TYPE_END
} rtk_l2_flushType_t;
typedef struct rtk_l2_flushCfg_s
{
rtk_enable_t flushByVid;
rtk_vlan_t vid;
rtk_enable_t flushByFid;
rtk_uint32 fid;
rtk_enable_t flushByPort;
rtk_port_t port;
rtk_enable_t flushByMac;
rtk_mac_t ucastAddr;
rtk_enable_t flushStaticAddr;
rtk_enable_t flushAddrOnAllPorts; /* this is used when flushByVid */
} rtk_l2_flushCfg_t;
typedef enum rtk_l2_read_method_e{
READMETHOD_MAC = 0,
READMETHOD_ADDRESS,
READMETHOD_NEXT_ADDRESS,
READMETHOD_NEXT_L2UC,
READMETHOD_NEXT_L2MC,
READMETHOD_NEXT_L3MC,
READMETHOD_NEXT_L2L3MC,
READMETHOD_NEXT_L2UCSPA,
READMETHOD_END
}rtk_l2_read_method_t;
/* l2 limit learning count action */
typedef enum rtk_l2_limitLearnCntAction_e
{
LIMIT_LEARN_CNT_ACTION_DROP = 0,
LIMIT_LEARN_CNT_ACTION_FORWARD,
LIMIT_LEARN_CNT_ACTION_TO_CPU,
LIMIT_LEARN_CNT_ACTION_END
} rtk_l2_limitLearnCntAction_t;
typedef enum rtk_l2_ipmc_lookup_type_e
{
LOOKUP_MAC = 0,
LOOKUP_IP,
LOOKUP_IP_VID,
LOOKUP_END
} rtk_l2_ipmc_lookup_type_t;
/* l2 address table - unicast data structure */
typedef struct rtk_l2_ucastAddr_s
{
rtk_mac_t mac;
rtk_uint32 ivl;
rtk_uint32 cvid;
rtk_uint32 fid;
rtk_uint32 efid;
rtk_uint32 port;
rtk_uint32 sa_block;
rtk_uint32 da_block;
rtk_uint32 auth;
rtk_uint32 is_static;
rtk_uint32 priority;
rtk_uint32 sa_pri_en;
rtk_uint32 fwd_pri_en;
rtk_uint32 address;
}rtk_l2_ucastAddr_t;
/* l2 address table - multicast data structure */
typedef struct rtk_l2_mcastAddr_s
{
rtk_uint32 vid;
rtk_mac_t mac;
rtk_uint32 fid;
rtk_portmask_t portmask;
rtk_uint32 ivl;
rtk_uint32 priority;
rtk_uint32 fwd_pri_en;
rtk_uint32 igmp_asic;
rtk_uint32 igmp_index;
rtk_uint32 address;
}rtk_l2_mcastAddr_t;
/* l2 address table - ip multicast data structure */
typedef struct rtk_l2_ipMcastAddr_s
{
ipaddr_t dip;
ipaddr_t sip;
rtk_portmask_t portmask;
rtk_uint32 priority;
rtk_uint32 fwd_pri_en;
rtk_uint32 igmp_asic;
rtk_uint32 igmp_index;
rtk_uint32 address;
}rtk_l2_ipMcastAddr_t;
/* l2 address table - ip VID multicast data structure */
typedef struct rtk_l2_ipVidMcastAddr_s
{
ipaddr_t dip;
ipaddr_t sip;
rtk_uint32 vid;
rtk_portmask_t portmask;
rtk_uint32 address;
}rtk_l2_ipVidMcastAddr_t;
typedef struct rtk_l2_addr_table_s
{
rtk_uint32 index;
ipaddr_t sip;
ipaddr_t dip;
rtk_mac_t mac;
rtk_uint32 sa_block;
rtk_uint32 auth;
rtk_portmask_t portmask;
rtk_uint32 age;
rtk_uint32 ivl;
rtk_uint32 cvid;
rtk_uint32 fid;
rtk_uint32 is_ipmul;
rtk_uint32 is_static;
rtk_uint32 is_ipvidmul;
rtk_uint32 l3_vid;
}rtk_l2_addr_table_t;
typedef enum rtk_l2_clearStatus_e
{
L2_CLEAR_STATE_FINISH = 0,
L2_CLEAR_STATE_BUSY,
L2_CLEAR_STATE_END
}rtk_l2_clearStatus_t;
/* Function Name:
* rtk_l2_init
* Description:
* Initialize l2 module of the specified device.
* Input:
* None
* Output:
* None
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* Note:
* Initialize l2 module before calling any l2 APIs.
*/
extern rtk_api_ret_t rtk_l2_init(void);
/* Function Name:
* rtk_l2_addr_add
* Description:
* Add LUT unicast entry.
* Input:
* pMac - 6 bytes unicast(I/G bit is 0) mac address to be written into LUT.
* pL2_data - Unicast entry parameter
* Output:
* None
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_ID - Invalid port number.
* RT_ERR_MAC - Invalid MAC address.
* RT_ERR_L2_FID - Invalid FID .
* RT_ERR_L2_INDEXTBL_FULL - hashed index is full of entries.
* RT_ERR_INPUT - Invalid input parameters.
* Note:
* If the unicast mac address already existed in LUT, it will update the status of the entry.
* Otherwise, it will find an empty or asic auto learned entry to write. If all the entries
* with the same hash value can't be replaced, ASIC will return a RT_ERR_L2_INDEXTBL_FULL error.
*/
extern rtk_api_ret_t rtk_l2_addr_add(rtk_mac_t *pMac, rtk_l2_ucastAddr_t *pL2_data);
/* Function Name:
* rtk_l2_addr_get
* Description:
* Get LUT unicast entry.
* Input:
* pMac - 6 bytes unicast(I/G bit is 0) mac address to be written into LUT.
* Output:
* pL2_data - Unicast entry parameter
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_ID - Invalid port number.
* RT_ERR_MAC - Invalid MAC address.
* RT_ERR_L2_FID - Invalid FID .
* RT_ERR_L2_ENTRY_NOTFOUND - No such LUT entry.
* RT_ERR_INPUT - Invalid input parameters.
* Note:
* If the unicast mac address existed in LUT, it will return the port and fid where
* the mac is learned. Otherwise, it will return a RT_ERR_L2_ENTRY_NOTFOUND error.
*/
extern rtk_api_ret_t rtk_l2_addr_get(rtk_mac_t *pMac, rtk_l2_ucastAddr_t *pL2_data);
/* Function Name:
* rtk_l2_addr_next_get
* Description:
* Get Next LUT unicast entry.
* Input:
* read_method - The reading method.
* port - The port number if the read_metohd is READMETHOD_NEXT_L2UCSPA
* pAddress - The Address ID
* Output:
* pL2_data - Unicast entry parameter
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_ID - Invalid port number.
* RT_ERR_MAC - Invalid MAC address.
* RT_ERR_L2_FID - Invalid FID .
* RT_ERR_L2_ENTRY_NOTFOUND - No such LUT entry.
* RT_ERR_INPUT - Invalid input parameters.
* Note:
* Get the next unicast entry after the current entry pointed by pAddress.
* The address of next entry is returned by pAddress. User can use (address + 1)
* as pAddress to call this API again for dumping all entries is LUT.
*/
extern rtk_api_ret_t rtk_l2_addr_next_get(rtk_l2_read_method_t read_method, rtk_port_t port, rtk_uint32 *pAddress, rtk_l2_ucastAddr_t *pL2_data);
/* Function Name:
* rtk_l2_addr_del
* Description:
* Delete LUT unicast entry.
* Input:
* pMac - 6 bytes unicast(I/G bit is 0) mac address to be written into LUT.
* fid - Filtering database
* Output:
* None
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_ID - Invalid port number.
* RT_ERR_MAC - Invalid MAC address.
* RT_ERR_L2_FID - Invalid FID .
* RT_ERR_L2_ENTRY_NOTFOUND - No such LUT entry.
* RT_ERR_INPUT - Invalid input parameters.
* Note:
* If the mac has existed in the LUT, it will be deleted. Otherwise, it will return RT_ERR_L2_ENTRY_NOTFOUND.
*/
extern rtk_api_ret_t rtk_l2_addr_del(rtk_mac_t *pMac, rtk_l2_ucastAddr_t *pL2_data);
/* Function Name:
* rtk_l2_mcastAddr_add
* Description:
* Add LUT multicast entry.
* Input:
* pMcastAddr - L2 multicast entry structure
* Output:
* None
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_ID - Invalid port number.
* RT_ERR_MAC - Invalid MAC address.
* RT_ERR_L2_FID - Invalid FID .
* RT_ERR_L2_VID - Invalid VID .
* RT_ERR_L2_INDEXTBL_FULL - hashed index is full of entries.
* RT_ERR_PORT_MASK - Invalid portmask.
* RT_ERR_INPUT - Invalid input parameters.
* Note:
* If the multicast mac address already existed in the LUT, it will update the
* port mask of the entry. Otherwise, it will find an empty or asic auto learned
* entry to write. If all the entries with the same hash value can't be replaced,
* ASIC will return a RT_ERR_L2_INDEXTBL_FULL error.
*/
extern rtk_api_ret_t rtk_l2_mcastAddr_add(rtk_l2_mcastAddr_t *pMcastAddr);
/* Function Name:
* rtk_l2_mcastAddr_get
* Description:
* Get LUT multicast entry.
* Input:
* pMcastAddr - L2 multicast entry structure
* Output:
* pMcastAddr - L2 multicast entry structure
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_MAC - Invalid MAC address.
* RT_ERR_L2_FID - Invalid FID .
* RT_ERR_L2_VID - Invalid VID .
* RT_ERR_L2_ENTRY_NOTFOUND - No such LUT entry.
* RT_ERR_INPUT - Invalid input parameters.
* Note:
* If the multicast mac address existed in the LUT, it will return the port where
* the mac is learned. Otherwise, it will return a RT_ERR_L2_ENTRY_NOTFOUND error.
*/
extern rtk_api_ret_t rtk_l2_mcastAddr_get(rtk_l2_mcastAddr_t *pMcastAddr);
/* Function Name:
* rtk_l2_mcastAddr_next_get
* Description:
* Get Next L2 Multicast entry.
* Input:
* pAddress - The Address ID
* Output:
* pMcastAddr - L2 multicast entry structure
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_L2_ENTRY_NOTFOUND - No such LUT entry.
* RT_ERR_INPUT - Invalid input parameters.
* Note:
* Get the next L2 multicast entry after the current entry pointed by pAddress.
* The address of next entry is returned by pAddress. User can use (address + 1)
* as pAddress to call this API again for dumping all multicast entries is LUT.
*/
extern rtk_api_ret_t rtk_l2_mcastAddr_next_get(rtk_uint32 *pAddress, rtk_l2_mcastAddr_t *pMcastAddr);
/* Function Name:
* rtk_l2_mcastAddr_del
* Description:
* Delete LUT multicast entry.
* Input:
* pMcastAddr - L2 multicast entry structure
* Output:
* None
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_MAC - Invalid MAC address.
* RT_ERR_L2_FID - Invalid FID .
* RT_ERR_L2_VID - Invalid VID .
* RT_ERR_L2_ENTRY_NOTFOUND - No such LUT entry.
* RT_ERR_INPUT - Invalid input parameters.
* Note:
* If the mac has existed in the LUT, it will be deleted. Otherwise, it will return RT_ERR_L2_ENTRY_NOTFOUND.
*/
extern rtk_api_ret_t rtk_l2_mcastAddr_del(rtk_l2_mcastAddr_t *pMcastAddr);
/* Function Name:
* rtk_l2_ipMcastAddr_add
* Description:
* Add LUT IP multicast entry
* Input:
* pIpMcastAddr - IP Multicast entry
* Output:
* None
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_ID - Invalid port number.
* RT_ERR_L2_INDEXTBL_FULL - hashed index is full of entries.
* RT_ERR_PORT_MASK - Invalid portmask.
* RT_ERR_INPUT - Invalid input parameters.
* Note:
* System supports L2 entry with IP multicast DIP/SIP to forward IP multicasting frame as user
* desired. If this function is enabled, then system will be looked up L2 IP multicast entry to
* forward IP multicast frame directly without flooding.
*/
extern rtk_api_ret_t rtk_l2_ipMcastAddr_add(rtk_l2_ipMcastAddr_t *pIpMcastAddr);
/* Function Name:
* rtk_l2_ipMcastAddr_get
* Description:
* Get LUT IP multicast entry.
* Input:
* pIpMcastAddr - IP Multicast entry
* Output:
* pIpMcastAddr - IP Multicast entry
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_L2_ENTRY_NOTFOUND - No such LUT entry.
* RT_ERR_INPUT - Invalid input parameters.
* Note:
* The API can get LUT table of IP multicast entry.
*/
extern rtk_api_ret_t rtk_l2_ipMcastAddr_get(rtk_l2_ipMcastAddr_t *pIpMcastAddr);
/* Function Name:
* rtk_l2_ipMcastAddr_next_get
* Description:
* Get Next IP Multicast entry.
* Input:
* pAddress - The Address ID
* Output:
* pIpMcastAddr - IP Multicast entry
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_L2_ENTRY_NOTFOUND - No such LUT entry.
* RT_ERR_INPUT - Invalid input parameters.
* Note:
* Get the next IP multicast entry after the current entry pointed by pAddress.
* The address of next entry is returned by pAddress. User can use (address + 1)
* as pAddress to call this API again for dumping all IP multicast entries is LUT.
*/
extern rtk_api_ret_t rtk_l2_ipMcastAddr_next_get(rtk_uint32 *pAddress, rtk_l2_ipMcastAddr_t *pIpMcastAddr);
/* Function Name:
* rtk_l2_ipMcastAddr_del
* Description:
* Delete a ip multicast address entry from the specified device.
* Input:
* pIpMcastAddr - IP Multicast entry
* Output:
* None
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_L2_ENTRY_NOTFOUND - No such LUT entry.
* RT_ERR_INPUT - Invalid input parameters.
* Note:
* The API can delete a IP multicast address entry from the specified device.
*/
extern rtk_api_ret_t rtk_l2_ipMcastAddr_del(rtk_l2_ipMcastAddr_t *pIpMcastAddr);
/* Function Name:
* rtk_l2_ipVidMcastAddr_add
* Description:
* Add LUT IP multicast+VID entry
* Input:
* pIpVidMcastAddr - IP & VID multicast Entry
* Output:
* None
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_ID - Invalid port number.
* RT_ERR_L2_INDEXTBL_FULL - hashed index is full of entries.
* RT_ERR_PORT_MASK - Invalid portmask.
* RT_ERR_INPUT - Invalid input parameters.
* Note:
*
*/
extern rtk_api_ret_t rtk_l2_ipVidMcastAddr_add(rtk_l2_ipVidMcastAddr_t *pIpVidMcastAddr);
/* Function Name:
* rtk_l2_ipVidMcastAddr_get
* Description:
* Get LUT IP multicast+VID entry.
* Input:
* pIpVidMcastAddr - IP & VID multicast Entry
* Output:
* pIpVidMcastAddr - IP & VID multicast Entry
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_L2_ENTRY_NOTFOUND - No such LUT entry.
* RT_ERR_INPUT - Invalid input parameters.
* Note:
*
*/
extern rtk_api_ret_t rtk_l2_ipVidMcastAddr_get(rtk_l2_ipVidMcastAddr_t *pIpVidMcastAddr);
/* Function Name:
* rtk_l2_ipVidMcastAddr_next_get
* Description:
* Get Next IP Multicast+VID entry.
* Input:
* pAddress - The Address ID
* Output:
* pIpVidMcastAddr - IP & VID multicast Entry
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_L2_ENTRY_NOTFOUND - No such LUT entry.
* RT_ERR_INPUT - Invalid input parameters.
* Note:
* Get the next IP multicast entry after the current entry pointed by pAddress.
* The address of next entry is returned by pAddress. User can use (address + 1)
* as pAddress to call this API again for dumping all IP multicast entries is LUT.
*/
extern rtk_api_ret_t rtk_l2_ipVidMcastAddr_next_get(rtk_uint32 *pAddress, rtk_l2_ipVidMcastAddr_t *pIpVidMcastAddr);
/* Function Name:
* rtk_l2_ipVidMcastAddr_del
* Description:
* Delete a ip multicast+VID address entry from the specified device.
* Input:
* pIpVidMcastAddr - IP & VID multicast Entry
* Output:
* None
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_L2_ENTRY_NOTFOUND - No such LUT entry.
* RT_ERR_INPUT - Invalid input parameters.
* Note:
*
*/
extern rtk_api_ret_t rtk_l2_ipVidMcastAddr_del(rtk_l2_ipVidMcastAddr_t *pIpVidMcastAddr);
/* Function Name:
* rtk_l2_ucastAddr_flush
* Description:
* Flush L2 mac address by type in the specified device (both dynamic and static).
* Input:
* pConfig - flush configuration
* Output:
* None
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_ID - Invalid port number.
* RT_ERR_VLAN_VID - Invalid VID parameter.
* RT_ERR_INPUT - Invalid input parameters.
* Note:
* flushByVid - 1: Flush by VID, 0: Don't flush by VID
* vid - VID (0 ~ 4095)
* flushByFid - 1: Flush by FID, 0: Don't flush by FID
* fid - FID (0 ~ 15)
* flushByPort - 1: Flush by Port, 0: Don't flush by Port
* port - Port ID
* flushByMac - Not Supported
* ucastAddr - Not Supported
* flushStaticAddr - 1: Flush both Static and Dynamic entries, 0: Flush only Dynamic entries
* flushAddrOnAllPorts - 1: Flush VID-matched entries at all ports, 0: Flush VID-matched entries per port.
*/
extern rtk_api_ret_t rtk_l2_ucastAddr_flush(rtk_l2_flushCfg_t *pConfig);
/* Function Name:
* rtk_l2_table_clear
* Description:
* Flush all static & dynamic entries in LUT.
* Input:
* None
* Output:
* None
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* Note:
*
*/
extern rtk_api_ret_t rtk_l2_table_clear(void);
/* Function Name:
* rtk_l2_table_clearStatus_get
* Description:
* Get table clear status
* Input:
* None
* Output:
* pStatus - Clear status, 1:Busy, 0:finish
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* Note:
*
*/
extern rtk_api_ret_t rtk_l2_table_clearStatus_get(rtk_l2_clearStatus_t *pStatus);
/* Function Name:
* rtk_l2_flushLinkDownPortAddrEnable_set
* Description:
* Set HW flush linkdown port mac configuration of the specified device.
* Input:
* port - Port id.
* enable - link down flush status
* Output:
* None
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_ID - Invalid port number.
* RT_ERR_ENABLE - Invalid enable input.
* Note:
* The status of flush linkdown port address is as following:
* - DISABLED
* - ENABLED
*/
extern rtk_api_ret_t rtk_l2_flushLinkDownPortAddrEnable_set(rtk_port_t port, rtk_enable_t enable);
/* Function Name:
* rtk_l2_flushLinkDownPortAddrEnable_get
* Description:
* Get HW flush linkdown port mac configuration of the specified device.
* Input:
* port - Port id.
* Output:
* pEnable - link down flush status
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_ID - Invalid port number.
* Note:
* The status of flush linkdown port address is as following:
* - DISABLED
* - ENABLED
*/
extern rtk_api_ret_t rtk_l2_flushLinkDownPortAddrEnable_get(rtk_port_t port, rtk_enable_t *pEnable);
/* Function Name:
* rtk_l2_agingEnable_set
* Description:
* Set L2 LUT aging status per port setting.
* Input:
* port - Port id.
* enable - Aging status
* Output:
* None
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_ID - Invalid port number.
* RT_ERR_ENABLE - Invalid enable input.
* Note:
* This API can be used to set L2 LUT aging status per port.
*/
extern rtk_api_ret_t rtk_l2_agingEnable_set(rtk_port_t port, rtk_enable_t enable);
/* Function Name:
* rtk_l2_agingEnable_get
* Description:
* Get L2 LUT aging status per port setting.
* Input:
* port - Port id.
* Output:
* pEnable - Aging status
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_ID - Invalid port number.
* Note:
* This API can be used to get L2 LUT aging function per port.
*/
extern rtk_api_ret_t rtk_l2_agingEnable_get(rtk_port_t port, rtk_enable_t *pEnable);
/* Function Name:
* rtk_l2_limitLearningCnt_set
* Description:
* Set per-Port auto learning limit number
* Input:
* port - Port id.
* mac_cnt - Auto learning entries limit number
* Output:
* None
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_ID - Invalid port number.
* RT_ERR_LIMITED_L2ENTRY_NUM - Invalid auto learning limit number
* Note:
* The API can set per-port ASIC auto learning limit number from 0(disable learning)
* to 8k.
*/
extern rtk_api_ret_t rtk_l2_limitLearningCnt_set(rtk_port_t port, rtk_mac_cnt_t mac_cnt);
/* Function Name:
* rtk_l2_limitLearningCnt_get
* Description:
* Get per-Port auto learning limit number
* Input:
* port - Port id.
* Output:
* pMac_cnt - Auto learning entries limit number
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_ID - Invalid port number.
* Note:
* The API can get per-port ASIC auto learning limit number.
*/
extern rtk_api_ret_t rtk_l2_limitLearningCnt_get(rtk_port_t port, rtk_mac_cnt_t *pMac_cnt);
/* Function Name:
* rtk_l2_limitSystemLearningCnt_set
* Description:
* Set System auto learning limit number
* Input:
* mac_cnt - Auto learning entries limit number
* Output:
* None
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_LIMITED_L2ENTRY_NUM - Invalid auto learning limit number
* Note:
* The API can set system ASIC auto learning limit number from 0(disable learning)
* to 2112.
*/
extern rtk_api_ret_t rtk_l2_limitSystemLearningCnt_set(rtk_mac_cnt_t mac_cnt);
/* Function Name:
* rtk_l2_limitSystemLearningCnt_get
* Description:
* Get System auto learning limit number
* Input:
* None
* Output:
* pMac_cnt - Auto learning entries limit number
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_ID - Invalid port number.
* Note:
* The API can get system ASIC auto learning limit number.
*/
extern rtk_api_ret_t rtk_l2_limitSystemLearningCnt_get(rtk_mac_cnt_t *pMac_cnt);
/* Function Name:
* rtk_l2_limitLearningCntAction_set
* Description:
* Configure auto learn over limit number action.
* Input:
* port - Port id.
* action - Auto learning entries limit number
* Output:
* None
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_ID - Invalid port number.
* RT_ERR_NOT_ALLOWED - Invalid learn over action
* Note:
* The API can set SA unknown packet action while auto learn limit number is over
* The action symbol as following:
* - LIMIT_LEARN_CNT_ACTION_DROP,
* - LIMIT_LEARN_CNT_ACTION_FORWARD,
* - LIMIT_LEARN_CNT_ACTION_TO_CPU,
*/
extern rtk_api_ret_t rtk_l2_limitLearningCntAction_set(rtk_port_t port, rtk_l2_limitLearnCntAction_t action);
/* Function Name:
* rtk_l2_limitLearningCntAction_get
* Description:
* Get auto learn over limit number action.
* Input:
* port - Port id.
* Output:
* pAction - Learn over action
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_ID - Invalid port number.
* Note:
* The API can get SA unknown packet action while auto learn limit number is over
* The action symbol as following:
* - LIMIT_LEARN_CNT_ACTION_DROP,
* - LIMIT_LEARN_CNT_ACTION_FORWARD,
* - LIMIT_LEARN_CNT_ACTION_TO_CPU,
*/
extern rtk_api_ret_t rtk_l2_limitLearningCntAction_get(rtk_port_t port, rtk_l2_limitLearnCntAction_t *pAction);
/* Function Name:
* rtk_l2_limitSystemLearningCntAction_set
* Description:
* Configure system auto learn over limit number action.
* Input:
* port - Port id.
* action - Auto learning entries limit number
* Output:
* None
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_ID - Invalid port number.
* RT_ERR_NOT_ALLOWED - Invalid learn over action
* Note:
* The API can set SA unknown packet action while auto learn limit number is over
* The action symbol as following:
* - LIMIT_LEARN_CNT_ACTION_DROP,
* - LIMIT_LEARN_CNT_ACTION_FORWARD,
* - LIMIT_LEARN_CNT_ACTION_TO_CPU,
*/
extern rtk_api_ret_t rtk_l2_limitSystemLearningCntAction_set(rtk_l2_limitLearnCntAction_t action);
/* Function Name:
* rtk_l2_limitSystemLearningCntAction_get
* Description:
* Get system auto learn over limit number action.
* Input:
* None.
* Output:
* pAction - Learn over action
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_ID - Invalid port number.
* Note:
* The API can get SA unknown packet action while auto learn limit number is over
* The action symbol as following:
* - LIMIT_LEARN_CNT_ACTION_DROP,
* - LIMIT_LEARN_CNT_ACTION_FORWARD,
* - LIMIT_LEARN_CNT_ACTION_TO_CPU,
*/
extern rtk_api_ret_t rtk_l2_limitSystemLearningCntAction_get(rtk_l2_limitLearnCntAction_t *pAction);
/* Function Name:
* rtk_l2_limitSystemLearningCntPortMask_set
* Description:
* Configure system auto learn portmask
* Input:
* pPortmask - Port Mask
* Output:
* None
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_MASK - Invalid port mask.
* Note:
*
*/
extern rtk_api_ret_t rtk_l2_limitSystemLearningCntPortMask_set(rtk_portmask_t *pPortmask);
/* Function Name:
* rtk_l2_limitSystemLearningCntPortMask_get
* Description:
* get system auto learn portmask
* Input:
* None
* Output:
* pPortmask - Port Mask
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_NULL_POINTER - Null pointer.
* Note:
*
*/
extern rtk_api_ret_t rtk_l2_limitSystemLearningCntPortMask_get(rtk_portmask_t *pPortmask);
/* Function Name:
* rtk_l2_learningCnt_get
* Description:
* Get per-Port current auto learning number
* Input:
* port - Port id.
* Output:
* pMac_cnt - ASIC auto learning entries number
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_ID - Invalid port number.
* Note:
* The API can get per-port ASIC auto learning number
*/
extern rtk_api_ret_t rtk_l2_learningCnt_get(rtk_port_t port, rtk_mac_cnt_t *pMac_cnt);
/* Function Name:
* rtk_l2_floodPortMask_set
* Description:
* Set flooding portmask
* Input:
* type - flooding type.
* pFlood_portmask - flooding portmask
* Output:
* None
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_MASK - Invalid portmask.
* RT_ERR_INPUT - Invalid input parameters.
* Note:
* This API can set the flooding mask.
* The flooding type is as following:
* - FLOOD_UNKNOWNDA
* - FLOOD_UNKNOWNMC
* - FLOOD_BC
*/
extern rtk_api_ret_t rtk_l2_floodPortMask_set(rtk_l2_flood_type_t floood_type, rtk_portmask_t *pFlood_portmask);
/* Function Name:
* rtk_l2_floodPortMask_get
* Description:
* Get flooding portmask
* Input:
* type - flooding type.
* Output:
* pFlood_portmask - flooding portmask
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_ID - Invalid port number.
* Note:
* This API can get the flooding mask.
* The flooding type is as following:
* - FLOOD_UNKNOWNDA
* - FLOOD_UNKNOWNMC
* - FLOOD_BC
*/
extern rtk_api_ret_t rtk_l2_floodPortMask_get(rtk_l2_flood_type_t floood_type, rtk_portmask_t *pFlood_portmask);
/* Function Name:
* rtk_l2_localPktPermit_set
* Description:
* Set permission of frames if source port and destination port are the same.
* Input:
* port - Port id.
* permit - permission status
* Output:
* None
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_ID - Invalid port number.
* RT_ERR_ENABLE - Invalid permit value.
* Note:
* This API is set to permit frame if its source port is equal to destination port.
*/
extern rtk_api_ret_t rtk_l2_localPktPermit_set(rtk_port_t port, rtk_enable_t permit);
/* Function Name:
* rtk_l2_localPktPermit_get
* Description:
* Get permission of frames if source port and destination port are the same.
* Input:
* port - Port id.
* Output:
* pPermit - permission status
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_ID - Invalid port number.
* Note:
* This API is to get permission status for frames if its source port is equal to destination port.
*/
extern rtk_api_ret_t rtk_l2_localPktPermit_get(rtk_port_t port, rtk_enable_t *pPermit);
/* Function Name:
* rtk_l2_aging_set
* Description:
* Set LUT ageing out speed
* Input:
* aging_time - Ageing out time.
* Output:
* None
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_OUT_OF_RANGE - input out of range.
* Note:
* The API can set LUT ageing out period for each entry and the range is from 14s to 800s.
*/
extern rtk_api_ret_t rtk_l2_aging_set(rtk_l2_age_time_t aging_time);
/* Function Name:
* rtk_l2_aging_get
* Description:
* Get LUT ageing out time
* Input:
* None
* Output:
* pEnable - Aging status
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_PORT_ID - Invalid port number.
* Note:
* The API can get LUT ageing out period for each entry.
*/
extern rtk_api_ret_t rtk_l2_aging_get(rtk_l2_age_time_t *pAging_time);
/* Function Name:
* rtk_l2_ipMcastAddrLookup_set
* Description:
* Set LUT IP multicast lookup function
* Input:
* type - Lookup type for IPMC packet.
* Output:
* None.
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* Note:
* This API can work with rtk_l2_ipMcastAddrLookupException_add.
* If users set the lookup type to DIP, the group in exception table
* will be lookup by DIP+SIP
* If users set the lookup type to DIP+SIP, the group in exception table
* will be lookup by only DIP
*/
extern rtk_api_ret_t rtk_l2_ipMcastAddrLookup_set(rtk_l2_ipmc_lookup_type_t type);
/* Function Name:
* rtk_l2_ipMcastAddrLookup_get
* Description:
* Get LUT IP multicast lookup function
* Input:
* None.
* Output:
* pType - Lookup type for IPMC packet.
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* Note:
* None.
*/
extern rtk_api_ret_t rtk_l2_ipMcastAddrLookup_get(rtk_l2_ipmc_lookup_type_t *pType);
/* Function Name:
* rtk_l2_ipMcastForwardRouterPort_set
* Description:
* Set IPMC packet forward to router port also or not
* Input:
* enabled - 1: Include router port, 0, exclude router port
* Output:
* None.
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* Note:
*
*/
extern rtk_api_ret_t rtk_l2_ipMcastForwardRouterPort_set(rtk_enable_t enabled);
/* Function Name:
* rtk_l2_ipMcastForwardRouterPort_get
* Description:
* Get IPMC packet forward to router port also or not
* Input:
* None.
* Output:
* pEnabled - 1: Include router port, 0, exclude router port
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_NULL_POINTER - Null pointer
* Note:
*
*/
extern rtk_api_ret_t rtk_l2_ipMcastForwardRouterPort_get(rtk_enable_t *pEnabled);
/* Function Name:
* rtk_l2_ipMcastGroupEntry_add
* Description:
* Add an IP Multicast entry to group table
* Input:
* ip_addr - IP address
* vid - VLAN ID
* pPortmask - portmask
* Output:
* None.
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_TBL_FULL - Table Full
* Note:
* Add an entry to IP Multicast Group table.
*/
extern rtk_api_ret_t rtk_l2_ipMcastGroupEntry_add(ipaddr_t ip_addr, rtk_uint32 vid, rtk_portmask_t *pPortmask);
/* Function Name:
* rtk_l2_ipMcastGroupEntry_del
* Description:
* Delete an entry from IP Multicast group table
* Input:
* ip_addr - IP address
* vid - VLAN ID
* Output:
* None.
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_TBL_FULL - Table Full
* Note:
* Delete an entry from IP Multicast group table.
*/
extern rtk_api_ret_t rtk_l2_ipMcastGroupEntry_del(ipaddr_t ip_addr, rtk_uint32 vid);
/* Function Name:
* rtk_l2_ipMcastGroupEntry_get
* Description:
* get an entry from IP Multicast group table
* Input:
* ip_addr - IP address
* vid - VLAN ID
* Output:
* pPortmask - member port mask
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_TBL_FULL - Table Full
* Note:
* Delete an entry from IP Multicast group table.
*/
extern rtk_api_ret_t rtk_l2_ipMcastGroupEntry_get(ipaddr_t ip_addr, rtk_uint32 vid, rtk_portmask_t *pPortmask);
/* Function Name:
* rtk_l2_entry_get
* Description:
* Get LUT unicast entry.
* Input:
* pL2_entry - Index field in the structure.
* Output:
* pL2_entry - other fields such as MAC, port, age...
* Return:
* RT_ERR_OK - OK
* RT_ERR_FAILED - Failed
* RT_ERR_SMI - SMI access error
* RT_ERR_L2_EMPTY_ENTRY - Empty LUT entry.
* RT_ERR_INPUT - Invalid input parameters.
* Note:
* This API is used to get address by index from 0~2111.
*/
extern rtk_api_ret_t rtk_l2_entry_get(rtk_l2_addr_table_t *pL2_entry);
#endif /* __RTK_API_L2_H__ */