View source for Dspserver.conf

==dspserver.conf==

*As of version Feb 01 2012 dspserver will now require a dspserver conf file.  By default it will be created in a users home directory if one does not exist.  dspserver may be started with an alternate  file using the --shareconfig option.

'''The original file contained:'''
 <nowiki># Simple config file for ghpsdr3's dspserver.
# default file is located at ~/dspserver.conf when dsp server is started with --share
# The information below will be supplied to a web database which will aid QtRadio
# users find active dspservers to connect to.  You may also see the current list at
# http://napan.ca/qtradio/qtradio.pl
# valid fields are call, location, band, rig and ant
# lines must end with ; and any characters after a # is a comment and ignored
# field values must be enclosed with " ie: "xxxx"
# This default file will be created if dspserver is started with the --share option and ~/dspserver.conf does not exist
# You may also start dspserver with an alternate config file by starting dspserver with --shareconfig /home/alternate_filename.conf
# Note field names are all lowercase!

call = "VE9GJ";
location = "Napan, NB FN77";
band = "20, 15, 10";
rig = "SoftRock rxtx-event";
ant = "4el Yagi Pointed NE";</nowiki>

'''New Sections as of Feb 01 2012:'''
* share and lookupcountry can now be set in the conf file
 <nowiki>share = "yes"; # Can be yes, no
lookupcountry = "yes"; # Can be yes, no </nowiki>

* TX needs to be set if not''' TX will be disabled'''
 <nowiki>tx = "password";  #Can be: no, yes, password</nowiki>
'''tx= no''' will disable all TX<br>
'''tx=yes''' will allow all TX dspserver will behave as before Feb 01 2012 version<br>
'''tx=password''' will require a user/password pair when sending a mox command and will be checked against the TX rules for that user before TX is allowed This is handled automatically by QtRadio.<br>
* User / passwords are added one per line

 <nowiki>ve9gj = "secretpassword";  #add users/passwords one per line (max 20 characters each!)
dl6kbg="hissecret";
zl2apv="anothersecret";</nowiki>

* Multiple rule groups are allowed so permissions can be set by group.  You need to list any group names you want to use in the groupnames line. Limit 20 characters and avoid spaces
 <nowiki>groupnames = ["txrulesall", "txrules20m_only"];</nowiki>
* Now each groupname needs a line that lists it's members.  Use the group name with _members appended to it. ''Note the format = [ "user1", "user2"];''
 <nowiki>txrulesall_members = ["ve9gj"]; 
txrules20m_only_members = ["ve9gj","zl2apv","dl6kbg"];</nowiki>

* Now each rule group need it's own section one line per rule  rule are defined as mode, start Mhz, end Mhz. ''Note the format =(  ("mode", 7.0, 7.1), ("mode",1.8, 2.0) );''
 <nowiki>txrulesall = (
     ("*",1.8,30.0) # mode, StartFreq Mhz, EndFreq Mhz
     );
txrules20m_only = (
     ("CW",14.0,14.1), # mode, StartFreq Mhz, EndFreq Mhz
     ("SSB",14.1,14.35), # mode, StartFreq Mhz, EndFreq Mhz
     ("AM",14.3,14.35)
          );</nowiki>

Mode needs to be in double quotes "AM"<br>
Mode can use "*" to mean any mode allowed<br>
Frequencies are in Mhz with the decimal point<br>
The first rule that matches will allow TX<br>
the User / Pass is sent with every MOX command so if a connection fails and another user somehow happens to attach as the wrong connected client he still cannot TX without the password<br>

* On the QtRadio Configure-->Transmit Tab you will find a table to save user passwords for specific servers.  The server name is the same as what is on the Quick connect list and will now show up in the Main Window title bar. 
* When QtRadio connects to a >= Feb 01 2012 dspserver it will check this table for a saved user pass and automatically send it when clicking the tune or mox buttons.
* Still to come is feed back to QtRadio when TX has been denied.  At the moment TX just fails.  The dspserver console will list the user name that attempt to TX.

73