Return codes

There are several possible return codes that may result from the driver's interaction with the hardware. They are as follows:

PASS

PASS means that the transactions succeded. This shall be defined as 0 (zero).

DEV_FAIL

DEV_FAIL means that the hardware in the device failed to respond to the SIB interface handshaking within the allocated time period, either for monitor data, or for command data. The SIB responded normally.

COMM_FAIL

COMM_FAIL means that the device detected a parity error in a command byte.

TIMEOUT

TIMEOUT means that the device failed to send anything back to the host. This is normally caused by a parity error in a control command word, or the interface being physicaly disconnected or powered off.

All failure codes shall be small negative numbers.