FieldPoint Responses
FieldPoint Success Responses
The success response to a FieldPoint standard or extended command can take either of the following two forms:
| A[cr] | This response indicates that the command was executed successfully, and no other information is required in the response. This type of response does not contain a checksum. |
| A[response data][checksum][cr] | Some commands require more information in the success response. This type of success response contains a [response data] field and a [checksum] field. The [checksum] field is calculated by adding the numeric values of all the characters in the [response data] field and determining the modulo-256 of the sum. The modulus (remainder) of the division is converted to two ASCII-hex characters to form the [checksum] field. Refer to the FieldPoint Commands Overview topic for more information about FieldPoint command syntax. |
FieldPoint Error Responses
A FieldPoint module returns an error response when an erroneous condition is detected during the reception or execution of a command. FieldPoint modules return only the standard errors (N00 through N07) in response to standard commands, enabling FieldPoint modules to work with host software that is written for the Optomux protocol. In response to the extended commands, FieldPoint modules return either standard or extended errors, depending on which error response is most appropriate.
The error response to a FieldPoint standard or extended command has the following form: N[error number][cr], where [error number] is two ASCII-hex characters. The error numbers are listed and described in this chapter.
FieldPoint error responses do not contain a [checksum] field.
Standard Error Responses
The following table lists the FieldPoint standard error responses. They can be returned in response to standard or extended FieldPoint commands.
| Error Number (Hex) | Error Tag | Description |
|---|---|---|
| 00 | E_PUCLR_EXP | Power Up Clear expected. The command was ignored. A command other than Power Up Clear was attempted after power-up or power failure. Once the error is received by the host, it is unnecessary to send the Power Up Clear command, because the next command is executed normally. If this error message is received, the FieldPoint network module has gone through its power-up sequence and has reset all characteristics to defaults. If SnapShot is enabled, the module is configured in accordance with the stored SnapShot information. The cFP-180x does not return this error. |
| 01 | E_INVALID_CMD | Undefined command. The command character was not a legal command character, or the addressed module does not support this command. The command was ignored. |
| 02 | E_BAD_CHECKSUM | Checksum error. The checksum received in the command did not match the calculated checksum of the characters in the command. The command was ignored. |
| 03 | E_INBUF_OVRFLO | Input buffer overrun. The received command was too long. The command was ignored. |
| 04 | E_ILLEGAL_CHAR | Unprintable ASCII character received. Only characters from ASCII value 33 to 127 are permitted within commands. The command was ignored. |
| 05 | E_INSUFF_CHARS | Data field error. An insufficient or incorrect number of characters were received for the specified command. |
| 06 | E_WATCHDOG_TMO | Communications link network watchdog timed out. The command was ignored. The cFP-180x does not return this error. |
| 07 | E_INV_LIMS_GOT | Specified limits invalid for the command. This includes notification that an invalid digit (hex or decimal) was received. |
Extended Error Responses
The following table lists the FieldPoint extended error responses, which can be returned in response only to extended FieldPoint commands.
| Error Number (Hex) | Error Tag | Description |
|---|---|---|
| 80 | E_ILLEGAL_DIGIT | One or more characters sent in the command could not be correctly converted to a digit (hex or decimal). |
| 81 | E_BAD_ADDRESS | The command is valid, but the addressed module does not support the command received. |
| 82 | E_INBUF_FRMERR | The FieldPoint network module detected a serial framing error in the command. The command was ignored. |
| 83 | E_NO_MODULE | The addressed module does not exist. |
| 84 | E_INV_CHNL | One or more channels specified in the command either do not exist or do not support the operation specified. The command was ignored. |
| 85 | E_INV_RANGE | One or more ranges specified in the command either do not exist or do not support the setting specified. The command was ignored. |
| 86 | E_INV_ATTR | One or more attributes specified in the command either do not exist or do not support the setting specified. The command was ignored. |
| 88 | E_HOTSWAP | The module has been hot-swapped since it was last sent a command. This response is sent only if the network module is enabled to report hot-swaps, and if the hot-swap occurred after hot-swap reporting mode was enabled. The command was ignored. This error number can be sent in response to a standard command if you have enabled hot-swap reporting for the bank. |
| 89 | E_ADDR_NOT_SAME | The module addressed by the Resend Last Response is not the same as the module addressed by the previous command. |
| 8A | E_NO_RESEND_BUF | The response to the last command is unavailable. |
| 8B | E_HW_FAILURE | An irrecoverable fault has occurred. |
| 8C | E_UNKNOWN | An unidentifiable error condition has occurred. |