Availability:
     Level C    , 'D'

  Quick Help:
     Display Bonanza Memory, D[MemorySelect],[StartAddress],[NumberOfSymbols],[BufferSelect]

  Description:
    This diagnostic will display the contents of the specified Bonanza internal memory.

  Input Parameters:

    
    0 - Memory Select.
    
        This parameter specifies which of Bonanza's internal memories to display.
        0x00: SAMPLE_BUFFER - Specifies the Sample Buffer
        0x01: SOFT_BUFFER_RD - Specifies the Soft Buffer Read Data
        0x02: SOFT_BUFFER_WT - Specifies the Soft Buffer Write Data
        0x03: SMALL_BUFFER - Specifies the Small Buffer
        0x04: ERASURE_INPUT_BUFFER - Specifies the Erasure Input Buffer
        0x05: ERASURE_OUTPUT_BUFFER - Specifies the Erasure Output Buffer
        0x06: EXTRINSIC_BUFFER - Specifies the Extrinsic Buffer
        0x07: DECODER_MICROCODE_MEMORY - Specifies the Decoder Microcode Memory
        0x08: ENCODER_MICROCODE_MEMORY - Specifies the Encoder Microcode Memory
         memories supported.
    
          Type:    Unsigned 8-bit value
    
          Range:   0 to 0xFF
    
          Default: None
    
    1 - Start Address.
    
        For SAMPLE_BUFFER, SOFT_BUFFER_RD, SOFT_BUFFER_WT, ERASURE_INPUT_BUFFER,
        and EXTRINSIC_BUFFER, this parameter represents the starting
        symbol number.
        
        For ERASURE_INPUT_BUFFER and ERASURE_OUTPUT_BUFFER,
        this parameter is the 16-bit word number.
        
        For DECODER_MICROCODE_MEMORY and ENCODER_MICROCODE_MEMORY,
        this parameter is the starting instruction number.
    
        For SMALL_BUFFER_MEMORY, this parameter has no effect due to chip
        behavior.
    
          Type:    Unsigned 16-bit value
    
          Range:   0 to 0xFFFF
    
          Default: 0
    
    2 - Number of Values to Display.
    
        For SAMPLE_BUFFER, SOFT_BUFFER_RD, SOFT_BUFFER_WT, ERASURE_INPUT_BUFFER,
        SMALL_BUFFER and EXTRINSIC_BUFFER, this parameter is the number of symbols
        of data to display. As there are 12 items/symbol, the total number of
        items that will be displayed will be 12 times the values specified by
        this parameter.
    
        For ERASURE_INPUT_BUFFER and ERASURE_OUTPUT_BUFFER, this value is the
        number of 16-bit values to display.
    
        For DECODER_MICROCODE_MEMORY and ENCODER_MICROCODE_MEMORY, this is the
        number of instructions to display.
    
        In all cases, 0 indicates that maximum supported number of samples
        will be displayed for the selected memory.
    
          Type:    Unsigned 16-bit value
    
          Range:   0 to 0xFFFF
    
          Default: 0
    
    3 - Buffer Select.
    
        This parameter specifies which of the available buffers to display.
        Note: this parameter is not used by:
          Extrinsic Buffer
          Decoder Microcode Memory
          Encoder Microcode Memory
    
        0x00: Specifies Buffer 0
        0x01: Specifies Buffer 1
        0x02: Specifies Buffer 2
        0x03: Specifies Buffer 3
    
        Any other value indicates "last buffer used".
    
          Type:    Unsigned 8-bit value
    
          Range:   0 to 0xFF
    
          Default: 0
    
  Output Data:


    If an error occurred, the following information will be displayed.
    
          "DiagError aaaaaaaa"
    
       where
    
          aaaaaaaa is the Diagnostic Error Code
    
    If no error occurred, then the output of this command will be displayed as follows depending
    on the memory type specified:
    

    
    Encoded / Decoder Memory Data
    
       XXXXXXX MICROCODE MEMORY
       Addr:    0     1     2     3     4     5     6     7     8     9     A     B     C     D     E     F
       aaaa bbbbb bbbbb bbbbb bbbbb bbbbb bbbbb bbbbb bbbbb bbbbb bbbbb bbbbb bbbbb bbbbb bbbbb bbbbb bbbbb
       .
       .
       .
       aaaa bbbbb bbbbb bbbbb bbbbb bbbbb bbbbb bbbbb bbbbb bbbbb bbbbb bbbbb bbbbb bbbbb bbbbb bbbbb bbbbb
    
    Where:
          XXXXXXX is either 'ENCODER' or 'DECODER' to indicate the source of the memory being displayed.
          aaaa represents the address of the buffer data
          bbbbb represents data returned from the buffer
    

    
    Erasure Buffer Data
    
       ERASURE xxxxx BUFFER - Buffer c
       Addr:   0    1    2    3    4    5    6    7    8    9    A    B    C    D    E    F
       aaaa bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb
       .
       .
       .
       aaaa bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb
    
    Where:
          xxxxx is INPUT or OUTPUT to indicate which erasure buffer is being displayed
          aaaa represents the address of the buffer data
          bbbb represents data returned from the buffer
          c represent the buffer number
    

    
    Extrinsic Buffer Data
    
       EXTRINSIC BUFFER
       Addr:     0      1      2
       aaaa bbbbbb bbbbbb bbbbbb
       .
       .
       .
       aaaa bbbbbb bbbbbb bbbbbb
    
    Where:
          aaaa represents the address of the buffer data
          bbbbbb represents data returned from the buffer
    

    
    Sample Buffer Data
    
       SAMPLE BUFFER - Buffer c
       Addr:  0   1   2   3   4   5   6   7   8   9   A   B
       aaaa bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb
       .
       .
       .
       aaaa  bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb bbb
    
    Where:
          aaaa represents the address of the buffer data
          bbb represents data returned from the buffer
          c represent the buffer number
    

    
    Small Buffer Data
    
       SMALL BUFFER - Buffer c
       Addr:   0    1    2    3    4    5    6    7    8    9    A    B    C    D    E    F
       aaaa  bbb  bbb  bbb  bbb  bbb  bbb  bbb  bbb  bbb  bbb  bbb  bbb  bbb  bbb  bbb  bbb
       .
       .
       .
       aaaa  bbb  bbb  bbb  bbb  bbb  bbb  bbb  bbb  bbb  bbb  bbb  bbb  bbb  bbb  bbb  bbb
    
    Where:
          a represents the address of the buffer data
          b represents data returned from the buffer
          c represent the buffer number
    

    
    Soft Buffer Read Data
    
       SOFT BUFFER RD - Buffer c
       Addr:      0      1      2
       aaaa  bbbbbb bbbbbb bbbbbb
       .                                                833
    
       .
       .
       aaaa  bbbbbb bbbbbb bbbbbb
    
    Where:
          a represents the address of the buffer data
          b represents data returned from the buffer
          c represent the buffer number
    

    
    Soft Buffer Write Data
    
       SOFT BUFFER WT - Buffer c
       Addr:   0    1    2    3    4    5    6    7    8    9    A    B    C    D    E    F
       aaaa bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb
       .
       .
       .
       aaaa bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb bbbb
    
    Where:
          a represents the address of the buffer data
          b represents data returned from the buffer
          c represent the buffer number
    
  Examples:
    Example #1:
       To display the entire contents of the Sample Buffer 2:
    
          F3 C>D5,,,2
 
   Example #2:
       To display the first 10 entries in the Small Buffer:
 
          F3 C>D6,0,A

  Revision History:

    0001.0000   Initial revision.