############## xpsk31 RUNTIME CONFIGURATION FILE: xpsk31rc ##########
#                                                                   #
# PLEASE NOTE! In order to keep the parser for this file simple,    #
# the runtime configuration entries below must all be present and   #
# in the order presented, since they are all read-in in a fixed     #
# sequence. Blank lines or those starting with a # or white space   #
# are ignored.                                                      #
#                                                                   #
# There are four sections, Sound card, xpsk31 Runtime, Operator and #
# QTH and Macros fields. Please check ALL and EDIT as needed!!      #
#                                                                   #
#####################################################################
#
####### SOUND-CARD CONFIGURATION #######
#
# PLEASE NOTE: It was very hard for me to migrate this
# program from the OSS API to the ALSA API, mainly because
# of the very sparse documentation and lack of a simple
# tutorial on Mixer programming. There may difficulties
# making this program run on platforms other than mine,
# if the sound card features are significantly different.
#
# Sound card hardware name: Default is hw:0 (first card).
# Other names can be hw:1 for the second sound card etc.
# There is a large number of possibilities for this entry
# which I can only just understand, but if this simple name
# string does not work, I am afraid you will need to have a
# look at the on-line ALSA documentation.
hw:0
#
# PCM Device Name
hw:0,0
# The sampling rate of the sound card's DSP. This should as
# far as possible be the native speed of the DSP to avoid
# resampling, as it seems resampling distorts the signal.
# The default is 48000 but for older cards it may be 44100
48000
#
# The "channel" to be used for sound capture. ALSA uses the
# notion of a channel for the description of what input is
# being used for capture. With todays sound cards that have
# surround sound etc there can be many inputs to choose from
# to connect the audio o/p from a receiver. These are the
# channel descriptions I know of (alsa-lib 1.0.20) that can be
# used with xpsk31.
# FRONT_LEFT
# FRONT_RIGHT
# REAR_LEFT
# REAR_RIGHT
# SIDE_LEFT
# SIDE_RIGHT
# MONO
# The default is FRONT_LEFT (that works for me)
FRONT_LEFT
#
# Sound capture source: Default is Capture.
Capture
#
# Sound capture volume control: Default is Capture.
# If volume setting is not possible or desired, replace with --
Capture
#
# Recording/Capture level: Useful range ~10-100%.
# The correct value must be found by testing, see xpsk31.html.
100
#
# Playback Master volume control: Default is PCM
# If volume setting is not possible or desired, replace with --
Master
#
# Playback PCM volume control: Default is Master
# If volume setting is not possible or desired, replace with --
Master
#
# Playback level: Useful range ~10-100%.
# The correct value must be found by testing, see xpsk31.html.
70
#
####### End of SOUND-CARD CONFIGURATION #######
#
####### xpsk31 RUNTIME CONFIGURATION #######
#
# Squelch threshold: Useful range ~3-10. My default is 5.
# Note that a zero setting will disable the squelch function
5
#
# Reverse the sense of the Magniphase indicators. This is
# can be used to make the indicators in the Magniphase
# display to rotate in the same sense as the transceiver's
# VFO. Use 1 for yes, 0 for no.
0
#
# Steady tone duration in sec. This is the steady
# tone transmitted at the beginning and tail end
# of a transmission (pre-amble and post-amble).
1
#
# Number of reversals following and preceding the steady tone:
# Default is 24. These phase reversals are part of the PSK31
# pre-amble and post-amble used for synching and squelching
24
#
# Morse encoder speed in wpm: Default is 20 wpm
20
#
# Transmit window word-wrap column: Default is 70
70
#
# Serial port device for Transceiver CAT: Default is /dev/tts/0
# Please specify the serial port device you intend to use for CAT
# control of your tranceiver. PLEASE NOTE: CAT is available only
# for the YAESU FT-847/FT857 and Elecraft K2/K3 which I own(ed).
# If you are using some other tranceiver, there is no need to edit
# these entries but do not activate CAT below to avoid errors.
/dev/k3
#
# MENU OPTIONS: Set default state of these pop-up menu options.
#
# Enable Transceiver CAT. Available entries are FT847 or FT857
# or K2 or K3. Specify NONE if you have a different Transceiver
# or you do not want CAT.
K3
#
# Serial port device for RTS or DTR line PTT control: Please specify
# the serial port device you intend to use for tranceiver PTT control
# via the RS232 port's RTS or DTR line. Do not edit if you do not want
# to use RTS control but specify "NONE" below to disable this feature.
/dev/k3
#
# Specify RTS or DTR line control for PTT On during transmission.
# Specify NONE if you do not want to use RTS or DTR control
NONE
#
# Record QSO's (raw) to file (yes or no). Default is yes
yes
#
# Capitalize letters in Transmit and Receive windows.
# (yes or no). Default is yes
yes
#
####### End of xpsk31 RUNTIME CONFIGURATION #######
#
#######	OPERATOR AND QTH INFORMATION #######
#
# All fields are required, if any are missing there will be errors.
# All fields MUST be edited!!
#
# Callsign: Maximum 14 characters allowed. !!USE CAPITAL LETTERS!!
CALLSIGN
# Name: Maximum 12 characters allowed
NAME
# Zone data: Maximum 14 characters allowed
ZONE
# QTH Name:  Maximum 12 characters allowed
QTH-NAME
# QTH Locator: Maximum 6 characters allowed
LOCATOR
# Default Transmitter name: Maximum 11 characters allowed
TX-NAME
# Transmitter power o/p (W): Maximum 9 characters allowed
70
# Transmitter antenna: Maximum 15 characters allowed
ANTENNA
# Default Receiver name: Maximum 11 characters allowed
RX-NAME
# Receiver Noise figure: Maximum 7 characters allowed
1.5
# Receiver antenna: Maximum 15 characters allowed
ANTENNA
# Via which propagation medium (Ionosphere, satellite etc)
Ionosphere!
# Remarks on QSO: Maximum 45 characters allowed
Pse QSL - Tks fer QSO - 73 es gud luck
#
####### End of OPERATOR AND QTH INFORMATION #######
#
####### MACROS (Prepared messages for transmission) #######
#
# These are various typical or standard messages transmitted
# during PSK31 (and other) digital mode QSO's. There can be a
# maximum of 9 entries which will be bound to the function keys
# F1-F9 in that order. Any number of entries up to 9 are allowed
# but the format is fixed in order to keep the parser simple:
#
# Each entry starts with a line which contains a label, enclosed
# in [ ] square brackets, to be shown in the PSK31 menu of
# keystroke commands. A maximum of 18 characters are allowed
# within the square brackets. PLEASE NOTE that [ or ] must not
# appear in the message text for obvious reasons!
#
# Each label is followed by the message to be transmitted in lines
# of a maximum of 80 characters, although it is probably better to
# limit lines to less than 70 characters for clarity. Blank lines
# and lines starting with a # or white space are ignored.
# *** NOTE: The last line of the last Macro must end with the
# PIPE | character to avoid EOF error conditions.
#
# Lines ending with a tilde ~ signify that xpsk31 should remain in
# transmit mode so that text can be appended to the macro manually,
# e.g. signal report, name etc. The up arrow ^ signifies that a
# 'new-line' signal should be sent before the text. The asterix
# sign * at the end of a line signifies that the station callsign
# must be sent in Morse code (CW identitiy).
#
# PLEASE NOTE that ^, ~ and * must not appear in the message text
# for obvious reasons!
#
##### Tags in Macros #####
#
# xpsk31 has a limited tag replacement ability, e.g. there are 12
# different tags that can be entered in the macros and these will
# identified and replaced with suitable values during operation:
#
# "Local information" tags, e.g. relating to the operator of xpsk31.
# "Remote information" tags, e.g. relating to the remote operator.
#
# All tags must be enclosed in <> similar to HTML tags. The following
# tags are currently recognized:
#
# <own-call> <own-name> <own-qth> <own-loc> <own-rst>
# <rem-call> <rem-name> <rem-qth> <rem-loc> <rem-rst>
# <date-time> <op-freq>
#
# They will be replaced during macro transmission with the following
# values respectively:
#
# Local Operator's call, name, QTH, QTH locator and RST report.
# Remote Operator's call, name, QTH, QTH locator and RST report.
# Current UTC date and time, the operating frequency.
#
#
# PLEASE NOTE: All but the RST report values for the Local operator
# are taken from the OPERATOR AND QTH INFORMATION block in this file.
# All other values are taken from the QSO Record fields, under the
# Receive window, as it is filled. A partially filled QSO record is
# still usable since values become available as they are entered but
# please note that empty fields are entered as null (blank) strings
# in place of the tags!
#
# Macro for F1
#
[CALL CQ de CALLSIGN]
^CQ CQ CQ de <own-call> <own-call> <own-call>
CQ CQ CQ de <own-call> <own-call> <own-call>
CQ CQ CQ de <own-call> <own-call> <own-call>
pse KKK
#
# Macro for F2
#
[CALLSIGN & HELLO]
^<rem-call> <rem-call> de <own-call> <own-call>
Hello dr <rem-name> and tks for your call ~
#
# Macro for F3
#
[RST/NAME/QTH/QSL]
^Your RSQ: <rem-rst> <rem-rst> <rem-rst>
My name: <own-name> <own-name>
My QTH: <own-qth> <own-qth>
My Loc: <own-loc> <own-loc>
QSL is OK via bureau or direct ~
#
# Macro for F4
#
[KEYBRD BTU/CALLS]
^Now keys BTU dr <rem-name>
<rem-call> <rem-call> de <own-call> <own-call> pse KKN
#
# Macro for F5
#
[HIS CALL/MY CALL]
^<rem-call> <rem-call> de <own-call> <own-call> ~
#
# Macro for F6
#
[MY STATION INFO]
^My station info:
Rig: RIG  Ant: ANTENNA
Computer: COMPUTER
O/S: OP_SYSTEM Software: Software <app-version> ~
#
# Macro for F7
#
[FINAL & SIGN-OFF]
^My tks for nice QSO dr <rem-name>
I wish you and your family happiness and good health
Until we meet again, good luck with dx and bye-bye
Logged by <app-version> on <date-time> UTC on <op-freq> MHz
<rem-call> de <own-call> SKSK *
#
# Macro for F8
#
[REPLY TO CQ CALL]
^<rem-call> <rem-call> de <own-call> <own-call> <own-call> pse KK
#
# Macro for F9
#
[QRZ de CALLSIGN]
^QRZ QRZ QRZ de <own-call> <own-call> <own-call> pse KK
#
# Macro for F10
#
[QRZ de CALLSIGN]
^QRZ QRZ QRZ de <own-call> <own-call> <own-call> pse KK|
#
