Differences

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

--- packet:qttermtcp [2023/05/21 22:24] – m0tzo
+++ packet:qttermtcp [2024/12/27 11:07] (current) – added download for MacOS QTTermTCP mm7shx
@@ Line 1: / Line 1: @@
 ====== QtTermTCP ======
+Official Website: https://www.cantab.net/users/john.wiseman/Documents/QtTermTCP.html
 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.
@@ Line 10: / Line 12: @@
 ==== Windows ====
-The instructions were tested on Windows 11 but presumablys work on other versions. For some reason its a bit of a faff and involves changing permissions possibly due to putting it in Program Files. But where else do you put a program on Windows?
+The instructions were tested on Windows 11 but presumably works on other versions.
+First off if it doesn't already exist, create a directory in your Documents directory and call it something like "Packet Radio Software" or similar.
 Download [[https://www.cantab.net/users/john.wiseman/Downloads/Beta/QtTermTCP.zip|QtTermTCP.zip]]
-Extract it, and copy the "release" directory to ''%%C://Program Files (x86)/%%'' then rename it to something useful like QTTermTCP. You might occasioanlly get prompted for administrator access.
+Extract it, and copy the "release" directory to the newly created directory, then rename it to something useful like QtTermTCP.
-Right click it, go to ''%%properties%%'' and hit the ''%%Security%%'' > ''%%Edit%%'' which will open another window. Scroll down in the list of ''%%Groups or user names%%'' Until you find ''%%Users%%'', highlight it and then Click ''%%Allow%%'' for ''%%Full Control%%'' then press ''%%Apply%%'' and exit the edit window.
+To access if from the Start Menu, Find QTTermTCP.exe, Right Click it, and select ''%%Pin To Start%%''.
-{{::qttermtcp_permissions.png?direct&600|}}
+Optionally if you want to create a desktop shortcut, you can also Right click the exe again, select ''%%Show more options%%'' > ''%%Send to%%'' > ''%%Desktop (Create Shortcut)%%''
-Click the ''%%General%%'' tab, Untick ''%%Read Only%%'' press ''%%Apply%%'' Then ''%%Ok%%'' when prompted to ''%%Apply changes to this folder, subfolders and files%%''
+This completes the installation.
-{{::qttermtcp_properties.png?direct&600|}}
+==== Debian-ish operating systems ====
-You can then exit the properties window.
+If you have a Debian-like OS, such as Ubuntu, Raspberry Pi OS, or indeed Debian itself, please consider using the repository here: https://github.com/Online-Amateur-Radio-Club-M0OUK/oarc-packages - instead of following the manual installation steps below.
-To access if from the Start Menu, Find QTTermTCP.exe, Right Click it, and select ''%%Pin To Start%%''.
+==== MacOS Download ====
+Download [[https://www.dropbox.com/scl/fo/5x7y3hlkfgtvjx35g5dnm/AHhwU7hPuDG_5xU3MFbt9rI?rlkey=se06u2h1354lle6kk1omu41p1&dl=1|QTTermTCP.app]] (version 0.0.0.77)
-Optionally if you want to create a desktop shortcut, you can also Right click the exe again, select ''%%Show more options%%'' > ''%%Send to%%'' > ''%%Desktop (Create Shortcut)%%''
+==== MacOS with Brew ====
-This completes the installation.
+If you use MacOs with the [[https://brew.sh/|Brew Package Manager]] a tap has been set up that will compile the QtTermTCP binary from source including dependencies:
+<code>
+brew install tomwardill/oarc-qttermtcp-tap/oarc-qttermtcp
+QtTermTCP
+</code>
+This installs the QtTermTCP app as if it was a CLI app, so it must be started from the terminal.
+==== Ubuntu 22.04 - standard installation ====
+In almost every case, you are better off installing by following this guide than building it yourself: https://guide.foxk.it/clients/qtttcp/
-==== Ubuntu 22.04 ====
+==== Ubuntu 22.04 - manual installation ====
 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]]
@@ Line 72: / Line 88: @@
 You should now be able to launch QtTermTCP from the "Applications" menu
-==== Raspbian Desktop ====
+==== Raspbian Desktop - standard installation ====
+In almost every case, you are better off installing by following this guide than building it yourself: https://guide.foxk.it/clients/qtttcp/
+==== Raspbian Desktop - manual installation ====
 === NOTE: the following instructions work exactly the same for Ubuntu 22.04 ===
@@ Line 126: / Line 146: @@
 ===== Setup =====
-Usage should be similar for both Windows and Linux versions.
+Setup should be similar for both Windows and Linux versions. Note of the 3 connection methods documented below, you'd generally only configure one - so pick the method most relevant to your setup.
-==== KISS ====
+==== KISS via Serial ====
 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.
@@ Line 141: / Line 161: @@
-==== KISS Over TCP ====
+==== KISS via TCP ====
 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.
@@ Line 161: / Line 181: @@
 Press OK when finished to exit the setup.
+==== AGW ====
+AGW is a packet protocol used by in SV2AGW's collection of packet software. It can be used to connect to software modems like [[packet:qtsoundmodem|QtSoundModem]].
+To configure it, open QTTermTCP, click ''%%Setup%%'' > ''%%AGW Setup%%''.
+Enter your callsign, ignore the Beacon setup for now, and then in the TNC Setup section configure the Host, Port, and Paclen. If you're using QtSoundModem on the same machine, the host is 127.0.0.1 and the default port is 8000.
+{{:packet:qtsm_qtttcp_config.jpg?direct&400|}}
 ===== Usage =====
 Once you've configured QTTermTCP you can try to connect to something.
+==== KISS ====
 Open QTTermTCP. Assuming everything is setup correctly you should see "Kiss Connected" in the bottom status bar.
@@ Line 186: / Line 218: @@
 Once connected, you can start to interact with the node.
+==== AGW ====
+Open QTTermTCP. Assuming everything is setup correctly you should see "AGW Connected" in the bottom status bar.
+To attempt to Connect, in the top bar select ''%%Connect%%'' > ''%%AGW Connect%%'' and enter the call sign of the station you wish to connect to. Digis can usually be left empty if you're in direct range of the node you're connecting to. You'll also have to select the radio port. For a single modem connection this will be the first in the list.
+{{:packet:qttermtcp_agwconnect.jpg?direct&400|}}
+Press OK once finished to connect. You should then attempt to connect to the node. You can see the sent packets in the monitor window.
+Once connected, you can start to interact with the node.
+==== LISTEN ====
+QtTermTCP has a very nice feature that ties directly with the TALK command.\\
+When set up correctly if a remote user types "TALK" and your node handles it a tab will open on your QtTermTCP app and you can communicate directly with that user.\\
+For this configuration example (it is actually mine), I have the TNC connected to one machine running linBPQ and my main machine running QtTermTCP.\\
+\\
+I need to know my main machine's IP address (not the internet IP address, my internal network IP address).\\
+''//192.168.1.175//''\\
+I also need a port number on my main machine to listen on.  I will use\\
+''//8015//''\\
+In QtTermTCP, click on the ''Listen'' menu. A new window will open as below:\\
+{{:packet:m0odz_qttermtcp_listen.png?400|}}\\
+Check the box ''[X] Enable Listen''\\
+Fill in the port number (''//8015//'' in my example)\\
+Fill in the CText box with the information the end user will see when they use the "TALK" command\\
+Click the OK button.\\
+If you notice a mistake later you can Click on the "Listen" menu item again to change it.\\
+\\
+On the node itself you need to add the TALK command to bpq32.cfg.  Below I show mine.\\
+''APPLICATION //4//,TALK,att //2// //192.168.1.175// //8015//,//GB7ODZ-5//,//ODZTLK//,        ; TALK Application''\\
+Step by step:\\
+''APPLICATION //4//''\\
+This is the application number, you can have between 1 and 32.  Ensure the number is unique (you can't have 2 application 4 lines).\\
+''TALK''\\
+This is the command the end user types to activate the command\\
+''att //2// //192.168.1.175// //8015//''\\
+Attach to port ''//8015//'' on IP address ''//192.168.1.175//'' using BPQ port ''//2//'' (this is my node's telnet port, ''PORTNUM //2//'').\\
+''//GB7ODZ-5//''\\
+This is a direct connection to the TALK command.  The end user could type ''C //GB7ODZ-5//'' and it would be as if they connected to my node as normal and then typed the "TALK" command\\
+''//ODZTLK//''\\
+This is the alias of ''//GB7ODZ-5//'' and can be used in the same manner (''C //ODZTLK//'')\\
+\\
+Save the config file and restart bpq32.\\
+\\
+One thing I do in QtTermTCP is to enable tabbed windows which means I can have multiple connections in one app.\\
+Click on the ''Setup'' menu and then ''Tabbed''.\\
+Also, tick ''[X] Beep on inbound connections''.  This will make a noise when the end user connects to ''TALK''.\\
+When the end user connects to ''TALK'', a tab at the bottom will show the remote user's callsign.\\
+If you change the "Tabbed" option then restart QtTermTCP.\\
+\\
+{{:packet:m0odz_qttermtcp_setup_tabbed_window.png?400|}}\\
+\\