Mode object for digital components with one order output.

 The object handles on digital order output, and has an object graph
 with Start/Stop and Auto/Man buttons to control a drive. CompModeD is
 for example used in BaseMotorAggr.

 The mode object handles several modes and configurations. The controlled
 unit can be handled locally or remotely.

 - Local mode    The unit is controlled from a local panel close to the drive.

 - Remote mode   The unit is controlled from the control system, either by
                 the operator from the object graph, or by PLC program.

 The local mode has higher priority than the remote.

 The mode handling also contains an extern and intern mode.

 - Intern mode   The unit is handled by the built-in Auto/Man function,
                 basically from the Auto/Man buttons in the object graph.

 - Extern mode   The built-in Auto/Man function is not used. Auto/Man is
                 handled from the plc program and other graphs.

 Which of these modes that are present depends on the configuration.

 Modes that can be configured

 - Intern          Auto/Manual mode is controlled from buttons in the
                   object graph. This is the default configuration.
 - Extern          Auto/Manual mode is controlled from the PLC program.
                   The Auto/Man buttons are removed from the object graph
                   but the Start/Stop buttons are still present.
                   Set attribute OpIntOnly to 1.
 - Extern only     Auto/Manual mode is controlled from the PLC program.
                   No Auto/Man or Start/Stop  buttons are present in the
                   object graph. Set attribute OpExtOnly to 1.
 - Intern only     Only manual mode is present, and the Auto/Man buttons
                   are removed. Set OpIntOnly to 1.
 - Local           When the local panel is activated, and the Start/Stop
                   buttons of the local panel is used. To disable this
                   mode, set OpNoLocal to 1.

 The Start/Stop buttons can also be configured to show On/Off instead.

 The Auto/Man buttons changes mode in remote control, and the Start/Stop
 buttons are used to manually control the drive at remote control.

 - The Start button has toggle function, i.e. if the unit is already
   started it will be stopped.

 - The Auto/Man buttons changes mode in remote control.

 - In local mode, the local indicator is yellow, and the Start/Stop buttons
   are dimmed. Control via Auto/Man is disabled.

 - The Extern indicator (not present in the graph above) displays when
   Auto/Man is controlled externally and the Auto/Man buttons are hidden.

 - When the mode is Auto, the Start/Stop buttons are dimmed.

 - If mode extern only is configured, both the Auto/Man and the Start/Stop
   buttons are hidden, and the Extern indicator is always green. Auto/Man
   should be displayed in some other way.

 - The Start indicator displays status of the feedback, usually the contactor
   feedback.

Configuration

 The Mode object CompModeD handles an order output that can be configured in
 many different ways. It contains the functions

 - Error handling for maneuvering, 5 alarm.
 - Buttons are dimmed and made insensitive to avoid incorrect handling.

 The order output is controlled in three different ways

 - by the ExtStart input pin of the function object, when the object
   is in Auto mode.
 - from the Start/Stop buttons in the object graph, when the object
   is in Manual mode.
 - by the LocalStart input pin of the function object, when the object
   is in local mode.

 Note that only one of the configuration attributes, OpExtAndIntMan, OpIntOnly
 and OpExtOnly should be set.

 -StartStop     Text of Start/Stop buttons in object graph is Start/Stop.
 -OnOff         Text of Start/Stop buttons is On/Off.

 The figure displays a configuration (the default), where all the functions
 are activated. The operator selects auto or manual mode with the buttons
 Auto/Man. In auto the order output is controlled by the ExtStart input of
 the function object. The ExtControl input is not used in this configuration.

 The left figure shows when Auto/Man mode is controlled by the ExtControl input
 of the function object. Auto is activated by setting ExtControl to 1. The order
 output is now controlled by the ExtStart input, and the Start/Stop buttons are
 dimmed. To get this configuration, set OpExtAndIntMan to 1.
 This is the only configuration alternative where the ExtControl input is used.

 The right figure shows when Auto/Man mode and maneuvering Start/Stop in manual
 mode is controlled outside the object. By setting OpExtOnly to 1 also the
 Start/Stop buttons are removed in the graph and the control of the order output
 is handled by the ExtStart input only, i.e. the mode is not handled in the object
 and no buttons are visible.

 The figure shows when manual mode only is configured. The ExtStart and Local
 inputs of the function object is not used. The Auto/Man and Local indicator
 are invisible. To get this configuration, set OpIntOnly and OpNoLocal to 1.

 The figure shows when local mode is activated, i.e the LocalMod input is 1.
 The control of the order output is now handled by pushbuttons on a local panel
 via inputs in the function object. Local mode disables auto and manual control,
 i.e. local control has highest priority.

 The start button also works as a toggle button, i.e. you don't have to push
 the Stop button to stop.

 The Start indication is green when the Feedback input is 1. Normally the
 contactor feedback is connected to the Feedback input.

 If the Ready input is reset, the normal behavior is to force the object to
 manual mode. This force can be disabled by setting OpNoAutoToMan to 1.
 The ForceMan input of the function object can also force the object into
 manual mode. This function is not affected of the OpNoAutoToMan setting.

 If ready is 0 the order output is interlocked in all different modes.

 If the object is interlocked when the operator tries to change mode, an
 alarm is sent. Normally buttons are dimmed to avoid incorrect actions.

 When local mode is activated, a B-alarm is sent. This can be disabled by
 setting OpDisableLocalAlarm.

 For plc coding the function object CompModeDFo is used.

 Create a function object in the plc editor and connect it to the current
 object with the connect function.

• CompModeDFo

 Optional description.
 The description is for example viewed in the navigator and in
 the object graph.

 Enumeration for object graph configuration.
 Handled by the ConfigureComponent method.

 Switch to Auto mode.
 OpAuto is normally set from the Auto button in the object graph,
 and automatically reset by the program.

 Switch to Manual mode.
 OpMan is normally set from the Auto button in the object graph,
 and automatically reset by the program.

 Manual start order.
 OpManStart is normally set from the Start button in the object graph,
 and automatically reset by the program.

 Manual stop order.
 OpManStop is normally set from the Stop button in the object graph,
 and automatically reset by the program.

 Shows if Local mode is active.
 Local mode is normally set by a switch on a local panel, which is
 connected to the LocalMode input of the function object.

 Shows if local start is active.
 Local start is normally set by a button on a local panel, which is
 connected to the LocalStart input of the function object.

 Shows if object is ready to start.
 Reflects the value of the Ready input of the function object.
 If ready is not set, start is inhibited for all modes.

 Shows the feedback value, normally the contactor feedback.
 Reflects the value of the Feedback input of the function object.

 The order output. When order is high the unit is started.
 Reflects the value of the Order output of the function object.

 Auto mode is active.

 When ManOrdDim is set, the Start/Stop buttons in the object graph are dimmed.

 When AutoOrdDim is set, the Auto button in the object graph is dimmed.

 When ManModDim is set, the Man button in the object graph is dimmed.

 When LocalModeHide is set, the Local indicator in the object graph is hidden.

 When ManAutoHide is set, the Auto/Man buttons in the object graph is hidden.

 When ManOrdHide is set, the Start/Stop buttons in the object graph are hidden.

 When ExternOrdHide is set, the Extern indicator in the object graph is hidden.

 Configuration attribute to support only manual mode, i.e. the unit can only
 be controlled from the Start/Stop buttons in the object graph. the Auto/Man
 buttons are removed, and the extern control inputs of the function object are
 disabled.

 Configuration attribute to not handle Local mode.

 Configuration attribute to keep Auto mode if Ready is lost.
 Normally Manual mode is forced when Ready is reset. Note
 that the unit can be restarted when Ready is set again.

 Configuration attribute to disable manual control. All buttons
 in the object graph are removed.

 Configuration attribute to enable Auto/Man control via the ExtControl
 input of the function object. The Auto/Man buttons in the object graph
 are removed. When the ExtControl input is high, the mode is set to Auto
 and the Start/Stop buttons are dimmed. When ExtControl is low, mode is
 set to manual.

 Configuration attribute to disable the alarm when local mode is activated.

 Manual start order is active.

 Alarm text for manual start attempt when unit is not ready. B-alarm.

 Alarm text for attempt to set Auto mode when unit is not ready. B-alarm.

 Alarm text for manual start attempt when unit is in local mode. B-alarm.

 Alarm text when local mode is activated. B-alarm.

 Alarm text for manual start attempt when unit is in Auto mode. B-alarm.

 Text string to show the current mode in the object symbol.
 Contains "L" in local mode, "M" in manual mode and is empty in auto mode.

 The plc function object connected to this object.
 This attribute is set when the function object is connected from
 the plc editor by the connect function.