October 25, 1999

Overview

Versions 3.2.0 and 3.2.1 of the SB32C2 host software include the following changes:

• Major revision of the E1 and T1 API.

• Modifications to host library functions.

• Modifications to support programs.

• Modifications to diagnostic programs.

SBE1 and SBT1 Application Interface Modifications

The SBE1API and SBT1API software has been re-worked since the last official release. These notes describe the major highlights of the modifications. For more details see the README file in the distribution found in the directory, $CAC/sbdsp/sbe1t1api.
• The SBE1API and SBT1API have been combined into a single set of files. The function names for each API have not changed.

• A DEBUG macro was added to control building the Library functions. The macro enables the displaying of error messages when a function fails.

• The API can be build to support the threaded environment on SOLARIS (SunOS 5.x).

• The follow functions have been added to support handling of non-channelized data streams.

      sbe1_raw_open()             sbt1_raw_open()
      sbe1_raw_read()             sbt1_raw_read()
      sbe1_raw_write()            sbt1_raw_write()
      sbe1_raw_close()            sbt1_raw_close()
      sbe1_rawsuspend_enable()    sbt1_rawsuspend_enable()
  

• The following macro defines have been added to control the building of the Library functions.

      E1_XMT_ENABLE   - controls allocation of dsp xmt buffer 
      CAS_MESSAGING   - controls allocation of CAS Message buffers
      THREAD_SUPPORT  - enables the SOLARIS threaded environment
      REALTIME        - enables real time threaded environment 
      MEMORY_LOCK     - enables locking of host memory buffers
      NEW_STYLE_UEH   - enables using the new style declaration 
                        of the User Error Handler
  

• The SBE1 or SBT1 Handle has been added to the argument list of the User Error Handler function. The user error handler function should be declared as follows:

      userfunction(E1_HANDLE e1, int event, int *data)  /* For E1 */
   or
      userfunction(T1_HANDLE t1, int event, int *data)  /* For T1 */
  

  To enable the new style function declaration, the NEW_STYLE_UEH macro needs to be set to 1 in the sbe1api.h and/or sbt1api.h files (found in the $CAC/include).

      #define NEW_STYLE_UEH  1
  

  The default value for this macro in the distribution files is 0.

• The user_info element has been added to the E1/T1 HANDLE. This element is declared as a (void *). It is not used by the API library functions and it is free to be used by the user application.

  The SBE1API and SBT1API information in the SB32C2 user manual will be updated to reflect these changes in the near future.

Host Library Function Modifications

The sbdsp_init_board function is modified to toggle the DSP RESET signal prior to attempting to access the DSPs. It is also modified to not toggle the DSP RESET signal when the value of its force argument is 0 and the DSPs' memory mode is already mode 6.

Note:The latter change to the sbdsp_init_board function fixes it to behave according to the documentation. Previously it would always toggle the DSP reset signal. Applications that call sbdsp_init_board with force set to 0 may need to modify the call to set force to 1.

The sbdsp_mezz_type function is fixed to close the DSP resource used to determine the mezzanine type.

Modifications to SB32C2 Support Programs

The sbdspreset program now inhibits the transmit signal from SBE1 and SBT1 mezzanines. The E1 and T1 signals are turned off by controlling the output parameter in the framer chip's Line Interface Control Register. The program also now asserts the DSP RESET signal to both DSPs.

The sbmezzcfg program now calls the sbdsp_init_board function after configuring each board.

Modifications to SB32C2 Diagnostic Programs

The sbd3e1loop program is modified to accept a second optional sbdsp device which will be used as an E1 slave. In this mode the primary device transmits E1 to the slave device.

The sbd3scp and sbd3fft programs are modified to support CS4218 codecs which will replace the CS4216 codecs in future production runs.

The sbd3fft program now includes a -M option to have its output sent through the more program to paginate the display.

The sbmemdma program has a new -P option for excluding the PIO transfer tests. Using -P alone excludes both the 16-bit and 32-bit tests. Using -P16 excludes just the 16-bit test and using -P32 excludes the 32-bit test.

The sbdsptim program is modified to include the transfer size and number transfers in its output report.

The sbd3chip, sbd3e1loop, sbd3t1loop and sbdsptim diagnostics are modified to call the sbdsp_init_board function with the force argument set to 1 instead of 0.

The sbdspburn program is modified to display the serial number when it asks for the accumulated burn-in time and to not open the log file until the board information has been gathered.