3.4 KiB
BPQ
Set Up Repo
If you have not already done so, set up the repo as shown here.
Install
To install LinBPQ from the repo, run the below commands:
sudo apt update
sudo apt install linbpq
Pre-Configure
sudo cp /usr/share/doc/linbpq/examples/bpq32.cfg /etc/bpq32.cfg
sudo nano /etc/bpq32.cfg
sudo chown :linbpq /etc/bpq32.cfg
sudo chmod 644 /etc/bpq32.cfg
!!! note
Without a config file installed to `/etc/bpq32.cfg`, BPQ from the repo will not start. If you are looking to use a config file in a different location, remove or modify `ConditionPathExists=/etc/bpq32.cfg` in `/usr/lib/systemd/system/linbpq.service`
Configure
The configuration file I ship in the repo, there are hopefully some obvious fields to fill out. Once all the below holes are filled, you should be able to log in either with QtTermTCP or in your web browser at 127.0.0.1:8008, assuming you're on the same computer as the node.
Field | Example | Purpose |
---|---|---|
NODECALL | MM0RFN | The callsign your node shall identify as |
NODEALIAS | RFNNOD | The alias a calling NET/ROM station can use to connect directly to you |
LOCATOR | IO87dc | A 6 figure Maidenhead square where you are |
PASSWORD | test123 | A sysop password for configuration activities |
AUTOSAVE | 1 | Autosave the NET/ROM Nodes Table on shutdown |
NODESINTERVAL | 30 | Interval between NET/ROM NODES broadcasts in minutes |
MINQUAL | 50 | The minimum quality of NET/ROM node included in your NODES broadcasts. |
CTEXT | Hi you look great! *** |
Text displayed when a user connects |
Ports
Port configs in BPQNode aren't too complicated. A common Gotcha is that you configure a port specific broadcast and end up double-broadcasting, both the node master broadcast and the port specific one.
KISS
A common port entry for a NinoTNC specifically (but also, more generally, a KISS Modem) looks like:
PORT
PORTNUM=1
ID=VHF
TYPE=ASYNC
PROTOCOL=KISS
KISSOPTIONS=ACKMODE
COMPORT=/dev/ttyACM0
SPEED=57600
FRACK=4000
PACLEN=150
DIGIFLAG=0
QUALITY=192
MINQUAL=20
ENDPORT
Key settings to observe are the COMPORT
, which should be the serial port of the device, and SPEED
. For a NinoTNC this is always 57600, but for QtSoundModem, Direwolf or older hardware may be 9600 or something else. Check your modem configuration!
QUALITY
sets the assumed quality of connections coming in - I recommend higher quality (up to 200) for higher speed links. Setting this to 0 will disable NET/ROM on the port, and this is current recommended standard practise on HF within the UK Packet Radio Network.
Telnet
BPQ's Telnet Port sets the TCP Ports for Telnet, FBB and HTTP connetions, alongside the username and password. This will come in useful when using QtTTCP as a monitor and control application.
PORT
PORTNUM=9
ID=Telnet
DRIVER=Telnet
CONFIG
LOGGING=1
CMS=1
DisconnectOnClose=1
TCPPORT=8010
FBBPORT=8011
HTTPPORT=8008
LOGINPROMPT=user:
PASSWORDPROMPT=password:
MAXSESSIONS=10
CTEXT=Thanks for connecting\n Enter ? for list of commands\n\n
USER=username,xxxxxxxx,m0aaa,,SYSOP
ENDPORT
USER
is the key configuration to change here - change username
to your desired administrator username, xxxxxxx
to the password and m0aaa
to the callsign of the administrator.