Datarouter Component Requirements

Datarouter Component Requirements		status: valid security: NO safety: QM
version: 1 realizes: wp__requirements_comp
doc__data_router_requirements		Generic Document

Datarouter Services

Datarouter DLT Server		status: valid security: NO safety: QM
reqtype: Functional testlink: DataRouterTestFixture__ConstructionAndDestructionOnStack (passed); DataRouterTestFixture__ConstructionAndDestructionOnHeap (passed); DataRouterTestFixture__TestUsingTheDefaultStackAndRingSizesIfTheUserProvidesZeros (passed); DataRouterTestFixture__TestSomeConditionsInsideTickMethodWithDisablingDlt (passed); UdpStreamOutputFixture__SendMethodShallSucceedIfSendmmsgSucceeded (passed); DltServerCreatedWithoutConfigFixture__WhenCreatedDefault (passed) version: 1 derived from: feat_req__logging__compat_dlt satisfied by: comp__datarouter
Datarouter shall implement a DLT server, sending messages in the DLT packet format.
comp_req__data_router__dlt_server		Component Requirement

DLT Server UDP Multicast Transport		status: valid security: NO safety: QM
reqtype: Functional version: 1 derived from: feat_req__logging__log_sinks_network satisfied by: comp__datarouter
Datarouter shall transmit the DLT messages of its DLT server over UDP multicast.
comp_req__data_router__dlt_udp_multicast		Component Requirement

DLT Multiple Channel Support		status: valid security: NO safety: QM
reqtype: Functional testlink: SocketserverConfigTest__ReadCorrectLogChannelsNoErrorsExpected (passed); DltChannelTest__WhenCreatedDefault (passed) version: 1 derived from: feat_req__logging__compat_dlt satisfied by: comp__datarouter
Datarouter shall support multiple log channels in its DLT server, each with its own destination and filter settings, as specified in AUTOSAR Diagnostic, Log and Trace Protocol Specification.
comp_req__data_router__dlt_multiple_channels		Component Requirement

Datarouter Configuration File		status: valid security: NO safety: QM
reqtype: Functional version: 1 derived from: feat_req__logging__config_log_filter satisfied by: comp__datarouter
Datarouter shall be able to read a deployment-specific configuration file located at <data_router binary location>/../etc/log-channels.json.
comp_req__data_router__config_file		Component Requirement

DLT Channel Configuration		status: valid security: NO safety: QM
reqtype: Functional version: 1 derived from: feat_req__logging__config_entity_id, feat_req__logging__config_log_filter satisfied by: comp__datarouter
The following parameters of the DLT log channels (DLT Multiple Channel Support (comp_req__data_router__dlt_multiple_channels)) shall be configurable statically via the deployment-specific configuration file (Datarouter Configuration File (comp_req__data_router__config_file)): Number and names of channels, Network configuration for channel output, Log level threshold per channel, Log channel assignments per application/context.
comp_req__data_router__dlt_channel_config		Component Requirement

DLT Message Filtering		status: valid security: NO safety: QM
reqtype: Functional testlink: SocketserverConfigTest__ReadCorrectLogChannelsNoErrorsExpected (passed); SocketserverConfigTest__JsonFilteringEnabledExpectConfigFilterTrue (passed); DltChannelTest__WhenLogLevelExceedsThreshold_Verbose (passed); DltChannelTest__WhenNonVerboseLogLevelExceedsThreshold (passed) version: 1 derived from: feat_req__logging__config_log_filter, feat_req__logging__filtering_entity_id, feat_req__logging__filtering_log_levels satisfied by: comp__datarouter
Datarouter shall support filtering of DLT messages within each channel. The filter shall be parametrized with application ID, context ID, log level threshold. Initial filter set shall be part of the deployment-specific configuration file (Datarouter Configuration File (comp_req__data_router__config_file)).
comp_req__data_router__dlt_message_filtering		Component Requirement

DLT Verbose Messages		status: valid security: NO safety: QM
reqtype: Functional testlink: SourceSessionTestFixture__TryFinalizeAcquisitionIsBlockReleased (passed); SourceSessionTestFixture__TryFinalizeAcquisitionIsBlockNotReleased (passed); SourceSessionTestFixture__ProcessAndRouteLogMessagesAcquireFinalized (passed); SourceSessionTestFixture__ProcessAndRouteLogMessagesBlockExpectedToBeNextDataAvailable (passed); SourceSessionTestFixture__ProcessAndRouteLogMessagesBlockExpectedToBeNextDataNotAvailable (passed); SourceSessionTestFixture__ProcessAndRouteLogMessagesNotBlockExpectedToBeNext (passed); SourceSessionTestFixture__RequestAcquire (passed); SourceSessionTestFixture__OnAcquireResponse (passed); SourceSessionTestFixture__IsSourceClosed (passed); SourceSessionTestFixture__ProcessDetachedLogsReaderUsed (passed); DataRouterTestFixture__WhenOnlySourceSession (passed); DataRouterTestFixture__WhenMessageHandledFromRw (passed); DataRouterTestFixture__TestDifferentCountsOfMessagesDropped (passed); DataRouterTestFixture__TestDifferentCountsOfInvalidSizeMessagesDropped (passed); DataRouterTestFixture__CreatingNewSessionShallFailIfTheFileDescriptorIsZero (passed); DataRouterTestFixture__OnSessionDetached (passed); DataRouterTestFixture__OnSessionDetachedWithError (passed); DltChannelTest__WhenSendingVerboseTwice (passed); DltVerboseHandlerTest__sendVerboseTest (passed) version: 1 derived from: feat_req__logging__compat_dlt satisfied by: comp__datarouter
Datarouter shall support verbose DLT messages. Datarouter shall send messages received from the mw::log library via DLT using verbose mode.
comp_req__data_router__dlt_verbose_messages		Component Requirement

DLT Quotas

DLT Bandwidth Quota Configuration		status: valid security: NO safety: QM
reqtype: Functional testlink: DataRouterTest__QuotaValueAsStringMethodShallReturnunlimitedIfTheQuotaIsBiggerThanOrEqualToTheMax (passed); SocketserverConfigTest__JsonQuotasEnabledExpectConfigFilterTrue (passed); DltServerCreatedWithConfigFixture__GetQuotaCorrectAppNameExpectCorrectValue (passed) version: 1 derived from: feat_req__logging__config_buffer_size, feat_req__logging__message_loss_handling, feat_req__logging__qos_message_handling, feat_req__logging__resource_comm_channel satisfied by: comp__datarouter
Datarouter shall have the DLT bandwidth quota configuration in the deployment-specific configuration file (Datarouter Configuration File (comp_req__data_router__config_file)).
comp_req__data_router__dlt_bw_quota_config		Component Requirement

DLT Quota Bandwidth Reduction		status: valid security: NO safety: QM
reqtype: Functional testlink: SourceSessionTestFixture__ProcessAndRouteLogMessagesQuotaLimitExceeded (passed); DataRouterTestFixture__TestQuotaOverEnforcementWithZeroTimeDuration (passed); DataRouterTestFixture__TestQuotaEnforcementWithTimeDurationBiggerThanZero (passed); DataRouterTestFixture__TestQuotaOverLimitationWithTimeDurationBiggerThanZero (passed); DataRouterTestFixture__TestQuotaLimitationWithTimeDurationBiggerThanZeroWithQuotaEnforcementEnabled (passed); SocketserverConfigTest__JsonQuotasEnabledActivated (passed); SocketserverConfigTest__JsonQuotasEnabledDeactivated (passed); DltServerCreatedWithoutConfigFixture__QuotaEnforcementEnabledExpectFalse (passed); DltServerCreatedWithoutConfigFixture__QuotaEnforcementEnabledExpectTrue (passed) version: 1 derived from: feat_req__logging__message_loss_handling, feat_req__logging__qos_message_handling satisfied by: comp__datarouter
Datarouter shall allow users to configure the action to drop DLT messages when a quota is exceeded. Note: The configuration shall be provided as an attribute as part of the DLT quota configuration file (DLT Bandwidth Quota Configu... (comp_req__data_router__dlt_bw_quota_config)).
comp_req__data_router__dlt_quota_bw_reduction		Component Requirement