Online Amateur Radio Community Wiki

User Tools

Site Tools

Trace:
packet-linbpq-x86

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
packet-linbpq-x86 [2023/01/08 16:38] – m0ltepacket-linbpq-x86 [2023/04/03 22:11] (current) – m0lte
Line 1: Line 1:
-====== Installing LinBPQ on Ubuntu 20.04 LTS x64 ====== +Moved to [[packet:linbpq_pc_installation]]
- +
-This is a document which describes the general case of installing and configuring LinBPQ on Ubuntu 22.04  +
- +
-===== Downloading and running the script ===== +
- +
-There are currently 2 options for installing linbpq  +
- +
-===1. Download the 32 Bit version and install a few missing things=== +
- +
-When you issue the following commands, a subfolder will be created in your working directory called linbpq. +
- +
-<code> +
- +
-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 gcc-multilib libc6:i386 libncurses5:i386 libstdc++6:i386 +
-cd +
-mkdir linbpq +
-cd linbpq +
-wget https://www.cantab.net/users/john.wiseman/Downloads/linbpq +
-chmod +x linbpq +
- +
-</code> +
- +
- +
-===2. OR Download the source code, and a few required libraries, and build it yourself=== +
- +
-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. +
- +
- +
-<code> +
-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 +
-</code> +
-     +
-Congratulations you now have linpbq! +
- +
-===== Setting up linbpq - the bpq-config tool===== +
- +
-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 +
- +
-<code> +
-   cd ~/linbpq +
-   wget http://www.prinmath.com/ham/bpq-config +
-   chmod +x bpq-config +
-</code> +
- +
-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\\ +
-{{:screenshot_2023-01-05_at_10.09.54.png?400|}}\\ +
-2. Enable serial port access [so you can access your tnc]\\ +
-{{:screenshot_2023-01-05_at_10.11.54.png?400|}}\\ +
-3. Disable Bluetooth [don't ask me why]\\ +
-{{:screenshot_2023-01-05_at_10.12.03.png?400|}}\\ +
-4. Let BPQ be attached to serial devices [so people connecting over your tnc can talk to bpq]\\ +
-{{:screenshot_2023-01-05_at_10.12.09.png?400|}}\\ +
-5. Reboot\\ +
-{{:screenshot_2023-01-05_at_10.12.16.png?400|}}\\ +
-6. Once your PC has reset, reconnect to, navigate to the linbpq folder and relaunch the configuration tool:  +
-<code> +
-cd ~/linbpq +
-sudo ./bpq-config +
-</code> +
-7. Select Quick Install - this will create a basic configuration that you can then change\\ +
-{{::screenshot_2023-01-05_at_10.20.06.png?400|}}\\ +
-8. On the following screen go through each option and populate - things to be aware of:\\ +
-  * Gridsquare reference is your Maidenhead locator. The first 2 letters need to upper case, the last 2 lower case. So IO92PB is IO92pb +
-  * Username/Password can be anything you like - you'll only use it when accessing the link over your home network +
-  * Set WinLink RMS to No +
-  * It doesn't currently like intermediate callsigns, just set a dummy callsign and edit in the config later +
-{{::screenshot_2023-01-05_at_10.21.51.png?400|}}\\ +
-9. Once done click finish. The script will update the appropriate files, hit ok to move on\\ +
-{{::screenshot_2023-01-05_at_10.26.18.png?400|}}\\ +
-10. The following screen shows how you can connect to your bpq instances interface - maybe fire up a browser and have a look now!\\ +
-{{::screenshot_2023-01-05_at_10.26.29.png?400|}}\\ +
-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. \\ +
-{{::screenshot_2023-01-05_at_10.26.40.png?400|}}\\ +
-12. Click finish +
-13. Finally run this code to fix an issue with the start up routine +
- +
-<code> +
-sudo sed -i 's/pilinbpq/linbpq/g' /lib/systemd/system/bpq.service +
-sudo systemctl daemon-reload +
-sudo systemctl start bpq.service +
- +
-</code> +
- +
-14. Your system is now ready - visit http://yournodeip:8008 and have fun! +
- +
-===== Connecting LinBPQ to your TNC ===== +
-1. Find out which port your TNC is connected to:  +
- +
-  * NinoTNC - It's /dev/ttyACM0 +
-  * Physical TNC connected by USB to Serial cable - Probably /dev/ttyUSB0 +
-  * Direwolf 'soundmode' - you can specify what "virtual port" it creates ask in #packet-and-networks channel on discord +
-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 +
-\\ +
- +
-===== What Next? Access your node ===== +
- +
- +
-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\\ +
- +
- +
- +
-  - Download a telnet client - Putty for Windows, "telnet" for pi/linux or TelNet Lite from the Mac OS App Shop\\ +
-  - Setup a connection to your pc, enter your pc IP address as prompted and port 8010\\ +
-  - Hit connect and you'll be prompted for your username and password [set above]\\ +
-  - Once connected you can type ? followed by enter to get commands\\ +
-  - Type BBS to access the BBS/Mailbox system\\ +
-  - Type ? for help\\  +
-  - If you have a second tnc, if might be fun to send yourself a message. Use the command 's callsign' and follow the prompts eg 's M0UKF' +
- +
-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.+
packet-linbpq-x86.1673195932.txt.gz · Last modified: 2023/01/08 16:38 by m0lte