Athena can be started from the command line or a desktop launcher. For a complete list of options type "athena --help":
usage: --xpos <pos> --ypos <pos> --laf <1 thru 4> --cfgfile <file.cfg> --aether --thetis --radio-id <Atlas = 0, Hermes(Anan-10,100) = 1, Hermes(Anan-10E,100B) = 2, Angelia(Anan-100D) = 3, Orion(Anan-200D) = 4, Hermes Lite = 6, Athena = 10> (default: 2 - Hermes(Anan-10E,100B)) --aetheriface <interface> --discovery <ip address> (default: 192.168.0.1) --radio <interface> (default: eno1) --outputbytes | --outputfloats | --outputdoubles --heartbeat <seconds> --oscfactor <-250 thru 250> --micfactor <40000 thru 60000> --audioserver --loadmasks --read <samplefile> --write <samplefile> --loop <samplefile> --writegigs <write size in gigabytes> --help | -hThe command line options are:
Set the x and y coordinates of Athena on the desktop.
Set the 'custom look and feel' of the gui.
Choose an alternate configuration file. Note: this argument is parsed before other command line arguments. This allows an alternate cfg file to be loaded BEFORE the remaining arguments are used.
Choose between 'aether' and 'thetis' modes.
Set the radio type. The default is type 2 - Hermes(Anan-10E,100B).
Set the network interface used for ??? Aether/Thetis or other protocol2 radio.
Set the 'discovery' address. If unset it defaults to 192.168.0.1.
Set the network interface used to connect to the hardware. If unset it defaults to eno1.
Set the IQ sample rate. If unset it defaults to 192000.
Set the data type of the IQ data:
Set the length in seconds between expected packets from the radio. If a packet is not received within this period Athena will disconnect from the radio. If unset it defaults to ???.
Set the oscillator offset from 'true' time. Since the hardware oscillator doesn't maintain perfect timing this argument sets an adjustment factor in parts per million. Once determined it can be set either here or in the configuration file. It can also be dynamically adjusted in the Athena 'Setup and Configuration' popup: 'Oscillator Offset'.
Set the microphone oscillator offset. Since the soundcard oscillator doesn't maintain perfect timing this argument sets an adjustment factor in Hz.
Choose between handling audio output internally, and using an
audio server.
This feature is in development...
Causes the fft masks to be loaded from files in /usr/local/sdr/data. If unset the masks are computed during startup, the preferred procedure.
Read or write ADC samples.
'read' will fetch ADC samples from a file.
It makes one pass then exits.
'loop' is similar to 'read' except that it continually
re-reads the file till Athena is terminated.
'write' will store ADC samples from the hardware to a file.
'writegigs' sets the size of the file produced by 'write'.
If unset the default is ???.
Caution: these files get VERY large VERY fast!
Sends zero-ed receive IQ data to the radio.
Debug feature, will be depricated soon...
Show a usage message on both the command line and as a popup window, then exit.
Athena must be started in either 'aether' mode or 'thetis' mode.