GATEWAY TROUBLESHOOTING

Troubleshoot a Modbus TCP-to-RTU gateway

A gateway creates two communication legs. A successful TCP connection reaches the gateway, not necessarily the downstream server. Troubleshooting becomes faster when each result is assigned to the layer that actually completed.

01

Draw the complete route before testing

Record client IP, gateway IP and port, MBAP Unit ID, downstream serial framing, RTU address, timeout, and expected register. Confirm whether the gateway forwards Unit ID directly, remaps it, or exposes its own management server.

02

Classify the result before changing settings

Connection refused or unreachable points to the network endpoint. A TCP timeout after connect may be gateway or downstream timing. Exception 0A describes an unavailable gateway path; 0B describes a downstream target that did not respond. Exception 01, 02, or 03 proves a Modbus server answered but rejected the operation.

  • Preserve transaction ID and Unit ID
  • Record the exact PDU address and quantity
  • Distinguish no response from exception response
  • Compare gateway and direct-RTU timing when possible
03

Prove one downstream server and one register

Use a known Unit ID and a short documented read. Avoid simultaneous address scans while testing timing. If direct RTU access works, copy the exact framing and request into the gateway path and account for gateway turnaround in the timeout.

04

Validate decoded data after the route works

A valid response proves transport and routing, not the engineering interpretation. Only then verify documentation address, function, register width, word order, signedness, scale, and unit. Save the proven route as a connection profile and the decoded values as tags.

QUESTIONS

Before you connect.

Why does TCP connect but every Modbus request time out?+

The gateway may be reachable while the downstream Unit ID, serial framing, timing, or device is wrong.

What is exception 0B?+

Gateway Target Device Failed to Respond means the gateway attempted the downstream transaction but received no response.

Should Unit ID always be 1 over TCP?+

No. Through a gateway it normally selects the downstream RTU server; direct TCP products vary.

KEEP THE EVIDENCE

Use the reference beside the live protocol.

Browse documentation→