Differences

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

--- qttermtcp [2023/03/12 12:47] – 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 29: / Line 31: @@
 This completes the installation.
+==== Ubuntu 22.04 ====
+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 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
+</code>
+Then create a .desktop file so you can find QtTermTCP in your applications menu.
+<code>
+nano /home/$USERNAME/.local/share/applications/QtTermTCP.desktop
+</code>
+Enter the following:
+<code>
+#!/usr/bin/env xdg-open
+[Desktop Entry]
+Version=1.0
+Type=Application
+Terminal=false
+Exec=/usr/local/bin/QtTermTCP
+Name=QTTermTCP
+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 =====
@@ Line 34: / Line 128: @@
 Usage should be similar for both Windows and Linux versions.
-==== Kiss Over TCP ====
+==== KISS ====
+KISS (Keep It Simple, Stupid) is a protocol for communicating with a serial terminal node controller (TNC) device used for amateur radio. An example of a modern TNC is the NinoTNC.
+Open QTTermTCP, click ''%%Setup%%'' > ''%%KISS Setup%%''.
+Tick Enable ''%%Enable KISS interface%%'', enter your callsign.
+In the Serial Setup section select the COM port of the attached TNC, and enter the desired baud rate (Note: This is the baud rate of the serial device itself, not the baud rate you wish to transmit at). The Baud Rate for the NinoTNC is 57600.
+{{::qttermtcp_kisscom.png?direct&400|}}
+==== KISS Over TCP ====
-Kiss Over TCP is useful if you're running QtTermTCP and want to connect to Dire Wolf, either running locally, or perhaps Dire Wolf is running on a Raspberry Pi and you want to connect from QtTermTCP running on your daily driver PC.
+KISS Over TCP is useful if you're running QtTermTCP and want to connect to Dire Wolf, which is either running locally, or perhaps running on a Raspberry Pi and you want to connect from QtTermTCP running on your daily driver PC.