FoundryNet / Error codes / MQTT / Sparkplug B CONNACK 1
MQTT / Sparkplug B error code

CONNACK 1 (0x01) — Connection Refused: unacceptable protocol version

The broker does not support the protocol level the client asked for. The client sent 4 (3.1.1) or 5 (5.0) and the broker will not serve it.

Start free MQTT / Sparkplug B → canonical

Diagnosis

When you hit this


Resolution

How to fix it

  1. Pin the protocol version explicitly
    Do not rely on the library default. Set 3.1.1 explicitly when talking to industrial brokers; many are not 5.0-capable.
  2. Check the broker's advertised version
    Broker logs state the protocol levels accepted. Sparkplug B is defined over 3.1.1, so that is the safe choice.
  3. Bypass the proxy to test
    Connect directly to the broker port. If that works, the middlebox is rewriting or rejecting your CONNECT.

Normalization

What Forge does about it

This is a configuration or addressing mistake on the wire, upstream of anything Forge sees. Where Forge helps is the step after you fix it: once the point returns data, its vendor tag name maps to a canonical field automatically, so you do not also have to hand-maintain a name table for every point you just re-addressed.


Connect

Normalize MQTT / Sparkplug B telemetry

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

# normalize telemetry from MQTT / Sparkplug B — 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 MQTT / Sparkplug B codes: CONNACK 2 CONNACK 3 CONNACK 5 Sparkplug NDATA before NBIRTH Sparkplug seq out of order

Equipment that speaks MQTT / Sparkplug B: MiR (Mobile Industrial Robots) Chemical process Food & beverage process Pharma process (GMP) OTTO Motors Geek+ (Geekplus) Locus Robotics Omron AMR (LD/HD) Trumpf

MQTT / Sparkplug B protocol hub

Other protocols: Modbus OPC UA 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.