mirror of
https://github.com/plappermaul/realtek-doc.git
synced 2025-12-10 07:44:41 +01:00
448 lines
12 KiB
C
Executable file
448 lines
12 KiB
C
Executable file
/*
|
|
* Copyright (C) 2013 Realtek Semiconductor Corp.
|
|
* All Rights Reserved.
|
|
*
|
|
* This program is the proprietary software of Realtek Semiconductor
|
|
* Corporation and/or its licensors, and only be used, duplicated,
|
|
* modified or distributed under the authorized license from Realtek.
|
|
*
|
|
* ANY USE OF THE SOFTWARE OTHER THAN AS AUTHORIZED UNDER
|
|
* THIS LICENSE OR COPYRIGHT LAW IS PROHIBITED.
|
|
*
|
|
* $Revision$
|
|
* $Date$
|
|
*
|
|
* Purpose : RTK switch high-level API for RTL8367/RTL8367C
|
|
* Feature : Here is a list of all functions and variables in Trunk module.
|
|
*
|
|
*/
|
|
|
|
#include <rtk_switch.h>
|
|
#include <rtk_error.h>
|
|
#include <trunk.h>
|
|
#include <linux/string.h>
|
|
|
|
#include <dal/dal_mgmt.h>
|
|
|
|
/* Function Name:
|
|
* rtk_trunk_port_set
|
|
* Description:
|
|
* Set trunking group available port mask
|
|
* Input:
|
|
* trk_gid - trunk group id
|
|
* pTrunk_member_portmask - Logic trunking member port mask
|
|
* Output:
|
|
* None
|
|
* Return:
|
|
* RT_ERR_OK - OK
|
|
* RT_ERR_FAILED - Failed
|
|
* RT_ERR_SMI - SMI access error
|
|
* RT_ERR_LA_TRUNK_ID - Invalid trunking group
|
|
* RT_ERR_PORT_MASK - Invalid portmask.
|
|
* Note:
|
|
* The API can set port trunking group port mask. Each port trunking group has max 4 ports.
|
|
* If enabled port mask has less than 2 ports available setting, then this trunking group function is disabled.
|
|
*/
|
|
rtk_api_ret_t rtk_trunk_port_set(rtk_trunk_group_t trk_gid, rtk_portmask_t *pTrunk_member_portmask)
|
|
{
|
|
rtk_api_ret_t retVal;
|
|
|
|
if (NULL == RT_MAPPER->trunk_port_set)
|
|
return RT_ERR_DRIVER_NOT_FOUND;
|
|
|
|
RTK_API_LOCK();
|
|
retVal = RT_MAPPER->trunk_port_set(trk_gid, pTrunk_member_portmask);
|
|
RTK_API_UNLOCK();
|
|
|
|
return retVal;
|
|
}
|
|
|
|
/* Function Name:
|
|
* rtk_trunk_port_get
|
|
* Description:
|
|
* Get trunking group available port mask
|
|
* Input:
|
|
* trk_gid - trunk group id
|
|
* Output:
|
|
* pTrunk_member_portmask - Logic trunking member port mask
|
|
* Return:
|
|
* RT_ERR_OK - OK
|
|
* RT_ERR_FAILED - Failed
|
|
* RT_ERR_SMI - SMI access error
|
|
* RT_ERR_LA_TRUNK_ID - Invalid trunking group
|
|
* Note:
|
|
* The API can get 2 port trunking group.
|
|
*/
|
|
rtk_api_ret_t rtk_trunk_port_get(rtk_trunk_group_t trk_gid, rtk_portmask_t *pTrunk_member_portmask)
|
|
{
|
|
rtk_api_ret_t retVal;
|
|
|
|
if (NULL == RT_MAPPER->trunk_port_get)
|
|
return RT_ERR_DRIVER_NOT_FOUND;
|
|
|
|
RTK_API_LOCK();
|
|
retVal = RT_MAPPER->trunk_port_get(trk_gid, pTrunk_member_portmask);
|
|
RTK_API_UNLOCK();
|
|
|
|
return retVal;
|
|
}
|
|
|
|
/* Function Name:
|
|
* rtk_trunk_distributionAlgorithm_set
|
|
* Description:
|
|
* Set port trunking hash select sources
|
|
* Input:
|
|
* trk_gid - trunk group id
|
|
* algo_bitmask - Bitmask of the distribution algorithm
|
|
* Output:
|
|
* None
|
|
* Return:
|
|
* RT_ERR_OK - OK
|
|
* RT_ERR_FAILED - Failed
|
|
* RT_ERR_SMI - SMI access error
|
|
* RT_ERR_LA_TRUNK_ID - Invalid trunking group
|
|
* RT_ERR_LA_HASHMASK - Hash algorithm selection error.
|
|
* RT_ERR_PORT_MASK - Invalid portmask.
|
|
* Note:
|
|
* The API can set port trunking hash algorithm sources.
|
|
* 7 bits mask for link aggregation group0 hash parameter selection {DIP, SIP, DMAC, SMAC, SPA}
|
|
* - 0b0000001: SPA
|
|
* - 0b0000010: SMAC
|
|
* - 0b0000100: DMAC
|
|
* - 0b0001000: SIP
|
|
* - 0b0010000: DIP
|
|
* - 0b0100000: TCP/UDP Source Port
|
|
* - 0b1000000: TCP/UDP Destination Port
|
|
* Example:
|
|
* - 0b0000011: SMAC & SPA
|
|
* - Note that it could be an arbitrary combination or independent set
|
|
*/
|
|
rtk_api_ret_t rtk_trunk_distributionAlgorithm_set(rtk_trunk_group_t trk_gid, rtk_uint32 algo_bitmask)
|
|
{
|
|
rtk_api_ret_t retVal;
|
|
|
|
if (NULL == RT_MAPPER->trunk_distributionAlgorithm_set)
|
|
return RT_ERR_DRIVER_NOT_FOUND;
|
|
|
|
RTK_API_LOCK();
|
|
retVal = RT_MAPPER->trunk_distributionAlgorithm_set(trk_gid, algo_bitmask);
|
|
RTK_API_UNLOCK();
|
|
|
|
return retVal;
|
|
}
|
|
|
|
/* Function Name:
|
|
* rtk_trunk_distributionAlgorithm_get
|
|
* Description:
|
|
* Get port trunking hash select sources
|
|
* Input:
|
|
* trk_gid - trunk group id
|
|
* Output:
|
|
* pAlgo_bitmask - Bitmask of the distribution algorithm
|
|
* Return:
|
|
* RT_ERR_OK - OK
|
|
* RT_ERR_FAILED - Failed
|
|
* RT_ERR_SMI - SMI access error
|
|
* RT_ERR_LA_TRUNK_ID - Invalid trunking group
|
|
* Note:
|
|
* The API can get port trunking hash algorithm sources.
|
|
*/
|
|
rtk_api_ret_t rtk_trunk_distributionAlgorithm_get(rtk_trunk_group_t trk_gid, rtk_uint32 *pAlgo_bitmask)
|
|
{
|
|
rtk_api_ret_t retVal;
|
|
|
|
if (NULL == RT_MAPPER->trunk_distributionAlgorithm_get)
|
|
return RT_ERR_DRIVER_NOT_FOUND;
|
|
|
|
RTK_API_LOCK();
|
|
retVal = RT_MAPPER->trunk_distributionAlgorithm_get(trk_gid, pAlgo_bitmask);
|
|
RTK_API_UNLOCK();
|
|
|
|
return retVal;
|
|
}
|
|
|
|
/* Function Name:
|
|
* rtk_trunk_trafficSeparate_set
|
|
* Description:
|
|
* Set the traffic separation setting of a trunk group from the specified device.
|
|
* Input:
|
|
* trk_gid - trunk group id
|
|
* separateType - traffic separation setting
|
|
* Output:
|
|
* None
|
|
* Return:
|
|
* RT_ERR_OK
|
|
* RT_ERR_FAILED
|
|
* RT_ERR_UNIT_ID - invalid unit id
|
|
* RT_ERR_LA_TRUNK_ID - invalid trunk ID
|
|
* RT_ERR_LA_HASHMASK - invalid hash mask
|
|
* Note:
|
|
* SEPARATE_NONE: disable traffic separation
|
|
* SEPARATE_FLOOD: trunk MSB link up port is dedicated to TX flooding (L2 lookup miss) traffic
|
|
*/
|
|
rtk_api_ret_t rtk_trunk_trafficSeparate_set(rtk_trunk_group_t trk_gid, rtk_trunk_separateType_t separateType)
|
|
{
|
|
rtk_api_ret_t retVal;
|
|
|
|
if (NULL == RT_MAPPER->trunk_trafficSeparate_set)
|
|
return RT_ERR_DRIVER_NOT_FOUND;
|
|
|
|
RTK_API_LOCK();
|
|
retVal = RT_MAPPER->trunk_trafficSeparate_set(trk_gid, separateType);
|
|
RTK_API_UNLOCK();
|
|
|
|
return retVal;
|
|
}
|
|
|
|
/* Function Name:
|
|
* rtk_trunk_trafficSeparate_get
|
|
* Description:
|
|
* Get the traffic separation setting of a trunk group from the specified device.
|
|
* Input:
|
|
* trk_gid - trunk group id
|
|
* Output:
|
|
* pSeparateType - pointer separated traffic type
|
|
* Return:
|
|
* RT_ERR_OK
|
|
* RT_ERR_FAILED
|
|
* RT_ERR_UNIT_ID - invalid unit id
|
|
* RT_ERR_LA_TRUNK_ID - invalid trunk ID
|
|
* RT_ERR_NULL_POINTER - input parameter may be null pointer
|
|
* Note:
|
|
* SEPARATE_NONE: disable traffic separation
|
|
* SEPARATE_FLOOD: trunk MSB link up port is dedicated to TX flooding (L2 lookup miss) traffic
|
|
*/
|
|
rtk_api_ret_t rtk_trunk_trafficSeparate_get(rtk_trunk_group_t trk_gid, rtk_trunk_separateType_t *pSeparateType)
|
|
{
|
|
rtk_api_ret_t retVal;
|
|
|
|
if (NULL == RT_MAPPER->trunk_trafficSeparate_get)
|
|
return RT_ERR_DRIVER_NOT_FOUND;
|
|
|
|
RTK_API_LOCK();
|
|
retVal = RT_MAPPER->trunk_trafficSeparate_get(trk_gid, pSeparateType);
|
|
RTK_API_UNLOCK();
|
|
|
|
return retVal;
|
|
}
|
|
|
|
/* Function Name:
|
|
* rtk_trunk_mode_set
|
|
* Description:
|
|
* Set the trunk mode to the specified device.
|
|
* Input:
|
|
* mode - trunk mode
|
|
* Output:
|
|
* None
|
|
* Return:
|
|
* RT_ERR_OK
|
|
* RT_ERR_FAILED
|
|
* RT_ERR_INPUT - invalid input parameter
|
|
* Note:
|
|
* The enum of the trunk mode as following
|
|
* - TRUNK_MODE_NORMAL
|
|
* - TRUNK_MODE_DUMB
|
|
*/
|
|
rtk_api_ret_t rtk_trunk_mode_set(rtk_trunk_mode_t mode)
|
|
{
|
|
rtk_api_ret_t retVal;
|
|
|
|
if (NULL == RT_MAPPER->trunk_mode_set)
|
|
return RT_ERR_DRIVER_NOT_FOUND;
|
|
|
|
RTK_API_LOCK();
|
|
retVal = RT_MAPPER->trunk_mode_set(mode);
|
|
RTK_API_UNLOCK();
|
|
|
|
return retVal;
|
|
}
|
|
|
|
/* Function Name:
|
|
* rtk_trunk_mode_get
|
|
* Description:
|
|
* Get the trunk mode from the specified device.
|
|
* Input:
|
|
* None
|
|
* Output:
|
|
* pMode - pointer buffer of trunk mode
|
|
* Return:
|
|
* RT_ERR_OK
|
|
* RT_ERR_FAILED
|
|
* RT_ERR_NULL_POINTER - input parameter may be null pointer
|
|
* Note:
|
|
* The enum of the trunk mode as following
|
|
* - TRUNK_MODE_NORMAL
|
|
* - TRUNK_MODE_DUMB
|
|
*/
|
|
rtk_api_ret_t rtk_trunk_mode_get(rtk_trunk_mode_t *pMode)
|
|
{
|
|
rtk_api_ret_t retVal;
|
|
|
|
if (NULL == RT_MAPPER->trunk_mode_get)
|
|
return RT_ERR_DRIVER_NOT_FOUND;
|
|
|
|
RTK_API_LOCK();
|
|
retVal = RT_MAPPER->trunk_mode_get(pMode);
|
|
RTK_API_UNLOCK();
|
|
|
|
return retVal;
|
|
}
|
|
|
|
/* Function Name:
|
|
* rtk_trunk_trafficPause_set
|
|
* Description:
|
|
* Set the traffic pause setting of a trunk group.
|
|
* Input:
|
|
* trk_gid - trunk group id
|
|
* enable - traffic pause state
|
|
* Output:
|
|
* None
|
|
* Return:
|
|
* RT_ERR_OK
|
|
* RT_ERR_FAILED
|
|
* RT_ERR_LA_TRUNK_ID - invalid trunk ID
|
|
* Note:
|
|
* None.
|
|
*/
|
|
rtk_api_ret_t rtk_trunk_trafficPause_set(rtk_trunk_group_t trk_gid, rtk_enable_t enable)
|
|
{
|
|
rtk_api_ret_t retVal;
|
|
|
|
if (NULL == RT_MAPPER->trunk_trafficPause_set)
|
|
return RT_ERR_DRIVER_NOT_FOUND;
|
|
|
|
RTK_API_LOCK();
|
|
retVal = RT_MAPPER->trunk_trafficPause_set(trk_gid, enable);
|
|
RTK_API_UNLOCK();
|
|
|
|
return retVal;
|
|
}
|
|
|
|
/* Function Name:
|
|
* rtk_trunk_trafficPause_get
|
|
* Description:
|
|
* Get the traffic pause setting of a trunk group.
|
|
* Input:
|
|
* trk_gid - trunk group id
|
|
* Output:
|
|
* pEnable - pointer of traffic pause state.
|
|
* Return:
|
|
* RT_ERR_OK
|
|
* RT_ERR_FAILED
|
|
* RT_ERR_LA_TRUNK_ID - invalid trunk ID
|
|
* RT_ERR_NULL_POINTER - input parameter may be null pointer
|
|
* Note:
|
|
* None.
|
|
*/
|
|
rtk_api_ret_t rtk_trunk_trafficPause_get(rtk_trunk_group_t trk_gid, rtk_enable_t *pEnable)
|
|
{
|
|
rtk_api_ret_t retVal;
|
|
|
|
if (NULL == RT_MAPPER->trunk_trafficPause_get)
|
|
return RT_ERR_DRIVER_NOT_FOUND;
|
|
|
|
RTK_API_LOCK();
|
|
retVal = RT_MAPPER->trunk_trafficPause_get(trk_gid, pEnable);
|
|
RTK_API_UNLOCK();
|
|
|
|
return retVal;
|
|
}
|
|
|
|
/* Function Name:
|
|
* rtk_trunk_hashMappingTable_set
|
|
* Description:
|
|
* Set hash value to port array in the trunk group id from the specified device.
|
|
* Input:
|
|
* trk_gid - trunk group id
|
|
* pHash2Port_array - ports associate with the hash value
|
|
* Output:
|
|
* None
|
|
* Return:
|
|
* RT_ERR_OK
|
|
* RT_ERR_FAILED
|
|
* RT_ERR_UNIT_ID - invalid unit id
|
|
* RT_ERR_LA_TRUNK_ID - invalid trunk ID
|
|
* RT_ERR_NULL_POINTER - input parameter may be null pointer
|
|
* RT_ERR_LA_TRUNK_NOT_EXIST - the trunk doesn't exist
|
|
* RT_ERR_LA_NOT_MEMBER_PORT - the port is not a member port of the trunk
|
|
* RT_ERR_LA_CPUPORT - CPU port can not be aggregated port
|
|
* Note:
|
|
* Trunk group 0 & 1 shares the same hash mapping table.
|
|
* Trunk group 2 uses a independent table.
|
|
*/
|
|
rtk_api_ret_t rtk_trunk_hashMappingTable_set(rtk_trunk_group_t trk_gid, rtk_trunk_hashVal2Port_t *pHash2Port_array)
|
|
{
|
|
rtk_api_ret_t retVal;
|
|
|
|
if (NULL == RT_MAPPER->trunk_hashMappingTable_set)
|
|
return RT_ERR_DRIVER_NOT_FOUND;
|
|
|
|
RTK_API_LOCK();
|
|
retVal = RT_MAPPER->trunk_hashMappingTable_set(trk_gid, pHash2Port_array);
|
|
RTK_API_UNLOCK();
|
|
|
|
return retVal;
|
|
}
|
|
|
|
/* Function Name:
|
|
* rtk_trunk_hashMappingTable_get
|
|
* Description:
|
|
* Get hash value to port array in the trunk group id from the specified device.
|
|
* Input:
|
|
* trk_gid - trunk group id
|
|
* Output:
|
|
* pHash2Port_array - pointer buffer of ports associate with the hash value
|
|
* Return:
|
|
* RT_ERR_OK
|
|
* RT_ERR_FAILED
|
|
* RT_ERR_UNIT_ID - invalid unit id
|
|
* RT_ERR_LA_TRUNK_ID - invalid trunk ID
|
|
* RT_ERR_NULL_POINTER - input parameter may be null pointer
|
|
* Note:
|
|
* Trunk group 0 & 1 shares the same hash mapping table.
|
|
* Trunk group 2 uses a independent table.
|
|
*/
|
|
rtk_api_ret_t rtk_trunk_hashMappingTable_get(rtk_trunk_group_t trk_gid, rtk_trunk_hashVal2Port_t *pHash2Port_array)
|
|
{
|
|
rtk_api_ret_t retVal;
|
|
|
|
if (NULL == RT_MAPPER->trunk_hashMappingTable_get)
|
|
return RT_ERR_DRIVER_NOT_FOUND;
|
|
|
|
RTK_API_LOCK();
|
|
retVal = RT_MAPPER->trunk_hashMappingTable_get(trk_gid, pHash2Port_array);
|
|
RTK_API_UNLOCK();
|
|
|
|
return retVal;
|
|
}
|
|
|
|
/* Function Name:
|
|
* rtk_trunk_portQueueEmpty_get
|
|
* Description:
|
|
* Get the port mask which all queues are empty.
|
|
* Input:
|
|
* None.
|
|
* Output:
|
|
* pEmpty_portmask - pointer empty port mask
|
|
* Return:
|
|
* RT_ERR_OK
|
|
* RT_ERR_FAILED
|
|
* RT_ERR_NULL_POINTER - input parameter may be null pointer
|
|
* Note:
|
|
* None.
|
|
*/
|
|
rtk_api_ret_t rtk_trunk_portQueueEmpty_get(rtk_portmask_t *pEmpty_portmask)
|
|
{
|
|
rtk_api_ret_t retVal;
|
|
|
|
if (NULL == RT_MAPPER->trunk_portQueueEmpty_get)
|
|
return RT_ERR_DRIVER_NOT_FOUND;
|
|
|
|
RTK_API_LOCK();
|
|
retVal = RT_MAPPER->trunk_portQueueEmpty_get(pEmpty_portmask);
|
|
RTK_API_UNLOCK();
|
|
|
|
return retVal;
|
|
}
|
|
|
|
|