Documentation

# SOME/IP 网关

由德国宝马公司开发的 SOME/IP（Scalable service-Oriented MiddlewarE over IP），是一种面向服务的车载以太网通信协议，并支持服务导向架构（SOA）。有别于传统车载总线，按照 SOME/IP 协议，发送方只会在网络中至少存在一个接收方、且需要相关数据时，才会发送数据，因此能极大提升网络带宽的利用率。

在软件定义汽车的趋势下，SOME/IP 在处理来自车内各种来源数据方面表现出高效和安全的特性。它既能与传统的 TSP 平台对接，还能联系 ADAS 等新一代应用服务完成计算卸载转移。

NanoMQ 现已通过 SOME/IP Gateway 支持基于 AUTOSAR 标准的 SOME-IP 数据通信方式，可以部署在车内中央网关中完成汇聚和与 TSP 平台的对接工作，并通过MQTT over QUIC/TCP + TLS 加密连接保证网关的安全性。

SOME/IP + MQTT 共同应用场景

# 前置准备

NanoMQ 的 SOME/IP Gateway 功能依赖于 vSOMEIP (opens new window)，运行以下命令安装 vSOMEIP。

::: 有关 vSOMEIP 的安装依赖项，可参考 vsomeip - GitHub 页面 (opens new window)

git clone https://github.com/COVESA/vsomeip.git
cd vsomeip
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX:PATH=$YOUR_PATH
make -j8
make install
1
2
3
4
5
6
7

# 编译例程服务

编译 vSOMEIP 中的 hello_world_service 例程服务，稍后我们将通过该例程测试 NanoMQ 的 SOME/IP 网关。

cd vsomeip/examples/hello_world
mkdir build
cd build
cmake ..
make -j8
1
2
3
4
5

# 启用 SOME/IP 协议转换功能

通过以下命令在编译阶段为 NanoMQ 开启 SOME/IP 协议转换功能:

cmake -G Ninja -DBUILD_VSOMEIP_GATEWAY=ON ..
ninja
1
2

编译完成后，可进入 build -> nanomq_cli 文件夹，执行命令 nanomq_cli 确认网关是否正确安装：

$ ./nanomq_cli
nanomq_cli { pub | sub | conn | nngproxy | nngcat | vsomeip_gateway } [--help]

available tools:
   * pub
   * sub
   * conn
   * nngproxy
   * nngcat
   * vsomeip_gateway

Copyright 2022 EMQ Edge Computing Team
1
2
3
4
5
6
7
8
9
10
11
12

运行命令 nanomq_cli vsomeip_gateway --help 可看到以下输出：

Usage: nanomq_cli vsomeip_gateway [--conf <path>]

  --conf <path>  The path of a specified nanomq_vsomeip_gateway.conf file
1
2
3

即我们需要首先为该网关指定相关配置文件。

# 配置 SOME/IP 网关

通过 etc/nanomq_vsomeip_gateway.conf 配置文件来设置桥接的主题和需要请求的 SOME/IP 服务地址。

例如，您希望将从 SOME/IP 服务接收到的数据转发至本地 MQTT Broker 的 topic/pub 主题，同时将通过主题 topic/sub 收到的 MQTT 消息转发至 SOME/IP 服务，可通过如下配置实现：

gateway.mqtt {
    address = "mqtt-tcp://localhost:1883"
    sub_topic = "topic/sub" # message from mqtt
    sub_qos = 0
    proto_ver = 4
    keepalive = 60
    clean_start = true
    username = "username"
    password = "passwd"
    clientid = "vsomeip_gateway"
    forward = "topic/pub" # message to mqtt
    parallel = 2
}

gateway.vsomeip {
    service_id = "0x1111"
    service_instance_id = "0x2222"
    service_method_id = "0x3333"
    # conf_path = "/etc/vsomeip.json"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

如果你希望通过 HTTP API 动态更新配置或者控制网关的重启或停止，可以通过将以下配置加入到 nanomq_vsomeip_gateway.conf 中，启动 HTTP 服务：

# #============================================================
# # Http server
# #============================================================
http_server {
	# # http server port
	# #
	# # Value: 0 - 65535
	port = 8082
	# # parallel for http server
	# # Handle a specified maximum number of outstanding requests
	# #
	# # Value: 1-infinity
	parallel = 2
	# # username
	# #
    # # Basic authorization 
    # #
	# # Value: String
	username = admin
	# # password
	# #
    # # Basic authorization
    # #
	# # Value: String
	password = public
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

# HTTP API

HTTP API 提供了如下几个接口：

  • 获取配置文件：
$ curl --basic -u admin:public 'http://127.0.0.1:8082/api/v4/proxy/configuration/someip' --output nanomq_vsomeip_gateway.conf
1
  • 更新配置文件：
$ curl --basic -u admin:public 'http://127.0.0.1:8082/api/v4/proxy/configuration/someip' --header 'Content-Type: text/plain'  --data-binary '@nanomq_vsomeip_gateway.conf'
1
  • 停止网关：
$ curl --basic -u admin:public 'http://127.0.0.1:8082/api/v4/proxy/ctrl/stop' \
--header 'Content-Type: application/json' \
--data '{
    "req": 10,
    "action": "stop",
    "seq": 1234
}'
1
2
3
4
5
6
7
  • 重启网关：
$ curl --basic -u admin:public 'http://127.0.0.1:8082/api/v4/proxy/ctrl/restart' \
--header 'Content-Type: application/json' \
--data '{
    "req": 10,
    "action": "restart",
    "seq": 1234
}'
1
2
3
4
5
6
7

# 测试 SOME/IP 网关

本节将使用上面编译好的 hello_world_service 作为 SOME/IP 的服务端，并通过 SOME/IP gateway 与 NanoMQ 对接。

提示

该服务可以更换成其他 SOME/IP 兼容的服务。

通过以下命令启动 hello_world_service ：

$ ldconfig
$ ./hello_world_service // 启动 SOME/IP Server
$ nanomq start // 启动 NanoMQ MQTT Broker
$ ./nanomq_cli vsomeip_gateway --conf path/to/nanomq_vsomeip_gateway.conf // 启动 SOME/IP proxy
1
2
3
4

配置好 SOME/IP 网关之后，当您通过 MQTT 客户端向 topic/sub 主题发送一条消息时，SOME/IP 网关会将这条消息转发给预先指定的 SOME/IP 服务，即 hello_world_service；SOME/IP 服务接收到消息后会产生一个回应，并通过 SOME/IP 网关将回应消息转发到 topic/pub 主题，订阅该主题的客户端即可收到相应回复消息。

运行如图： img img img img

目前，NanoMQ 的 SOME/IP 网关仅支持透明传输（透传）服务，即原始数据经过 SOME/IP 网关后不会有任何的改变或处理，我们后续计划根据用户所使用的数据序列化和反序列化格式工具，比如 IDL 或 FIDL，提供更多高级功能，比如自动代码生成和数据序列化，敬请期待。

← DDS 网关 →

编辑此页
本页导航