ZAURA Datasheet, PDF (42/99 Pages) –

ZAURA RF Wireless Library
Programmer’s Reference Manual
30
ZAURA_RF_Transmit
Description The ZAURA_RF_Transmit API sends data to a specific node
(0x00 < Dest < 0xFF) or broadcasts the data to all nodes within
range of the transmitter (Dest = ZAURA_RF_BC_ADDR). The
data will be transferred reliably or unreliably, depending on the
values of the Dest and Ctrl parameters. Data transfer will be reli-
able using the RDTFC if the Ctrl parameter specifies the use of an
SDATA frame; the Dest parameter is not
ZAURA_RF_BC_ADDR (0xFF) and the ZAURA_RF_Format
configuration variable is set to XFER_DA_SA_CTRL. If any of
these conditions is not satisfied, the data will be transferred unreli-
ably. The Ctrl field is meaningless if the ZAURA_RF_Format
configuration variable is set to either XFER_DA or
XFER_DA_SA.
A return code of ZAURA_RF_SUCCESS means different things
depending on whether RDTFC was used or whether the data was sent
unreliably with a DATA frame. If the data was transported via a DATA
frame, then ZAURA_RF_SUCCESS indicates that the transmitter did
not encounter any errors while sending the frame. If the data was sent
using an SDTA frame, ZAURA_RF_SUCCESS indicates that the peer
node acknowledged and accepted the frame.
A return code of TX_CHANNEL_BUSY indicates that the data was
not transmitted because the channel was in use. This status can only be
returned if the ZAURA_RF_CsAttempts configuration variable is non-
zero, because a zero value disables carrier sensing before transmission.
A ZAURA_RF_TX_NOT_ACK status means that the SDATA frame
was successfully transmitted but no acknowledgement was received
after ZAURA_RF_MaxRetry +1 attempts to transmit the SDATA
frame. As a result, either the target did not receive the SDATA frame or
the transmitter did not receive the ACK.
A ZAURA_RF_TX_NAK status indicates that the SDATA frame was
successfully transmitted and an ACK was received. However, the
ACK indicates that the target rejected the data due to a sequence error.
This situation can occur if the first transmission of the SDATA frame is
received and accepted by the target but the target’s ACK is lost. In this
instance, the transmitter will attempt to retransmit the SDATA frame
and the target will reject the data as a duplicate. The
ZAURA_RF_TX_NAK status could also indicate that the recipient
was unable to accept the otherwise-valid SDTA frame because no buf-
fer space was available to hold the data.
ZAURA RF Wireless API Reference
RM006003-1011