FoundryNet / Error codes / Modbus Exception 02
Modbus error code

Exception 02 (0x02) — Illegal Data Address

The address, or the address plus the quantity requested, is outside the range the server implements. The function was fine; the range was not.

Start free Modbus → canonical

Diagnosis

When you hit this


Resolution

How to fix it

  1. Subtract the offset convention
    40001 in a manual is usually offset 0 with FC03. 30001 is offset 0 with FC04. Read one register at the suspect address to isolate it.
  2. Bisect the range
    If a block read fails, halve it. The boundary where it starts failing is the real end of the implemented range.
  3. Split reads at known holes
    Issue several smaller reads that each stay inside a contiguous block instead of one wide read that spans a gap.

Normalization

What Forge does about it

A request that fails on some points and succeeds on others still normalizes. The tags that arrived resolve to canonical fields as usual; the ones that did not come back are listed in unresolved_tags and excluded from coverage_pct, so a partial read reports as partial instead of quietly looking complete.


Connect

Normalize Modbus telemetry

One MCP endpoint serves every protocol adapter. 16,908 curated mappings, 366 canonical fields.

# normalize telemetry from Modbus — and 13 other protocols
claude mcp add --transport http forge https://mcp.foundrynet.io/mcp \
  --header 'Authorization: Bearer YOUR_FORGE_KEY'
✓ forge connected — 32 tools available

Related

Keep reading

Other Modbus codes: Exception 01 Exception 03 Exception 04 Exception 06 Exception 0B

Equipment that speaks Modbus: Fanuc Haas Universal Robots Chemical process Food & beverage process Pharma process (GMP) Bridgeport Brother Doosan Robotics Epson Robots

Modbus protocol hub

Other protocols: OPC UA MQTT / Sparkplug B FANUC FOCAS EtherNet/IP PROFINET / S7 BACnet/IP J1939 (CAN) MTConnect ROS 2 (DDS) SNMP MAVLink HTTP / REST CSV ingest

All error codes · All OEMs · All protocols

Industrial AI fails at the data layer. The Machine Agent explains why, weekly. Read it →
Get the thesis behind this infrastructure — The Machine Agent, weekly.