Chapter 7

Function Summary

An MVIP system permits a variety of telephony devices on boards from different vendors to be connected to each other. Switching is the process of changing those connections, both during and between phone calls.
The Switching service provides functions to: Open and close switching devices Make connections and access inputs and outputs Configure the clocks Obtain and configure stream speed information Get configuration information about streams, timeslots, boards, and drivers Access the underlying MVIP device driver Perform miscellaneous switching functions
All functions in the Switching service are synchronous.

The following functions allow you to open and close switching devices and obtain information about the switch block: Function Description swiCloseSwitch Closes the switching device and invalidates the specified switch handle. swiGetSwitchCaps Queries the device driver and returns information about the capabilities of the device driver and the switch controlled by it. swiOpenSwitch Opens the switching device and returns a switch handle.
Refer to Section 3.2, Opening a Switch Handle and to Section 3.3, Closing a Switch Handle for more information.

Function	Description
swiCloseSwitch	Closes the switching device and invalidates the specified switch handle.
swiGetSwitchCaps	Queries the device driver and returns information about the capabilities of the device driver and the switch controlled by it.
swiOpenSwitch	Opens the switching device and returns a switch handle.

The following functions allow you to make connections and access inputs and outputs: Function Description swiDisableOutput Resets specified switch block outputs to their idle state. swiGetOutputState Retrieves the state of specified switch block outputs. swiMakeConnection Connects inputs to outputs. swiMakeFramedConnection Connects inputs to outputs with identical throughput delay for all connections. swiResetSwitch Resets the entire switch block to the idle state. swiSampleInput Retrieves the current datum values present on specified switch block inputs. swiSendPattern Asserts fixed patterns on specified switch block outputs.
Refer to Section 5.4, Disabling Output and to Section 5.2, Making Connections for more information.

Function	Description
swiDisableOutput	Resets specified switch block outputs to their idle state.
swiGetOutputState	Retrieves the state of specified switch block outputs.
swiMakeConnection	Connects inputs to outputs.
swiMakeFramedConnection	Connects inputs to outputs with identical throughput delay for all connections.
swiResetSwitch	Resets the entire switch block to the idle state.
swiSampleInput	Retrieves the current datum values present on specified switch block inputs.
swiSendPattern	Asserts fixed patterns on specified switch block outputs.

The Switching service allows you to control the clocks on the underlying MVIP switching device. It provides functions for configuring the: Board's clock source (H bus or network). Secondary clock signal on the bus. Netref clock source on the H.100/H.110 bus.
It also provides functions to retrieve clock configuration, timing reference, and status information.
The following table describes the clock configuration functions: Function Description swiConfigBoardClock Establishes the clock source for an MVIP board. swiConfigNetrefClock Defines the source of the NETREF clocks on the H.100/H.110 bus. swiGetBoardClock Retrieves information regarding the configuration of the board clocking and current status of the clocks. swiGetTimingReference Retrieves the status of a potential TDM bus clock timing reference.
Refer to Chapter 4 for more information about configuring clocks.

Function	Description
swiConfigBoardClock	Establishes the clock source for an MVIP board.
swiConfigNetrefClock	Defines the source of the NETREF clocks on the H.100/H.110 bus.
swiGetBoardClock	Retrieves information regarding the configuration of the board clocking and current status of the clocks.
swiGetTimingReference	Retrieves the status of a potential TDM bus clock timing reference.

The following functions allow you to obtain and control the speed of an H.100 stream on an H.100 bus: Function Description swiConfigStreamSpeed Configures the speed of one or more streams of the H.100 bus. swiGetStreamsBySpeed Identifies all H.100 streams operating at one specified speed. Note: The H.110 bus is specified for 8 MHz streams only.
Refer to Section 6.2, Stream Speed Configuration for more information.

Function	Description
swiConfigStreamSpeed	Configures the speed of one or more streams of the H.100 bus.
swiGetStreamsBySpeed	Identifies all H.100 streams operating at one specified speed.

The following functions allow you to configure devices on local streams and local timeslots, obtain information about the board and the driver, and obtain information about devices on a local stream and a local timeslot: Function Description swiConfigLocalStream Configures stream-specific characteristics of a local device. swiConfigLocalTimeslot Configures stream-specific and timeslot-specific characteristics of a local device. swiGetBoardInfo Retrieves information about the board controlled by the MVIP device driver. swiGetDriverInfo Retrieves general and vendor-specific information about the device driver. swiGetLocalStreamInfo Retrieves stream-specific characteristics of a local device. swiGetLocalTimeslotInfo Retrieves stream-specific and timeslot-specific characteristics of a local device.
Refer to Section 6.3, Board and Driver Configuration for more information.

Function	Description
swiConfigLocalStream	Configures stream-specific characteristics of a local device.
swiConfigLocalTimeslot	Configures stream-specific and timeslot-specific characteristics of a local device.
swiGetBoardInfo	Retrieves information about the board controlled by the MVIP device driver.
swiGetDriverInfo	Retrieves general and vendor-specific information about the device driver.
swiGetLocalStreamInfo	Retrieves stream-specific characteristics of a local device.
swiGetLocalTimeslotInfo	Retrieves stream-specific and timeslot-specific characteristics of a local device.

The following functions give you direct access to the MVIP device driver: Function Description swiCallDriver Allows the application to make a direct call to the MVIP device driver. swiGetLastError Gets the last MVIP device error on the switch handle.

Function	Description
swiCallDriver	Allows the application to make a direct call to the MVIP device driver.
swiGetLastError	Gets the last MVIP device error on the switch handle.

The following additional miscellaneous functions are available in the Switching service: Function Description swiDisableSwitch Disables the switch block with respect to the MVIP bus. swiEnableSwitch Enables the switch block with respect to the MVIP bus. swiSetVerify Enables or disables command-by-command verification of switching functions.

Function	Description
swiDisableSwitch	Disables the switch block with respect to the MVIP bus.
swiEnableSwitch	Enables the switch block with respect to the MVIP bus.
swiSetVerify	Enables or disables command-by-command verification of switching functions.

Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com