This is a data communications tester. It configures a channel to transmit data using any protocol and encoding.
Go to directory $(TiNG)/test.
You must have downloaded firmware modules as listed in Prosody Data Communcations Protocols and Encodings.
Run gdctx with the appropriate options (the program is
gen-LINUX_V6/gdctx or
gen-WINNT_V6/gdctx
depending on which operating system you are using).
Command line options are:
| Option format | Meaning | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
-i <inifile>
| take initial command from this file (then read commands from standard input as normal) | ||||||||||||||||
-m <module>
| The Prosody module to use. This is the number of the module on the card. | ||||||||||||||||
-t <timeslot>
| timeslot to use for output (see Test program timeslots). | ||||||||||||||||
-p <patlen>
| length of pattern to test. This can be tested by gdcrx. | ||||||||||||||||
-e <encoding>
| The encoding to use. One of
"hdlc",
"sync", or
"async".
| ||||||||||||||||
-u <modulation>
| The modulation to use. One of
"raw",
"cw",
"fsk",
"v110",
"v17",
"v27", or
"v29".
| ||||||||||||||||
-s <standard>
| The type of FSK modulation required. This
option is only relevant when the -u fsk
is used. It is an alternative to specifying the FSK
parameters with -M, -S,
and -B options.
One of these:
| ||||||||||||||||
-B <speed>
| The speed (in bps) that the modulation is to use. This option is only relevant when the speed of the modulation can be configured. | ||||||||||||||||
-M <markfreq>
| The frequency to be used by FSK modulation for sending
mark. This option is only relevant when the
-u fsk is used. It is an alternative to
specifying the FSK parameters with the -s
option.
| ||||||||||||||||
-S <spacefreq>
| The frequency to be used by FSK modulation for sending
space. This option is only relevant when the
-u fsk is used. It is an alternative to
specifying the FSK parameters with the -s
option.
| ||||||||||||||||
-X <stopbits>
| The number of extra stop bits to use. This option
is only relevant when the -u async is used.
(See the async encoding
description for further details).
| ||||||||||||||||
-C <crcsize>
| The length of the CRC to use (in bits). This option
is only relevant when the -u hdlc is used.
(See the HDLC encoding
description for further details).
| ||||||||||||||||
-c <crc>
| The CRC polynomial to use. This option is only
relevant when the -u hdlc is used.
(See the HDLC encoding
description for further details).
| ||||||||||||||||
-x <cardspec>
| Use a Prosody processor module on this card, specified as described in Test programs: Specifying Prosody Processor modules |
For example:
gdctx -x x:1.2.3.4/mykey -t64:0 -u fsk -s v21a -e async
starts an FSK transmitter configured for the V.21 originating carrier on
the timeslot 64:0 and sends data as async.
While it is running, it reads lines of input and interprets them as
commands. (The -i option can be used to make it run some
initialisation commands before reading any input). Each line is one
command, which consists of one character followed by any parameters.
The commands are:
| Character | Meaning | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| (i.e. blank line - no command) Print status | |||||||||
? | Print summary of possible commands | ||||||||
c x | Invoke
smdc_line_control() with
the command to use being determined by the next character, x, as
follows:
| ||||||||
e N | Enable (N=1) or disable (N=0) talker echo protection (only relevant for V.27ter, V.29, and V.17) | ||||||||
f N | send N flags (only relevant for HDLC) | ||||||||
F | finish (same giving the kSMDCTxCtlFinish command to smdc_tx_control()). Makes the carrier turn off after remaining data has been sent. | ||||||||
f N | send N flags (only relevant for HDLC) | ||||||||
p P[:S] | Set prefix to P
and suffix to S where each of these is written in binary
| ||||||||
R | turn on RTS | ||||||||
r | turn off RTS | ||||||||
t N | Enable (N=1) or disable (N=0) short training sequences (only relevant for V.27ter, V.29, and V.17) | ||||||||
= characters | send specified characters plus a CR LF | ||||||||
- characters | send specified characters | ||||||||
v characters | send specified characters after translating to the code from V.18 Annex A (a 5-bit code similar to Baudot) | ||||||||
q | quit | ||||||||
# anything | do nothing - used for comments |
The source code for this program is provided (gdctx.c).
This is one of the Prosody test programs .