AddVariable

Adds a user-defined variable.

Syntax

KsError AddVariable(
     UserVariable* Variable
);

Parameters

Variable: the variable you want to add. See the UserVariable structure.

Return value

If the function succeeds, it returns errNoError, otherwise an error code. For more information about the error code, see the KsError list.

Remarks

• The variable can be used in KINGSTAR Scope and a real-time log.
• You can add up to 64 variables.

Usable EtherCAT states

ecatOffline, ecatInit, ecatBoot, ecatPreOP, ecatSafeOP, ecatOP

Example

// Add an user variable in the variable table
UserVariable addVariable = { 0, L"User Control Flag", NULL, logBool };
nRet = AddVariable(&addVariable);
bool *ctrlFlag = (bool*)addVariable.Value;

if (nRet == errNoError)
{
    // Access the user variable in you application
    *ctrlFlag = true;
}

// Remove the variable if you are not going to use it anymore
nRet = RemoveVariable(addVariable.Id);

Requirements

See also

GetVariable

GetVariables

RemoveVariable