Table of Contents
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
- Grid square: https://www.levinecentral.com/ham/grid_square.php
- 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.
mkdir ~/linbpq
←- only needed if you didn't do it in the steps abovecd ~/linbpq
chmod +x pilinbpq
sudo setcap “CAP_NET_ADMIN=ep CAP_NET_RAW=ep CAP_NET_BIND_SERVICE=ep” pilinbpq
mkdir HTML
cd HTML
unzip HTMLPages.zip
rm HTMLPages.zip
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. ! |
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 (!! 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