The purpose of this Mini-HOWTO is to get a working BPQ configuration on a
Raspberry Pi. It assumes you have installed Raspbian on your Pi and takes it
from the first login.
Log in to the Raspberry Pi as user pi. You can do this remotely using SSH or
directly from the keyboard.
Create a directory BPQ using the command mkdir BPQ
Make this the current directory using the command cd BPQ
Download bpq-config using the command wget http://www.prinmath.com/ham/bpq-config
Make bpq-config ecxecutable with the command chmod a+x bpq-config
Run bpq-config with sudo sudo ./bpq-config
bpq-config will look for programs you will need, and prompt you to install
them. Select Install
On the Pi 3, the Bluetooth system uses the serial port needed by BPQ.
On the Pi 3, the hciuart handles the Bluetooth system. Disable it also.
The getty system allows a serial console login. Disable it.
Reboot to have the above change take effect.
After the reboot log back in.
Change to the BPQ directory using cd BPQ
Run bpq-config again using sudo ./bpq-config
bpq-config will detect a fresh install by the absence of a .bpqconfig file. Select Quick Install unless you know what you are doing.
Hit the enter key to set the Node Callsign
The node callsign is what BPQ will use to identify the node on packet. Do
not add the SSID (-1 or -10) which denotes the service. bpq-config will add
that for each service.
Hit enter to set the Owner Acronym.
The Owner Acronym can be 1 to 4 characters. It is used to make an alias
callsign to access different services. For example, with the Owner Acronym CTN
the alias callsign for the BBS will be CTNBBS.
Hit enter to set the Owner Name.
The Owner Name will be used in prompts and beacon text to tell other
stations about your BPQ node.
Hit enter to set the Grid Square.
This is the maidenhead grid square where your node are located.
Hit enter to set the Frequency your node will operate on.
The frequency is a six digit integer, and represents the frequency in kHz.
Hit enter to set your user name.
The user name is used to log in to the BPQ node using the web interface or
via telnet. This can be any string, even a callsign. I chose my first name.
Hit enter to set the password for web interface and telnet logins.
This can be any string, but it is the secret you need to use to gain access
via the web interface or telnet login.
Quick Start configuration is now complete. You can go back and change any
of the settings you need to. When done select Finish.
bpq-config will write the configuration file and system files you need.
Select OK to proceed.
bpq-config will now start BPQ. Make sure it is working by connecting to it
using your web browser or doing a telnet login. This screen will show you the
IP address to use for your system. If all is well, select Continue to
proceed. If BPQ seems to not be running, select Abort Quick Start and
trouble shoot your system.
You now have a working BPQ system. You can modify your system by selecting
Configure BPQ and you will have a plethora of options.
Select Enable BPQ start at boot to apply system settings to start BPQ
when the Pi boots.
If you make it here, congratulations, you now have a working BPQ system.
You can use bpq-config to start, stop or restart BPQ, enable or disable BPQ
start at boot, and update your configuration.
You can upgrade BPQ and bpq-config to the latest version by selecting
Download BPQ. As BPQ continues to be developed, and bpq-config is
certainly a work in progress, you should to that periodically.
Please report problems with bpq-config to the author. Feedback and patches
are always welcome. 73 and good luck. Willem AC0KQ.