Crate someip_parse

A Rust library for parsing the SOME/IP network protocol (without payload interpretation).

Usage

Add the following to your Cargo.toml:

[dependencies]
someip_parse = "0.4.0"

Example

examples/print_messages.rs:

use someip_parse::SliceIterator;
 
//trying parsing some ip messages located in a udp payload
for someip_message in SliceIterator::new(&udp_payload) {
    match someip_message {
        Ok(value) => {
            if value.is_someip_sd() {
                println!("someip service discovery packet");
            } else {
                println!("0x{:x} (service id: 0x{:x}, method/event id: 0x{:x})", 
                         value.message_id(), 
                         value.service_id(),
                         value.event_or_method_id());
            }
            println!("  with payload {:?}", value.payload())
        },
        Err(_) => {} //error reading a someip packet (based on size, protocol version value or message type value)
    }
}

Todo

• Example how to serialize someip packets
• SOMEIP Service Discovery Message Parsing

References

• AUTOSAR Foundation 1.5.0 (contains SOMEIP Protocol Specification 1.5.0 & SOME/IP Service Discovery Protocol Specification 1.5.0)
• SOME/IP Protocol Specification 1.3.0
• SOME/IP Service Discovery Protocol Specification 1.3.0

Structs

SliceIterator

Allows iterating over the someip messages in a udp or tcp payload.

SomeIpHeader

SOMEIP header (including tp header if present).

SomeIpHeaderSlice

A slice containing an some ip header & payload of that message.

TpHeader

Additional header when a packet contains a TP header (transporting large SOME/IP messages).

Enums

MessageType

Message types of a SOME/IP message.

ReadError

Errors that can occur when reading someip headers.

ReturnCode

Return code contained in a SOME/IP header.

ValueError

Range errors in fields of the someip & tp header struct. These can occur when serializing or modifying an error.

WriteError

Errors that can occur when serializing a someip & tp header.

Constants

SOMEIP_HEADER_LENGTH

Length of a someip header.

SOMEIP_HEADER_MESSAGE_TYPE_TP_FLAG

Flag in the message type field marking the package a as tp message (transporting large SOME/IP messages of UDP).

SOMEIP_LEN_OFFSET_TO_PAYLOAD

Offset that must be substracted from the length field to determine the length of the actual payload.

SOMEIP_MAX_PAYLOAD_LEN

Maximum payload length supported by some ip. This is NOT the maximum length that is supported when sending packets over UDP. This constant is based on the limitation of the length field data type (uint32).

SOMEIP_PROTOCOL_VERSION

The currently supported protocol version.

SOMEIP_SD_MESSAGE_ID

Message id of SOMEIP service discovery messages

TP_HEADER_LENGTH

Length of the tp header that follows a someip header if a someip packet has been flaged as tp.