SOMEIP_集成手册¶

文档控制

日期	作者	版本	状态	说明
2022/10/26	吴挺伟	V0.1	【初稿】	初版
2023/2/15	吴挺伟	V0.2	【修改】	修改Sd、SomeIpTp、SomeIpXf参考文件名
2024/7/16	陈伯奇	V1.0	【发布】	1.更新4.2.1参考手册名称名称修改2.修改4.3.1参考章节引用错误3.4.1章节第7步增加截图 4.删除5.3章节第3步“添加调度文件，点击应用保存。 5.5.4章节main函数中代码修改为ComM_ChComAllow(ComMUser_ETH,TRUE); 6.修改截图

目的¶

本文档旨在通过一个SOMEIP示例工程的配置，向用户展示SOMEIP的集成过程。

通过阅读本文档，用户可以了解ORIENTAIS配置工具的配置过程，以及如何应用配置工具生成的配置文件。

为了让用户更清晰的了解工具的使用，所用的配置均逐一手动完成。用户在了解了配置的基本过程后，可以快速完成配置。

缩写词和术语¶

表 2‑1 缩写词和术语¶
缩写词/术语	描述
SoAd	Socket Adapter 将socket的数据和PDU进行转换
Sd	Service Discovery 服务发现模块
SOMEIP	Scalable service-Oriented MiddlewarE over IP 可扩展的面向服务的IP中间件
RTE	Runtime Enviroment 虚拟运行唤醒
SWC	Software Component 软件组件

参考文档¶

[1] 参考手册_Sd.pdf

[2] 参考手册_SomeIpTp.pdf

[3] 参考手册_SomeIpXf.pdf

协议栈集成¶

新建ORIENTAIS工程¶

①安装软件后，双击软件图标打开软件

图 4‑1 新建工程-1¶

②菜单栏File🡪New🡪Project，新建工程

图 4‑2 新建工程-2¶

③在弹出的新建窗口中选择Autosar下的 [BSW Project]，选择Next

图 4‑3 新建工程-3¶

④在弹出的窗口中输入工程名，选择Finish

图 4‑4 新建工程-4¶

⑤在弹出的窗口中选择Yes。

图 4‑5 新建工程-5¶

⑥在工程的[Bsw_Builder]项目上右键，选择New ECU Configuration

图 4‑6 新建工程-6¶

⑦在弹出的窗口中输入一个ECU名，然后选择Next

图 4‑7 新建工程-7¶

⑧在弹出的窗口中勾选需要添加的模块，点击Finish。

图 4‑8 新建工程-8¶

⑨新建完成的工程如下所示，步骤7中添加的模块已经被加入到工程中。

图 4‑9 新建工程-9¶

配置文件生成¶

模块配置¶

模块的具体配置，取决于具体的项目需求。SOMEIP各模块配置项的详细介绍，参见《参考手册_Sd.pdf》、《参考手册_SomeIpTp.pdf》、《参考手册_SomeIpXf.pdf》。

配置代码生成¶

①在工程上右键会弹出校验整个工程和生成整个工程所有模块配置文件的菜单。

②首先选择Validate All，没有错误提示信息即校验通过。

图 4‑10 配置代码的生成-1¶

③然后选择Generate All，生成配置文件。右下角的输出框中会输出生成的配置文件信息。

图 4‑11 配置代码的生成-2¶

④在工程Config文件夹下即可查看生成的配置文件。

图 4‑12 配置代码的生成-3¶

功能集成¶

代码集成¶

协议栈代码包括两部分：项目提供的协议栈源码和ORIENTAIS Configurator配置生成代码。SOMEIP集成包括SOMEIP源码（SD、SomeipXf）。

用户须将协议栈源码和章节4.2.2生成的配置源代码添加到集成开发工具的对应文件夹。协议栈集成的文件结构，见章节5.3。

注意：协议栈集成之前，用户须确保已经有基础工程，以及以太网通信协议栈已集成，且本协议栈相关的其他协议栈能正常工作。

集成注意事项¶

对于集成过程中，协议栈特殊要求和用户经常出现的问题，归类总结形成下表4-1。用户需逐一排查表中的约束项，以避免集成问题出现。

表4-1 SOMEIP集成约束清单

编号	类别	约束限制
1	堆栈	用户需确保为任务堆栈和中断堆栈分配足够的堆栈空间。
2	头文件	添加协议栈代码之后，用户需更新集成开发工具中的头文件路径。调用协议栈API的源文件，需要包含协议栈的头文件。
3	初始化	SOMEIP协议栈的初始化顺序为：EthIf_Init, TcpIp_Init, SoAd_Init，SomeIpXf_Init，Sd_Init。
4	周期函数	EthSM_Ma inFunction,EthIf_MainFunctionState,Sd_MainFunction, ComM_MainFu nction_<ComMChannel_ETH>需要被周期性任务函数调用。

配置过程¶

集成目标¶

本手册会以以下参数作为示例，进行集成演示。

表 5‑1 配置参数¶
参数	值
SdServerSe rvice实例参数	SdServerServiceId：0x1 SdServerServiceInstanceId：0x1 SdServerServiceMajorVersion：1 SdServerServiceMinorVersion：1
SdServer Timer时间参数	SdServerTimerInitialOfferDelayMax：0.1 SdServerTimerInitialOfferDelayMin：0.0 SdServerTimerInitialOfferRepetitionBaseDelay：0.03 SdServerTimerInitialOfferRepetitionsMax：3 SdServerTimerOfferCyclicDelay：1.0 SdServerTimerRequestResponseMaxDelay：0.5 SdServerTimerRequestResponseMinDelay：0.0 SdServerTimerTTL：300
Socket信息	Sd单播本地：172.31.30.78/ UDP/30490 Sd多播本地：239.192.255.250/ UDP/30490 AddMethod本地：172.31.30.78/ TCP/12310 AddMethod远端：172.31.30.80/ TCP/0（端口号为通配符）
序列化参数	加法运算请求参数： typedef struct { uint16 number_a; uint16 number_b; } AddMethodReq; 加法运算结果参数： typedef uint32 AddMethodResp;

模块配置¶

EcuC模块配置¶

①双击EcuC模块，打开EcuC模块配置界面。

②在EcucConfigSets栏目上右键新建 EcucConfigSet。

③再在EcucPduCollections上右键新建EcucPduCollection。配置PduIdTypeEnum为UINT16，PduLengthTypeEnum为UINT32。

图 5‑1 EcuC 模块配置-1¶

④在EcucPduCollection上右键，选择Pdu，生成一个Pdu的配置界面。

图 5‑2 EcuC 模块配置-2¶

⑤配置4个PDU用于加法运算服务的收发，pdu长度为500， SoAd_SdInstance0_AddMethodReq、LdCom_SdInstance0_AddMethodReq、SoAd_SdInstance0_AddMethodResp、LdCom_SdInstance0_AddMethodResp；

配置3个PDU用于用于SD模块的单/多播收发，pdu长度1400， SdInstance0_Unicast_Rx、SdInstance0_Multicast_Rx、SdInstance0_Tx。