User's Manual

User Guide

___________________________________________________________________________________________________________________

_________________________________________________________________________________________________________________

User Guide, WherePort IV D1300 REV A

12.0 COMMAND SUMMARY

This appendix describes the commands used to configure the WherePort IV.

• 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.

12.1. Initial Power Up

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

{CR}{LF}

WhereNet{CR}{LF}

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

12.2. Passwords

Every command must start with a four character password followed by a colon. For example, if the

password is 1234 the query command would be entered as follows:

1234:VER?<CR><LF>

The WherePort IV will respond with NAK to any command that does not start with the correct password.

The WherePort IV 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.