home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
HAM Radio 3
/
hamradioversion3.0examsandprograms1992.iso
/
bbs
/
bpq402a
/
ports.doc
< prev
next >
Wrap
Text File
|
1990-10-16
|
10KB
|
388 lines
Configuration file - BPQCFG.TXT
PORTS Section.
This section of the configuration file defines the links from the switch
to the outside world. These will normally be Radio links, but could also
be a link to another computer running another copy of the switch, or similar
software (eg NOS).
Please note that there is no relationship between the 'Virtual' COM ports
defined in the TNCPORT section, which are used by the BBS or other program
running abouve the switch, and these external links. You may use your
'real' COM1 port to connect to a KISS TNC, even if you have defined a
'Virtual' COM1 in the TNCPORT section.
There are two basic classes of links supported by the switch. One uses
normal ASYNC ports to communicate with TNCs running in KISS mode, and the
other uses special HDLC cards which fit inside the PC. ASYNC links are
supported , and interface to
the radio via either an inbuilt or external modem. Those currently supported
are the PacCom PC120, DRSI PC-PA, and Thor RLC100.
Interrupt levels may be shared by any cards with suitable hardware.
Examples are all but the earliest DRSI cards, and a MS400 ASYNC card
modified as described by AA4RE in his MBBIOS documentation. However
there is a significant overhead in using the shared interrupt feature
- try to use it on relatively low speed links, and watch out for TX
underruns/RX overuns.
Each port is defined by a set of statements of the form:
PORT
PARAM=VALUE
..
..
ENDPORT
Samples of various configurations are given later, but the full list
of PARAM values supported is given below
PORTNUM=n ; Number for use in PORTS display, connects, etc.
; Default is next sequential number.
ID=text string *; Up to 30 chars, appears on PORTS display
TYPE=ASYNC/DRSI/PC120/RLC100/QUAD/INTERNAL *
; ASYNC is for a normal ASYNC card, or a shared interrupt card
; such as the MS400
; PC120, DRSI and RLC100 are the internal HDLC cards - and
; support 2 channels.
; QUAD is the Quadram Quadport, which allows up to 5 async
; links. This version only supports a single Quadport. See
; later section for setup details.
; INTERNAL defines a 'loopback' port - anything
; sent on it will be received.Intended to allow KISS
; applications (eg TCP/IP) to talk to the switch.
PROTOCOL=HDLC/KISS/ASYNC/MULTIKISS *
; ASYNC is NETROM backend link
; MULTIKISS is for multidropped KISS TNCs on one port, and
; needs special ROMS (JKISSP), and a diode coupler.
IOADDR=xxxH * ; in hex, H is needed
INTLEVEL=n * ; 2,3,4,5 or 7 - supports shared interrupt cards
SPEED=nnnn * ; Radio speed for DRSI, etc, async link speed for KISS
; If set to zero, the modem must supply a 1x clock.
; (TXC on RTXC pin, RXC on TRXC pin.)
CHANNEL=A/B/..* ; Selects port on DRSI/PC120, dual port KISS (eg KPC4) or
; MULTIKISS
BBSFLAG=NOBBS ; Stops direct connects to the BBS on this port
QUALITY=nnn * ; Default quality for nodes heard on this port. Set to zero
; to suppress NODES broadcasts on this port.
MAXFRAME=n * ; Maximum outstanding frames
TXDELAY=nnn * ; TX Keyup delay in milliseconds
SLOTTIME=100 * ; CSMA interval timer (milliseconds)
PERSIST=nnn * ; 'Probability to transmit' value (1-255)
FULLDUP=0/1 ; currently only used by KISS driver
SOFTDCD=0/1 ; not yet supported
TXTAIL=nnnn ; TXTAIL timer in ms. Used only by KISS TNCs
FRACK=nnnn * ; Level 2 timout in milliseconds
RESPTIME=nnnn * ; Level 2 delayed ack timer in milliseconds
RETRIES=n * ; Level 2 maximum retry value
PACLEN=nnn * ; default maximum packet length for this port
CWID=CALL ; Currently only supported on DRSI/PC120/RLC100
PORTCALL=CALL ; Additional callsign/alias for level 2 connects to the
PORTALIAS=ALIAS ; node for this port. Should not be the same as BBSCALL
ALIAS_IS_BBS=0/1; If set then PORTCALL and PORTALIAS give access to the BBS
; rather than the node.
VALIDCALLS=CALLS; Up to about 40 callsigns, separated by a single commas.
; If present, only stations in the list will be allowed
; to connect to you on this port. The SSID should not
; be specified, and multiple VALIDCALLS lines may be
; included. End all but he last line with commas. The
; total length of the list, including commas, as 256 bytes.
QUALADJUST=NNN ; Percentage to reduce the quality of a NODE in the NODES
; broadcast, if the best neighbour is on the same port as
; the broadcast. Designed to improve throughput if more than
; one channel is available, by discouraging routes which
; cause a node to send a packet on the same port that it
; received it on.
DIGIFLAG=0/1/255; Digipeat control flag for this port
; 0 = dont digi, 1 = digi everything, 255 = digi UI frames only
DIGIPORT=N ; Port to send digied frames on. Zero means the port it was
; received on, any other number means send on that port.
; This is intended mainly to allow a BBS on another machine,
; connected via a wire link, to send out 'MAIL FOR' messages.
USERS=N ; This limits the number of L2 sessions to the supplied
; number. Zero means no limit. The limit applies to all
; L2 sessions (even those with other nodes), but is only
; checked for incoming connects (ie you can make outgoing
; connects even when the limit is reached). Intended mainly
; to control the number of users on busy user access ports
; (especially 2m)
UNPROTO= ; Unproto destination and digi string for this port.
; Use commas between calls, and dont include the VIA.
L3ONLY=0/1 ; If set, will stop users (but not HOST sessions) issuing
; downlink connects on this port.
INTERLOCK=n ; Allows groups of ports to be defined which will not transmit
; at the same time. A value of zero indicates no locking, if
; any other value is specifed the code will make sure that no
; two ports with the same value can transmit at the same time.
Those marked with a * must be included, the rest are optional. The validation
is not good, and defaults are generally zero, so if you miss out any of the
essential ones, odd things may well happen!
Sample PORT Configurations:
1. 2 Port DRSI card set for IO addr = 300h, int level 5
PORT
ID=144.650 MHz 1200 Baud
TYPE=DRSI
PROTOCOL=HDLC
IOADDR=300H
INTLEVEL=5
SPEED=1200
CHANNEL=A
QUALITY=10
MAXFRAME=1
TXDELAY=500
SLOTTIME=100
PERSIST=64
FULLDUP=0
SOFTDCD=0
FRACK=7000
RESPTIME=2000
RETRIES=10
PACLEN=120
CWID=G8BPQ
ENDPORT
;
PORT
ID=432.675 MHz 1200 Baud
TYPE=DRSI
PROTOCOL=HDLC
IOADDR=300H
INTLEVEL=5
SPEED=1200
CHANNEL=B
BBSFLAG=NOBBS ; IF MY BBS LICENCE IS ONLY FOR 2M
QUALITY=10
MAXFRAME=1
TXDELAY=500
SLOTTIME=100
PERSIST=64
FULLDUP=0
SOFTDCD=0
FRACK=6000
RESPTIME=1500
RETRIES=10
PACLEN=120
CWID=G8BPQ
PORTCALL=G8BPQ
PORTALIAS=NOTTM
;
ENDPORT
2. Standard KISS TNC on primary ASYNC card. (COM1). To use the secondary
ASYNC card (COM2), change IOADDR to 2F8H, and the INTLEVEL to 3.
PORT
ID=144.650 Mhz 1200 Baud
TYPE=ASYNC
PROTOCOL=KISS
IOADDR=3F8H
INTLEVEL=4
SPEED=9600
CHANNEL=A
QUALITY=10
MAXFRAME=2
TXDELAY=500
SLOTTIME=100
PERSIST=64
FULLDUP=0
FRACK=7000
RESPTIME=2000
RETRIES=10
PACLEN=120
ENDPORT
The second port of a multiport TNC (Such as the KAM or KPC 4) is defined as
follows:
ID=432.675 Mhz 1200 baud
TYPE=ASYNC
PROTOCOL=KISS
IOADDR=3F8H
INTLEVEL=4
SPEED=2400
CHANNEL=B
QUALITY=10
MAXFRAME=2
TXDELAY=500
SLOTTIME=100
PERSIST=64
FULLDUP=0
FRACK=7000
RESPTIME=2000
RETRIES=10
PACLEN=120
QUALADJUST=5
ENDPORT
3. Quadram Quadport.
The Quadram Quadport card supports up to 5 (yes I know it says quadport!!)
async ports. This version only supports one card - if anyone needs more,
let me know. You do not need to define all ports, but you must start with
the first, and not leave any gaps.
The card should be configured with first port at 280h, and software
selectable interrupts (3 or 4 may be used)
The card will support KISS TNCS (either normal, or KPC4 type dual port), or
NETROM links (or a combination of both).
The following sample config file is for a Dual Port KPC4 on channel 1,
a normal KISS TNC on channel 2, and a NETROM async link on channel 3.
PORT
ID=KPC4 PORT 1
TYPE=QUAD
PROTOCOL=KISS
IOADDR=280H
INTLEVEL=3
SPEED=2400
CHANNEL=A
QUALITY=10
MAXFRAME=2
TXDELAY=500
SLOTTIME=100
PERSIST=64
FULLDUP=0
FRACK=7000
RESPTIME=2000
RETRIES=10
PACLEN=120
ENDPORT
PORT
ID=KPC4 PORT 2
TYPE=QUAD
PROTOCOL=KISS
IOADDR=280H
INTLEVEL=3
SPEED=2400
CHANNEL=B
QUALITY=10
MAXFRAME=2
TXDELAY=500
SLOTTIME=100
PERSIST=64
FULLDUP=0
FRACK=7000
RESPTIME=2000
RETRIES=10
PACLEN=120
ENDPORT
PORT
ID=NORMAL KISS
TYPE=QUAD
PROTOCOL=KISS
IOADDR=290H
INTLEVEL=3
SPEED=2400
CHANNEL=A
QUALITY=10
MAXFRAME=2
TXDELAY=500
SLOTTIME=100
PERSIST=64
FULLDUP=0
FRACK=7000
RESPTIME=2000
RETRIES=10
PACLEN=120
ENDPORT
PORT
ID=NETROM BACKEND
TYPE=QUAD
PROTOCOL=NETROM
IOADDR=2A0H
INTLEVEL=3
SPEED=2400
CHANNEL=A
QUALITY=10
MAXFRAME=2
TXDELAY=500 ; THESE AREN'T USED, BUT I SUGGEST
SLOTTIME=100 ; YOU PUT THEM IN IN CASE ONE DAY
PERSIST=64 ; THEY ARE!
FULLDUP=1 ;
SOFTDCD=0
FRACK=7000
RESPTIME=2000
RETRIES=10
PACLEN=120
ENDPORT