PreviousNext
Bond Node
Help > Peripherals > Coordinator > Bond Node

This command bonds a new [N] by the [C]. There is a maximum of approx. 10 s blocking delay when this function is called. The command must not be used inside Batch or Selective Batch.

 

Please note that the bonded [N] does not have to be configured for a working network RF channel as the channel is automatically inherited from the network member that provided the bonding and then written to the configuration.

 

Request

 

NADR

PNUM

PCMD

HWPID

0

1

NADR

0x00

0x04

?

ReqAddr

 BondingTestRetries

 

ReqAddr                    A requested address for the bonded [N]. The address must not be used (bonded) yet.
If this parameter equals 0, then the 1st free address is assigned to the [N].
If this parameter equals 0xF0 and the next parameter
BondingTestRetries is 0, then activation of the IQuip is performed for the later OTK bonding. See IQuip users guide for more details.

BondingTestRetries    Maximum number of FRCs used to test whether the [N] was successfully bonded. If the [N] does not respond, it is unbonded at the Coordinator’s side. If the value is 0, then no test is performed. If the [N] is connected to and bonded from DSM then this testing never succeeds.

 

Response

NADR

PNUM

PCMD

HWPID

ErrN

DpaValue

0

1

NADR

0x00

0x84

?

0

?

BondAddr

DevNr

 

 

 

 

 

BondAddr                  Address of the [N] newly bonded to the network. The value is undefined in the case of IQuip activation.

DevNr                        Total number of bonded Nodes.

 

Error codes

ERROR_FAIL      a. Nonzero ReqAddr is already used.
b. No free address is available when ReqAddr equals 0.
d. ReqAddr is out of range of valid addresses.
e. Internal call to bondNewNode failed.
f.  Bonded [N] did not respond to the testing FRC.