TC8 Conformance Test Requirements#

Overview#

This document defines the requirements for verifying someipd against the OPEN Alliance TC8 SOME/IP test specification.

It belongs to a set of three documents that work together:

Table 4 TC8 Conformance Documentation Set#

Document

Purpose

requirements.rst (this file)

Defines what must be verified: one feature requirement and multiple component requirements, each linked to the S-CORE requirement hierarchy.

TC8 Test Specifications

Defines how each test runs: purpose, preconditions, stimuli, and expected results.

TC8 Conformance Traceability

Maps external OA spec test case IDs to internal test IDs and component requirements, and shows generated test results.

How the feature / component split works for TC8#

For TC8 conformance, the split is simple:

  • One feature requirement (feat_req__tc8_conformance__conformance) covers the overall goal: “verify someipd against OA TC8 SOME/IP at the wire level.” This requirement does not change when new test areas are added.

  • Many component requirements, one per testable protocol aspect (e.g., SD offer format, cyclic timing, response headers, TCP transport). Each component requirement:

    • Describes the specific behaviour under test.

    • References the relevant AUTOSAR PRS or TC8 specification section.

    • Is verified by one or more pytest functions.

Feature Requirement#

The following feature requirement establishes TC8 SOME/IP conformance testing as a formal verification activity for the SOME/IP Gateway’s protocol stack.

TC8 SOME/IP Protocol Conformance
status: valid
security: NO
safety: QM
tags: tc8, conformance, someip, verification
reqtype: Functional
valid_from: v0.0.0
version: 1
derived from: stkh_req__someip_gw__interoperability
derives: comp_req__tc8_conformance__evt_subscription, comp_req__tc8_conformance__msg_error_codes, comp_req__tc8_conformance__msg_resp_header, comp_req__tc8_conformance__sd_cyclic_timing, comp_req__tc8_conformance__sd_endpoint_option, comp_req__tc8_conformance__sd_find_mcast_rsp, comp_req__tc8_conformance__sd_find_response, comp_req__tc8_conformance__sd_mcast_eg, comp_req__tc8_conformance__sd_offer_format, comp_req__tc8_conformance__sd_phases_timing, comp_req__tc8_conformance__sd_reboot, comp_req__tc8_conformance__sd_sub_lifecycle, comp_req__tc8_conformance__sd_ttl_expiry
satisfied by: feat__someip_gateway

The SOME/IP Gateway project shall verify protocol conformance of its SOME/IP stack (someipd) against OPEN Alliance TC8 SOME/IP test specifications at the wire protocol level, without requiring application processes.

Scope boundary: This document currently defines only the top-level feature requirement and the initial set of TC8 component requirements established for the test infrastructure split. The remaining component requirements, covering method calls, field access, and the detailed traceability matrix against the OA TC8 v3.0 Chapter 6 test catalog, are added together with the test modules that implement and verify them.
feat_req__tc8_conformance__conformance
Feature Requirement

Component Requirements: Service Discovery#

The following component requirements define the high-priority TC8 conformance tests for SOME/IP Service Discovery (SD), aligned with SOME/IP-SD Protocol Specification (AUTOSAR PRS_SOMEIP_SD).

TC8 SD Offer Entry Format Validation
status: valid
security: NO
safety: QM
tags: tc8, conformance, service_discovery
reqtype: Functional
testlink: TestSDOfferFormat__test_tc8_sd_002_offer_entry_format (passed); TestSDFindServiceAdvanced__test_ets_091_session_id_increments (passed)
version: 1
derived from: feat_req__tc8_conformance__conformance
satisfied by: comp__someipd

The conformance test suite shall verify that someipd transmits SOME/IP-SD OfferService entries on the configured multicast group with correct service ID, instance ID, major/minor version, and TTL fields upon startup.

Note: Traces to AUTOSAR SOME/IP Service Discovery Protocol Specification R24-11, section 5.1.2.5.2 (Offer Service Entry).
comp_req__tc8_conformance__sd_offer_format
Component Requirement
TC8 SD Cyclic Offer Timing
status: valid
security: NO
safety: QM
tags: tc8, conformance, service_discovery, timing
reqtype: Functional
testlink: TestSDOfferFormat__test_tc8_sd_003_cyclic_offer_timing (passed)
version: 1
derived from: feat_req__tc8_conformance__conformance
satisfied by: comp__someipd

The conformance test suite shall verify that, in the main phase, two consecutive OfferService messages of someipd are cyclic_offer_delay apart within the OA ParamToleranceTime.

Note: Traces to OA TC8 SOMEIPSRV_SD_BEHAVIOR_02.
comp_req__tc8_conformance__sd_cyclic_timing
Component Requirement
TC8 SD Multicast Response to FindService
status: valid
security: NO
safety: QM
tags: tc8, conformance, service_discovery, timing
reqtype: Functional
testlink: TestSDFindServiceTiming__test_sd_behavior_03_unicast_findservice_timing (passed); TestSDFindServiceTiming__test_sd_behavior_04_multicast_findservice_timing (passed)
version: 1
derived from: feat_req__tc8_conformance__conformance
satisfied by: comp__someipd

The conformance test suite shall verify that someipd answers a FindService with a multicast OfferService, as defined by the OA tests for a FindService received after half of cyclic_offer_delay and for a FindService with the Unicast Flag cleared.

Note: Traces to OA TC8 SOMEIPSRV_SD_BEHAVIOR_03 and SOMEIPSRV_SD_BEHAVIOR_04.
comp_req__tc8_conformance__sd_find_mcast_rsp
Component Requirement
TC8 SD FindService Response
status: valid
security: NO
safety: QM
tags: tc8, conformance, service_discovery
reqtype: Functional
testlink: TestSDFindResponse__test_tc8_sd_004_find_known_service_unicast_offer (passed); TestSDVersionMatching__test_sd_message_01_any_instance (passed); TestSDVersionMatching__test_sd_message_02_instance_specific (passed); TestSDVersionMatching__test_sd_message_03_any_major_version (passed); TestSDVersionMatching__test_sd_message_04_major_version_specific (passed); TestSDVersionMatching__test_sd_message_05_any_minor_version (passed); TestSDVersionMatching__test_sd_message_06_minor_version_specific (passed); TestSDFindServiceAdvanced__test_ets_128_multicast_findservice_version_any (passed); TestSDFindServiceAdvanced__test_ets_130_multicast_findservice_unicast_flag_clear (skipped)
version: 1
derived from: feat_req__tc8_conformance__conformance
satisfied by: comp__someipd

The conformance test suite shall verify that someipd responds to a SOME/IP-SD FindService entry with a unicast OfferService for a known service, and does not respond for an unknown service.

Note: Traces to AUTOSAR SOME/IP Service Discovery Protocol Specification R24-11, section 5.1.4.2 (Server Answer Behavior).
comp_req__tc8_conformance__sd_find_response
Component Requirement
TC8 SD Subscribe Eventgroup Lifecycle
status: valid
security: NO
safety: QM
tags: tc8, conformance, service_discovery, eventgroup
reqtype: Functional
testlink: TestSDSubscribeLifecycle__test_tc8_sd_006_subscribe_valid_eventgroup_ack (passed); TestSDSubscribeLifecycle__test_tc8_sd_007_subscribe_unknown_eventgroup_nack (passed); TestSDSubscribeLifecycle__test_tc8_sd_008_stop_subscribe_ceases_notifications (passed); TestSDTTLExpiry__test_tc8_sd_014_ttl_expiry_ceases_notifications (passed); TestSDSubscribeNAck__test_sd_message_18_wrong_major_version (passed); TestSDSubscribeNAck__test_sd_message_14_15_16_unknown_service_id (passed); TestSDSubscribeNAck__test_sd_message_17_wrong_instance_id (passed); TestSDSubscribeNAck__test_sd_message_19_unknown_eventgroup_id (passed); TestSDSubscribeNAck__test_ets_144_reserved_field_endpoint_option_set (skipped); TestSDSubscribeLifecycleAdvanced__test_ets_088_two_subscribes_same_session (passed); TestSDSubscribeLifecycleAdvanced__test_ets_092_ttl_zero_stop_subscribe_no_nack (passed); TestSDSubscribeLifecycleAdvanced__test_ets_107_consider_entries_order (skipped); TestSDSubscribeLifecycleAdvanced__test_ets_120_events_sent_to_endpoint_option_port (skipped); TestSDSubscribeLifecycleAdvanced__test_ets_155_resubscribe_after_stop (skipped); TestSDFindServiceAdvanced__test_ets_121_events_sent_after_subscribe_ack (passed)
version: 1
derived from: feat_req__tc8_conformance__conformance
satisfied by: comp__someipd

The conformance test suite shall verify that someipd correctly handles the SubscribeEventgroup lifecycle: acknowledge valid subscriptions (SubscribeEventgroupAck), reject unknown eventgroups (SubscribeEventgroupNack with TTL=0), honor StopSubscribeEventgroup by ceasing notifications, and clean up expired subscriptions after the subscription TTL elapses.

Note: Traces to AUTOSAR SOME/IP Service Discovery Protocol Specification R24-11, sections 5.1.3.1.1 (Subscribe Eventgroup Entry, including TTL), 5.1.3.1.2 (Stop Subscribe Eventgroup Entry), 5.1.3.1.3 (Subscribe Eventgroup Acknowledgement), and 5.1.3.1.4 (Subscribe Eventgroup Negative Acknowledgement).
comp_req__tc8_conformance__sd_sub_lifecycle
Component Requirement
TC8 SD Subscription TTL Expiry
status: valid
security: NO
safety: QM
tags: tc8, conformance, service_discovery, eventgroup, timing
reqtype: Functional
testlink: TestSDSubscribeLifecycleAdvanced__test_ets_095_subscribe_ttl_expires_no_events (passed)
version: 1
derived from: feat_req__tc8_conformance__conformance
satisfied by: comp__someipd

The conformance test suite shall verify that event notifications cease to arrive after the subscription TTL expires: when a tester subscribes with TTL = 3 and no renewal is sent, no further SOME/IP notifications shall be received beyond 2 seconds after the TTL expiry, conforming to OA TC8 SOMEIP_ETS_095.
comp_req__tc8_conformance__sd_ttl_expiry
Component Requirement
TC8 SD Initial Delay and Repetitions Phase
status: valid
security: NO
safety: QM
tags: tc8, conformance, service_discovery, timing
reqtype: Functional
testlink: TestSDPhasesTiming__test_tc8_sd_009_repetition_phase_intervals (passed)
version: 1
derived from: feat_req__tc8_conformance__conformance
satisfied by: comp__someipd

The conformance test suite shall verify that someipd doubles the delay between offers in the Repetition Phase: the first gap is shorter than half of cyclic_offer_delay and the second gap is twice repetitions_base_delay within the OA tolerance.

Note: Traces to OA TC8 SOMEIPSRV_SD_BEHAVIOR_01 (Repetition Phase delay doubling). The offer count (repetitions_max), the initial wait delay and the main phase transition are not defined by this OA test and are out of scope.
comp_req__tc8_conformance__sd_phases_timing
Component Requirement
TC8 SD IPv4 Endpoint Option Validation
status: valid
security: NO
safety: QM
tags: tc8, conformance, service_discovery
reqtype: Functional
testlink: TestSDOptionFormat__test_tc8_sd_011_offer_ipv4_endpoint_option (passed)
version: 1
derived from: feat_req__tc8_conformance__conformance
satisfied by: comp__someipd

The conformance test suite shall verify that someipd includes a valid IPv4EndpointOption in OfferService SD entries, carrying the correct unicast address, port, and L4 protocol (UDP) so that clients can reach the offered service.

Note: Traces to AUTOSAR SOME/IP Service Discovery Protocol Specification R24-11, section 5.1.2.4.3 (IPv4 Endpoint Option).
comp_req__tc8_conformance__sd_endpoint_option
Component Requirement
TC8 SD Reboot Detection
status: valid
security: NO
safety: QM
tags: tc8, conformance, service_discovery, reboot
reqtype: Functional
testlink: TestSDClientReboot__test_format_07_reboot_flag_set_after_first_restart (passed); TestSDClientReboot__test_format_07_reboot_flag_set_after_second_restart (passed)
version: 1
derived from: feat_req__tc8_conformance__conformance
satisfied by: comp__someipd

The conformance test suite shall verify that someipd resets its SD state upon restart: the reboot flag (SD flags byte bit 7) shall be set in the first SD message after restart, and the SD session ID shall reset to a low value (≤ 2).

Note: Traces to AUTOSAR SOME/IP Service Discovery Protocol Specification R24-11, section 5.1.2.2 (SOME/IP-SD Header, Reboot Flag and Session ID handling).
comp_req__tc8_conformance__sd_reboot
Component Requirement
TC8 SD Multicast Eventgroup Option
status: valid
security: NO
safety: QM
tags: tc8, conformance, service_discovery, multicast
reqtype: Functional
testlink: TestSDMulticastEventgroup__test_tc8_sd_013_subscribe_ack_has_multicast_option (passed)
version: 1
derived from: feat_req__tc8_conformance__conformance
satisfied by: comp__someipd

The conformance test suite shall verify that someipd includes a multicast IPv4EndpointOption in the SubscribeEventgroupAck for eventgroups configured with a multicast address, so that clients know which multicast group to join for event delivery.

Note: Traces to AUTOSAR SOME/IP Service Discovery Protocol Specification R24-11, section 5.1.3.1.3 (Subscribe Eventgroup Acknowledgement Entry, multicast endpoint option).
comp_req__tc8_conformance__sd_mcast_eg
Component Requirement

Component Requirements: SOME/IP Message Format#

TC8 SOME/IP Response Header Validation
status: valid
security: NO
safety: QM
tags: tc8, conformance, message_format
reqtype: Functional
version: 1
derived from: feat_req__tc8_conformance__conformance
satisfied by: comp__someipd

The conformance test suite shall verify that someipd returns SOME/IP RESPONSE messages with correct protocol version (0x01), message type (0x80), matching session ID, and matching client ID for each received REQUEST.

Note: Traces to AUTOSAR SOME/IP Protocol Specification R24-11, sections 4.1.2.5 (Protocol Version), 4.1.2.7 (Message Type), and 4.1.2.4 (Request ID, Client ID / Session ID).
comp_req__tc8_conformance__msg_resp_header
Component Requirement
TC8 SOME/IP Error Return Codes
status: valid
security: NO
safety: QM
tags: tc8, conformance, message_format, error_handling
reqtype: Functional
version: 1
derived from: feat_req__tc8_conformance__conformance
satisfied by: comp__someipd

The conformance test suite shall verify that someipd returns the correct SOME/IP return codes for error conditions: E_UNKNOWN_SERVICE (0x02) for requests to non-existent services, E_UNKNOWN_METHOD (0x03) for invalid method IDs, and E_WRONG_INTERFACE_VERSION for interface version mismatches.

Note: Traces to AUTOSAR SOME/IP Protocol Specification R24-11, section 4.1.2.8 (Return Code) and section 4.2.6.1 (Return Codes, requirement PRS_SOMEIP_00191).
comp_req__tc8_conformance__msg_error_codes
Component Requirement

Component Requirements: Event Notification#

TC8 Event Notification Subscription Lifecycle
status: valid
security: NO
safety: QM
tags: tc8, conformance, events, notification
reqtype: Functional
version: 1
derived from: feat_req__tc8_conformance__conformance
satisfied by: comp__someipd

The conformance test suite shall verify that someipd delivers NOTIFICATION messages (message type 0x02) with correct event ID only to endpoints with an active eventgroup subscription, and ceases delivery after StopSubscribeEventgroup.

Note: Traces to AUTOSAR SOME/IP Protocol Specification R24-11, section 4.2.4 (Notification Events), and AUTOSAR SOME/IP Service Discovery Protocol Specification R24-11, section 5.1.3.1.1 (Subscribe Eventgroup Entry).
comp_req__tc8_conformance__evt_subscription
Component Requirement