📚 课程目录第1章 SOME/IP服务发现基础

1. SOME/IP服务发现基础

任务目标

构建并解析一个SOME/IP服务发现（SD）报文，理解其核心字段与消息结构。本案例聚焦于车辆以太网中ECU通过服务发现报文宣告自身服务能力的场景，为后续服务订阅与调用建立基础。

环境依赖

本案例使用Python 3.8+实现，无需第三方库，仅依赖标准库struct与socket。代码可直接在任意支持Python的Linux/Windows环境运行。

SOME/IP SD报文结构

SOME/IP SD报文基于SOME/IP头部扩展，核心字段包括：

Message ID：0xFFFF8100（SD服务ID）
Request ID：Client ID + Session ID
Interface Version：0x01
Message Type：0x02（Notification事件通知）
Return Code：0x00
Flags：Reboot Flag + Unicast Flag
Entries Array：承载服务发现具体条目
Options Array：承载IP/端口等附加信息

关键完整代码

以下代码实现一个服务发现OfferService报文的构建与解析闭环：

```python import struct import socket # SOME/IP SD 常量定义 SD_MESSAGE_ID = 0xFFFF8100 SD_INTERFACE_VERSION = 0x01 SD_MESSAGE_TYPE = 0x02 # NOTIFICATION SD_RETURN_CODE = 0x00 SD_FLAG_REBOOT = 0x80 SD_FLAG_UNICAST = 0x40 # Entry类型 ENTRY_OFFER_SERVICE = 0x01 ENTRY_TYPE_LENGTH = 16 # Entry固定长度 def build_sd_packet(service_id, instance_id, major_version, minor_version, ttl, ip, port): """构建SOME/IP SD OfferService报文""" # 1. SOME/IP头部 (16字节) someip_header = struct.pack('!I', SD_MESSAGE_ID) # Message ID someip_header += struct.pack('!I', 0x00000001) # Request ID (Client=0, Session=1) someip_header += struct.pack('!I', 0x00000000) # Length占位，后续填充 someip_header += struct.pack('!BBH', SD_INTERFACE_VERSION, SD_MESSAGE_TYPE, SD_RETURN_CODE) # 2. SD头部 (12字节) sd_header = struct.pack('!I', 0x00000000) # Flags + Reserved sd_header += struct.pack('!I', 0x00000001) # Entry Array Length sd_header += struct.pack('!I', 0x00000001) # Option Array Length # 3. Entry: OfferService (16字节) entry = struct.pack('!BBH', ENTRY_OFFER_SERVICE, 0x00, 0x0000) # Type + Index entry += struct.pack('!I', service_id) # Service ID entry += struct.pack('!I', instance_id) # Instance ID entry += struct.pack('!BBH', major_version, 0x00, ttl) # Major + TTL # 4. Option: IPv4 Endpoint (12字节) option = struct.pack('!BBH', 0x04, 0x00, 0x0009) # Option Type + Length option += struct.pack('!I', socket.inet_aton(ip)) # IPv4地址 option += struct.pack('!H', port) # 端口 option += struct.pack('!H', 0x0000) # Reserved # 5. 计算总长度并填充 payload = sd_header + entry + option total_length = 16 + len(payload) # SOME/IP头部 + SD负载 someip_header = someip_header[:8] + struct.pack('!I', total_length) + someip_header[12:] return someip_header + payload def parse_sd_packet(packet): """解析SOME/IP SD报文，返回关键字段字典""" result = {} # 解析SOME/IP头部 message_id, request_id, length, iface_ver, msg_type, ret_code = \ struct.unpack('!IIIBBH', packet[:16]) result['message_id'] = hex(message_id) result['request_id'] = hex(request_id) result['length'] = length result['message_type'] = hex(msg_type) # 解析SD头部 flags_reserved, entry_len, option_len = struct.unpack('!III', packet[16:28]) result['flags'] = hex(flags_reserved >> 24) result['entry_count'] = entry_len result['option_count'] = option_len # 解析Entry offset = 28 entry_type, entry_index, entry_opts = struct.unpack('!BBH', packet[offset:offset+4]) service_id, instance_id = struct.unpack('!II', packet[offset+4:offset+12]) major_ver, _, ttl = struct.unpack('!BBH', packet[offset+12:offset+16]) result['entry_type'] = hex(entry_type) result['service_id'] = hex(service_id) result['instance_id'] = hex(instance_id) result['major_version'] = major_ver result['ttl'] = ttl # 解析Option offset += 16 opt_type, opt_class, opt_len = struct.unpack('!BBH', packet[offset:offset+4]) ip_bytes = packet[offset+4:offset+8] port = struct.unpack('!H', packet[offset+8:offset+10])[0] result['ip'] = socket.inet_ntoa(ip_bytes) result['port'] = port return result # 最小可运行示例 if __name__ == '__main__': # 构建OfferService报文 packet = build_sd_packet( service_id=0x1234, instance_id=0x5678, major_version=0x01, minor_version=0x00, ttl=3, # 3秒有效期 ip='192.168.1.100', port=30501 ) print(f"构建报文长度: {len(packet)} 字节") print(f"报文Hex: {packet.hex()}") # 解析验证 parsed = parse_sd_packet(packet) print("\n解析结果:") for key, value in parsed.items(): print(f" {key}: {value}") ```

运行与验证

直接执行脚本即可完成构建与解析闭环：

python3 sd_packet_demo.py

预期输出（基于代码逻辑可唯一推出）：

构建报文长度: 56 字节
报文Hex: ffff81000000000100000038...
解析结果:
  message_id: 0xffff8100
  request_id: 0x1
  length: 56
  message_type: 0x2
  flags: 0xc0
  entry_count: 1
  option_count: 1
  entry_type: 0x1
  service_id: 0x1234
  instance_id: 0x5678
  major_version: 1
  ttl: 3
  ip: 192.168.1.100
  port: 30501

判定标准：解析结果中service_id、instance_id、ip、port与构建参数完全一致，且报文总长度为56字节（16字节SOME/IP头 + 12字节SD头 + 16字节Entry + 12字节Option），即表示报文构建与解析逻辑正确。

常见问题

字节序：SOME/IP协议规定使用大端字节序（网络序），代码中struct.pack('!...')的!前缀已确保正确。
TTL含义：TTL=3表示该服务宣告在3秒内有效，超过后需重新发送OfferService报文。
Flags值0xC0：由Reboot Flag(0x80)与Unicast Flag(0x40)按位或得到，表示非重启且支持单播响应。