IOF_SER_IDN_Read

IOF_SER_IDN_Read 1:

The IOF_SER_IDN_Read function block allows a value to be read from an S or P parameter of a Sercos drive. Data type and size are determined automatically on the basis of the attribute.

Inputs

VAR_INPUT
    sNetId     : T_AmsNetId;
    nIDN       : UINT;
    bExecute   : BOOL;
    nPort      : UINT;
    nMode      : DINT;
    nAttrib    : DWORD;
    cbLen      : UDINT;
    dwDestAddr : PVOID;
    tTimeout   : TIME := DEFAULT_ADS_TIMEOUT;
END_VAR

Name	Type	Description
sNetId	T_AmsNetID	The network address of the TwinCAT computer on which the ADS command is to be executed can be specified here. For the local computer an empty string may be specified.
nIDN	UINT	Contains the Sercos parameter number to be accessed for reading. nIDN must lie between 0 and 32767 for S parameters and between 32768 and 65535 for P parameters.
bExecute	BOOL	The function block is enabled by a positive edge at this input.
nPort	UINT	The port number nPort is assigned by the TwinCAT system during the hardware configuration.
nMode	DINT	The read mode determines which part of the parameter is to be read. nMode = 0: Value nMode = 2: Name nMode = 3: Attribute (is always read to determine data type and size, unless nAttrib is <> 0) nMode = 4: Unit (not available for every parameter) nMode = 5: Minimum (not available for every parameter) nMode = 6: Maximum (not available for every parameter)
nAttrib	DWORD	Attribute of the parameter, if known. If nAttrib = 0, IOF_SER_IDN_Write first reads the parameter attribute of the drive before the value is written to the parameter of the drive.
cbLen	UDINT	Maximum length of the data buffer that is to accept the value.
dwDestAddr	PVOID	Address of the data buffer that is to accept the value.
tTimeout	TIME	Specifies the time-out period that must not be exceeded when the command is executed.

Outputs

VAR_OUTPUT
    cbRead    : UDINT;
    nAttribRd : DWORD;
    sAttrib   : ST_SercosParamAttrib;
    bBusy     : BOOL;
    bError    : BOOL;
    nErrId    : UDINT;
END_VAR

Name	Type	Description
cbRead	UDINT	Number of bytes read and copied to dwDestAddr.
nAttribRd	DWORD	Attribute of the parameter; can be saved for the next access (nAttrib) to the parameter.
sAttrib	ST_SercosParamAttrib	Contains the nAttribRd attribute of the Sercos parameter broken down into individual variables.
bBusy	BOOL	When the function block is enabled, this output is set and remains set until a feedback is received.
bError	BOOL	If an error should occur during the transfer of the command, then this output is set once the bBusy output was reset.
nErrId	UDINT	Returns the ADS error number or the specific function block error number if the ERR output is set.

specific function block error number	Description
0x1003	Incorrect parameter mode
0x1004	Incorrect parameter data size

Requirements

Development environment	Target platform	IO hardware	PLC libraries to be integrated (category group)
TwinCAT v3.1.0	PC (x86)	Sercans SCS-P ISA; Sercans SCS-P PCI; Beckhoff FC750x PCI	Tc2_IoFunctions (IO)