TC8 Test Specifications#
This document provides the detailed test specification for each TC8 conformance test case. Each entry describes the purpose, preconditions, test stimuli, expected results, and requirement traceability.
For the full OA specification mapping see TC8 Conformance Traceability. For requirement definitions see TC8 Conformance Test Requirements.
Note
The “OA Spec Reference” field in each test case references the corresponding section from Chapter 6 of the OPEN Alliance TC8 Automotive Ethernet ECU Test Specification v3.0 (Final). See TC8 Conformance Traceability for the full mapping.
Note
Execution model
The host address is TC8_TESTER_IP; the DUT address is TC8_DUT_IP.
Both default values are defined in tc8_itf_conftest.py. To run a
test:
bazel test --config=qemu-integration //tests/tc8_conformance/qemu:test_tc8_<name>
For QNX x86_64 use --config=x86_64-qnx.
Note
Terminology
Throughout this specification, “server” refers to the SOME/IP Service Provider role (the DUT, which offers services and responds to requests), and “client” refers to the SOME/IP Service Consumer role (the external test harness, which discovers services and subscribes to events). This usage mirrors TC8 OA Section 6.1.5 (“Test Cases SOME/IP Server”) and Section 6.1.6 (“Test Cases ETS”) directly.
Note
DUT scope
The OA ETS cases assume the Enhanced Testability Service. The DUT here is
someipd offering service 0x1234 with the instances 0x5678 and
0x5680, eventgroups 0x0002, 0x0005 and 0x0006, the cyclic field
0x8001 (500 ms), the multicast event 0x800B and the fields 0x8005 to
0x8007, which have no update cycle and are sent only as initial fields. It has
no trigger methods, so OA steps that call one are marked “Not verified”.
The OA procedures take the instance ID from the received OfferService. The tests
use the configured ID, which is the same.
Service Discovery Tests#
- DUT Config:
tests/tc8_conformance/config/tc8_someipd_sd.json
TC8-SD-002: Offer Entry Format#
- OA Spec Reference:
Section 6.1.5.1, SOMEIPSRV_FORMAT_14-18
- Test Module:
test_service_discovery.py- Test Function:
test_tc8_sd_002_offer_entry_format- Requirement:
comp_req__tc8_conformance__sd_offer_format- DUT Config:
tc8_someipd_sd.json
Purpose: Verify that the OfferService entry carries the correct service ID, instance ID, major/minor version, and TTL as configured.
Preconditions:
someipdstarted withoutgatewaydMulticast route available (
224.0.0.0/4)
Stimuli: None, passive observation of the first OfferService of the capture.
Expected Result:
OfferService entry has service_id=0x1234, instance_id=0x5678,
major_version=0x01, minor_version=0x00000000, and TTL = 30 (configured ttl).
TC8-SD-003: Cyclic Offer Timing#
- OA Spec Reference:
Section 6.1.5.4, SOMEIPSRV_SD_BEHAVIOR_02
- Test Module:
test_service_discovery.py- Test Function:
test_tc8_sd_003_cyclic_offer_timing- Requirement:
comp_req__tc8_conformance__sd_cyclic_timing- DUT Config:
tc8_someipd_sd.json
Purpose: Verify that in the main phase OfferService messages are sent cyclically.
Stimuli: Receive an OfferService for the service. Wait TOTAL-REP-INTV (1.4 s) for the DUT to enter the main phase. Listen for two OfferService messages, up to CYCLE-INTV * 2 + ParamToleranceTime.
Expected Result:
The time between the first and the second OfferService is greater than
CYCLE-INTV - ParamToleranceTime and less than CYCLE-INTV + ParamToleranceTime.
CYCLE-INTV is cyclic_offer_delay (2 s), ParamToleranceTime is 1 s by default.
TC8-SD-004: FindService Known Service#
- OA Spec Reference:
Section 6.1.6, SOMEIP_ETS_171
- Test Module:
test_service_discovery.py- Test Function:
test_tc8_sd_004_find_known_service_unicast_offer- Requirement:
comp_req__tc8_conformance__sd_find_response- DUT Config:
tc8_someipd_sd.json
Purpose:
Verify that someipd responds with a unicast OfferService when a
FindService is sent for a known service.
Preconditions:
DUT offering service
0x1234.
Stimuli:
Send SD FindService entry for service 0x1234 / instance 0x5678 unicast to
the DUT, repeated every 1.5 seconds for up to 5 seconds.
Expected Result: At least one unicast OfferService entry received for the requested service.
TC8-SD-006: Subscribe Eventgroup Ack#
- OA Spec Reference:
Section 6.1.5.3, SOMEIPSRV_SD_MESSAGE_13
- Test Module:
test_service_discovery.py- Test Function:
test_tc8_sd_006_subscribe_valid_eventgroup_ack- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- DUT Config:
tc8_someipd_sd.json
Purpose:
Verify that someipd answers a valid eventgroup subscription with a
SubscribeEventgroupAck that echoes the subscription.
Preconditions:
DUT offering eventgroup
0x0002.
Stimuli:
Send SD SubscribeEventgroup for service 0x1234, instance 0x5678, eventgroup
0x0002, major version 0x01, TTL 0xFFFFFF, Reserved 0.
Expected Result:
SubscribeEventgroupAck with the same service ID, instance ID, eventgroup ID and
major version, TTL 0xFFFFFF and Reserved 0.
TC8-SD-007: Subscribe Unknown Eventgroup Nack#
- OA Spec Reference:
Section 6.1.5.3, SOMEIPSRV_SD_MESSAGE_19; Section 6.1.6, SOMEIP_ETS_140
- Test Module:
test_service_discovery.py- Test Function:
test_tc8_sd_007_subscribe_unknown_eventgroup_nack- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- DUT Config:
tc8_someipd_sd.json
Purpose:
Verify that someipd sends SubscribeEventgroupNack (TTL = 0) for
an unknown eventgroup.
Preconditions:
DUT running, eventgroup
0xBEEFnot configured.
Stimuli:
Send SD SubscribeEventgroup for eventgroup 0xBEEF, TTL 0xFFFFFF.
Expected Result: SubscribeEventgroupAck with TTL = 0 (Nack) received.
TC8-SD-008: StopSubscribe Ceases Notifications#
- OA Spec Reference:
Section 6.1.6, SOMEIP_ETS_108
- Test Module:
test_service_discovery.py- Test Function:
test_tc8_sd_008_stop_subscribe_ceases_notifications- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- DUT Config:
tc8_someipd_sd.json
Purpose:
Verify that no events are sent after StopSubscribeEventgroup (TTL = 0)
(ETS_108, eventgroup 0x0005). The OA trigger method TestEventUINT8 is not
used; the cyclic event of the DUT is observed instead.
Preconditions:
Active subscription to eventgroup
0x0005.At least one notification received.
Stimuli: Send SD SubscribeEventgroup with TTL = 0 (StopSubscribe).
Expected Result: No further notifications received within 4 seconds.
Not verified: the initial event and the TestEventUINT8 trigger (the DUT has no trigger method).
TC8-SD-009: Repetition Phase Intervals#
- OA Spec Reference:
Section 6.1.5.4, SOMEIPSRV_SD_BEHAVIOR_01
- Test Module:
test_sd_phases_timing.py- Test Function:
test_tc8_sd_009_repetition_phase_intervals- Requirement:
comp_req__tc8_conformance__sd_phases_timing- DUT Config:
tc8_someipd_sd.json
Purpose: Verify that the first two inter-offer gaps after startup follow the Repetition Phase: about the base delay (200 ms), then about twice that (400 ms).
Preconditions:
Multicast socket opened before DUT startup to capture first offer.
Stimuli: None, passive observation from DUT start.
Expected Result:
First gap < 1000 ms (half of cyclic_offer_delay 2000 ms). Second gap
400 ms (2 x repetitions_base_delay 200 ms) within ParamToleranceTimeMillisec
(default 100 ms), i.e. between 300 ms and 500 ms.
TC8-SD-011: IPv4 Endpoint Option#
- OA Spec Reference:
Section 6.1.5.2, SOMEIPSRV_OPTIONS_01-07; Section 6.1.5.3, SOMEIPSRV_SD_MESSAGE_08
- Test Module:
test_service_discovery.py- Test Function:
test_tc8_sd_011_offer_ipv4_endpoint_option- Requirement:
comp_req__tc8_conformance__sd_endpoint_option- DUT Config:
tc8_someipd_sd.json
Purpose: Verify that OfferService SD entries include an IPv4EndpointOption with the correct address, port, and L4 protocol.
Preconditions:
DUT offering service on UDP port 30509.
Stimuli: None, passive observation with option parsing.
Expected Result:
Exactly one IPv4EndpointOption with Length 0x0009, both Reserved fields
0x00, address TC8_DUT_IP, port = 30509, protocol = UDP (0x11).
TC8-SD-013: Multicast Eventgroup Option#
- OA Spec Reference:
Section 6.1.5.2, SOMEIPSRV_OPTIONS_08-14
- Test Module:
test_service_discovery.py- Test Function:
test_tc8_sd_013_subscribe_ack_has_multicast_option- Requirement:
comp_req__tc8_conformance__sd_mcast_eg- DUT Config:
tc8_someipd_sd.json- Marker:
@pytest.mark.network(requires non-loopback interface)
Purpose: Verify that SubscribeEventgroupAck for a multicast eventgroup includes a multicast IPv4EndpointOption.
Preconditions:
Non-loopback network interface (
TC8_TESTER_IPset).Eventgroup
0x0006configured with multicast address239.0.0.1.
Stimuli:
Send SD SubscribeEventgroup for eventgroup 0x0006.
Expected Result:
SubscribeEventgroupAck contains a multicast IPv4EndpointOption with option type
0x14, Length 0x0009, both Reserved fields 0x00, address 239.0.0.1,
protocol = UDP (0x11) and port = 40490.
The OA Synopsis of SOMEIPSRV_OPTIONS_14 names the port of the multicast events,
its Pass criteria name <SERVICE-ID-1-UDP-PORT>. This test asserts the
multicast event port.
TC8-SD-014: TTL Expiry Cleanup#
- OA Spec Reference:
Section 6.1.6, SOMEIP_ETS_095
- Test Module:
test_service_discovery.py- Test Function:
test_tc8_sd_014_ttl_expiry_ceases_notifications- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- DUT Config:
tc8_someipd_sd.json
Purpose: Verify that notifications cease after the subscription TTL expires.
Preconditions:
Active subscription with TTL = 3 seconds.
At least one notification received before expiry.
Stimuli: Wait for TTL to expire (3 s + 2 s margin).
Expected Result: No notifications received in a 3-second window after TTL expiry.
Not verified: the reaction to an explicit TriggerEventUint8 call (the DUT has no trigger method).
SD Entry Semantics Tests#
- DUT Config:
tests/tc8_conformance/config/tc8_someipd_sd.json- Test Module:
test_service_discovery
TC8-SDM-001: FindService: Any Instance (0xFFFF)#
- OA Reference:
Section 6.1.5.3, SOMEIPSRV_SD_MESSAGE_01
- Requirement:
comp_req__tc8_conformance__sd_find_response- Test Function:
TestSDVersionMatching::test_sd_message_01_any_instance
Purpose: Verify that a FindService with instance_id = 0xFFFF (Any Instance) elicits an OfferService entry for every offered instance of the service.
Stimulus: Send FindService with instance_id = 0xFFFF.
Expected Result: OfferService with two entries for service_id = 0x1234 and different instance IDs (0x5678 and 0x5680).
TC8-SDM-002: FindService: Specific Instance#
- OA Reference:
Section 6.1.5.3, SOMEIPSRV_SD_MESSAGE_02
- Requirement:
comp_req__tc8_conformance__sd_find_response- Test Function:
TestSDVersionMatching::test_sd_message_02_instance_specific
Purpose: Verify that a FindService with an exact instance_id elicits exactly one OfferService entry for that instance.
Stimulus: Send FindService with instance_id = 0x5678, then with instance_id = 0x5680.
Expected Result: Each time one OfferService entry for service_id = 0x1234 and the requested instance_id.
TC8-SDM-003: FindService: Any Major Version (0xFF)#
- OA Reference:
Section 6.1.5.3, SOMEIPSRV_SD_MESSAGE_03
- Requirement:
comp_req__tc8_conformance__sd_find_response- Test Function:
TestSDVersionMatching::test_sd_message_03_any_major_version
Purpose: Verify that a FindService with major_version = 0xFF (Any Major Version) elicits an OfferService.
Stimulus: Send FindService with major_version = 0xFF, TTL = 0xFFFFFF.
Expected Result: OfferService received for the configured service with major_version = 0x01.
TC8-SDM-004: FindService: Specific Major Version#
- OA Reference:
Section 6.1.5.3, SOMEIPSRV_SD_MESSAGE_04
- Requirement:
comp_req__tc8_conformance__sd_find_response- Test Function:
TestSDVersionMatching::test_sd_message_04_major_version_specific
Purpose: Verify that a FindService with the exact major_version = 0x01 elicits an OfferService.
Stimulus: Send FindService with major_version = 0x01, TTL = 0xFFFFFF.
Expected Result: OfferService received for the configured service with major_version = 0x01.
TC8-SDM-005: FindService: Any Minor Version (0xFFFFFFFF)#
- OA Reference:
Section 6.1.5.3, SOMEIPSRV_SD_MESSAGE_05
- Requirement:
comp_req__tc8_conformance__sd_find_response- Test Function:
TestSDVersionMatching::test_sd_message_05_any_minor_version
Purpose: Verify that a FindService with minor_version = 0xFFFFFFFF (Any Minor Version) elicits an OfferService.
Stimulus: Send FindService with minor_version = 0xFFFFFFFF.
Expected Result: OfferService received for the configured service with minor_version = 0x00000000.
TC8-SDM-006: FindService: Specific Minor Version#
- OA Reference:
Section 6.1.5.3, SOMEIPSRV_SD_MESSAGE_06
- Requirement:
comp_req__tc8_conformance__sd_find_response- Test Function:
TestSDVersionMatching::test_sd_message_06_minor_version_specific
Purpose: Verify that a FindService with the exact minor_version = 0x00000000 elicits an OfferService.
Stimulus: Send FindService with minor_version = 0x00000000.
Expected Result: OfferService received for the configured service with minor_version = 0x00000000.
TC8-SDM-007: SubscribeEventgroup: Wrong Major Version NAck#
- OA Reference:
Section 6.1.5.3, SOMEIPSRV_SD_MESSAGE_18; Section 6.1.6, SOMEIP_ETS_142
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeNAck::test_sd_message_18_wrong_major_version
Purpose: Verify that a SubscribeEventgroup with a non-matching major version is answered with a NAck (SubscribeEventgroupAck with TTL = 0) that carries the requested major version.
Stimulus: Send SubscribeEventgroup for the configured service, instance and eventgroup with major_version = 0x02 (configured major version + 1), TTL = 0xFFFFFF, Reserved = 0.
Expected Result: SubscribeEventgroupAck with TTL = 0 and major_version = 0x02.
TC8-SDM-008: SubscribeEventgroup: Unknown Service ID NAck#
- OA Reference:
Section 6.1.5.3, SOMEIPSRV_SD_MESSAGE_14-16; Section 6.1.6, SOMEIP_ETS_143
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeNAck::test_sd_message_14_15_16_unknown_service_id
Purpose: Verify that a SubscribeEventgroup for an unknown service is answered with a NAck that echoes the request.
Stimulus: Send SubscribeEventgroup with service_id = 0xBEEF and the configured instance, eventgroup and major version, TTL = 0xFFFFFF, Reserved = 0.
Expected Result: SubscribeEventgroupAck with TTL = 0, service_id = 0xBEEF and the instance ID, eventgroup ID and major version of the request, Reserved = 0.
TC8-SDM-009: SubscribeEventgroup: Unknown Instance ID NAck#
- OA Reference:
Section 6.1.5.3, SOMEIPSRV_SD_MESSAGE_17; Section 6.1.6, SOMEIP_ETS_141
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeNAck::test_sd_message_17_wrong_instance_id
Purpose: Verify that a SubscribeEventgroup for an unknown instance is answered with a NAck that carries the requested instance ID.
Stimulus: Send SubscribeEventgroup with instance_id = 0x5679 (configured instance + 1), TTL = 0xFFFFFF, Reserved = 0.
Expected Result: SubscribeEventgroupAck with TTL = 0 and instance_id = 0x5679.
TC8-SDM-010: SubscribeEventgroup: Unknown Eventgroup NAck#
- OA Reference:
Section 6.1.5.3, SOMEIPSRV_SD_MESSAGE_19
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeNAck::test_sd_message_19_unknown_eventgroup_id
Purpose: Verify that a SubscribeEventgroup for an unknown eventgroup ID is answered with a NAck.
Stimulus: Send SubscribeEventgroup with eventgroup_id = 0xBEEF, TTL = 0xFFFFFF.
Expected Result: SubscribeEventgroupAck with eventgroup_id = 0xBEEF and TTL = 0 (NAck).
TC8-SDM-012: SubscribeEventgroup: Reserved Fields of Endpoint Option Set#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_144
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeNAck::test_ets_144_reserved_field_endpoint_option_set
Purpose: Verify that the DUT ignores set reserved fields of the IPv4 Endpoint Option in a SubscribeEventgroup and sends a SubscribeEventgroupAck.
Stimulus: Send SubscribeEventgroup whose Endpoint Option has its reserved fields set.
Expected Result: SubscribeEventgroupAck with TTL > 0.
TC8-SDM-013: FindService After Half Cyclic Offer Delay: Multicast Response#
- OA Reference:
Section 6.1.5.4, SOMEIPSRV_SD_BEHAVIOR_03
- Requirement:
comp_req__tc8_conformance__sd_find_mcast_rsp- Test Function:
TestSDFindServiceTiming::test_sd_behavior_03_unicast_findservice_timing
Purpose: Verify that a FindService with the Unicast Flag set, received at least half a cyclic offer delay after the last OfferService, is answered with a multicast OfferService.
Stimulus:
Wait for the main phase and receive a cyclic OfferService. Wait
cyclic_offer_delay / 2 (1 s), then send FindService with the Unicast Flag set.
Expected Result:
OfferService with IP destination address equal to the SD multicast group, received
within the listen time (ParamListenTime, default 10 s).
TC8-SDM-014: FindService With Unicast Flag Cleared: Multicast Response#
- OA Reference:
Section 6.1.5.4, SOMEIPSRV_SD_BEHAVIOR_04
- Requirement:
comp_req__tc8_conformance__sd_find_mcast_rsp- Test Function:
TestSDFindServiceTiming::test_sd_behavior_04_multicast_findservice_timing
Purpose: Verify that a FindService with the Unicast Flag cleared is answered with a multicast OfferService.
Stimulus: Wait for the main phase, then send FindService with the Unicast Flag = 0.
Expected Result:
OfferService with IP destination address equal to the SD multicast group, received
within cyclic_offer_delay (2 s).
SD Lifecycle Advanced Tests#
- DUT Config:
tests/tc8_conformance/config/tc8_someipd_sd.json- Test Module:
test_service_discovery(TestSDSubscribeLifecycleAdvanced, TestSDFindServiceAdvanced) andtest_sd_client
TC8-SDLC-001: Multiple Subscribes in One Message#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_088
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeLifecycleAdvanced::test_ets_088_two_subscribes_same_session
Purpose:
Verify (OA SD_Answer_multiple_subscribes_together) that three SubscribeEventgroup entries (eventgroups 0x0002,
0x0005, 0x0006) in one SD message each receive a positive ACK.
Stimulus: Send an SD message containing three SubscribeEventgroup entries.
Expected Result: Three ACK entries received (one per subscription).
TC8-SDLC-002: TTL = 0 as StopSubscribe (No NAck)#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_092
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeLifecycleAdvanced::test_ets_092_ttl_zero_stop_subscribe_no_nack
Purpose: Verify that a unicast SubscribeEventgroup with TTL = 0 gets no reaction from the DUT (no Ack, no NAck).
Stimulus: Send a unicast SubscribeEventgroup with TTL = 0 (no prior subscription).
Expected Result: No SubscribeEventgroupAck or SubscribeEventgroupNack received within 2 seconds.
The OA procedure numbers its steps from 3.
TC8-SDLC-004: Entries In One Message Processed In Order#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_107
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeLifecycleAdvanced::test_ets_107_consider_entries_order
Purpose: Verify that the DUT handles the entries of one SD message in order (SOMEIP_ETS_107, SD_Consider_Entries_Order).
Stimulus:
Subscribe to eventgroup 0x0005, then send one SD message with a
StopSubscribeEventgroup entry (TTL = 0) followed by a SubscribeEventgroup entry for the
same eventgroup.
Expected Result:
The entries are processed in order: a new SubscribeAck is received and the initial
fields (0x8005 to 0x8007) arrive again after the re-subscribe.
TC8-SDLC-005: Events Sent to Endpoint Option Port#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_120
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeLifecycleAdvanced::test_ets_120_events_sent_to_endpoint_option_port
Purpose: Verify that events go to the address and port in the endpoint option, not to the SD packet source port. OA ETS_120 also changes the IP address, but the test uses the tester IP with a different port, so it only partially verifies the requirement.
Stimulus: Send SubscribeEventgroup from the SD socket with an endpoint option naming a different tester port.
Expected Result:
The ACK arrives on the SD socket and the initial fields (0x8005 to 0x8007)
arrive on the endpoint option socket. Not verified: an option IP address that differs
from the tester IP address.
TC8-SDLC-007: Re-subscribe After StopSubscribe#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_155
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeLifecycleAdvanced::test_ets_155_resubscribe_after_stop
Purpose: Verify that a subscription can be re-established after a StopSubscribeEventgroup (TTL = 0), a new ACK is sent and the initial fields arrive. The OA procedure has no tester step for the re-subscribe, the OA synopsis says the tester subscribes again.
Stimulus: Subscribe, wait for the ACK, StopSubscribe, re-Subscribe.
Expected Result:
A new SubscribeAck and the initial fields (0x8005 to 0x8007) are received after
the re-subscription.
TC8-SDLC-008: Session ID Increments per OfferService#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_091
- Requirement:
comp_req__tc8_conformance__sd_offer_format- Test Function:
TestSDFindServiceAdvanced::test_ets_091_session_id_increments
Purpose: Verify that the SD SOME/IP header session_id increments by 1 between consecutive OfferService messages.
Stimulus: Capture two consecutive OfferService messages.
Expected Result:
session_id[n+1] == session_id[n] + 1 (with wrap from 0xFFFF to 0x0001).
TC8-SDLC-009: Events Sent After Subscribe ACK#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_121
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDFindServiceAdvanced::test_ets_121_events_sent_after_subscribe_ack
Purpose: Verify that the DUT sends the initial fields to a new subscriber after a successful SubscribeEventgroup ACK.
Stimulus:
Subscribe to eventgroup 0x0005; wait for the ACK and the initial fields.
Expected Result:
A SubscribeEventgroupAck and the initial fields (0x8005 to 0x8007) received
within 5 seconds after the ACK.
TC8-SDLC-011: StopOfferService Stops FindService#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_101
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDFindServiceAdvanced::test_ets_101_stop_offer_ceases_client_events
Purpose: Verify that the DUT stops sending FindService for a service after a StopOfferService.
Stimulus: N/A (skipped).
Expected Result:
Not applicable: the DUT has no ETS client mode (clientServiceActivate).
TC8-SDLC-012: Multicast FindService: Any Major and Any Minor Version#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_128
- Requirement:
comp_req__tc8_conformance__sd_find_response- Test Function:
TestSDFindServiceAdvanced::test_ets_128_multicast_findservice_version_any
Purpose: Verify that a multicast FindService with Any Major Version (0xFF) and with Any Minor Version (0xFFFFFFFF) is answered with a unicast OfferService.
Stimulus: Send 10 multicast FindService messages at 100 ms intervals with major_version = 0xFF (other fields default), then 10 at 100 ms intervals with minor_version = 0xFFFFFFFF (other fields default).
Expected Result: At least one unicast OfferService received for the configured service in each phase.
TC8-SDLC-013: Multicast FindService: Unicast Flag Clear#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_130
- Requirement:
comp_req__tc8_conformance__sd_find_response- Test Function:
TestSDFindServiceAdvanced::test_ets_130_multicast_findservice_unicast_flag_clear
Purpose: Verify that a multicast FindService with the unicast flag cleared (0x00) is answered with a unicast OfferService (the flag is ignored).
Stimulus: Send multicast FindService with unicast flag = 0.
Expected Result: Unicast OfferService received on the tester socket.
TC8-SDLC-015: Restart: Reboot Flag and Session ID After First Restart#
- OA Reference:
Section 6.1.5.1, SOMEIPSRV_FORMAT_07; Section 6.1.5.1, SOMEIPSRV_FORMAT_02
- Requirement:
comp_req__tc8_conformance__sd_reboot- Test Module:
test_sd_client- Test Function:
TestSDClientReboot::test_format_07_reboot_flag_set_after_first_restart
Purpose: Verify that after a DUT restart the first SD message has the reboot flag (bit 7 of SD flags byte) set and the session_id restarts at 0x0001.
Stimulus: Start the DUT, drain 3 SD messages, terminate it, restart it and capture the first post-restart SD message.
Expected Result:
sd_hdr.flag_reboot == True and outer.session_id == 1.
Not verified: the reboot flag changing to 0 after the Session ID wraps (needs 65535 messages).
TC8-SDLC-016: Restart: Reboot Flag and Session ID After Second Restart#
- OA Reference:
Section 6.1.5.1, SOMEIPSRV_FORMAT_07; Section 6.1.5.1, SOMEIPSRV_FORMAT_02
- Requirement:
comp_req__tc8_conformance__sd_reboot- Test Module:
test_sd_client- Test Function:
TestSDClientReboot::test_format_07_reboot_flag_set_after_second_restart
Purpose: Verify that the reboot flag and session ID restart hold across a second consecutive restart (not just the first).
Stimulus: Start, drain, stop, start, drain, stop, start, then capture the first message.
Expected Result:
sd_hdr.flag_reboot == True and outer.session_id == 1.
Not verified: the reboot flag changing to 0 after the Session ID wraps (needs 65535 messages).
TC8-SDLC-019: Subscribe TTL Expiry Stops Events#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_095
- Requirement:
comp_req__tc8_conformance__sd_ttl_expiry- Test Function:
TestSDSubscribeLifecycleAdvanced::test_ets_095_subscribe_ttl_expires_no_events
Purpose: Verify that when a subscription’s TTL expires without renewal the DUT ceases sending event notifications to that subscriber.
Stimulus:
Subscribe to eventgroup 0x0002 with TTL = 3 seconds, wait 5 seconds without
renewal, observe events.
Expected Result: No NOTIFICATION messages received after TTL expiry window.
Not verified: the reaction to an explicit TriggerEventUint8 call (the DUT has no trigger method).
SD Message Format Tests#
- DUT Config:
tests/tc8_conformance/config/tc8_someipd_sd.json- Test Module:
test_sd_format
TC8-SDF-001: Client ID#
- OA Reference:
Section 6.1.5.1, SOMEIPSRV_FORMAT_01
- Requirement:
comp_req__tc8_conformance__sd_offer_format- Test Function:
TestSDFormat::test_format_01_client_id
Purpose: Verify that the Client ID of SD messages sent by the DUT is 0x0000.
Stimulus: None, passive observation of DUT SD messages.
Expected Result:
Client ID = 0x0000.
TC8-SDF-002: Protocol Version#
- OA Reference:
Section 6.1.5.1, SOMEIPSRV_FORMAT_03
- Requirement:
comp_req__tc8_conformance__sd_offer_format- Test Function:
TestSDFormat::test_format_03_protocol_version
Purpose: Verify that the Protocol Version of SD messages sent by the DUT is 0x01.
Stimulus: None, passive observation of DUT SD messages.
Expected Result:
Protocol Version = 0x01.
TC8-SDF-003: Message Type#
- OA Reference:
Section 6.1.5.1, SOMEIPSRV_FORMAT_05
- Requirement:
comp_req__tc8_conformance__sd_offer_format- Test Function:
TestSDFormat::test_format_05_message_type
Purpose: Verify that the Message Type of SD messages sent by the DUT is 0x02.
Stimulus: None, passive observation of DUT SD messages.
Expected Result:
Message Type = 0x02.
TC8-SDF-004: Return Code#
- OA Reference:
Section 6.1.5.1, SOMEIPSRV_FORMAT_06
- Requirement:
comp_req__tc8_conformance__sd_offer_format- Test Function:
TestSDFormat::test_format_06_return_code
Purpose: Verify that the Return Code of SD messages sent by the DUT is 0x00.
Stimulus: None, passive observation of DUT SD messages.
Expected Result:
Return Code = 0x00.
TC8-SDF-005: Unicast Flag#
- OA Reference:
Section 6.1.5.1, SOMEIPSRV_FORMAT_08
- Requirement:
comp_req__tc8_conformance__sd_offer_format- Test Function:
TestSDFormat::test_format_08_unicast_flag
Purpose: Verify that the Unicast Flag of SD messages sent by the DUT is set.
Stimulus: None, passive observation of DUT SD messages.
Expected Result: Unicast Flag bit = 1.
TC8-SDF-006: Undefined Flag Bits#
- OA Reference:
Section 6.1.5.1, SOMEIPSRV_FORMAT_09
- Requirement:
comp_req__tc8_conformance__sd_offer_format- Test Function:
TestSDFormat::test_format_09_undefined_flag_bits
Purpose: Verify that the undefined bits of the SD Flags field are 0.
Stimulus: None, passive observation of DUT SD messages.
Expected Result: The six Flag bits other than the Reboot and Unicast bits are 0.
TC8-SDF-007: Reserved Bits#
- OA Reference:
Section 6.1.5.1, SOMEIPSRV_FORMAT_10
- Requirement:
comp_req__tc8_conformance__sd_offer_format- Test Function:
TestSDFormat::test_format_10_reserved_bits
Purpose: Verify that the Reserved field of SD messages sent by the DUT is 0.
Stimulus: None, passive observation of DUT SD messages.
Expected Result:
Reserved = 0x000000.
TC8-SDF-008: Type 1 Entry Length#
- OA Reference:
Section 6.1.5.1, SOMEIPSRV_FORMAT_11
- Requirement:
comp_req__tc8_conformance__sd_offer_format- Test Function:
TestSDOfferEntryFormat::test_format_11_type_1_entry_length
Purpose: Verify the Entry Type and the Entries Array length of OfferService messages.
Stimulus: None, passive observation of DUT SD messages.
Expected Result:
Entry Type = 0x01 and Entries Array length = number of entries x 16.
TC8-SDF-009: Type 1 Index First Option Run#
- OA Reference:
Section 6.1.5.1, SOMEIPSRV_FORMAT_12
- Requirement:
comp_req__tc8_conformance__sd_offer_format- Test Function:
TestSDOfferEntryFormat::test_format_12_type_1_index_first_option_run
Purpose: Verify the Index First Option Run of OfferService entries.
Stimulus: None, passive observation of DUT SD messages.
Expected Result: Index First Option Run = 0.
TC8-SDF-010: Type 1 Number of Options 1#
- OA Reference:
Section 6.1.5.1, SOMEIPSRV_FORMAT_13
- Requirement:
comp_req__tc8_conformance__sd_offer_format- Test Function:
TestSDOfferEntryFormat::test_format_13_type_1_number_of_options_1
Purpose: Verify that the OfferService (Type 1) entry in the Service Discovery message correctly defines the number of options utilized in its first option run.
Stimulus: None, passive observation of DUT SD messages.
Expected Result: Number of Options 1 >= 1.
TC8-SDF-011: Offer TTL#
- OA Reference:
Section 6.1.5.3, SOMEIPSRV_SD_MESSAGE_07
- Requirement:
comp_req__tc8_conformance__sd_offer_format- Test Function:
TestSDOfferEntryFormat::test_sd_message_07_offer_ttl
Purpose: Verify that the TTL of an OfferService entry equals the lifetime of the service instance.
Stimulus:
Send FindService for service 0x1234 and take the OfferService.
Expected Result:
TTL = 30 (configured ttl).
Not verified: OA steps 6 to 9 (wait for the TTL timeout, send a Request, expect no Response). The DUT keeps offering the service cyclically.
TC8-SDF-012: Type 2 Entry Type#
- OA Reference:
Section 6.1.5.1, SOMEIPSRV_FORMAT_19
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeAckFormat::test_format_19_type_2_entry_type
Purpose: Verify the Entry Type of the SubscribeEventgroupAck.
Stimulus:
Send FindService for service 0x1234, take the OfferService, send
SubscribeEventgroup for eventgroup 0x0002 with TTL = 30 (configured ttl) and
capture the SubscribeEventgroupAck.
Expected Result:
Entry Type = 0x07.
TC8-SDF-013: Type 2 Entry Length#
- OA Reference:
Section 6.1.5.1, SOMEIPSRV_FORMAT_20
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeAckFormat::test_format_20_type_2_entry_length
Purpose: Verify the Entries Array length of the SubscribeEventgroupAck.
Stimulus:
Send FindService for service 0x1234, take the OfferService, send
SubscribeEventgroup for eventgroup 0x0002 with TTL = 30 (configured ttl) and
capture the SubscribeEventgroupAck.
Expected Result: Entries Array length = number of entries x 16.
TC8-SDF-014: Type 2 Index First Option Run#
- OA Reference:
Section 6.1.5.1, SOMEIPSRV_FORMAT_21
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeAckFormat::test_format_21_type_2_index_first_option_run
Purpose: Verify the Index First Option Run of the SubscribeEventgroupAck entry.
Stimulus:
Send FindService for service 0x1234, take the OfferService, send
SubscribeEventgroup for eventgroup 0x0002 with TTL = 30 (configured ttl) and
capture the SubscribeEventgroupAck.
Expected Result: Index First Option Run = 0.
TC8-SDF-015: Type 2 Service ID#
- OA Reference:
Section 6.1.5.1, SOMEIPSRV_FORMAT_23
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeAckFormat::test_format_23_type_2_service_id
Purpose: Verify the Service ID of the SubscribeEventgroupAck entry.
Stimulus:
Send FindService for service 0x1234, take the OfferService, send
SubscribeEventgroup for eventgroup 0x0002 with TTL = 30 (configured ttl) and
capture the SubscribeEventgroupAck.
Expected Result:
Service ID = 0x1234.
TC8-SDF-016: Type 2 Instance ID#
- OA Reference:
Section 6.1.5.1, SOMEIPSRV_FORMAT_24
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeAckFormat::test_format_24_type_2_instance_id
Purpose: Verify the Instance ID of the SubscribeEventgroupAck entry.
Stimulus:
Send FindService for service 0x1234, take the OfferService, send
SubscribeEventgroup for eventgroup 0x0002 with TTL = 30 (configured ttl) and
capture the SubscribeEventgroupAck.
Expected Result:
Instance ID = 0x5678.
TC8-SDF-017: Type 2 Major Version#
- OA Reference:
Section 6.1.5.1, SOMEIPSRV_FORMAT_25
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeAckFormat::test_format_25_type_2_major_version
Purpose: Verify the Major Version of the SubscribeEventgroupAck entry.
Stimulus:
Send FindService for service 0x1234, take the OfferService, send
SubscribeEventgroup for eventgroup 0x0002 with TTL = 30 (configured ttl) and
capture the SubscribeEventgroupAck.
Expected Result:
Major Version = 0x01.
TC8-SDF-018: Type 2 TTL#
- OA Reference:
Section 6.1.5.1, SOMEIPSRV_FORMAT_26
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeAckFormat::test_format_26_type_2_ttl
Purpose: Verify the TTL of the SubscribeEventgroupAck entry.
Stimulus:
Send FindService for service 0x1234, take the OfferService, send
SubscribeEventgroup for eventgroup 0x0002 with TTL = 30 (configured ttl) and
capture the SubscribeEventgroupAck.
Expected Result:
TTL = 30 (configured ttl).
TC8-SDF-019: Type 2 Reserved#
- OA Reference:
Section 6.1.5.1, SOMEIPSRV_FORMAT_27
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeAckFormat::test_format_27_type_2_reserved
Purpose: Verify the Reserved field of the SubscribeEventgroupAck entry.
Stimulus:
Send FindService for service 0x1234, take the OfferService, send
SubscribeEventgroup for eventgroup 0x0002 with TTL = 30 (configured ttl) and
capture the SubscribeEventgroupAck.
Expected Result:
Reserved = 0x0000.
TC8-SDF-020: Type 2 Eventgroup ID#
- OA Reference:
Section 6.1.5.1, SOMEIPSRV_FORMAT_28
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeAckFormat::test_format_28_type_2_eventgroup_id
Purpose: Verify the Eventgroup ID of the SubscribeEventgroupAck entry.
Stimulus:
Send FindService for service 0x1234, take the OfferService, send
SubscribeEventgroup for eventgroup 0x0002 with TTL = 30 (configured ttl) and
capture the SubscribeEventgroupAck.
Expected Result:
Eventgroup ID = 0x0002.
TC8-SDF-021: Notification Interface Version#
- OA Reference:
Section 6.1.5.1, SOMEIPSRV_FORMAT_04
- Requirement:
comp_req__tc8_conformance__sd_offer_format- Test Function:
TestNotificationFormat::test_format_04_interface_version
Purpose: Verify that the Interface Version of a notification sent by the DUT is 0x01.
Stimulus:
Subscribe to eventgroup 0x0002 with TTL = 30 (configured ttl) and receive the
notifications of service 0x1234 for 10 s.
Expected Result:
Interface Version = 0x01 in every notification received.
SD Find Response Tests#
- DUT Config:
tests/tc8_conformance/config/tc8_someipd_sd.json- Test Module:
test_sd_find
TC8-SDR-001: Discover Port and IP#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_060
- Requirement:
comp_req__tc8_conformance__sd_find_response- Test Function:
TestSDFindResponse::test_ets_060_discover_port_and_ip
Purpose: Verify that a multicast FindService is answered with a unicast OfferService that states the IP addresses and ports needed to reach the service.
Stimulus:
Send a multicast FindService for service 0x1234 and instance 0x5678.
Expected Result:
Unicast OfferService with an IPv4 Endpoint Option for UDP (TC8_DUT_IP, port 30509).
Not verified: a TCP Endpoint Option (the DUT configuration has no reliable port).
TC8-SDR-002: Ignore Options in FindService#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_118
- Requirement:
comp_req__tc8_conformance__sd_find_response- Test Function:
TestSDFindResponse::test_ets_118_ignore_options_in_findservice
Purpose: Verify that the DUT ignores the options of a FindService.
Stimulus: Send 10 FindService messages with an IPv4 Endpoint Option at 100 ms intervals.
Expected Result: At least one unicast OfferService.
TC8-SDR-003: Multicast FindService#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_127
- Requirement:
comp_req__tc8_conformance__sd_find_response- Test Function:
TestSDFindResponse::test_ets_127_multicast_findservice
Purpose: Verify that a multicast FindService for a valid service and instance is answered with a unicast OfferService.
Stimulus:
Send 10 multicast FindService messages at 100 ms intervals for service 0x1234 and
instance 0x5678.
Expected Result: At least one unicast OfferService.
SD TCP Tests#
- DUT Config:
tests/tc8_conformance/config/tc8_someipd_service.json- Test Module:
test_sd_tcp
TC8-SDT-001: Layer 4 Protocol of TCP Endpoint Option#
- OA Reference:
Section 6.1.5.2, SOMEIPSRV_OPTIONS_15
- Requirement:
comp_req__tc8_conformance__sd_endpoint_option- Test Function:
TestSDTcpBinding::test_options_15_tcp_endpoint_l4_protocol
Purpose: Verify that an OfferService of a TCP-only service carries exactly one IPv4 Endpoint Option and that its Layer 4 protocol is TCP.
Stimulus:
Send FindService for service 0x1234 and take the OfferService.
Expected Result:
Exactly one IPv4 Endpoint Option, with Layer 4 protocol 0x06 (TCP).
The module uses a TCP-only service configuration (reliable port, no unreliable port), so the OfferService carries a single Endpoint Option.
TC8-SDT-002: Subscribe With TCP Option Without Connection#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_096
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDTcpBinding::test_ets_096_subscribe_tcp_option_without_connection
Purpose: Verify that a SubscribeEventgroup for eventgroup 0x0002 with a TCP Endpoint Option is rejected when no TCP connection exists.
Stimulus:
Send SubscribeEventgroup for eventgroup 0x0002 with a TCP Endpoint Option, without
establishing the TCP connection.
Expected Result: SubscribeEventgroupNAck.
SD Subscribe Option Tests#
- DUT Config:
tests/tc8_conformance/config/tc8_someipd_sd.json- Test Module:
test_sd_subscribe_options
TC8-SDO-001: No Port in Endpoint Option#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_109
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeEndpointOptions::test_ets_109_no_port_in_endpoint_option
Purpose: Verify that a SubscribeEventgroup whose Endpoint Option has port 0 is rejected.
Stimulus: Send SubscribeEventgroup with port 0 in the Endpoint Option.
Expected Result: SubscribeEventgroupNAck.
TC8-SDO-002: No IPv4 Address in Endpoint Option#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_110
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeEndpointOptions::test_ets_110_no_ipv4_address_in_endpoint_option
Purpose: Verify that a SubscribeEventgroup without a valid IPv4 address in the Endpoint Option is rejected.
Stimulus: Send SubscribeEventgroup with IP address 32.0.0.0 in the Endpoint Option.
Expected Result: SubscribeEventgroupNAck.
TC8-SDO-003: Wrong L4 Protocol in Endpoint Option#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_119
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeEndpointOptions::test_ets_119_wrong_l4proto
Purpose: Verify that a SubscribeEventgroup whose IPv4 Endpoint Option has an l4proto that is neither UDP nor TCP is rejected.
Stimulus:
Send SubscribeEventgroup referencing an IPv4 Endpoint Option with l4proto 0x00.
Expected Result: SubscribeEventgroupNAck.
The OA Pass criteria say “at least one unicast OfferService”, which contradicts the OA
procedure and synopsis. The test follows the procedure and synopsis. The OA gives no
l4proto value, 0x00 is a neutral choice.
TC8-SDO-004: Non-existent IPv4 Address in Endpoint Option#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_154
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeEndpointOptions::test_ets_154_unexisting_ipv4_address
Purpose: Verify that a SubscribeEventgroup with a non-existent IPv4 address in the Endpoint Option is rejected.
Stimulus: Send SubscribeEventgroup with a non-existent IP address (169.254.200.200) in the Endpoint Option (the OA specification does not provide a specific address; this value is chosen as a neutral fallback).
Expected Result: SubscribeEventgroupNAck.
Expected failure (strict xfail). OA expectation: SubscribeEventgroupNAck. Observed: no NAck received.
TC8-SDO-005: Endpoint Option With DUT IP Address#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_162
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeEndpointOptions::test_ets_162_unallowed_option_ip
Purpose: Verify that a SubscribeEventgroup whose Endpoint Option carries the IP address of the DUT is rejected.
Stimulus: Send SubscribeEventgroup with the DUT IP address in the Endpoint Option.
Expected Result: SubscribeEventgroupNAck.
TC8-SDO-006: Endpoint Option With 111.111.111.111#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_164
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeEndpointOptions::test_ets_164_unallowed_option_ip_2
Purpose: Verify that a SubscribeEventgroup whose Endpoint Option carries IP address 111.111.111.111 is rejected.
Stimulus: Send SubscribeEventgroup with IP address 111.111.111.111 in the Endpoint Option.
Expected Result: SubscribeEventgroupNAck.
TC8-SDO-007: Unicast SubscribeEventgroup With Option Indexes#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_172 (alias SOMEIP_ETS_173)
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeEndpointOptions::test_ets_172_unicast_subscribe_option_indexes
Purpose: Verify that unicast subscriptions with different option index and run settings are acknowledged.
Stimulus: Send a unicast SubscribeEventgroup with index1stOptions = 0, index2ndOptions = 1, numOfOptions1 = 1, numOfOptions2 = 1. Then send one with index1stOptions = 0, index2ndOptions = 0, numOfOptions1 = 2, numOfOptions2 = 0. The OA gives no option content: the test uses one UDP and one TCP IPv4 Endpoint Option, both with the tester IP address and the sender port.
Expected Result: A unicast SubscribeEventgroupAck for each.
The PDF heading prints SOMEIP_ETS_172 and SOMEIP_ETS_173 for this test.
Expected failure (strict xfail). OA expectation: a unicast SubscribeEventgroupAck for each option layout. Observed: no Ack received for either layout.
TC8-SDO-008: Unreferenced Option#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_175
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDSubscribeEndpointOptions::test_ets_175_unreferenced_option
Purpose: Verify that an unreferenced Configuration Option does not stop the DUT from acknowledging a subscription.
Stimulus:
Send SubscribeEventgroup with all needed Endpoint Options and an additional unreferenced
Configuration Option. The OA gives no option content: the test appends the bytes
00 02 01 00 00 (empty string) after the Endpoint Option, and the entry does not
reference them.
Expected Result: SubscribeEventgroupAck.
SD Malformed Message Tests#
- DUT Config:
tests/tc8_conformance/config/tc8_someipd_sd.json- Test Module:
test_sd_malformed
Base message of all entries: one SubscribeEventgroup entry that references one UDP IPv4 Endpoint Option (tester IP address, sender port). The OA gives no option content.
TC8-SDX-001: Empty Entries Array#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_111
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDMalformedArrays::test_ets_111_empty_entries_array
Purpose: Verify that a SubscribeEventgroup with an empty Entries Array is ignored.
Stimulus: Send a SubscribeEventgroup entry with the Entries Array length field set to 0.
Expected Result: No SD entry of any type within 5 s.
The OA synopsis says a total length of zero “should not be interpreted”. The test sends a real entry with the length field set to 0.
TC8-SDX-002: Empty Option#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_112
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDMalformedArrays::test_ets_112_empty_option
Purpose: Verify that a SubscribeEventgroup with IPv4 Option length 0 is rejected.
Stimulus:
Send SubscribeEventgroup for eventgroup 0x0002 with the length field of the IPv4
Endpoint Option set to 0.
Expected Result: SubscribeEventgroupNAck.
ETS_112 and ETS_113 share the same synopsis text in the OA.
TC8-SDX-003: Empty Options Array#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_113
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDMalformedArrays::test_ets_113_empty_options_array
Purpose: Verify that a SubscribeEventgroup with Options Array length 0 is rejected.
Stimulus:
Send SubscribeEventgroup for eventgroup 0x0002 with Options Array length 0 and an
entry that references no option.
Expected Result: SubscribeEventgroupNAck.
The OA synopsis says “IPv4Option length = 0”, the OA procedure says “options array length = 0”. The test follows the procedure. The OA does not say whether the entry references options.
TC8-SDX-004: Entries Length Wrong, Two Entries#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_114
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDMalformedArrays::test_ets_114_entries_length_wrong_combined
Purpose: Verify that a SubscribeEventgroup with two correct entries but a shortened Entries Array length is rejected.
Stimulus: Send two identical SubscribeEventgroup entries with the Entries Array length set to 16 (one entry).
Expected Result: SubscribeEventgroupNAck.
TC8-SDX-005: More Option References Than Options#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_115
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDMalformedArrays::test_ets_115_entry_references_more_options_than_exist
Purpose: Verify that a SubscribeEventgroup that references more options than exist is rejected.
Stimulus: Send SubscribeEventgroup with Number of Options 1 = 3 and one existing option. The OA gives no count.
Expected Result: SubscribeEventgroupNAck.
TC8-SDX-006: Unknown Option Type 0x77#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_116
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDMalformedArrays::test_ets_116_entry_references_non_existing_option_type
Purpose: Verify that a SubscribeEventgroup that references an unknown option type (0x77) is rejected.
Stimulus:
Send SubscribeEventgroup referencing an option of type 0x77 with length field 5, one
reserved byte and four zero bytes.
Expected Result: SubscribeEventgroupNAck.
TC8-SDX-007: Two Options of the Same Kind#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_117
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDMalformedArrays::test_ets_117_entry_references_options_of_same_kind
Purpose: Verify that a SubscribeEventgroup with two options of the same type is rejected or ignored.
Stimulus: Send one SubscribeEventgroup entry with Number of Options 1 = 2 and two identical IPv4 Endpoint Options (tester IP address, sender port).
Expected Result: SubscribeEventgroupNAck or no reaction (no Ack with TTL above 0).
TC8-SDX-008: Entries Array Longer Than Message#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_123
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDMalformedArrays::test_ets_123_length_of_entry_array_longer_than_message_allows
Purpose: Verify that a SubscribeEventgroup whose Entries Array length exceeds the total length is rejected.
Stimulus: Send SubscribeEventgroup with the Entries Array length set to the datagram length plus 1 (the OA gives no value).
Expected Result: SubscribeEventgroupNAck.
The OA synopsis says the message is “unrecognizable” or “too damaged to be answered with an Ack”, the OA procedure and Pass criteria require a NAck. The test follows the procedure.
Expected failure (strict xfail). OA expectation: SubscribeEventgroupNAck. Observed: no NAck received within 5 s.
TC8-SDX-009: Entries Array Too Long#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_124
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDMalformedArrays::test_ets_124_length_of_entry_array_too_long
Purpose: Verify that a SubscribeEventgroup whose Entries Array length exceeds the total length by at least 20 bytes is rejected.
Stimulus: Send SubscribeEventgroup with the Entries Array length set to the datagram length plus 20.
Expected Result: SubscribeEventgroupNAck.
The OA synopsis says the Entries Array length “does not exceed” the Message total length, the OA procedure says it exceeds it by at least 20 bytes. The test follows the procedure.
Expected failure (strict xfail). OA expectation: SubscribeEventgroupNAck. Observed: no NAck received within 5 s.
TC8-SDX-010: Entries Array Too Short#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_125
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDMalformedArrays::test_ets_125_length_of_entry_array_too_short
Purpose: Verify that a SubscribeEventgroup whose Entries Array length is less than the sum of the lengths of its entries is rejected.
Stimulus: Send one SubscribeEventgroup entry (16 bytes) with the Entries Array length set to 15. The OA gives no value.
Expected Result: SubscribeEventgroupNAck.
Expected failure (strict xfail). OA expectation: SubscribeEventgroupNAck. Observed: no NAck received within 5 s.
TC8-SDX-011: Option Ends Past Options Array, Variant A#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_134
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDMalformedOptionsAndHeader::test_ets_134_option_length_ends_past_options_array_var_a
Purpose: Verify that a SubscribeEventgroup whose option length surpasses the Options Array length is rejected or ignored.
Stimulus: Send SubscribeEventgroup with the SOME/IP length and the Options Array length both cut by 4 bytes, option length fields unchanged, one option. The OA cuts both by 12 bytes (60 to 48 and 24 to 12).
Expected Result: SubscribeEventgroupNAck or no reaction (no Ack with TTL above 0).
The OA synopsis implies two options of 12 bytes, the OA procedure only says “option length greater than the options array length”. The test follows the synopsis shape with one option.
TC8-SDX-012: Option Ends Past Options Array, Variant B#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_135
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDMalformedOptionsAndHeader::test_ets_135_option_length_ends_past_options_array_var_b
Purpose: Verify that a SubscribeEventgroup whose option length surpasses the Options Array length is rejected or ignored.
Stimulus: Send SubscribeEventgroup with Options Array length 8 and one option of 12 bytes. The OA gives no value.
Expected Result: SubscribeEventgroupNAck or no reaction (no Ack with TTL above 0).
The OA synopsis ends with a NAck only, the OA procedure and Pass criteria allow a NAck or no reaction. The test follows the procedure.
TC8-SDX-013: UDP Option Length 4#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_136
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDMalformedOptionsAndHeader::test_ets_136_option_length_shorter_gt_0_as_specified_for_type
Purpose: Verify that a SubscribeEventgroup with a UDP option length shorter than specified for the type is rejected or ignored.
Stimulus: Send SubscribeEventgroup with the length field of the UDP IPv4 Endpoint Option set to 4 instead of 9.
Expected Result: SubscribeEventgroupNAck or no reaction (no Ack with TTL above 0).
TC8-SDX-014: Shorter Option With Unaligned Next Option#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_137
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDMalformedOptionsAndHeader::test_ets_137_option_shorter_with_unaligned_next_option
Purpose: Verify that a SubscribeEventgroup with wrong sized options that keep the total Options Array length is rejected.
Stimulus: Send one SubscribeEventgroup entry with Number of Options 1 = 2 and these options, in this order: a TCP IPv4 Endpoint Option with length field 14 followed by 5 dummy bytes, then a UDP IPv4 Endpoint Option with length field 4 followed by 7 bytes. The Options Array length is 24 and the SOME/IP length is consistent with the datagram.
Expected Result: SubscribeEventgroupNAck.
Known limitation: A NAck is also returned for a valid Subscribe that references two options, so this check cannot attribute the NAck to the injected fault alone.
TC8-SDX-015: Options Array Longer Than Message#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_138
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDMalformedOptionsAndHeader::test_ets_138_options_array_longer_than_message_allows
Purpose: Verify that a SubscribeEventgroup whose Options Array length is longer than the message is acknowledged or ignored.
Stimulus: Send SubscribeEventgroup with Options Array length 0x28 and one option of 12 bytes.
Expected Result: SubscribeEventgroupAck or no reaction (no NAck).
The OA synopsis says “0x28 instead of 0x18”, which assumes a 24 byte array with two options. The test keeps 0x28 with one option.
TC8-SDX-016: Options Array Too Short#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_139
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDMalformedOptionsAndHeader::test_ets_139_options_array_too_short
Purpose: Verify that a SubscribeEventgroup whose Options Array length is shorter than required is rejected.
Stimulus: Send SubscribeEventgroup with Options Array length 2 and one option of 12 bytes.
Expected Result: SubscribeEventgroupNAck.
TC8-SDX-017: SOME/IP Length Shorter Than Actual#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_153
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDMalformedOptionsAndHeader::test_ets_153_someip_length_shorter_as_expected
Purpose: Verify that a SubscribeEventgroup whose SOME/IP length is less than the actual length is rejected or ignored.
Stimulus: Send SubscribeEventgroup with the SOME/IP length set to the actual length minus 1.
Expected Result: SubscribeEventgroupNAck or no reaction (no Ack with TTL above 0).
TC8-SDX-018: Unknown Option Type#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_174
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDMalformedOptionsAndHeader::test_ets_174_unknown_option_type
Purpose: Verify that a SubscribeEventgroup that references an unknown option type is rejected.
Stimulus:
Send one SubscribeEventgroup entry with Number of Options 1 = 2. Option 0 has the
unknown type 0x77 (length field 9, zero content), option 1 is a UDP IPv4 Endpoint
Option. The OA layout uses a TCP option instead of the unknown option.
Expected Result: SubscribeEventgroupNAck.
Known limitation: A NAck is also returned for a valid Subscribe that references two options, so this check cannot attribute the NAck to the injected fault alone.
TC8-SDX-019: Unused Data After Options Array#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_176
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDMalformedOptionsAndHeader::test_ets_176_unused_data_after_options_array
Purpose: Verify that unused payload data after the Options Array does not stop the DUT from acknowledging a unicast subscription.
Stimulus:
Send a unicast SubscribeEventgroup with the unused data 0x30303a3031 after the
Options Array, counted in the SOME/IP length. Then send one with the same data, not
counted in the SOME/IP length.
Expected Result: A SubscribeEventgroupAck for each.
TC8-SDX-020: Unused Data After Options Array, Wrong Length#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_177
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDMalformedOptionsAndHeader::test_ets_177_unused_data_after_options_array_wrong_length
Purpose: Verify that unused payload data that is not included in the SOME/IP length does not stop the DUT from acknowledging a unicast subscription.
Stimulus:
Send a unicast SubscribeEventgroup with the unused data 0x30303a3031 at the end, not
included in the SOME/IP length.
Expected Result: SubscribeEventgroupAck.
TC8-SDX-021: Wrong SOME/IP Message ID#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_178
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestSDMalformedOptionsAndHeader::test_ets_178_subscribe_using_wrong_someip_messageid
Purpose: Verify that a SubscribeEventgroup whose SOME/IP header has a wrong Message ID for Service Discovery is rejected.
Stimulus:
Send SubscribeEventgroup with Method ID 0x8101 instead of 0x8100 in the SOME/IP
header (the OA gives no value).
Expected Result: SubscribeEventgroupNAck.
Expected failure (strict xfail). OA expectation: SubscribeEventgroupNAck. Observed: no NAck received within 5 s.
SD Initial Field and Reboot Detection Tests#
- DUT Config:
tests/tc8_conformance/config/tc8_someipd_sd.json- Test Module:
test_sd_initial_fields
TC8-SDI-001: Initial Fields, Eventgroup 0x0002#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_086
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestEts086::test_ets_086_events_and_fields_all_2
Purpose: Verify that the DUT acknowledges a subscription to eventgroup 0x0002 and sends all initial fields.
Stimulus:
Wait 6 s after the DUT is ready, so that the DUT application has published its field
values. Then subscribe to eventgroup 0x0002 and receive events for 4 s after the Ack.
Expected Result:
SubscribeEventgroupAck, then the initial fields 0x8005 (Interface Version), 0x8006
(TestfieldUINT8) and 0x8007 (TestfieldUINT8Array) to the tester endpoint.
Not verified: field 0x8008 (TestFieldUINT8Reliable), the DUT configuration has no
reliable port.
Expected failure (strict xfail). OA expectation: the initial fields 0x8005 to
0x8007 after the Ack. Observed: the Ack is received, the initial fields are not.
TC8-SDI-002: Initial Fields, Eventgroup 0x0005#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_087
- Requirement:
comp_req__tc8_conformance__sd_sub_lifecycle- Test Function:
TestEts087::test_ets_087_events_and_fields_unreliable_5
Purpose: Verify that the DUT acknowledges a subscription to eventgroup 0x0005 and sends all initial fields.
Stimulus:
Wait 6 s after the DUT is ready, so that the DUT application has published its field
values. Then subscribe to eventgroup 0x0005 and receive events for 4 s after the Ack.
Expected Result:
SubscribeEventgroupAck, then the initial fields 0x8005 (Interface Version), 0x8006
(TestfieldUINT8) and 0x8007 (TestfieldUINT8Array) to the tester endpoint.
Expected failure (strict xfail). OA expectation: the initial fields 0x8005 to
0x8007 after the Ack. Observed: the Ack is received, the initial fields are not.
TC8-SDI-003: Reboot Detection, Multicast and Unicast#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_093
- Requirement:
comp_req__tc8_conformance__sd_reboot- Test Function:
TestEts093::test_ets_093_reboot_detection_multicast_and_unicast
Purpose: Verify that the DUT detects a client reboot (lower Session ID) separately for multicast and unicast messages.
Stimulus:
All SD messages set the Reboot flag. Each step waits 2 s for the initial event.
A: multicast FindService (Session ID 4, 5, 1), each followed by a unicast
SubscribeEventgroup for eventgroup 0x0005 with the same Session ID.
B: after a 4 s wait, so that the subscription of part A expires, unicast
SubscribeEventgroup with Session ID 4, 5, 1.
C: multicast FindService with Session ID 100, 101, 102, each followed by a unicast
SubscribeEventgroup with Session ID 10, 11, 12. The OA gives no wait time before B and no
Session IDs for C, these values are neutral choices.
Expected Result:
A, B: SubscribeEventgroupAck each time. Initial event of field 0x8005 after the first
subscription, not after the second, again after the third (Session ID 1). C: no
initial event, no reboot detected.
Expected failure (strict xfail). OA expectation: the initial event 0x8005 again
after the subscription with Session ID 1 in A and B. Observed: 0x8005 is received only
after the first subscription of part A, not after Session ID 1 in A, nor after Session IDs
4 and 1 in B. Part C shows no initial event.
TC8-SDI-004: Reboot Detection, Server Side#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_094
- Requirement:
comp_req__tc8_conformance__sd_reboot- Test Function:
TestEts094::test_ets_094_reboot_detection_server_side
Purpose: Verify that the DUT detects a reboot of the tester and stops sending events.
Stimulus:
All SD messages set the Reboot flag. Subscribe to eventgroup 0x0002 with Session ID 1
and TTL 0xFFFFFF (a short TTL would end the events by itself). Send FindService with
Session ID 5, then again with Session ID 5 (reboot simulation).
Expected Result: SubscribeEventgroupAck, events continue after the first FindService and stop after the second.
Not verified: the TriggerEventUint8 call (the DUT has no trigger method). The cyclic event
0x8001 is observed instead.
SD Session ID Wrap Test#
- DUT Config:
tests/tc8_conformance/config/tc8_someipd_sd.json- Test Module:
test_sd_session_wrap
TC8-SDW-001: Session ID Is One After Wrapping#
- OA Reference:
Section 6.1.6, SOMEIP_ETS_152
- Requirement:
comp_req__tc8_conformance__sd_offer_format- Test Function:
TestSDSessionWrap::test_ets_152_session_id_one_after_wrap
Purpose: Verify that the Session ID of the OfferService responses restarts at 0x0001 after the wrap around.
Stimulus:
Send unicast FindService messages in bursts of 50 until the Session ID of the
OfferService responses for instance 0x5678 wraps. The OA gives no message count.
Expected Result:
The first Session ID after 0xFFFF is 0x0001.
The OA Pass criteria also list a SubscribeEventgroupAck, which no step sends. It is not checked.