User Tools

Site Tools


bpq_bbs_software

BPQ BBS Software

This page talks about getting an initial installation of BPQ working with Direwolf on a Raspberry Pi as described in APRS & Packet Radio pages.

Once this file is updated and BPQ is restarted (sudo systemctl restart direwolf.service), most other updates should be made with either the installed applications (Windows) or the web server (Linux). This includes configurations for modules (e.g., BBS and CHAT), since the configuration file options are not documented.

To access the web configuration tool on Linux, you'll need the IP address or hostname and port (HTTPPORT below) to enter into a browser. For example, I use another system, open a browser, and go to http://packet.local:8008 .

Windows vs. Linux

LINBPQ (for Linux)

Download and run BPQ Config

Automatic installer for LINBPQ. Use arrow keys, tab, and enter to navigate the interface.

  • mkdir ~/linbpq
  • cd ~/linbpq
  • chmod +x bpq-config
  • sudo ./bpq-config
  • If asked about installing telnet or minicom, choose Install.
  • If notified that the serial port must be enabled, choose Enable.
  • If notified that bluetooth must be disabled, that is no longer true, but there's no other option other than Disable in order to continue the installation.
  • If notified that serial getty must be disabled, choose Disable.
  • Reboot if asked.
    • Log back in.
    • cd ~/linbpq
    • sudo ./bpq-config
  • Expert Install
  • Download BPQ
  • Configure BPQ
  • Node Configuration
    • Node callsign: Your callsign with no SSID
    • Owner acryonym: Something unique, probably the last three characters of your callsign
    • Owner name: Your name
    • Leave the rest alone for now, unless you really know what you're doing with TCP ports.
    • WinLink RMS (at bottom): No
    • Chat server: Yes, probably
    • APRS iGate: No
    • Finish
  • Port configuration
    • Add port
    • Type: Packet
    • Device type: Serial
    • Device number: 0
    • Speed: Usually 1200, as most packet users don't use 9600 for general use.
    • Frequency: Packet frequency with no decimal. For Wisconsin, 145030
    • Digipeat: Yes
    • WL2K: No
    • Finish
    • Finish
  • Telnet users
    • Add user
    • Username: Your real name, probably just first name?
    • Password: Unique password. Don't reuse a password from elsewhere as they aren't stored securely.
    • Application: Leave alone (Node)
    • SysOp: Yes
    • Finish
  • Write configuration
  • Yes
  • Enable BPQ start at boot
  • Finish

Installing LINBPQ Manually

:!: If BPQ Config successfully downloaded, skip these steps.

Basic bpq32.cfg Config File Setup

  • Edit ~/linbpq/bpq32.cfg. If you don't have a preferred editor, use nano or the GUI text editor.
    • nano bpq34.cfg
    • Raspberry menu → Accessories → Text Editor

In the sections below, the format is generally PARAMETER=SETTING in all caps. Where the Setting shows N/A, then there is no equals sign or setting, just PARAMETER. Comments can be placed after a semicolon.

These are not an exhaustive list of settings, but merely enough to get a working node operational.

Sample file: bpq32.zip

General (top) Section

Parameter Setting Notes
SIMPLE N/A First line of your config file. Sets some reasonable default parameters.
NODECALL CALL-7 Your callsign with -7 (or whatever your area standard SSID is for a node.
LOCATOR XXnnXX Your maidenhead grid.
LINMAIL N/A Enables the BBS module.
LINCHAT N/A Enables the chat module.

Messages Section

Parameter Setting Notes
IDINTERVAL 30 How often the IDMSG gets broadcast in minutes. The default 10 minutes is a bit chatty.
IDMSG Name CALL. CALL-1/B CALL-7/N CALL-11/C 120 character broadcast for your station. Watch for packets in your area and see what is common. The example is what I use in SE Wisconsin.
CTEXT abcdef Leave what is here as default or change to your liking. This tells a connecting user what commands are available to them.
BTINTERVAL 30 How often the IDMSG gets broadcast in minutes. The default 10 minutes is a bit chatty.
BTEXT Name CALL. CALL-1/B CALL-7/N CALL-11/C 120 character broadcast for your station. Watch for packets in your area and see what is common. The example is what I use in SE Wisconsin.
INFOMSG abcdef I just leave this as the default.

Ports Section

Start and end ports with a port declaration.

Virtual TNC Port

This is a virtual TNC that you can connect to with a terminal program like minicom.

Format is:

TNCPORT
  PARAMETER=SETTING
  PARAMETER=SETTING
ENDPORT
Parameter Setting Notes
COMPORT /home/<yourusername>/linbpq/com10 Enter your username. If unsure of this setting, type the command 'ls -d ~'
TYPE TNC2
APPLNUM 32
APPLFLAGS 6
CONOK 1 Add this. !FIXME! I don't know what it does.
AUTOLF 1 Add this. Adds line feed for when you connect to the virtual TNC with minicom.
ECHO 1 Add this. Echos your typing back to you for when you connect to the virtual TNC with minicom.
Port 1 (VHF)

This will be your VHF port to your radio. Convention in Wisconsin is port #1.

Format is:

PORT
  PARAMETER=SETTING
  PARAMETER=SETTING
ENDPORT

:!: Remove the COMPORT and SPEED parameters and replace them with the IPADDR and TCPPORT parameters.

Parameter Setting Notes
PORTNUM 1
ID 145.030 MHz 1200 bps
TYPE ASYNC
IPADDR 127.0.0.1
TCPPORT 8001
PROTOCOL KISS
KISSOPTIONS PITNC,NOPARAMS
CHANNEL A
MAXFRAME 2
FRACK 7000
RESPTIME 1000
RETRIES 10
PACLEN 128
TXDELAY 500
SLOTTIME 100
PERSIST 64
DIGIFLAG 1
Port 2 (telnet/web)

This will be your telnet and webserver port (!FIXME! and whatever FBB is?).

Format is:

PORT
  PARAMETER=SETTING
  PARAMETER=SETTING
ENDPORT
Parameter Setting Notes
PORTNUM 2
ID Telnet Server
DRIVER TELNET
CONFIG N/A
LOGGING 1
DisconnectionOnClose 1
TCPPORT 8010
FBBPORT 8011
HTTPPORT 8008
LOGINPROMPT user:
PASSWORDPROMPT password:
LOCALECHO NO
MAXSESSIONS 10
CTEXT AAA BPQ32 Telnet Server\nEnter ? for a list of commands\n\n Change AAA to your Owner Acronym from bpq-config
USER name,password,callsign,type,sysop
Port 4 (AX/IP/UDP)

:!: This port comment and PORTNUM parameter is 3 by default.

This will be your AX/IP/UDP port. Convention in Wisconsin is port #4.

Format is:

PORT
  PARAMETER=SETTING
  PARAMETER=SETTING
ENDPORT
Parameter Setting Notes
PORTNUM 4 For Wisconsin I change this to convention, which is Port 4.
ID AX/IP/UDP
DRIVER BPQAXIP
QUALITY 220
MINQUALITY 165
MAXFRAME 5
FRACK 3000
RESPTIME 1000
RETRIES 5
PACLEN 236
CONFIG N/A
MHEARD N/A
UDP 10093 N/A
AUTOADDDMAP
BROADCAST NODES

Applications

This is where you define which applications BPQ will run. Ensure the section includes:

APPLICATION 1,BBS,,WT9X-1,T9XBBS,255
APPLICATION 2,CHAT,,WT9X-11,T9XCHT,255
APPLICATION 32,TALK,,WT9X
bpq_bbs_software.txt · Last modified: 2022/10/19 12:45 by Andre Robitaille, WT9X