Differences

This shows you the differences between two versions of the page.

--- g6fji:bpq32_cfg_for_abngdn [2023/04/08 16:40] – created g6fji
+++ g6fji:bpq32_cfg_for_abngdn [2024/07/03 08:39] (current) – m0lte
@@ Line 1: / Line 1: @@
-====== Headline ======
+====== Example bpq32.cfg======
-Example node configuration file as at 2022-04-08
+Node configuration file for ABNGDN as at 2022-04-15
+===== Station Context =====
+Linbpq is running on Ubuntu 22.04 LTS on a MacMini.  I installed and built Hamlib from source, then the Direwolf Dev release - you have to install Hamlib first or Direwolf won't include Hamlib Support, and the Dev release is required for IL2P support.  For RF I have:
+  * V/UHF: FTM-300D connected via SignaLink USB for audio and VOX control
+  * HF: IC-705 connected over USB for audio and CAT control
+  * VHF: Tait 2010iI which could be connected over serial and a KISS-mode TNC, but I've run out of aerials!
+I have configured Direwolf to connect to the IC-705 through Hamlib's rigctld rather than direct; this then allows linbpq to control the radio too.  I simply have it set up to switch to the right frequency and mode when the node starts, but it could be used for example to listen on different bands at different parts of the day, or to set a frequency for say Vara HF to connect.
 <code>
-SIMPLE                  ; sets a lot of defaults
+; *************************************************************************************************
-NODECALL=G6FJI          ; Node callsign
+; Global settings
-NODEALIAS=ABNGDN        ; Node alias (6 characters max)
+; *************************************************************************************************
-LOCATOR=IO91iq          ; Maidenhead locator
+SIMPLE
-MAPCOMMENT=Experimental on 144.950        ; should show on the map
+; The configuration command SIMPLE sets the following values:
+; BBS = 1
+; BTINTERVAL = 60
+; BUFFERS = 999
+; C_IS_CHAT = 1
+; FULLCTEXT = 1
+; HIDENODES = 0
+; IDINTERVAL = 10
+; IDLETIME = 900
+; IPGATEWAY = 0
+; L3TIMETOLIVE = 25
+; L4DELAY = 10
+; L4RETRIES = 3
+; L4TIMEOUT = 60
+; L4WINDOW = 4
+; LINKEDFLAG = 'A'
+; MAXCIRCUITS = 128
+; MAXNODES = 250
+; MAXHOPS = 4
+; MAXLINKS = 64
+; MAXROUTES = 64
+; MAXRTT = 90
+; MINQUAL = 150
+; NODE = 1
+; NODESINTERVAL = 30
+; OBSINIT = 6
+; OBSMIN = 5
+; PACLEN = 236
+; AUTOSAVE = 1
+; SAVEMH=1
+; T3 = 180
-AUTOSAVE=1              ; Tells Node to save Nodes and Routes information on closedown
-SAVEMH=1                ; Tells Node to save and restore MH lists when shut down and restarted
-BBS=1                   ; This enables application support.
+NODECALL=G6FJI                           ; Node callsign
-                        ; If your system does not provide access to any application programs, then you could set BBS=0, but leaving it at 1 will do no harm.
+NODEALIAS=ABNGDN                         ; Node alias (6 characters max)
-NODE=1                  ; This allows users to connect to your node, and then connect out to other stations.
+; Shows station on map at http://nodemap.g8bpq.net:81/
-                        ; If NODE=0, then uses will only be able to connect to your applications, and not to the node command handler.
+; Enabled if locator set
+;LOCATOR=IO91iq                           ; Maidenhead locator
+;MAPCOMMENT=Attended Experimental node on 144.950Mhz and 7052.3kHz
-PASSWORD=<set password here>
+AUTOSAVE=1                               ; Tells Node to save Nodes and Routes information on closedown
-EnableEvents=1
+SAVEMH=1                                 ; Tells Node to save and restore MH lists when shut down and restarted
-IDMSG:                              ; UI broadcast text from NODECALL to fixed dest ID
+BBS=1                                    ; This enables application support.
-BPQ node G6FJI/alias ABNGDN martinontheroad@gmail.com  IO91iq. 144.950
+                                         ; If your system does not provide access to any application programs, then you could set BBS=0, but leaving it at 1 will do no harm.
-***                                         ; Denotes end of IDMSG text
-INFOMSG:                            ; The INFO command text follows:
+NODE=1                                   ; This allows users to connect to your node, and then connect out to other stations.
+                                         ; If NODE=0, then uses will only be able to connect to your applications, and not to the node command handler.
-G 6 F J I - BPQ experimental server in Abingdon
+; this should exclude these users from all access - including being recorded from a Nodes broadcast
-===============================================
+; @@@ does't seem to work on Nodes at least
-          Type ? for list of commands.
+; trying to exclude these for example:
+; 2RZCON	VK2RZ
+; 2RZBBS	VK2RZ-1
+; 2RZRMS	VK2RZ-10
+; 2RZCHT	VK2RZ-4
+; 2RZBPQ	VK2RZ-7
+; ATMNOD	VK3ATM-2
+; AYMNOS	VK3AYM
-     N.B. Time quoted by this node is GMT.
+EXCLUDE=K6BDE N2NOV VK2RZ VK3ATM VK3AYM
-***                     ; Denotes end of INFOMSG text
+PASSWORD=<your node sysop password>
+EnableEvents=1                           ; allows certin 'events' to cause an external program to be run
-CTEXT:                              ; The CTEXT text follows:
+IDMSG:                                   ; UI broadcast text from NODECALL to fixed dest ID
+BPQ node G6FJI/alias ABNGDN [email protected]  IO91iq. 144.950 / 7.0523
+***                                      ; Denotes end of IDMSG text
+INFOMSG:                                 ; The INFO command text follows - shown when you type INFO at the node command prompt:
+G6FJI - attended BPQ Node in Abingdon - experimental!
+***                                      ; Denotes end of INFOMSG text
+CTEXT:                                   ; The CTEXT text follows - shown when you connect
 BPQ node G6FJI, alias ABNGDN, run by Martin G6FJI in Abingdon.
 Type  ?  for Help
-***                                 ; Denotes end of CTEXT text
+***                                      ; Denotes end of CTEXT text
-BTEXT:
+; If FULL_CTEXT is set to 1, CTEXT will be sent to all connects. If FULL_CETEXT is set to 0, CTEXT will only be sent to users who connect directly to the Node Alias
+FULL_CTEXT=0
+BTEXT:                                   ; broadcast identifier
 G6FJI/ABNGDN - Node in Abingdon IO91iq. Node=G6FJI/ABNGDN Chat=ABICHT BBS=ABIBBS. Sysop [email protected]
 ***
-;    Network System Parameters.
+; Network System Parameters.
-;
+; There are defaults from John G8BPQ but liase with those running nodes that you link to
-;    These are my values. Many other node sysops use other values. If in doubt, liase with
+OBSINIT=5                                ; INITIAL OBSOLESCENCE VALUE
-;    those running nodes that you link to
+OBSMIN=4                                 ; MINIMUM TO BROADCAST
+NODESINTERVAL=45                         ; 'NODES' INTERVAL IN MINS
-OBSINIT=5               ; INITIAL OBSOLESCENCE VALUE
+L3TIMETOLIVE=25                          ; MAX L3 HOPS
-OBSMIN=4                ; MINIMUM TO BROADCAST
+L4RETRIES=4;                             ; LEVEL 4 RETRY COUNT
-NODESINTERVAL=45        ; 'NODES' INTERVAL IN MINS
+L4TIMEOUT=60;                            ; LEVEL 4 TIMEOUT
+L4DELAY=10                               ; LEVEL 4 DELAYED ACK TIMER
+L4WINDOW=4                               ; DEFAULT LEVEL 4 WINDOW
-L3TIMETOLIVE=25         ; MAX L3 HOPS
+; @@@ Seems to work but...
-L4RETRIES=4;            ; LEVEL 4 RETRY COUNT
+; - How does this interact with quality and minqual in port config?
-L4TIMEOUT=60;           ; LEVEL 4 TIMEOUT
+; - it doesn't always work!  I have 5 nodes from NBA with qual 3 or 4
-L4DELAY=10              ; LEVEL 4 DELAYED ACK TIMER
+MINQUAL=35                               ; MINIMUM QUALITY TO ADD TO NODES TABLE
-L4WINDOW=4              ; DEFAULT LEVEL 4 WINDOW
+                                         ; was 140 but that excludes most of NBA broadcast!
-MINQUAL=35              ; MINIMUM QUALITY TO ADD TO NODES TABLE
-                        ; was 140 but that excludes most of NBA broadcast!
-                        ; @@@ Seems to work but...
-                        ; - How does this interact with quality and minqual in port config?
-                        ; - it doesn't always work!  I have 5 nodes from NBA with qual 3 or 4
-;    The following MAX params set the limits for various tables.
+; The following MAX params set the limits for various tables.
 ;
-;    Although significantly larger values can be used, a common area is used
+; Although significantly larger values can be used, a common area is used
-;    for these tables and the buffer pool, so don't increase them more than
+; for these tables and the buffer pool, so don't increase them more than
-;    necessary.
+; necessary.
-MAXLINKS=100            ; MAX LEVEL 2 LINKS (UP,DOWN AND INTERNODE)
+MAXLINKS=100                             ; MAX LEVEL 2 LINKS (UP,DOWN AND INTERNODE)
-MAXNODES=300            ; MAX NODES IN SYSTEM
+MAXNODES=300                             ; MAX NODES IN SYSTEM
-MAXROUTES=30            ; MAX ADJACENT NODES
+MAXROUTES=30                             ; MAX ADJACENT NODES
-MAXCIRCUITS=150         ; NUMBER OF L4 CIRCUITS
+MAXCIRCUITS=150                          ; NUMBER OF L4 CIRCUITS
-BUFFERS=999             ; PACKET BUFFERS - 999 MEANS ALLOCATE AS MANY
+BUFFERS=999                              ; PACKET BUFFERS - 999 MEANS ALLOCATE AS MANY
-                        ; AS POSSIBLE - NORMALLY ABOUT 600, DEPENDING
+                                         ; AS POSSIBLE - NORMALLY ABOUT 600, DEPENDING
-                        ; ON OTHER TABLE SIZES
+                                         ; ON OTHER TABLE SIZES
-; docs:
+; Rig Control - see https://www.cantab.net/users/john.wiseman/Documents/RigControl.html
-; https://www.cantab.net/users/john.wiseman/Documents/BPQCFGFile.html##Port
+; RADIO NUMBER [DEBUG] [AUTH Passcode] PORT SPEED MAKE MODEL [CI-V Addr] [PTTMUX COMn] [PTT_SETS_INPUT] [DATAPTT] [HAMLIB=PORT]
+; NUMBER is used to link a RADIO definition with one or more PORT definitions.
+; DEBUG enables logging of Rigcontrol actions to the system debug log, and shouldn't normally be used.
+; AUTH Passcode enables authenticated access to the Rigcontrol module over the network. Normally only applications on the same machine can use rigcontrol.
+; PORT and SPEED are normally Serial Port Name and Baud Rate for Serial Interfaces. See here for info on defining a CM108 PTT interface.
+; To use HAMLIB's rigctld replace PORT SPEED MAKE MODEL with HAMLIB HostIPAddr:Port, eg HAMLIB 127.0.0.1:4532
+; To use FLRIG replace PORT SPEED MAKE MODEL with FLRIG HostIPAddr:Port, eg FLRIG 127.0.0.1:12345
+; FTM-300D - uses vox, not controllable here
+;RADIO 1
+;****
+; IC-705 - uses Hamlib and CI-V controls
+; rigctl settings would be
+; freq: F 7052300
+; mode: M PKTUSB 2400
+; scan definitions use comma-separated but no space in definitions
+;  dwell time in seconds
+;  F in MHZ
+;  Mode
+;  Bandwidth (not documented)
+RADIO 2
+ DEBUG
+ HAMLIB 127.0.0.1:4532
+,7.052300,PKTUSB,2400
+****
+; Tait 2010ii - connected via TNC in kiss mode, not controllable here
+;RADIO 3
+;****
+; *************************************************************************************************
+; Individual Port Settings
+; documnetatation at https://www.cantab.net/users/john.wiseman/Documents/BPQCFGFile.html##Port
+; *************************************************************************************************
 PORT
   PORTNUM=1
-  ID=VHF
+  ID=VHF 2m
+  INTERLOCK=1                            ; needed if rig control enabled
+                                         ; ports that use the same rig need the same interlock group
+  QUALITY=192                            ; quality for nodes heard on this port
+  MINQUAL=10                             ; min quali for nodes broadcast
+  ; this port is using a KISS modem over TCP
   TYPE=ASYNC
   PROTOCOL=KISS
   IPADDR=127.0.0.1
   TCPPORT=8001
-  DIGIFLAG=1            ; 0 = dont digi, 1 = digi everything, 255 = digi UI frames only.
-  DIGIPORT=0            ; Port to send digied frames on. Zero means the port it was received on, any other number means send on that port.
-  PACLEN=150            ; from GB7RDG settings - max is 236?
-  ; Tuning for SignaLink USB
-  DWAIT=0
-  SLOTTIME=100
-  PERSIST=63
-  TXDELAY=150
-  TXTAIL=50
-  FULLDUP=0
-  QUALITY=192           ; quality for nodes heard on this port
+  ; This tells the modem what channel (ie radio) to use
-  MINQUAL=10            ; min quali for nodes broadcast
+  ; Direwolf puts channels A&B on first sound card, C&D on second - stereo inputs can support two
+  CHANNEL=A
+  DIGIFLAG=1                             ; 0 = dont digi, 1 = digi everything, 255 = digi UI frames only.
+  DIGIPORT=0                             ; Port to send digied frames on. Zero means the port it was received on, any other number means send on that port.
+  ; Tuning for SignaLink USB on VHF
+  RETRIES=4                              ; Level 2 maximum retry value
+  PACLEN=150                             ; max is 255 but also depends on other nodes along the link
+  SLOTTIME=100                           ; CSMA interval timer, ms
+  PERSIST=63                             ; Probability to transmit (out of 255)
+  TXDELAY=150                            ; keyup delay in ms
+  TXTAIL=50                              ; Passed to Kiss TNCs - try 50-100 on HF if trouble decoding
+  FULLDUP=0                              ; Passed to Kiss TNCs - just ignore!
+  ; Could set a default application to connect to on this port
+  ; APPL BBS                             ; Autoconnect to BBS Application
 ENDPORT
 PORT
   PORTNUM=2
+  ID=HF 40m
+  INTERLOCK=2                            ; seems to be needed if rig control enabled
+                                         ; ports that use the same rig need the same interlock group
+  QUALITY=192                            ; quality for nodes heard on this port
+  MINQUAL=140                            ; min quali for nodes broadcast - set high for HF to reduce chatter
+  ; this port is using a KISS modem over TCP
+  TYPE=ASYNC
+  PROTOCOL=KISS
+  IPADDR=127.0.0.1
+  TCPPORT=8001
+  ; This tells the modem what channel (ie radio) to use
+  ; Direwolf puts channels A&B on first sound card, C&D on second - stereo inputs can support two
+  CHANNEL=C
+  ; BPQ has rig control!
+  RADIO=2                                ; use IC-705; must setup interlock if used
+  ; could use different radios for tx and rx
+  ;TXRADIO=1
+  ;RXRADIO=3
+  DIGIFLAG=1                             ; 0 = dont digi, 1 = digi everything, 255 = digi UI frames only.
+  DIGIPORT=0                             ; Port to send digied frames on. Zero means the port it was received on, any other number means send on that port.
+  ; Needs tuning for HF on IC-705
+  ; Tuning for SignaLink USB
+  RETRIES=5                              ; Level 2 maximum retry value
+  PACLEN=80                              ; shorter is better on HF but not too short
+  SLOTTIME=100                           ; CSMA interval timer, ms
+  PERSIST=63                             ; Probability to transmit (out of 255)
+  TXDELAY=150                            ; keyup delay in ms
+  TXTAIL=100                             ; Passed to Kiss TNCs - try 50-100 on HF if trouble decoding
+  FULLDUP=0                              ; Passed to Kiss TNCs - just ignore!
+ENDPORT
+PORT
+  PORTNUM=3
   ID=Telnet
+  INTERLOCK=3                            ; seems to be needed if rig control enabled - though shouldn't matter for Telnet!
+                                         ; ports that use the same rig need the same interlock group
+  QUALITY=201                            ; quality for nodes heard on this port
+  MINQUAL=10                             ; min quali for nodes broadcast
+  ; driver line has to be before CONFIG
+  ; Documentation: https://www.cantab.net/users/john.wiseman/Documents/TelnetServer.htm
   DRIVER=Telnet
-  QUALITY=201
-  MINQUAL=142
+  CONFIG                                 ; "Driver-Specific Configuration" - everything between here and ENDPORT
-  CONFIG
+  SECURETELNET=1                         ; otherwise there is a gaping security hole
-  LOGGING=1
+  DisconnectOnClose=0                    ; 1 = closes window when you bye
-  DisconnectOnClose=0   ; 1 = closes window when you bye
   TCPPORT=8010
   FBBPORT=8011
@@ Line 117: / Line 267: @@
   LOGINPROMPT=user:
   PASSWORDPROMPT=password:
   MAXSESSIONS=10
-  RELAYAPPL=BBS         ; or RMS
+  LOGGING=1                              ; only an option for telnet
   CTEXT=Welcome to G6FJI Telnet Server\n Enter ? for list of commands\n\n
-  USER=G6FJI,<set telnet password here>,G6FJI,,SYSOP        ; sysop flag here gives user more commands!
+  USER=G6FJI,<your node telnet password<,G6FJI,,SYSOP
+  ; for RMS / WinLink.  Default server can be overridden
+  ; see also https://www.cantab.net/users/john.wiseman/Documents/PATSupport.html
+  ; CMSSERVER=cms.winlink.org
   CMS=1
   CMSCALL=G6FJI
-  CMSPASS=<winlink password here if used>
+  CMSPASS=<your winlink password>
+  CMSLOGGING=1
-  CMDPORT 63000 63001       ; zero-based list of TCP ports referenced in HOST parameter of custom applications
+  ; See https://www.cantab.net/users/john.wiseman/Documents/TelnetServer.htm#:~:text=10%2CBPQRMS%2C255-,RMS%20Relay%20Emulation
+  RELAYAPPL=BBS                          ; or RMS
+  CMDPORT 63000 63001                    ; custom application ports
 ENDPORT
+; Example for AXIP linking - not tested by G6FJI
 ;PORT
-; PORTNUM=3
+; PORTNUM=N
 ; ID=AXIPUDP
-; DRIVER=BPQAXIP            ; Uses BPQAXIP.DLL
+; DRIVER=BPQAXIP                           ; Uses BPQAXIP.DLL
-; QUALITY=200               ; Quality factor applied to node broadcasts heard on
+; QUALITY=200                              ; Quality factor applied to node broadcasts heard on
-;                           ; this port, unless overridden by a locked route
+;                                          ; this port, unless overridden by a locked route
-;                           ; entry. Setting to 0 stops node broadcasts
+;                                          ; entry. Setting to 0 stops node broadcasts
-; MINQUAL=0                 ; Entries in the nodes table with qualities greater or
+; MINQUAL=0                                ; Entries in the nodes table with qualities greater or
-;                           ; equal to MINQUAL will be sent on this port. A value
+;                                          ; equal to MINQUAL will be sent on this port. A value
-;                           ; of 0 sends everything.
+;                                          ; of 0 sends everything.
-; MAXFRAME=7                ; Max outstanding frames (1 thru 7)
+; MAXFRAME=7                               ; Max outstanding frames (1 thru 7)
-; FRACK=7000                ; Level 2 timout in milliseconds
+; FRACK=7000                               ; Level 2 timout in milliseconds
-; RESPTIME=1000             ; Level 2 delayed ack timer in milliseconds
+; RESPTIME=1000                            ; Level 2 delayed ack timer in milliseconds
-; RETRIES=10                ; Level 2 maximum retry value
+; RETRIES=10                               ; Level 2 maximum retry value
-; UNPROTO=ID                ; BTEXT broadcast addrs format: DEST[,digi1[,digi2]]
+; UNPROTO=ID                               ; BTEXT broadcast addrs format: DEST[,digi1[,digi2]]
-; ;BCALL=NOCALL             ; BTEXT call. unstated defaults to APPL1CALL
+; ;BCALL=NOCALL                            ; BTEXT call. unstated defaults to APPL1CALL
 ;CONFIG
-; UDP 10093                 ;Listens for UDP packets on this UDP port number
+; UDP 10093                                ;Listens for UDP packets on this UDP port number
 ; UDP 10092
 ; MHEARD ON
@@ Line 156: / Line 316: @@
 ;ENDPORT
+; *************************************************************************************************
+; Global settings that came after nodes
+; *************************************************************************************************
 LINMAIL
 LINCHAT
@@ Line 164: / Line 327: @@
 ; You can now also specify MAXFRAME, FRACK, PACLEN (in that order) to override the port defaults.
 ; Examples
-; AE5E-14,200,2,0,0,0,2         ; No Keepalives
+; AE5E-14,200,2,0,0,0,2                    ; No Keepalives
-; G4RFG,0,1                    ; Marginal, So lock out by setting QUALITY = 0
+; G4RFG,0,1                                ; Marginal, So lock out by setting QUALITY = 0
-; G0GDR-1,100,2,1,6000,100 ; not always very good, so MAXFRAME = 1
+; G0GDR-1,100,2,1,6000,100                 ; not always very good, so MAXFRAME = 1
 ;
 ; MB7NBA is good,on port 1 (RF)
@@ Line 173: / Line 336: @@
 ; Applications
+; For walkthrough of adding custom applications see https://wiki.oarc.uk/packet:linbpq_custom_applications
 ; https://www.cantab.net/users/john.wiseman/Documents/LinBPQ%20Applications%20Interface.html
 ; APPLICATION n,CMD,New Command,Call,Alias,Quality,L2Alias
@@ Line 182: / Line 346: @@
 ; Alias,Quality (optional) If specified, causes an entry for Call and Alias to be added to your NODES table with the specified Quality
 ; L2Alias (optional)is an additional Alias for direct (L2) connects to the Node.
-; See also https://wiki.oarc.uk/packet:linbpq_custom_applications for more details
 APPLICATION 1,BBS,,G6FJI-2,ABIBBS,254
 APPLICATION 2,CHAT,,G6FJI-1,ABICHT,254
 APPLICATION 3,HARS,C 1 HARS S
-APPLICATION 4,PADDLE,C 2 HOST 0 S,G6FJI
+APPLICATION 4,PADDLE,C 3 HOST 0 S,G6FJI
-APPLICATION 5,HELLO-WORLD,C 2 HOST 1 S,G6FJI
+APPLICATION 5,HELLO-WORLD,C 3 HOST 1 S,G6FJI
 </code>