User Manual

Table Of Contents
Appendix 101
Return Values of Mailbox Commands
WAGO-I/O-SYSTEM 750
I/O Modules
6.2 Return Values of Mailbox Commands
The following standard values are defined for the return values
(MBX_RESULT) of mailbox commands:
Label Return
value
Description
MBX_CMD_OK 0x00 Successful execution
MBX_CMD_GENERAL_ERROR 0x01 General error
MBX_CMD_DENIED_UNKNOWN 0x02 Unknown command
MBX_CMD_OUT_OF_RANGE 0x03 Values outside of the valid range
(overrun or underrun)
MBX_CMD_INVALID_ARG 0x04 False or invalid argument
MBX_CMD_INTERNAL_ERROR 0x05 Internal fault
MBX_CMD_TIMEOUT 0x06 Time overrun of the command
MBX_CMD_DENIED_NOT_APPLICABLE 0x07
Prerequisites for command not ful-
filled: false operation mode, false
device role or necessary precursor
command not executed
MBX_CMD_DENIED_NOT_IMPLEMENTED 0x08 Command reserved for later imple-
mentation
MBX_CMD_DENIED_MBX_TOO_SMALL 0x09 Mailbox too small for return value
MBX_CMD_DENIED_BUSY 0x0A Current or precursor command being
executed, no valid data is available
yet. Recommendation: call up com-
mand again after a short waiting
period.
MBX_CMD_INVALID_CONFIGURATION 0x0B System or network configuration is
defective
All mailbox commands use these return values to signal the status of the
command execution. If individual return values offer additional interpretations
for specific mailbox commands, this is explained in more detail in the descrip-
tion of the respective command.
In principle, the first return value with a mirrored mailbox command and tog-
gle bit is considered a valid response. As soon as this happens, the next mail-
box command can be executed. Many commands result in a restart of the
module. If a mailbox command that triggers a restart is not replaced by an-
other command after receiving the response, the module recognizes the unal-
tered, existing command when it restarts. The command is rejected with
MBX_CMD_DENIED_BUSY to prevent an endless loop of resets. This of-
fers the possibility of determining the successful conclusion of a reset by
monitoring change of the return value.