SNIP_CLASSIC_CANTP_SECTION_8_3_7_CanTp_ChangeParameter

8.3.7 CanTp_ChangeParameter [SWS_CanTp_00302] Definition of API function CanTp_ChangeParameter ⌈ Service Name CanTp_ChangeParameter Syntax Std_ReturnType CanTp_ChangeParameter ( PduIdType id, TPParameterType parameter, uint16 value ) Service ID [hex] 0x4b Sync/Async Synchronous Reentrancy Non Reentrant id Identification of the PDU which the parameter change shall affect. parameter ID of the parameter that shall be changed. Parameters (in) value The new value of the parameter. Parameters (inout) None Parameters (out) None Return value Std_ReturnType E_OK: The parameter was changed successfully. E_NOT_OK: The parameter change was rejected. Description Request to change a specific transport protocol parameter (e.g. block size). Available via CanTp.h ⌋ The service CanTp_ChangeParameter is used to change the value of the reception parameter BS and STmin associated to each received N-SDU. Implementation of this service depends on the configuration parameter CanTpChangeParameterApi (i.e. the service shall be implemented when the parameter is set to TRUE). [SWS_CanTp_00303] ⌈A parameter change is only possible if the related N-SDU is not in the process of reception - i.e. a change of parameter value it is not possible after reception of FF until indication for last CF reception of the related N-SDU.⌋ [SWS_CanTp_00304] ⌈If the change of a parameter is requested for an N-SDU that is on reception process the service CanTp_ChangeParameter immediately returns E_NOT_OK and no parameter value is changed⌋ [SWS_CanTp_00338] ⌈When CanTp_ChangeParameter is called for an N-SDU with MetaData (indicating a generic connection), the change shall be applied to all generic connections, so that it is used for all following receptions.⌋ [SWS_CanTp_00305] ⌈If development error detection is enabled, the function CanTp_ChangeParameter shall check the validity of function parameters (parameter and value). If the parameter parameter is invalid, the CanTp_ChangeParameter function shall raise the development error CANTP_E_PARAM_ID. If the value parameter is invalid, the CanTp_ChangeParameter function shall raise the development error CANTP_E_PARAM_CONFIG.⌋ [SWS_CanTp_00357] ⌈If development error detection is enabled the function CanTp_ChangeParameter shall check the validity of function parameter id. If its value is invalid, the CanTp_ChangeParameter function shall raise the development error CANTP_E_INVALID_RX_ID.⌋