User Tools

Site Tools


qttermtcp

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
qttermtcp [2023/03/27 12:37] m0ukfqttermtcp [2023/05/21 22:25] (current) – removed m0tzo
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 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. 
- 
- 
-===== Installation ===== 
- 
-==== 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?  
- 
-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. 
- 
-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. 
- 
-{{::qttermtcp_permissions.png?direct&600|}} 
- 
-Click the ''%%General%%'' tab, Untick ''%%Read Only%%'' press ''%%Apply%%'' Then ''%%Ok%%'' when prompted to ''%%Apply changes to this folder, subfolders and files%%''  
- 
-{{::qttermtcp_properties.png?direct&600|}} 
- 
-You can then exit the properties window. 
- 
-To access if from the Start Menu, Find QTTermTCP.exe, Right Click it, and select ''%%Pin To Start%%'' 
- 
-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)%%''  
- 
-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 ==== 
- 
-sudo apt-get install -y qt5-qmake qtbase5-dev libqt5serialport5-dev 
-git clone git://vps1.g8bpq.net/QtTermTCPgit clone git://vps1.g8bpq.net/QtTermTCP 
-mv QtTermTCP src 
-cd src 
-qmake 
-make 
-mv QtTermTCP ../ 
-cd .. 
-rm src -R 
- 
- 
-./QtTermTCP 
- 
- 
- 
- 
- 
-===== Setup ===== 
- 
-Usage should be similar for both Windows and Linux versions.  
- 
-==== 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, 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. 
- 
- 
-Open QTTermTCP, click ''%%Setup%%'' > ''%%KISS Setup%%''. 
- 
-Tick Enable ''%%Enable KISS interface%%'', enter your callsign. 
- 
-In the Serial Setup section select "TCP" in the drop down for Serial Device. 
- 
-In the TCP Setup section enter the IP and port of the KISS modem. If you're running Dire Wolf on your local machine the IP would be ''%%127.0.0.1%%''. Dire Wolf listens on port 8001 for KISS by default. 
- 
-It should look something like: 
- 
-{{::qttermtcp_kisstcp.png?direct&400|}} 
- 
- 
-Press OK when finished to exit the setup. 
- 
- 
-===== Usage ===== 
- 
-Once you've configured QTTermTCP you can try to connect to something. 
- 
-Open QTTermTCP. Assuming everything is setup correctly you should see "Kiss Connected" in the bottom status bar. 
- 
-By default, the windows is split into three. The top panel is monitoring any packets sent or received. If you're in range of another packet station you should see some activity here. The Middle panel is there terminal and will show any data sent from a node once connected. The bottom small text bar is for sending text to a connected node. 
- 
-Monitor panel showing some activity from GB7WOD:  
- 
-{{::qttermtcp_monitor.png?direct&400|}} 
- 
- 
-To attempt to Connect, in the top bar select ''%%Connect%%'' > ''%%KISS 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. 
- 
-{{::qttermtcp_kissconnect.png?direct&400|}} 
- 
-Press OK once finished to connect 
- 
-{{::qttermtcp_kissconnecting.png?direct&600|}} 
- 
-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. 
qttermtcp.1679920678.txt.gz · Last modified: 2023/03/27 12:37 by m0ukf