Pool Control 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.

NOTE: Twitter alerts are not available in this firmware. But you can use e-mail alerts in combination with a free service such as posterous or ifttt to convert your e-mails to twitter posts (and more!).

Protocol

The protocol for communication with the TCP serial port has been implemented to be compatible with the original Jandy® serial adapter protocol. Please see the serial adapter manual for more documentation. At this time not all commands are supported, so see the list below.

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 15)
Supported qualifiers: NULL,?,=,+,-
POOLHT
Supported qualifiers: NULL,?,=
POOLSP
Supported qualifiers: NULL,?,=,+,-
POOLTMP
Supported qualifiers: ?
POOLHT2
Supported qualifiers: NULL,?,=
POOLSP2
Supported qualifiers: NULL,?,=,+,-
POOLTMP2
Supported qualifiers: ?
PUMP
Supported qualifiers: NULL,?,=
PUMPLO
Supported qualifiers: NULL,?,=
SPA
Supported qualifiers: NULL,?,=
SPAHT
Supported qualifiers: NULL,?,=
SPASP
Supported qualifiers: NULL,?,=,+,-
SPATMP
Supported qualifiers: ?
SOLHT
Supported qualifiers: NULL,?,=
SOLTMP
Supported qualifiers: ?
AIRTMP
Supported qualifiers: ?
OPMODE
Supported qualifiers: ?
WFALL
Supported qualifiers: NULL,?,=
CLEANR
Supported qualifiers: NULL,?,=
VBAT
Supported qualifiers: ?
OPTIONS
Supported qualifiers: ?
MODEL
Supported qualifiers: ?
UNITS
Supported qualifiers: ?


Additional Commands in Advanced Firmware


VSPn (where n is an integer from 1-4)
Supported qualifiers: ?,=
SWCPOOL
Supported qualifiers: ?,=
SWCSPA
Supported qualifiers: ?,=
SALTPOOL
Supported qualifiers: ?
SALTSPA
Supported qualifiers: ?
ORPLVLn (where n is an integer from 1-2)
Supported qualifiers: ?,=
PHLVLn (where n is an integer from 1-2)
Supported qualifiers: ?,=
ORPFEEDn (where n is an integer from 1-2)
Supported qualifiers: NULL,?,=
PHFEEDn (where n is an integer from 1-2)
Supported qualifiers: NULL,?,=
ONETOUCHn (where n is an integer from 1-6)
Supported qualifiers: NULL,?,=
HTPMP
Supported qualifiers: NULL,?,=
LIGHTS
Supported qualifiers: ?
Note: Returns a comma separated list of the aux circuits and their configured light type numeric index [None=0, Jandy Colors, Jandy LED, SAM/SAL, Color Logic, Intellibrite]
Note: Color lights will return a status of 0x81-0x8F (129-143) which represents the color index. Subtract 0x80 (128) to get the real index. The index will correspond to the color lists below depending on the light type. To select a color set the aux to a value between 1-15 representing the color index.
[ "Alpine White", "Sky Blue", "Cobalt Blue", "Caribbean Blue", "Spring Green", "Emerald Green", "Emerald Rose", "Magenta", "Garnet Red", "Violet", "Color Splash" ],
[ "Alpine White", "Sky Blue", "Cobalt Blue", "Caribbean Blue", "Spring Green", "Emerald Green", "Emerald Rose", "Magenta", "Violet", "Slow Splash", "Fast Splash", "USA!!!", "Fat Tuesday", "Disco Tech" ],
[ "White", "Light Green", "Green", "Cyan", "Blue", "Lavender", "Magenta", "Light Magenta", "Color Splash" ],
[ "Voodoo Lounge", "Deep Blue Sea", "Afternoon Skies", "Emerald", "Sangria", "Cloud White", "Twilight", "Tranquility", "Gemstone", "USA!", "Mardi Gras", "Cool Caberet" ],
[ "SAM", "Party", "Romance", "Caribbean", "American", "Cal Sunset", "Royal", "Blue", "Green", "Red", "White", "Magenta", "Hold", "Recall" ]

Special Commands

BCAST
Supported qualifiers: ?,=
This command is used to enable/disable the UDP status broadcast. Set to 2 to enable with heartbeats, 1 to enable without heartbeats, 0 to disable. The setting is persistent across reboots. When enabled, status changes will be broadcast to UDP port 7890. When heartbeats are enabled, a broadcast will be sent at least once every 30 seconds (default update = air temp). Status information is followed by an 8-bit sequence number in the format "uSeq=#" (# is 0-255). Broadcasts are each sent twice with the same sequence number.

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


+
A plus sign causes a step up in the value of the equipment or setting specified by the command word. This can be a dimmer or 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 dimmer or 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 (PC100JZ)

Firmware 1.6.9 update

Current software version: 1.6.9

See forum for details & discussion: Visit Forum

Pool Control Advanced (PC100JZ)

Firmware 1.6.9 update

Current software version: 1.6.9

See forum for details & discussion: Visit Forum

Pool Control w/ IR (PC100JZIR)

Firmware 1.6.9 update

Current software version: 1.6.9

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