org.vishia.fbcl.fblock

Class Evinout_FBcl

java.lang.Object

org.vishia.fbcl.fblock.Pin_FBcl

org.vishia.fbcl.fblock.Evinout_FBcl

All Implemented Interfaces:

org.vishia.util.ToStringBuilder

Direct Known Subclasses:

Evin_FBcl, Evout_FBcl

public class Evinout_FBcl
extends Pin_FBcl
implements org.vishia.util.ToStringBuilder

Nested Class Summary

Nested classes/interfaces inherited from class org.vishia.fbcl.fblock.Pin_FBcl

Pin_FBcl.XXXXXEKind

Field Summary

Fields

Modifier and Type	Field and Description
protected long[][]	condBits One bit determines by its position one condition of the module for this event.
int	idEvent A created id for the existing event Object.
(package private) static int	idEventCt
long	mEvinClusterEnd Bit mask which Evin_FBcl of the module's output or adequate a state machine FBlock's evin is driven immediately or indirect.
long	mEvoutClusterStart Bit mask which whether this pin is connected indirect or direct with which evinMdl (it is an Evout_FBcl) or one of the Evout_FBcl of a FBlock_FBcl with a state machine, which is the start of one or some evChain.
int	nrEventInChain Counts the number of this evout in the chain.

Fields inherited from class org.vishia.fbcl.fblock.Pin_FBcl

connectDst, connectSrc, fb, name, pint, version, xy

Constructor Summary

Constructors

Constructor and Description
Evinout_FBcl(PinType_FBcl pint, FBlock_FBcl fb, XY_FBcl xy)
Evinout_FBcl(PinType_FBcl pint, java.lang.String name, FBlock_FBcl fb, XY_FBcl xy)

Method Summary

Modifier and Type	Method and Description
long[][]	getConditionBits() Gets the condition bits condBits from an module internal event instance.
long[][]	set_orNewConditionBits(long[][] addBits, long[] allBitsArg)
java.lang.StringBuilder	toString(java.lang.StringBuilder app, java.lang.String... cond)

Methods inherited from class org.vishia.fbcl.fblock.Pin_FBcl

addEvchain, addEvchainDepending, connDst, connectFrom, connectFrom, connSrc, containsEvchain, containsOtherEvchain, dinType, doutType, evChainHex, evinType, evoutType, fbtypeName, getFirstConnDst, getFirstConnSrc, getMaskEvinMdlChainDriven, getMaskEvoutMdlBackChainDriven, getOneConnSrc, getOneConnSrc, isEventBackChainDriven, isEventBackChainDriven, isEventChainDriven, isEventChainDriven, isEventChainDriven, isEventChainDriven, isKind, isNotKind, isUpdatePin, iterConnDst, iterConnSrc, iterEvchainDep, iterEvchainShow, nameFBpin, nameFBpin, nrofConnDst, nrofConnSrc, pinType, removeConnectDst, removeConnectSrc, removeConnSrcAll, removePinSimpleInConnDst, setEventBackChainDriven, setEventChainDriven, spec, spec, throwError, toString, XXXremoveConnectSrc, XXXremoveConnSrc

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

idEventCt

static int idEventCt

idEvent

public final int idEvent

A created id for the existing event Object.

nrEventInChain

public transient int nrEventInChain

Counts the number of this evout in the chain. Used to detect which event is the latest.

mEvinClusterEnd

public transient long mEvinClusterEnd

Bit mask which Evin_FBcl of the module's output or adequate a state machine FBlock's evin is driven immediately or indirect. The bit position is adequate the PinType_FBcl.ixPin. Info to build event operations of the module.

mEvoutClusterStart

public transient long mEvoutClusterStart

Bit mask which whether this pin is connected indirect or direct with which evinMdl (it is an Evout_FBcl) or one of the Evout_FBcl of a FBlock_FBcl with a state machine, which is the start of one or some evChain. The last kind of Evout_FBcl is also a part of indexed EvoutType_FBcl of the module inner interface. It means the indices are not overlapping with the module pins indices. But the sum of all this event should not exceed 64 (or 62). If the modules will get more comprehensive, here either a container of indices should be used, but then the algorithm for each event gets more comprehensive too. or an array of some long, with retention of this bit mask approach. Hint: the last one is already implemented for condBits with Bitfield The Evout_FBcl for state machines are yet not implemented, 2024-03

condBits

protected long[][] condBits

One bit determines by its position one condition of the module for this event. For a module's evin (type Evout_FBcl) this element notices, which condition bits are used for the event chain operation. It is not a condition.

For all other evout:

If null or set with #unconditional, then this event is unconditionally.

The first dimension defines more than 64 bit if the module has more as 64 conditions (a large module). Usual this dimension has 1 element. If higher conditions are not used then the size of the dimension is lesser.

Only valid for 'ExprEv': General two bits builds a pair for true and false of a condition. Both bits, the even and odd from the pair should never be set. Because it is excluding. If more as one bit is set, then this conditions should be AND-related.
For example 0x1 means, the first condition should be true.
0x2 means, the first condition should be false.
0x0 means, it does not depend from conditions (same as null as vector).
0x9 means, (!cond2 && cond1)

The second dimension is for OR conditions. That occurs if more as one evout drives one evin. Then the evout of the driven evin gets the OR of conditions.
For example [ [0x9], [0x6] ] means (!cond2 && cond1 || cond2 && !cond1)
respectively [ [0x4], [0x1] ] means (cond2 || cond1)



For an evout of an 'ExprEv' or for the Evout_FBcl of a state FBlock this element contains the primary condition of this FBlock, whereby also AND bits can be set if the 'ExprEv' or State is determined also conditionally (it is a secondary condition). The second dimension is not used, (condBits.length ==1)

Constructor Detail

Evinout_FBcl

public Evinout_FBcl(PinType_FBcl pint,
                    FBlock_FBcl fb,
                    XY_FBcl xy)

Evinout_FBcl

public Evinout_FBcl(PinType_FBcl pint,
                    java.lang.String name,
                    FBlock_FBcl fb,
                    XY_FBcl xy)

Method Detail

set_orNewConditionBits

public long[][] set_orNewConditionBits(long[][] addBits,
                                       long[] allBitsArg)

getConditionBits

public long[][] getConditionBits()

Gets the condition bits condBits from an module internal event instance. This operation returns null for the module's evinMdl (Evout_FBcl) because the modules evinMdl have not really a condition, instead it stores in condBits the used condition in this event to detect all bits as 'unconditionally'. To prevent confusion on evinMdl this mits are not returned.

Returns:

toString

public java.lang.StringBuilder toString(java.lang.StringBuilder app,
                                        java.lang.String... cond)

Specified by:

toString in interface org.vishia.util.ToStringBuilder

Overrides:

toString in class Pin_FBcl