SNIP_CLASSIC_STD_SECTION_5_6_34_Rte_Trigger

5.6.34 Rte_Trigger Purpose: Raise an external trigger of a trigger port. Signature: [SWS_Rte_07200] Upstream requirements: SRS_Rte_00162 ⌈ signature if returnValueProvision of the related ExternalTriggeringPoint(s) is set to noReturnValueProvided: void Rte_[Byps_]Trigger_<p>_<o>( [IN Rte_Instance <instance>], [OUT Std_TransformerError transformerError]) signature if returnValueProvision of the related ExternalTriggeringPoint(s) not set to noReturnValueProvided: Std_ReturnType Rte_[Byps_]Trigger_<p>_<o>( [IN Rte_Instance <instance>]) Where <p> is the port name and <o> the Trigger within the trigger interface categorizing the port. [Byps_] is an optional infix used when component wrapper method for bypass support is enabled for the related software component type.⌋ Data Transformation of external triggers is only supported for external triggers without queueing support. Existence: [SWS_Rte_07201] Upstream requirements: SRS_Rte_00162 ⌈The existence of an ExternalTriggeringPoint shall result in the generation of a Rte_Trigger API.⌋ [SWS_Rte_05300] Upstream requirements: SRS_Rte_00249 ⌈The optional OUT parameter transformerError of the API shall be generated if the PortPrototype of port <p> is referenced by a PortAPIOption which has the attribute errorHandling set to transformerErrorHandling.⌋ [SWS_Rte_CONSTR_09032]Rte_Trigger API may only be used by the runnable that describe its usage ⌈The Rte_Trigger API may only be used by the runnable that contains the corresponding ExternalTriggeringPoint.⌋ Description: The Rte_Trigger API triggers an execution for all runnables whose ExternalTriggerOccurredEvent is associated to the Trigger. The OUT parameter transformerError contains the transformer error which occurred during execution of the transformer chain. See chapter 4.10.5. Return Value: None if returnValueProvision of the related ExternalTriggeringPoint(s) is set to noReturnValueProvided. [SWS_Rte_06720] Upstream requirements: SRS_Rte_00235 ⌈The Rte_Trigger API shall return the following values: • RTE_E_OK if the trigger was successfully queued • RTE_E_LIMIT if the trigger was not queued because the maximum queue size is already reached. if returnValueProvision of the related ExternalTriggeringPoint(s) not set to noReturnValueProvided.⌋