diff --git a/docs/beginners-guide.md b/docs/beginners-guide.md index d098a1e..f06f9f3 100644 --- a/docs/beginners-guide.md +++ b/docs/beginners-guide.md @@ -86,11 +86,11 @@ The key modulations we use are: **AFSK** -Audio Frequncy Shift Keying - Multiple audible tones. This is commonly found on VHF, FM 1200bd links. Classic bleeps and bloops that have been heard on our frequencies for decades. Tune to 144.800MHz to get a flavour from the APRS network. +Audio Frequency Shift Keying - Multiple audible tones. This is commonly found on VHF, FM 1200bd links. Classic bleeps and bloops that have been heard on our frequencies for decades. Tune to 144.800MHz to get a flavour from the APRS network. **FSK** -Frequency Shift Keying - Multiple tones, not necessarily audible. Commonly found on UHF, FM 9600bd links. This sounds quite like white noise and can be difficut to differentiate from unsquelched audio. +Frequency Shift Keying - Multiple tones, not necessarily audible. Commonly found on UHF, FM 9600bd links. This sounds quite like white noise and can be difficult to differentiate from unsquelched audio. **PSK** @@ -102,7 +102,7 @@ A key component of the systems I'll be discussing in this guide is Linux. If you There's a lot to take in, and it can seem overwhelming at first, but feel free to read, ask for help and keep in mind that it's easy to feel lost when you approach anything new - there are just so many things to grasp. -A simple starting point is a [Raspberry Pi](https://raspberrypi.org) - it will be a dedicated computer for just packet exploration, and if everything is broken you can easily start again without losing any importnt data - you just rewrite the SD card and start again. +A simple starting point is a [Raspberry Pi](https://raspberrypi.org) - it will be a dedicated computer for just packet exploration, and if everything is broken you can easily start again without losing any important data - you just rewrite the SD card and start again. ## Radio Set Up @@ -124,7 +124,7 @@ Once you have done that you can install the prerequisites - QTTermTCP. If you're a new user, I recommend using a graphical 'app store' - see how [here](linux.md/#graphical-app-store-frontend). -If you're more linux aware? `apt install soundmodem` in your terminal of choice! +If you're more Linux aware? `apt install soundmodem` in your terminal of choice! ### Configure QtTermTCP @@ -148,7 +148,7 @@ Decoded data shall look like: ## Connect -Press Connect, then 'Kiss Connect' in the dropdown menu. You'll see something aking to the below - selection session, enter the callsign & SSID you are trying to connect to, for example GB7HIB-7 if you're connecting to my node. Ignore digipeters for the moment - they can be a future challenge. +Press Connect, then 'Kiss Connect' in the dropdown menu. You'll see something asking to the below - selection session, enter the callsign & SSID you are trying to connect to, for example GB7HIB-7 if you're connecting to my node. Ignore digipeters for the moment - they can be a future challenge. ![Connect window](static/img/qttcp_connect.png) @@ -163,7 +163,10 @@ Not seeing anything in the monitor pane? Time to get debugging! ## Debugging -This is where most of my time is spent when setting up packet radio stuff. In my opinion, it's where the real learning happens - you need to get your hands dirty with your radio, with your modem, with linux and try to retain your sanity at the same time. +This is where most of my time is spent when setting up packet radio stuff. In my +opinion, it's where the real learning happens - you need to get your hands dirty +with your radio, with your modem, with Linux and try to retain your sanity at +the same time. Don't worry - there is always something you've forgotten to do, or think you've looked at and haven't. We all have that feeling. Sometimes I keep a note of what I've done and what I've looked at to avoid replication of work, or so I can note what I *have* changed and what I might need to replicate. diff --git a/docs/config/bpq.md b/docs/config/bpq.md index 5efbb78..1a3ed3d 100644 --- a/docs/config/bpq.md +++ b/docs/config/bpq.md @@ -78,7 +78,7 @@ Mail configuration isn't easy to get your head round! I'm still not clear on it all, and I think many others are in the same boat. It's done through the browser instead of on the command line, which makes it slightly more approachable. -Navigate to `http://localhost:8008`, assuming your HTTPPORT is set to 8008. This +Navigate to [http://localhost:8008](http://localhost:8008), assuming your HTTPPORT is set to 8008 and you're on the same machine. This will present you with the below view: ![BPQ Node Main page](../static/img/node-main.png) diff --git a/docs/index.md b/docs/index.md index a9adae4..4d07ce2 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,6 +1,7 @@ # Welcome to Hibby's Packet Radio Guide -Hi, welcome - thanks for coming by! +Hi, welcome - thanks for coming by! I'm Hibby and this is a collection of +everything I know about packet radio, and is being assembled bit by bit! !!! warning @@ -37,5 +38,3 @@ Have a look to see if you have a [proven radio](equipment/radios.md) and install I'd recommend trying 1200bd on VHF or UHF first, but slower modes on HF are perfectly do-able as well if you're on an island or stuck in a ditch. Take a look at the [beginner's guide](beginners-guide.md) to see more detail about how to get started. - - diff --git a/docs/install/bpq.md b/docs/install/bpq.md index c2c4a4b..4aff7b9 100644 --- a/docs/install/bpq.md +++ b/docs/install/bpq.md @@ -27,7 +27,7 @@ sudo chmod 644 /etc/bpq32.cfg ## Configure -The configuration file I ship in the repo, there are hopefully some obvious fields to fill out. Once all the below holes are filled, you should be able to log in either with [QtTermTCP](../clients/qtttcp.md) or in your web browser at 127.0.0.1:8008, assuming you're on the same computer as the node. +The configuration file I ship in the repo, there are hopefully some obvious fields to fill out. Once all the below holes are filled, you should be able to log in either with [QtTermTCP](../clients/qtttcp.md) or in your web browser at [localhost:8008](http://127.0.0.1:8008)), assuming you're on the same computer as the node. | Field | Example | Purpose | ----- | ------- | ------- @@ -42,7 +42,7 @@ The configuration file I ship in the repo, there are hopefully some obvious fiel ### Ports -Port configs in BPQNode aren't too complicated. A common Gotcha is that you configure a port specific broadcast and end up double-broadcasting, both the node master broadcast and the port specific one. +Port configuration blocks in BPQNode aren't too complicated. A common Gotcha is that you configure a port specific broadcast and end up double-broadcasting, both the node master broadcast and the port specific one. #### KISS @@ -71,7 +71,7 @@ Key settings to observe are the `COMPORT`, which should be the serial port of th #### Telnet -BPQ's Telnet Port sets the TCP Ports for Telnet, FBB and HTTP connetions, alongside the username and password. This will come in useful when using [QtTTCP](../clients/qtttcp.md) as a monitor and control application. +BPQ's Telnet Port sets the TCP Ports for Telnet, FBB and HTTP connections, alongside the username and password. This will come in useful when using [QtTTCP](../clients/qtttcp.md) as a monitor and control application. ``` PORT diff --git a/docs/linux.md b/docs/linux.md index 2a8d196..2b98a19 100644 --- a/docs/linux.md +++ b/docs/linux.md @@ -25,31 +25,49 @@ There are hundreds, if not thousands, of Linux Distributions all with different ## Desktops and Terminals -There's a common misconception that Linux is for command line users only, or that you need to be proficient in the command line to be able to drive it. This is no more true in Linux than it is for MacOS and Windows - there are a number of tasks that some may find more efficient to do via the command line interface (CLI), but there are usually multiple ways to skin the cat. +There's a common misconception that Linux is for command line users only, or +that you need to be proficient in the command line to be able to drive it. This +is no more true in Linux than it is for MacOS and Windows - there are a number +of tasks that some may find more efficient to do via the command line interface +(CLI), but there are usually multiple ways to skin the cat. -Much of my advice will take the form of things to run in the command line, as this is often the way I interact with my computers, but I am endeavouring to diversify so things are more approachable. +Much of my advice will take the form of things to run in the command line, as +this is often the way I interact with my computers, but I am endeavouring to +diversify so things are more approachable. -If you're running the Raspberry Pi, it's most likely you have [Raspberry Pi OS](https://www.raspberrypi.com/software/) with a desktop - there'll be a background, a menu in the top left etc. It might not look familiar, but to a keen explorer it should look approachable at the very least. +If you're running the Raspberry Pi, it's most likely you have [Raspberry Pi +OS](https://www.raspberrypi.com/software/) with a desktop - there'll be a +background, a menu in the top left etc. It might not look familiar, but to a +keen explorer it should look approachable at the very least. -<<<<<<< Updated upstream -If you're running Debian, during install we'll ask you what graphical desktop environment you want to install, if any. This is the desktop you boot in to - unlike Windows, there are multiples available for Linux. As a beginner, I strongly recommend [KDE](https://kde.org) - it is most Windows like and is pretty full featured. If you're running Ubuntu, typically you install an Ubuntu derivative focussed on a specific desktop environment - perhaps [Kubuntu](https://kubuntu.org) for KDE. -======= If you're running Debian, during install we'll ask you what graphical desktop -environment you want to install, if any. As a beginner, I strongly recommend -[KDE](https://kde.org) - it is most Windows like and is pretty full featured. If -you're running Ubuntu, typically you install an Ubuntu derivative focussed on a -specific desktop environment - perhaps [Kubuntu](https://kubuntu.org) for KDE. -For older hardware, I'm a big fan of [LXDE](https://lxde.org) - it's simple and -fast. ->>>>>>> Stashed changes +environment you want to install, if any. This is the desktop you boot in to - +unlike Windows, there are multiples available for Linux. As a beginner, I +strongly recommend [KDE](https://kde.org) - it is most Windows like and is +pretty full featured. If you're running Ubuntu, typically you install an Ubuntu +derivative focussed on a specific desktop environment - perhaps +[Kubuntu](https://kubuntu.org) for KDE. ## Applications and Repositories -Most Linux distributions are not only just the system and the desktop, but they are shipped with a vast catalogue of applications too. They might not be installed, and you'll need to use some sort of app store tool to install, remove etc applications. It's just like every modern mobile phone - they stole the idea from us! +Most Linux distributions are not only just the system and the desktop, but they +are shipped with a vast catalogue of applications too. They might not be +installed, and you'll need to use some sort of app store tool to install, remove +etc applications. It's just like every modern mobile phone - they stole the idea +from us! -We call this tool a package manager (we often call applications 'packages'), and a collection of applications is known as a repository, or repo. The Debian family use a program called `apt` as its package manager, and it ships with quite a large repository of apps you can choose from. Most guides, mine included, don't focus on showing you a usable app-store, just a method of installing from a repository. +We call this tool a package manager (we often call applications 'packages'), and +a collection of applications is known as a repository, or repo. The Debian +family use a program called `apt` as its package manager, and it ships with +quite a large repository of apps you can choose from. Most guides, mine +included, don't focus on showing you a usable app-store, just a method of +installing from a repository. -You might want to add another repository if to get access to additional software, new software that isn't shipped by the distribution's maintainers or some other reason. I keep more up to date versions of software in my repository than Raspberry Pi OS offers, and I have additional software that isn't offered by RasPi OS too. +You might want to add another repository if to get access to additional +software, new software that isn't shipped by the distribution's maintainers or +some other reason. I keep more up to date versions of software in my repository +than Raspberry Pi OS offers, and I have additional software that isn't offered +by RasPi OS too. ### Install from the Command Line @@ -89,7 +107,10 @@ In Linux we follow a different filesystem hierarchy, starting at the 'root' of t Paths always start with a `/`, and if it's a folder it will end with a `/` to indicate there is more depth below. -Devices, as they present, are often named by the class of device and a number starting at 0 to indicate which number it is. You'll commonly see references to `eth0`, showing the first ethernet device or `wlan0` showing the first wireless internet adaptor. A second would be `wlan1` etc. +Devices, as they present, are often named by the class of device and a number +starting at 0 to indicate which number it is. You'll commonly see references to +`eth0`, showing the first Ethernet device or `wlan0` showing the first wireless +internet adaptor. A second would be `wlan1` etc. If I look at my root filesystem, I see the following folders: @@ -176,7 +197,7 @@ Every Debian system ships with a text editor called `nano` which is relatively a You open your file directly, so to edit the BPQ config file, run `sudo nano /etc/bpq32.cfg`. This translates to: `As root user, open nano to edit /etc/bpq32.cfg` -Navigation is with arrow keys (no mouse, sorry!). There are a list of commands at the bottom of the screen - they use ^ as a shortcut to indicate you must press control at the same time as those letters. Similarly, M is an idication of 'meta' key, which will likely be the alt key. This is quite similar to keyboard shortcuts in Microsoft Word (ctrl&s for save, alt-f4 for exit). +Navigation is with arrow keys (no mouse, sorry!). There are a list of commands at the bottom of the screen - they use ^ as a shortcut to indicate you must press control at the same time as those letters. Similarly, M is an indication of 'meta' key, which will likely be the alt key. This is quite similar to keyboard shortcuts in Microsoft Word (ctrl&s for save, alt-f4 for exit). Some helpful commands to know: diff --git a/docs/modems/index.md b/docs/modems/index.md index 0c45753..1fce876 100644 --- a/docs/modems/index.md +++ b/docs/modems/index.md @@ -4,7 +4,7 @@ Modems are the part of a packet radio system that encodes data into audio for yo Modems have traditionally been dedicated hardware devices in packet radio, and in the last 20 years some software modems have been written as computers have become flexible and fast! -Moden modems come in many shapes and sizes. As long as the modem at each end of the link knows what they are sending and receiving, these are interchangable parts. Nothing stops you and a friend from experimenting with new modes in the UK, as long as you stay within given bandwidths and aren't intentionally obfuscating/encrypting data. +Modern modems come in many shapes and sizes. As long as the modem at each end of the link knows what they are sending and receiving, these are interchangeable parts. Nothing stops you and a friend from experimenting with new modes in the UK, as long as you stay within given bandwidths and aren't intentionally obfuscating/encrypting data. The key choices of modem as I'm presenting are: @@ -23,7 +23,7 @@ Other modems are available however, including but not limited to ## What is a TNC? -A term that appears regularly is 'TNC' or Terminal Node Controller, and often Modem & TNC are used interchangably, however I have made a choice to not conflate the two items. +A term that appears regularly is 'TNC' or Terminal Node Controller, and often Modem & TNC are used interchangeably, however I have made a choice to not conflate the two items. A TNC is a device containing not only the modem hardware, but often the Node software, personal mail, the entire logic for the AX.25 system and higher level protocols such as NET/ROM. It is effectively a complete networking computer in a box that you connected to with your computer over a serial link when computational power was a luxury not a right. @@ -33,9 +33,9 @@ In more modern packet systems, all of these roles are taken by the software we u We can still make use of legacy TNC units - KISS mode (Keep It Simple Stupid!) strips away all of the AX.25 and other functionality of the TNC and makes it only pass serial data it is given. We use the same serial commands of KISS mode now for the majority of modems as it is simple and well documented. -Alternative modem command sets exist - onces I can name easily are: +Alternative modem command sets exist - ones I can name easily are: | Command Protocol | Description | ---------------- | ----------- -| AGW or AGWPE | From AGW Packet Engine. A properitary command set that was originally released to interact with the software it is named after +| AGW or AGWPE | From AGW Packet Engine. A proprietary command set that was originally released to interact with the software it is named after | 6pack | 6pack offers more control over the radio and more awareness for the PC what is happening at the cost of greater complexity diff --git a/docs/modems/ninotnc.md b/docs/modems/ninotnc.md index a832431..e82a2db 100644 --- a/docs/modems/ninotnc.md +++ b/docs/modems/ninotnc.md @@ -14,7 +14,7 @@ For the UK & Ireland, boards are are available from [Tom, M0LTE](https://ko-fi.c ## Build -The build gide for the NinoTNC is available on the [TARPN Website](https://tarpn.net/t/nino-tnc/nino-tnc.html). +The build guide for the NinoTNC is available on the [TARPN Website](https://tarpn.net/t/nino-tnc/nino-tnc.html). ## Operation @@ -60,9 +60,9 @@ Why? Simply put, see the below three statements but tread carefully. Not all thi Modulation: These modes offer increasing bandwidth efficiency, with QPSK being our over SSB being our preferred - AFSK over FM is the least efficient mode. -Protocol: IL2P+CRC is the most resilent mode against corruption or data loss as it transits the air, with AX.25 being unprotected against this. +Protocol: IL2P+CRC is the most resilient mode against corruption or data loss as it transits the air, with AX.25 being unprotected against this. -Mode: SSB is preferred as the channels are narrower and allow for more flexibility - tigher filtering and better amplification per hz. FM is good enough, however. +Mode: SSB is preferred as the channels are narrower and allow for more flexibility - tighter filtering and better amplification per hz. FM is good enough, however. ### Signals Switch diff --git a/docs/repo.md b/docs/repo.md index 199a9e0..b9e4968 100644 --- a/docs/repo.md +++ b/docs/repo.md @@ -2,14 +2,15 @@ ## Script -The script requires dowloaded, set to executable and run and is a little simpler than the manual setup - thanks to John M5ET for writing it! +The script requires downloaded, set to executable and run and is a little simpler than the manual setup - thanks to John M5ET for writing it! I strongly recommend you read through it **before** running it - it should look similar to the manual method below. **General computer security advice is to not blindly run scripts you downloaded from the internet!** -Download the script from: [[https://guide.foxk.it/static/files/setup.sh]] +Download the script from: +[https://guide.foxk.it/static/files/setup.sh](https://guide.foxk.it/static/files/setup.sh). -Lines you can run in the command line are: +This, sadly, must be run in the command line - the lines to run it are: ``` cd /tmp @@ -32,6 +33,9 @@ You can trust this key - it is contained in [Debian](https://salsa.debian.org/de ## Set up Repo Then you need to add the repo for your OS: +### Ubuntu 24.04 LTS amd64 +`sudo sh -c 'echo "deb +https://online-amateur-radio-club-m0ouk.github.io/oarc-packages noble main" >> /etc/apt/sources.list'` ### Ubuntu 22.04 LTS amd64 `sudo sh -c 'echo "deb https://online-amateur-radio-club-m0ouk.github.io/oarc-packages jammy main" >> /etc/apt/sources.list'`