- Keep the following restrictions in mind when reconfiguring the available functions on an AG board:
- The AG-8 cannot support more than four foreground overlays if echo.dsp is
installed. This restriction does not apply to the AG-8 80.
- To configure the AG boards in a system to use functions that are not in the default configuration, complete the following the steps:
- List all the functions that you wish to be made available to your application in the connected call control state for the ports on a given AG board.
- From the previous step, look in Table 2 to determine which overlay files are required.
- Add a
DSPfile statement to the ag.cfg file for each new overlay which is required. The syntax for the statement is:
DSPfile = <overlay.dsp>
For example, DSPfile = wavrec.dsp
- Each overlay file listed in a
DSPfile statement will be assigned to task processors. If the overlay is not one of DTMF, DTMFE, SIGNAL or ECHO, it will be placed on all foreground task processors.
Note: In the configuration files on the runtime disk, the DSPfile statements are located in the common section after the [AGBOARD] keyword. This will cause the overlay files to be loaded on all boards configured in the configuration file. As an alternative, the DSPfile statements can be moved to inside the individual BOARD sections of the configuration file. This will allow each board in the system to be configured independently.
Note: If configuring for A-law encoding, as is typical with the AG-E1 and AG-60 products, append "_A" to each DSP file name. This will select the
A-law encoded version of the DSP file. (For example, voice_a.dsp.)
- Always make certain the following overlay files are specified in the ag.cfg file. These files are required for the call control functions.
DSPfile = signal.dsp
DSPfile = callp.dsp
DSPfile = dtmf.dsp *
DSPfile = tone.dsp
(* Substitute dtmfe.dsp if you are using echo canceling.)
- To configure for echo canceling, also specify the following overlay file in the ag.cfg file:
DSPfile = echo.dsp
- Check your MIPS usage. Take the worst case MIPS usage for each port on a board. Add up the total MIPS usage for all ports. This should not exceed the Available Foreground MIPS from Table 3 for any boards in the system. If it does, then reduce the number of ports used on that board by the application, accordingly.
- Check the list of configuration restrictions
- Initialize the boards by running agmon. Examine the Task Processor Configuration section of the ag.rpt file output by agmon and confirm that the foreground overlays you have selected are assigned to the foreground task processors.
Bandwidth Configuration Restrictions
- Some functions have extremely high data throughput requirements. This is especially true of Wave file play and record since no audio compression is performed on Wave files. This section lists restrictions based on data throughput limitations.
- A maximum of 20 ports can simultaneously play 16-bit Wave files on the
AG-24+, AG-30, AG-T1, AG-E1, AG-48 and AG-60.
- For the AG-8, AG-8 80, and AG-24, the maximum number of ports which
can play 8 bit Wave files is equal to the standard port count divided by 1.4
rounded down. For example, an AG-24 can play only 24 / 1.4 = 17 ports.
- A maximum of 40 ports can simultaneously play 8-bit Wave files on the
AG-24+, AG-30, AG-T1, AG-E1, AG-48 and AG-60.
Example 1
- This example is based on the procedure explained on page 109 and describes how to configure a standard AG-8 to play and record OKI 6Khz speech instead of NMS speech, without echo canceling.
- List all foreground functions used in connected state:
- OKI Play 6Khz
- OKI Record 6Khz
- From Table 2, the overlay files required are:
- okirec.dsp
- okiply.dsp
- Edit the ag.cfg file to contain the following statements:
DSPfile = signal.dsp # Always required background
DSPfile = dtmf.dsp # Always required background
DSPfile = callp.dsp # Always required foreground
DSPfile = tone.dsp # Always required foreground
DSPfile = okirec.dsp # Foreground from step 2
DSPfile = okiply.dsp # Foreground from step 2
- Calculate worst case MIPS:
From Table 2, the MIPS requirements for the selected foreground functions are:
Tone Generator = 0.88 MIPS
OKI Play 6Khz = 2.52 MIPS
OKI Record 6Khz = 2.46 MIPS
These three functions are mutually exclusive on each port. i.e. only a single one of the three will ever be active at any given time on a given port. Consequently, the worst case foreground MIPS usage is 2.52 MIPS per port.
The total worst case MIPS usage is 8 ports * 2.52 MIPS per port = 20.2 MIPS. From Table 3 there are available 23 foreground MIPS.
- No restrictions apply.
- Run agmon on the edited configuration file and confirm task processor assignments.
Example 2
- This example is based on the procedure explained on page 109 and describes how to configure a standard AG-24+ to use NMS vari-speed speech with the maximum play speed set to 2X, without echo canceling. It is assumed that the application is also using tone generation. Due to the high MIPS requirements of the NMS vari-speed overlay, this configuration will result in a reduced port count as shown in step 4.
- List functions
- NMS Play 32kbs 2X (4.30 MIPS)
- NMS Play 24kbs 2X (4.30 MIPS)
- NMS Play 16kbs 2X (4.30 MIPS)
- NMS Record 32kbs (2.13 MIPS)
- NMS Record 24kbs (2.13 MIPS)
- NMS Record 16kbs (2.13 MIPS)
- List overlays
- voxp.dsp
- voxr.dsp
- Edit the ag.cfg file to contain the following statements:
DSPfile = signal.dsp # Always required background
DSPfile = dtmf.dsp # Always required background
DSPfile = callp.dsp # Always required foreground
DSPfile = tone.dsp # Always required foreground
DSPfile = voxp.dsp # Foreground from step 2
DSPfile = voxr.dsp # Foreground from step 2
- All functions listed in step 1 are mutually exclusive on each port. Only a single one of the three types of play or record will ever be active at any given time on a given port. Consequently, the worst case foreground MIPS usage occurs when any NMS vari-speed play is running at 4.3 MIPS per port. The available foreground MIPS on an AG-24+ from table two is 86 MIPS. This means the maximum number of ports in this configuration is equal to 86 MIPS / 4.3 MIPS = 20 ports.
- No restrictions apply.
- Run agmon on the edited configuration file and confirm task processor assignments.
(Page 6 of 6 in this chapter)