DoIP troubleshooting

DoIP connection failure

The diagnostic application cannot discover the vehicle, complete routing activation, or establish usable TCP communication with an ECU over DoIP. This guide narrows the failure to the network path, DoIP exchange, ECU availability, or diagnostic configuration.

Start the diagnostic workflow

Observable symptoms

What the failure can look like

Possible causes

Boundaries worth checking first

01

Automotive Ethernet path or link problem

A disconnected, incorrectly connected, or inactive Automotive Ethernet path prevents discovery traffic from reaching the vehicle or prevents responses from returning to the diagnostic application. The result is typically a complete absence of discovery evidence.

  • Automotive Ethernet
02

Incorrect DoIP endpoint or routing configuration

The application may target the wrong vehicle or ECU endpoint, use stale addressing information, or request routing activation with parameters that do not match the available DoIP path. Discovery can therefore succeed while routed communication fails.

  • DoIP
03

ECU unavailable or not in a communicable state

The target ECU may not be powered, may not have completed its startup behavior, or may not be available through the current vehicle state. This can produce a silent timeout or a connection that closes before diagnostic communication becomes usable.

  • DoIP
  • UDS
04

TCP transport interruption or endpoint rejection

A transport connection can be refused, reset, or closed by the endpoint or an intermediate network component. Repeated connection attempts with no completed diagnostic exchange indicate that the failure is below UDS service handling.

  • DoIP
05

Diagnostic description does not match the target ECU

An ODX or PDX description may identify the wrong ECU, addressing information, diagnostic session, or expected service behavior. The DoIP connection may be healthy while the subsequent UDS request is directed or interpreted incorrectly.

  • DoIP
  • UDS
06

Analysis or automation setup masks the actual exchange

A CANoe configuration, CAPL automation, or diagnostic application may send requests in the wrong order, use an incorrect target, or fail to preserve the relevant timing and response evidence. The apparent connection failure may therefore be a test or integration defect.

  • CANoe
  • CAPL

Ordered investigation

Diagnostic workflow

  1. 01

    Define the first failed exchange

    Record the exact target ECU, vehicle state, reproduction sequence, expected behavior, and first missing or rejected response. Separate discovery failure, routing activation failure, TCP failure, and post-connection UDS failure before changing the setup.

    • DoIP
    • UDS
  2. 02

    Verify the physical and data-link path

    Confirm that the Automotive Ethernet connection is present and that the diagnostic application is attached to the intended interface. A missing discovery response at this stage rules the investigation toward the network path or endpoint availability, but does not by itself identify which one is defective.

    • Automotive Ethernet
  3. 03

    Inspect DoIP discovery evidence

    Capture one clean reproduction and determine whether discovery requests and responses are present, whether the response identifies the expected vehicle or ECU, and whether the response disappears only after a particular request. This separates reachability and target-selection issues from later routing activation issues.

    • DoIP
    • Wireshark
    • PCAP
  4. 04

    Inspect routing activation and TCP state

    Use the capture to establish whether TCP connection setup completes, whether routing activation is sent to the intended endpoint, and whether the endpoint accepts, rejects, or closes the exchange. This rules out a purely physical failure when the endpoint responds, but may require ECU-side evidence to distinguish configuration from ECU behavior.

    • DoIP
    • Wireshark
    • PCAP
  5. 05

    Compare the diagnostic description with the target

    Check the ODX or PDX data used by the application against the selected ECU and the requests being sent. Confirm that the connection issue is not actually a UDS addressing, diagnostic-session, or service-expectation mismatch after DoIP communication has already been established.

    • DoIP
    • UDS
    • Diagnostic Session
  6. 06

    Reproduce with controlled tooling and automation disabled

    Repeat the minimum exchange in CANoe or the diagnostic application without unnecessary CAPL automation, then compare the result with the automated sequence. If the controlled exchange works, investigate sequencing, target selection, and timing in the automation rather than the vehicle network first.

    • CANoe
    • CAPL
    • DoIP

Verification gates

Technical checks

Confirm the intended Automotive Ethernet interface

Read the active interface selected by the diagnostic application and compare it with the interface physically connected to the vehicle network for the reproduction.

Expected

The intended interface is active and is the one used by the capture and diagnostic application.

If failed

The result does not isolate the vehicle from the setup; correct the interface selection or connection and repeat discovery before investigating UDS.

Check for DoIP discovery request and response pairs

In the PCAP, compare the timestamps and target information of each discovery request with the expected vehicle or ECU response.

Expected

A response is present for the request and identifies the intended DoIP endpoint.

If failed

No response points toward the Automotive Ethernet path, endpoint availability, or incorrect discovery targeting; a response for another endpoint points toward target selection.

Check TCP connection completion

Inspect the PCAP for a completed TCP connection to the intended DoIP endpoint and record whether the connection is refused, reset, or closed immediately.

Expected

The TCP connection completes and remains available for the DoIP exchange.

If failed

A refusal or reset requires investigation of endpoint availability, TCP targeting, or the network path before UDS services are assessed.

Check routing activation outcome

Compare the routing activation request with the endpoint response and record whether the exchange is accepted, rejected, absent, or terminated.

Expected

The intended endpoint returns an acceptance result and the connection remains usable.

If failed

A rejection or termination points toward DoIP configuration, endpoint state, or an ECU-side condition; an absent response points back to transport or endpoint availability.

Compare target identity in ODX or PDX

Read the ECU and diagnostic addressing information used by the diagnostic application from the selected ODX or PDX data and compare it with the discovered target.

Expected

The description identifies the same ECU and addressing context as the discovered DoIP endpoint.

If failed

A mismatch can cause post-connection diagnostic failure or an apparent target failure; correct the diagnostic data or confirm the intended ECU with the responsible owner.

Separate DoIP failure from UDS failure

After a stable DoIP route exists, inspect whether the UDS request and response are present and whether the selected diagnostic session and service expectation match the target ECU.

Expected

The UDS request traverses the established route and the ECU returns a response consistent with the selected diagnostic session.

If failed

The DoIP connection is not the remaining fault domain; investigate UDS configuration, diagnostic session behavior, or ECU-specific handling.

From evidence to action

Resolution paths

Repair the Automotive Ethernet path or setup

Correct the interface selection, physical connection, or network setup identified by the evidence, then repeat discovery and capture a clean exchange. If the path remains unavailable, the vehicle or network owner may need to verify the connected ECU and vehicle state.

Correct DoIP target and routing configuration

Update the diagnostic application, CANoe configuration, or CAPL sequence to use the discovered target and the expected routing activation sequence. Revalidate with a PCAP rather than relying only on application-level status.

Restore ECU availability

Confirm the ECU power and vehicle state required for DoIP communication and repeat the test after startup is complete. If the ECU still does not respond while the Automotive Ethernet path and requests are correct, provide the evidence to the ECU supplier or OEM for ECU-side investigation.

Correct ODX or PDX diagnostic data

Replace or revise the diagnostic description when it identifies the wrong ECU, addressing context, diagnostic session, or expected service behavior. Validate that the corrected data matches the discovered endpoint before testing UDS services.

FAQ

Questions that shape the investigation

What should be checked first when DoIP discovery returns nothing?
First verify the intended Automotive Ethernet interface, physical connection, target vehicle state, and the presence of discovery requests in a PCAP. No response does not by itself prove an ECU fault; it can also indicate a path or endpoint-selection problem.
What does successful discovery prove?
It shows that at least one DoIP endpoint responded to discovery. It does not prove that routing activation, TCP diagnostic communication, UDS addressing, or the requested diagnostic service will succeed.
How can routing activation failure be distinguished from a network failure?
A routing activation failure normally has evidence that the endpoint was discovered and that TCP communication reached the endpoint. An absent discovery response or failed TCP connection places the failure earlier in the path, although endpoint availability may still require ECU-side confirmation.
When should ODX or PDX data be investigated?
Investigate ODX or PDX after confirming that the intended endpoint can be discovered and a DoIP route can be established. Incorrect diagnostic data is more likely to explain a post-connection UDS failure than a complete absence of DoIP discovery.
Can a UDS diagnostic session cause an apparent DoIP connection failure?
It can make the application report an unsuccessful diagnostic operation after the route is already established, but it does not normally explain missing discovery or an uncompleted TCP connection. Use the PCAP to identify which stage actually failed.

Diagnostic support

Discuss a DoIP Project

For a documented engineering analysis, diagnostic application, or automated test suite around DoIP and UDS communication, provide the problem description, relevant PCAP, ECU details, and ODX or PDX data for focused investigation.