AN241
5.3. NLME-PERMIT-JOINING
5.3.1. Description
This primitive opens a Coordinator or Router to accept other devices to its network.
Applicability:
Applies to Coordinator or Routers only.
Prerequisite:
Device already started as Coordinator or Router.
NLME-NETWORK-FORMATION (Coordinator), or
NLME-START-ROUTER (Router)
5.3.2. Request
Description:
This function allows the next higher layer of a ZigBee coordinator or router to set its MAC
sub-layer association permit flag for a fixed period during which it may accept devices
onto its network.
Function Prototype: NWK_ENUM nlmePermitJoiningRequest(BYTE permitDuration)
Parameters:
BYTE permitDuration
The length of time in seconds during which the ZigBee coordinator or router will allow
associations.
The values 0x00 and 0xff indicate that permission is disabled or enabled, respectively,
without a specified time limit.
5.3.3. Confirm
Description:
Confirmation by return value of nmlePermitJoiningRequest, type NWK_ENUM (See
Section “6.1.1. NWK_ENUM” on page 28).
Returned Values:
SUCCESS:
INVALID_REQUEST: Occurs if issued to a ZigBee end device.
UNSUPPORTED_ATTRIBUTE:
INVALID_PARAMETER:
16
Rev. 0.1