org.vishia.fpga

Class Fpga

java.lang.Object

org.vishia.fpga.Fpga

public class Fpga
extends java.lang.Object

This class contains hardware related opeations for FPGA simulation which are also accepted by the Java2Vhdl translator.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Fpga.BITVECTOR Defines an numeric variable in VHDL as BIT_VECTOR( DOWNTO 0) This allows only specific routines in this class or assignments.
static interface	Fpga.ClockedInput Defines that an input pin of the Fpga or of an module should be clocked immediately.
static interface	Fpga.GetterVhdl Defines that an Operation is existing in the module class to access data from RECORD instance (associated to a PROCESS).
static interface	Fpga.IfcAccess Defines a sub module in another module which is only responsible to implement an interface as access point to the containing module.
static interface	Fpga.STDVECTOR Defines an numeric variable in VHDL as STD_LOGIC_VECTOR( DOWNTO 0) This is necessary if numeric operations are done.
static interface	Fpga.VHDL_PROCESS Defines an numeric variable in VHDL as STD_LOGIC_VECTOR( DOWNTO 0) This is necessary if numeric operations are done.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	sVersion Version, history and license.

Constructor Summary

Constructors

Constructor and Description
Fpga()

Method Summary

Modifier and Type	Method and Description
static void	checkDbg(boolean cond)
static void	checkTime(int time, int ztime, int min) Check the time.
static boolean	checkVector(java.lang.Class<?> inClass, java.lang.String var, int nrBits) Checks the size of a vector adequate to its annotation
static int	concatbits(int high, int bitPos, int low) Concatenate two bit vectors
static boolean	getBit(int vector, int bit) Gets one bit from a vector.
static int	getBits(int vector, int msb, int lsb) Returns in VHDL vector(6 DOWNTO 2) if msp=6 and lsb=2.
static int	getBitsShL(int vector, int nrBits, boolean low) Shifts a vector 1 to left and replaces the bit 0 with low value.
static int	getBitsShR(boolean high, int bitHigh, int vector) Shifts a vector 1 to right and replaces the ms bit with high value.
static void	measTime(int[] tgroup, int ixGroup, int tdiff)
static int	setBit(int vector, int bit, boolean value) Gets one bit from a vector.
static int	setBits(int vector, int dstMSB, int dstLSB, int value) Replaces the dedicated bits with value.

Methods inherited from class java.lang.Object

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

Field Detail

sVersion

public static final java.lang.String sVersion

Version, history and license.

• 2022-05-02 setBits(int, int, int, int) without 5th argument.
• 2022-02-14 Hartmut created.

Copyright/Copyleft: For this source the LGPL Lesser General Public License, published by the Free Software Foundation is valid. It means:

1. You can use this source without any restriction for any desired purpose.
2. You can redistribute copies of this source to everybody.
3. Every user of this source, also the user of redistribute copies with or without payment, must accept this license for further using.
4. But the LPGL is not appropriate for a whole software product, if this source is only a part of them. It means, the user must publish this part of source, but don't need to publish the whole source of the own product.
5. You can study and modify (improve) this source for own using or for redistribution, but you have to license the modified sources likewise under this LGPL Lesser General Public License. You mustn't delete this Copyright/Copyleft inscription in this source file.

If you are intent to use this sources without publishing its usage, you can get a second license subscribing a special contract with the author.

See Also:

Constant Field Values

Constructor Detail

Fpga

public Fpga()

Method Detail

setBit

public static int setBit(int vector,
                         int bit,
                         boolean value)

Gets one bit from a vector. Vhdl: vector(7)

Parameters:

vector - variable which presents a Vhdl vector

bit - bit number set in vector output in the return value, should be a simple const number.

value - the value to set to this bits. An ordinary expression of bool type. On VHDL an automatic conversion to STD_VECTOR will be done if necessary.

setBits

public static int setBits(int vector,
                          int dstMSB,
                          int dstLSB,
                          int value)

Replaces the dedicated bits with value. VHDL: vector(16 DOWNTO 1) <= value(15 DOWNTO 0)

Parameters:

vector - the given vector, for the unchanged bits in return, current value.

dstMSB - most significant bit set in vector output in the return value, should be a simple const number.

dstLSB - last significant bit set in vector output in the return value, should be a simple const number.

value - the value to set to this bits, the same number of bits are used. An ordinary expression.

Returns:

changed vector

getBit

public static boolean getBit(int vector,
                             int bit)

Gets one bit from a vector. Vhdl: vector(7)

Parameters:

vector - variable which presents a Vhdl vector

bit - the bit, from 0

Returns:

boolean meaning of bit.

getBitsShL

public static int getBitsShL(int vector,
                             int nrBits,
                             boolean low)

Shifts a vector 1 to left and replaces the bit 0 with low value. In Vhdl it is vector(14 DOWNTO 0) & low

Parameters:

vector - the previous state (z)

nrBits - valid number of bits to shift

low - It should present a boolean for a Vhdl: BIT

Returns:

new value.

getBitsShR

public static int getBitsShR(boolean high,
                             int bitHigh,
                             int vector)

Shifts a vector 1 to right and replaces the ms bit with high value. In Vhdl it is high & vector(15 DOWNTO 1)

Parameters:

high - most significant bit to replace. It should present a boolean for a Vhdl: BIT

bitHigh - bit position for high or number of bits to shift for vector. vector is used with (bithigh downto 1)

vector -

Returns:

new value.

getBits

public static int getBits(int vector,
                          int msb,
                          int lsb)

Returns in VHDL vector(6 DOWNTO 2) if msp=6 and lsb=2. In Java returns the bits msb...lsb right aligned.

Parameters:

vector -

msb - the msb bit itself inclusively

lsb - the lsb inclusively.

Returns:

concatbits

public static int concatbits(int high,
                             int bitPos,
                             int low)

Concatenate two bit vectors

Parameters:

high -

bitPos - Position where high should be placed in result. This should be exact the length of low, checked in assertion.

low -

Returns:

measTime

public static void measTime(int[] tgroup,
                            int ixGroup,
                            int tdiff)

checkVector

public static boolean checkVector(java.lang.Class<?> inClass,
                                  java.lang.String var,
                                  int nrBits)

Checks the size of a vector adequate to its annotation

Parameters:

inClass -

var - The field in this class.

nrBits -

Returns:

checkTime

public static void checkTime(int time,
                             int ztime,
                             int min)

Check the time. This operation is used to generate timing constrains, and also used in simulation for check the time.

Parameters:

time - current time of access

ztime - time of the accessed variable

min - minimal difference.

checkDbg

public static void checkDbg(boolean cond)