Page Comparison

Utilities

Take the control of the specified function block of the currently connected model. Only one client API at a time is granted a given function block control. See OP_FUNCTIONAL_BLOCK for more information about the available function blocks.

Example: In order to be able to take a snapshot of the running model, control of the snapshot function block should be first requested using RtlabApi.TakeFunctionControl(OP_FB_SNAPSHOT, 0, 0). As soon as the control is granted, the user can call the OpalSnapshot(...) function.

None

RtlabApi.TakeFunctionControl(functionalBlock, fbElement, priority)

• functionalBlock: Functional block which control is to be requested. See OP_FUNCTIONAL_BLOCK.

• fbElement: Functional block element which control is to be requested. This input is used to specify the acquisition groups or the subsystem id when the function block are OP_FB_ACQ_GROUP and OP_FB_SIGNAL respectively. Normally, this value is 0.

• priority: Control priority to be requested. Higher is the value, higher is the priority. See OP_CONTROL_PRIORITY.

None

• EOK: Success.

• EPERM: Control requested but already given to another client.

• EBADF: Model not specified by previous

• Connect or

• OpenProject.

• EIO: Error sending the request or receiving the reply.

• ENOMEM: Memory allocation error.

• EINVAL: Invalid function block.

• ESRCH: Model instance id not found.

None

ReleaseFunctionControl, OP_FUNCTIONAL_BLOCK, OP_CONTROL_PRIORITY.

import RtlabApi