/*.......1.........2.........3.........4.........5.........6.........7.........8 ================================================================================ FILE d_ram/cfunc.mod Copyright 1991 Georgia Tech Research Corporation, Atlanta, Ga. 30332 All Rights Reserved PROJECT A-8503-405 AUTHORS 23 Aug 1991 Jeffrey P. Murray MODIFICATIONS 30 Sep 1991 Jeffrey P. Murray SUMMARY This file contains the model-specific routines used to functionally describe the d_ram code model. INTERFACES FILE ROUTINE CALLED CMevt.c void *cm_event_alloc() void *cm_event_get_ptr() REFERENCED FILES Inputs from and outputs to ARGS structure. NON-STANDARD FEATURES NONE ===============================================================================*/ /*=== INCLUDE FILES ====================*/ #include #include #include #include /*=== CONSTANTS ========================*/ /*=== MACROS ===========================*/ /*=== LOCAL VARIABLES & TYPEDEFS =======*/ /*=== FUNCTION PROTOTYPE DEFINITIONS ===*/ /*============================================================================== FUNCTION cm_address_to_decimal() AUTHORS 27 Jun 1991 Jeffrey P. Murray MODIFICATIONS 8 Jul 1991 Jeffrey P. Murray 30 Sep 1991 Jeffrey P. Murray SUMMARY Calculates a decimal value from binary values passed. INTERFACES FILE ROUTINE CALLED N/A N/A RETURNED VALUE A pointer containing the total (*total). GLOBAL VARIABLES NONE NON-STANDARD FEATURES NONE ==============================================================================*/ /*=== CM_ADDRESS_TO_DECIMAL ROUTINE ===*/ /************************************************ * The following routine calculates a * * decimal value equivalent to the binary * * value passed to it on address[i] bits. * * The determined value is written to the * * integer *total. * * * * Created 6/27/91 J.P.Murray * ************************************************/ static int cm_address_to_decimal(Digital_State_t *address,int address_size,int *total) { int i, /* indexing variable */ multiplier, /* binary multiplier value */ err; /* error value: 1 => output is unknown 0 => output is valid */ err = 0; *total = 0; multiplier = 1; for (i=0; i> (ram_offset * 2)); switch (value) { case 0: return ZERO; case 1: return ONE; default: return UNKNOWN; } } /*============================================================================== FUNCTION cm_initialize_ram() AUTHORS 9 Jul 1991 Jeffrey P. Murray MODIFICATIONS 30 Sep 1991 Jeffrey P. Murray SUMMARY This function stores digital data into specific short integer array locations. INTERFACES FILE ROUTINE CALLED N/A N/A RETURNED VALUE Returns updated ram[] value. GLOBAL VARIABLES NONE NON-STANDARD FEATURES NONE ==============================================================================*/ /*=== CM_INITIALIZE_RAM ROUTINE ===*/ /************************************************ * The following routine stores two-bit * * data into short integer array "ram". The * * integers are assumed to be at least two * * bytes each, so each will hold eight two- * * bit values. * * * * Created 7/9/91 J.P.Murray * ************************************************/ static void cm_initialize_ram(Digital_State_t out,int word_width,int bit_number, int word_number,short *ram) { int /*err,*/ /* error index value */ int1, /* temp storage variable */ /*int2,*/ /* temp storage variable */ ram_index, /* ram base address at which word bits will be found */ ram_offset; /* offset from ram base address at which bit[0] of the required word can be found */ short base; /* variable to hold current base integer for comparison purposes. */ /* obtain offset value from word_number, word_width & bit_number */ int1 = word_number * word_width + bit_number; ram_index = int1 >> 3; ram_offset = int1 & 7; /* retrieve entire base_address ram integer... */ base = ram[ram_index]; /* for each offset, mask off the bits and store values */ cm_mask_and_store(&base,ram_offset,out); /* store modified base value */ ram[ram_index] = base; } /*============================================================================== FUNCTION cm_store_ram_value() AUTHORS 27 Jun 1991 Jeffrey P. Murray MODIFICATIONS 9 Jul 1991 Jeffrey P. Murray 30 Sep 1991 Jeffrey P. Murray SUMMARY This function stores digital data into specific short integer array locations, after decoding address bits passed to it (using cm_address_to_decimal routine). INTERFACES FILE ROUTINE CALLED N/A N/A RETURNED VALUE Returns updated ram[] value via *ram pointer. GLOBAL VARIABLES NONE NON-STANDARD FEATURES NONE ==============================================================================*/ /*=== CM_STORE_RAM_VALUE ROUTINE ===*/ /************************************************ * The following routine stores two-bit * * data into short integer array "ram". The * * integers are assumed to be at least two * * bytes each, so each will hold eight two- * * bit values. A sister routine, cm_get_ * * ram_value is used to retrieve the two- * * bit values from the "ram" array. * * * * Created 6/27/91 J.P.Murray * ************************************************/ static void cm_store_ram_value(Digital_State_t out,int word_width,int bit_number, Digital_State_t *address,int address_size, short *ram) { int err, /* error index value */ int1, /* temp storage variable */ word_number, /* particular word of interest...this value is derived from the passed address bits */ ram_index, /* ram base address at which word bits will be found */ ram_offset; /* offset from ram base address at which bit[0] of the required word can be found */ short base; /* variable to hold current base integer for comparison purposes. */ /** first obtain word_number from *address values **/ err = cm_address_to_decimal(address,address_size,&word_number); if ( FALSE == err ) { /** valid data was returned...store value **/ /* obtain offset value from word_number, word_width & bit_number */ int1 = word_number * word_width + bit_number; ram_index = int1 >> 3; ram_offset = int1 & 7; /* retrieve entire base_address ram integer... */ base = ram[ram_index]; /* for each offset, mask off the bits and store values */ cm_mask_and_store(&base,ram_offset,out); /* store modified base value */ ram[ram_index] = base; } } /*============================================================================== FUNCTION cm_get_ram_value() AUTHORS 27 Jun 1991 Jeffrey P. Murray MODIFICATIONS 30 Sep 1991 Jeffrey P. Murray SUMMARY This function retrieves digital data from specific short integer array locations, after decoding address bits passed to it (using cm_address_to_decimal routine). This is a sister routine to cm_store_ram_value. INTERFACES FILE ROUTINE CALLED N/A N/A RETURNED VALUE Returns output value via *out pointer. GLOBAL VARIABLES NONE NON-STANDARD FEATURES NONE ==============================================================================*/ /*=== CM_GET_RAM_VALUE ROUTINE ===*/ /************************************************ * The following routine retrieves two-bit * * data from short integer array "ram". The * * integers are assumed to be at least two * * bytes each, so each will hold eight two- * * bit values. A sister routine, cm_store_ * * ram_value is used to store the two-bit * * values into the "ram" array. * * * * Created 6/27/91 J.P.Murray * ************************************************/ static Digital_State_t cm_get_ram_value(int word_width,int bit_number,Digital_State_t *address, int address_size,short *ram) { int err, /* error index value */ int1, /* temp storage variable */ word_number, /* particular word of interest...this value is derived from the passed address bits */ ram_index, /* ram base address at which word bits will be found */ ram_offset; /* offset from ram base address at which bit[0] of the required word can be found */ short base; /* variable to hold current base integer for comparison purposes. */ /** first obtain word_number from *address values **/ err = cm_address_to_decimal(address,address_size,&word_number); if ( FALSE == err ) { /** valid data was returned **/ /* obtain offset value from word_number, word_width & bit_number */ int1 = word_number * word_width + bit_number; ram_index = int1 >> 3; ram_offset = int1 & 7; /* retrieve entire base_address ram integer... */ base = ram[ram_index]; /* for each offset, mask off the bits and determine values */ return cm_mask_and_retrieve(base,ram_offset); } else { /** incorrect data returned...return UNKNOWN values **/ return UNKNOWN; } } /*============================================================================== FUNCTION cm_d_ram() AUTHORS 26 Jun 1991 Jeffrey P. Murray MODIFICATIONS 30 Sep 1991 Jeffrey P. Murray SUMMARY This function implements the d_ram code model. INTERFACES FILE ROUTINE CALLED CMevt.c void *cm_event_alloc() void *cm_event_get_ptr() RETURNED VALUE Returns inputs and outputs via ARGS structure. GLOBAL VARIABLES NONE NON-STANDARD FEATURES NONE ==============================================================================*/ /*=== CM_D_RAM ROUTINE ===*/ /************************************************ * The following is the model for the * * digital M x N random access memory for the * * ATESSE Version 2.0 system. * * * * Created 6/26/91 J.P.Murray * ************************************************/ void cm_d_ram(ARGS) { int i, /* generic loop counter index */ j, /* generic loop counter index */ ram_size, /* total number of words in ram */ num_of_ram_ints, /* actual number of "short" integer values necessary to store all of the ram_size integers */ address_size, /* total number of address lines */ select_size, /* total number of address lines */ select_value, /* decimal value compared with select inputs to confirm that the ram has indeed been activated */ word_width, /* width of each word in bits */ int_test, /* integer test variable */ address_changed, /* TRUE if address is different from that on the previous call...FALSE otherwise */ address_unknown; /* TRUE if currently-read address has at least one line which is an unknown value. */ short int *ram, /* storage words...note that the total ram data will be stored in the two-bytes-per-Digital_State_t...since we require 2 bits per ram bit (for ZERO, ONE & UNKNOWN), we will store 8 ram bits per Digital_State_t location */ *ram_old; /* previous values of storage words */ Digital_State_t *address, /* address line values */ *address_old, /* previous address line values */ *write_en, /* write_en value */ *write_en_old, /* previous write_en value */ *select, /* current selected state of ram... note that this is derived from all of the select lines into the ram */ *select_old, /* previous selected state of ram */ d_test, /* digital debugging variable */ out; /* current output bit */ /** retrieve device size values...& other parameters **/ address_size = PORT_SIZE(address); /* calculate ram word size from address size */ ram_size = 1; for (i=0; i>1; } /******* Determine analysis type and output appropriate values *******/ if (0.0 == TIME) { /****** DC analysis...output w/o delays ******/ /** initialize ram to ic value **/ out = (Digital_State_t) PARAM(ic); for (i=0; i