############## xfhell RUNTIME CONFIGURATION FILE: xfhellrc ##########
#                                                                   #
# 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, xfhell 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 xfhell.
# FRONT_LEFT
# FRONT_RIGHT
# REAR_LEFT
# REAR_RIGHT
# SIDE_LEFT
# SIDE_RIGHT
# MONO
# The default is FRONT_RIGHT (that works for me)
FRONT_RIGHT
#
# Sound capture source: Default is Capture (that works for me).
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%. Default is 100.
# The correct value must be found by testing, see xfhell.html.
100
#
# Playback Master volume control: Default is Master
# If volume setting is not possible or desired, replace with --
Master
#
# Playback PCM volume control: Default is PCM
# If volume setting is not possible or desired, replace with --
Master
#
# Playback level: Useful range ~10-100%. Default is 100.
# The correct value must be found by testing, see xfhell.html.
100
#
####### End of SOUND-CARD CONFIGURATION #######
#
####### xfhell RUNTIME CONFIGURATION #######
#
# Morse encoder speed in wpm: Default is 20 wpm
20
#
# CW message to send at tag '*' (24 char max)
DE YOUR-CALL
# 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/ttyUSB0
#
# Specify RTS or DTR line control for PTT On during transmission.
# Specify NONE if you do not want to use RTS or DTR control
DTR
#
# Record QSO's (raw) to file (yes or no). Default is yes
yes
#
# Hellscreiber mode: Currently only FeldHell and FMHell are valid
FeldHell
#
# Default Baud rate. Available valid values are:
# 122.5 105.0 61.25 30.63 15.3 14.0 7.65
122.5
#
# Dot size, in pixels, of characters rendered in receive mode.
# Valid entries are 2, 3 and 4. The corresponding dot size will
# be 2x2, 3x3 and 4x4 pixels.
2
#
# Capitalize letters in Transmit window.
# (yes or no). Default is yes
yes
#
# Receiver's BFO tone pitch (Hz). This should not be changed if
# at all possible because it affects other parameters in the program.
# This means your receiver's BFO pitch must be set to 500 Hz
500
#
# Set Receive window to half size (yes or no). Default is no
no
#
####### End of xfhell RUNTIME CONFIGURATION #######
#
#######	OPERATOR AND QTH INFORMATION (USED IN STATION LOG) ########
#
# 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!!
YOUR-CALL
# Name: Maximum 12 characters allowed
YOUR-NAME
# Zone data: Maximum 14 characters allowed
Zone data
# QTH Name:  Maximum 12 characters allowed
QTH Name
# QTH Locator: Maximum 6 characters allowed
Locatr
# Default Transmitter name: Maximum 11 characters allowed
Tx-name
# Transmitter power o/p (W): Maximum 9 characters allowed
100
# Transmitter antenna: Maximum 15 characters allowed
Tx 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
Rx 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 Hellschreiber (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 Xfhell menu of
# keystroke commands. A maximum of 19 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.
#
# Lines ending with a tilde ~ signify that xfhell should remain in
# transmit mode so that text can be appended to the macro manually,
# e.g. signal report, name etc. 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 #####
#
# xfhell 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 xfhell.
# "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> <app-version>
#
# 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, xfhell version.
#
#
# 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!
#
# Glyph encodings of icon/smiley fonts. Place in tags for transmission
# of the icon or smiley, e.g. <15> will cause the dog icon to be sent.
#
# Xmass tree 	10
# CPU			11
# RAM			12
# thermometer	13
# sound			14
# doggy			15
# hello			16
# happyface		17
# sadface		18
# rig			19
# smeter		20
# gplane		21
# dipole		22
# yagi			23
# computer		24
# tux			25
# qth			26
# sunny			27
# cloudy		28
# qslcard		29
# phone			30
#
# 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 <16><17> dr <rem-name> and tks for call <30> ~
#
# Macro for F3
#
[RST/NAME/QTH/QSL]
Your <20> RST <rem-rst> <rem-rst> <rem-rst> = 
My Name: <own-name> <own-name> model 1948 vintage <17> 
Member FeldHell Club FH632 = 
My <26> QTH <own-qth> <own-qth> = 
My Loc: <own-loc> <own-loc> = 
<29> QSL card OK via bureau or direct = 
My website 5b4az.chronos.org.uk ~
#
# Macro for F4
#
[KEYBRD BTU/CALLS]
Now keys BTU dr <rem-name> = 
<rem-call> de <own-call> pse KKN <15> *
#
# Macro for F5
#
[HIS CALL/MY CALL]
. <rem-call> de <own-call> ~
#
# Macro for F6
#
[MY STATION INFO]
My station info: 
Rig: <19> FT-847 o/p 50W = 
Ant: <22> G5RV 30-160m, <21> Broadband Vertical 10-30m= 
Computer: <24> CPU <11> Athlon 64x2 2.4GHz Mem: <12> 1Gb  Sound <14> AC97= 
O/S: Arch Linux x86-64 <25> = Software: <app-version> ~
#
# Macro for F7
#
[FINAL & SIGN-OFF]
My tks for a nice <17> Hell mode QSO dr <rem-name> = 
I wish you and your family happiness and good health = 
Until we meet again, good luck with Hell 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> pse KKK
#
# Macro for F9
#
[QRZ de 5B4AZ]
. QRZ? QRZ? QRZ? de <own-call> <own-call> pse KKK
#
# Macro for F10
#
[QRZ de 5B4AZ]
. QRZ? QRZ? QRZ? de <own-call> <own-call> pse KKK|
#
