doc-tools - Added initial tools for creating static documentation

Merge release/r4 to dev

RELEASES.md

@@ -1,5 +1,42 @@
 # EmComm Tools OS Community Release
 
+# 2025.04.01.R4 (4.0.0)
+
+* Tier 1 radio PnP support
+  * Yaesu FT-991A
+* Tier 2 radio PnP support
+  * Icom IC-7300
+  * Elecraft KX2 (DigiRig Mobile)
+* et-mode
+  * BBS Client 1: Paracon (AGW radio terminal)
+  * BBS Client 2: QtTermTCP (multi mode radio terminal)
+  * BBS Server: 1200 baud packet node/BBS using LinBPQ 
+  * Chattervox: Packet-based chat client
+  * Added 300, 1200, and 9600 baud packet packet to direwolf
+  * Added VARA HF and VARA FM mode selection if installed
+* GPS PnP support
+  * Dell 7220 (u-blox 8 receiver)
+* Winlink
+  * Enabled P2P listening for AX.25 and ARDOP
+  * Updated RMS list as of 03/27/25
+* Bluetooth TNC support
+  * et-uv-pro: Support for BTECH UV Pro
+  * et-vr-n76: support for Vero VGC NR-76
+  * et-th-d74: support for Kenwood TH-D74
+  * Added support for: axcall, QtTermTCP, Winlink, and YAAC
+* WINE
+  * Added basic installation of WINE
+  * Added scripts (`~/add-on/wine/*.sh`) to install VARA HF/FM
+* Misc
+  * Added kiwix for offline Wikipedia and/or .zim browsing
+  * et-user-backup: Performs ETC configuration backup
+  * et-user-restore: Restores ETC configuration
+  * Added misc tooling: pup, socat 
+* Bug fixes
+  * Updated OSM map downloader to work with updates to Geofabrik site
+  * Fixed formatting of et-radio text output
+  * Resolved inconsistent Conky startup behavior
+
 # 2024.11.27.R3 (3.0.0)
 
 * Plug-and-Play (PnP) support for CAT control, sound card, and GPS

overlay/etc/skel/add-ons/docs/create-doc-site.sh

@@ -0,0 +1,25 @@
+#!/bin/bash
+# Author  : Gaston Gonzalez
+# Date    : 3 April 2025
+# Updated : 24 April 2024
+# Purpose : Creates a Jekyll doc site
+set -e
+source /opt/emcomm-tools/bin/et-common
+
+function usage() {
+  echo "$(basename $0) <site-name>"
+}
+
+if [[ $# -ne 1 ]]; then
+  usage
+  exit 1
+fi
+
+SITE="$1"
+
+rbenv local 3.3.8
+gem install jekyll bundler && jekyll new ${SITE}
+
+echo -e "${YELLOW}1. Move into the site directory: ${WHITE}cd ${SITE}${NC}"
+echo -e "${YELLOW}2. Build and start site: ${WHITE}bundle exec jekyll serve${NC}" 
+echo -e "${YELLOW}3. Access site in web browser: ${WHITE}min http://localhost:4000${NC}" 

overlay/etc/skel/add-ons/docs/install-doc-tools.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+# Author  : Gaston Gonzalez
+# Date    : 2 April 2025
+# Updated : 24 April 2025
+# Purpose : Installs documentation tooling
+set -e
+
+RUBY_VERSION="3.3.8"
+
+if [[ "${EUID}" -eq 0 ]]; then
+  echo "This script be run as your normal user, not as root."
+  exit 1
+fi
+
+if [[ ! -e ~/.rbenv ]]; then
+  echo "Install 'rbenv' into your home directory..."
+  git clone https://github.com/rbenv/rbenv.git ~/.rbenv
+
+  echo "Adding 'rbenv' into your path..."
+  echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bash_profile
+  echo 'eval "$(rbenv init - bash)"' >> ~/.bash_profile
+
+  echo "Adding 'ruby-build' plugin..."
+  git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
+fi
+
+source ~/.bash_profile
+
+
+echo "Installing Ruby ${RUBY_VERSION}..."
+rbenv install ${RUBY_VERSION}
+rbenv global ${RUBY_VERSION}
+
+echo "Using ruby version: $(ruby -v)"
+echo "Using gem version: $(gem -v)"
+
+ruby -v | grep "${RUBY_VERSION}"
+if [[ $? -ne 0 ]]; then
+  "The documentation tool requires Ruby ${RUBY_VERSION}."
+  exit 1
+fi

overlay/opt/emcomm-tools/bin/et-vr-n76

@@ -4,7 +4,7 @@
 #          : Cliff Jones
 # Date     : 1 January 2025
 # Updated  : 17 March 2025
-# Purpose  : Utility for accessing the Bluetooth TNC on the BTECH UV PRO.           
+# Purpose  : Utility for accessing the Bluetooth TNC on the Vero VGC VR-N76.           
 source /opt/emcomm-tools/bin/et-common
 
 CLEAN_UP=1

overlay/opt/emcomm-tools/conf/radios.d/elecraft-kx2.json

@@ -0,0 +1,16 @@
+{
+  "id": "elecraft-kx2",
+  "vendor": "Elecraft",
+  "model": "KX-2 (DigiRig)",
+  "rigctrl": {
+    "id": "2044",
+    "baud": "38400",
+    "ptt": "RTS"
+  },
+  "notes": [
+    "In Menu set RS232 to 38400 b",
+    "Note current Mic Gain setting then set to 5 (ALC meter should read 3-5 bars during TX)",
+    "Set AF Gain to 15 (ensure input level is green in JS8CALL)",
+    "For voice operation, return Mic Gain to setting noted above (25 typical)"
+  ]
+}

scripts/install-dev-tools.sh

@@ -2,7 +2,7 @@
 #
 # Author  : Gaston Gonzalez
 # Date    : 29 December 2023
-# Updated : 20 October 2024
+# Updated : 24 April 2025
 # Purpose : Install development tools
 set -e
 
@@ -37,3 +37,10 @@ then
   sudo apt update
   sudo apt install --no-install-recommends cubic -y
 fi
+
+
+# libyaml-dev - needed for Ruby via rbenv
+et-log "Installing tools needed for ETC R5"
+apt install \
+  libyaml-dev \
+  -y