Echelon Neuron C User Manual
Page 144
132
How Devices Communicate Using Application Messages
the event. See the
Predefined Events
chapter in the
Neuron C Reference Guide
for more information.
The msg_completes event is the most general event. When an outgoing message
completes (that is, succeeds
or
fails), this event evaluates to TRUE.
The msg_succeeds event evaluates to TRUE when a message is successfully sent.
The msg_fails event evaluates to TRUE when a message fails to be sent (after all
retry attempts). See Table 9 for a more precise breakdown of what “success” and
“failure” mean for each service type. For a given message, only
one
of these
events evaluates to TRUE. The order of processing is thus important. If a
msg_completes event is processed before the msg_succeeds and msg_fails events,
the msg_succeeds and msg_fails events never evaluate to TRUE.
Note: See also
Comparison of resp_arrives and msg_succeeds
on page 141.
These events are primarily of interest when you send a message with either the
acknowledged service or the request/response service (see
on page 136). If you send a message with the
unacknowledged or repeated service, the msg_succeeds and msg_completes
events are
always
TRUE as soon as the message is transferred from the network
processor to the Media Access Control (MAC) processor on the sender device.
Table 9. Success/Failure Completion Events
Service Used
SUCCESS =
FAIL=
Unacknowledged
Message is transmitted
to MAC processor.
See Note.
Repeated
N
messages are
transmitted to MAC
processor. (
N
is the
number of repeats.)
See Note.
Acknowledged
All acknowledgments
have been received by
the network processor on
the sender device.
One or more
acknowledgments are not
received. This applies to
both messages and
network variables.
Request/Response
All responses have been
received by the
application processor on
the sender device.
For a message:
One or
more of the responses did
not arrive.
For a network variable
poll:
(a)
One or more of
the responses did not
arrive. (b) None of the
responses had valid data.
Note: In all cases, if the Neuron firmware encounters an addressing error,
a failure event occurs (see the
Neuron C Reference Guide
). If a network variable
or message is unbound, a success event occurs.