This is a document which describes the general case of installing and configuring LinBPQ on Ubuntu 22.04
NB this process has now been superseded since one of our members has kindly established an apt repo containing a build of LinBPQ.
See linbpq-apt-installation for a guide.
There are currently 2 options for installing linbpq
When you issue the following commands, a subfolder will be created in your working directory called linbpq.
This is as-yet untested, so reports of success or otherwise will be highly appreciated.
sudo apt install libconfig9 mkdir linbpq cd linbpq wget https://github.com/M0LTE/linbpq/releases/download/release/linbpq chmod +x linbpq ./linbpq -v
When you issue the following commands, a subfolder will be created in your working directory called linbpq.
sudo dpkg --add-architecture i386 sudo sed -i 's/deb /deb [arch=amd64,i386] /g' /etc/apt/sources.list && \ sudo apt update && sudo apt install -yq wget unzip libcap2-bin lib32z1 && \ sudo apt install -yq libasound2:i386 libasound2-dev:i386 && \ sudo apt install -yq gcc-multilib libc6:i386 libncurses5:i386 libstdc++6:i386 mkdir linbpq cd linbpq wget https://www.cantab.net/users/john.wiseman/Downloads/linbpq chmod +x linbpq ./linbpq -v
Don't do this unless you know what you are doing. When you issue the following commands, a subfolder will be created in your working directory called linbpq.
sudo apt update sudo apt install git build-essential libconfig-dev libssl-dev libminiupnpc-dev libzip-dev libpcap-dev libasound2-dev minicom unzip git clone git://vps1.g8bpq.net/linbpq cd linbpq make chmod +x linbpq ./linbpq -v
Congratulations you now have linpbq!
Before you can use linbpq you need a configuration file called bpq32.conf.
The configuration file tells linbpq how to interact with your TNC/Radio, it's web interface and any other connections such as internet links or Telnet connections.
You will also need a few other applications, such as telnet, minicom and lsof.
The following tool will take care of this and create a basic configuration file, which we can then edit it to make it suited to our needs
Run the following commands from within your linbpq directory to download the tool
cd ~/linbpq wget http://www.prinmath.com/ham/bpq-config chmod +x bpq-config
To launch the tool type:
sudo ./bpq-config
The script will make appropriate changes to your PC, just select the default options:
1. Install missing software
2. Enable serial port access [so you can access your tnc]
3. Disable Bluetooth [don't ask me why]
4. Let BPQ be attached to serial devices [so people connecting over your tnc can talk to bpq]
5. Reboot
6. Once your PC has reset, reconnect to, navigate to the linbpq folder and relaunch the configuration tool:
cd ~/linbpq sudo ./bpq-config
7. Select Quick Install - this will create a basic configuration that you can then change
8. On the following screen go through each option and populate - things to be aware of:
9. Once done click finish. The script will update the appropriate files, hit ok to move on
10. The following screen shows how you can connect to your bpq instances interface - maybe fire up a browser and have a look now!
11. You will then be sent to the main menu, if you run the config tool again in future you will be brought here. Select option 5 to enable bpq on boot.
12. Click finish
13. Finally run this code to fix an issue with the start up routine
sudo sed -i 's/pilinbpq/linbpq/g' /lib/systemd/system/bpq.service sudo systemctl daemon-reload sudo systemctl start bpq.service
14. Your system is now ready - visit http://yournodeip:8008 and have fun!
1. Find out which port your TNC is connected to:
2. Navigate to your linbpq folder.
2. Run the command sudo nano bpq32.cfg to open the configuration file
3. Spend a few minutes looking over this file. The tool we used has added a load of comments telling you what everything does.
4. Navigate to the section that starts *Port 1*
5. Change the COMPORT and SPEED to the correct values - in the case of a NinoTNC you would change:
COMPORT=/dev/ttyACM0 ; Serial port SPEED=19200 ; Serial port speed
to:
COMPORT=/dev/ttyACM0 ; Serial port SPEED=57600 ; Serial port speed
6. To save your changes - Press Ctrl + X to exit the text editor. The bottom of the screen will ask if you want to save changes. Press 'Y' then enter.
7. To load in changes restart linbpq with the following command: sudo systemctl restart bpq.service
8. If you want to check if linbpq has started type sudo systemctl status bpq.service The first 3 lines of the output should look like this - If it says “active (running) on the third line, you are good to go!
bpq.service - BPQ Loaded: loaded (/lib/systemd/system/bpq.service; enabled; vendor preset: enabled) Active: active (running) since Thu 2023-01-05 10:49:04 GMT; 1min 34s ago
You can access your node via radio and over your home network [and potentially the internet] via a telnet client.
It's better to use a dedicated telnet client but linbpq does provide a web based one. You can access it by clicking “Terminal” on your nodes webpage - located at http://IPAddress:8080 - if you take this route skip steps 1 & 2
You can also access your node via G8BPQ's desktop application QtTermTCP. Enable an FBBPORT inside your Telnet port config, and set up a host in QtTermTCP, pointing at that port.