1
0
mirror of https://github.com/AG7GN/nexus-utilities.git synced 2025-05-15 22:20:09 -07:00

replace references to 'hampi' with 'nexus'

This commit is contained in:
Steve Magnuson 2020-08-30 08:35:16 -07:00
parent 750f9ccef0
commit 668f38863f
6 changed files with 19 additions and 19 deletions

View File

@ -1,10 +1,10 @@
# Hampi Utilities # Nexus Utilities
VERSION 2020721 VERSION 20200830
AUTHOR: Steve Magnuson, AG7GN AUTHOR: Steve Magnuson, AG7GN
This is a collection of utilities for the Hampi image. These scripts will only work on the Hampi image. This is a collection of utilities for the Nexus image. These scripts will only work on the Nexus image.
Some scripts are specific to the [Nexus DR-X](http://wb7fhc.com/nexus-dr-x.html) board. Some scripts are specific to the [Nexus DR-X](http://wb7fhc.com/nexus-dr-x.html) board.
[Check Piano script](#check-piano-script) [Check Piano script](#check-piano-script)
@ -51,7 +51,7 @@ Some scripts are specific to the [Nexus DR-X](http://wb7fhc.com/nexus-dr-x.html)
### Install ### Install
- Click __Raspberry > Hamradio > Update Pi and Ham Apps__. - Click __Raspberry > Hamradio > Update Pi and Ham Apps__.
- Check __hampi-utilities__, click __OK__. - Check __nexus-utilities__, click __OK__.
## Check Piano script ## Check Piano script
@ -113,7 +113,7 @@ If `DO_NOT_DELETE_THIS_FILE` is present in the home folder, the script exits wit
## Direwolf and pat GUI ## Direwolf and pat GUI
`dw_pat_gui.sh` provides a GUI to configure the Direwolf TNC and [pat](https://getpat.io/) to make a functional Winlink email client on Hampi. It also provides a monitor window that shows messages from both Direwolf and pat. `dw_pat_gui.sh` provides a GUI to configure the Direwolf TNC and [pat](https://getpat.io/) to make a functional Winlink email client on Nexus DR-X. It also provides a monitor window that shows messages from both Direwolf and pat.
If you make any changes in either of the Configure tabs, click __Restart Direwolf and pat__ to activate the changes. If you make any changes in either of the Configure tabs, click __Restart Direwolf and pat__ to activate the changes.
@ -121,7 +121,7 @@ If you make any changes in either of the Configure tabs, click __Restart Direwol
Shows the output of the Direwolf TNC and [pat](https://github.com/la5nta/pat/wiki) applications. Near the top of the Monitor tab window, youll see a row that looks something like this: Shows the output of the Direwolf TNC and [pat](https://github.com/la5nta/pat/wiki) applications. Near the top of the Monitor tab window, youll see a row that looks something like this:
`AGW Port: 8001 KISS Port: 8011 pat Telnet Port: 8770 pat Web Server: http://hampi-ag7gn.local:8040` `AGW Port: 8001 KISS Port: 8011 pat Telnet Port: 8770 pat Web Server: http://nexus-ag7gn.local:8040`
The first 3 items are port numbers that your Pi is listening on for various connections from other clients. Use the KISS port, for example, if you have Windows PCs running Winlink Express on the same network as your Pi. The first 3 items are port numbers that your Pi is listening on for various connections from other clients. Use the KISS port, for example, if you have Windows PCs running Winlink Express on the same network as your Pi.
@ -162,7 +162,7 @@ Configures the pat Winlink email client.
Clicking this button brings up a window that allows you to search for RMS gateway stations (the output of the `pat rmslist` command) and add them to pat's connection alias list. These aliases are available in a dropdown in the pat web interface __Connection__ dialog to make it easy to select RMS gateway stations to connect to. Clicking this button brings up a window that allows you to search for RMS gateway stations (the output of the `pat rmslist` command) and add them to pat's connection alias list. These aliases are available in a dropdown in the pat web interface __Connection__ dialog to make it easy to select RMS gateway stations to connect to.
`pat` has a restriction in that if you include a frequency in an connection alias, you must also run `rigctld` while running pat. [Hamlib](https://hamlib.github.io), which provides `rigctld`, is already installed in Hampi. If you don't already run rigctl, this configuration gui will configure `rigctld` to use a "dummy" rig to fool pat into thinking it's talking to your radio via `rigctld`. Note that when `rigctld` is used with a "dummy" radio, you must manually set your radio to the desired frequency. `pat` has a restriction in that if you include a frequency in an connection alias, you must also run `rigctld` while running pat. [Hamlib](https://hamlib.github.io), which provides `rigctld`, is already installed in Nexus DR-X. If you don't already run rigctl, this configuration gui will configure `rigctld` to use a "dummy" rig to fool pat into thinking it's talking to your radio via `rigctld`. Note that when `rigctld` is used with a "dummy" radio, you must manually set your radio to the desired frequency.
### Rig Control tab ### Rig Control tab
@ -170,7 +170,7 @@ Provides information about how `pat` uses rig control. A __Manage Hamlib rigctl
## ARDOP and pat gui ## ARDOP and pat gui
`ardop_pat_gui.sh` provides a GUI to configure the [piardopc](http://www.cantab.net/users/john.wiseman/Documents/ARDOPC.html) TNC (which implements ARDOP version 1) and [pat](https://getpat.io/) to make a functional Winlink email client on Hampi. It also provides a monitor window that shows messages from both piardopc and pat. `ardop_pat_gui.sh` provides a GUI to configure the [piardopc](http://www.cantab.net/users/john.wiseman/Documents/ARDOPC.html) TNC (which implements ARDOP version 1) and [pat](https://getpat.io/) to make a functional Winlink email client on Nexus DR-X. It also provides a monitor window that shows messages from both piardopc and pat.
If you make any changes in either of the Configure tabs, click __Restart ARDOP and pat__ to activate the changes. If you make any changes in either of the Configure tabs, click __Restart ARDOP and pat__ to activate the changes.
@ -207,7 +207,7 @@ If you make any changes in either of the Configure tabs, click __Restart ARDOP a
Configures the pat Winlink email client. Clicking the __Edit pat Connection Aliases__ button brings up a window that allows you to search for RMS gateway stations (the output of the `pat rmslist` command) and add them to pat's connection alias list. These aliases are available in a dropdown in the pat web interface __Connection__ dialog to make it easy to select RMS gateway stations to connect to. Configures the pat Winlink email client. Clicking the __Edit pat Connection Aliases__ button brings up a window that allows you to search for RMS gateway stations (the output of the `pat rmslist` command) and add them to pat's connection alias list. These aliases are available in a dropdown in the pat web interface __Connection__ dialog to make it easy to select RMS gateway stations to connect to.
pat has a restriction in that if you include a frequency in an connection alias, you must also run `rigctld` while running pat. [Hamlib](https://hamlib.github.io), which provides `rigctld`, is already installed in Hampi. If you don't already run rigctl, this configuration gui will configure `rigctld` to use a "dummy" rig to fool pat into thinking it's talking to your radio via `rigctld`. Note that when `rigctld` is used with a "dummy" radio, you must manually set your radio to the desired frequency. pat has a restriction in that if you include a frequency in an connection alias, you must also run `rigctld` while running pat. [Hamlib](https://hamlib.github.io), which provides `rigctld`, is already installed in Nexus DR-X. If you don't already run rigctl, this configuration gui will configure `rigctld` to use a "dummy" rig to fool pat into thinking it's talking to your radio via `rigctld`. Note that when `rigctld` is used with a "dummy" radio, you must manually set your radio to the desired frequency.
If you make any changes in either of the Configure tabs, click __Save Settings & Restart ARDOP + pat__ to activate the changes. If you make any changes in either of the Configure tabs, click __Save Settings & Restart ARDOP + pat__ to activate the changes.
@ -246,7 +246,7 @@ If you make any changes in either of the Configure tabs, click __Save Settings &
Clicking this button brings up a window that allows you to search for RMS gateway stations (the output of the `pat rmslist` command) and add them to pat's connection alias list. These aliases are available in a dropdown in the pat web interface __Connection__ dialog to make it easy to select RMS gateway stations to connect to. Clicking this button brings up a window that allows you to search for RMS gateway stations (the output of the `pat rmslist` command) and add them to pat's connection alias list. These aliases are available in a dropdown in the pat web interface __Connection__ dialog to make it easy to select RMS gateway stations to connect to.
`pat` has a restriction in that if you include a frequency in an connection alias, you must also run `rigctld` while running pat. [Hamlib](https://hamlib.github.io), which provides `rigctld`, is already installed in Hampi. If you don't already run rigctl, this configuration gui will configure `rigctld` to use a "dummy" rig to fool pat into thinking it's talking to your radio via `rigctld`. Note that when `rigctld` is used with a "dummy" radio, you must manually set your radio to the desired frequency. `pat` has a restriction in that if you include a frequency in an connection alias, you must also run `rigctld` while running pat. [Hamlib](https://hamlib.github.io), which provides `rigctld`, is already installed in Nexus DR-X. If you don't already run rigctl, this configuration gui will configure `rigctld` to use a "dummy" rig to fool pat into thinking it's talking to your radio via `rigctld`. Note that when `rigctld` is used with a "dummy" radio, you must manually set your radio to the desired frequency.
### Rig Control tab ### Rig Control tab
@ -316,7 +316,7 @@ To change it to trim log entries older than 2 weeks ago rather than yesterday, t
`shutdown_button.py` monitors the shutdown button found on the DigiLink REV DS and [Nexus DR-X](http://wb7fhc.com/nexus-dr-x.html) boards. It reboots the Pi if the button is pressed more than 2 but less than 5 seconds, or shuts down the Pi if the button is pressed for more than 5 seconds. `shutdown_button.py` monitors the shutdown button found on the DigiLink REV DS and [Nexus DR-X](http://wb7fhc.com/nexus-dr-x.html) boards. It reboots the Pi if the button is pressed more than 2 but less than 5 seconds, or shuts down the Pi if the button is pressed for more than 5 seconds.
Your Hampi image already has the systemd service file for the shutdown script installed and enabled. No further action is required to enable it, but __for documentation purposes only__, here's how to enable the service manually: Your Nexus DR-X image already has the systemd service file for the shutdown script installed and enabled. No further action is required to enable it, but __for documentation purposes only__, here's how to enable the service manually:
- As sudo, create a file called `/etc/systemd/system/shutdown_button.service` with the following text: - As sudo, create a file called `/etc/systemd/system/shutdown_button.service` with the following text:
@ -357,11 +357,11 @@ These files are stored in `/usr/local/share/applications` and are used as templa
## Edit Desktop Text script ## Edit Desktop Text script
`edit-desktop.sh` allows you to edit the default Nexus DR-X desktop background, which was introduced in Hampi version 20191214. `edit-desktop.sh` allows you to edit the default Nexus DR-X desktop background, which was introduced in Nexus DR-X version 20191214.
If your image is older than 20191214 and you want to install the customizable Nexus desktop background, you must do run these commands in the Terminal before you can run the new 'Edit Desktop Background Text script (__NOTE: This will REPLACE your current desktop background__): If your image is older than 20191214 and you want to install the customizable Nexus desktop background, you must do run these commands in the Terminal before you can run the new 'Edit Desktop Background Text script (__NOTE: This will REPLACE your current desktop background__):
cp /usr/local/src/hampi/desktop-items-0.conf $HOME/.config/pcmanfm/LXDE-pi/ cp /usr/local/src/nexus/desktop-items-0.conf $HOME/.config/pcmanfm/LXDE-pi/
pcmanfm --reconfigure pcmanfm --reconfigure
After you start the script (__Raspberry > Preferences > Edit Desktop Background Text__), enter the text you want to display and optionally check the box to show your Pi's host name, then click __OK__. The script won't close until you Cancel, so click __Cancel__ when you're satisfied with your new desktop. After you start the script (__Raspberry > Preferences > Edit Desktop Background Text__), enter the text you want to display and optionally check the box to show your Pi's host name, then click __OK__. The script won't close until you Cancel, so click __Cancel__ when you're satisfied with your new desktop.

View File

@ -8,7 +8,7 @@
#% DESCRIPTION #% DESCRIPTION
#% This script provides a GUI to configure and start/stop #% This script provides a GUI to configure and start/stop
#% piardop2, pat and gARIM. It is designed to work on the #% piardop2, pat and gARIM. It is designed to work on the
#% Hampi image. #% Nexus image.
#% #%
#% OPTIONS #% OPTIONS
#% -h, --help Print this help #% -h, --help Print this help

View File

@ -8,7 +8,7 @@
#% DESCRIPTION #% DESCRIPTION
#% This script provides a GUI to configure and start/stop #% This script provides a GUI to configure and start/stop
#% Direwolf as an iGate, Digipeater or both. #% Direwolf as an iGate, Digipeater or both.
#% It is designed to work on the Hampi image. #% It is designed to work on the Nexus image.
#% #%
#% OPTIONS #% OPTIONS
#% -h, --help Print this help #% -h, --help Print this help
@ -457,7 +457,7 @@ fi
export -f setDefaults loadAPRSDefaults killDirewolf export -f setDefaults loadAPRSDefaults killDirewolf
export load_aprs_defaults_cmd='@bash -c "setDefaults; loadAPRSDefaults"' export load_aprs_defaults_cmd='@bash -c "setDefaults; loadAPRSDefaults"'
export click_aprs_help_cmd='bash -c "xdg-open /usr/local/share/hampi/aprs_help.html"' export click_aprs_help_cmd='bash -c "xdg-open /usr/local/share/nexus/aprs_help.html"'
export PIPEDATA=$PIPE export PIPEDATA=$PIPE
#============================ #============================

View File

@ -7,7 +7,7 @@
#% #%
#% DESCRIPTION #% DESCRIPTION
#% This script provides a GUI to configure and start/stop #% This script provides a GUI to configure and start/stop
#% Direwolf and pat. It is designed to work on the Hampi image. #% Direwolf and pat. It is designed to work on the Nexus image.
#% #%
#% OPTIONS #% OPTIONS
#% -h, --help Print this help #% -h, --help Print this help
@ -395,7 +395,7 @@ cat $PAT_CONFIG | jq --arg R "network" '.ax25.rig = $R' | sponge $PAT_CONFIG
export -f setTNCpatDefaults loadpatDefaults export -f setTNCpatDefaults loadpatDefaults
export load_pat_defaults_cmd='@bash -c "setTNCpatDefaults; loadpatDefaults"' export load_pat_defaults_cmd='@bash -c "setTNCpatDefaults; loadpatDefaults"'
export click_dw_pat_help_cmd='bash -c "xdg-open /usr/local/share/hampi/dw_pat_gui_help.html"' export click_dw_pat_help_cmd='bash -c "xdg-open /usr/local/share/nexus/dw_pat_gui_help.html"'
export PIPEDATA=$PIPE export PIPEDATA=$PIPE
#============================ #============================

View File

@ -9,7 +9,7 @@
#% This script provides a GUI to add aliases to pat's config.json #% This script provides a GUI to add aliases to pat's config.json
#% file by making selections from the output of 'pat rmslist'. #% file by making selections from the output of 'pat rmslist'.
#% These aliases are available in pat's web interface. #% These aliases are available in pat's web interface.
#% This script is designed to work on the Hampi image. #% This script is designed to work on the Nexus image.
#% This script requires these packages: jq moreutils. #% This script requires these packages: jq moreutils.
#% #%
#% OPTIONS #% OPTIONS