AoU: ETAS_RTACAR_SM_OS_019

The ETAS_RTACAR_SM_OS_019 AoU requires that there is a complete mapping between events and the tasks that wait for them.

Every OsEvent defined in the OS ECUC configuration must be referenced by at least one OsTask via an OsTaskEventRef entry.

An event that is defined but never waited upon is either dead configuration or a latent logic error — a SetEvent call on such an event would silently have no effect, potentially hiding a synchronization defect.

Events and the WaitEvent API are exclusively used by extended tasks. If the project does not use extended tasks at all, no events are declared and no WaitEvent calls are made, so the AoU is trivially satisfied.

Verification Approach

The verification is performed by analyzing the OS ECUC configuration files (ARXML) provided via the --os-arxml parameter or discovered in the project directory specified by --dir.

The tool performs the following steps:

  1. Configuration Loading: Parses the ARXML files to extract the OS configuration, including task definitions, event definitions, and event references.

  2. Extended Task Detection: Identifies tasks configured as extended tasks (tasks that reference events via OsTaskEventRef).

  3. Scalability Class Validation: Checks that the OsScalabilityClass parameter is consistent across all configuration files. If incompatible values are detected, manual verification is required.

  4. Result Reporting: Generates one of the following results based on the analysis outcome.

Important

Automated Verification Scope

The current implementation detects the presence of extended tasks in the ECUC configuration but does not yet implement full automated verification of the event-to-task mapping specified in the AoU.

When extended tasks are detected, the tool reports a review result, requiring manual verification to confirm compliance with the complete AoU requirement as stated in the RTA-CAR V12.12.0 Safety Manual5.

ARXML Configuration Requirements

To enable this check, the OS ECUC configuration must be provided in AUTOSAR ARXML format. The tool analyzes:

  • Task definitions (OsTask containers) to identify extended tasks

  • Event references (OsTaskEventRef) to determine which tasks are extended

  • Scalability class settings (OsScalabilityClass) to ensure configuration consistency

Rule Id

ETAS_RTACAR_SM_OS_019

Title

There is a complete mapping between events and the tasks that wait for them.

Description

This rule verifies that every OS event defined in the ECUC configuration is referenced by at least one task that waits for it.

Message Description

Id

id_000

Message

Issue detected while executing the verification.

Kind

Open

Level

None

Description

An internal exception occurred during the execution. This can happen if there are insufficient resources available on the host machine, or if the ARXML configuration files cannot be properly parsed. For more details, please consult the RTA-SQF log file.

How To Fix

Restart the command to exclude any internal exceptions. Verify that the ARXML files are well-formed and accessible. Alternatively, please contact ETAS GmbH support for assistance. When reporting the error, include a sample configuration and command line that reproduces the issue.

Id

id_001

Message

No extended tasks were detected in the ECUC configuration; the AoU constraint is satisfied by default.

Kind

Pass

Level

None

Description

The analysis of the OS ECUC configuration did not detect any extended tasks. Since events and the WaitEvent API are exclusively used by extended tasks, the absence of extended tasks means no events are declared and no WaitEvent calls can occur. The AoU constraint is trivially satisfied. The check is limited to the scenario(s) documented in the RTA-SQF User Manual. Please refer to the manual for more information.

How To Fix

Everything is in order. No action is required.

Id

id_002

Message

Extended tasks were detected in the ECUC configuration. The automated verification that every OsEvent is mapped to at least one waiting task is not yet implemented. Manual verification is required to confirm that all events defined in the configuration are referenced by at least one OsTaskEventRef.

Kind

Review

Level

None

Description

The tool detected one or more extended tasks in the OS configuration (tasks that reference events via OsTaskEventRef), but the full automated cross-reference verification between OsEvent containers and OsTaskEventRef entries is not yet implemented. Manual verification is required to ensure that every OsEvent defined in the ECUC is referenced by at least one OsTaskEventRef in an OsTask container. The check is limited to the scenario(s) documented in the RTA-SQF User Manual. Please refer to the manual for more information.

How To Fix

Manually verify the following: (1) Identify all OsEvent containers defined in your OS ECUC configuration. (2) For each OsEvent, verify that at least one OsTask references it via OsTaskEventRef. (3) Identify and resolve any orphaned events — events that are declared but not referenced by any waiting task. Document your verification in your project’s safety documentation.

Id

id_003

Message

No ECUC configuration was found. Manual verification is required to confirm that all constraints specified in the AoU have been met.

Kind

Review

Level

None

Description

No OS ECUC configuration was found in the provided ARXML files or project directory. This may occur if the –os-arxml parameter was not specified and no ARXML files were found in the project directory (–dir), or if the ARXML files do not contain OS configuration data (OsTask containers). Manual verification is required to ensure compliance with the AoU constraint. The check is limited to the scenario(s) documented in the RTA-SQF User Manual. Please refer to the manual for more information.

How To Fix

Verify that ARXML files containing the OS ECUC configuration are provided via the –os-arxml parameter or are present in the project directory specified by –dir. If OS configuration is not available in ARXML format, manually verify that every OsEvent defined in the system is referenced by at least one OsTask via OsTaskEventRef.

Id

id_004

Message

Incompatible values were detected for {0} param. Manual verification is required.

Kind

Review

Level

None

Description

The tool detected incompatible values for the OsScalabilityClass parameter across multiple ARXML configuration files. This inconsistency prevents the tool from reliably determining the OS configuration state. Manual verification is required to resolve the configuration issue and confirm compliance with the AoU constraint. The check is limited to the scenario(s) documented in the RTA-SQF User Manual. Please refer to the manual for more information.

How To Fix

Review the OS configuration files and ensure that the OsScalabilityClass parameter has a consistent value across all ARXML files. Resolve any inconsistencies in the configuration. After correcting the configuration, re-run the RTA-SQF tool to verify the constraint.

See Also

  • os options for information on providing ARXML files via --os-arxml or --dir

  • RTA-CAR V12.12.0 Safety Manual5 section on event management and the WaitEvent/SetEvent API pair

  • AUTOSAR - Automotive Open System Architecture1 specification for extended task scheduling and event ownership semantics