Alofi(1) Alofi(1) NAME Alofi - a network-transparent audio server for LoFi SYNOPSIS The AF audio server is a network transparent system developed at Digital CRL for using LoFi audio hardware in a distributed environment. DESCRIPTION Alofi is an AF server with LoFi/DECaudio device dependent support. STARTING UP Alofi [:portOffset] [options] & OPTIONS -help Use the help switch to determine device independent arguments. -device device Specifies the name of the LoFi audio device. If this switch is not used, the Alofi audio server will default to the device specified by the AUDIO_DEVICE environment variable or the /dev/lofi device. (In general, /dev/lofi is a symbolic link to the /dev/lofi0 device special file.) -ukernel lodfile Specifies an alternate DSP56001 absolute lodfile. If ukernel is not specified, the server checks for the AF_UKERNEL environment variable. If neither the switch nor the AF_UKERNEL environment is used, the server looks for the path DIR/main.lod (Or DIR/mainteleport.lod in -teleport mode) where DIR is the LODPATH environment variable if it exists, otherise it is the config variable LODDIR. -pcoeff coeff_file Specifies an alternate set of X filter coefficients for the primary/phone CODEC. coeff_file should be an ASCII file containing eight lines with two bytes per line representing the X filter coeffi- cients for the AMD79C30A CODEC. Here are the contents of an example file containing the default coefficients used on LoFi's telephone CODEC. 94 0F C2 AC 94 FF 22 AB 36 EA 4A B2 A4 E2 BC BA -teleport When this switch is specified, the operation of the hifi parts of the server are customized to work well with the Ariel Teleport DSP port to telephone interface. In this mode, device 2 is a 16 bit mono path to Line 1 of the Teleport and device 3 is a 16 bit mono path to Line 2 of the Teleport. On device 2, the passthrough mode controls the "line" or "local" setting of the local telephone set. Device 2 also provides two "inputs". Input 0 connects the interface to the telephone line, while Input 1 connects the device to the Teleport local battery cir- cuit. Along with -teleport, you must specify "-mode ext" "-hrate xxx" and "-dspc xxx". The Teleport mode replaces the low two client data bits on output with inband signalling to the Teleport. On input, the low two bits are inband signalling from the Teleport, which are observed, but not changed by the server. -nohifi Disables HiFi support (devices 2, 3, and 4). -daa_gain {0,1} Sets the state of the telephone DAA's gain control bit. Setting the bit to 1 (default) disables the power limiting circuitry in the DAA. Setting the bit to 0 enables the automatic power limiter. -mode {int,ext} Sets the hi-fi operating mode: int selects the internal stereo DAC (44.1 kHz, two-channel output). ext selects an external device con- nected to the DSP port. NOTE: make sure the switch on the back of the distribution box is set to match the operating mode. Defaults to int. -hrate <#> Informs the server of the hi-fi sample rate (in samples per second). This option does not set the rate for the hi-fi hardware. The inter- nal DAC runs at 44100 samples per second. External devices may have fixed sample rates, be configurable with panel switches, or may be software configurable (see the -dspc parameter below); consult the device's manual for details. Defaults to 44100. -dspc <#> Specifies a 3-bit DSP port value that sets the sample rate for some hi-fi devices; consult the device's manual for details. Only valid when the external operating mode is selected. AUDIO DEVICES The Alofi audio server presents five audio devices to client applications. These audio devices are the 8KHz mu-law telephone CODEC, the 8KHz local audio CODEC, left and right stereo HiFi device, mono HiFi left channel dev- ice, and finally the mono HiFi right channel device. These audio devices have device numbers of 0 to 4. In Teleport mode, there are 4 devices, num- bered 0 to 3. CONNECTION NAME From the user's prospective, every AF server has an audio connection of the form: hostname:portOffset This information is used by the application to determine how it should con- nect to the server. hostname The hostname specifies the name of the machine to which the audio device is physically connected. portOffset The portOffset is used to identify the audio server's port on host- name. For example, to simultaneously run two audio servers on a given host, you might select 0 or 1 for portOffset. If the connection name to an audio server is not specified, then the environment variables AUDIOFILE or DISPLAY will be used. ACCESS CONTROL The sample server provides two types of access control: an authorization protocol which provides a list of ``magic cookies'' clients can send to request access, and a list of hosts from which connections are always accepted. EXAMPLES Alofi has been used with the following three devices: the Ariel ProPort Model 656, the Ariel Teleport Model 214, the Ariel DM-N Digital Microphone, and the Applied Speech Technologies A/D16. A "-mode ext" option selects external operation (disabling the DECaudio's built-in stereo DAC). The "-dspc #" option sets bits on the DSP port to set the external device's sample rate in some device specific way. The "- hrate #" informs the server of the sample rate (the actual sample rate is usually set by the external device). Ariel DM-N Digital Microphone settings: 5.5 kHz: Alofi -mode ext -dspc 3 -hrate 5500 11.02 kHz: Alofi -mode ext -dspc 2 -hrate 11020 22.05 kHz: Alofi -mode ext -dspc 1 -hrate 22050 44.1 kHz: Alofi -mode ext -dspc 7 -hrate 44100 Ariel ProPort Model 656 settings: 8 kHz: Alofi -mode ext -dspc 6 -hrate 8000 11.025 kHz: Alofi -mode ext -dspc 5 -hrate 11025 16 kHz: Alofi -mode ext -dspc 4 -hrate 16000 32 kHz: Alofi -mode ext -dspc 3 -hrate 32000 44.1 kHz: Alofi -mode ext -dspc 2 -hrate 44100 48 kHz: Alofi -mode ext -dspc 1 -hrate 48000 Applied Speech Technologies, A/D16: (fixed single channel, 16 kHz input) 16 kHz: Alofi -mode ext -hrate 16000 Ariel Teleport Model 214 settings: 7.2 KHz: Alofi -teleport -mode ext -dspc 2 -hrate 7200 8.0 KHz: Alofi -teleport -mode ext -dspc 1 -hrate 8000 9.6 KHz: Alofi -teleport -mode ext -dspc 0 -hrate 9600 BUGS DECaudio's built-in DAC will not work if there is an external device plugged into the DSP port (regardless of the switch setting). If you encounter a repeatable bug, please submit a problem report to () and include the source code if possible. SEE ALSO AF(1), Aaxp(1), Amaxine(1), Alofi(1), Ajv(1), Amsb(1), Aj300(1), aplay(1), arecord(1), apass(1), aset(1), abrowse(1), afft(1), ahost(1), aphone(1), aprop(1), ahs(1), axset(1), xpow(1), afxctl(1), aname2num(1), alsatoms(1), aevents(1), abob(1) COPYRIGHT See the COPYRIGHTS file. Copyright 1991-1994, Digital Equipment Corporation and the Massachusetts Institute of Technology. AUTHORS Digital Cambridge Research Lab