record.1

speech signal process tools

.\" record.1	1.2 4/22/86
.TH RECORD  1 2/14/86
.ds ]W "Entropic Processing, Inc.
.SH NAME
record  - digitize data using the MASSCOMP EF-12M analog-to-digital (A/D) converter.
.SH SYNOPSIS
.B record
[
.BI \-x " debug level"
] [
.BI \-{psf} " range"
] [
.BI \-r " sampling rate"
] [
.BI \-g " gain"
] [
.BI \-w " width"
] [
.BI \-c " a2d channel"
] [
.BI \-k " clock#"
]
.I file
.SH DESCRIPTION
.PP
.I Record
digitizes the input at the specified sampling rate and stores the data in 
.I file
(an SPS sampled data (.sd) file).
A range of data may be specified in one of three ways:
the number of samples, seconds of data, or number of frames at the specified width.
Furthermore, a scaling factor
(gain), an alternate A/D channel, and an alternate clock may be specified.
.PP
The following options are supported:
.TP
.BI \-x " debug level"
Only debug level 1 is defined in this version;
this causes several messages to be printed.
The default level is zero, which causes no debug output.
.TP
.BI \-p " range"
Select the recording length, in number of points.
.TP
.BI \-s " range"
Select the recording length, in seconds.
.TP
.BI \-f " range"
Select the recording length, in frames. By default, a frame is
100 points, but this may be changed. See 
.I width
below.
.TP
.BI \-r " sampling rate"
Select the sampling rate (default is 8000).
.TP
.BI \-w " width"
This switch defines the frame width. The width is ignored unless the
.B \-f
switch is also specified. (The default is 100.)
.TP
.BI \-c " a2d channel"
Specifies the channel of the A/D to use. Legal values are zero through seven. (Default is channel zero)
.TP
.BI \-k " clock#"
Specifies the clock used to drive the analog to digital conversion. Legal values are zero through four. (Default is number one.)
.TP
.BI \-g " gain"
Analog signal is multiplied by
.I gain
before being recorded. Legal gains are 1, 2, 4, and 8. (Default is one.)
.TP
.I \ file
The file to store the sampled speech data into.  By convention this
file ends with \fI.sd\fR, although it is not enforced.
.PP
.I Record 
uses a 12 bit A/D converter;
the
maximum sampling rate is 333,000 samples/second; and the input
voltage range to the A/D converter is -+ 10 volts.
.PP
.I Record
tells the user when all the setups are finished and the A/D conversion process is ready to begin.
The data conversion starts when the user hits a carriage return.
.SH SPS PARAMETERS
The SPS parameter file is not referenced.
.SH DIAGNOSTICS
.PP
.I Record
prints "Event Wait Timeout" if the the program quits before all the data is captured.
This can happen if the designated clock is not physically connected to the A/D converter, or if the
system load is too heavy to support the conversion.
.SH FILES
.PP
/usr/tmp/recXXXXXX
.SH BUGS
.SH EXPECTED CHANGES
.PP
A more efficient version
of this program could be written using MASSCOMP's DA/CP libraries.
.SH AUTHOR
.PP
David Burton