Jump to main content

# 1.1.2.4.4 DRV_G3_MACRT_TxRequest Function

## C

    void DRV_G3_MACRT_TxRequest (
        const DRV_HANDLE handle,
        uint8_t *pData,
        uint16_t length
    );

## Summary

Allows a client to transmit G3 MAC data through Power Line (PLC).

## Description

This routine sends a new data message through PLC using the G3 MAC RT driver. The message must have a valid IEEE 802.15.4 MAC format with its corresponding MAC header.

## Precondition

DRV_G3_MACRT_Open must have been called to obtain a valid opened device handle.

## Parameters

Param | Description
--- | ---
handle | A valid instance handle, returned from the driver's open routine.
pData | Pointer to the data to transmit.
length | Length of the data to transmit in bytes.

## Returns

None.

## Example

    // 'handle', returned from DRV_G3_MACRT_Open previously called

    // Local function implemented in the user application
    _setupTransmissionParameters();

    DRV_G3_MACRT_TxRequest(handle, appData.pData, appData.length);

## Remarks

None.

Rev: G