User's Manual

User Guide

WherePort III User Guide

ll other trademarks are the property of their respective owners.

7 COMMAND SUMMARY

This section describes the commands used to configure the WherePort.

All commands and responses are ASCII character strings.

ACK responses are the three character string ‘ACK’ and not the 0x06 non-

printable character. Similarly, NAK responses are the three character string ‘NAK’ and

not the 0x15 non-printable character.

All numbers (represented by ‘n’ in command list) sent are the ASCII

representation of the value. For example, the number 14 is sent as the two ASCII

character string ‘14’ and not the single byte 0x0E. The number 7 is sent as the single

ASCII character ‘7’ and not the single byte 0x07.

7.1 Initial Power Up

When theWherePort is initially powered up, it will transmit the following string.

{CR}{LF}

WhereNet{CR}{LF}

WherePort vx.xx <CR><LF> (where x.xx is the firmware version)

7.2 Passwords

Every command must start with a four character password followed by a colon. For

example, if the passwore is 1234 the query command would be entered as follows:

1234:VER?<CR><LF>

The WherePort will respond with NAK to any command that does not start with the

correct password.

The WherePort ignores space characters, carriage return characters, and the line feed

character because it signals the end of a command. These three characters (0x0D, 0x0A,

0x20) may not be used in passwords. All other byte values are legal.

The password is set to the default value of 1234. The only command that does not require

the password is the HWT n command. The HWT n command sets and queries the

password. To access the password, the host must send the following three commands in

order. Any other command, or any change to the sequence will reset the access flags. The

sequence of commands is:

HWT 3 Set flag 1 of 3 only if all 3 flags are cleared.

HWT 4

Set flag 2 of 3 only if flag 1 is set and 2 and 3 are clear.

HWT 5

Set flag 3 of 3 only if flags 1 and 2 are set and 3 is clear.

HWT 6

Set password to 1234 only if all 3 access flags are set.