SETBAYCOM(8)

NAME
setbaycom - get/set Linux baycom port information

SYNOPSIS
setbaycom [ -bcdhs ] [-i device] setbaycom -c [-i device] cal setbaycom -p [-i device] [ modem iobase irq options ]

DESCRIPTION
setbaycom is a program designed to set and/or report the configuration information associated with a baycom radio modem port. This information includes the modem type ( ser12 or par96 ), what I/O port and IRQ a particular baycom port is using, and whether or not the software DCD should be used. With the -p option, setbaycom sets and/or reports the port configuration. With the -c option, setbaycom instructs the driver to send a calibration pattern for cal minutes. Without the -p and -c option, setbaycom will stay in the foreground and display received packets. The AX.25 header and eventually a FlexNet compressed header are decoded. CTRL-C terminates setbaycom . Specifying additional options, setbaycom may display additional information.

OPTIONS
setbaycom accepts the following options:

-b  Trace the bits at the output of the demodulator. This option is only available if setbaycom and the baycom kernel driver is compiled with debugging support on. This is useful for driver debugging.

-d  Trace DCD, PTT and other status information on stdout. setbaycom displays two times per second a line containing these informations.

-h  Display an overview of the available command line parameters and exit.

-i  The device argument specifies the baycom device which should be configured or interrogated. It will usually have the following form: /dev/bc[0-3].

-s  Trace the values sampled from the TCM3105 output to stdout. This option is only available if setbaycom and the baycom kernel driver is compiled with debugging support on and the specified device is configured as ser12. This is useful for driver debugging.

PARAMETERS
The following parameters can be assigned to a baycom port. All parameter values are assumed to be in decimal unless preceeded by "0x". The modem parameter sets the type of modem that is connected to the specified port. Currently none , ser12 or par96 are valid choices. The ioport parameter sets the I/O port address. Usual values are for ser12 modems 0x3f8, 0x2f8, 0x3e8, 0x2e8 and for par96 modems 0x378, 0x3bc, 0x278. The irq parameter sets the hardware IRQ number. Usual values are for ser12 modems 4, 3 and for par96 modems 7, 5. The options parameter sets whether the software DCD algorithm should be used (1) or not (0). Using the software DCD algorithm is strongly recommended for ser12 modems, however with par96 modems it should only be used if there is no hardware DCD signal connected to the par96 modem.

CONSIDERATIONS OF CONFIGURING BAYCOM PORTS
It is important to note that setbaycom merely tells the Linux kernel where it should expect to find the I/O port and IRQ lines of a particular serial port. It does *not* configure the hardware to use a particular I/O port. In order to do that, you will need to physically program the serial board, usually by setting some jumpers or by switching some DIP switches. This section will provide some pointers in helping you decide how you would like to configure your baycom ports. The "standard MS-DOS" port associations are given below:
    COM1, port 0x3f8, irq 4
    COM2, port 0x2f8, irq 3
    COM3, port 0x3e8, irq 4
    COM4, port 0x2e8, irq 3
    LPT1, port 0x378, irq 7
    LPT1 (on hercules graphics adapter), port 0x3bc, irq 7
    LPT1, port 0x278, irq 5

CAUTION
CAUTION: Using an invalid port can lock up your machine.

SEE ALSO
setserial(8), linux/drivers/char/baycom.c

AUTHOR
This version of setbaycom was written by Thomas Sailer (sailer@ife.ee.ethz.ch). Portions are from setserial.