Warning

This documentation is actively being updated as the project evolves and may not be complete in all areas.

DoIP Driver¶

jumpstarter-driver-doip provides raw Diagnostics over Internet Protocol (DoIP, ISO-13400) operations for Jumpstarter. This driver enables low-level communication with automotive ECUs over Ethernet, including vehicle discovery, entity status checks, alive checks, and raw diagnostic message exchange.

For UDS (Unified Diagnostic Services) over DoIP, see jumpstarter-driver-uds-doip.

Installation¶

pip3 install --extra-index-url https://pkg.jumpstarter.dev/simple/ jumpstarter-driver-doip

Configuration¶

Parameter	Type	Default	Description
`ecu_ip`	str	required	IP address of the target ECU
`ecu_logical_address`	int	required	DoIP logical address of the ECU
`tcp_port`	int	13400	DoIP TCP port
`protocol_version`	int	2	DoIP protocol version (2=2012, 3=2019)
`client_logical_address`	int	0x0E00	Logical address of the client/tester
`auto_reconnect_tcp`	bool	false	Auto-reconnect on TCP connection close
`activation_type`	int	0	Routing activation type (null to disable)

Example exporter configuration¶

export:
  doip:
    type: jumpstarter_driver_doip.driver.DoIP
    config:
      ecu_ip: "192.168.1.100"
      ecu_logical_address: 224  # 0x00E0

Client API¶

Method	Description
`entity_status()`	Request DoIP entity status
`alive_check()`	Request alive check
`diagnostic_power_mode()`	Request diagnostic power mode
`request_vehicle_identification()`	Request vehicle identification (VIN, EID, etc.)
`routing_activation(type)`	Request routing activation
`send_diagnostic(payload)`	Send raw diagnostic payload bytes
`receive_diagnostic(timeout)`	Receive raw diagnostic response bytes
`reconnect(close_delay)`	Reconnect after ECU reset
`close_connection()`	Close the DoIP connection