Direwolf + pat GUI Help

This program allows you to configure Direwolf and pat and monitor the output of both programs. Direwolf enables a pseudo terminal using AX.25 port 'wl2k' for the KISS protocol, which is required by pat as well as some other AX.25 programs. The AGW and KISS TCP ports are available to applications running on this Pi as well as over the network. This allows other hosts, like Windows PCs running RMS Express to use the Direwolf TNC running on this Pi. The AX.25 port 'wl2k' is available to other applications running on this Pi as well.


Table of Contents

Buttons

Monitor tab
Configure TNC tab
    Call Sign
    Direwolf Capture/Playback ADEVICEs
    Direwolf ARATE
    Direwolf PTT
    Audio Stats interval
    AGW Port
    KISS Port

Configure pat tab
    Call Sign
    Winlink Password
    Locator Code
    Web Service Port
    Telnet Service Port
    Telnet Service Password
    AX25 Beacon Interval
    AX25 Beacon Message
    Start pat web service when Direwolf TNC starts
    AX25 Timers (TX delay, TX tail, Persist, Slot time)
    Load Default AX25 Timers button
    Edit pat Connection aliases button

Rig Control tab

Buttons

Stop Direwolf + pat & Exit

This button has the same effect as closing the app by clicking X in the upper right corner.

Save Settings & Restart Direwolf + pat

The GUI will disappear for a few seconds and then reappear when it restarts.

Open pat Web Interface

Opens the Pi's browser and connects it to pat's web service.

Top

Monitor tab

This tab displays the output of the Direwolf and pat programs. At the top of the pane are the currently configured AGW and KISS TCP ports, the AX.25 port, pat's telnet port and if pat is running, the URI you use to access the pat web interface.


Configure TNC tab

Configuration parameters for the Direwolf TNC. When Direwolf starts, it sets up a pseudo terminal using port "wl2k" as defined in /etc/ax25/axports.

Top

Call Sign

Your call sign with no SSID

Direwolf Capture/Playback ADEVICEs

Sound card interface for capture and playback specific to the Nexus DR-X + Fe-Pi sound card.

ADEVICE Left Radio Right Radio

Capture

fepi-capture-left

fepi-capture-right

Playback

fepi-playback-left

fepi-playback-right


Top

Direwolf ARATE

Number of audio samples per second. Depends on the capabilities of the sound card. The Fe-Pi supports up to 96000.

Top

Direwolf PTT

The GPIO (BCM numbering) pin to use for Push To Talk. Nexus DR-X is wired to use pin 12 for the left radio and pin 23 for the right radio.

Top

Direwolf Audio Stats

Print Direwolf's audio statistics every x seconds. Set to 0 to disable printing of statistics.

Top

AGW Port

Start Direwolf listening for AGW connections on the specified port. Programs such as Xastir can use AGW on the same host or via a network connection to access the Direwolf TNC.

Top

KISS Port

Start Direwolf listening for KISS connections on the specified port. Programs such as Xastir, RMS Express and others can use KISS to access the Direwolf TNC across a network.

Top

Configure pat tab

Configuration parameters for the pat Winlink email application.

Top

Call Sign

Your call sign with no SSID as registered with winlink.org

Top

Winlink Password

Your Winlink password as registered with winlink.org

Top

Location Code

Six character maidenhead grid square. See Amateur Radio Ham Radio Maidenhead Grid Square Locator Map

Top

Web Service Port

Port number pat uses to start it's web service. This allows you to access pat's web interface from a browser on this Pi or via a browser on a PC that is on the same network as this Pi.

Top

Telnet Service Port

Port number pat listens on so external applications can communicate with pat using telnet. This allows you to access pat's telnet interface from a command line on this Pi or from a PC using a suitable application that is on the same network as this Pi.

Top

Telnet Service Password

When pat is running with the telnet service enabled, users connecting to pat must provide this password. The default is no password.

Top

Telnet Service Password

When pat is running with the telnet service enabled, users connecting to pat must provide this password. The default is no password.

Top

AX25 Beacon Interval

When pat is running, your radio will beacon an IDENT message periodically, so other hams know you are capable of P2P. Default is 3600 seconds. Set it to 0 to disable beacons.

Top

AX25 Beacon Message

When pat is running, your radio will beacon an IDENT message periodically, so other hams know you are capable of P2P. This text will be sent as part of the beacon. Default = "Winlink P2P"

Top

Start pat web service when Direwolf TNC starts

Checking this box will start pat's web service when this GUI is run. Alternatively, you can use pat's command line interface after starting this GUI by opening a Terminal window and running:

pat interactive
This control exists because some users might not be interested in using pat's web interface or even using pat at all. They may instead want to access Direwolf on this Pi from another computer using the AGW or KISS ports, or use various AX25 commands to interact with Direwolf.

Top

TX Delay

The amount of time in milliseconds to wait between keying the transmitter and beginning to send data.

TX Tail

The amount of time in milliseconds to keep the transmitter keyed after sending the data.

Persist

Persistence is part of the CSMA protocol. It represents the odds (out of 256) that the TNC will transmit within its slot time when no carrier is detected.

Slot Time

Slot Time is part of the CSMA protocol. It is the delay in milliseconds that the TNC waits before checking whether it can transmit.

Top

Load Default AX25 Timers button

Clicking this button restores the default values for TX Delay, TX Tail, Persist and Slot Time.

Top

Edit pat Connection aliases button

Clicking this button opens another program that allows you to set the aliases (shortcuts) used in the pat web interface.

Top

Rig Control tab

pat uses Rig Control, which is part of Hamlib. Pat uses Rig Control to QSY supported radios. It only implements the ability to change a supported rig's frequency, however. It does not implement any other rig control functions. This tab presents information about rig control and a button that when clicked opens a program that allows you to manage rig control.