Set_Attribute_Single (FB)

FUNCTION_BLOCK Set_Attribute_Single EXTENDS BaseService

This function block is used for setting the attribute of a specific instance of a CIP object. This instance call sets the host name (of the device in the network) from the DEVICE_123_ETHERNET device as soon as xExecute yields TRUE:

Note

Data received and send needs to be swapped. See parent folder.

(* 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=> );
;

InOut:

Scope	Name	Type	Comment	Inherited from
Input	itfEtherNetIPDevice	IEtherNetIPService	EtherNet/IP Device which implements the EtherNet/IP Services interface	BaseService
	eClass	CIPClass	Class which shall perform the service	BaseService
	dwInstance	DWORD	Instance which shall perform the service (0: Class level, 1..x: Instance level)	BaseService
Output	eError	ERROR	Error (0-255: CIP Error; 256-x: Library Error)	BaseService
Input	wAttribute	WORD	Attribute to be set
	pData	POINTER TO BYTE	Data buffer
	udiDataSize	UDINT	Size of buffer