SNIP_CLASSIC_COMM_SECTION_8_3_10_ComM_GetPncToChannelMapping

8.3.10 ComM_GetPncToChannelMapping [SWS_ComM_91013] Definition of API function ComM_GetPncToChannelMapping Upstream requirements: SRS_ModeMgm_09259 ⌈ Service Name ComM_GetPncToChannelMapping Syntax Std_ReturnType ComM_GetPncToChannelMapping ( uint8* MappingTable, uint8* ChannelCnt, uint8* PNCBitVectorLength ) Service ID [hex] 0x68 Sync/Async Synchronous Reentrancy Non Reentrant Parameters (in) None Parameters (inout) None MappingTable Pointer to an array of uint8 which stores for each channel a PNC bit vector representing the mapping of PNCs to the channel Parameters (out) ChannelCnt Pointer to the number of physical channels passed in the MappingTable ▽ △ PNCBitVectorLength Pointer to the length in bytes of the PNC bit vector where each bit represents one PNC Return value Std_ReturnType E_OK: Successfully get PNC-to-channel-mapping entry E_NOT_OK: Getting of PNC-to-channel-mapping entry failed COMM_E_LEARNING_ACTIVE: Functionality cannot be executed because PNC learning phase is active. Description This function returns the current configuration of the ECUs PNC-to-channel-mapping. Available via ComM.h ⌋ [SWS_ComM_01034] Upstream requirements: SRS_ModeMgm_09258 ⌈Function ComM_GetPncToChannelMapping shall be only available if ComMPncGatewayEnabled and ComMDynamicPncToChannelMappingSupport are set to TRUE.⌋ [SWS_ComM_01035] Upstream requirements: SRS_ModeMgm_09259 ⌈If ComMDynamicPncToChannelMappingEnabled is set to TRUE on at least one channel and when PNC learning phase is active, then the function ComM_GetPncToChannelMapping shall return with COMM_E_LEARNING_ACTIVE.⌋ [SWS_ComM_01036] Upstream requirements: SRS_ModeMgm_09259 ⌈If ComMDynamicPncToChannelMappingEnabled is set to TRUE on at least one channel and when PNC learning phase is not active, then the function ComM_GetPncToChannelMapping shall provide within MappingTable the current PNC-to-channel mapping as a two-dimensional array where on first dimension all ComM channels where ComMPncGatewayType is set are handled according to their derived order in ComM and on second dimension all configured ComMPnc according to their order given by their ComMPncId. ComM shall also set the parameter ChannelCnt and PNCBitVectorLength accordingly and return with E_OK.⌋ Note: The content of this MappingTable can only be interpreted correctly by application or tester correctly if the number of Channels and PNCs and their order is known.