Set_Attribute_Single (FB)¶

(* CIP Data type for string with a length of max. 64 chars *)
TYPE STRING64 :
STRUCT
   uiLength  : UINT;
   sString   : STRING(63);
END_STRUCT
END_TYPE

PROGRAM PLC_PRG
VAR
    setAttributeSingle : ENIP.Set_Attribute_Single ;
    strHostnameToSet   : STRING64 := (sString := 'NewName');
END_VAR

strHostnameToSet.uiLength := INT_TO_UINT(Standard.LEN(strHostnameToSet.sString));
setAttributeSingle(
    xExecute:= ,
    itfEtherNetIPDevice:= EtherNetIP_Adapter,          (* instance of the device (instance is found in the I/O Image of the device) *)
    eClass:= ENIP.CIPClass.TCPIPInterfaceObject,       (* cip class which contains the desired attribute *)
    dwInstance:= 1,                                    (* value of 0 is class level, range from 1..x is instance level *)
    pData:= ADR(strHostnameToSet),                     (* data to be assigned to the attribute *)
    udiDataSize:= SIZEOF(strHostnameToSet.uiLength) + strHostnameToSet.uiLength, (* size of the data. Here: size of the Length-Parameter PLUS the length of the string *)
    wAttribute:= 6,                                    (* attribute no. 6 of the tcp/ip interface object is the Hostname (CIP Spec. Vol.2 Chapter 5-3.3.2.6)*)
    xDone=> ,
    xBusy=> ,
    xError=> ,
    eError=> );
;