Prosody installation guide: test programs: gdcrx

This is a data communications tester. It configures a channel to receive 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 gdcrx with the appropriate options (the program is gen-LINUX_V6/gdcrx or gen-WINNT_V6/gdcrx depending on which operating system you are using).

Command line options are:

Option format Meaning

-o <file> record incoming data into this file

-f <format>

the format to use for displaying incoming data.

format meaning

c show as characters. Control characters are printed as ^X, characters >= 128 are printed as ~X, and the characters ^, ~, and \, are prefixed with \. (default)

x print in hex

r print as received

Show characters as V.18 Annex A. Display most characters as themselves, the rest as follows

Code	Shown as
LTRS	`[L]` or, if redundant, `[L+`x`]`, where x is a decimal number
FIGS	`[N]` or, if redundant, `[N+`x`]`, where x is a decimal number
SPACE	`_`
CR	`^M`
LF	`^J`
BACKSP	`^H`

A redundant LTRS or FIGS also prints the number of characters received since the last one. This allows you to check if the V.18 rule about sending a redundant LTRS or FIGS every 72 characters is being followed.

-m <module> The Prosody module to use. This is the number of the module on the card.

-t <timeslot> timeslot to use for input (see Test program timeslots).

-p <patlen> length of pattern to test. This must be a pattern generated by gdctx.

-e <encoding> The encoding to use. One of "hdlc", "sync", or "async".

-u <modulation> The modulation to use. One of "raw", "cw", "fsk", "v110", "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:

name	modulation
v21o	V.21 channel 1 (originate)
v21a	V.21 channel 2 (answer)
v23o	V.23 originate (75 bps)
v23a	V.23 answer (1200 bps)
v23a600	V.23 answer (600 bps)
bell103a	Bell 103 answer (300 bps)
bell103o	Bell 103 originate (300 bps)

-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.

-Foff <off-mS> The rx_carrier_off_mS value to use. This option is only relevant when the -u fsk is used. option.

-Fon <on-mS> The rx_carrier_on_mS value to use. This option is only relevant when the -u fsk is used. option.

-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:

	gdcrx -x x:1.2.3.4/mykey -t64:0 -u fsk -s v21a -e async

starts an FSK receiver configured for the V.21 originating carrier on the timeslot 64:0 and decodes incoming data as async.

While it is running, in addition to the decoded data, it also prints status messages for events such as loss of carrier.

This is one of the Prosody test programs .