Pool Control (PI) TCP Serial Port Firmware

From Autelis

Jump to: navigation, search

Contents

About

The TCP Serial Port Firmwares have a serial port enabled on TCP port 6000. This allows you to communicate with Pool Control using either a controller that supports TCP communications or through a TCP to serial port adapter (sold separately) which will enable you to connect to controllers which only support serial connectivity.

The TCP Serial Port will respond to commands and also automatically issue status updates when the state of equipment or settings change.

This firmware is currently under development.


Protocol

The protocol for communication with the TCP serial port has been implemented to be similar to the iLink serial adapter protocol.

Command Format

Commands start with a "#" character and are followed by a command word. The command word is followed by an optional qualifier symbol and value. Each command is terminated by a "\r" (0x0D) character.


Command Words

AUXn (where n is an integer from 1 to 50, 41-50 are features, 21-40 do not currently support query or toggle)
Supported qualifiers: NULL,?,=
CIRn (where n is an integer from 1 to 50, 41-50 are features, 21-40 do not currently support query or toggle)
Supported qualifiers: NULL,?,=
Note: Follows circuit order. See reference for indices of circuits.
POOLHT
Supported qualifiers: ?,=
POOLSP
Supported qualifiers: ?,=,+,-
POOLTMP
Supported qualifiers: ?
POOL
Supported qualifiers: NULL,?,=
SPA
Supported qualifiers: NULL,?,=
SPAHT
Supported qualifiers: ?,=
SPASP
Supported qualifiers: ?,=,+,-
SPATMP
Supported qualifiers: ?
AIRTMP
Supported qualifiers: ?
OPMODE
Supported qualifiers: ?
MODEL
Supported qualifiers: ?
FREEZE
Supported qualifiers: ?
Return value: 1 if active, 0 if inactive
NAMEn (where n is an integer from 1 to 50, 41-50 are features)
Supported qualifiers: ?
Note: Names follow circuit order. See reference for indices of circuits.
SENSORn (where n is an integer from 1 to 5 [PoolWater, PoolSolar, Air, SpaWater, SpaSolar])
Supported qualifiers: ?
Return value: 1 if error, 0 if no error
PUMPn (where n is an integer from 1 to 8)
Supported qualifiers: ?
Return value: Comma separated list of parameters (Watts, RPM, GPM(if avail), FilterStatus(if avail), Errors)
Note: Must be queried, no updates on change
Light Commands
COLORSWIM
Supported qualifiers: NULL
COLORSET
Supported qualifiers: NULL
COLORSYNC
Supported qualifiers: NULL
Intellibrite Commands
IB_PARTY
Supported qualifiers: NULL
IB_ROMANCE
Supported qualifiers: NULL
IB_CARIBBEAN
Supported qualifiers: NULL
IB_AMERICAN
Supported qualifiers: NULL
IB_SUNSET
Supported qualifiers: NULL
IB_ROYALTY
Supported qualifiers: NULL
IB_BLUE
Supported qualifiers: NULL
IB_GREEN
Supported qualifiers: NULL
IB_RED
Supported qualifiers: NULL
IB_WHITE
Supported qualifiers: NULL
IB_MAGENTA
Supported qualifiers: NULL
IB_HOLD
Supported qualifiers: NULL
IB_RECALL
Supported qualifiers: NULL
Magicstream Commands
MS_THUMPER
Supported qualifiers: NULL
MS_HOLD
Supported qualifiers: NULL
MS_RESET
Supported qualifiers: NULL
MS_MODE
Supported qualifiers: NULL

Qualifiers

NULL
If a command word is followed immediately by a carriage return ("\r", 0x0D) then it will act as a toggle command and toggle the state of the equipment specified by the command word.
?
A question mark designates a query for the state of the equipment or setting specified by the command word.
=
An equals sign requires a value to which the equipment specified by the command word will be set.
Equipment supported values: 1,0,TRUE,FALSE,T,F (case insensitive)
Setpoint supported values: valid integer temperature value
Dimmer supported values: "30%" - "100%"
Heat supported values: "OFF", "HEATER", "SOLPREF", "SOLAR"
+
A plus sign causes a step up in the value of the equipment or setting specified by the command word. This can be a temperature setpoint.
-
A minus sign causes a step down in the value of the equipment or setting specified by the command word. This can be a temperature setpoint.

Response Format

A response to a valid command starts with "!00" followed by a space. Then a command word followed by an equals sign and the value of the equipment or setting specified by the command word.

An invalid command results in a "?01 INVALID COMMAND" response.

All responses end with "\r\n" (0x0D,0x0A).

Example Commands

Some example commands are listed below:

"#POOLTMP?\r"
"#AUX1=0\r"
"#POOLSP+\r"


Example Responses

Some example responses are listed below:

"!00 POOLTMP=80 F\r\n"
"!00 AUX1=0\r\n"
"!00 POOLSP=84 F\r\n"

Downloads

Please choose the right firmware for your device model.

Pool Control (PC100PI) Intellitouch/EasyTouch

Firmware 1.6.7 update

Current software version: 1.6.7

Pool Control (PC100PS) Suntouch

Firmware 1.6.7 update

Current software version: Firmware: 1.6.7


See forum for details & discussion: Visit Forum


Firmware updates should only be applied over a local network connection. If the firmware update times out on the first attempt, try it again and do not reboot the device.

Note: Firmware updates require the Java runtime available here: http://www.java.com/en/download

Personal tools