一、概述

二、限制与约束

三、功能说明

3.1 需求

3.1.1 通用需求

3.1.2 以太网通信

3.1.3 状态处理

3.1.4 与SoAd的交互

3.1.5 订阅事件组重试处理

3.2 报文格式

3.2.1 Entries Array

3.2.2 Opotion Array

3.2.3 示例

3.3 服务发现条目

3.3.1 服务查找相关的Entry

3.3.2 事件组相关的Entry

3.4 发送和接收消息

3.5 服务器服务和事件处理程序的计时和重复

3.6 客户端服务和消费事件组的时间和重复

3.7 错误分类

3.7.1 开发错误

3.7.2 运行错误

四、API接口

4.1 API定义

4.2 回调接口

4.3 调度接口

一、概述

AUTOSAR 服务发现模块提供了检测和提供车辆网络内可用的服务的功能，即功能实体。为此，它利用了IP组播和所谓的SOME/IP-SD消息。服务发现模块（Sd）位于AUTOSAR BSW模式管理器模块（BswM）和AUTOSAR 套接字适配器模块（SoAd）之间。

二、限制与约束

虽然AUTOSAR SD能够响应服务ID、实例ID、主要版本和次要版本的通配符请求（ANY），但此模块只能发送次要版本的通配符查找。

三、功能说明

3.1 需求

3.1.1 通用需求

【规范】服务发现模块应存储服务模式请求，该请求通过调用以下api提供：

Sd_ServerServiceSetState（）和Sd_ClientServiceSetState（），如果Sd_ServerServiceSetState（）服务器服务和Sd客户端服务分别没有引用一个服务器组
如果服务器服务和客户端服务分别引用Sd_ServiceGroupStart和服务器组停止
Sd_ConsumedEventGroupSetState（），如果专用客户端服务请求，则。（注意：允许此API调用不依赖于对SdService服务组的引用）
Sd_EventHandlerSetState（）目前不存在，因为该状态是由服务发现直接从服务器服务的状态推导出来的。

说明：

（1）ServerServiceSetState()函数设置模式：

SD_SERVER_SERVICE_DOWN
SD_SERVER_SERVICE_AVAILABLE

（2） Sd_ClientServiceSetState()设置模式：

SD_CLIENT_SERVICE_RELEASED
SD_CLIENT_SERVICE_REQUESTED

（3）Sd_ConsumedEventGroupSetState()设置模式：

SD_CONSUMED_EVENTGROUP_RELEASED
SD_CONSUMED_EVENTGROUP_REQUESTED

3.1.2 以太网通信

【规范】每个服务发现配置实例应至少具有一个TxPdu ID、一个单播RxPdu ID和一个多播RxPduID，且模块初始化时为期连接的Soad Socket调用SoAd_OpenSoCon()；

【规范】对于不同的链接，应配置单独的服务发现实例容器；

3.1.3 状态处理

【规范】通过API Sd_Init（）调用初始化服务发现模块后，所有配置的服务器服务实例都应具有“SD_SERVER_SERVICE_DOWN”状态，除非服务器服务实例将SdServer服务自动可用设置为true，否则该状态应设置为“SD_SERVER_SERVICE_AVAILABLE”。

【规范】通过调用API Sd_Init（）初始化服务发现模块后，所有配置的客户端服务实例的状态均应为“SD_CLIENT_SERVICE_RELEASED”，除非客户端服务实例的SdClientServiceAutoRequired设置为true，否则该状态应设置为“SD_CLIENT_SERVICE_REQUESTED”

【规范】通过调用API Sd_Init（）初始化服务发现模块后，所有配置的事件组应具有“SD_CONSUMED_EVENTGROUP_发布”状态，除非消耗事件组将“SdConsumed

EventGroupAutoRequired”设置为true，则一旦请求关联的客户端服务实例，状态应设置为“SD_CONSUMED_EVENTGROUP_REQUESTED”。

【规范】服务发现模块应存储服务器和客户端服务实例所引用的所有IP地址分配状态；

【规范】如果使用SD_CONSUMED_EVENTGROUP_REQUESTED调用Sd_ConsumedEventGroupSetState，而其客户端服务实例仍然被发布（SD_CLIENT_SERVICE_RELEASED），则将返回E_NO_OK

【规范】如果sd客户端服务设置为SD_CLIENT_SERVICE_RELEASED（通过Sd_ClientServiceSetState（）或Sd_ServiceGroupStop（）），而一个或多个事件组仍然被请求（SD_CONSUMED_EVENTGROUP_REQUESTED），服务发现应与SD_CONSUMED_EVENTGROUP_RELEASED首先用这些事件组调用

3.1.4 与SoAd的交互

【规范】服务发现模块应能够使用针对服务器和客户端服务实例的api SoAd_EnableRouting（）、SoAd_DisableRouting（）、SoAd_EnableSpecificRouting（）和SoAd_DisableSpecificRouting（）来启用/禁用SoAd模块内的路由组。

【规范】服务发现模块应能够使用API SoAd_IfSpecificRoutingGroupTransmit（）触发初始事件的发送。

【规范】服务发现模块应能够参考每个服务实例/事件组的路由组）。请参见以下配置参数：

SdClientServiceActivationRef (in SdConsumedMethods)
SdConsumedEventGroupMulticastActivationRef
SdConsumedEventGroupTcpActivationRef
SdConsumedEventGroupUdpActivationRef
SdServerServiceActivationRef (in SdProvidedMethods)
SdEventActivationRef (in SdEventHandlerMulticast)
SdEventActivationRef (in SdEventHandlerTcp)
SdEventTriggeringRef (in SdEventHandlerTcp)
SdEventActivationRef (in SdEventHandlerUdp)
SdEventTriggeringRef (in SdEventHandlerUdp)

【规范】服务发现模块应能够参考每个服务实例/事件组的套接字连接和Socket连接组。请参见以下配置参数：

SdClientServiceTcpRef (Service Instance and Eventgroups)
SdClientServiceUdpRef (Service Instance and Eventgroups)
SdConsumedEventGroupMulticastGroupRef (Eventgroup)
SdServerServiceTcpRef (Service Instance and Eventgroups)
SdServerServiceUdpRef (Service Instance and Eventgroups)
SdMulticastEventSoConRef in SdEventHandlerMulticast (Eventgroup)

【规范】服务发现模块只能在分配了IP地址时调用SoAd_IfTransmit（）。： Sd_LocalIpAddrAssignmentChg（）已用当前状态TCPIP_IPADDR_STATE_ASSIGNED进行调用。

【规范】如果SoAd_IfTransmit（）返回E_NOT_OK，则忽略。

【规范】如果适用以下所有条件，则应使用SoAd_ReleaseRemoteAddr（）将每个通配符Socket连接重置为通配符：

套接字连接的远程地址已由SD设置。
客户机服务不再使用套接字连接。即没有收到要约，收到停止要约或TTL已过期。
用户不再使用套接字连接。即，客户端已使用此套接字连接取消订阅所有事件组。如果由于达到SdEventHandlerMulticastThreshold而禁用，则不得套接字连接。

3.1.5 订阅事件组重试处理

订阅事件组重试机制是客户端服务的一个可选功能。如果一些/IP-SD消息丢，并且周期提供之间的间隔很大，以获得快速恢复，或者如果在两个循环提供之间请求一个事件组，则可以加快订阅。订阅事件组重试机制的定时行为可以根据客户端服务进行配置，并且必须与相应的服务器服务的定时行为相匹配。对于TLL（Sd服务器TTL）设置为0x FFFFFF和主阶段的周期延迟)设置为0的服务器服务，可以将订阅事件组重试设置为0xFF。这将意味着重试订阅一个事件组，因为事件组被设置为SD_CONSUMED_EVENTGROUP_REQUESTED，并且没有收到订阅事件组Ack。