User Tools

Site Tools


packet-linbpq

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 [2023/01/05 11:14] – [What Next? Access your node] m0ukfpacket-linbpq [2023/04/03 22:10] (current) m0lte
Line 1: Line 1:
-====== Installing LinBPQ ====== +Moved to [[packet:linbpq_pi_installation]]
- +
- +
-===== Assumptions ===== +
- +
-This process assumes you know how to flash an SD card with the latest version of the Raspberry Pi OS and you have SSH access to your Pi. +
- +
-Nothing being installed requires a graphical interface so the minimum non-graphical interface is my [Francis M0UKF] preference - but it's up to you +
- +
-===== Downloading and running the script ===== +
- +
-Log into your pi +
- +
-When you issue the following commands, a script will be download, that script create a folder called linbpq and download and install a pi version of linbpq. I personally run it from my home folder - so it is installed in /home/pi/linbpq +
- +
- +
-wget http://www.cantab.net/users/john.wiseman/Downloads/installLinBPQ\\ +
-chmod +x installLinBPQ\\ +
-./installLinBPQ\\ +
- +
-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 +
- +
- +
-wget http://www.prinmath.com/ham/bpq-config \\ +
-chmod a+x bpq-config\\ +
-\\ +
- +
-To launch the tool type:\\ +
- +
-sudo ./bpq-config\\ +
-\\ +
-The script will make appropriate changes to your pi, 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 pi has reset, reconnect to, nagivate to the linbpq folder and relaunch the configuration tool: sudo ./bpq-config\\ +
-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 +
-{{::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. Your bpq instance is setup! Why not visit the web interface! http://yourpiIP/8008 +
-===== 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 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 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://piIPAddress: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 pi, enter your pi 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' +
- +
- +
packet-linbpq.1672917287.txt.gz · Last modified: 2023/01/05 11:14 by m0ukf