HASE User Guide

PARAMLIB - The Parameter Library

The parameter library is used to create the type definitions of parameters used by the project. HASE supplies the built-in types: bit, bool, char, integer, unsigned integer, long, floating-point, string and range, from which more complex types can be created, for example structures, enumerations and ranges. Once types have been defined in the parameter library, instances of these types can then be created in the GLOBALS section of the project definition file and within entity declarations (in the ENTITYLIB section).

ENUM ( typename, [ enumerate : icon, ... ] )

STRUCT ( typename, [ reference_parameter , ... ] )

INSTR ( typename, [ (tag, reference_parameter ) , ... ] , class_enum )

LINK ( typename, [ ( tag, reference_parameter : icon), ... ] )

ARRAY ( typename, type_of_elements )

ARRAYI ( typename, type_of_elements )

Instr - Instruction Parameter

The Instr parameter is best explained by means of an example. The following example shows the full instruction set of a simple computer, preceded by the necessary operand STRUCT definitions. Each instruction consists of a function and zero, one or more operands.

>>> include insttruction table here.

-- operands for loading a register from memory using address + (index reg) STRUCT (t_load, [RSTRING (dest_reg, "-", 5), RSTRING (src_reg, "-", 5), RINT (address, 0)]); -- operands for storing a register to memory using address + (index reg) STRUCT (t_store, [RSTRING (src_reg, "-", 5), RSTRING (dest_reg, "-", 5), RINT (address, 0)]); -- operand for loading register with immediate STRUCT (t_loadi, [RSTRING (dest_reg, "-", 5), RINT (immediate, 0)]); -- operands for move instruction STRUCT (t_move, [RSTRING (dest_reg, "-", 5), RSTRING (src_reg, "-", 5)]); -- operands for ALU scalar instruction group STRUCT (t_alu, [RSTRING (dest_reg, "-", 5), RSTRING (src_reg1, "-", 5), RSTRING (src_reg2, "-", 5)]); -- operands for ALUI scalar instruction group STRUCT (t_alui, [RSTRING (dest_reg, "-", 5), RSTRING (src_reg1, "-", 5), RINT (immediate, 0)]); -- operands for COMP instruction STRUCT (t_comp, [RSTRING (src_reg1, "-", 5), RSTRING (src_reg2, "-", 5)]); -- Definition of a simple instruction set INSTR (t_simple_instrn_set, [(NOP), (JUMP, RINT (immediate, 0)), (JREG, RSTRING (src_reg, "-")), (SETCC(SEQ,SNE,SGT,SLT,SGE,SLE), RSTRUCT (t_comp, comp_field)), (BRANCH, RSTRING (label, "-", 50)), (LDM, RSTRUCT (t_load, load_field)), (LDI, RSTRUCT (t_loadi, loadi_field)), (STM, RSTRUCT (t_store, store_field)), (ALU(ADD,SUB,MUL,DIV,AND,OR,XOR,SLL,SRL,SRA), RSTRUCT (t_alu, alu_field)), (ALUI(ADDI,SUBI,MULI,DIVI,ANDI,ORI,XORI,SLLI,SRLI,SRAI), RSTRUCT (t_alui, alui_field)), (STOP) ], function); Notes

In STRUCT (t_loadi, [RSTRING (dest_reg, "-", 5), RINT (immediate, 0)]);,
"-" is the initial value of dest_reg while the value 5 limits the length of the string to 5 characters; the default string length in HASE is 100 characters, so this parameter reduces the storage requirements of a project (NB: the length must allow for the end-of-string character).
In (JUMP, RINT (immediate, 0)), the operand is just an integer, so doesn't need a STRUCT definition.
NOP and STOP have no operand.
t_simple_instrn_set is the (str) typename of the instruction set, used when creating instances; a project can include more than instruction set definition
In (ALU(ADD,SUB,MUL,DIV,AND,OR,XOR,SLL,SRL,SRA), "ALU" is the (str) tag of a class of instructions, while ADD etc. are members of a corresponding class_enum, in this case called function ;
the construct "if (IR.decode_ALU())" can be used in e.g. the processor Hase++ file when a common set of actions is to be performed for all ALU functions, where IR is an instruction register of type t_simple_instrn_set.
Individual instructions within the ALU set can be decoded using a switch construct:
switch (IR.function)
{
case ADD: // ADD Rx Ry Rz: Rx = Ry + Rz
dest_op = src1_op + src2_op;
break;
etc.
}
OR by using the construct:
if (IR.function == t_simple_instrn_set::JUMP)
{

}