Jump to main content

# 1.1.2.4.6 DRV_G3_MACRT_PIBSet Function

## C

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

## Summary

Allows a client to set information to PLC transceiver on G3 MAC RT and PHY Information Base (PIB).

## Description

This routine sets G3 MAC RT and PHY data information to 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 setting information.

## Parameters

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

## Returns

MAC_RT_STATUS Enum value containing the result of set operation.

## Example

    // 'handle', returned from DRV_G3_MACRT_Open previously called

    MAC_RT_PIB_OBJ pibObj;
    uint8_t autoMode
    uint8_t impedance;
    uint8_t forcedRobo;

    // Disable AUTODETECT impedance mode
    autoMode = 0;

    // Set VLO impedance mode
    impedance = VLO_STATE;

    pibObj.pib = MAC_RT_PIB_MANUF_PHY_PARAM;
    pibObj.index = PHY_PARAM_CFG_AUTODETECT_BRANCH;
    pibObj.pData = &autoMode;
    pibObj.length = 1;
    DRV_G3_MACRT_PIBSet(handle, &pibObj);

    pibObj.pib = MAC_RT_PIB_MANUF_PHY_PARAM;
    pibObj.index = PHY_PARAM_CFG_IMPEDANCE;
    pibObj.pData = &impedance;
    pibObj.length = 1;
    DRV_G3_MACRT_PIBSet(handle, &pibObj);

    // Forces Modulation Type in every transmitted frame (1 - Force BPSK_ROBO)
    forcedRobo = 1;

    pibObj.pib = MAC_RT_PIB_MANUF_FORCED_MOD_TYPE;
    pibObj.index = 0;
    pibObj.pData = &forcedRobo;
    pibObj.length = 1;
    DRV_G3_MACRT_PIBSet(handle, &pibObj);

## Remarks

None.

Rev: G