Jump to main content

# 1.1.1.4.4 DRV_PLC_PHY_TxRequest Function

## C

    void DRV_PLC_PHY_TxRequest (
        const DRV_HANDLE handle,
        DRV_PLC_PHY_TRANSMISSION_OBJ *transmitObj
    );

## Summary

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

## Description

This routine sends a new data message through PLC using the PLC PHY driver.

## Precondition

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

DRV_PLC_PHY_TRANSMISSION_OBJ must be configured before requesting the transmission.

## Parameters

Param | Description
--- | ---
handle | A valid open-instance handle, returned from the driver's open routine.
transmitObj | Pointer to the object to transmit.

## Returns

None.

## Example

    // 'handle', returned from DRV_PLC_PHY_Open previously called

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

    memcpy(transmitObj.data, txBuf, dataLen);
    transmitObj.length = dataLen;

    DRV_PLC_PHY_TxRequest(handle, &transmitObj);

## Remarks

None.

Rev: G