FC_SemaphoreMeGiveForce

 

FC_SemaphoreMeGiveForce - General Information

Overview

Type:

Function

Available as of:

V1.0.7.0

Versions:

Current version

Task

Release a semaphore regardless of its Task.

Description

NOTE: The function only helps when debugging. It may not be used for any other purpose! Disregarding this can lead to the destruction of the content of data structures in critical areas!

For restrictions for use see Notes on Using the "SemaphoreMutualExclusion" Function.

Interface

Output

Data type

Description

q_etDiag

GD.ET_Diag

General library-independent statement on the diagnostic.

A value not equal to ET_Diag.Ok corresponds to an diagnostic message.

q_etDiagExt

ET_DiagExt

POU-specific output on the diagnostic.

q_etDiag = ET_Diag.Ok -> Status message

q_etDiag <> ET_Diag.Ok -> Diagnostic message

Input/Output

Data type

Description

iq_stSemMe

ST_SemaphoreMe

Structure of the semaphores to be released

Return Value

Data type

Description

BOOL

TRUE: the semaphore has been successfully released.

FALSE: the semaphore has not been released.

Diagnostic Messages

q_etDiag

q_etDiagExt

Enumeration value

Description

OK

Ok

0

Ok

InputParameterInvalid

SemaphoreMeNotInitialized

266

SemaphoreMe is not initializd.

UnexpectedProgramBehavior

SemaphoreMeGiveForceFailed

268

GiveForce of the SemaphoreMe was unsuccessful.

Ok

Enumeration name:

Ok

Enumeration value:

0

Description:

Ok

The semaphore has been successfully released.

SemaphoreMeGiveForceFailed

Enumeration name:

SemaphoreMeGiveForceFailed

Enumeration value:

268

Description:

GiveForce of the SemaphoreMe was unsuccessful.

Issue

Cause

Solution

-

An error occurred in the internal execution.

Please inform the support team about this error.

SemaphoreMeNotInitialized

Enumeration name:

SemaphoreMeNotInitialized

Enumeration value:

266

Description:

SemaphoreMe is not initializd.

Issue

Cause

Solution

-

The semaphore is not initialized.

Transfer the same semaphore which was used during call-up of FC_SemaphoreMeCreate at the iq_stSemMe input.