ZAURA Datasheet, PDF (61/99 Pages) –

ZAURA RF Wireless Library
Programmer’s Reference Manual
49
ZAURA_RF_SetNID
Description This function is used to modify the ZAURA RF Network ID (NID)
used by the radio. All nodes within the same ZAURA RF cell must use
the same NID (and channel) to communication with one another. The
NID is an arbitrary value between 1 and 4 bytes in length. If the NID is
of the proper length, the radio is reconfigured to used the new NID, the
ZAURA_RF_Params structure is updated and
ZAURA_RF_SUCCESS is returned. Otherwise,
ZAURA_RF_INVALID_PARAM is returned and the current NID is
not modified.
To improve the radio’s immunity to noise, the caller should avoid using
NID values that contain long sequences of repeated binary 1 or 0 dig-
its. For example, the NID value 0x00000001 should be avoided
because a single pulse of RF energy near the channel centre frequency
could be misinterpreted as a valid NID.
Syntax
ZAURA_RF_STATUS ZAURA_RF_SetNID( RF_NID * pNid );
Parameters
pNid
Points to a new NID.
Returns ZAURA_RF_SUCCESS, ZAURA_RF_INVALID_PARAM
See Also ZAURA_RF_GetNID, ZAURA_RF_SetParams,
ZAURA_RF_NID Structure, ZAURA_RF_PARAMS Structure
Example
ZAURA_RF_NID MyNid;
ZAURA_RF_STATUS;
MyNid.Len = 2;
MyNid.Value.Data8[0] = 0x11;
MyNid.Value.Data8[1] = 0x22;
Status = ZAURA_RF_SetNid( &MyNid );
RM006003-1011
ZAURA_RF_SetNID