Package eu.bandm.sig.adlib2

Class ByteDelay

java.lang.Object

eu.bandm.sig.adlib2.AbstractProcess

eu.bandm.sig.adlib2.ByteStoredSignalSource

eu.bandm.sig.adlib2.compile.CompilableByteStoredSignalSource

eu.bandm.sig.adlib2.ByteDelay

All Implemented Interfaces:

AbstractClockedSignalSource, AbstractSignalSource, ByteClockedSignalSource, ByteSignalSource, CompilableControlFlow, CompilableDataFlow, Component, Process, Register, ByteSupplier

public class ByteDelay
extends CompilableByteStoredSignalSource
implements Register

A component that forwards the value from an input signal source delayed by a single clock tick.

Nested Class Summary

Nested classes/interfaces inherited from interface eu.bandm.sig.adlib2.ByteClockedSignalSource

ByteClockedSignalSource.AbstractRandom

Nested classes/interfaces inherited from interface eu.bandm.sig.adlib2.Process

Process.Proxy

Field Summary

Fields inherited from class eu.bandm.sig.adlib2.ByteStoredSignalSource

out

Fields inherited from interface eu.bandm.sig.adlib2.AbstractClockedSignalSource

STREAM_CHARACTERISTICS, STREAM_SIZE

Constructor Summary

Constructors

Constructor	Description
ByteDelay(byte initial)	Creates a new instance without a valid input source.
ByteDelay(byte initial, ByteSignalSource in)	Creates a new instance with an independent input source.
ByteDelay(byte initial, Function<? super ByteDelay,? extends ByteSignalSource> in)	Creates a new instance with a feedback-looped input source.

Method Summary

Modifier and Type	Method	Description
Consumer<CompilationContext>	compileControlFlow()	Compiles the state transition of this process.
Consumer<CompilationContext>	compileGetNextValue()	Returns a code generator for loading the next value of the compiled version of this component on the operand stack.
Consumer<CompilationContext>	compileInitialization()	Compiles the initialization of this process.
Consumer<CompilationContext>	compileSetNextValue(Consumer<CompilationContext> value)	Returns a code generator for storing the next value of the compiled version of this component from the operand stack.
Process	getLoadPhase()
byte	getNextValue()	Returns the value that will be produced on the next clock tick.
protected eu.bandm.tools.lljava.live.VariableContext.Variable	getNextVariable(CompilationContext context)
Process	getStorePhase()
void	init()	Initializes the state of this process.
void	setInput(ByteSignalSource in)
void	setNextValue(byte next)	Sets the value that will be produced on the next clock tick.
void	step()	Signals a time event, executing a transition step for this process to the next observable state.

Methods inherited from class eu.bandm.sig.adlib2.compile.CompilableByteStoredSignalSource

compileDataFlow, compileSetStoredValueVariable, getStoredValueVariable, publishStoredValueVariable

Methods inherited from class eu.bandm.sig.adlib2.ByteStoredSignalSource

getAsByte

Methods inherited from class eu.bandm.sig.adlib2.AbstractProcess

getRealtimeContext, setRealtimeContext

Methods inherited from class java.lang.Object

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

Methods inherited from interface eu.bandm.sig.adlib2.ByteClockedSignalSource

after, compile, drain, drain, during

Methods inherited from interface eu.bandm.sig.adlib2.ByteSignalSource

abs, add, asDouble, asFloat, asInt, compileMainSignalSource, DEBUG, delayed, delayed, divide, equal, getConstantAsByte, getValueClass, greaterOrEqual, greaterThan, guard, hasConstantAsByte, invariant, lessOrEqual, lessThan, map, max, min, modulo, multiply, negate, negative, nonEqual, nonnegative, nonpositive, nonzero, positive, power, probe, relateWith, sampleAndHold, stored, subtract, zero, zipWith

Methods inherited from interface eu.bandm.sig.adlib2.compile.CompilableDataFlow

compileDataFlowTo, hasDataFlowIO

Methods inherited from interface eu.bandm.sig.adlib2.Process

afterEvery, andThen, compileAsMainProcess, every, every, getProcess, hasControlFlowIO, hasInitializationIO, setRealtimeContext

Methods inherited from interface eu.bandm.sig.adlib2.Register

andMeanwhile, andMeanwhile

Constructor Details

ByteDelay

public ByteDelay(byte initial)

Creates a new instance without a valid input source. The method setInput(eu.bandm.sig.adlib2.ByteSignalSource) must be invoked before this signal source can be used.

Parameters:

initial - the initial value of this signal source

ByteDelay

public ByteDelay(byte initial,
 ByteSignalSource in)

Creates a new instance with an independent input source.

Parameters:

initial - the initial value of this signal source

in - the input signal source

ByteDelay

public ByteDelay(byte initial,
 Function<? super ByteDelay,? extends ByteSignalSource> in)

Creates a new instance with a feedback-looped input source.

Parameters:

initial - the initial value of this signal source

in - a function that constructs the input signal source when applied to this delayed signal source

Method Details

setInput

public void setInput(ByteSignalSource in)

getLoadPhase

public Process getLoadPhase()

Specified by:

getLoadPhase in interface Register

getStorePhase

public Process getStorePhase()

Specified by:

getStorePhase in interface Register

init

public void init()

Description copied from interface: Process

Initializes the state of this process. The state is initialized such that the first subsequent call to Process.step() transitions to the first specified observable state.

The default implementation does nothing.

Specified by:

init in interface Process

step

public void step()

Description copied from interface: Process

Signals a time event, executing a transition step for this process to the next observable state.

The state of the process after successful completion of this method should be the n-th observable state, if Process.step() has been invoked n times since the last initialization via Process.init(). The behavior of this method is unspecified if Process.init() has not been invoked before.

FIXME: Process.setRealtimeContext(eu.bandm.sig.adlib2.RealtimeContext)

If this method completes abruptly by throwing an error or unchecked exception, the process state should be considered invalid.

Specified by:

step in interface Process

getNextVariable

protected eu.bandm.tools.lljava.live.VariableContext.Variable getNextVariable(CompilationContext context)

compileInitialization

public Consumer<CompilationContext> compileInitialization()

Description copied from interface: Process

Compiles the initialization of this process.

This method emits code equivalent to the Process.init() method of this component. The compilation context should be set up to specify no input or output variables.

The default implementation emits code that simply invokes Process.init() for this process.

This method should be overridden together with Process.compileControlFlow(), in order to ensure that both operate on the same state variables.

Specified by:

compileInitialization in interface CompilableControlFlow

Specified by:

compileInitialization in interface Process

Overrides:

compileInitialization in class CompilableByteStoredSignalSource

See Also:

• Process.hasInitializationIO(eu.bandm.sig.adlib2.compile.CompilationContext)

compileControlFlow

public Consumer<CompilationContext> compileControlFlow()

Description copied from interface: Process

Compiles the state transition of this process.

This method emits code equivalent to the Process.step() method of this process. The compilation context should be set up to specify no input or output variables.

The default implementation emits code that simply invokes Process.step() for this process.

This method should be overridden together with Process.compileInitialization(), in order to ensure that both operate on the same state variables.

Specified by:

compileControlFlow in interface CompilableControlFlow

Specified by:

compileControlFlow in interface Process

Specified by:

compileControlFlow in class CompilableByteStoredSignalSource

See Also:

• Process.hasControlFlowIO(eu.bandm.sig.adlib2.compile.CompilationContext)

getNextValue

public byte getNextValue()

Returns the value that will be produced on the next clock tick.

This method is in concurrent reader–writer conflict with the getStorePhase() process.

compileGetNextValue

public Consumer<CompilationContext> compileGetNextValue()

Returns a code generator for loading the next value of the compiled version of this component on the operand stack.

See Also:

• getNextValue()

setNextValue

public void setNextValue(byte next)

Sets the value that will be produced on the next clock tick.

This method is in concurrent writer–writer conflict with the getStorePhase() process.

compileSetNextValue

public Consumer<CompilationContext> compileSetNextValue(Consumer<CompilationContext> value)

Returns a code generator for storing the next value of the compiled version of this component from the operand stack.

See Also:

• setNextValue(byte)