Clone
3
Communicating with an IntelliCenter controller
parnic edited this page 2025-05-17 18:43:48 -05:00

IntelliCenter controllers allow connectivity via Telnet and Websocket. The Telnet server listens on port 6681 and the Websocket server is on port 6680. Each server operates in a request-response format where a json payload is delivered as a request and the server replies with a json response. Each request is expected to have a messageID field that will be included in the response for matching responses to requests.

You can connect to the Websocket server with a developer tool like Postman, Bruno, etc. by using: ws://[intellicenter.ip]:6680

Requests follow the basic format:

{
  "command": "CommandName",
  "messageID": "SomeUniqueMessageIDString"
}

though different requests will use different commands as well as other fields. See request.ts for the full list of fields, and messages for various uses of each field to get different results. Some messages require specific fields to be provided, even if empty, and others to be missing. For example, to get the list of bodies and circuits attached to a controller, the request would be:

{
    "command": "GetQuery",
    "queryName": "GetConfiguration",
    "arguments": "",
    "messageID": "1-2-3-4"
}

which would provide a response listing out each object in the answer field (see response format: response.ts).

Note that newlines are allowed on websocket requests, but a Telnet request message must be on a single line.

Search terms: pentair intellicenter api documentation communication control controller remote network websocket telnet protocol