Network Server

    Updated Edit on GitHub
    Copy page

    The Network Server handles the LoRaWAN® network layer, including MAC commands, regional parameters and adaptive data rate (ADR).

    Device Management

    Network Servers expose NsEndDeviceRegistry service for end device management. Typical clients of this service are Console and CLI.

    Network Servers store device MAC configuration, MAC state and network session keys.

    Change of device MAC configuration may trigger a downlink message.

    Network Servers let Application Servers push, replace and list application downlinks as well as link applications via gRPC API.

    Change of application downlink queue may trigger a downlink message.

    Once the link is established, Network Server will send application-specific uplink messages to the client via the link. There can be at most one active link per-appplication.

    In case link is not active, but Network Server has application-specific uplink messages to send, those messages will be queued and sent once the link is established.

    Network Servers maintain internal downlink task queue. Each downlink task has an execution time associated with it, which tasks are sorted by in ascending order. Whenever a downlink task is ready to execute, it is executed as soon as possible.

    Join-accept

    In case a pending session exists and join-accept is queued for the device, it is scheduled.

    In case a pending session does not exist or join-accept for it has already been sent, Network Server attempts to genererate and schedule data downlink in the active session.

    Network Servers receive uplinks from Gateway Servers via gRPC.

    Network Servers process the uplinks received and handle accordingly. The first step is matching the uplink to a device. In case an uplink cannot be matched to a device stored in Network Server, it is dropped.

    Join-request

    If join-request is received:

    1. Device is matched using the DevEUI and JoinEUI pair present in the join-request, which uniquely identifies the device.
    2. New DevAddr is assigned to the device and new MAC state is derived for the device.
    3. If Join Server is present in the cluster, Network Server sends a join-request message to the cluster-local Join Server.
    4. If Join Server is not present in the cluster or the device is not provisioned in the cluster-local Join Server, Network Server sends a join-request message to the Join Server discovered via interoperability configuration.
    5. If a Join Server accepted the join-request, join-accept message may be enqueued for the device and application-specific uplink messages carrying relevant information about join-accept is sent to linked Application Server.

    If data uplink is received:

    1. Device is matched using the DevAddr present in the data uplink. Matching is performed by comparing the session context and MAC state, as well as performing the MIC check. Since several devices may have identical DevAddrs, the Network Server may need to go through several stored devices before matching the device.
    2. The Network Server processes the MAC commands, if such are present in the frame and updates MAC state accordingly.
    3. If ADR bit is set in data uplink, Network Server runs the ADR algorithm and updates MAC state accordingly.
    4. If data uplink is successfully processed, downlink may be enqueued for the device and one or more application-specific uplink messages carrying relevant information about join-accept are sent to linked Application Server.