home *** CD-ROM | disk | FTP | other *** search
/ ftp.whtech.com / ftp.whtech.com.tar / ftp.whtech.com / Geneve / 9640news / CAT36 / EMULSRC.ZIP / GROM.C < prev    next >
Text File  |  1993-04-22  |  3KB  |  85 lines
  1. /* TI-99/4A Emulator.
  2.    GROM Emulator part.
  3.  
  4.    Functions:
  5.  
  6.    void grom_write(word address,word data);
  7.    * Writes data into grom memory if (address&2)==0. This is the case when
  8.      >9C00 is addressed. The data is assumed to be 16 bits, but only the
  9.      MSbyte is written. The GromAdressCounter is incremented by one.
  10.    * Updates the GromAdressCounter when (address&2)!=0. This is the case
  11.      when >9C02 is addressed. The GromAddressCounter is shifted left 8
  12.      bits, and the MSbyte of 'data' is the new LSbyte of the GAC.
  13.      So to change the GAC, write the new MSbyte first, followed by the
  14.      LSbyte.
  15.  
  16.    word grom_read(word address,word data);
  17.    * Reads data from grom memory if (address&2)==0. The byte pointed to by
  18.      the GAC is returned as MSbyte of a word. The GAC is incremented.
  19.    * Returnes the MSbyte of the GAC as the MSbyte of a word. The GAC is
  20.      shifted left 8 bits, so grom-read-data actions cannot take place until
  21.      a new grom address is written.
  22.  
  23.  
  24.    A GROM is essentially a mere ROM memory with a serial access mechanism.
  25.    To this end the grom is equipped with a address counter. This counter
  26.    must be set by the CPU. When the data is read-out through the read-data
  27.    address the address counter is incremented automatically. Though a
  28.    typical GROM produced by TI is only 6k (2k is wasted every 8k) and has
  29.    its own counter, in the emulator the GROM bank is 32k (or more) of
  30.    contiguous RAM. It is decided to make the GROM read-only, but it should
  31.    be very easy to emulate a GRAM device.
  32.  
  33.    The adresses through which GROM is addressed are:
  34.  
  35.    >9800:    GROM read data
  36.    >9802:    GROM read address
  37.    >9C00:    GROM write data
  38.    >9C02:    GROM write address
  39.  
  40.    These addresses are not fully decoded, so the same adressing is achieved
  41.    throughout the >9800..>9FFF area. (e.g. >9800=>9804=>9808=... etc.)
  42.  
  43. */
  44.  
  45. void init_grom(void)
  46. {
  47.     grom=(byte *)malloc(GROM_MEMSIZE);
  48.     if (grom==NULL)
  49.     {
  50.         printf("Not enough memory for GROM.\n");
  51.         exit(0);
  52.     }
  53.     GromAddressCounter=0;
  54. }
  55.  
  56. word grom_read(word address)
  57. {
  58.     if(address&1)  /* GROM read address. Address will be destroyed. */
  59.     {
  60.         word dummy;
  61.         GromAddressCounter++;
  62.         dummy=(GromAddressCounter&0xff00);
  63.         GromAddressCounter&=0xff;     /* filter lsbyte */
  64.         GromAddressCounter<<=8;     /* shift left    */
  65.         return(dummy);
  66.     }
  67.  
  68.     else        /* GROM read data */
  69.     return(*(grom+GromAddressCounter++)<<8);
  70. }
  71.  
  72. void grom_write(word gwaddress,word gdata)
  73. {
  74.     if (gwaddress&1)    /* write address */
  75.     GromAddressCounter=(GromAddressCounter<<8)|(gdata>>8);
  76.  
  77. /*          write data not (yet) supported
  78.     else
  79.     {
  80.         grom[GromAddressCounter]=(byte)(gdata>>8);
  81.         GromAddressCounter++;
  82.     }
  83. */
  84. }
  85.