SNIP_CLASSIC_STD_SECTION_8_4_Callback_notifications_BSWGENERAL

8.4 Callback notifications Callbacks are functions, which are used for notifications to other modules. Callbacks, which are AUTOSAR Services, follow the signature expected by the RTE. In this case, the return value of these functions has the type Std_ReturnType and the caller can assume, that always E_OK is returned. Callback functions should never fail, but this can happen, e.g. in partitioned systems [SWS_BSW_00180] Signature of Callback functions of AUTOSAR Services ⌈If the BSW Module provides Callback functions which are AUTOSAR Services, i.e. the function invocation is routed via RTE, then the signature of these functions shall follow the signature provided by the RTE to invoke servers via RTE_Call API.⌋(SRS_BSW_- 00440) [SWS_BSW_00172] Avoid return types other than void in Callback functions ⌈If the BSW Module provides Callback functions which are not AUTOSAR Services, then the return type of these functions shall avoid types other than void.⌋(SRS_BSW_- 00359) General Specification of Basic Software Modules If Callback functions do serve as simple triggers, no parameter is necessary to be passed. If additional data is to be passed to the caller within the callback scope, it must be possible to forward the content of that data using a parameter. [SWS_BSW_00173] Callback parameters ⌈Callback functions are allowed to have parameters.⌋(SRS_BSW_00360) Some Callback functions are called in interrupt context. According to [SRS_BSW_00333] the BSW Module specification contains the information, for each Callback function, if it is called in interrupt context or not. The implementation of Callback functions called in interrupt context must be kept as short as possible, as specified in [SWS_BSW_00167]. Example: A callback from CAN Interface could be called from an ISR of the CAN driver. In this case, this information is part of the callback specification within the SWS for the CAN Interface module. The list of callbacks is specific for every BSW Module. Please refer to the respective BSW Module specification for further details. [SWS_BSW_00218] Usage of Callback functions of AUTOSAR Services ⌈A BSW Module shall not call RTE interfaces (e.g. Rte_Call) before the first invocation of the own MainFunction.⌋()