From a882ef8eb2342872a7e577f84d601f7974af84f2 Mon Sep 17 00:00:00 2001 From: Dave Hibberd Date: Wed, 27 Mar 2024 01:41:25 +0000 Subject: [PATCH] New update --- .gitignore | 1 + docs/install/bpq.md | 39 ++++-------------------- docs/install/linux.md | 68 ++++++++++++++++++++++++++++++++++++++++++ docs/radios/ft-7900.md | 22 ++++++++++++++ docs/radios/ft-891.md | 22 ++++++++++++++ docs/radios/gm340.md | 24 ++++++++------- docs/radios/index.md | 20 +++++++++++-- docs/repo.md | 39 ++++++++++++++++++++++++ mkdocs.yml | 12 ++++++-- 9 files changed, 197 insertions(+), 50 deletions(-) create mode 100644 .gitignore create mode 100644 docs/install/linux.md create mode 100644 docs/radios/ft-7900.md create mode 100644 docs/radios/ft-891.md create mode 100644 docs/repo.md diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..45ddf0a --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +site/ diff --git a/docs/install/bpq.md b/docs/install/bpq.md index 5df166b..5bc237e 100644 --- a/docs/install/bpq.md +++ b/docs/install/bpq.md @@ -1,48 +1,19 @@ # BPQ -## Raspberry Pi -### Install Key -**Do this once, only.** +## Set Up Repo -Our very own Hibby MM0RFN, also a Debian maintainer, has kindly packaged and is maintaining various Linux packet radio software, among them LinBPQ. +If you have not already done so, set up the repo [as shown here](../repo.md). -To start using his repo, you need tell your machine to trust the repo: +## Install -``` -wget -q https://online-amateur-radio-club-m0ouk.github.io/oarc-packages/hibby.key -sudo mv hibby.key /etc/apt/trusted.gpg.d/hibby.asc -``` - -### Set up Repo -Then you need to add the repo for your OS: - -``` -# 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' - -# Raspberry Pi OS 12 - 'Bookworm' -sudo sh -c 'echo "deb https://online-amateur-radio-club-m0ouk.github.io/oarc-packages bookworm main" >> /etc/apt/sources.list' - -# Raspberry Pi OS 11 - 'Bullseye' -sudo sh -c 'echo "deb https://online-amateur-radio-club-m0ouk.github.io/oarc-packages bullseye main" >> /etc/apt/sources.list' - -# Debian 13 amd64 -sudo sh -c 'echo "deb https://online-amateur-radio-club-m0ouk.github.io/oarc-packages testing main" >> /etc/apt/sources.list' - -# Debian 12 amd64 -sudo sh -c 'echo "deb https://online-amateur-radio-club-m0ouk.github.io/oarc-packages bookworm main" >> /etc/apt/sources.list' -``` - -### Install - -After following the above steps, to install LinBPQ, run the below commands: +To install LinBPQ from the repo, run the below commands: ``` sudo apt update sudo apt install linbpq ``` -### Configure +## Configure ``` sudo mv /usr/share/doc/linbpq/examples/bpq32.cfg /etc/bpq32.cfg diff --git a/docs/install/linux.md b/docs/install/linux.md new file mode 100644 index 0000000..e9ca3e6 --- /dev/null +++ b/docs/install/linux.md @@ -0,0 +1,68 @@ +# Linux Native Stack + +The linux native stack is highly configurable and can be easily installed on all Debian distros. + +## Install + +To get a basic node setup, the minimum viable software is: + +`apt install libax25 ax25-tools ax25-apps uronode` + +### BBS + +To set up a BBS install fbb + +`apt install fbb` + +## Basic Config + +We shall set up a single AX.25 port to receive calls and display Uronode to calling stations. + +### ax25 ports + +Set up your ax25 ports in `/etc/ax25/axports` + +The following example is for a NinoTNC: +``` +# /etc/ax25/axports +# +# The format of this file is: +# +# name callsign speed paclen window description +# +uhf UR0CAL-10 57600 255 2 UHF 9600bd +``` + +Modify the callsign to your own or your station's call. + +This has to be attached as to the modem, in effect telling the computer to +listen to the modem's output. Run the below as root: + +`kissattach /dev/ttyACM0 uhf` + +### ax25d + +ax25d (ax25 daemon) listens to incoming data and directs calling stations to the application you want them to use. +It can present different applications based on any combination of the callsign calling you, the callsign and SSID the calling station is calling and the port they are calling to. + +ax25d is controlled by `/etc/ax25/ax25d.conf` + +``` +# /etc/ax25/ax25d.conf +# +# ax25d Configuration File. +# +# AX.25 Ports begin with a '['. +# +[UR0CAL-10 via uhf] +NOCALL * * * * * * L +default * * * * * * - root /usr/sbin/uronode uronode +``` + +Note the callsign, SSID and port are aligned with the axport in this example. Similar to axports, modify UR0CAL to our own callsign or your station's callsign. + +ax25d is started by running the below as root: + +`ax25d` + +Stations should be able to call uronode on your system using AX.25. diff --git a/docs/radios/ft-7900.md b/docs/radios/ft-7900.md new file mode 100644 index 0000000..718cafa --- /dev/null +++ b/docs/radios/ft-7900.md @@ -0,0 +1,22 @@ +# Yaesu FT-7900 + +The FT-7900 is an 2m & 70cm radio manufactured by Yaesu from 2010 to the present day. + +## Bands + +| Band | Power | Modulation | +| ---- | ----- | ---------- | +| 2m | 0 - 50W | FM | +| 70cm | 0 - 40W | FM | + +## Interface + +Yaesu Mini DIN + +## Settings + +## Known Examples + +| Location | Band | Modem | Mode | +| -------- | ---- | ----- | ---- | +| GB7HIB VHF Port | 2m | [NinoTNC](../modems/ninotnc.md) | 1200bd IL2P | diff --git a/docs/radios/ft-891.md b/docs/radios/ft-891.md new file mode 100644 index 0000000..cfedee7 --- /dev/null +++ b/docs/radios/ft-891.md @@ -0,0 +1,22 @@ +# Yaesu FT-891 + +The FT-891 is an HF & 6m radio manufactured by Yaesu from 2016 to the present day. + +## Bands + +| Band | Power | Modulation | +| ---- | ----- | ---------- | +| HF | 0 - 100W | SSB | +| 6m | 0 - 100W | SSB, FM | + +## Interface + +Yaesu Mini DIN + +## Settings + +## Known Examples + +| Location | Band | Modem | Mode | +| -------- | ---- | ----- | ---- | +| GB7HIB HF Port | 40m | [NinoTNC](../modems/ninotnc.md) | 300bd IL2P | diff --git a/docs/radios/gm340.md b/docs/radios/gm340.md index 2d0203f..9ad3b2a 100644 --- a/docs/radios/gm340.md +++ b/docs/radios/gm340.md @@ -1,18 +1,20 @@ # GM340 -The Motorola GM340 can be configured as VHF or UHF at the factory and supports deviation suitable for 1200bd and 9600bd +The Motorola GM340 is a commercial radio. It can be configured as VHF or UHF at the factory and supports deviation suitable for 1200bd and 9600bd. -## Prior Example +## Bands + +| Band | Power | Modulation | +| ---- | ----- | ---------- | +| UHF | 25W | FM | + +## Interface + +## Settings + + +## Known Example MM0RFN is using a GM340 as the 9600bd/UHF port on GB7HIB. General programming advice from [BI7JTA](https://www.bi7jta.org/wiki/index.php?title=Main_Page#GM340.2FGM350.2FGM360) was followed, including connector definition. - -## Power - -To change output power, open GM340 > Per Radio > RF with a double click and vary high/low power modes - -## RF Channel Properties - -To change frequency, open GM340 > per Channel > double click a channel and assign new frequency, spacing and power level (defined in Power section) - diff --git a/docs/radios/index.md b/docs/radios/index.md index d7d4dd8..8126039 100644 --- a/docs/radios/index.md +++ b/docs/radios/index.md @@ -4,6 +4,20 @@ There are a huge number of radios we can use for packet radio, and they can be s ## Known good Beginner Radios -| Radio | -| ----- | -| [GM340](gm340.md) | +| Manufacturer | Radio | Band | +| ------------ | ----- | ---- | +| Motorola | [GM340](gm340.md) | UHF | +| Yaesu | [FT-7900](ft-7900.md) | VHF / UHF | + +## VHF/UHF Radios + +| Manufacturer | Radio | Band | +| ------------ | ----- | ---- | +| Motorola | [GM340](gm340.md) | UHF | +| Yaesu | [FT-7900](ft-7900.md) | VHF / UHF | + +## HF Radios + +| Manufacturer | Radio | +| ------------ | ----- | +| Yaesu | [FT-891](ft-891.md) | diff --git a/docs/repo.md b/docs/repo.md new file mode 100644 index 0000000..7f7f835 --- /dev/null +++ b/docs/repo.md @@ -0,0 +1,39 @@ +# Hibby's Repo +## Install Signing Key + +First, you need tell your machine to trust the signature I verify the packages with: + +``` +wget -q https://online-amateur-radio-club-m0ouk.github.io/oarc-packages/hibby.key +sudo mv hibby.key /etc/apt/trusted.gpg.d/hibby.asc +``` + +You can trust this key - it is contained in [Debian](https://salsa.debian.org/debian-keyring/keyring/-/blob/master/debian-keyring-gpg/0x03A1FB7A1904771B?ref_type=heads) and signed as trusted by other developers in the project. + +## Set up Repo +Then you need to add the repo for your OS: + +``` +# 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' + +# Raspberry Pi OS 12 - 'Bookworm' +sudo sh -c 'echo "deb https://online-amateur-radio-club-m0ouk.github.io/oarc-packages bookworm main" >> /etc/apt/sources.list' + +# Raspberry Pi OS 11 - 'Bullseye' +sudo sh -c 'echo "deb https://online-amateur-radio-club-m0ouk.github.io/oarc-packages bullseye main" >> /etc/apt/sources.list' + +# Debian 13 amd64 +sudo sh -c 'echo "deb https://online-amateur-radio-club-m0ouk.github.io/oarc-packages testing main" >> /etc/apt/sources.list' + +# Debian 12 amd64 +sudo sh -c 'echo "deb https://online-amateur-radio-club-m0ouk.github.io/oarc-packages bookworm main" >> /etc/apt/sources.list' +``` + +## Update + +Once the repo is setup, refresh your package lists and we're good to go: + +``` +sudo apt update +``` diff --git a/mkdocs.yml b/mkdocs.yml index abaabd0..ab8ee22 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -3,6 +3,7 @@ site_url: https://packetradio.debian.net nav: - Home: "index.md" - About: "about.md" + - Glossary: "glossary.md" - Radios: - "radios/index.md" - Modems: @@ -14,7 +15,14 @@ nav: - Software Setup: - "software.md" - BPQ: "install/bpq.md" + - Linux: "install/linux.md" - Node Configuration: - BPQ: "config/bpq.md" - - Glossary: "glossary.md" -theme: readthedocs + - Misc: + - Repo Setup: "repo.md" +theme: + name: readthedocs + navigation_depth: 5 + collapse_navigation: False + sticky_navigation: False + highlightjs: True