Skip to main content

ADAS CAPL Functions

Valid for: CANoe DE

Introduction

ON THIS PAGE:

General ADAS API

FunctionsShort Description
ADASActivateFMUThis method is used to activate or deactivate a specified FMU that has been coupled via the FMI.
ADASSetOutputDataThis method is used to set a byte array as ADAS output.

Ground Truth API

FunctionsShort Description
GetGroundTruthObjectGets the name of a special ground truth object as string.
GetGroundTruthObjectsGets the unique names of available ground truth objects as string-array.
GetHostVehicleGets the name of the host vehicle for the current ground truth.
GetOrCreateGroundTruthObjectGets a ground truth object. The object is created if it does not exist.
HasGroundTruthObjectsChecks if a special ground truth object exits.
SetHostVehicleSets the host vehicle for the ground truth.

Proj API

FunctionsShort Description
Proj_CreateInitialize the Proj Access with a Proj String / Proj definition.
Proj_TransformToGeoTransforms an inertial coordinate to a geodetic coordinate.
Proj_TransformToInertialTransforms a geodetic coordinate to an inertial coordinate.

Scenario API

FunctionsShort Description
SetStationSpeedChanges the speed of a station.
StartScenarioStarts the currently loaded scenario.
StopScenarioStops a started scenario.
IsScenarioStartedQueries whether the currently loaded scenario has started.
LoadScenarioLoads a scenario during a running measurement via a file path.
GetStationAttributeDoubleQueries an attribute of a scenario as a value of type double at the runtime of the scenario.
GetStationAttributeInt64Queries an attribute of a scenario as a value of type int64 at the runtime of the scenario.
SetStationAttributeDoubleSets values for attributes based on the attribute name and keypoint (index) in the Scenario Editor timeline.
SetStationAttributeInt64Sets values for attributes based on the attribute name and keypoint (index) in the Scenario Editor timeline.
OnScenarioStateChangeThis callback is called when the state of the scenario has changed.
OnStationAttributeTriggerThis callback is called is called when the value of an attribute of a station has changed.

Sensor API

FunctionsShort Description
GetDetectedObjectsThis function returns the detected objects of a sensor as a string array.
GetDetectedObjectsCondtionalThis function returns the detected objects of a sensor as a string array.
GetOrCreateDetectedObjectThis function gets the name of a detected object of a sensor as a string. If no object with the given trackingId exists, it will be created.
GetDetectedObjectByTrackingIdThis function returns the name of a detected object of a sensor based on the trackingId as a string.
GetDetectedObjectByGroundTruthIdThis function gets the name of a ground truth object of a sensor based on the ground truth Id as a string. If no object with the given ground truth Id is present, an empty string is returned.
HasDetectedObjectThis function can be used to query whether a detected object of a sensor with a specific tracking Id is present.
RemoveDetectedObjectThis function can be used to remove a detected object from a sensor with a specific tracking Id.
SetDetectedObjectExpirationTimeSets a detected object to inactive after a special amount of time (in ms).

Transmission Behavior API

FunctionsShort Description
BeginUpdateThis method is only required if data of a sensor and those of its detected objects are not to be sent directly after assignment.
OnDetectedObjectUpdateA call of this method for a sensor sends all the data of the sensor and the detected objects that have been marked as completed.
ResetCalling this function resets the values of the available sensors to their default values and clears the list of objects detected by them.
SetDetectedObjectCompletedThis method is used to mark that the data of a detected object of a sensor is completely available.
SetDetectedObjectsCompletedThis method is used to mark that the data of a sensor is completely available.
UpdateA call of this method for a sensor sends all data of the sensor and the detected objects that were marked as completed.

Test Feature Set

FunctionsShort Description
TestGetWaitADASDetectedObjectRetrieves the name of the Detected Object that triggered the wait function.
TestWaitForADASDetectedObjectDistanceWaits for a Detected Object for which the distance is above/below a specified value.
TestWaitForADASDetectedObjectSpeedWaits for a Detected Object for with a speed above/below a specified value.
TestWaitForADASDetectedObjectTimeToCollisionWaits for the occurrence of the first Detected Object matching the Time To Collision (TTC) conditions passed as arguments.
TestWaitForADASGroundTruthObjectDistanceWaits for the occurrence of the first Moving Object matching the distance conditions passed as arguments.
TestWaitForADASGroundTruthObjectInLaneWaits for a Moving Object which is completely in the given lane.
TestWaitForADASGroundTruthObjectInSameLaneWaits for a Moving Object which is completely in the lane of the ego vehicle.
TestWaitForADASGroundTruthObjectLaneSwitchWaits for a Moving Object which switches lane.
TestWaitForADASGroundTruthObjectSpeedWaits for the occurrence of the first Moving Object matching the speed conditions passed as arguments.
TestWaitForADASGroundTruthObjectTimeToCollisionWaits for the occurrence of the first Moving Object matching the Time To Collision (TTC) conditions passed as arguments.

Test Service Library Checks

FunctionsShort Description
ChkCreate_ADASDetectedObjectsDistanceViolation, ChkStart_ADASDetectedObjectsDistanceViolationObserves the distance of the Detected Moving Objects.
ChkCreate_ADASDetectedObjectsHaveMatchingGroundTruthObjectsViolation, ChkStart_ADASDetectedObjectsHaveMatchingGroundTruthObjectsViolationObserves if Detected Moving Objects have matching Moving Objects.
ChkCreate_ADASDetectedObjectsSpeedViolation, ChkStart_ADASDetectedObjectsSpeedViolationObserves the relative speed of the Detected Moving Objects.
ChkCreate_ADASDetectedObjectsTimeToCollisionViolation, ChkStart_ADASDetectedObjectsTimeToCollisionViolationObserves the Time To Collision (TTC) to the Detected Moving Objects.
ChkCreate_ADASGroundTruthObjectsDistanceViolation, ChkStart_ADASGroundTruthObjectsDistanceViolationObserves the distance of the Moving Objects to the EgoVehicle.
chkCreate_ADASEgoVehicleLaneViolation, chkStart_ADASEgoVehicleLaneViolationObserves the lane of the EgoVehicle.
ChkCreate_ADASGroundTruthObjectsHaveMatchingDetectedObjectsViolation, ChkStart_ADASGroundTruthObjectsHaveMatchingDetectedObjectsViolationObserves if Moving Objects have matching Detected Moving Objects.
ChkCreate_ADASGroundTruthObjectsSpeedViolation, chkStart_ADASGroundTruthObjectsSpeedViolationObserves the relative speed of the Moving Objects to the EgoVehicle.
ChkCreate_ADASGroundTruthObjectsTimeToCollisionViolation, ChkStart_ADASGroundTruthObjectsTimeToCollisionViolationObserves the Time To Collision (TTC) between Moving Objects and the EgoVehicle.
ADAS