UpdateDiagnosisEntry (FB)¶

FUNCTION_BLOCK UpdateDiagnosisEntry

This function block is used by a Profinet-Device application to add and remove Profinet diagnosis-data.

The device application adds or removes diagnosis information according to the status of its real periphery.
The real periphery is specified through the diagnosis source (API, Slot, Subslot, Channel, Direction, Accumulative).
A diagnosis information (ChannelErrorType, optionally ExtChannelErrorType) exist only once per diagnosis source.
If severity or ExtChannelErrorAddValue changes, the diagnosis information is updated regarding these values.

If the diagnosis of a particular submodule changes during operation (submodule is in data-exchange), a diagnosis alarm is issued to the IO controller owning this submodule.

Update Diagnosis

PROGRAM PLC_PRG
VAR
    ID : UDINT;
    exec : BOOL;            // trigger execution of function block by setting exec := TRUE
    appears : BOOL := TRUE;
    updateDiag : ProfinetCommon.UpdateDiagnosisEntry;
END_VAR


ID := CommFB.SUBSLOT_ID(EN := TRUE, ID := PN_Device.DeviceID, SLOT := 2, SUBSLOT := 1);

updateDiag.ID := ID;
updateDiag.xAppears := appears;
updateDiag.ChannelNumber := 1;
updateDiag.ChannelProperties.ChannelType := ProfinetCommon.ChannelProperties_Type.BitSize1;
updateDiag.ChannelProperties.Direction := ProfinetCommon.DiagnosisDirection.In;
updateDiag.Diagnosis.Severity := ProfinetCommon.DiagnosisSeverity.Fault;
updateDiag.Diagnosis.ChannelErrorType := ProfinetCommon.ChannelErrorType.Line_break;    //0x0006 Line break
updateDiag(xExecute := exec);

IF(updateDiag.xDone OR updateDiag.xError) THEN
    exec := FALSE;
END_IF

InOut:

Scope	Name	Type	Initial	Comment
Input	`xExecute`	`BOOL`		Rising edge: Execute update of submodule’s diagnosis
	`ID`	`UDINT`		Submodule-ID
	`xAppears`	`BOOL`		TRUE: Diagnosis appears - add new diagnosis or update Severity and additional value FALSE: Diagnosis disappears - clear diagnosis specified by source(Submodule, Channel) and error/ext-error
	`ChannelNumber`	`UINT`	16#8000	The channel number of the diagnosis source (0x8000 means the whole submodule)
	`ChannelProperties`	ChannelProperties		additional channel data, not used for diagnosis that affect the whole submodule.
	`Diagnosis`	ChannelDiagnosisData		The diagnosis-data entry
Output	`xDone`	`BOOL`		Action successfully completed
	`xBusy`	`BOOL`		Function block active
	`xError`	`BOOL`		error occurred, function block aborts action
	`Status`	UpdateDiagnosis_Status		Error related to local update of diagnosis data, e.g. duplicate entry, no ressource…
	`PNIOStatus`	`UDINT`		PNIOStatus of Alarm processing (only with established AR)