1.3.4.1.8 MAC_PLC_MIB_SetAttributeSync Function

C

MAC_STATUS MAC_PLC_MIB_SetAttributeSync
(
    MAC_COMMON_PIB_ATTRIBUTE attribute,
    uint16_t index,
    const MAC_PIB_VALUE *pibValue
);

Summary

The MAC_PLC_MIB_SetAttributeSync primitive sets the value of an attribute in the MAC layer Common Information Base (IB).

Description

SetAttributeSync primitive is used to set the value of a MIB stored in MAC Common module. Sync suffix indicates that result of set operation is provided upon function call return, in the return status code.

Precondition

MAC_PLC_Init routine must have been called before.

Parameters

ParamDescription
attributeIdentifier of the Attribute to provide value. See MAC_COMMON_PIB_ATTRIBUTE
indexIndex of element in case Attribute is a table. Otherwise index must be set to '0'
pibValuePointer to MAC_PIB_VALUE object where value is contained

Returns

Result of set operation as a MAC_STATUS code.

Example

MAC_STATUS status;
const MAC_PIB_VALUE value = {
    .length = 1,
    .value = 1
};

status = MAC_PLC_MIB_SetAttributeSync(MAC_COMMON_PIB_PROMISCUOUS_MODE, 0, &value);
if (status == MAC_STATUS_SUCCESS)
{
    // MIB correctly set
}

Remarks

None.