GT_Trace的使用

使用Codec Engine开发DaVinci系统,最令人头痛的莫过于调试。由于evm6446开发过程分成DSP端和GPP端,因此我们无法使用 IDE下的调试工具对程序进行跟踪调试。为此, TI在Codec Engine中提供了一套名为Generic Trace Support 的模块,专门用来 打印Debug信息。

       要使用GT_Trace,需要在应用程序文件夹下remote.cfg文件中将GT_Trace的配置:
           //TraceUtil.attrs = TraceUtil.SOCRATES_TRACING;
           TraceUtil.attrs = TraceUtil.FULL_TRACING;
           //TraceUtil.attrs = TraceUtil.DEFAULT_TRACING;
           //TraceUtil.attrs = TraceUtil.NO_TRACING;

       要在终端上打印DEBUG信息,很简单。只需要在执行命令前加上CE_DEBUG=n,n=1,2,3即可:

       在代码中使用Generic Trace Support:

       首先,我们要定义一个GT_Mask对象,GT_Mask是用来描述GT模块的对象,它的定义如下: 
           typedef struct { 
               String modName; 
               UInt8 *flags; 
           } GT_Mask;

       我们在程序中可以这样定义: 
           GT_Mask curMask = {0,0};

       然后,调用初始化函数: 
           GT_create(&curMask, "snowwaft"); 
           GT_set("snowwaft=01234567");

       上面的代码,我们给curMask设定了名字:snowwaft,将它的级别设为0-7(有关级别,后面会描述)。

       当完成以上工作后,我们就可以使用GT模块来输出信息了:

           GT_0trace(curMask, GT_2CLASS, "main>; Welcome to DSP server's main().\n");

       屏幕会输出如下结果:
           [DSP] @0×000001a2:[T:0x00000000] snowwaft - main> Welcome to DSP server’s main().

       关于GT_*trace宏,以上我们使用GT_0trace宏来输出信息,同样的,我们还可以使用以下宏: 
           GT_0trace( mask, classId, format ) 
           GT_1trace( mask, classId, format, arg1 ) 
           GT_2trace( mask, classId, format, arg1, arg2 ) 
           GT_3trace( mask, classId, format, arg1, arg2, arg3 ) 
           GT_4trace( mask, classId, format, arg1, arg2, arg3, arg4 ) 
           GT_5trace( mask, classId, format, arg1, arg2, arg3, arg4, arg5 ) 
           GT_6trace( mask, classId, format, arg1, arg2, arg3, arg4, arg5, arg6 )

       这些宏分别定义了输出1个、2个、……、6个参数的使用方式,例如,我们需要输出两个参数: 
           GT_2trace(curMask, GT_2CLASS, "App->; Decode frame %d (0x%x)\n",p1,p2);

       关于GT_*CLASS宏,在GT_*trace宏里,第二个参数为classId,这个参数是什么用的呢?某些时候,我们在打印Trace信息的时候,有可能希望只打印某些级别的信息,而不打印其他级别的信息,因此,我们指定classID

       在GT Module里一共定义了7种级别: 
           #define GT_1CLASS ((UInt8)0x02) 
           #define GT_2CLASS ((UInt8)0x04) 
           #define GT_3CLASS ((UInt8)0x08) 
           #define GT_4CLASS ((UInt8)0x10) 
           #define GT_5CLASS ((UInt8)0x20) 
           #define GT_6CLASS ((UInt8)0x40) 
           #define GT_7CLASS ((UInt8)0x80)

       这7种级别分别表示:
           GT_1CLASS : 纯粹的Debug信息 
           GT_2CLASS : 由开发人员指定,告诉使用人员这这条信息可能有用 
           GT_3CLASS : 进入某个模块 
           GT_4CLASS : 由开发人员指定,告诉使用人员这是比较重要的信息 
           GT_5CLASS : 标记 
           GT_6CLASS : 警告 
           GT_7CLASS : 错误 

       不难理解,为什么我们要在调用GT_set时制定:snowwaft=01234567,这表示,对于snowwaft这个GT_Mask,我们关心的信息包括以上所有部分而0,则表示进入、退出某个函数的报告

Functions GT_STATUS cpssDxChPacketAnalyzerManagerCreate (IN GT_U32 managerId) Create Packet Trace Manager. GT_STATUS cpssDxChPacketAnalyzerManagerDelete (IN GT_U32 managerId) Delete Packet Trace Manager. GT_STATUS cpssDxChPacketAnalyzerManagerDeviceAdd (IN GT_U32 managerId, IN GT_U8 devNum) Add device to Packet Trace Manager. GT_STATUS cpssDxChPacketAnalyzerManagerDeviceRemove (IN GT_U32 managerId, IN GT_U8 devNum) Remove device from Packet Trace Manager. GT_STATUS cpssDxChPacketAnalyzerManagerEnableSet (IN GT_U32 managerId, IN GT_BOOL enable) Enable/Disable the packet analyzer on all devices added to manager id. GT_STATUS cpssDxChPacketAnalyzerManagerDevicesGet (IN GT_U32 managerId, OUT GT_BOOL *deviceStatePtr, INOUT GT_U32 *numOfDevicesPtr, OUT GT_U8 devicesArr[]) Get packet analyzer manager information. GT_STATUS cpssDxChPacketAnalyzerManagerResetToDefaults (IN GT_U32 managerId) Reset Packet Trace Manager configuration to default settings. GT_STATUS cpssDxChPacketAnalyzerFieldSizeGet (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldName, OUT GT_U32 *lengthPtr) Get packet analyzer field's size. GT_STATUS cpssDxChPacketAnalyzerLogicalKeyCreate (IN GT_U32 managerId, IN GT_U32 keyId, IN CPSS_DXCH_PACKET_ANALYZER_KEY_ATTRIBUTES_STC *keyAttrPtr, IN GT_U32 numOfStages, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stagesArr[], IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ASSIGNMENT_MODE_ENT fieldMode, IN GT_U32 numOfFields, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldsArr[]) Create logical key. GT_STATUS cpssDxChPacketAnalyzerLogicalKeyFieldsAdd (IN GT_U32 managerId, IN GT_U32 keyId, IN GT_U32 numOfFields, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldsArr[]) Add fields to existing logical key. GT_STATUS cpssDxChPacketAnalyzerLogicalKeyFieldsRemove (IN GT_U32 managerId, IN GT_U32 keyId, IN GT_U32 numOfFields, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldsArr[]) Remove fields from existing logical key. GT_STATUS cpssDxChPacketAnalyzerLogicalKeyDelete (IN GT_U32 managerId, IN GT_U32 keyId) Delete existing logical key. GT_STATUS cpssDxChPacketAnalyzerLogicalKeyInfoGet (IN GT_U32 managerId, IN GT_U32 keyId, OUT CPSS_DXCH_PACKET_ANALYZER_KEY_ATTRIBUTES_STC *keyAttrPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_ASSIGNMENT_MODE_ENT *fieldModePtr) Get existing logical key configuration. GT_STATUS cpssDxChPacketAnalyzerLogicalKeyStagesGet (IN GT_U32 managerId, IN GT_U32 keyId, INOUT GT_U32 *numOfStagesPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stagesArr[]) Get existing logical key stages list. GT_STATUS cpssDxChPacketAnalyzerLogicalKeyFieldsPerStageGet (IN GT_U32 managerId, IN GT_U32 keyId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, INOUT GT_U32 *numOfFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldsArr[]) Get existing logical key fields list per stage. GT_STATUS cpssDxChPacketAnalyzerStagesGet (IN GT_U32 managerId, INOUT GT_U32 *numOfApplicStagesPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT applicStagesListArr[], INOUT GT_U32 *numOfValidStagesPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT validStagesListArr[]) Get applicable stages and Valid stages - stages that are not muxed for current configuration. GT_STATUS cpssDxChPacketAnalyzerMuxStagesGet (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, INOUT GT_U32 *numOfMuxStagesPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT muxStagesListArr[]) Get mux stages array for specific stage. GT_STATUS cpssDxChPacketAnalyzerGroupCreate (IN GT_U32 managerId, IN GT_U32 groupId, IN CPSS_DXCH_PACKET_ANALYZER_GROUP_ATTRIBUTES_STC *groupAttrPtr) Create packet analyzer group. GT_STATUS cpssDxChPacketAnalyzerGroupDelete (IN GT_U32 managerId, IN GT_U32 groupId) Delete packet analyzer group. GT_STATUS cpssDxChPacketAnalyzerGroupRuleAdd (IN GT_U32 managerId, IN GT_U32 keyId, IN GT_U32 groupId, IN GT_U32 ruleId, IN CPSS_DXCH_PACKET_ANALYZER_RULE_ATTRIBUTES_STC *ruleAttrPtr, IN GT_U32 numOfFields, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_VALUE_STC fieldsValueArr[], IN GT_U32 actionId) Add packet analyzer rule to packet analyzer group. GT_STATUS cpssDxChPacketAnalyzerGroupRuleUpdate (IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, IN GT_U32 numOfFields, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_VALUE_STC fieldsValueArr[], IN GT_U32 actionId) Replace content of packet analyzer rule. GT_STATUS cpssDxChPacketAnalyzerGroupRuleDelete (IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId) Delete packet analyzer rule. GT_STATUS cpssDxChPacketAnalyzerGroupRuleGet (IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, OUT GT_U32 *keyIdPtr, OUT CPSS_DXCH_PACKET_ANALYZER_RULE_ATTRIBUTES_STC *ruleAttrPtr, INOUT GT_U32 *numOfFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_VALUE_STC fieldsValueArr[], OUT GT_U32 *actionIdPtr) Get packet analyzer rule attributes. GT_STATUS cpssDxChPacketAnalyzerActionCreate (IN GT_U32 managerId, IN GT_U32 actionId, IN CPSS_DXCH_PACKET_ANALYZER_ACTION_STC *actionPtr) Create packet analyzer action. GT_STATUS cpssDxChPacketAnalyzerActionUpdate (IN GT_U32 managerId, IN GT_U32 actionId, IN CPSS_DXCH_PACKET_ANALYZER_ACTION_STC *actionPtr) Update packet analyzer action. GT_STATUS cpssDxChPacketAnalyzerActionDelete (IN GT_U32 managerId, IN GT_U32 actionId) Delete packet analyzer action. GT_STATUS cpssDxChPacketAnalyzerActionGet (IN GT_U32 managerId, IN GT_U32 actionId, OUT CPSS_DXCH_PACKET_ANALYZER_ACTION_STC *actionPtr) Get packet analyzer action. GT_STATUS cpssDxChPacketAnalyzerSampledDataCountersClear (IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId) Clear Sampling Data and Counters for packet analyzer rule. GT_STATUS cpssDxChPacketAnalyzerActionSamplingEnableSet (IN GT_U32 managerId, IN GT_U32 actionId, IN GT_BOOL enable) Enable/disable sampling for packet analyzer action. GT_STATUS cpssDxChPacketAnalyzerGroupActivateEnableSet (IN GT_U32 managerId, IN GT_U32 groupId, IN GT_BOOL enable) Enable/disable packet analyzer group activation. GT_STATUS cpssDxChPacketAnalyzerRuleMatchStagesGet (IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, INOUT GT_U32 *numOfMatchedStagesPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT matchedStagesArr[]) Get stages where packet analyzer rule was matched. GT_STATUS cpssDxChPacketAnalyzerStageMatchDataGet (IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, OUT GT_U32 *numOfHitsPtr, INOUT GT_U32 *numOfSampleFieldsPtr, INOUT CPSS_DXCH_PACKET_ANALYZER_FIELD_VALUE_STC sampleFieldsValueArr[]) Get packet analyzer stage match attributes. GT_STATUS cpssDxChPacketAnalyzerStageMatchDataAllFieldsGet (IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, OUT GT_U32 *numOfHitsPtr, INOUT GT_U32 *numOfSampleFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_VALUE_STC sampleFieldsValueArr[]) Get packet analyzer stage match attributes for all packet analyzer fields. GT_STATUS cpssDxChPacketAnalyzerStageFieldsGet (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, INOUT GT_U32 *numOfFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldsArr[]) Get stage fields list array. GT_STATUS cpssDxChPacketAnalyzerStageMatchDataAllInternalFieldsGet (IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, OUT GT_U32 *numOfHitsPtr, INOUT GT_U32 *numOfSampleFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_INTERNAL_FIELD_VALUE_STC sampleFieldsValueArr[]) Get packet analyzer stage match attributes for all internal fields. GT_STATUS cpssDxChPacketAnalyzerStageMatchDataAllInternalFieldsByAttributesGet (IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, IN CPSS_DXCH_PACKET_ANALYZER_SEARCH_ATTRIBUTE_STC *searchAttributePtr, OUT GT_U32 *numOfHitsPtr, INOUT GT_U32 *numOfSampleFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_INTERNAL_FIELD_VALUE_STC sampleFieldsValueArr[]) Get packet analyzer stage match attributes for all internal fields by specific search attributes. GT_STATUS cpssDxChPacketAnalyzerFieldStagesGet (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldName, INOUT GT_U32 *numOfStagesPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stagesArr[]) Get field's stage list array. GT_STATUS cpssDxChPacketAnalyzerMuxStageBind (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId) Set stage that will be valid in group of muxed stages. GT_STATUS cpssDxChPacketAnalyzerMuxStageUnbind (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId) Set stage that will be invalid in group of muxed stages. GT_STATUS cpssDxChPacketAnalyzerUserDefinedFieldAdd (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_UDF_ATTRIBUTES_STC *udfAttrPtr, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_NAME_STC *fieldNamePtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT *udfIdPtr) Add packet analyzer user defined field. GT_STATUS cpssDxChPacketAnalyzerUserDefinedFieldDelete (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_UDF_ATTRIBUTES_STC *udfAttrPtr) Delete packet analyzer user defined field. GT_STATUS cpssDxChPacketAnalyzerUserDefinedFieldGet (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_UDF_ATTRIBUTES_STC *udfAttrPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT *udfIdPtr, OUT GT_BOOL *validPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_NAME_STC *fieldNamePtr) Get packet analyzer user defined field. GT_STATUS cpssDxChPacketAnalyzerUserDefinedFieldInfoGet (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT udfId, OUT GT_BOOL *validPtr, OUT CPSS_DXCH_PACKET_ANALYZER_UDF_ATTRIBUTES_STC *udfAttrPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_NAME_STC *fieldNamePtr) Get packet analyzer user defined field information. GT_STATUS cpssDxChPacketAnalyzerUserDefinedStageAdd (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_UDS_ATTRIBUTES_STC *udsAttrPtr, IN CPSS_DXCH_PACKET_ANALYZER_STAGE_INTERFACE_STC *interfaceAttrPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT *udsIdPtr) Add packet analyzer user defined stage. GT_STATUS cpssDxChPacketAnalyzerUserDefinedStageDelete (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_UDS_ATTRIBUTES_STC *udsAttrPtr) Delete packet analyzer user defined stage. GT_STATUS cpssDxChPacketAnalyzerUserDefinedStageGet (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_UDS_ATTRIBUTES_STC *udsAttrPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT *udsIdPtr, OUT GT_BOOL *validPtr, OUT CPSS_DXCH_PACKET_ANALYZER_STAGE_INTERFACE_STC *interfaceAttrPtr) Get packet analyzer user defined stage. GT_STATUS cpssDxChPacketAnalyzerUserDefinedStageInfoGet (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT udsId, OUT GT_BOOL *validPtr, OUT CPSS_DXCH_PACKET_ANALYZER_UDS_ATTRIBUTES_STC *udsAttrPtr, OUT CPSS_DXCH_PACKET_ANALYZER_STAGE_INTERFACE_STC *interfaceAttrPtr) Get packet analyzeruser defined stages information. GT_STATUS cpssDxChPacketAnalyzerRuleMatchDataAllFieldsByAttributeGet (IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, IN CPSS_DXCH_PACKET_ANALYZER_SEARCH_ATTRIBUTE_STC *searchAttributePtr, OUT GT_U32 *numOfHitsPtr, INOUT GT_U32 *numOfSampleFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_VALUE_STC sampleFieldsValueArr[]) Get packet analyzer rule match attributes for all packet analyzer fields by specific search attributes. GT_STATUS cpssDxChPacketAnalyzerStageFieldOverlappingFieldsGet (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldName, INOUT GT_U32 *numOfFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldsArr[]) Get packet analyzer overlapping fields for spesific field in stage. Detailed Description Packet Analyzer APIs for CPSS. Version 1 Function Documentation ◆ cpssDxChPacketAnalyzerActionCreate() GT_STATUS cpssDxChPacketAnalyzerActionCreate ( IN GT_U32 managerId, IN GT_U32 actionId, IN CPSS_DXCH_PACKET_ANALYZER_ACTION_STC * actionPtr ) Create packet analyzer action. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] actionId - action identification (APPLICABLE RANGES: 1..128) [in] actionPtr - (pointer to) action configuration Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_FOUND - not found action GT_BAD_PTR - on NULL pointer value GT_ALREADY_EXIST - already initialized GT_OUT_OF_CPU_MEM - Cpu memory allocation failed ◆ cpssDxChPacketAnalyzerActionDelete() GT_STATUS cpssDxChPacketAnalyzerActionDelete ( IN GT_U32 managerId, IN GT_U32 actionId ) Delete packet analyzer action. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] actionId - action identification (APPLICABLE RANGES: 1..128) Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_NOT_FOUND - not found action ◆ cpssDxChPacketAnalyzerActionGet() GT_STATUS cpssDxChPacketAnalyzerActionGet ( IN GT_U32 managerId, IN GT_U32 actionId, OUT CPSS_DXCH_PACKET_ANALYZER_ACTION_STC * actionPtr ) Get packet analyzer action. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] actionId - action identification (APPLICABLE RANGES: 1..128) [out] actionPtr - (pointer to) action configuration Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_FOUND - not found action ◆ cpssDxChPacketAnalyzerActionSamplingEnableSet() GT_STATUS cpssDxChPacketAnalyzerActionSamplingEnableSet ( IN GT_U32 managerId, IN GT_U32 actionId, IN GT_BOOL enable ) Enable/disable sampling for packet analyzer action. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] actionId - action identification (APPLICABLE RANGES: 1..128) [in] enable - enable/disable sampling Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_FOUND - on not found action ◆ cpssDxChPacketAnalyzerActionUpdate() GT_STATUS cpssDxChPacketAnalyzerActionUpdate ( IN GT_U32 managerId, IN GT_U32 actionId, IN CPSS_DXCH_PACKET_ANALYZER_ACTION_STC * actionPtr ) Update packet analyzer action. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] actionId - action identification (APPLICABLE RANGES: 1..128) [in] actionPtr - (pointer to) action configuration Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_FOUND - not found action GT_BAD_PTR - on NULL pointer value ◆ cpssDxChPacketAnalyzerFieldSizeGet() GT_STATUS cpssDxChPacketAnalyzerFieldSizeGet ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldName, OUT GT_U32 * lengthPtr ) Get packet analyzer field's size. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] fieldName - field name [out] lengthPtr - (pointer to) fields length in bits Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - not found manager ◆ cpssDxChPacketAnalyzerFieldStagesGet() GT_STATUS cpssDxChPacketAnalyzerFieldStagesGet ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldName, INOUT GT_U32 * numOfStagesPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stagesArr[] ) Get field's stage list array. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] fieldName - field name [in,out] numOfStagesPtr - in: (pointer to) allocated number of stages out: (pointer to) actual number of stages [out] stagesArr - (pointer to) field's stage list array Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - on not found manager ◆ cpssDxChPacketAnalyzerGroupActivateEnableSet() GT_STATUS cpssDxChPacketAnalyzerGroupActivateEnableSet ( IN GT_U32 managerId, IN GT_U32 groupId, IN GT_BOOL enable ) Enable/disable packet analyzer group activation. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) [in] enable - enable/disable group activation Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_INITIALIZED - if the driver was not initialized GT_HW_ERROR - on hardware error GT_NOT_FOUND - on not found group GT_BAD_STATE - on invalid parameter Note in order to see the results use APIs: cpssDxChPacketAnalyzerRuleMatchStagesGet,cpssDxChPacketAnalyzerRuleMatchDataGet, cpssDxChPacketAnalyzerRuleMatchDataAllFieldsGet ◆ cpssDxChPacketAnalyzerGroupCreate() GT_STATUS cpssDxChPacketAnalyzerGroupCreate ( IN GT_U32 managerId, IN GT_U32 groupId, IN CPSS_DXCH_PACKET_ANALYZER_GROUP_ATTRIBUTES_STC * groupAttrPtr ) Create packet analyzer group. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) [in] groupAttrPtr - (pointer to) group attributes Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_FOUND - not found action GT_BAD_PTR - on NULL pointer value GT_ALREADY_EXIST - already initialized GT_OUT_OF_CPU_MEM - Cpu memory allocation failed ◆ cpssDxChPacketAnalyzerGroupDelete() GT_STATUS cpssDxChPacketAnalyzerGroupDelete ( IN GT_U32 managerId, IN GT_U32 groupId ) Delete packet analyzer group. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_NOT_FOUND - not found group ◆ cpssDxChPacketAnalyzerGroupRuleAdd() GT_STATUS cpssDxChPacketAnalyzerGroupRuleAdd ( IN GT_U32 managerId, IN GT_U32 keyId, IN GT_U32 groupId, IN GT_U32 ruleId, IN CPSS_DXCH_PACKET_ANALYZER_RULE_ATTRIBUTES_STC * ruleAttrPtr, IN GT_U32 numOfFields, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_VALUE_STC fieldsValueArr[], IN GT_U32 actionId ) Add packet analyzer rule to packet analyzer group. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] keyId - logical key identification (APPLICABLE RANGES: 1..1024) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) [in] ruleId - rule identification (APPLICABLE RANGES: 1..2048) [in] ruleAttrPtr - (pointer to) rule attributes [in] numOfFields - number of fields for rule and group identification [in] fieldsValueArr - rule content array (Data and Mask) [in] actionId - rule action identification (APPLICABLE RANGES: 1..128) Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_FOUND - not found group or action GT_FULL - if array is full GT_ALREADY_EXIST - already initialized GT_OUT_OF_CPU_MEM - Cpu memory allocation failed ◆ cpssDxChPacketAnalyzerGroupRuleDelete() GT_STATUS cpssDxChPacketAnalyzerGroupRuleDelete ( IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId ) Delete packet analyzer rule. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] ruleId - rule identification (APPLICABLE RANGES: 1..2048) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_NOT_FOUND - not found group or rule GT_FAIL - on error ◆ cpssDxChPacketAnalyzerGroupRuleGet() GT_STATUS cpssDxChPacketAnalyzerGroupRuleGet ( IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, OUT GT_U32 * keyIdPtr, OUT CPSS_DXCH_PACKET_ANALYZER_RULE_ATTRIBUTES_STC * ruleAttrPtr, INOUT GT_U32 * numOfFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_VALUE_STC fieldsValueArr[], OUT GT_U32 * actionIdPtr ) Get packet analyzer rule attributes. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] ruleId - rule identification (APPLICABLE RANGES: 1..2048) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) [out] keyIdPtr - (pointer to) logical key identification [out] ruleAttrPtr - (pointer to) rule attributes [in,out] numOfFieldsPtr - in: (pointer to) allocated number of fields for rule identification out: (pointer to) actual number of fields for rule identification [out] fieldsValueArr - rule content array (Data and Mask) [out] actionIdPtr - (pointer to) rule action identification Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_FOUND - not found group or rule ◆ cpssDxChPacketAnalyzerGroupRuleUpdate() GT_STATUS cpssDxChPacketAnalyzerGroupRuleUpdate ( IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, IN GT_U32 numOfFields, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_VALUE_STC fieldsValueArr[], IN GT_U32 actionId ) Replace content of packet analyzer rule. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] ruleId - rule identification (APPLICABLE RANGES: 1..2048) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) [in] numOfFields - number of fields for rule and group identification [in] fieldsValueArr - rule content array (Data and Mask) [in] actionId - rule action identification (APPLICABLE RANGES: 1..128) Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_FOUND - not found group or action ◆ cpssDxChPacketAnalyzerLogicalKeyCreate() GT_STATUS cpssDxChPacketAnalyzerLogicalKeyCreate ( IN GT_U32 managerId, IN GT_U32 keyId, IN CPSS_DXCH_PACKET_ANALYZER_KEY_ATTRIBUTES_STC * keyAttrPtr, IN GT_U32 numOfStages, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stagesArr[], IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ASSIGNMENT_MODE_ENT fieldMode, IN GT_U32 numOfFields, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldsArr[] ) Create logical key. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] keyId - logical key identification (APPLICABLE RANGES: 1..1024) [in] keyAttrPtr - (pointer to) key attributes [in] numOfStages - number of stages [in] stagesArr - (pointer to) applicable stages list array [in] fieldMode - field mode assignment [in] numOfFields - number of fields [in] fieldsArr - (pointer to) fields list array Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_ALREADY_EXIST - already initialized GT_OUT_OF_CPU_MEM - Cpu memory allocation failed GT_NOT_FOUND - not found manager GT_FULL - if array is full Note in order to see the results use APIs: cpssDxChPacketAnalyzerLogicalKeyStagesGet, cpssDxChPacketAnalyzerLogicalKeyFieldsPerStageGet ◆ cpssDxChPacketAnalyzerLogicalKeyDelete() GT_STATUS cpssDxChPacketAnalyzerLogicalKeyDelete ( IN GT_U32 managerId, IN GT_U32 keyId ) Delete existing logical key. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] keyId - logical key identification (APPLICABLE RANGES: 1..1024) Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - on not found manager GT_BAD_STATE - on wrong state ◆ cpssDxChPacketAnalyzerLogicalKeyFieldsAdd() GT_STATUS cpssDxChPacketAnalyzerLogicalKeyFieldsAdd ( IN GT_U32 managerId, IN GT_U32 keyId, IN GT_U32 numOfFields, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldsArr[] ) Add fields to existing logical key. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] keyId - logical key identification (APPLICABLE RANGES: 1..1024) [in] numOfFields - number of fields [in] fieldsArr - (pointer to) fields list array Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - not found manager Note in order to see the results use APIs: cpssDxChPacketAnalyzerLogicalKeyStagesGet, cpssDxChPacketAnalyzerLogicalKeyFieldsPerStageGet ◆ cpssDxChPacketAnalyzerLogicalKeyFieldsPerStageGet() GT_STATUS cpssDxChPacketAnalyzerLogicalKeyFieldsPerStageGet ( IN GT_U32 managerId, IN GT_U32 keyId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, INOUT GT_U32 * numOfFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldsArr[] ) Get existing logical key fields list per stage. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] keyId - logical key identification [in] stagesId - stage identification [in,out] numOfFieldsPtr - in: (pointer to) allocated number of fields out: (pointer to) actual number of fields [out] fieldsArr - out: (pointer to) field list array Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_BAD_STATE - on wrong state ◆ cpssDxChPacketAnalyzerLogicalKeyFieldsRemove() GT_STATUS cpssDxChPacketAnalyzerLogicalKeyFieldsRemove ( IN GT_U32 managerId, IN GT_U32 keyId, IN GT_U32 numOfFields, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldsArr[] ) Remove fields from existing logical key. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] keyId - logical key identification (APPLICABLE RANGES: 1..1024) [in] numOfFields - number of fields [in] fieldsArr - (pointer to) fields list array Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - not found manager Note in order to see the results use APIs: cpssDxChPacketAnalyzerLogicalKeyStagesGet, cpssDxChPacketAnalyzerLogicalKeyFieldsPerStageGet ◆ cpssDxChPacketAnalyzerLogicalKeyInfoGet() GT_STATUS cpssDxChPacketAnalyzerLogicalKeyInfoGet ( IN GT_U32 managerId, IN GT_U32 keyId, OUT CPSS_DXCH_PACKET_ANALYZER_KEY_ATTRIBUTES_STC * keyAttrPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_ASSIGNMENT_MODE_ENT * fieldModePtr ) Get existing logical key configuration. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] keyId - logical key identification (APPLICABLE RANGES: 1..1024) [out] keyAttrPtr - (pointer to) key attributes [out] fieldModePtr - (pointer to) field Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - on not found manager GT_BAD_STATE - on wrong state ◆ cpssDxChPacketAnalyzerLogicalKeyStagesGet() GT_STATUS cpssDxChPacketAnalyzerLogicalKeyStagesGet ( IN GT_U32 managerId, IN GT_U32 keyId, INOUT GT_U32 * numOfStagesPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stagesArr[] ) Get existing logical key stages list. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] keyId - logical key identification (APPLICABLE RANGES: 1..1024) [in,out] numOfStagesPtr - in: (pointer to) allocated number of stages out: (pointer to) actual number of stages [out] stagesArr - out: (pointer to) stages list array Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - on not found manager GT_BAD_STATE - on wrong state ◆ cpssDxChPacketAnalyzerManagerCreate() GT_STATUS cpssDxChPacketAnalyzerManagerCreate ( IN GT_U32 managerId ) Create Packet Trace Manager. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_ALREADY_EXIST - already initialized GT_FAIL - on error GT_OUT_OF_CPU_MEM - Cpu memory allocation failed GT_BAD_PTR - on NULL pointer value. ◆ cpssDxChPacketAnalyzerManagerDelete() GT_STATUS cpssDxChPacketAnalyzerManagerDelete ( IN GT_U32 managerId ) Delete Packet Trace Manager. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - on not found manager GT_BAD_STATE - on invalid parameter ◆ cpssDxChPacketAnalyzerManagerDeviceAdd() GT_STATUS cpssDxChPacketAnalyzerManagerDeviceAdd ( IN GT_U32 managerId, IN GT_U8 devNum ) Add device to Packet Trace Manager. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] devNum - device number Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_ALREADY_EXIST - already initialized GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - on not found manager GT_FULL - if array is full ◆ cpssDxChPacketAnalyzerManagerDeviceRemove() GT_STATUS cpssDxChPacketAnalyzerManagerDeviceRemove ( IN GT_U32 managerId, IN GT_U8 devNum ) Remove device from Packet Trace Manager. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] devNum - device number Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - on not found manager GT_BAD_STATE - on invalid parameter ◆ cpssDxChPacketAnalyzerManagerDevicesGet() GT_STATUS cpssDxChPacketAnalyzerManagerDevicesGet ( IN GT_U32 managerId, OUT GT_BOOL * deviceStatePtr, INOUT GT_U32 * numOfDevicesPtr, OUT GT_U8 devicesArr[] ) Get packet analyzer manager information. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [out] deviceStatePtr - (pointer to) whether PA is enabled for manager id's devices [in,out] numOfDevicesPtr - in: (pointer to) allocated number of devices for managerId out: (pointer to) actual number of devices for managerId [out] devicesArr - devices array Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value GT_FAIL - on error GT_NOT_FOUND - on not found manager ◆ cpssDxChPacketAnalyzerManagerEnableSet() GT_STATUS cpssDxChPacketAnalyzerManagerEnableSet ( IN GT_U32 managerId, IN GT_BOOL enable ) Enable/Disable the packet analyzer on all devices added to manager id. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] enable - enable/disable PA on manager id Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_FOUND - on not found manager ◆ cpssDxChPacketAnalyzerManagerResetToDefaults() GT_STATUS cpssDxChPacketAnalyzerManagerResetToDefaults ( IN GT_U32 managerId ) Reset Packet Trace Manager configuration to default settings. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - on not found manager GT_BAD_STATE - on invalid parameter ◆ cpssDxChPacketAnalyzerMuxStageBind() GT_STATUS cpssDxChPacketAnalyzerMuxStageBind ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId ) Set stage that will be valid in group of muxed stages. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] stageId - stage identification Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - not found manager ◆ cpssDxChPacketAnalyzerMuxStagesGet() GT_STATUS cpssDxChPacketAnalyzerMuxStagesGet ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, INOUT GT_U32 * numOfMuxStagesPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT muxStagesListArr[] ) Get mux stages array for specific stage. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] stageId - stage identification [in,out] numOfMuxStagesPtr - in: (pointer to) allocated number of muxed stages out: (pointer to) actual number of muxed stages [out] muxStagesListArr - (pointer to) muxed stages list array Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - not found manager ◆ cpssDxChPacketAnalyzerMuxStageUnbind() GT_STATUS cpssDxChPacketAnalyzerMuxStageUnbind ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId ) Set stage that will be invalid in group of muxed stages. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] stageId - stage identification Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - not found manager ◆ cpssDxChPacketAnalyzerRuleMatchDataAllFieldsByAttributeGet() GT_STATUS cpssDxChPacketAnalyzerRuleMatchDataAllFieldsByAttributeGet ( IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, IN CPSS_DXCH_PACKET_ANALYZER_SEARCH_ATTRIBUTE_STC * searchAttributePtr, OUT GT_U32 * numOfHitsPtr, INOUT GT_U32 * numOfSampleFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_VALUE_STC sampleFieldsValueArr[] ) Get packet analyzer rule match attributes for all packet analyzer fields by specific search attributes. Note APPLICABLE DEVICES: Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; Aldrin; AC3X; Bobcat3; Aldrin2. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] ruleId - rule identification (APPLICABLE RANGES: 1..2048) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) [in] stageId - stage identification [in] searchAttributePtr -(pointer to) search attributes. [out] numOfHitsPtr - (pointer to) number of hits [in,out] numOfSampleFieldsPtr - in: (pointer to) allocated number of fields for sample data array out: (pointer to) actual number of fields for sample data array [out] sampleFieldsValueArr - out: (pointer to) sample data array values for requested fields Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_FOUND - on not found manager GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_SUPPORTED - on not supported parameter ◆ cpssDxChPacketAnalyzerRuleMatchStagesGet() GT_STATUS cpssDxChPacketAnalyzerRuleMatchStagesGet ( IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, INOUT GT_U32 * numOfMatchedStagesPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT matchedStagesArr[] ) Get stages where packet analyzer rule was matched. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] ruleId - rule identification (APPLICABLE RANGES: 1..2048) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) [in,out] numOfMatchedStagesPtr- in: (pointer to) allocated number of matched stages out: (pointer to) actual number of matched stages [out] matchedStagesArr - (pointer to) matched stages list array Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_FOUND - on not found manager GT_NOT_APPLICABLE_DEVICE - on not applicable device ◆ cpssDxChPacketAnalyzerSampledDataCountersClear() GT_STATUS cpssDxChPacketAnalyzerSampledDataCountersClear ( IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId ) Clear Sampling Data and Counters for packet analyzer rule. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] ruleId - rule identification (APPLICABLE RANGES: 1..2048) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_INITIALIZED - if the driver was not initialized GT_HW_ERROR - on hardware error GT_NOT_FOUND - on not found group ◆ cpssDxChPacketAnalyzerStageFieldOverlappingFieldsGet() GT_STATUS cpssDxChPacketAnalyzerStageFieldOverlappingFieldsGet ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldName, INOUT GT_U32 * numOfFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldsArr[] ) Get packet analyzer overlapping fields for spesific field in stage. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] stageId - stage identification [in] fieldName - field name [in,out] numOfFieldsPtr - in: (pointer to) allocated number of fields out: (pointer to) actual number of fields [out] fieldsArr - out: (pointer to) fields list array Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_FOUND - on not found manager GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_SUPPORTED - on not supported parameter ◆ cpssDxChPacketAnalyzerStageFieldsGet() GT_STATUS cpssDxChPacketAnalyzerStageFieldsGet ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, INOUT GT_U32 * numOfFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldsArr[] ) Get stage fields list array. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] stageId - stage identification [in,out] numOfFieldsPtr - in: (pointer to) allocated number of fields out: (pointer to) actual number of fields [out] fieldsArr - (pointer to) stage fields list array Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - on not found manager GT_NOT_SUPPORTED - on not supported parameter ◆ cpssDxChPacketAnalyzerStageMatchDataAllFieldsGet() GT_STATUS cpssDxChPacketAnalyzerStageMatchDataAllFieldsGet ( IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, OUT GT_U32 * numOfHitsPtr, INOUT GT_U32 * numOfSampleFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_VALUE_STC sampleFieldsValueArr[] ) Get packet analyzer stage match attributes for all packet analyzer fields. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] ruleId - rule identification (APPLICABLE RANGES: 1..2048) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) [in] stageId - stage identification [out] numOfHitsPtr - (pointer to) number of hits [in,out] numOfSampleFieldsPtr - in: (pointer to) allocated number of fields for sample data array out: (pointer to) actual number of fields for sample data array [out] sampleFieldsValueArr - out: (pointer to) sample data array values for requested fields Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_FOUND - on not found manager GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_SUPPORTED - on not supported parameter ◆ cpssDxChPacketAnalyzerStageMatchDataAllInternalFieldsByAttributesGet() GT_STATUS cpssDxChPacketAnalyzerStageMatchDataAllInternalFieldsByAttributesGet ( IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, IN CPSS_DXCH_PACKET_ANALYZER_SEARCH_ATTRIBUTE_STC * searchAttributePtr, OUT GT_U32 * numOfHitsPtr, INOUT GT_U32 * numOfSampleFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_INTERNAL_FIELD_VALUE_STC sampleFieldsValueArr[] ) Get packet analyzer stage match attributes for all internal fields by specific search attributes. Note APPLICABLE DEVICES: Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; Aldrin; AC3X; Bobcat3; Aldrin2. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] ruleId - rule identification (APPLICABLE RANGES: 1..2048) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) [in] stageId - stage identification [in] searchAttributePtr -(pointer to) search attributes. [out] numOfHitsPtr - (pointer to) number of hits [in,out] numOfSampleFieldsPtr - in: (pointer to) allocated number of fields for sample data array out: (pointer to) actual number of fields for sample data array [out] sampleFieldsValueArr - out: (pointer to) sample data array values for requested fields Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_FOUND - on not found manager GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_SUPPORTED - on not supported parameter ◆ cpssDxChPacketAnalyzerStageMatchDataAllInternalFieldsGet() GT_STATUS cpssDxChPacketAnalyzerStageMatchDataAllInternalFieldsGet ( IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, OUT GT_U32 * numOfHitsPtr, INOUT GT_U32 * numOfSampleFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_INTERNAL_FIELD_VALUE_STC sampleFieldsValueArr[] ) Get packet analyzer stage match attributes for all internal fields. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] ruleId - rule identification (APPLICABLE RANGES: 1..2048) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) [in] stageId - stage identification [out] numOfHitsPtr - (pointer to) number of hits [in,out] numOfSampleFieldsPtr - in: (pointer to) allocated number of fields for sample data array out: (pointer to) actual number of fields for sample data array [out] sampleFieldsValueArr - out: (pointer to) sample data array values for requested fields Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_FOUND - on not found manager GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_SUPPORTED - on not supported parameter ◆ cpssDxChPacketAnalyzerStageMatchDataGet() GT_STATUS cpssDxChPacketAnalyzerStageMatchDataGet ( IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, OUT GT_U32 * numOfHitsPtr, INOUT GT_U32 * numOfSampleFieldsPtr, INOUT CPSS_DXCH_PACKET_ANALYZER_FIELD_VALUE_STC sampleFieldsValueArr[] ) Get packet analyzer stage match attributes. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] ruleId - rule identification (APPLICABLE RANGES: 1..2048) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) [in] stageId - stage identification [out] numOfHitsPtr - (pointer to) number of hits [in,out] numOfSampleFieldsPtr - in: (pointer to) allocated number of fields for sample data array out: (pointer to) actual number of fields for sample data array [in,out] sampleFieldsValueArr - in: (pointer to) requested fields for sample data array out: (pointer to) sample data array values for requested fields Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_FOUND - on not found manager GT_NOT_APPLICABLE_DEVICE - on not applicable device ◆ cpssDxChPacketAnalyzerStagesGet() GT_STATUS cpssDxChPacketAnalyzerStagesGet ( IN GT_U32 managerId, INOUT GT_U32 * numOfApplicStagesPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT applicStagesListArr[], INOUT GT_U32 * numOfValidStagesPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT validStagesListArr[] ) Get applicable stages and Valid stages - stages that are not muxed for current configuration. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in,out] numOfApplicStagesPtr - in: (pointer to) size of allocated applicStagesListArr out: (pointer to) actual number of applicable stages in applicStagesListArr [out] applicStagesListArr - (pointer to) applicable stages list array [in,out] numOfValidStagesPtr - in: (pointer to) size of allocated ValidStagesListArr out: (pointer to) actual number of valid stages in ValidStagesListArr [out] ValidStagesListArr - (pointer to) valid stages list array Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - not found manager ◆ cpssDxChPacketAnalyzerUserDefinedFieldAdd() GT_STATUS cpssDxChPacketAnalyzerUserDefinedFieldAdd ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_UDF_ATTRIBUTES_STC * udfAttrPtr, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_NAME_STC * fieldNamePtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT * udfIdPtr ) Add packet analyzer user defined field. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] udfAttrPtr - (pointer to) udf attributes [in] fieldNamePtr - (pointer to) field name [out] udfIdPtr - (pointer to)user defined field identification. Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_INITIALIZED - if the driver was not initialized GT_NOT_FOUND - on not found parameters GT_ALREADY_EXIST - on already initialized ◆ cpssDxChPacketAnalyzerUserDefinedFieldDelete() GT_STATUS cpssDxChPacketAnalyzerUserDefinedFieldDelete ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_UDF_ATTRIBUTES_STC * udfAttrPtr ) Delete packet analyzer user defined field. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] udfAttrPtr - (pointer to) udf attributes Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_INITIALIZED - if the driver was not initialized GT_NOT_FOUND - on not found parameters ◆ cpssDxChPacketAnalyzerUserDefinedFieldGet() GT_STATUS cpssDxChPacketAnalyzerUserDefinedFieldGet ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_UDF_ATTRIBUTES_STC * udfAttrPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT * udfIdPtr, OUT GT_BOOL * validPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_NAME_STC * fieldNamePtr ) Get packet analyzer user defined field. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] udfAttrPtr - (pointer to) udf attributes [out] udfIdPtr - (pointer to) user defined field identification [out] validPtr - (pointer to) whether udf entry is valid or not [out] fieldNamePtr - (pointer to) field name Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_INITIALIZED - if the driver was not initialized GT_NOT_FOUND - on not found parameters ◆ cpssDxChPacketAnalyzerUserDefinedFieldInfoGet() GT_STATUS cpssDxChPacketAnalyzerUserDefinedFieldInfoGet ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT udfId, OUT GT_BOOL * validPtr, OUT CPSS_DXCH_PACKET_ANALYZER_UDF_ATTRIBUTES_STC * udfAttrPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_NAME_STC * fieldNamePtr ) Get packet analyzer user defined field information. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] udfId - user defined field identification [out] validPtr - (pointer to) whether udf entry is valid or not [out] udfAttrPtr - (pointer to) udf attributes. Valid only when validPtr == GT_TRUE [out] fieldNamePtr - (pointer to) field name. Valid only when validPtr == GT_TRUE Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_INITIALIZED - if the driver was not initialized GT_NOT_FOUND - on not found parameters ◆ cpssDxChPacketAnalyzerUserDefinedStageAdd() GT_STATUS cpssDxChPacketAnalyzerUserDefinedStageAdd ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_UDS_ATTRIBUTES_STC * udsAttrPtr, IN CPSS_DXCH_PACKET_ANALYZER_STAGE_INTERFACE_STC * interfaceAttrPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT * udsIdPtr ) Add packet analyzer user defined stage. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] udsAttrPtr - (pointer to) uds attributes [in] interfaceAttrPtr - (pointer to) interface attributes [out] udsIdPtr - (pointer to) user defined stage identification Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_INITIALIZED - if the driver was not initialized GT_NOT_FOUND - on not found parameters GT_ALREADY_EXIST - on already initialized ◆ cpssDxChPacketAnalyzerUserDefinedStageDelete() GT_STATUS cpssDxChPacketAnalyzerUserDefinedStageDelete ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_UDS_ATTRIBUTES_STC * udsAttrPtr ) Delete packet analyzer user defined stage. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] udsAttrPtr - (pointer to) uds attributes Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_INITIALIZED - if the driver was not initialized GT_NOT_FOUND - on not found parameters ◆ cpssDxChPacketAnalyzerUserDefinedStageGet() GT_STATUS cpssDxChPacketAnalyzerUserDefinedStageGet ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_UDS_ATTRIBUTES_STC * udsAttrPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT * udsIdPtr, OUT GT_BOOL * validPtr, OUT CPSS_DXCH_PACKET_ANALYZER_STAGE_INTERFACE_STC * interfaceAttrPtr ) Get packet analyzer user defined stage. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] udsAttrPtr - (pointer to) uds attributes [out] udsIdPtr - (pointer to) user defined stage identification [out] validPtr - (pointer to) whether uds entry is valid or not [out] interfaceAttrPtr - (pointer to) interface attributes. Valid only when validPtr == GT_TRUE Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_INITIALIZED - if the driver was not initialized GT_NOT_FOUND - on not found parameters ◆ cpssDxChPacketAnalyzerUserDefinedStageInfoGet() GT_STATUS cpssDxChPacketAnalyzerUserDefinedStageInfoGet ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT udsId, OUT GT_BOOL * validPtr, OUT CPSS_DXCH_PACKET_ANALYZER_UDS_ATTRIBUTES_STC * udsAttrPtr, OUT CPSS_DXCH_PACKET_ANALYZER_STAGE_INTERFACE_STC * interfaceAttrPtr ) Get packet analyzeruser defined stages information. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] udsId - user defined stage identification [out] validPtr - (pointer to) whether uds entry is valid or not [out] udsAttrPtr - (pointer to) uds attributes. Valid only when validPtr == GT_TRUE [out] interfaceAttrPtr - (pointer to) interface attributes. Valid only when validPtr == GT_TRUE Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_INITIALIZED - if the driver was not initialized GT_NOT_FOUND - on not found parameters 其中是否有用于报文数量统计的函数
09-24
cpssDxChPacketAnalyzer.h File Reference Packet Analyzer APIs for CPSS. More... #include <cpss/common/cpssTypes.h&gt; #include <cpss/dxCh/dxChxGen/packetAnalyzer/cpssDxChPacketAnalyzerTypes.h&gt; #include <cpssDriver/pp/prvCpssDrvPpDefs.h&gt; Functions GT_STATUS cpssDxChPacketAnalyzerManagerCreate (IN GT_U32 managerId) Create Packet Trace Manager. GT_STATUS cpssDxChPacketAnalyzerManagerDelete (IN GT_U32 managerId) Delete Packet Trace Manager. GT_STATUS cpssDxChPacketAnalyzerManagerDeviceAdd (IN GT_U32 managerId, IN GT_U8 devNum) Add device to Packet Trace Manager. GT_STATUS cpssDxChPacketAnalyzerManagerDeviceRemove (IN GT_U32 managerId, IN GT_U8 devNum) Remove device from Packet Trace Manager. GT_STATUS cpssDxChPacketAnalyzerManagerEnableSet (IN GT_U32 managerId, IN GT_BOOL enable) Enable/Disable the packet analyzer on all devices added to manager id. GT_STATUS cpssDxChPacketAnalyzerManagerDevicesGet (IN GT_U32 managerId, OUT GT_BOOL *deviceStatePtr, INOUT GT_U32 *numOfDevicesPtr, OUT GT_U8 devicesArr[]) Get packet analyzer manager information. GT_STATUS cpssDxChPacketAnalyzerManagerResetToDefaults (IN GT_U32 managerId) Reset Packet Trace Manager configuration to default settings. GT_STATUS cpssDxChPacketAnalyzerFieldSizeGet (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldName, OUT GT_U32 *lengthPtr) Get packet analyzer field's size. GT_STATUS cpssDxChPacketAnalyzerLogicalKeyCreate (IN GT_U32 managerId, IN GT_U32 keyId, IN CPSS_DXCH_PACKET_ANALYZER_KEY_ATTRIBUTES_STC *keyAttrPtr, IN GT_U32 numOfStages, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stagesArr[], IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ASSIGNMENT_MODE_ENT fieldMode, IN GT_U32 numOfFields, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldsArr[]) Create logical key. GT_STATUS cpssDxChPacketAnalyzerLogicalKeyFieldsAdd (IN GT_U32 managerId, IN GT_U32 keyId, IN GT_U32 numOfFields, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldsArr[]) Add fields to existing logical key. GT_STATUS cpssDxChPacketAnalyzerLogicalKeyFieldsRemove (IN GT_U32 managerId, IN GT_U32 keyId, IN GT_U32 numOfFields, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldsArr[]) Remove fields from existing logical key. GT_STATUS cpssDxChPacketAnalyzerLogicalKeyDelete (IN GT_U32 managerId, IN GT_U32 keyId) Delete existing logical key. GT_STATUS cpssDxChPacketAnalyzerLogicalKeyInfoGet (IN GT_U32 managerId, IN GT_U32 keyId, OUT CPSS_DXCH_PACKET_ANALYZER_KEY_ATTRIBUTES_STC *keyAttrPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_ASSIGNMENT_MODE_ENT *fieldModePtr) Get existing logical key configuration. GT_STATUS cpssDxChPacketAnalyzerLogicalKeyStagesGet (IN GT_U32 managerId, IN GT_U32 keyId, INOUT GT_U32 *numOfStagesPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stagesArr[]) Get existing logical key stages list. GT_STATUS cpssDxChPacketAnalyzerLogicalKeyFieldsPerStageGet (IN GT_U32 managerId, IN GT_U32 keyId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, INOUT GT_U32 *numOfFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldsArr[]) Get existing logical key fields list per stage. GT_STATUS cpssDxChPacketAnalyzerStagesGet (IN GT_U32 managerId, INOUT GT_U32 *numOfApplicStagesPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT applicStagesListArr[], INOUT GT_U32 *numOfValidStagesPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT validStagesListArr[]) Get applicable stages and Valid stages - stages that are not muxed for current configuration. GT_STATUS cpssDxChPacketAnalyzerMuxStagesGet (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, INOUT GT_U32 *numOfMuxStagesPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT muxStagesListArr[]) Get mux stages array for specific stage. GT_STATUS cpssDxChPacketAnalyzerGroupCreate (IN GT_U32 managerId, IN GT_U32 groupId, IN CPSS_DXCH_PACKET_ANALYZER_GROUP_ATTRIBUTES_STC *groupAttrPtr) Create packet analyzer group. GT_STATUS cpssDxChPacketAnalyzerGroupDelete (IN GT_U32 managerId, IN GT_U32 groupId) Delete packet analyzer group. GT_STATUS cpssDxChPacketAnalyzerGroupRuleAdd (IN GT_U32 managerId, IN GT_U32 keyId, IN GT_U32 groupId, IN GT_U32 ruleId, IN CPSS_DXCH_PACKET_ANALYZER_RULE_ATTRIBUTES_STC *ruleAttrPtr, IN GT_U32 numOfFields, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_VALUE_STC fieldsValueArr[], IN GT_U32 actionId) Add packet analyzer rule to packet analyzer group. GT_STATUS cpssDxChPacketAnalyzerGroupRuleUpdate (IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, IN GT_U32 numOfFields, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_VALUE_STC fieldsValueArr[], IN GT_U32 actionId) Replace content of packet analyzer rule. GT_STATUS cpssDxChPacketAnalyzerGroupRuleDelete (IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId) Delete packet analyzer rule. GT_STATUS cpssDxChPacketAnalyzerGroupRuleGet (IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, OUT GT_U32 *keyIdPtr, OUT CPSS_DXCH_PACKET_ANALYZER_RULE_ATTRIBUTES_STC *ruleAttrPtr, INOUT GT_U32 *numOfFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_VALUE_STC fieldsValueArr[], OUT GT_U32 *actionIdPtr) Get packet analyzer rule attributes. GT_STATUS cpssDxChPacketAnalyzerActionCreate (IN GT_U32 managerId, IN GT_U32 actionId, IN CPSS_DXCH_PACKET_ANALYZER_ACTION_STC *actionPtr) Create packet analyzer action. GT_STATUS cpssDxChPacketAnalyzerActionUpdate (IN GT_U32 managerId, IN GT_U32 actionId, IN CPSS_DXCH_PACKET_ANALYZER_ACTION_STC *actionPtr) Update packet analyzer action. GT_STATUS cpssDxChPacketAnalyzerActionDelete (IN GT_U32 managerId, IN GT_U32 actionId) Delete packet analyzer action. GT_STATUS cpssDxChPacketAnalyzerActionGet (IN GT_U32 managerId, IN GT_U32 actionId, OUT CPSS_DXCH_PACKET_ANALYZER_ACTION_STC *actionPtr) Get packet analyzer action. GT_STATUS cpssDxChPacketAnalyzerSampledDataCountersClear (IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId) Clear Sampling Data and Counters for packet analyzer rule. GT_STATUS cpssDxChPacketAnalyzerActionSamplingEnableSet (IN GT_U32 managerId, IN GT_U32 actionId, IN GT_BOOL enable) Enable/disable sampling for packet analyzer action. GT_STATUS cpssDxChPacketAnalyzerGroupActivateEnableSet (IN GT_U32 managerId, IN GT_U32 groupId, IN GT_BOOL enable) Enable/disable packet analyzer group activation. GT_STATUS cpssDxChPacketAnalyzerRuleMatchStagesGet (IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, INOUT GT_U32 *numOfMatchedStagesPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT matchedStagesArr[]) Get stages where packet analyzer rule was matched. GT_STATUS cpssDxChPacketAnalyzerStageMatchDataGet (IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, OUT GT_U32 *numOfHitsPtr, INOUT GT_U32 *numOfSampleFieldsPtr, INOUT CPSS_DXCH_PACKET_ANALYZER_FIELD_VALUE_STC sampleFieldsValueArr[]) Get packet analyzer stage match attributes. GT_STATUS cpssDxChPacketAnalyzerStageMatchDataAllFieldsGet (IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, OUT GT_U32 *numOfHitsPtr, INOUT GT_U32 *numOfSampleFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_VALUE_STC sampleFieldsValueArr[]) Get packet analyzer stage match attributes for all packet analyzer fields. GT_STATUS cpssDxChPacketAnalyzerStageFieldsGet (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, INOUT GT_U32 *numOfFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldsArr[]) Get stage fields list array. GT_STATUS cpssDxChPacketAnalyzerStageMatchDataAllInternalFieldsGet (IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, OUT GT_U32 *numOfHitsPtr, INOUT GT_U32 *numOfSampleFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_INTERNAL_FIELD_VALUE_STC sampleFieldsValueArr[]) Get packet analyzer stage match attributes for all internal fields. GT_STATUS cpssDxChPacketAnalyzerStageMatchDataAllInternalFieldsByAttributesGet (IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, IN CPSS_DXCH_PACKET_ANALYZER_SEARCH_ATTRIBUTE_STC *searchAttributePtr, OUT GT_U32 *numOfHitsPtr, INOUT GT_U32 *numOfSampleFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_INTERNAL_FIELD_VALUE_STC sampleFieldsValueArr[]) Get packet analyzer stage match attributes for all internal fields by specific search attributes. GT_STATUS cpssDxChPacketAnalyzerFieldStagesGet (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldName, INOUT GT_U32 *numOfStagesPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stagesArr[]) Get field's stage list array. GT_STATUS cpssDxChPacketAnalyzerMuxStageBind (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId) Set stage that will be valid in group of muxed stages. GT_STATUS cpssDxChPacketAnalyzerMuxStageUnbind (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId) Set stage that will be invalid in group of muxed stages. GT_STATUS cpssDxChPacketAnalyzerUserDefinedFieldAdd (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_UDF_ATTRIBUTES_STC *udfAttrPtr, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_NAME_STC *fieldNamePtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT *udfIdPtr) Add packet analyzer user defined field. GT_STATUS cpssDxChPacketAnalyzerUserDefinedFieldDelete (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_UDF_ATTRIBUTES_STC *udfAttrPtr) Delete packet analyzer user defined field. GT_STATUS cpssDxChPacketAnalyzerUserDefinedFieldGet (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_UDF_ATTRIBUTES_STC *udfAttrPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT *udfIdPtr, OUT GT_BOOL *validPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_NAME_STC *fieldNamePtr) Get packet analyzer user defined field. GT_STATUS cpssDxChPacketAnalyzerUserDefinedFieldInfoGet (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT udfId, OUT GT_BOOL *validPtr, OUT CPSS_DXCH_PACKET_ANALYZER_UDF_ATTRIBUTES_STC *udfAttrPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_NAME_STC *fieldNamePtr) Get packet analyzer user defined field information. GT_STATUS cpssDxChPacketAnalyzerUserDefinedStageAdd (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_UDS_ATTRIBUTES_STC *udsAttrPtr, IN CPSS_DXCH_PACKET_ANALYZER_STAGE_INTERFACE_STC *interfaceAttrPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT *udsIdPtr) Add packet analyzer user defined stage. GT_STATUS cpssDxChPacketAnalyzerUserDefinedStageDelete (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_UDS_ATTRIBUTES_STC *udsAttrPtr) Delete packet analyzer user defined stage. GT_STATUS cpssDxChPacketAnalyzerUserDefinedStageGet (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_UDS_ATTRIBUTES_STC *udsAttrPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT *udsIdPtr, OUT GT_BOOL *validPtr, OUT CPSS_DXCH_PACKET_ANALYZER_STAGE_INTERFACE_STC *interfaceAttrPtr) Get packet analyzer user defined stage. GT_STATUS cpssDxChPacketAnalyzerUserDefinedStageInfoGet (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT udsId, OUT GT_BOOL *validPtr, OUT CPSS_DXCH_PACKET_ANALYZER_UDS_ATTRIBUTES_STC *udsAttrPtr, OUT CPSS_DXCH_PACKET_ANALYZER_STAGE_INTERFACE_STC *interfaceAttrPtr) Get packet analyzeruser defined stages information. GT_STATUS cpssDxChPacketAnalyzerRuleMatchDataAllFieldsByAttributeGet (IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, IN CPSS_DXCH_PACKET_ANALYZER_SEARCH_ATTRIBUTE_STC *searchAttributePtr, OUT GT_U32 *numOfHitsPtr, INOUT GT_U32 *numOfSampleFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_VALUE_STC sampleFieldsValueArr[]) Get packet analyzer rule match attributes for all packet analyzer fields by specific search attributes. GT_STATUS cpssDxChPacketAnalyzerStageFieldOverlappingFieldsGet (IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldName, INOUT GT_U32 *numOfFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldsArr[]) Get packet analyzer overlapping fields for spesific field in stage. Detailed Description Packet Analyzer APIs for CPSS. Version 1 Function Documentation ◆ cpssDxChPacketAnalyzerActionCreate() GT_STATUS cpssDxChPacketAnalyzerActionCreate ( IN GT_U32 managerId, IN GT_U32 actionId, IN CPSS_DXCH_PACKET_ANALYZER_ACTION_STC * actionPtr ) Create packet analyzer action. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] actionId - action identification (APPLICABLE RANGES: 1..128) [in] actionPtr - (pointer to) action configuration Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_FOUND - not found action GT_BAD_PTR - on NULL pointer value GT_ALREADY_EXIST - already initialized GT_OUT_OF_CPU_MEM - Cpu memory allocation failed ◆ cpssDxChPacketAnalyzerActionDelete() GT_STATUS cpssDxChPacketAnalyzerActionDelete ( IN GT_U32 managerId, IN GT_U32 actionId ) Delete packet analyzer action. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] actionId - action identification (APPLICABLE RANGES: 1..128) Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_NOT_FOUND - not found action ◆ cpssDxChPacketAnalyzerActionGet() GT_STATUS cpssDxChPacketAnalyzerActionGet ( IN GT_U32 managerId, IN GT_U32 actionId, OUT CPSS_DXCH_PACKET_ANALYZER_ACTION_STC * actionPtr ) Get packet analyzer action. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] actionId - action identification (APPLICABLE RANGES: 1..128) [out] actionPtr - (pointer to) action configuration Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_FOUND - not found action ◆ cpssDxChPacketAnalyzerActionSamplingEnableSet() GT_STATUS cpssDxChPacketAnalyzerActionSamplingEnableSet ( IN GT_U32 managerId, IN GT_U32 actionId, IN GT_BOOL enable ) Enable/disable sampling for packet analyzer action. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] actionId - action identification (APPLICABLE RANGES: 1..128) [in] enable - enable/disable sampling Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_FOUND - on not found action ◆ cpssDxChPacketAnalyzerActionUpdate() GT_STATUS cpssDxChPacketAnalyzerActionUpdate ( IN GT_U32 managerId, IN GT_U32 actionId, IN CPSS_DXCH_PACKET_ANALYZER_ACTION_STC * actionPtr ) Update packet analyzer action. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] actionId - action identification (APPLICABLE RANGES: 1..128) [in] actionPtr - (pointer to) action configuration Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_FOUND - not found action GT_BAD_PTR - on NULL pointer value ◆ cpssDxChPacketAnalyzerFieldSizeGet() GT_STATUS cpssDxChPacketAnalyzerFieldSizeGet ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldName, OUT GT_U32 * lengthPtr ) Get packet analyzer field's size. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] fieldName - field name [out] lengthPtr - (pointer to) fields length in bits Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - not found manager ◆ cpssDxChPacketAnalyzerFieldStagesGet() GT_STATUS cpssDxChPacketAnalyzerFieldStagesGet ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldName, INOUT GT_U32 * numOfStagesPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stagesArr[] ) Get field's stage list array. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] fieldName - field name [in,out] numOfStagesPtr - in: (pointer to) allocated number of stages out: (pointer to) actual number of stages [out] stagesArr - (pointer to) field's stage list array Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - on not found manager ◆ cpssDxChPacketAnalyzerGroupActivateEnableSet() GT_STATUS cpssDxChPacketAnalyzerGroupActivateEnableSet ( IN GT_U32 managerId, IN GT_U32 groupId, IN GT_BOOL enable ) Enable/disable packet analyzer group activation. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) [in] enable - enable/disable group activation Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_INITIALIZED - if the driver was not initialized GT_HW_ERROR - on hardware error GT_NOT_FOUND - on not found group GT_BAD_STATE - on invalid parameter Note in order to see the results use APIs: cpssDxChPacketAnalyzerRuleMatchStagesGet,cpssDxChPacketAnalyzerRuleMatchDataGet, cpssDxChPacketAnalyzerRuleMatchDataAllFieldsGet ◆ cpssDxChPacketAnalyzerGroupCreate() GT_STATUS cpssDxChPacketAnalyzerGroupCreate ( IN GT_U32 managerId, IN GT_U32 groupId, IN CPSS_DXCH_PACKET_ANALYZER_GROUP_ATTRIBUTES_STC * groupAttrPtr ) Create packet analyzer group. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) [in] groupAttrPtr - (pointer to) group attributes Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_FOUND - not found action GT_BAD_PTR - on NULL pointer value GT_ALREADY_EXIST - already initialized GT_OUT_OF_CPU_MEM - Cpu memory allocation failed ◆ cpssDxChPacketAnalyzerGroupDelete() GT_STATUS cpssDxChPacketAnalyzerGroupDelete ( IN GT_U32 managerId, IN GT_U32 groupId ) Delete packet analyzer group. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_NOT_FOUND - not found group ◆ cpssDxChPacketAnalyzerGroupRuleAdd() GT_STATUS cpssDxChPacketAnalyzerGroupRuleAdd ( IN GT_U32 managerId, IN GT_U32 keyId, IN GT_U32 groupId, IN GT_U32 ruleId, IN CPSS_DXCH_PACKET_ANALYZER_RULE_ATTRIBUTES_STC * ruleAttrPtr, IN GT_U32 numOfFields, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_VALUE_STC fieldsValueArr[], IN GT_U32 actionId ) Add packet analyzer rule to packet analyzer group. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] keyId - logical key identification (APPLICABLE RANGES: 1..1024) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) [in] ruleId - rule identification (APPLICABLE RANGES: 1..2048) [in] ruleAttrPtr - (pointer to) rule attributes [in] numOfFields - number of fields for rule and group identification [in] fieldsValueArr - rule content array (Data and Mask) [in] actionId - rule action identification (APPLICABLE RANGES: 1..128) Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_FOUND - not found group or action GT_FULL - if array is full GT_ALREADY_EXIST - already initialized GT_OUT_OF_CPU_MEM - Cpu memory allocation failed ◆ cpssDxChPacketAnalyzerGroupRuleDelete() GT_STATUS cpssDxChPacketAnalyzerGroupRuleDelete ( IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId ) Delete packet analyzer rule. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] ruleId - rule identification (APPLICABLE RANGES: 1..2048) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_NOT_FOUND - not found group or rule GT_FAIL - on error ◆ cpssDxChPacketAnalyzerGroupRuleGet() GT_STATUS cpssDxChPacketAnalyzerGroupRuleGet ( IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, OUT GT_U32 * keyIdPtr, OUT CPSS_DXCH_PACKET_ANALYZER_RULE_ATTRIBUTES_STC * ruleAttrPtr, INOUT GT_U32 * numOfFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_VALUE_STC fieldsValueArr[], OUT GT_U32 * actionIdPtr ) Get packet analyzer rule attributes. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] ruleId - rule identification (APPLICABLE RANGES: 1..2048) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) [out] keyIdPtr - (pointer to) logical key identification [out] ruleAttrPtr - (pointer to) rule attributes [in,out] numOfFieldsPtr - in: (pointer to) allocated number of fields for rule identification out: (pointer to) actual number of fields for rule identification [out] fieldsValueArr - rule content array (Data and Mask) [out] actionIdPtr - (pointer to) rule action identification Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_FOUND - not found group or rule ◆ cpssDxChPacketAnalyzerGroupRuleUpdate() GT_STATUS cpssDxChPacketAnalyzerGroupRuleUpdate ( IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, IN GT_U32 numOfFields, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_VALUE_STC fieldsValueArr[], IN GT_U32 actionId ) Replace content of packet analyzer rule. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] ruleId - rule identification (APPLICABLE RANGES: 1..2048) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) [in] numOfFields - number of fields for rule and group identification [in] fieldsValueArr - rule content array (Data and Mask) [in] actionId - rule action identification (APPLICABLE RANGES: 1..128) Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_FOUND - not found group or action ◆ cpssDxChPacketAnalyzerLogicalKeyCreate() GT_STATUS cpssDxChPacketAnalyzerLogicalKeyCreate ( IN GT_U32 managerId, IN GT_U32 keyId, IN CPSS_DXCH_PACKET_ANALYZER_KEY_ATTRIBUTES_STC * keyAttrPtr, IN GT_U32 numOfStages, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stagesArr[], IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ASSIGNMENT_MODE_ENT fieldMode, IN GT_U32 numOfFields, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldsArr[] ) Create logical key. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] keyId - logical key identification (APPLICABLE RANGES: 1..1024) [in] keyAttrPtr - (pointer to) key attributes [in] numOfStages - number of stages [in] stagesArr - (pointer to) applicable stages list array [in] fieldMode - field mode assignment [in] numOfFields - number of fields [in] fieldsArr - (pointer to) fields list array Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_ALREADY_EXIST - already initialized GT_OUT_OF_CPU_MEM - Cpu memory allocation failed GT_NOT_FOUND - not found manager GT_FULL - if array is full Note in order to see the results use APIs: cpssDxChPacketAnalyzerLogicalKeyStagesGet, cpssDxChPacketAnalyzerLogicalKeyFieldsPerStageGet ◆ cpssDxChPacketAnalyzerLogicalKeyDelete() GT_STATUS cpssDxChPacketAnalyzerLogicalKeyDelete ( IN GT_U32 managerId, IN GT_U32 keyId ) Delete existing logical key. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] keyId - logical key identification (APPLICABLE RANGES: 1..1024) Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - on not found manager GT_BAD_STATE - on wrong state ◆ cpssDxChPacketAnalyzerLogicalKeyFieldsAdd() GT_STATUS cpssDxChPacketAnalyzerLogicalKeyFieldsAdd ( IN GT_U32 managerId, IN GT_U32 keyId, IN GT_U32 numOfFields, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldsArr[] ) Add fields to existing logical key. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] keyId - logical key identification (APPLICABLE RANGES: 1..1024) [in] numOfFields - number of fields [in] fieldsArr - (pointer to) fields list array Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - not found manager Note in order to see the results use APIs: cpssDxChPacketAnalyzerLogicalKeyStagesGet, cpssDxChPacketAnalyzerLogicalKeyFieldsPerStageGet ◆ cpssDxChPacketAnalyzerLogicalKeyFieldsPerStageGet() GT_STATUS cpssDxChPacketAnalyzerLogicalKeyFieldsPerStageGet ( IN GT_U32 managerId, IN GT_U32 keyId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, INOUT GT_U32 * numOfFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldsArr[] ) Get existing logical key fields list per stage. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] keyId - logical key identification [in] stagesId - stage identification [in,out] numOfFieldsPtr - in: (pointer to) allocated number of fields out: (pointer to) actual number of fields [out] fieldsArr - out: (pointer to) field list array Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_BAD_STATE - on wrong state ◆ cpssDxChPacketAnalyzerLogicalKeyFieldsRemove() GT_STATUS cpssDxChPacketAnalyzerLogicalKeyFieldsRemove ( IN GT_U32 managerId, IN GT_U32 keyId, IN GT_U32 numOfFields, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldsArr[] ) Remove fields from existing logical key. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] keyId - logical key identification (APPLICABLE RANGES: 1..1024) [in] numOfFields - number of fields [in] fieldsArr - (pointer to) fields list array Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - not found manager Note in order to see the results use APIs: cpssDxChPacketAnalyzerLogicalKeyStagesGet, cpssDxChPacketAnalyzerLogicalKeyFieldsPerStageGet ◆ cpssDxChPacketAnalyzerLogicalKeyInfoGet() GT_STATUS cpssDxChPacketAnalyzerLogicalKeyInfoGet ( IN GT_U32 managerId, IN GT_U32 keyId, OUT CPSS_DXCH_PACKET_ANALYZER_KEY_ATTRIBUTES_STC * keyAttrPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_ASSIGNMENT_MODE_ENT * fieldModePtr ) Get existing logical key configuration. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] keyId - logical key identification (APPLICABLE RANGES: 1..1024) [out] keyAttrPtr - (pointer to) key attributes [out] fieldModePtr - (pointer to) field Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - on not found manager GT_BAD_STATE - on wrong state ◆ cpssDxChPacketAnalyzerLogicalKeyStagesGet() GT_STATUS cpssDxChPacketAnalyzerLogicalKeyStagesGet ( IN GT_U32 managerId, IN GT_U32 keyId, INOUT GT_U32 * numOfStagesPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stagesArr[] ) Get existing logical key stages list. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] keyId - logical key identification (APPLICABLE RANGES: 1..1024) [in,out] numOfStagesPtr - in: (pointer to) allocated number of stages out: (pointer to) actual number of stages [out] stagesArr - out: (pointer to) stages list array Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - on not found manager GT_BAD_STATE - on wrong state ◆ cpssDxChPacketAnalyzerManagerCreate() GT_STATUS cpssDxChPacketAnalyzerManagerCreate ( IN GT_U32 managerId ) Create Packet Trace Manager. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_ALREADY_EXIST - already initialized GT_FAIL - on error GT_OUT_OF_CPU_MEM - Cpu memory allocation failed GT_BAD_PTR - on NULL pointer value. ◆ cpssDxChPacketAnalyzerManagerDelete() GT_STATUS cpssDxChPacketAnalyzerManagerDelete ( IN GT_U32 managerId ) Delete Packet Trace Manager. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - on not found manager GT_BAD_STATE - on invalid parameter ◆ cpssDxChPacketAnalyzerManagerDeviceAdd() GT_STATUS cpssDxChPacketAnalyzerManagerDeviceAdd ( IN GT_U32 managerId, IN GT_U8 devNum ) Add device to Packet Trace Manager. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] devNum - device number Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_ALREADY_EXIST - already initialized GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - on not found manager GT_FULL - if array is full ◆ cpssDxChPacketAnalyzerManagerDeviceRemove() GT_STATUS cpssDxChPacketAnalyzerManagerDeviceRemove ( IN GT_U32 managerId, IN GT_U8 devNum ) Remove device from Packet Trace Manager. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] devNum - device number Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - on not found manager GT_BAD_STATE - on invalid parameter ◆ cpssDxChPacketAnalyzerManagerDevicesGet() GT_STATUS cpssDxChPacketAnalyzerManagerDevicesGet ( IN GT_U32 managerId, OUT GT_BOOL * deviceStatePtr, INOUT GT_U32 * numOfDevicesPtr, OUT GT_U8 devicesArr[] ) Get packet analyzer manager information. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [out] deviceStatePtr - (pointer to) whether PA is enabled for manager id's devices [in,out] numOfDevicesPtr - in: (pointer to) allocated number of devices for managerId out: (pointer to) actual number of devices for managerId [out] devicesArr - devices array Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value GT_FAIL - on error GT_NOT_FOUND - on not found manager ◆ cpssDxChPacketAnalyzerManagerEnableSet() GT_STATUS cpssDxChPacketAnalyzerManagerEnableSet ( IN GT_U32 managerId, IN GT_BOOL enable ) Enable/Disable the packet analyzer on all devices added to manager id. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] enable - enable/disable PA on manager id Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_FOUND - on not found manager ◆ cpssDxChPacketAnalyzerManagerResetToDefaults() GT_STATUS cpssDxChPacketAnalyzerManagerResetToDefaults ( IN GT_U32 managerId ) Reset Packet Trace Manager configuration to default settings. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - on not found manager GT_BAD_STATE - on invalid parameter ◆ cpssDxChPacketAnalyzerMuxStageBind() GT_STATUS cpssDxChPacketAnalyzerMuxStageBind ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId ) Set stage that will be valid in group of muxed stages. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] stageId - stage identification Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - not found manager ◆ cpssDxChPacketAnalyzerMuxStagesGet() GT_STATUS cpssDxChPacketAnalyzerMuxStagesGet ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, INOUT GT_U32 * numOfMuxStagesPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT muxStagesListArr[] ) Get mux stages array for specific stage. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] stageId - stage identification [in,out] numOfMuxStagesPtr - in: (pointer to) allocated number of muxed stages out: (pointer to) actual number of muxed stages [out] muxStagesListArr - (pointer to) muxed stages list array Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - not found manager ◆ cpssDxChPacketAnalyzerMuxStageUnbind() GT_STATUS cpssDxChPacketAnalyzerMuxStageUnbind ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId ) Set stage that will be invalid in group of muxed stages. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] stageId - stage identification Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - not found manager ◆ cpssDxChPacketAnalyzerRuleMatchDataAllFieldsByAttributeGet() GT_STATUS cpssDxChPacketAnalyzerRuleMatchDataAllFieldsByAttributeGet ( IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, IN CPSS_DXCH_PACKET_ANALYZER_SEARCH_ATTRIBUTE_STC * searchAttributePtr, OUT GT_U32 * numOfHitsPtr, INOUT GT_U32 * numOfSampleFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_VALUE_STC sampleFieldsValueArr[] ) Get packet analyzer rule match attributes for all packet analyzer fields by specific search attributes. Note APPLICABLE DEVICES: Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; Aldrin; AC3X; Bobcat3; Aldrin2. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] ruleId - rule identification (APPLICABLE RANGES: 1..2048) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) [in] stageId - stage identification [in] searchAttributePtr -(pointer to) search attributes. [out] numOfHitsPtr - (pointer to) number of hits [in,out] numOfSampleFieldsPtr - in: (pointer to) allocated number of fields for sample data array out: (pointer to) actual number of fields for sample data array [out] sampleFieldsValueArr - out: (pointer to) sample data array values for requested fields Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_FOUND - on not found manager GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_SUPPORTED - on not supported parameter ◆ cpssDxChPacketAnalyzerRuleMatchStagesGet() GT_STATUS cpssDxChPacketAnalyzerRuleMatchStagesGet ( IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, INOUT GT_U32 * numOfMatchedStagesPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT matchedStagesArr[] ) Get stages where packet analyzer rule was matched. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] ruleId - rule identification (APPLICABLE RANGES: 1..2048) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) [in,out] numOfMatchedStagesPtr- in: (pointer to) allocated number of matched stages out: (pointer to) actual number of matched stages [out] matchedStagesArr - (pointer to) matched stages list array Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_FOUND - on not found manager GT_NOT_APPLICABLE_DEVICE - on not applicable device ◆ cpssDxChPacketAnalyzerSampledDataCountersClear() GT_STATUS cpssDxChPacketAnalyzerSampledDataCountersClear ( IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId ) Clear Sampling Data and Counters for packet analyzer rule. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] ruleId - rule identification (APPLICABLE RANGES: 1..2048) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_INITIALIZED - if the driver was not initialized GT_HW_ERROR - on hardware error GT_NOT_FOUND - on not found group ◆ cpssDxChPacketAnalyzerStageFieldOverlappingFieldsGet() GT_STATUS cpssDxChPacketAnalyzerStageFieldOverlappingFieldsGet ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldName, INOUT GT_U32 * numOfFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldsArr[] ) Get packet analyzer overlapping fields for spesific field in stage. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] stageId - stage identification [in] fieldName - field name [in,out] numOfFieldsPtr - in: (pointer to) allocated number of fields out: (pointer to) actual number of fields [out] fieldsArr - out: (pointer to) fields list array Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_FOUND - on not found manager GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_SUPPORTED - on not supported parameter ◆ cpssDxChPacketAnalyzerStageFieldsGet() GT_STATUS cpssDxChPacketAnalyzerStageFieldsGet ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, INOUT GT_U32 * numOfFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT fieldsArr[] ) Get stage fields list array. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] stageId - stage identification [in,out] numOfFieldsPtr - in: (pointer to) allocated number of fields out: (pointer to) actual number of fields [out] fieldsArr - (pointer to) stage fields list array Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - on not found manager GT_NOT_SUPPORTED - on not supported parameter ◆ cpssDxChPacketAnalyzerStageMatchDataAllFieldsGet() GT_STATUS cpssDxChPacketAnalyzerStageMatchDataAllFieldsGet ( IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, OUT GT_U32 * numOfHitsPtr, INOUT GT_U32 * numOfSampleFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_VALUE_STC sampleFieldsValueArr[] ) Get packet analyzer stage match attributes for all packet analyzer fields. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] ruleId - rule identification (APPLICABLE RANGES: 1..2048) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) [in] stageId - stage identification [out] numOfHitsPtr - (pointer to) number of hits [in,out] numOfSampleFieldsPtr - in: (pointer to) allocated number of fields for sample data array out: (pointer to) actual number of fields for sample data array [out] sampleFieldsValueArr - out: (pointer to) sample data array values for requested fields Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_FOUND - on not found manager GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_SUPPORTED - on not supported parameter ◆ cpssDxChPacketAnalyzerStageMatchDataAllInternalFieldsByAttributesGet() GT_STATUS cpssDxChPacketAnalyzerStageMatchDataAllInternalFieldsByAttributesGet ( IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, IN CPSS_DXCH_PACKET_ANALYZER_SEARCH_ATTRIBUTE_STC * searchAttributePtr, OUT GT_U32 * numOfHitsPtr, INOUT GT_U32 * numOfSampleFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_INTERNAL_FIELD_VALUE_STC sampleFieldsValueArr[] ) Get packet analyzer stage match attributes for all internal fields by specific search attributes. Note APPLICABLE DEVICES: Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; Aldrin; AC3X; Bobcat3; Aldrin2. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] ruleId - rule identification (APPLICABLE RANGES: 1..2048) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) [in] stageId - stage identification [in] searchAttributePtr -(pointer to) search attributes. [out] numOfHitsPtr - (pointer to) number of hits [in,out] numOfSampleFieldsPtr - in: (pointer to) allocated number of fields for sample data array out: (pointer to) actual number of fields for sample data array [out] sampleFieldsValueArr - out: (pointer to) sample data array values for requested fields Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_FOUND - on not found manager GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_SUPPORTED - on not supported parameter ◆ cpssDxChPacketAnalyzerStageMatchDataAllInternalFieldsGet() GT_STATUS cpssDxChPacketAnalyzerStageMatchDataAllInternalFieldsGet ( IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, OUT GT_U32 * numOfHitsPtr, INOUT GT_U32 * numOfSampleFieldsPtr, OUT CPSS_DXCH_PACKET_ANALYZER_INTERNAL_FIELD_VALUE_STC sampleFieldsValueArr[] ) Get packet analyzer stage match attributes for all internal fields. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] ruleId - rule identification (APPLICABLE RANGES: 1..2048) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) [in] stageId - stage identification [out] numOfHitsPtr - (pointer to) number of hits [in,out] numOfSampleFieldsPtr - in: (pointer to) allocated number of fields for sample data array out: (pointer to) actual number of fields for sample data array [out] sampleFieldsValueArr - out: (pointer to) sample data array values for requested fields Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_FOUND - on not found manager GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_SUPPORTED - on not supported parameter ◆ cpssDxChPacketAnalyzerStageMatchDataGet() GT_STATUS cpssDxChPacketAnalyzerStageMatchDataGet ( IN GT_U32 managerId, IN GT_U32 ruleId, IN GT_U32 groupId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT stageId, OUT GT_U32 * numOfHitsPtr, INOUT GT_U32 * numOfSampleFieldsPtr, INOUT CPSS_DXCH_PACKET_ANALYZER_FIELD_VALUE_STC sampleFieldsValueArr[] ) Get packet analyzer stage match attributes. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] ruleId - rule identification (APPLICABLE RANGES: 1..2048) [in] groupId - group identification (APPLICABLE RANGES: 1..1024) [in] stageId - stage identification [out] numOfHitsPtr - (pointer to) number of hits [in,out] numOfSampleFieldsPtr - in: (pointer to) allocated number of fields for sample data array out: (pointer to) actual number of fields for sample data array [in,out] sampleFieldsValueArr - in: (pointer to) requested fields for sample data array out: (pointer to) sample data array values for requested fields Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_FOUND - on not found manager GT_NOT_APPLICABLE_DEVICE - on not applicable device ◆ cpssDxChPacketAnalyzerStagesGet() GT_STATUS cpssDxChPacketAnalyzerStagesGet ( IN GT_U32 managerId, INOUT GT_U32 * numOfApplicStagesPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT applicStagesListArr[], INOUT GT_U32 * numOfValidStagesPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT validStagesListArr[] ) Get applicable stages and Valid stages - stages that are not muxed for current configuration. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in,out] numOfApplicStagesPtr - in: (pointer to) size of allocated applicStagesListArr out: (pointer to) actual number of applicable stages in applicStagesListArr [out] applicStagesListArr - (pointer to) applicable stages list array [in,out] numOfValidStagesPtr - in: (pointer to) size of allocated ValidStagesListArr out: (pointer to) actual number of valid stages in ValidStagesListArr [out] ValidStagesListArr - (pointer to) valid stages list array Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_BAD_SIZE - in case not enough memory was allocated to parameters list GT_BAD_PTR - on NULL pointer value. GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_FOUND - not found manager ◆ cpssDxChPacketAnalyzerUserDefinedFieldAdd() GT_STATUS cpssDxChPacketAnalyzerUserDefinedFieldAdd ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_UDF_ATTRIBUTES_STC * udfAttrPtr, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_NAME_STC * fieldNamePtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT * udfIdPtr ) Add packet analyzer user defined field. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] udfAttrPtr - (pointer to) udf attributes [in] fieldNamePtr - (pointer to) field name [out] udfIdPtr - (pointer to)user defined field identification. Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_INITIALIZED - if the driver was not initialized GT_NOT_FOUND - on not found parameters GT_ALREADY_EXIST - on already initialized ◆ cpssDxChPacketAnalyzerUserDefinedFieldDelete() GT_STATUS cpssDxChPacketAnalyzerUserDefinedFieldDelete ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_UDF_ATTRIBUTES_STC * udfAttrPtr ) Delete packet analyzer user defined field. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] udfAttrPtr - (pointer to) udf attributes Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_INITIALIZED - if the driver was not initialized GT_NOT_FOUND - on not found parameters ◆ cpssDxChPacketAnalyzerUserDefinedFieldGet() GT_STATUS cpssDxChPacketAnalyzerUserDefinedFieldGet ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_UDF_ATTRIBUTES_STC * udfAttrPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT * udfIdPtr, OUT GT_BOOL * validPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_NAME_STC * fieldNamePtr ) Get packet analyzer user defined field. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] udfAttrPtr - (pointer to) udf attributes [out] udfIdPtr - (pointer to) user defined field identification [out] validPtr - (pointer to) whether udf entry is valid or not [out] fieldNamePtr - (pointer to) field name Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_INITIALIZED - if the driver was not initialized GT_NOT_FOUND - on not found parameters ◆ cpssDxChPacketAnalyzerUserDefinedFieldInfoGet() GT_STATUS cpssDxChPacketAnalyzerUserDefinedFieldInfoGet ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_FIELD_ENT udfId, OUT GT_BOOL * validPtr, OUT CPSS_DXCH_PACKET_ANALYZER_UDF_ATTRIBUTES_STC * udfAttrPtr, OUT CPSS_DXCH_PACKET_ANALYZER_FIELD_NAME_STC * fieldNamePtr ) Get packet analyzer user defined field information. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] udfId - user defined field identification [out] validPtr - (pointer to) whether udf entry is valid or not [out] udfAttrPtr - (pointer to) udf attributes. Valid only when validPtr == GT_TRUE [out] fieldNamePtr - (pointer to) field name. Valid only when validPtr == GT_TRUE Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_INITIALIZED - if the driver was not initialized GT_NOT_FOUND - on not found parameters ◆ cpssDxChPacketAnalyzerUserDefinedStageAdd() GT_STATUS cpssDxChPacketAnalyzerUserDefinedStageAdd ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_UDS_ATTRIBUTES_STC * udsAttrPtr, IN CPSS_DXCH_PACKET_ANALYZER_STAGE_INTERFACE_STC * interfaceAttrPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT * udsIdPtr ) Add packet analyzer user defined stage. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] udsAttrPtr - (pointer to) uds attributes [in] interfaceAttrPtr - (pointer to) interface attributes [out] udsIdPtr - (pointer to) user defined stage identification Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_INITIALIZED - if the driver was not initialized GT_NOT_FOUND - on not found parameters GT_ALREADY_EXIST - on already initialized ◆ cpssDxChPacketAnalyzerUserDefinedStageDelete() GT_STATUS cpssDxChPacketAnalyzerUserDefinedStageDelete ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_UDS_ATTRIBUTES_STC * udsAttrPtr ) Delete packet analyzer user defined stage. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] udsAttrPtr - (pointer to) uds attributes Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_INITIALIZED - if the driver was not initialized GT_NOT_FOUND - on not found parameters ◆ cpssDxChPacketAnalyzerUserDefinedStageGet() GT_STATUS cpssDxChPacketAnalyzerUserDefinedStageGet ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_UDS_ATTRIBUTES_STC * udsAttrPtr, OUT CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT * udsIdPtr, OUT GT_BOOL * validPtr, OUT CPSS_DXCH_PACKET_ANALYZER_STAGE_INTERFACE_STC * interfaceAttrPtr ) Get packet analyzer user defined stage. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] udsAttrPtr - (pointer to) uds attributes [out] udsIdPtr - (pointer to) user defined stage identification [out] validPtr - (pointer to) whether uds entry is valid or not [out] interfaceAttrPtr - (pointer to) interface attributes. Valid only when validPtr == GT_TRUE Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_INITIALIZED - if the driver was not initialized GT_NOT_FOUND - on not found parameters ◆ cpssDxChPacketAnalyzerUserDefinedStageInfoGet() GT_STATUS cpssDxChPacketAnalyzerUserDefinedStageInfoGet ( IN GT_U32 managerId, IN CPSS_DXCH_PACKET_ANALYZER_LOOKUP_STAGES_ENT udsId, OUT GT_BOOL * validPtr, OUT CPSS_DXCH_PACKET_ANALYZER_UDS_ATTRIBUTES_STC * udsAttrPtr, OUT CPSS_DXCH_PACKET_ANALYZER_STAGE_INTERFACE_STC * interfaceAttrPtr ) Get packet analyzeruser defined stages information. Note APPLICABLE DEVICES: Aldrin; Aldrin2; Falcon; AC5P; AC5X; Harrier; Ironman. NOT APPLICABLE DEVICES: xCat3; AC5; Lion2; Bobcat2; Caelum; AC3X; Bobcat3. Parameters [in] managerId - manager identification (APPLICABLE RANGES: 1..10) [in] udsId - user defined stage identification [out] validPtr - (pointer to) whether uds entry is valid or not [out] udsAttrPtr - (pointer to) uds attributes. Valid only when validPtr == GT_TRUE [out] interfaceAttrPtr - (pointer to) interface attributes. Valid only when validPtr == GT_TRUE Return values GT_OK - on success GT_BAD_PARAM - wrong value in any of the parameters GT_FAIL - on error GT_NOT_APPLICABLE_DEVICE - on not applicable device GT_NOT_INITIALIZED - if the driver was not initialized GT_NOT_FOUND - on not found parameters
09-24
/** * @internal appDemoDxChDbReset function * @endinternal * * @brief DxCh DB reset. (part of 'System reset') * * @param[in] devNum - device number * @param[in] needHwReset - indication to do HW reset * @param[in] needFullDbCleanUp - indication to do full DB reset (or skip it to minimal) * * @retval GT_OK - on success, * @retval GT_FAIL - otherwise. */ GT_STATUS appDemoDxChDbReset ( IN GT_U8 devNum, IN GT_BOOL needHwReset, IN GT_BOOL needFullDbCleanUp ) { GT_STATUS rc; /* To hold funcion return code */ static GT_CHAR devMustNotResetPort_str[100]; CPSS_PORTS_BMP_STC portBmp;/* bmp for port */ GT_U32 port;/* port iterator */ struct { GT_U32 regAddr; GT_U32 value; } regsToRestore[] = { /* Unit Default ID (UDID) Register */ { 0x00000204, 0 }, /* Window n registers (n=0..5) * Base Address, * Size, * High Address Remap, * Window Control */ { 0x020c, 0 }, { 0x0210, 0 }, { 0x23c, 0}, { 0x0254, 0 }, { 0x0214, 0 }, { 0x0218, 0 }, { 0x240, 0}, { 0x0258, 0 }, { 0x021c, 0 }, { 0x0220, 0 }, { 0x244, 0}, { 0x025c, 0 }, { 0x0224, 0 }, { 0x0228, 0 }, { 0x248, 0}, { 0x0260, 0 }, { 0x022c, 0 }, { 0x0230, 0 }, { 0x24c, 0}, { 0x0264, 0 }, { 0x0234, 0 }, { 0x0248, 0 }, { 0x250, 0}, { 0x0258, 0 }, /* address completion are used by LSP of MSYS for eth port PHY managment */ { 0x0124, 0 }, { 0x0128, 0 }, { 0x012c, 0}, { 0x0130, 0 }, { 0x0134, 0 }, { 0x0138, 0 }, { 0x013c, 0}, /* SMI Master controller configuration is used for BobK systems for MSYS eth port PHY managment */ { SMI_MNG_ADDRESS_MARK_CNS, 0 }, /* must be last before {0,0} */ { 0, 0 }/* END */ }; GT_U32 ii; GT_UINTPTR deviceBaseAddrOnPex; GT_U32 doMgDecodingRestore; CPSS_PP_INTERFACE_CHANNEL_ENT ifChannel; /* DIAG device channel access type */ GT_U32 value; GT_BOOL doByteSwap; GT_U32 supportMgWindowsRegisters = 1; GT_U32 mgOffset; GT_U32 *unitBasePtr; if(PRV_CPSS_IS_DEV_EXISTS_MAC(devNum) == 0) { return (GT_STATUS)GT_ERROR; } if (PRV_CPSS_SIP_5_CHECK_MAC(devNum)) { /* all SIP5 devices should use PEX_MBUS driver with 8 regions address completion. */ ifChannel = CPSS_CHANNEL_PEX_MBUS_E; } else { ifChannel = CPSS_CHANNEL_PEX_E; } #ifdef ASIC_SIMULATION doMgDecodingRestore = 0; if (!PRV_CPSS_SIP_5_CHECK_MAC(devNum) && !PRV_CPSS_DXCH_IS_AC3_BASED_DEVICE_MAC(devNum)) { /* the memory space was not implemented ... and not really needed */ supportMgWindowsRegisters = 0; } #else doMgDecodingRestore = 1; #endif if(PRV_CPSS_SIP_6_CHECK_MAC(devNum) || (PRV_CPSS_PP_MAC(devNum)-&gt;devFamily == CPSS_PP_FAMILY_DXCH_AC5_E)) { supportMgWindowsRegisters = 0; /* we skip the MG 'save' and 'restore' because the 'init phase' in the appDemo is calling to : extern GT_STATUS prvNoKmDrv_configure_dma_per_devNum(IN GT_U8 devNum , IN GT_U32 portGroupId); that initialize the MG[0] of the device. and the 'cpss init phase2' will copy it from MG[0] to all other MGs */ } if (PRV_CPSS_SIP_7_CHECK_MAC(devNum)) { /* NO MG unit(s) */ supportMgWindowsRegisters = 0; doMgDecodingRestore = 0; mgOffset = 0;/* not used , but for compiler warning only */ } else { unitBasePtr = NULL; rc = prvCpssDxChUnitBaseTableGet(devNum, &unitBasePtr); if ((GT_NOT_APPLICABLE_DEVICE != rc) && (rc != GT_OK)) { return rc; } mgOffset = (NULL == unitBasePtr)?0:unitBasePtr[PRV_CPSS_DXCH_UNIT_MG_E]; for(ii = 0; ii < sizeof(regsToRestore)/sizeof(regsToRestore[0]); ii++) { if(0 == regsToRestore[ii].regAddr) { break; } regsToRestore[ii].regAddr += mgOffset; } } if(needHwReset == GT_FALSE) { doMgDecodingRestore = 0; } /*osPrintf("appDemoDxChDbReset - start \n");*/ if(GT_TRUE == needFullDbCleanUp) { /* IP LPM DB Clear - main LBM DB deleted, all prefixes removed, all VR removed */ rc = prvIpLpmLibReset(); CPSS_ENABLER_DBG_TRACE_RC_MAC("prvIpLpmLibReset", rc); if (rc != GT_OK) { return rc; } #ifdef IMPL_TM if(PRV_CPSS_PP_MAC(devNum)-&gt;tmInfo.tmHandle != NULL) { /* TM DB Clear */ rc = cpssTmClose(devNum); CPSS_ENABLER_DBG_TRACE_RC_MAC("cpssTmClose", rc); if (rc != GT_OK) { return rc; } } #endif /*IMPL_TM*/ /* reset TCAM related DBs */ appDemoDxChTcamDbReset(); /* Reset FDB Manager SW Db */ rc = prvCpssDxChFdbManagerAllDbDelete(); CPSS_ENABLER_DBG_TRACE_RC_MAC("prvCpssDxChFdbManagerAllDbDelete", rc); if(rc != GT_OK) { return rc; } /* Reset Exact Match Manager SW Db */ rc = prvCpssDxChExactMatchManagerAllDbDelete(); CPSS_ENABLER_DBG_TRACE_RC_MAC("prvCpssDxChExactMatchManagerAllDbDelete", rc); if(rc != GT_OK) { return rc; } } else { BYPASS_DB_CLEANUP_MAC(prvIpLpmLibReset); BYPASS_DB_CLEANUP_MAC(cpssTmClose); BYPASS_DB_CLEANUP_MAC(appDemoDxChTcamDbReset); } if(supportMgWindowsRegisters) { /* fill-in registers restore DB by run time values */ for(ii = 0 ; regsToRestore[ii].regAddr != 0; ii++) { if(SMI_MNG_ADDRESS_MARK_CNS == regsToRestore[ii].regAddr) { if(PRV_CPSS_DXCH_PP_MAC(devNum)-&gt;hwInfo.gop_lms.notSupported == GT_TRUE) { regsToRestore[ii].regAddr = PRV_CPSS_DXCH_DEV_REGS_VER1_MAC(devNum)-&gt;GOP.SMI[0].SMIMiscConfiguration; } else { /* BC2 A0 - MSYS does not use this register. mark as last one and not used */ regsToRestore[ii].regAddr = 0; } } } } CPSS_PORTS_BMP_PORT_CLEAR_ALL_MAC(&portBmp); cpssOsBzero(devMustNotResetPort_str, sizeof(devMustNotResetPort_str)); /* power down all ports */ for(port = 0 ; port < CPSS_MAX_PORTS_NUM_CNS /*support 256 ports in bc2*/; port++) { if(prvCpssDxChPortRemotePortCheck(devNum,port)) { /* we allow remote ports ... see logic below */ } else if(GT_FALSE == appDemoDxChIsPhysicalPortHoldMac(devNum,port)) { /* skip ports without MAC */ continue; } cpssOsSprintf(devMustNotResetPort_str,"devMustNotResetPort_str_d[%d]p[%d]",devNum,port); if(appDemoStaticDbEntryGet(devMustNotResetPort_str,&value)== GT_OK) { if(value) { /* port 90 is used for MAC 62 in BobK. Power down of SERDES for this port kills OOB port. Skip this ports. */ osPrintf("appDemoDxChDbReset : SKIP reset of port [%d] because 'MUST NOT RESET' flag \n", port); continue; } } if(portMgr) { /* support port manager operation */ (void)appDemoPortInitSeqDeletePortStage(devNum, port); } else { /* set the port in bmp */ CPSS_PORTS_BMP_PORT_SET_MAC(&portBmp,port); rc = cpssDxChPortModeSpeedSet(devNum, &portBmp, GT_FALSE, /*don't care*/CPSS_PORT_INTERFACE_MODE_SGMII_E, /*don't care*/CPSS_PORT_SPEED_1000_E); if (rc != GT_OK) { /* do not break .. maybe port not exists but we not have here knowledge about it */ if(port < PRV_CPSS_PP_MAC(devNum)-&gt;numOfPorts) { /* give indication about ports that are supposed to be in 'valid range' note that for BC2 ports 60..63 could give 'false alarm' indication */ /*osPrintf("cpssDxChPortModeSpeedSet : failed on port[%d] \n", port);*/ } } } /* Remote ports are not HW reset: Restore HW defaults */ if (needHwReset && prvCpssDxChPortRemotePortCheck(devNum,port)) { cpssDxChPortForceLinkPassEnableSet(devNum,port,GT_FALSE); cpssDxChPortForceLinkDownEnableSet(devNum,port,GT_FALSE); } /* remove the port from bmp */ CPSS_PORTS_BMP_PORT_CLEAR_MAC(&portBmp,port); } if(needHwReset == GT_TRUE) { CPSS_HW_INFO_STC *hwInfoPtr; hwInfoPtr = cpssDrvHwPpHwInfoStcPtrGet(devNum, 0); if (hwInfoPtr == NULL) return GT_FAIL; deviceBaseAddrOnPex = hwInfoPtr-&gt;resource.switching.start; osPrintf("deviceBaseAddrOnPex = 0x %p \n",deviceBaseAddrOnPex); doByteSwap = GT_FALSE; if(supportMgWindowsRegisters) { /* read the registers */ for(ii = 0 ; regsToRestore[ii].regAddr != 0; ii++) { rc = prvCpssDrvHwPpReadRegister(devNum,regsToRestore[ii].regAddr,&(regsToRestore[ii].value)); CPSS_ENABLER_DBG_TRACE_RC_MAC("prvCpssDrvHwPpReadRegister", rc); if (rc != GT_OK) { return rc; } } rc = cpssDxChDiagRegRead(deviceBaseAddrOnPex, ifChannel, CPSS_DIAG_PP_REG_INTERNAL_E, mgOffset + 0x50, &value, doByteSwap); CPSS_ENABLER_DBG_TRACE_RC_MAC("cpssDxChDiagRegRead", rc); if (rc != GT_OK) { return rc; } if(value == 0xAB110000) { doByteSwap = GT_TRUE; } } } else { deviceBaseAddrOnPex = 0;/* dummy.. will not be used */ doByteSwap = GT_FALSE; /* dummy.. will not be used */ } if(appDemoDbEntryGet("mgcamEnable", &value) == GT_OK) { /* disable MGCAM before remove device */ appDemoMgCamEnableSet(devNum, GT_FALSE); } if(needHwReset == GT_TRUE) { /* logic above generates interrupts. Provide time for CPU to take care of them. */ cpssOsTimerWkAfter(100); /* do 'atomic' device remove after device reset */ rc = doAtomicDeviceResetAndRemove(devNum); CPSS_ENABLER_DBG_TRACE_RC_MAC("doAtomicDeviceResetAndRemove", rc); if (rc != GT_OK) { return rc; } } else { if(skipRemoveDeviceFromCpss_get()) { osPrintf("appDemoDxChDbReset : DO NOT 'remove device from cpss' --- SKIP the remove device operation \n"); } else { /* do device remove without device reset */ osPrintf("appDemoDxChDbReset : 'remove device from cpss' \n"); rc = cpssDxChCfgDevRemove(devNum); CPSS_ENABLER_DBG_TRACE_RC_MAC("cpssDxChCfgDevRemove", rc); if (rc != GT_OK) { return rc; } } } /* let the device minimal time for reset before we restore next registers */ osTimerWkAfter(1); if(doMgDecodingRestore && supportMgWindowsRegisters) { osPrintf("appDemoDxChDbReset : (after soft reset) restore 'MG Registers/Address Decoding' configurations \n"); rc = cpssDxChDiagRegRead(deviceBaseAddrOnPex, ifChannel, CPSS_DIAG_PP_REG_INTERNAL_E, mgOffset + 0x50, &value, doByteSwap); CPSS_ENABLER_DBG_TRACE_RC_MAC("cpssDxChDiagRegRead", rc); if (rc != GT_OK) { return rc; } /*osPrintf("cpssDxChDiagRegRead:deviceBaseAddrOnPex[0x%x] reg[0x50] with value[%d] doByteSwap[%d] \n", deviceBaseAddrOnPex,value,doByteSwap);*/ /* restore the registers of : <MG_IP&gt; MG_IP/MG Registers/Address Decoding/Base Address %n 0x0000020C + n*8: where n (0-5) represents BA and: <MG_IP&gt; MG_IP/MG Registers/Address Decoding/Size (S) %n 0x00000210 + n*0x8: where n (0-5) represents SR and: <MG_IP&gt; MG_IP/MG Registers/Address Decoding/High Address Remap %n 0x0000023c + n*0x4: where n (0-5) represents HA and : <MG_IP&gt; MG_IP/MG Registers/Address Decoding/Window Control Register%n 0x00000254 + n*4: where n (0-5) represents n */ if(supportMgWindowsRegisters) { /* write the saved registers */ /* since the device was removed from cpss ... we must use the 'diag' functions to write to the device ... */ /* restore the registers */ for(ii = 0 ; regsToRestore[ii].regAddr != 0; ii++) { rc = cpssDxChDiagRegWrite(deviceBaseAddrOnPex, ifChannel, CPSS_DIAG_PP_REG_INTERNAL_E, regsToRestore[ii].regAddr, regsToRestore[ii].value, doByteSwap); CPSS_ENABLER_DBG_TRACE_RC_MAC("cpssDxChDiagRegWrite", rc); if (rc != GT_OK) { return rc; } } } } osPrintf("appDemoDxChDbReset - ended \n"); return GT_OK; 貌似是/* do device remove without device reset */ osPrintf("appDemoDxChDbReset : 'remove device from cpss' \n"); rc = cpssDxChCfgDevRemove(devNum);这里报错,分析下原因
10-21
【轴承故障诊断】加权多尺度字典学习模型(WMSDL)及其在轴承故障诊断上的应用(Matlab代码实现)内容概要:本文介绍了加权多尺度字典学习模型(WMSDL)在轴承故障诊断中的应用,并提供了基于Matlab的代码实现。该模型结合多尺度分析与字典学习技术,能够有效提取轴承振动信号中的故障特征,提升故障识别精度。文档重点阐述了WMSDL模型的理论基础、算法流程及其在实际故障诊断中的实施步骤,展示了其相较于传统方法在特征表达能力和诊断准确性方面的优势。同时,文中还提及该资源属于一个涵盖多个科研方向的技术合集,包括智能优化算法、机器学习、信号处理、电力系统等多个领域的Matlab仿真案例。; 适合人群:具备一定信号处理和机器学习基础,从事机械故障诊断、工业自动化、智能制造等相关领域的研究生、科研人员及工程技术人员。; 使用场景及目标:①学习并掌握加权多尺度字典学习模型的基本原理与实现方法;②将其应用于旋转机械的轴承故障特征提取与智能诊断;③结合实际工程数据复现算法,提升故障诊断系统的准确性和鲁棒性。; 阅读建议:建议读者结合提供的Matlab代码进行实践操作,重点关注字典学习的训练过程与多尺度分解的实现细节,同时可参考文中提到的其他相关技术(如VMD、CNN、BILSTM等)进行对比实验与算法优化。
【硕士论文复现】可再生能源发电与电动汽车的协同调度策略研究(Matlab代码实现)内容概要:本文档围绕“可再生能源发电与电动汽车的协同调度策略研究”展开,旨在通过Matlab代码复现硕士论文中的核心模型与算法,探讨可再生能源(如风电、光伏)与大规模电动汽车接入电网后的协同优化调度方法。研究重点包括考虑需求侧响应的多时间尺度调度、电动汽车集群有序充电优化、源荷不确定性建模及鲁棒优化方法的应用。文中提供了完整的Matlab实现代码与仿真模型,涵盖从场景生成、数学建模到求解算法(如NSGA-III、粒子群优化、ADMM等)的全过程,帮助读者深入理解微电网与智能电网中的能量管理机制。; 适合人群:具备一定电力系统基础知识和Matlab编程能力的研究生、科研人员及从事新能源、智能电网、电动汽车等领域技术研发的工程人员。; 使用场景及目标:①用于复现和验证硕士论文中的协同调度模型;②支撑科研工作中关于可再生能源消纳、电动汽车V2G调度、需求响应机制等课题的算法开发与仿真验证;③作为教学案例辅助讲授能源互联网中的优化调度理论与实践。; 阅读建议:建议结合文档提供的网盘资源下载完整代码,按照目录顺序逐步学习各模块实现,重点关注模型构建逻辑与优化算法的Matlab实现细节,并通过修改参数进行仿真实验以加深理解。
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值