Documentation Index
Fetch the complete documentation index at: https://notevil.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
SomeIpAddEvent
Valid for: CANoe DE • CANoe4SW DE
Function Syntax
dword SomeIpAddEvent( dword psiHandle, dword eventId, char onPrepareEventCallback[] );
Description
This function adds an Event to a Provided Service Instance that was created by SomeIpCreateProvidedServiceInstance.
SomeIpTriggerEvent is used to trigger sending of the Event. Then, the CAPL Callback function <OnSomeIpPrepareEvent> is called, and the application has the opportunity to change or update the values of the SOME/IP Event.
An Event can be removed again using the SomeIpRemoveEvent function.
Parameters
- psiHandle: Handle of the Provided-Service Instance
- eventId: Identifier of the Event
- onPrepareEventCallback: Name of the CAPL function, see CAPL callback
<OnSomeIpPrepareEvent>
Return Values
- 0: An error occurred. The error can be evaluated using the SomeIpGetLastError function.
- >0: Handle of the created Event
Example
void Initialize()
{
DWORD aep; // Application Endpoint handle
DWORD psi; // provided service handle
DWORD peg; // provided Eventgroup handle
DWORD pev; // provided Event handle
// open Application Endpoint
aep = SomeIpOpenLocalApplicationEndpoint(17, 50002);
// create Service Instance
psi = SomeIpCreateProvidedServiceInstance(aep,10,1);
// create Eventgroup
peg = SomeIpAddProvidedEventGroup(psi,1);
// create Event and add Event to Eventgroup
pev = SomeIpAddEvent(psi, 1, "OnPrepareEvent1");
SomeIpAddEventToEventgroup(peg, pev);
// ensure that Event is sent cyclically
SomeIpSetProperty(pev,"CycleTimeMs",1000);
}
void OnPrepareEvent1(DWORD eventHandle, DWORD messageHandle)
{
// this function is called before the Event is sent. Parameters can be specified here.
}
