Differences

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

--- qttermtcp [2023/03/22 00:54] – 2e0sip
+++ qttermtcp [2023/05/21 16:21] – [Raspbian Desktop] ab4mw
@@ Line 1: / Line 1: @@
 ====== QtTermTCP ======
-QtTermTCP is a software package created by John G8BPQ that acts as a "terminal" for interacting with packet radio stations. It can connect to a packet system using FBB over IP, or the more recent beta version supports KISS, both with a directly connected serial TNC or over TCP to something like Dire Wolf.
+QtTermTCP is a software package created by John G8BPQ that acts as a "terminal" for interacting with packet radio stations. It can connect to directly to a BPQ node using FBB over IP, or the more recent beta version supports KISS, both with a directly connected serial TNC or over TCP to something like Dire Wolf.
 The following Wiki page covers getting started with QtTermTCP. It assumes you've got a working Radio + TNC setup.
@@ Line 36: / Line 36: @@
 Tom M0LTE has kindly setup some Github actions for building QTTermTCP for 64 bit Linux. The subsequent compiled binary can be found [[https://github.com/M0LTE/QtTermTCP-builds/releases|here]]
-First of all open a terminal, change to root and download the binary. Then make it executable.
+First of all open a terminal, change to root, and install the dependencies:
 <code>
 su root
+apt-get update
+apt-get install libqt5serialport5 libqt5widgets5
+Next download the binary and make it executable:
+<code>
 wget -P /usr/local/bin https://github.com/M0LTE/QtTermTCP-builds/releases/download/release/QtTermTCP
 chmod +x /usr/local/bin/QtTermTCP
@@ Line 62: / Line 67: @@
 Comment=QTTermTCP
 </code>
+Then press ''%%Ctrl + O%%'' to save and ''%%Ctrl + X%%'' to exit nano.
+You should now be able to launch QtTermTCP from the "Applications" menu
+==== Raspbian Desktop ====
+=== NOTE: the following instructions work exactly the same for Ubuntu 22.04 ===
+QtTermTCP can be compiled for a Raspberry Pi. From a fresh install run the following commands:
+<code>
+# First let's install the support packages.
+sudo apt-get install -y qt5-qmake qtbase5-dev libqt5serialport5-dev git
+# Move to the user's home folder and create a source folder.
+# If it already exists, it's ok.
+cd
+mkdir -p src
+cd src
+# Download the source code.
+git clone git://vps1.g8bpq.net/QtTermTCP
+cd QtTermTCP
+# We want to do a shadow build so it's easy to update later
+mkdir build
+cd build
+qmake ..
+# NOTE: older Pi's like 2's and 3's will want to use a "-j2" or "-j3"
+# but Pi 4/400's can support the "-j4" just fine.
+make -j4
+# Now the executable will reside in the build folder so let's
+# make a tidy home for it as a folder in our home folder.
+mkdir -p ~/QtTermTCP
+cp QtTermTCP ~/QtTermTCP
+cd ~/QtTermTCP
+# Ensure the program is executable.
+chmod +x QtTermTCP
+# Now make a simple script to use for a desktop shortcut or manually starting the program.
+touch QtTermTCP.sh
+echo "#!/bin/bash" > QtTermTCP.sh
+echo "cd ~/QtTermTCP" >> QtTermTCP.sh
+echo "./QtTermTCP > /dev/null & 2>&1" >> QtTermTCP.sh
+echo "exit 0" >> QtTermTCP.sh
+chmod +x QtTermTCP.sh
+</code>
+The program may be run using the shell script found at /home/<user>/QtTermTCP/QtTermTCP.sh
+This shell script may also be used to build a shortcut for the desktop.  For RPi, open the File Manager and find the QtTermTCP.sh file.  Drag the file to the desktop and drop it.  For other Linuxes, the desktop shortcut creation may be different.
 ===== Setup =====