Responses

 

When a successful SET, SETL, INC, DEC, or RECALL command is sent to an Nexia device via RS-232 or Telnet, Nexia will respond with: ‘+OK’ followed by a carriage return and line feed.

Example: Sending the string: SET 2 AMLVLIN 4 2 1 < LF> will result in an: +OK<CR><LF> response.

 

A successful GET or GETL command will result in a numerical response to the command string followed by <CR><LF>.

 

The response from an NTP string with a GET command may contain a decimal point (with 4 numbers after the decimal) and/or negative numbers, depending on type of Attribute addressed. If the control system does not support negative numbers or decimal places a GETL command may be used instead (see page 6).

 

Example: After sending the above example to an Nexia device the string:

GET 2 AMLVLIN 4 2<LF> would result in the response: 1.0000 <CR><LF> this tells us that the level is currently set to 1dB.

 

If an incorrect command string is sent, an Nexia will respond with: -ERR<CR><LF>

 

A space normally proceeds the carriage return/line feed <CR><LF> in a response to a GET command, but this space is not present in the standard ‘+OK’ or ‘-ERR’ responses.

 

Note: SETD, GETD, INCD, DECD, SETLD, and GETLD commands may be used when a ‘full path’ serial response to the command is desired. A ‘full path’ serial response will provide identification of the target object, the original command, and the resulting Value. A ‘full path’ response to a valid command will always begin with a pound sign (#) and end normally (as described above).

 

Examples:

 

Command = SETD 1 IPADDR 192.168.1.197

Response = #SETD 1 IPADDR 192.168.1.197 +OK

 

Command = GETD 1 IPADDR

Response = #GETD 1 IPADDR 192.168.1.197

 

Command = SETD 1 MMLVLXP 38 1 1 -1.1

Response = #SETD 1 MMLVLXP 38 1 1 -1.1 +OK

 

Command = INCD 1 MMLVLXP 38 1 1 1.0

Response = #INCD 1 MMLVLXP 38 1 1 -0.1000 +OK

 

It should be noted that, unlike SETD commands/responses, INCD or DECD commands and responses will most often contain different Values. This is because SETD commands specify an exact Value (which will be the same in the response), whereas, INCD and DECD commands specify a ‘change’ in Value.