1.2.5.16 ADP_DataRequest Function

C

void ADP_DataRequest (
    uint16_t nsduLength,
    const uint8_t *pNsdu,
    uintptr_t nsduHandle,
    bool discoverRoute,
    uint8_t qualityOfService
);

Summary

This primitive requests the transfer of a PDU to another device or multiple devices.

Description

The ADP Data Request primitive is used to transfer data to to another device or multiple devices in the G3 Network. Result is provided in the corresponding ADP Data Confirm callback.

Parameters


Param	Description
nsduLength	The size of the NSDU, in bytes; Up to 1280
pNsdu	Pointer to NSDU to send; has to be a valid IPv6 packet
nsduHandle	The handle of the NSDU to transmit. This parameter is used to identify in the ADP Data Confirm primitive which request it is concerned with. It can be randomly chosen by the application layer.
discoverRoute	If true, a route discovery procedure will be performed prior to sending the frame if a route to the destination is not available in the routing table. If false, no route discovery is performed.
qualityOfService	The requested quality of service (QoS) of the frame to send. Allowed values are 0 (normal priority) and 1 (high priority).

Returns

None.

Example

uint8_t nsdu[1280];
uint16_t nsduLength;

// ...
// Fill NSDU
// ...

ADP_DataRequest(nsduLength, nsdu, 0, true, 0);
// Wait for Data Confirm

Remarks

None.