Jump to main content

# 1.1.2.4.5 DRV_G3_MACRT_PIBGet Function

## C

    MAC_RT_STATUS DRV_G3_MACRT_PIBGet (
        const DRV_HANDLE handle,
        MAC_RT_PIB_OBJ *pibObj
    );

## Summary

Allows a client to get information from PLC transceiver about G3 MAC RT and PHY Information Base (PIB).

## Description

This routine gets G3 MAC RT and PHY data information from the PLC transceiver.

## Precondition

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

MAC_RT_PIB_OBJ must be configured before getting information.

## Parameters

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

## Returns

MAC_RT_STATUS Enum value containing the result of get operation.

## Example

    // 'handle', returned from DRV_G3_MACRT_Open previously called

    MAC_RT_PIB_OBJ pibObj;
    uint32_t phyVersion;
    uint8_t macRtVersion[6];

    pibObj.pib = MAC_RT_PIB_MANUF_PHY_PARAM;
    pibObj.index = PHY_PARAM_VERSION;
    pibObj.pData = &phyVersion;
    pibObj.length = 4;

    DRV_G3_MACRT_PIBGet(handle, &pibObj);

    pibObj.pib = MAC_RT_PIB_MANUF_MAC_RT_INTERNAL_VERSION;
    pibObj.index = 0;
    pibObj.pData = &macRtVersion;
    pibObj.length = 6;

    DRV_G3_MACRT_PIBGet(handle, &pibObj);

## Remarks

None.

Rev: G