If you want to connect, have a feature request, bug report or need support, send me an email or connect on LinkedIn:

📧 [email protected]
🔌 LinkedIn

🔗 https://chrizog.github.io/someipy/

someipy is a Python library implementing the SOME/IP protocol, including the SOME/IP SD (Service Discovery) in Python. It's perfectly suited for fast prototyping of applications that need to provide (server) or use (client) SOME/IP services from other ECUs.

someipy also supports serialization and deserialization of SOME/IP payloads, which is a unique feature compared to other libraries.

someipy is still under development; therefore, it does not yet support all features of the SOME/IP and SOME/IP Service Discovery protocol specification.

someipy is based on the specification version of R22-11:

• SOME/IP Protocol Specification
• SOME/IP Service Discovery Protocol Specification

The library is currently developed and tested under Ubuntu 22.04 and Python 3.8.

someipy excels in scenarios where a full-scale Autosar (Adaptive or Classic) integration would be excessive:

• 🧪 Develop Test Applications: Easily create test applications to stimulate the SOME/IP interfaces of your system under test. Whether running on a PC in a SIL environment or on an ECU, someipy allows you to efficiently send and receive SOME/IP events or utilize/provide SOME/IP services. Test data can be seamlessly generated or imported in Python, from sources such as .csv files or ROS bag files. Explore the example applications for more details.

• 🔋 Prototype Sensor Integration: Quickly integrate new sensors into your project using SOME/IP, ideal for evaluating the sensor's potential impact without significant effort. Define the message/parameter layout in Python and create a server service instance in minutes. Check out the example application send_events_udp.py for a practical demonstration.

• 🔬 Data Recording: Set up a SOME/IP recording application in just a few minutes and store data in your preferred format, such as ROS bags, .csv files, or databases. Simply dump the received data within your callback function. The example application receive_events_udp.py illustrates this process.

The package can be installed from PyPi.

pip3 install someipy

In the directory example_apps, examples including explanations, can be found for using the someipy library. In temperature_msg.py, a payload interface "TemperatureMsg" is defined, which can be serialized and deserialized. In send_events.py, the service discovery and two services are instantiated. The "TemperatureMsg" is serialized and used as the payload for sending events.

The library is still under development. The current major limitations and deviations from the protocol specifications are listed below.

• Calling methods via TCP is not supported yet. Only method calls via UDP are supported.
• Only unicast services are supported.
• SOME/IP-TP is not supported.
• IPv6 endpoints are not supported.
• Session handling is supported only for SOME/IP-SD and not for SOME/IP messages transporting events.

• Configuration and load balancing options in SOME/IP SD messages are not supported.
• TTL of Service Discovery entries is not checked yet.
• The Initial Wait Phase and Repetition Phase of the Service Discovery specification are skipped. For simplification, the Main Phase is directly entered, i.e. SD Offer Entries are immediately sent cyclically.
• Multiple Service Discovery entries are not packed together in a single SD message, which is sent via UDP.

• Only fixed size arrays are supported. Dynamically sized arrays are not supported.
• Optional length fields for SOME/IP arrays are not supported.
• Strings are not supported yet.
• Configuration of padding is not supported yet.