Teacin - Townshend Computer Tools DAT-Link User Manual

170
NAME
teacin – parse data transferred from a TEAC data DAT recorder
SYNOPSIS
teacin [ –o out_file ] [ file ]
DESCRIPTION
Data transferred from a TEAC data DAT recorder contains side information in addition to the actual
data. This information is stored in the two least significant bits of each 16-bit data word. The teacin
p rogram can be used to separate this information from the data, parse it, and store it in separate files.
The complete data stream is read from file, or, if file is not given, from the standard input. The actua
c hannel data and speech annotation trace are stored in two sets of files formed by added suffixes to
out_file. A new pair of files (one for data, one for speech) is opened each time a break in the recordin
i s detected.
Teacin also parses and displays the side information on the standard output. This output consists of the
following elements on a single line:
Filename:
of current output data file.
Date: In the format yy/mm/dd.
T ime: In the format hh:mm:ss.
Channels:
Number of channels of recording.
Sample:
Current 16-bit sample number starting at zero for first sample read by teacin.
Speed: Either 1x or 2x for normal or double-speed mode.
R eserved:
Three words of undecoded side information from the TEAC. These may be used on
future models in TEAC's data DAT line.
Input Range :
Maximum level, in volts, for each of the input channels. This value is prefixed with
the letter 'Z' if zero-shifting is enabled for the channel.
T he above values are written on single line which is continuously erased and updated. If any break in
the time sequence or any other side information changes then the display begins a new line with th
c hanged values. Thus, a continuous monitoring of the TEAC's output can be achieved using:
narecord | teacin
T he data from the TEAC is stored in a sequence of files formed from out_file by appending the suffix
.dnn where nn is a number starting at one and incremented each time synchronization from the TEAC
i s lost then resumed again. Each file begins with the channel 1 data starting from the point sync was
obtained and ends with the last data block read with correct sync. The two least significant bits are
z eroed in this file.
Similiarly files formed from out_file by appending the suffix .dnn are used to store the speech annota-
tion track from the recorder.
F or example, if the command:
narecord | teacin -o test
i s given, control information will be stored in test.ctl, data in test.d01, test.d02, test.d03,..., and the
speech channels in test.s01, test.s02, test.s03,... Note that the test.ctl file will indicate the byte numbe
o f the input which is stored in each of the files, as well as the recording settings, date, and time.
NetAudio Reference Last change: 1995/07/11

TEACIN(1)

l
g
e
r
1