home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Monster Media 1994 #1
/
monster.zip
/
monster
/
HAM
/
BPQ407A.ZIP
/
PORTS.DOC
< prev
next >
Wrap
Text File
|
1993-11-25
|
13KB
|
553 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, and interface to
the radio via either an inbuilt or external modem. Those currently supported
are the PacCom PC120, DRSI PC-PA, Thor RLC100, Baycom USCC-Karte and
OptoPcSCC.
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/EXTERNAL/BAYCOM/PA0HZP *
Hardware type.
ASYNC is for a normal ASYNC card, or a shared interrupt card
such as the MS400
PC120, DRSI, RLC100, BAYCOM, PA0HZP are the internal HDLC cards,
the first two support up to two channels, the others up to 4.
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.
EXTERNAL defines a user-supplied hardware driver.
PROTOCOL=HDLC/KISS/NETROM *
Protocol to be used on the link.
NETROM is to connect to the async port of a real NETROM
KISS is to connect to a KISS TNC
IOADDR=xxxH *
The base I/O address for the card. In hex, H is needed
INTLEVEL=n *
The interrupt level to be used. Any spare level may be used, up to
7 on an 8 bit machine, or 15 on a 16 bit machine. More than one card
may share a level if the hardware has the necessary logic. Also used
to define the software interrupt for EXTERNAL drivers.
SPEED=nnnn *
The radio speed for HDLC cards, or the async link speed for KISS
and NETROM links. 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 HDLC cards, dual port KISS (eg KPC4) or Multidropped KISS
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
all level 3/4 activity (including 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
Passed on to TNC if using KISS. Used to allow transmission whilst DCD
is active on HDLC cards, and to allow connection of a NETROM cluster
via a diode matrix.
SOFTDCD=0/1
If set to 1, system uses the detection of a valid frame to indicate that
the channel is busy, rather than the DCD signal from the modem. Used
only for HDLC cards.
TXTAIL=nnnn
TXTAIL timer in ms. Used only by KISS TNCs. If running on HF at 300 baud,
the default is probably too short. If others have trouble copying your
frames, try a value of 50 - 100.
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
Only used on HDLC cards. CWID is sent every 29 mins.
CWIDTYPE=ONOFF
Send CWID using ON-OFF Keying. Without this param, the CWID will be sent
using normal modem tones. This is fine for low speed links, but faster
modems (eg the G3RUH) include scramblers which make it impossible to read
the CW. Note that the TX must have a pretty fast keying characteristic
to work with ON-OFF keying - certainly < 20mS.
PORTCALL=CALL
PORTALIAS=ALIAS
Additional callsign/alias for level 2 connects to the node for this port.
Should not be the same as BBSCALL
ALIAS_IS_BBS=0/1
If set then PORTCALL and PORTALIAS access the BBS instead of the node.
VALIDCALLS=CALLS
Up to about 40 callsigns, separated by 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 the last line with commas. The total length of the
list, including commas, is 256 bytes.
MINQUAL=NNN
Defines the minimum quality for a destination to be included in a
'Nodes' broadcast on this port.
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. Only valid on HDLC cards.
TXPORT=n
Allows frames for this port to be transmitted on a different port.
This is for use when you are operating a central node, with a single
transmitter, and a number of receivers.
MHEARD=Y/N
Enables or disables the MHEARD function on this port. There is a slight
overhead in maintaining the MHEARD list, so if it is not needed (eg on
an internode port) it may be disabled. Default is enabled.
KISSOPTIONS=POLLED,CHECKSUM,ACKMODE,SLAVE
These select my extended KISS mode.
These extended KISS options are supported by my BPQKISS EPROM for
the TNC2 and clones, and by special EPROMS for the KPC2, KPC4 and
KAM, available from Kantronics.
POLLED selects multi-dropped mode, where the TNC only
transmits when requested (Polled) by the PC. This allows
several TNCs to share an async port without any risk of
collisions.
CHECKSUM selects a mode where a checksum byte is appended
to each data message, and checked by the other end. This
reduces the risk of data corruption if errors occur on the
link from PC to TNCs. It may be used on its own, but should
always be used if POLLED mode is selected.
ACKMODE enables the transmission of 'ACK required' frames.
These cause the TNC to send a reply when the frame has been
transmitted. This will improve link performance by avoiding
the possibility of a retry being sent before the original
frame has even left the TNC. This mode should always be used
if the TNC support it.
SLAVE allows a PC to be multidropped along with one or more
KISS TNCs on a multidropped link. If you use SLAVE, you shouldn't
set POLLED, and you shouldn't use ACKMODE on either end.
Parameters 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 ; THIS IS NOW NEEDED FOR A SINGLE NETROM
; TNC. SET TO 0 IF USING A DIODE MATRIX.
SOFTDCD=0
FRACK=7000
RESPTIME=2000
RETRIES=10
PACLEN=120
ENDPORT
4. Baycom USCC.
This card has 4 ports, two running at 1200 (Ports A and B), one
TTL port (Port C), and one G3RUH compatible 9600 bps port (Port D).
The configuration is similar to the DRSI, except that port D should
have SPEED=0 (Not SPEED=9600).
John Wiseman, G8BPQ
13/9/93