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

ParamDescription
handleA valid open-instance handle, returned from the driver's open routine
transmitObjPointer 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);