May 4, 1998

Overview

Version 3.1.1 of the SB32C2 host software includes the following changes:

• Modifications to the sbdspburn diagnostic program for year-2000 operation.

• New features and improvements in the SBE1 Mezzanine API.

Year-2000 Modifications for Burn-In Diagnostic

The sbdspburn diagnostic program was modified to handle years beyond 1999 when generating log file names and time-stamps for log entries.

SBE1 Application Interface Modifications

The host interrupt handler and data buffer formats were modified to reduce the loading on the host.

Two functions added to the E1API provide the ability for an application to suspend itself until data is available to be read from an incoming channel or space is available to send new data to an outgoing channel.

The sbe1_suspend2 function suspends the calling application until either a time slot open for reading has more than a specified number of data samples available in its buffer, or a time slot open for writing has a specified number of spaces open for writing outgoing data samples.

    int
    sbe1_suspend2 (readcnt, writecnt, e1handle, timeslot, mode)
  
        int        readcnt  - number of data samples required
                              for an incoming timeslot to
                              terminate suspension
        int        writecnt - number of data samples required
                              for an outgoing timeslot to
                              terminate suspension
        E1_HANDLE *e1handle - an open E1 handle
        int       *timeslot - pointer to int for time slot value
        int       *mode     - pointer to int for mode value

The readcnt and writecnt arguments specify the number of readable and/or writable data samples required to terminate suspension. The e1handle, timeslot and mode arguments are pointers that, if not NULL, the function will use to store information about the time slot for which the suspension was terminated.

e1handle will be updated with the E1_HANDLE for the device. timeslot will be updated with the time slot number and mode will be updated with E1_READ for an incoming time slot or E1_WRITE, for an outgoing time slot.

When a time slot is opened, it is enabled by default. The sbe1_suspend_enable functions allows the application to select which time slots can and cannot trigger the sbe1_suspend2 function to terminate and return to the application. The rmask and wmask arguments are bit-mapped masks that select which read and write time slots are to be enabled or disabled by the function call. The enable argument specifies whether those time slots are to be enabled, if it is 1, or disabled, if it is 0. The sbe1_suspend2 function only checks the buffers for time slots whose suspend flag is enabled.

    int
    sbe1_suspend_enable (e1handle, rmask, wmask, enable)
  
        E1_HANDLE *e1handle - an open E1 handle
        int        rmask    - mask of incoming time slots
        int        wmask    - mask of outgoing time slots
        int        enable   - enable flag

The E1API now supports the use of multiple DSP processors. An application may now call the sbe1_open multiple times with different DSP device names. A new E1_HANDLE is returned for each new DSP device specified.