 |
 |
 |
 |
 |
|
|
|
|
|
4.11.5. Constructing Device Names
Once the Intel Dialogic System Software sorts the devices, it assigns names to both devices and channels within devices. The following topics discuss how to construct device names:
- Overview of Device Naming
- Board-Level Names
- Channel-Level Names
- Device Naming and Numbering for DM3 Boards
Overview of Device Naming
Although there is a great deal of consistency among different types of compatible Intel Dialogic hardware in how devices are numbered, device mapping (device naming or device numbering) is hardware dependent. If a programmer "hard-codes" an application to use device names based on specific Intel Dialogic boards, some of those device names may need to be changed if a different model board is used as a replacement.
A programmer can achieve the greatest degree of backward compatibility among Intel Dialogic boards by making the device mapping in the application program hardware independent. The method for achieving this, along with sample application code, is provided in the technical note entitled "Identifying the number and type of Intel Dialogic boards in a Windows NT system from within an application," (http://resource.intel.com/telecom/support/tnotes/tnbyos/winnt/tn193.htm). This technical note also is available from the Intel® Networking & Communications Telecom Support Resources web site http://developer.intel.com/design/telecom/support/ by selecting Technical Notes, and then the operating system, Windows NT.
Board-Level Names
A device name is assigned to each device or each component in a board as follows:
- dxxxBn, where n is the device number assigned in sequential order down the list of sorted voice boards. A device corresponds to a grouping of two or four voice channels.
For example, a D/240SC board employs 24 voice channels; the Intel Dialogic System Software therefore divides the D/240SC into six voice devices, each device consisting of four channels. Boards with an E-1 interface, such as the D/300SC-E1, employ 30 voice channels. The Intel Dialogic System Software divides the D/300SC-E1 into seven voice devices consisting of four channels each and one voice device consisting of two voice channels.
- dtiBn, where n is the device number assigned in sequential order down the list of sorted digital network interface devices. A device consists of one digital network interface. A DTI/240SC contains one dti device. A D/240SC-2T1 contains two dti devices. Note that the D/240SC-2T1 also contains six dxxx devices.
- msiBn, where n is the device number assigned in sequential order down the list of sorted modular station interface boards. A device corresponds to one MSI board.
- dcbBn, where n is the device number assigned in sequential order down the list of sorted audio conferencing boards. A device corresponds to one DCB board.
- iptBn, where n is the logical board number that corresponds to a NIC or NIC address when using IP technology. These devices are used by the Global Call API.
- ipmBn, where n is the board device number assigned to a media board. These devices are used by the Global Call API and the IP Media Library API.
- brdBn, where n is a physical board name assigned to each board in the system. Given the opaque identifier (AUID) for a board, the SRLGetPhysicalBoardName( ) function can be used to retrieve the physical board name.
Channel-Level Names
A board device name can be appended with a channel or component identifier. The following channel-level devices are used:
- dxxxBnCy: where y corresponds to one of the voice channels. Examples of channel device names for voice boards are dxxxB1C1 and dxxxB1C2.
- dtiBnTy: where y corresponds to one of the digital time slots. Examples of channel device names for digital network interface boards are dtiB1T1 and dtiB1T2.
- msiBnCy: where y corresponds to one of the conferencing channels.
- dcbBnDy: where y corresponds to one (DCB/320), two (DCB/640), or three (DCB/960) DSP(s).
- iptBnTy: where y corresponds to the logical channel number over which call signaling is transmitted when using IP technology. These devices are used by the Global Call API.
- ipmBnTy: where y corresponds to a media resource on a media board and is used to control media streaming and related functions when using IP technology. These devices are used by the Global Call API and the IP Media Library API.
Device Naming and Numbering for DM3 Boards
The following conventions apply to DM3 board naming and numbering:
- All DM3 board devices are assigned standard device names, for example, dxxxB1, dxxxB2, dtiB1, dtiB2 etc.
- All DM3 channel and timeslot devices are assigned standard device names, for example, dxxxB1C1, dxxxB1C2, dtiB1T1, dtiB1T2.
- A single physical DM3 board device can contain multiple virtual boards that are each numbered in sequential order; for example, a DM/V960-4T1 board with four digital network interfaces contains four virtual network interface boards that would follow a sequential numbering pattern such as dtiB1, dtiB2, dtiB3, dtiB4.
- All DM3 board devices are numbered in sequential order based on the logical Board ID assigned by the DM3 driver (the board with the lowest logical Board ID will be assigned the next board number, and so on).
- The SRL device mapper functions can be used to return information about the structure of the system including the number of boards in the system and so on. See the Standard Runtime Library API Library Reference for more information.
Table 12 provides an example of the device naming and numbering conventions used for DM3 boards.
For a given physical board, devices are enumerated sequentially, but there are differences in the way devices are enumerated in Springware and DM3. For example:
For a Springware D/600JCT board, devices are enumerated as follows:
For a DM3 DM/V600A board, devices are enumerated as follows:
- Note: The device enumeration scheme described above applies to the DM/V600A, DM/V1200, and DM/V1200A boards also.
|
|
|
|
|
Click here to contact Telecom Support Resources
Copyright 2002, Intel Corporation