FB_SoERead
With the FB_SoERead function block a parameter can be read.
Inputs
VAR_INPUT
sNetId : T_AmsNetId := '';
nIdn : WORD;
nElement : BYTE;
pDstBuf : PVOID;
cbBufLen : UDINT;
bExecute : BOOL;
tTimeout : TIME := DEFAULT_ADS_TIMEOUT;
END_VAR
Name | Type | Description |
---|---|---|
sNetId | T_AmsNetId | String, which contains the AMS Network ID of the PC (type: T_AmsNetId). |
nIdn | WORD | Parameter number to which FB_SoERead refers, e.g. "S_0_IDN + 33" for |
nElement | BYTE | Specifies which part of the parameter should be accessed, e.g. 16#40 is the value (Value) of the parameter. EC_SOE_ELEMENT_DATASTATE :BYTE :=16#01; |
pDstBuf | PVOID | ADR() of the variables to which the value should be read. |
cbBufLen | UDINT | SIZEOF() of the variables to which the value should be read. |
bExecute | BOOL | The function block is enabled via a positive edge at this input. |
tTimeout | TIME | Maximum time allowed for the execution of the function block. |
Inputs/outputs
VAR_IN_OUT
Axis : NCTOPLC_AXIS_REF;(* reference to NC axis *)
END_VAR
Name | Type | Description |
---|---|---|
Axis | Axis data structure of the type NCTOPLC_AXIS_REF |
Outputs
VAR_OUTPUT
bBusy : BOOL;
bError : BOOL;
iAdsErrId : UINT;
iSercosErrId : UINT;
dwAttribute : DWORD;
END_VAR
Name | Type | Description |
---|---|---|
bBusy | BOOL | This output is set when the function block is activated, and remains set until a feedback is received. |
bError | BOOL | This output is set after the bBusy output has been reset when an error occurs in the transmission of the command. |
iAdsErrId | UINT | Returns the ADS error code of the last executed command when the bError output is set. |
iSercosErrId | UINT | In the case of a set bError output returns the Sercos error of the last executed command. |
dwAttribute | DWORD | Returns the attributes of the Sercos parameter. |
Sample
fbRead : FB_SoERead;
bRead : BOOL;
iReadValue : UINT;
nIdn : WORD;
bReadValue : UINT;
(* NcAxis *)
NcToPlc AT %I* : NCTOPLC_AXIS_REF;
IF bRead THEN
nIdn := S_0_IDN + 33;
fbRead(
Axis := NcToPlc,
nIdn := nIdn,
nElement := 16#40,
pDstBuf := ADR(iReadValue),
cbBufLen := SIZEOF(iReadValue),
bExecute := TRUE,
tTimeout := DEFAULT_ADS_TIMEOUT,
);
IF NOT fbRead.bBusy THEN
fbRead(Axis := NcToPlc, bExecute := FALSE);
bRead := FALSE;
END_IF
END_IF