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].
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
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.