Ghpsdr3 SDR project - User contributions [en]

Developers Documentation

2012-08-25T00:21:58Z

Zl2apv: /* Compiling QtRadio */

*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3_protocols More on the Ghpsdr communications protocols (and more up to date)]
*[[dspserver.conf]] The '''''dspserver.conf''''' file has it's own page

Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].

= Installing portaudio19-dev with jackd2 =

Portaudio19-dev depends on having a copy of libjack-dev installed and if the libkjack-jackd2-dev package is installed before portaudio19-dev it's dependency will be satisfied and it will not uninstall jackd2 and install jackd1 if you have already installed jackd2 on your system.

== If jackd1 and portaudio19-dev already installed ==

<pre>From Synaptic

Uninstall portaudio19-dev
Uninstall jackd1
Install Jackd2
Install libjack-jackd2-dev
Install portaudio19-dev
</pre>

== If you are starting from scratch ==

<pre>From Synaptic

Install Jackd2
Install libjack-jackd2-dev
Install portaudio19-dev
</pre>

= Installing Qt5 =
You need to add the unsupported packages to your system. It will exist as a stand alone system separate from any other version of qt or creator etc. that you may have installed.

== Adding the qt5 “Canonical Qt5 Edgers” ppa to your system ==

In a terminal, copy and paste ...
<pre>
sudo add-apt-repository ppa:canonical-qt5-edgers/qt5-daily
</pre>
Your system will now fetch the PPA's key. This enables your Ubuntu system to verify that the packages in the PPA have not been interfered with since they were built.

Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:
<pre>
sudo apt-get update
</pre>
Now you're ready to start installing software from the PPA!

== Installing from the ppa ==

You will be installing the packages from the daily build of qt5 and the version date etc. could change but it is important to check that you have marked for install the package corresponding to the qt5 build as some of the packages may also be installed for qt 4.8.x A good check is to open the url for the Edgers and compare your selection to their file list at [https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily canonical-qt5-edgers]

The packages will be identified with similar to
5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
I have shown the example on the first entry in the list only.

Open Synaptic and use the quick find to look for and mark for install each of the packages in the following list ...
<pre>
qt-components-qtquick2 5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
qt3d
qtbase
qtdeclarative
qtdoc
qtjsbackend
qtmultimedia
qtquick1
qtscript
qtsvg
qttools
qtwebkit
qtxmlpatterns

These packages will install by default in /opt/qt5
</pre>
note: there are a couple of packages which you do not need to install.

== Setting the path to qt5 ==

From a terminal
<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>

== Compiling QtRadio ==

<pre>
$ cd to the location of ghpsdr3-alex

$ sh cleanup
$ autoreconf -i
$ ./configure CFLAGS='-fopenmp -O3 -msse3' CXXFLAGS='-fopenmp -O3 -msse3'
(for those of us with older machines use the line below instead)
$ ./configure CXXFLAGS='-O3 -msse2 -fopenmp'
$ make
$ sudo make install
</pre>

== Setting QtCreator to use the qt5 libraries ==

If you want to use Qt Creator (you use the same Qt Creator as with Qt4), you need to configure it to use Qt5 as one of the options:
<pre>
From the top line menu of QtCreator ...

Tools > Options > Build & Run
Click on the Qt Versions panel
Click on Add button
Navigate to /opt/qt5/bin
Click on qmake
Click on open
Click on Apply then OK
</pre>
You need to point to the qmake file which is found in /opt/qt5/bin

== Choosing the build library in QtCreator ==

you need to (re)import your QtRadio project and then you will be able to select Qt5 (or the previous Qt4.8 etc.) for building the application.

It may be necessary to edit the project file (QtRadio.pro) to choose which version of Qt Creator you are using which can be the SDK directly from Nokia, or the Ubuntu install of Creator. The line "_UsingSDK" needs to be set to true or false as appropriate.

Developers Documentation

2012-07-13T10:20:42Z

Zl2apv: /* Choosing the build library in QtCreator */

*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3_protocols More on the Ghpsdr communications protocols (and more up to date)]
*[[dspserver.conf]] The '''''dspserver.conf''''' file has it's own page

Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].

= Installing portaudio19-dev with jackd2 =

Portaudio19-dev depends on having a copy of libjack-dev installed and if the libkjack-jackd2-dev package is installed before portaudio19-dev it's dependency will be satisfied and it will not uninstall jackd2 and install jackd1 if you have already installed jackd2 on your system.

== If jackd1 and portaudio19-dev already installed ==

<pre>From Synaptic

Uninstall portaudio19-dev
Uninstall jackd1
Install Jackd2
Install libjack-jackd2-dev
Install portaudio19-dev
</pre>

== If you are starting from scratch ==

<pre>From Synaptic

Install Jackd2
Install libjack-jackd2-dev
Install portaudio19-dev
</pre>

= Installing Qt5 =
You need to add the unsupported packages to your system. It will exist as a stand alone system separate from any other version of qt or creator etc. that you may have installed.

== Adding the qt5 “Canonical Qt5 Edgers” ppa to your system ==

In a terminal, copy and paste ...
<pre>
sudo add-apt-repository ppa:canonical-qt5-edgers/qt5-daily
</pre>
Your system will now fetch the PPA's key. This enables your Ubuntu system to verify that the packages in the PPA have not been interfered with since they were built.

Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:
<pre>
sudo apt-get update
</pre>
Now you're ready to start installing software from the PPA!

== Installing from the ppa ==

You will be installing the packages from the daily build of qt5 and the version date etc. could change but it is important to check that you have marked for install the package corresponding to the qt5 build as some of the packages may also be installed for qt 4.8.x A good check is to open the url for the Edgers and compare your selection to their file list at [https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily canonical-qt5-edgers]

The packages will be identified with similar to
5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
I have shown the example on the first entry in the list only.

Open Synaptic and use the quick find to look for and mark for install each of the packages in the following list ...
<pre>
qt-components-qtquick2 5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
qt3d
qtbase
qtdeclarative
qtdoc
qtjsbackend
qtmultimedia
qtquick1
qtscript
qtsvg
qttools
qtwebkit
qtxmlpatterns

These packages will install by default in /opt/qt5
</pre>
note: there are a couple of packages which you do not need to install.

== Setting the path to qt5 ==

From a terminal
<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>

== Compiling QtRadio ==

<pre>
$ cd to the location of ghpsdr3-alex

$ sh cleanup
$ autoreconf -i
$ ./configure CXXFLAGS = '-O3 -fopenmp'
(for those of us with older machines use the line below instead)
$ ./configure CXXFLAGS='-O3 -msse2 -fopenmp'
$ make
$ sudo make install
</pre>

== Setting QtCreator to use the qt5 libraries ==

If you want to use Qt Creator (you use the same Qt Creator as with Qt4), you need to configure it to use Qt5 as one of the options:
<pre>
From the top line menu of QtCreator ...

Tools > Options > Build & Run
Click on the Qt Versions panel
Click on Add button
Navigate to /opt/qt5/bin
Click on qmake
Click on open
Click on Apply then OK
</pre>
You need to point to the qmake file which is found in /opt/qt5/bin

== Choosing the build library in QtCreator ==

you need to (re)import your QtRadio project and then you will be able to select Qt5 (or the previous Qt4.8 etc.) for building the application.

It may be necessary to edit the project file (QtRadio.pro) to choose which version of Qt Creator you are using which can be the SDK directly from Nokia, or the Ubuntu install of Creator. The line "_UsingSDK" needs to be set to true or false as appropriate.

Developers Documentation

2012-06-25T20:05:53Z

Zl2apv: /* If you are starting from scratch */

*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3_protocols More on the Ghpsdr communications protocols (and more up to date)]
*[[dspserver.conf]] The '''''dspserver.conf''''' file has it's own page

Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].

= Installing portaudio19-dev with jackd2 =

Portaudio19-dev depends on having a copy of libjack-dev installed and if the libkjack-jackd2-dev package is installed before portaudio19-dev it's dependency will be satisfied and it will not uninstall jackd2 and install jackd1 if you have already installed jackd2 on your system.

== If jackd1 and portaudio19-dev already installed ==

<pre>From Synaptic

Uninstall portaudio19-dev
Uninstall jackd1
Install Jackd2
Install libjack-jackd2-dev
Install portaudio19-dev
</pre>

== If you are starting from scratch ==

<pre>From Synaptic

Install Jackd2
Install libjack-jackd2-dev
Install portaudio19-dev
</pre>

= Installing Qt5 =
You need to add the unsupported packages to your system. It will exist as a stand alone system separate from any other version of qt or creator etc. that you may have installed.

== Adding the qt5 “Canonical Qt5 Edgers” ppa to your system ==

In a terminal, copy and paste ...
<pre>
sudo add-apt-repository ppa:canonical-qt5-edgers/qt5-daily
</pre>
Your system will now fetch the PPA's key. This enables your Ubuntu system to verify that the packages in the PPA have not been interfered with since they were built.

Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:
<pre>
sudo apt-get update
</pre>
Now you're ready to start installing software from the PPA!

== Installing from the ppa ==

You will be installing the packages from the daily build of qt5 and the version date etc. could change but it is important to check that you have marked for install the package corresponding to the qt5 build as some of the packages may also be installed for qt 4.8.x A good check is to open the url for the Edgers and compare your selection to their file list at [https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily canonical-qt5-edgers]

The packages will be identified with similar to
5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
I have shown the example on the first entry in the list only.

Open Synaptic and use the quick find to look for and mark for install each of the packages in the following list ...
<pre>
qt-components-qtquick2 5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
qt3d
qtbase
qtdeclarative
qtdoc
qtjsbackend
qtmultimedia
qtquick1
qtscript
qtsvg
qttools
qtwebkit
qtxmlpatterns

These packages will install by default in /opt/qt5
</pre>
note: there are a couple of packages which you do not need to install.

== Setting the path to qt5 ==

From a terminal
<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>

== Compiling QtRadio ==

<pre>
$ cd to the location of ghpsdr3-alex

$ sh cleanup
$ autoreconf -i
$ ./configure CXXFLAGS = '-O3 -fopenmp'
(for those of us with older machines use the line below instead)
$ ./configure CXXFLAGS='-O3 -msse2 -fopenmp'
$ make
$ sudo make install
</pre>

== Setting QtCreator to use the qt5 libraries ==

If you want to use Qt Creator (you use the same Qt Creator as with Qt4), you need to configure it to use Qt5 as one of the options:
<pre>
From the top line menu of QtCreator ...

Tools > Options > Build & Run
Click on the Qt Versions panel
Click on Add button
Navigate to /opt/qt5/bin
Click on qmake
Click on open
Click on Apply then OK
</pre>
You need to point to the qmake file which is found in /opt/qt5/bin

== Choosing the build library in QtCreator ==

you need to (re)import your QtRadio project and then you will be able to select Qt5 (or the previous Qt4.8 etc.) for building the application.
(I have not got this to work yet so there is some more to go here when I get it sorted.)

Developers Documentation

2012-06-25T20:05:22Z

Zl2apv: /* If jackd1 and portaudio19-dev already installed */

*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3_protocols More on the Ghpsdr communications protocols (and more up to date)]
*[[dspserver.conf]] The '''''dspserver.conf''''' file has it's own page

Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].

= Installing portaudio19-dev with jackd2 =

Portaudio19-dev depends on having a copy of libjack-dev installed and if the libkjack-jackd2-dev package is installed before portaudio19-dev it's dependency will be satisfied and it will not uninstall jackd2 and install jackd1 if you have already installed jackd2 on your system.

== If jackd1 and portaudio19-dev already installed ==

<pre>From Synaptic

Uninstall portaudio19-dev
Uninstall jackd1
Install Jackd2
Install libjack-jackd2-dev
Install portaudio19-dev
</pre>

== If you are starting from scratch ==

<pre>From Synaptic

Install Jackd2
Install libkjack-jackd2-dev
Install portaudio19-dev
</pre>

= Installing Qt5 =
You need to add the unsupported packages to your system. It will exist as a stand alone system separate from any other version of qt or creator etc. that you may have installed.

== Adding the qt5 “Canonical Qt5 Edgers” ppa to your system ==

In a terminal, copy and paste ...
<pre>
sudo add-apt-repository ppa:canonical-qt5-edgers/qt5-daily
</pre>
Your system will now fetch the PPA's key. This enables your Ubuntu system to verify that the packages in the PPA have not been interfered with since they were built.

Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:
<pre>
sudo apt-get update
</pre>
Now you're ready to start installing software from the PPA!

== Installing from the ppa ==

You will be installing the packages from the daily build of qt5 and the version date etc. could change but it is important to check that you have marked for install the package corresponding to the qt5 build as some of the packages may also be installed for qt 4.8.x A good check is to open the url for the Edgers and compare your selection to their file list at [https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily canonical-qt5-edgers]

The packages will be identified with similar to
5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
I have shown the example on the first entry in the list only.

Open Synaptic and use the quick find to look for and mark for install each of the packages in the following list ...
<pre>
qt-components-qtquick2 5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
qt3d
qtbase
qtdeclarative
qtdoc
qtjsbackend
qtmultimedia
qtquick1
qtscript
qtsvg
qttools
qtwebkit
qtxmlpatterns

These packages will install by default in /opt/qt5
</pre>
note: there are a couple of packages which you do not need to install.

== Setting the path to qt5 ==

From a terminal
<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>

== Compiling QtRadio ==

<pre>
$ cd to the location of ghpsdr3-alex

$ sh cleanup
$ autoreconf -i
$ ./configure CXXFLAGS = '-O3 -fopenmp'
(for those of us with older machines use the line below instead)
$ ./configure CXXFLAGS='-O3 -msse2 -fopenmp'
$ make
$ sudo make install
</pre>

== Setting QtCreator to use the qt5 libraries ==

If you want to use Qt Creator (you use the same Qt Creator as with Qt4), you need to configure it to use Qt5 as one of the options:
<pre>
From the top line menu of QtCreator ...

Tools > Options > Build & Run
Click on the Qt Versions panel
Click on Add button
Navigate to /opt/qt5/bin
Click on qmake
Click on open
Click on Apply then OK
</pre>
You need to point to the qmake file which is found in /opt/qt5/bin

== Choosing the build library in QtCreator ==

you need to (re)import your QtRadio project and then you will be able to select Qt5 (or the previous Qt4.8 etc.) for building the application.
(I have not got this to work yet so there is some more to go here when I get it sorted.)

Developers Documentation

2012-06-05T23:07:18Z

Zl2apv:

*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3_protocols More on the Ghpsdr communications protocols (and more up to date)]
*[[dspserver.conf]] The '''''dspserver.conf''''' file has it's own page

Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].

= Installing portaudio19-dev with jackd2 =

Portaudio19-dev depends on having a copy of libjack-dev installed and if the libkjack-jackd2-dev package is installed before portaudio19-dev it's dependency will be satisfied and it will not uninstall jackd2 and install jackd1 if you have already installed jackd2 on your system.

== If jackd1 and portaudio19-dev already installed ==

<pre>From Synaptic

Uninstall portaudio19-dev
Uninstall jackd1
Install Jackd2
Install libkjack-jackd2-dev
Install portaudio19-dev
</pre>

== If you are starting from scratch ==

<pre>From Synaptic

Install Jackd2
Install libkjack-jackd2-dev
Install portaudio19-dev
</pre>

= Installing Qt5 =
You need to add the unsupported packages to your system. It will exist as a stand alone system separate from any other version of qt or creator etc. that you may have installed.

== Adding the qt5 “Canonical Qt5 Edgers” ppa to your system ==

In a terminal, copy and paste ...
<pre>
sudo add-apt-repository ppa:canonical-qt5-edgers/qt5-daily
</pre>
Your system will now fetch the PPA's key. This enables your Ubuntu system to verify that the packages in the PPA have not been interfered with since they were built.

Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:
<pre>
sudo apt-get update
</pre>
Now you're ready to start installing software from the PPA!

== Installing from the ppa ==

You will be installing the packages from the daily build of qt5 and the version date etc. could change but it is important to check that you have marked for install the package corresponding to the qt5 build as some of the packages may also be installed for qt 4.8.x A good check is to open the url for the Edgers and compare your selection to their file list at [https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily canonical-qt5-edgers]

The packages will be identified with similar to
5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
I have shown the example on the first entry in the list only.

Open Synaptic and use the quick find to look for and mark for install each of the packages in the following list ...
<pre>
qt-components-qtquick2 5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
qt3d
qtbase
qtdeclarative
qtdoc
qtjsbackend
qtmultimedia
qtquick1
qtscript
qtsvg
qttools
qtwebkit
qtxmlpatterns

These packages will install by default in /opt/qt5
</pre>
note: there are a couple of packages which you do not need to install.

== Setting the path to qt5 ==

From a terminal
<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>

== Compiling QtRadio ==

<pre>
$ cd to the location of ghpsdr3-alex

$ sh cleanup
$ autoreconf -i
$ ./configure CXXFLAGS = '-O3 -fopenmp'
(for those of us with older machines use the line below instead)
$ ./configure CXXFLAGS='-O3 -msse2 -fopenmp'
$ make
$ sudo make install
</pre>

== Setting QtCreator to use the qt5 libraries ==

If you want to use Qt Creator (you use the same Qt Creator as with Qt4), you need to configure it to use Qt5 as one of the options:
<pre>
From the top line menu of QtCreator ...

Tools > Options > Build & Run
Click on the Qt Versions panel
Click on Add button
Navigate to /opt/qt5/bin
Click on qmake
Click on open
Click on Apply then OK
</pre>
You need to point to the qmake file which is found in /opt/qt5/bin

== Choosing the build library in QtCreator ==

you need to (re)import your QtRadio project and then you will be able to select Qt5 (or the previous Qt4.8 etc.) for building the application.
(I have not got this to work yet so there is some more to go here when I get it sorted.)

Developers Documentation

2012-06-05T23:05:01Z

Zl2apv:

*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3_protocols More on the Ghpsdr communications protocols (and more up to date)]
*[[dspserver.conf]] The '''''dspserver.conf''''' file has it's own page

Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].

= Installing portaudio19-dev with jackd2 =

Portaudio19-dev depends on having a copy of libjack-dev installed and if the libkjack-jackd2-dev package is installed befor portaudio19-dev it's dependency will be satisfied and it will not uninstall jackd2 and install jackd1. If you have already installed jackd1 with portaudio19-dev then the following procedure will fix the problem ...

== If jackd1 and portaudio19-dev already installed ==

<pre>From Synaptic

Uninstall portaudio19-dev
Uninstall jackd1
Install Jackd2
Install libkjack-jackd2-dev
Install portaudio19-dev
</pre>

== If you are starting from scratch ==

<pre>From Synaptic

Install Jackd2
Install libkjack-jackd2-dev
Install portaudio19-dev
</pre>

= Installing Qt5 =
You need to add the unsupported packages to your system. It will exist as a stand alone system separate from any other version of qt or creator etc. that you may have installed.

== Adding the qt5 “Canonical Qt5 Edgers” ppa to your system ==

In a terminal, copy and paste ...
<pre>
sudo add-apt-repository ppa:canonical-qt5-edgers/qt5-daily
</pre>
Your system will now fetch the PPA's key. This enables your Ubuntu system to verify that the packages in the PPA have not been interfered with since they were built.

Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:
<pre>
sudo apt-get update
</pre>
Now you're ready to start installing software from the PPA!

== Installing from the ppa ==

You will be installing the packages from the daily build of qt5 and the version date etc. could change but it is important to check that you have marked for install the package corresponding to the qt5 build as some of the packages may also be installed for qt 4.8.x A good check is to open the url for the Edgers and compare your selection to their file list at [https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily canonical-qt5-edgers]

The packages will be identified with similar to
5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
I have shown the example on the first entry in the list only.

Open Synaptic and use the quick find to look for and mark for install each of the packages in the following list ...
<pre>
qt-components-qtquick2 5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
qt3d
qtbase
qtdeclarative
qtdoc
qtjsbackend
qtmultimedia
qtquick1
qtscript
qtsvg
qttools
qtwebkit
qtxmlpatterns

These packages will install by default in /opt/qt5
</pre>
note: there are a couple of packages which you do not need to install.

== Setting the path to qt5 ==

From a terminal
<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>

== Compiling QtRadio ==

<pre>
$ cd to the location of ghpsdr3-alex

$ sh cleanup
$ autoreconf -i
$ ./configure CXXFLAGS = '-O3 -fopenmp'
(for those of us with older machines use the line below instead)
$ ./configure CXXFLAGS='-O3 -msse2 -fopenmp'
$ make
$ sudo make install
</pre>

== Setting QtCreator to use the qt5 libraries ==

If you want to use Qt Creator (you use the same Qt Creator as with Qt4), you need to configure it to use Qt5 as one of the options:
<pre>
From the top line menu of QtCreator ...

Tools > Options > Build & Run
Click on the Qt Versions panel
Click on Add button
Navigate to /opt/qt5/bin
Click on qmake
Click on open
Click on Apply then OK
</pre>
You need to point to the qmake file which is found in /opt/qt5/bin

== Choosing the build library in QtCreator ==

you need to (re)import your QtRadio project and then you will be able to select Qt5 (or the previous Qt4.8 etc.) for building the application.
(I have not got this to work yet so there is some more to go here when I get it sorted.)

Developers Documentation

2012-06-05T23:03:34Z

Zl2apv:

*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3_protocols More on the Ghpsdr communications protocols (and more up to date)]
*[[dspserver.conf]] The '''''dspserver.conf''''' file has it's own page

Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].

= Installing portaudio19-dev with jackd2 =

Portaudio19-dev depends on having a copy of libjack-dev installed and if the libkjack-jackd2-dev package is installed befor portaudio19-dev it's dependency will be satisfied and it will not uninstall jackd2 and install jackd1. If you have already installed jackd1 with portaudio19-dev then the following procedure will fix the problem ...

== If jackd1 and portaudio19-dev already installed ==

<pre>From Synaptic

Uninstall portaudio19-dev
Uninstall jackd1
Install Jackd2
Install libkjack-jackd2-dev
Install portaudio19-dev
</pre>

== If you are starting from scratch ==

<pre>From Synaptic

Install Jackd2
Install libkjack-jackd2-dev
Install portaudio19-dev
</pre>

= Installing Qt5 =
You need to add the unsupported packages to your system. It will exist as a stand alone system separate from any other version of qt or creator etc. that you may have installed.

== 1. Adding the qt5 “Canonical Qt5 Edgers” ppa to your system ==

In a terminal, copy and paste ...
<pre>
sudo add-apt-repository ppa:canonical-qt5-edgers/qt5-daily
</pre>
Your system will now fetch the PPA's key. This enables your Ubuntu system to verify that the packages in the PPA have not been interfered with since they were built.

Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:
<pre>
sudo apt-get update
</pre>
Now you're ready to start installing software from the PPA!

== 2. Installing from the ppa ==

You will be installing the packages from the daily build of qt5 and the version date etc. could change but it is important to check that you have marked for install the package corresponding to the qt5 build as some of the packages may also be installed for qt 4.8.x A good check is to open the url for the Edgers and compare your selection to their file list at [https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily canonical-qt5-edgers]

The packages will be identified with similar to
5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
I have shown the example on the first entry in the list only.

Open Synaptic and use the quick find to look for and mark for install each of the packages in the following list ...
<pre>
qt-components-qtquick2 5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
qt3d
qtbase
qtdeclarative
qtdoc
qtjsbackend
qtmultimedia
qtquick1
qtscript
qtsvg
qttools
qtwebkit
qtxmlpatterns

These packages will install by default in /opt/qt5
</pre>
note: there are a couple of packages which you do not need to install.

== 3. Setting the path to qt5 ==

From a terminal
<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>

== 4. Compiling QtRadio ==

<pre>
$ cd to the location of ghpsdr3-alex

$ sh cleanup
$ autoreconf -i
$ ./configure CXXFLAGS = '-O3 -fopenmp'
(for those of us with older machines use the line below instead)
$ ./configure CXXFLAGS='-O3 -msse2 -fopenmp'
$ make
$ sudo make install
</pre>

== 5. Setting QtCreator to use the qt5 libraries ==

If you want to use Qt Creator (you use the same Qt Creator as with Qt4), you need to configure it to use Qt5 as one of the options:
<pre>
From the top line menu of QtCreator ...

Tools > Options > Build & Run
Click on the Qt Versions panel
Click on Add button
Navigate to /opt/qt5/bin
Click on qmake
Click on open
Click on Apply then OK
</pre>
You need to point to the qmake file which is found in /opt/qt5/bin

== 6. Choosing the build library in QtCreator ==

you need to (re)import your QtRadio project and then you will be able to select Qt5 (or the previous Qt4.8 etc.) for building the application.
(I have not got this to work yet so there is some more to go here when I get it sorted.)

Developers Documentation

2012-06-05T22:31:06Z

Zl2apv:

*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3_protocols More on the Ghpsdr communications protocols (and more up to date)]
*[[dspserver.conf]] The '''''dspserver.conf''''' file has it's own page

Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].

== Installing portaudio19-dev with jackd2 ==

Portaudio19-dev depends on having a copy of libjack-dev installed and if the libkjack-jackd2-dev package is installed befor portaudio19-dev it's dependency will be satisfied and it will not uninstall jackd2 and install jackd1. If you have already installed jackd1 with portaudio19-dev then the following procedure will fix the problem ...

<pre>From Synaptic

Uninstall portaudio19-dev
Uninstall jackd1
Install Jackd2
Install libkjack-jackd2-dev
Install portaudio19-dev
</pre>

Of course if you are starting from scratch then this is all you need

<pre>From Synaptic

Install Jackd2
Install libkjack-jackd2-dev
Install portaudio19-dev
</pre>

== Installing Qt5 ==
You need to add the unsupported packages to your system. It will exist as a stand alone system separate from any other version of qt or creator etc. that you may have installed.

=== 1. Adding the qt5 “Canonical Qt5 Edgers” ppa to your system ===

In a terminal, copy and paste ...
<pre>
sudo add-apt-repository ppa:canonical-qt5-edgers/qt5-daily
</pre>
Your system will now fetch the PPA's key. This enables your Ubuntu system to verify that the packages in the PPA have not been interfered with since they were built.

Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:
<pre>
sudo apt-get update
</pre>
Now you're ready to start installing software from the PPA!

=== 2. Installing from the ppa ===

You will be installing the packages from the daily build of qt5 and the version date etc. could change but it is important to check that you have marked for install the package corresponding to the qt5 build as some of the packages may also be installed for qt 4.8.x A good check is to open the url for the Edgers and compare your selection to their file list at [https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily canonical-qt5-edgers]

The packages will be identified with similar to
5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
I have shown the example on the first entry in the list only.

Open Synaptic and use the quick find to look for and mark for install each of the packages in the following list ...
<pre>
qt-components-qtquick2 5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
qt3d
qtbase
qtdeclarative
qtdoc
qtjsbackend
qtmultimedia
qtquick1
qtscript
qtsvg
qttools
qtwebkit
qtxmlpatterns

These packages will install by default in /opt/qt5
</pre>
note: there are a couple of packages which you do not need to install.

=== 3. Setting the path to qt5 ===

From a terminal
<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>
=== 4. Compiling QtRadio ===
<pre>
$ cd to the location of ghpsdr3-alex

$ sh cleanup
$ autoreconf -i
$ ./configure CXXFLAGS = '-O3 -fopenmp'
(for those of us with older machines use the line below instead)
$ ./configure CXXFLAGS='-O3 -msse2 -fopenmp'
$ make
$ sudo make install
</pre>
=== 5. Setting QtCreator to use the qt5 libraries ===

If you want to use Qt Creator (you use the same Qt Creator as with Qt4), you need to configure it to use Qt5 as one of the options:
<pre>
From the top line menu of QtCreator ...

Tools > Options > Build & Run
Click on the Qt Versions panel
Click on Add button
Navigate to /opt/qt5/bin
Click on qmake
Click on open
Click on Apply then OK
</pre>
You need to point to the qmake file which is found in /opt/qt5/bin

=== 6. Choosing the build library in QtCreator ===

you need to (re)import your QtRadio project and then you will be able to select Qt5 (or the previous Qt4.8 etc.) for building the application.
(I have not got this to work yet so there is some more to go here when I get it sorted.)

Developers Documentation

2012-06-05T22:28:24Z

Zl2apv:

*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3_protocols More on the Ghpsdr communications protocols (and more up to date)]
*[[dspserver.conf]] The '''''dspserver.conf''''' file has it's own page

Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].

== Installing portaudio19-dev with jackd2 ==

Portaudio19-dev depends on having a copy of libjack-dev installed and if the libkjack-jackd2-dev package is installed befor portaudio19-dev it sependency will be satisfied and it will not uninstall jackd2 and install jackd1. If you have already installed jackd1 with portaudio19-dev then the following procedure will fix the problem ...

<pre>From Synaptic

Uninstall portaudio19-dev
Uninstall jackd1
Install Jackd2
Install libkjack-jackd2-dev
Install portaudio19-dev
</pre>

Of course if you are starting from scratch then this is all you need

<pre>From Synaptic

Install Jackd2
Install libkjack-jackd2-dev
Install portaudio19-dev
</pre>

== Installing Qt5 ==
You need to add the unsupported packages to your system. It will exist as a stand alone system separate from any other version of qt or creator etc. that you may have installed.

=== 1. Adding the qt5 “Canonical Qt5 Edgers” ppa to your system ===

In a terminal, copy and paste ...
<pre>
sudo add-apt-repository ppa:canonical-qt5-edgers/qt5-daily
</pre>
Your system will now fetch the PPA's key. This enables your Ubuntu system to verify that the packages in the PPA have not been interfered with since they were built.

Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:
<pre>
sudo apt-get update
</pre>
Now you're ready to start installing software from the PPA!

=== 2. Installing from the ppa ===

You will be installing the packages from the daily build of qt5 and the version date etc. could change but it is important to check that you have marked for install the package corresponding to the qt5 build as some of the packages may also be installed for qt 4.8.x A good check is to open the url for the Edgers and compare your selection to their file list at [https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily canonical-qt5-edgers]

The packages will be identified with similar to
5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
I have shown the example on the first entry in the list only.

Open Synaptic and use the quick find to look for and mark for install each of the packages in the following list ...
<pre>
qt-components-qtquick2 5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
qt3d
qtbase
qtdeclarative
qtdoc
qtjsbackend
qtmultimedia
qtquick1
qtscript
qtsvg
qttools
qtwebkit
qtxmlpatterns

These packages will install by default in /opt/qt5
</pre>
note: there are a couple of packages which you do not need to install.

=== 3. Setting the path to qt5 ===

From a terminal
<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>
=== 4. Compiling QtRadio ===
<pre>
$ cd to the location of ghpsdr3-alex

$ sh cleanup
$ autoreconf -i
$ ./configure CXXFLAGS = '-O3 -fopenmp'
(for those of us with older machines use the line below instead)
$ ./configure CXXFLAGS='-O3 -msse2 -fopenmp'
$ make
$ sudo make install
</pre>
=== 5. Setting QtCreator to use the qt5 libraries ===

If you want to use Qt Creator (you use the same Qt Creator as with Qt4), you need to configure it to use Qt5 as one of the options:
<pre>
From the top line menu of QtCreator ...

Tools > Options > Build & Run
Click on the Qt Versions panel
Click on Add button
Navigate to /opt/qt5/bin
Click on qmake
Click on open
Click on Apply then OK
</pre>
You need to point to the qmake file which is found in /opt/qt5/bin

=== 6. Choosing the build library in QtCreator ===

you need to (re)import your QtRadio project and then you will be able to select Qt5 (or the previous Qt4.8 etc.) for building the application.
(I have not got this to work yet so there is some more to go here when I get it sorted.)

Developers Documentation

2012-06-05T22:11:29Z

Zl2apv:

*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3_protocols More on the Ghpsdr communications protocols (and more up to date)]
*[[dspserver.conf]] The '''''dspserver.conf''''' file has it's own page
* Installing Qt5
* Installing portaudio19-dev with jackd2

Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].

== Installing Qt5 ==
You need to add the unsupported packages to your system. It will exist as a stand alone system separate from any other version of qt or creator etc. that you may have installed.

=== 1. Adding the qt5 “Canonical Qt5 Edgers” ppa to your system ===

In a terminal, copy and paste ...
<pre>
sudo add-apt-repository ppa:canonical-qt5-edgers/qt5-daily
</pre>
Your system will now fetch the PPA's key. This enables your Ubuntu system to verify that the packages in the PPA have not been interfered with since they were built.

Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:
<pre>
sudo apt-get update
</pre>
Now you're ready to start installing software from the PPA!

=== 2. Installing from the ppa ===

You will be installing the packages from the daily build of qt5 and the version date etc. could change but it is important to check that you have marked for install the package corresponding to the qt5 build as some of the packages may also be installed for qt 4.8.x A good check is to open the url for the Edgers and compare your selection to their file list at [https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily canonical-qt5-edgers]

The packages will be identified with similar to
5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
I have shown the example on the first entry in the list only.

Open Synaptic and use the quick find to look for and mark for install each of the packages in the following list ...
<pre>
qt-components-qtquick2 5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
qt3d
qtbase
qtdeclarative
qtdoc
qtjsbackend
qtmultimedia
qtquick1
qtscript
qtsvg
qttools
qtwebkit
qtxmlpatterns

These packages will install by default in /opt/qt5
</pre>
note: there are a couple of packages which you do not need to install.

=== 3. Setting the path to qt5 ===

From a terminal
<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>
=== 4. Compiling QtRadio ===
<pre>
$ cd to the location of ghpsdr3-alex

$ sh cleanup
$ autoreconf -i
$ ./configure CXXFLAGS = '-O3 -fopenmp'
(for those of us with older machines use the line below instead)
$ ./configure CXXFLAGS='-O3 -msse2 -fopenmp'
$ make
$ sudo make install
</pre>
=== 5. Setting QtCreator to use the qt5 libraries ===

If you want to use Qt Creator (you use the same Qt Creator as with Qt4), you need to configure it to use Qt5 as one of the options:
<pre>
From the top line menu of QtCreator ...

Tools > Options > Build & Run
Click on the Qt Versions panel
Click on Add button
Navigate to /opt/qt5/bin
Click on qmake
Click on open
Click on Apply then OK
</pre>
You need to point to the qmake file which is found in /opt/qt5/bin

=== 6. Choosing the build library in QtCreator ===

you need to (re)import your QtRadio project and then you will be able to select Qt5 (or the previous Qt4.8 etc.) for building the application.
(I have not got this to work yet so there is some more to go here when I get it sorted.)

Developers Documentation

2012-06-05T07:37:50Z

Zl2apv:

*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3_protocols More on the Ghpsdr communications protocols (and more up to date)]
*[[dspserver.conf]] The '''''dspserver.conf''''' file has it's own page

Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].

== Installing Qt5 ==
You need to add the unsupported packages to your system. It will exist as a stand alone system separate from any other version of qt or creator etc. that you may have installed.

=== 1. Adding the qt5 “Canonical Qt5 Edgers” ppa to your system ===

In a terminal, copy and paste ...
<pre>
sudo add-apt-repository ppa:canonical-qt5-edgers/qt5-daily
</pre>
Your system will now fetch the PPA's key. This enables your Ubuntu system to verify that the packages in the PPA have not been interfered with since they were built.

Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:
<pre>
sudo apt-get update
</pre>
Now you're ready to start installing software from the PPA!

=== 2. Installing from the ppa ===

You will be installing the packages from the daily build of qt5 and the version date etc. could change but it is important to check that you have marked for install the package corresponding to the qt5 build as some of the packages may also be installed for qt 4.8.x A good check is to open the url for the Edgers and compare your selection to their file list at [https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily canonical-qt5-edgers]

The packages will be identified with similar to
5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
I have shown the example on the first entry in the list only.

Open Synaptic and use the quick find to look for and mark for install each of the packages in the following list ...
<pre>
qt-components-qtquick2 5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
qt3d
qtbase
qtdeclarative
qtdoc
qtjsbackend
qtmultimedia
qtquick1
qtscript
qtsvg
qttools
qtwebkit
qtxmlpatterns

These packages will install by default in /opt/qt5
</pre>
note: there are a couple of packages which you do not need to install.

=== 3. Setting the path to qt5 ===

From a terminal
<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>
=== 4. Compiling QtRadio ===
<pre>
$ cd to the location of ghpsdr3-alex

$ sh cleanup
$ autoreconf -i
$ ./configure CXXFLAGS = '-O3 -fopenmp'
(for those of us with older machines use the line below instead)
$ ./configure CXXFLAGS='-O3 -msse2 -fopenmp'
$ make
$ sudo make install
</pre>
=== 5. Setting QtCreator to use the qt5 libraries ===

If you want to use Qt Creator (you use the same Qt Creator as with Qt4), you need to configure it to use Qt5 as one of the options:
<pre>
From the top line menu of QtCreator ...

Tools > Options > Build & Run
Click on the Qt Versions panel
Click on Add button
Navigate to /opt/qt5/bin
Click on qmake
Click on open
Click on Apply then OK
</pre>
You need to point to the qmake file which is found in /opt/qt5/bin

=== 6. Choosing the build library in QtCreator ===

you need to (re)import your QtRadio project and then you will be able to select Qt5 (or the previous Qt4.8 etc.) for building the application.
(I have not got this to work yet so there is some more to go here when I get it sorted.)

Developers Documentation

2012-06-05T07:35:30Z

Zl2apv: /* 2. Installing from the ppa */

*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3_protocols More on the Ghpsdr communications protocols (and more up to date)]
*[[dspserver.conf]] The '''''dspserver.conf''''' file has it's own page

Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].

== Installing Qt5 ==
You need to add the unsupported packages to your system. It will exist as a stand alone system separate from any other version of qt or creator etc. that you may have installed.

=== 1. Adding the qt5 “Canonical Qt5 Edgers” ppa to your system ===

In a terminal, copy and paste ...
<pre>
sudo add-apt-repository ppa:canonical-qt5-edgers/qt5-daily
</pre>
Your system will now fetch the PPA's key. This enables your Ubuntu system to verify that the packages in the PPA have not been interfered with since they were built.

Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:
<pre>
sudo apt-get update
</pre>
Now you're ready to start installing software from the PPA!

=== 2. Installing from the ppa ===

You will be installing the packages from the daily build of qt5 and the version date etc. could change but it is important to check that you have marked for install the package corresponding to the qt5 build as some of the packages may also be installed for qt 4.8.x A good check is to open the url for the Edgers and compare your selection to their file list at [https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily canonical-qt5-edgers]

The packages will be identified with similar to
5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
I have shown the example on the first entry in the list only.

Open Synaptic and use the quick find to look for and mark for install each of the packages in the following list ...
<pre>
qt-components-qtquick2 5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
qt3d
qtbase
qtdeclarative
qtdoc
qtjsbackend
qtmultimedia
qtquick1
qtscript
qtsvg
qttools
qtwebkit
qtxmlpatterns

These packages will install by default in /opt/qt5
</pre>
note: there are a couple of packages which you do not need to install.

=== 3. Setting the path to qt5 ===

From a terminal
<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>
=== 4. Compiling QtRadio ===
<pre>
$ cd to the location of ghpsdr3-alex

$ sh cleanup
$ autoreconf -i
$ ./configure CXXFLAGS = '-O3 -fopenmp'
(for those of us with older machines use the line below instead)
$ ./configure CXXFLAGS='-O3 -msse2 -fopenmp'
$ make
$ sudo make install
</pre>
=== 5. Setting QtCreator to use the qt5 libraries ===

If you want to use Qt Creator (you use the same Qt Creator as with Qt4), you need to configure it to use Qt5 as one of the options:
<pre>
Tools > Options > Build & Run
Click on the Qt Versions panel
Click on Add button
Navigate to /opt/qt5/bin
Click on qmake
Click on open
Click on Apply then OK
</pre>
You need to point to the qmake file which is found in /opt/qt5/bin

=== 6. Choosing the build library in QtCreator ===

you need to (re)import your QtRadio project and then you will be able to select Qt5 (or the previous Qt4.8 etc.) for building the application.
(I have not got this to work yet so there is some more to go here when I get it sorted.)

Developers Documentation

2012-06-05T07:31:38Z

Zl2apv: /* 2. Installing from the ppa */

*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3_protocols More on the Ghpsdr communications protocols (and more up to date)]
*[[dspserver.conf]] The '''''dspserver.conf''''' file has it's own page

Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].

== Installing Qt5 ==
You need to add the unsupported packages to your system. It will exist as a stand alone system separate from any other version of qt or creator etc. that you may have installed.

=== 1. Adding the qt5 “Canonical Qt5 Edgers” ppa to your system ===

In a terminal, copy and paste ...
<pre>
sudo add-apt-repository ppa:canonical-qt5-edgers/qt5-daily
</pre>
Your system will now fetch the PPA's key. This enables your Ubuntu system to verify that the packages in the PPA have not been interfered with since they were built.

Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:
<pre>
sudo apt-get update
</pre>
Now you're ready to start installing software from the PPA!

=== 2. Installing from the ppa ===

You will be installing the packages from the daily build of qt5 and the version date etc. could change but it is important to check that you have marked for install the package corresponding to the qt5 build as some of the packages may also be installed for qt 4.8.x A good check is to open the url for the Edgers and compare your selection to their file list at ...

[https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily]

The packages will be identified with similar to
5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
I have shown the example on the first entry in the list only.

Open Synaptic and use the quick find to look for and mark for install each of the packages in the following list ...
<pre>
qt-components-qtquick2 5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
qt3d
qtbase
qtdeclarative
qtdoc
qtjsbackend
qtmultimedia
qtquick1
qtscript
qtsvg
qttools
qtwebkit
qtxmlpatterns

These packages will install by default in /opt/qt5
</pre>
note: there are a couple of packages which you do not need to install.

=== 3. Setting the path to qt5 ===

From a terminal
<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>
=== 4. Compiling QtRadio ===
<pre>
$ cd to the location of ghpsdr3-alex

$ sh cleanup
$ autoreconf -i
$ ./configure CXXFLAGS = '-O3 -fopenmp'
(for those of us with older machines use the line below instead)
$ ./configure CXXFLAGS='-O3 -msse2 -fopenmp'
$ make
$ sudo make install
</pre>
=== 5. Setting QtCreator to use the qt5 libraries ===

If you want to use Qt Creator (you use the same Qt Creator as with Qt4), you need to configure it to use Qt5 as one of the options:
<pre>
Tools > Options > Build & Run
Click on the Qt Versions panel
Click on Add button
Navigate to /opt/qt5/bin
Click on qmake
Click on open
Click on Apply then OK
</pre>
You need to point to the qmake file which is found in /opt/qt5/bin

=== 6. Choosing the build library in QtCreator ===

you need to (re)import your QtRadio project and then you will be able to select Qt5 (or the previous Qt4.8 etc.) for building the application.
(I have not got this to work yet so there is some more to go here when I get it sorted.)

Developers Documentation

2012-06-05T07:29:40Z

Zl2apv:

*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3_protocols More on the Ghpsdr communications protocols (and more up to date)]
*[[dspserver.conf]] The '''''dspserver.conf''''' file has it's own page

Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].

== Installing Qt5 ==
You need to add the unsupported packages to your system. It will exist as a stand alone system separate from any other version of qt or creator etc. that you may have installed.

=== 1. Adding the qt5 “Canonical Qt5 Edgers” ppa to your system ===

In a terminal, copy and paste ...
<pre>
sudo add-apt-repository ppa:canonical-qt5-edgers/qt5-daily
</pre>
Your system will now fetch the PPA's key. This enables your Ubuntu system to verify that the packages in the PPA have not been interfered with since they were built.

Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:
<pre>
sudo apt-get update
</pre>
Now you're ready to start installing software from the PPA!

=== 2. Installing from the ppa ===

You will be installing the packages from the daily build of qt5 and the version date etc. could change but it is important to check that you have marked for install the package corresponding to the qt5 build as some of the packages may also be installed for qt 4.8.x A good check is to open the url for the Edgers and compare your selection to their file list at
https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily
The packages will be identified with similar to
5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
I have shown the example on the first entry in the list only.

Open Synaptic and use the quick find to look for and mark for install each of the packages in the following list ...
<pre>
qt-components-qtquick2 5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
qt3d
qtbase
qtdeclarative
qtdoc
qtjsbackend
qtmultimedia
qtquick1
qtscript
qtsvg
qttools
qtwebkit
qtxmlpatterns

These packages will install by default in /opt/qt5
</pre>
note: there are a couple of packages which you do not need to install.

=== 3. Setting the path to qt5 ===

From a terminal
<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>
=== 4. Compiling QtRadio ===
<pre>
$ cd to the location of ghpsdr3-alex

$ sh cleanup
$ autoreconf -i
$ ./configure CXXFLAGS = '-O3 -fopenmp'
(for those of us with older machines use the line below instead)
$ ./configure CXXFLAGS='-O3 -msse2 -fopenmp'
$ make
$ sudo make install
</pre>
=== 5. Setting QtCreator to use the qt5 libraries ===

If you want to use Qt Creator (you use the same Qt Creator as with Qt4), you need to configure it to use Qt5 as one of the options:
<pre>
Tools > Options > Build & Run
Click on the Qt Versions panel
Click on Add button
Navigate to /opt/qt5/bin
Click on qmake
Click on open
Click on Apply then OK
</pre>
You need to point to the qmake file which is found in /opt/qt5/bin

=== 6. Choosing the build library in QtCreator ===

you need to (re)import your QtRadio project and then you will be able to select Qt5 (or the previous Qt4.8 etc.) for building the application.
(I have not got this to work yet so there is some more to go here when I get it sorted.)

Developers Documentation

2012-06-05T07:26:14Z

Zl2apv:

*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3_protocols More on the Ghpsdr communications protocols (and more up to date)]
*[[dspserver.conf]] The '''''dspserver.conf''''' file has it's own page

Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].

== Installing Qt5 ==
You need to add the unsupported packages to your system. It will exist as a stand alone system separate from any other version of qt or creator etc. that you may have installed.

=== 1. Adding the qt5 “Canonical Qt5 Edgers” ppa to your system ===

In a terminal, copy and paste ...
<pre>
sudo add-apt-repository ppa:canonical-qt5-edgers/qt5-daily
</pre>
Your system will now fetch the PPA's key. This enables your Ubuntu system to verify that the packages in the PPA have not been interfered with since they were built.

Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:
<pre>
sudo apt-get update
</pre>
Now you're ready to start installing software from the PPA!

=== 2. Installing from the ppa ===

You will be installing the packages from the daily build of qt5 and the version date etc. could change but it is important to check that you have marked for install the package corresponding to the qt5 build as some of the packages may also be installed for qt 4.8.x A good check is to open the url for the Edgers and compare your selection to their file list at
https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily
The packages will be identified with similar to
5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
I have shown the example on the first entry in the list only.

Open Synaptic and use the quick find to look for and mark for install each of the packages in the following list ...
<pre>
qt-components-qtquick2 5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
qt3d
qtbase
qtdeclarative
qtdoc
qtjsbackend
qtmultimedia
qtquick1
qtscript
qtsvg
qttools
qtwebkit
qtxmlpatterns
</pre>
note: there are a couple of packages which you do not need to install.

These packages will install by default in /opt/qt5

=== 3. Setting the path to qt5 ===

From a terminal
<pre>
$ export PATH=/opt/qt5/bin:$PATH
</pre>
=== 4. Compiling QtRadio ===
<pre>
$ cd to the location of ghpsdr3-alex

$ sh cleanup
$ autoreconf -i
$ ./configure CXXFLAGS = '-O3 -fopenmp'
(for those of us with older machines use the line below instead)
$ ./configure CXXFLAGS='-O3 -msse2 -fopenmp'
$ make
$ sudo make install
</pre>
=== 5. Setting QtCreator to use the qt5 libraries ===

If you want to use Qt Creator (you use the same Qt Creator as with Qt4), you need to configure Qt Creator to use Qt5 as one of the options:
<pre>
Tools > Options > Build & Run
Click on the Qt Versions panel
Click on Add button
Navigate to /opt/qt5/bin
Click on qmake
Click on open
Click on Apply then OK
</pre>
You need to point to the qmake file which is found in /opt/qt5/bin

=== 6. Choosing the build library in QtCreator ===

you need to (re)import your QtRadio project and then you will be able to select Qt5 (or the previous Qt4.8 etc.) for building the application.
(I have not got this to work yet so there is some more to go here when I get it sorted.)

Developers Documentation

2012-06-05T07:22:06Z

Zl2apv:

*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3_protocols More on the Ghpsdr communications protocols (and more up to date)]
*[[dspserver.conf]] The '''''dspserver.conf''''' file has it's own page

Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].

== Installing Qt5 ==
You need to add the unsupported packages to your system. It will exist as a stand alone system separate from any other version of qt or creator etc. that you may have installed.

=== 1. Adding the qt5 “Canonical Qt5 Edgers” ppa to your system ===

In a terminal, copy and paste ...

sudo add-apt-repository ppa:canonical-qt5-edgers/qt5-daily

Your system will now fetch the PPA's key. This enables your Ubuntu system to verify that the packages in the PPA have not been interfered with since they were built.

Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:

sudo apt-get update

Now you're ready to start installing software from the PPA!

=== 2. Installing from the ppa ===

You will be installing the packages from the daily build of qt5 and the version date etc. could change but it is important to check that you have marked for install the package corresponding to the qt5 build as some of the packages may also be installed for qt 4.8.x A good check is to open the url for the Edgers and compare your selection to their file list at
https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily
The packages will be identified with similar to
5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
I have shown the example on the first entry in the list only.

Open Synaptic and use the quick find to look for and mark for install each of the packages in the following list ...

qt-components-qtquick2 5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
qt3d
qtbase
qtdeclarative
qtdoc
qtjsbackend
qtmultimedia
qtquick1
qtscript
qtsvg
qttools
qtwebkit
qtxmlpatterns

note: there are a couple of packages which you do not need to install.

These packages will install by default in /opt/qt5

=== 3. Setting the path to qt5 ===

From a terminal
$ export PATH=/opt/qt5/bin:$PATH

=== 4. Compiling QtRadio ===
<pre>
$ cd to the location of ghpsdr3-alex

$ sh cleanup
$ autoreconf -i
$ ./configure CXXFLAGS = '-O3 -fopenmp'
(for those of us with older machines use the line below instead)
$ ./configure CXXFLAGS='-O3 -msse2 -fopenmp'
$ make
$ sudo make install
</pre>
=== 5. Setting QtCreator to use the qt5 libraries ===

If you want to use Qt Creator (you use the same Qt Creator as with Qt4), you need to configure Qt Creator to use Qt5 as one of the options:

Tools > Options > Build & Run
Click on the Qt Versions panel
Click on Add button
Navigate to /opt/qt5/bin
Click on qmake
Click on open
Click on Apply then OK

You need to point to the qmake file which is found in /opt/qt5/bin

=== 6. Choosing the build library in QtCreator ===

you need to (re)import your QtRadio project and then you will be able to select Qt5 (or the previous Qt4.8 etc.) for building the application.
(I have not got this to work yet so there is some more to go here when I get it sorted.)

Developers Documentation

2012-06-05T07:19:40Z

Zl2apv:

*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3_protocols More on the Ghpsdr communications protocols (and more up to date)]
*[[dspserver.conf]] The '''''dspserver.conf''''' file has it's own page

Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].

== Installing Qt5 ==
You need to add the unsupported packages to your system. It will exist as a stand alone system separate from any other version of qt or creator etc. that you may have installed.

=== 1. Adding the qt5 “Canonical Qt5 Edgers” ppa to your system ===

In a terminal, copy and paste ...

sudo add-apt-repository ppa:canonical-qt5-edgers/qt5-daily

Your system will now fetch the PPA's key. This enables your Ubuntu system to verify that the packages in the PPA have not been interfered with since they were built.

Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:

sudo apt-get update

Now you're ready to start installing software from the PPA!

=== 2. Installing from the ppa ===

You will be installing the packages from the daily build of qt5 and the version date etc. could change but it is important to check that you have marked for install the package corresponding to the qt5 build as some of the packages may also be installed for qt 4.8.x A good check is to open the url for the Edgers and compare your selection to their file list at
https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily
The packages will be identified with similar to
5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
I have shown the example on the first entry in the list only.

Open Synaptic and use the quick find to look for and mark for install each of the packages in the following list ...

qt-components-qtquick2 5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
qt3d
qtbase
qtdeclarative
qtdoc
qtjsbackend
qtmultimedia
qtquick1
qtscript
qtsvg
qttools
qtwebkit
qtxmlpatterns

note: there are a couple of packages which you do not need to install.

These packages will install by default in /opt/qt5

=== 3. Setting the path to qt5 ===

From a terminal
$ export PATH=/opt/qt5/bin:$PATH

=== 4. Compiling QtRadio ===

'$' cd to the location of ghpsdr3-alex

'$' sh cleanup
\$ autoreconf -i
\$ ./configure CXXFLAGS = '-O3 -fopenmp'
(for those of us with older machines use the line below instead)
\$ ./configure CXXFLAGS='-O3 -msse2 -fopenmp'
\$ make
\$ sudo make install

=== 5. Setting QtCreator to use the qt5 libraries ===

If you want to use Qt Creator (you use the same Qt Creator as with Qt4), you need to configure Qt Creator to use Qt5 as one of the options:

Tools > Options > Build & Run
Click on the Qt Versions panel
Click on Add button
Navigate to /opt/qt5/bin
Click on qmake
Click on open
Click on Apply then OK

You need to point to the qmake file which is found in /opt/qt5/bin

=== 6. Choosing the build library in QtCreator ===

you need to (re)import your QtRadio project and then you will be able to select Qt5 (or the previous Qt4.8 etc.) for building the application.
(I have not got this to work yet so there is some more to go here when I get it sorted.)

Developers Documentation

2012-06-05T07:17:40Z

Zl2apv:

*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3_protocols More on the Ghpsdr communications protocols (and more up to date)]
*[[dspserver.conf]] The '''''dspserver.conf''''' file has it's own page

Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].

== Installing Qt5 ==
You need to add the unsupported packages to your system. It will exist as a stand alone system separate from any other version of qt or creator etc. that you may have installed.

=== 1. Adding the qt5 “Canonical Qt5 Edgers” ppa to your system ===

In a terminal, copy and paste ...

sudo add-apt-repository ppa:canonical-qt5-edgers/qt5-daily

Your system will now fetch the PPA's key. This enables your Ubuntu system to verify that the packages in the PPA have not been interfered with since they were built.

Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:

sudo apt-get update

Now you're ready to start installing software from the PPA!

=== 2. Installing from the ppa ===

You will be installing the packages from the daily build of qt5 and the version date etc. could change but it is important to check that you have marked for install the package corresponding to the qt5 build as some of the packages may also be installed for qt 4.8.x A good check is to open the url for the Edgers and compare your selection to their file list at
https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily
The packages will be identified with similar to
5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
I have shown the example on the first entry in the list only.

Open Synaptic and use the quick find to look for and mark for install each of the packages in the following list ...

qt-components-qtquick2 5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
qt3d
qtbase
qtdeclarative
qtdoc
qtjsbackend
qtmultimedia
qtquick1
qtscript
qtsvg
qttools
qtwebkit
qtxmlpatterns

note: there are a couple of packages which you do not need to install.

These packages will install by default in /opt/qt5

=== 3. Setting the path to qt5 ===

From a terminal
$ export PATH=/opt/qt5/bin:$PATH

=== 4. Compiling QtRadio ===

\$ cd to the location of ghpsdr3-alex

\$ sh cleanup
\$ autoreconf -i
\$ ./configure CXXFLAGS = '-O3 -fopenmp'
(for those of us with older machines use the line below instead)
\$ ./configure CXXFLAGS='-O3 -msse2 -fopenmp'
\$ make
\$ sudo make install

=== 5. Setting QtCreator to use the qt5 libraries ===

If you want to use Qt Creator (you use the same Qt Creator as with Qt4), you need to configure Qt Creator to use Qt5 as one of the options:

Tools > Options > Build & Run
Click on the Qt Versions panel
Click on Add button
Navigate to /opt/qt5/bin
Click on qmake
Click on open
Click on Apply then OK

You need to point to the qmake file which is found in /opt/qt5/bin

=== 6. Choosing the build library in QtCreator ===

you need to (re)import your QtRadio project and then you will be able to select Qt5 (or the previous Qt4.8 etc.) for building the application.
(I have not got this to work yet so there is some more to go here when I get it sorted.)

Developers Documentation

2012-06-05T07:15:11Z

Zl2apv:

*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3_protocols More on the Ghpsdr communications protocols (and more up to date)]
*[[dspserver.conf]] The '''''dspserver.conf''''' file has it's own page

Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].

== Installing Qt5 ==
You need to add the unsupported packages to your system. It will exist as a stand alone system separate from any other version of qt or creator etc. that you may have installed.

=== 1. Adding the qt5 “Canonical Qt5 Edgers” ppa to your system ===

In a terminal, copy and paste ...

sudo add-apt-repository ppa:canonical-qt5-edgers/qt5-daily

Your system will now fetch the PPA's key. This enables your Ubuntu system to verify that the packages in the PPA have not been interfered with since they were built.

Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:

sudo apt-get update

Now you're ready to start installing software from the PPA!

=== 2. Installing from the ppa ===

You will be installing the packages from the daily build of qt5 and the version date etc. could change but it is important to check that you have marked for install the package corresponding to the qt5 build as some of the packages may also be installed for qt 4.8.x A good check is to open the url for the Edgers and compare your selection to their file list at
https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily
The packages will be identified with similar to
5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
I have shown the example on the first entry in the list only.

Open Synaptic and use the quick find to look for and mark for install each of the packages in the following list ...

qt-components-qtquick2 5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
qt3d
qtbase
qtdeclarative
qtdoc
qtjsbackend
qtmultimedia
qtquick1
qtscript
qtsvg
qttools
qtwebkit
qtxmlpatterns

note: there are a couple of packages which you do not need to install.

These packages will install by default in /opt/qt5

=== 3. Setting the path to qt5 ===

From a terminal
$ export PATH=/opt/qt5/bin:$PATH

=== 4. Compiling QtRadio ===

$ cd to the location of ghpsdr3-alex

$ sh cleanup
$ autoreconf -i
$ ./configure CXXFLAGS = '-O3 -fopenmp'
(for those of us with older machines use the line below instead)
$ ./configure CXXFLAGS='-O3 -msse2 -fopenmp'
$ make
$ sudo make install

=== 5. Setting QtCreator to use the qt5 libraries ===

If you want to use Qt Creator (you use the same Qt Creator as with Qt4), you need to configure Qt Creator to use Qt5 as one of the options:

Tools > Options > Build & Run
Click on the Qt Versions panel
Click on Add button
Navigate to /opt/qt5/bin
Click on qmake
Click on open
Click on Apply then OK

You need to point to the qmake file which is found in /opt/qt5/bin

=== 6. Choosing the build library in QtCreator ===

you need to (re)import your QtRadio project and then you will be able to select Qt5 (or the previous Qt4.8 etc.) for building the application.
(I have not got this to work yet so there is some more to go here when I get it sorted.)

Developers Documentation

2012-06-05T07:11:46Z

Zl2apv:

*[https://github.com/alexlee188/ghpsdr3-alex Git Repository ]
*[https://github.com/alexlee188/ghpsdr3-alex/blob/master/README README]
*[http://code.google.com/p/sdr-shell/wiki/SDRCore Dttsp]
*[http://www.youtube.com/watch?v=6KtOzh0StTc A Very good video tutorial series on using QT and C++]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3 A Brief Description on the architecture of ghpsdr3]
*[http://openhpsdr.org/wiki/images/4/47/Ghpsdr3-protocols2010-08-07.pdf Ghpsdr3 communication protocols 2010-08-07]
*[http://openhpsdr.org/wiki/index.php?title=Ghpsdr3_protocols More on the Ghpsdr communications protocols (and more up to date)]
*[[dspserver.conf]] The '''''dspserver.conf''''' file has it's own page

Most of the development discussion has been taking place on the [http://groups.google.com/group/sdr-widget sdr-widget google group].

== Installing Qt5 ==
You need to add the unsupported packages to your system. It will exist as a stand alone system separate from any other version of qt or creator etc. that you may have installed.

=== 1. Adding the qt5 “Canonical Qt5 Edgers” ppa to your system ===

In a terminal, copy and paste ...

sudo add-apt-repository ppa:canonical-qt5-edgers/qt5-daily

Your system will now fetch the PPA's key. This enables your Ubuntu system to verify that the packages in the PPA have not been interfered with since they were built.

Now, as a one-off, you should tell your system to pull down the latest list of software from each archive it knows about, including the PPA you just added:

sudo apt-get update

Now you're ready to start installing software from the PPA!

=== 2. Installing from the ppa ===

You will be installing the packages from the daily build of qt5 and the version date etc. could change but it is important to check that you have marked for install the package corresponding to the qt5 build as some of the packages may also be installed for qt 4.8.x A good check is to open the url for the Edgers and compare your selection to their file list at
https://launchpad.net/~canonical-qt5-edgers/+archive/qt5-daily
The packages will be identified with similar to
5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
I have shown the example on the first entry in the list only.

Open Synaptic and use the quick find to look for and mark for install each of the packages in the following list ...

qt-components-qtquick2 5.0-2012xxx ubuntu5 Zoltan Balogh (2012-04-05)
qt3d
qtbase
qtdeclarative
qtdoc
qtjsbackend
qtmultimedia
qtquick1
qtscript
qtsvg
qttools
qtwebkit
qtxmlpatterns

note: there are a couple of packages which you do not need to install.

These packages will install by default in /opt/qt5

3. Setting the path to qt5

From a terminal
$ export PATH=/opt/qt5/bin:$PATH

4. Compiling QtRadio

$ cd to the location of ghpsdr3-alex

$ sh cleanup
$ autoreconf -i
$ ./configure CXXFLAGS = '-O3 -fopenmp'
(for those of us with older machines use the line below instead)
$ ./configure CXXFLAGS='-O3 -msse2 -fopenmp'
$ make
$ sudo make install

5. Setting QtCreator to use the qt5 libraries

If you want to use Qt Creator (you use the same Qt Creator as with Qt4), you need to configure Qt Creator to use Qt5 as one of the options:

Tools > Options > Build & Run
Click on the Qt Versions panel
Click on Add button
Navigate to /opt/qt5/bin
Click on qmake
Click on open
Click on Apply then OK

You need to point to the qmake file which is found in /opt/qt5/bin
6. Choosing the build library in QtCreator

Developers Documentation

2012-06-05T07:04:44Z

Zl2apv:

What's New

2012-02-19T21:06:08Z

Zl2apv:

===Feb 19 2012===
* Graeme ZL2APV has coded CW receive in QtRadio to behave the same as Kenwood, Yaesu, K3 etc.
===Feb 18 2012===
* Frank DG1SBG has got QtRadio to run on Mac OS X 10.6.8 ! http://www.youtube.com/watch?v=LaWnr6Pn3ek
===Feb 17 2012===
* Bugfix to possible segfault in dspserver
===Feb 16 2012===
* New Windows build of QtRadio (master branch) Download: http://napan.com/ve9gj/qtradio-master.zip
===Feb 11 2012===
* The android client AHPSDR now has a Server list feature just like QtRadio. Look under the menu item Servers and select from among the active servers Download information on the [[AHPSDR]] page
* The branch to use for most users is now the master branch. This is the one that most dspservers are running
* Fixed SetTXAMCarrierLevel bug when tx ="all" in master branch
* Two key Rx audio functions into their own QThread in QtRadio. This should help lower spec'd PCs
* Fixed a bug where the band edge line in the spectrum display was off by the offset value of the dspserver.

QtRadio - Operation

2011-12-05T01:57:03Z

Zl2apv: /* Band Selection */

=== Connecting to a server ===

== Tuning the radio ==
=== Fixed frequency radio ===
For crystal locked radios such as the softrock lite II or YU1LM sdr's It is necessary to use [[#Using subRx | subRx]]. The procedure is to set vfoA to your centre frequency, usually the crystal frequency / 4 and leave it alone as changing it will affect your centre frequency. Using the button on the vfo panel or the 'Receiver' Menu / subRx choice switch on the subRx. You can now tune within the limits of the sample rate of your sound card (48, 96 or 192 KHz).

Note that you need to start dspserver with LO offset of zero:

$ dspserver --lo 0

=== si570 tunable radio ===

In the Softrock series of hardware using sound cards, there is frequently a noise band near DC (offset 0). As such most users will set an offset of 9000 Hz (or 12000Hz etc.) using programs such as PSDR-IQ. You do the same when starting dspserver:

$ dspserver --lo 9000

=== Direct Down Conversion (DDC) radio ===

Such radios (eg. Perseus, HPSDR, usrp) do not need the offset. So start dspserver with:

$ dspserver --lo 0

== Setting the noise floor ==
The height of the spectrum from the baseline is adjusted by rolling the mouse wheel with the pointer over the level calibration markings on the extreme left hand side of the spectrum window. This will at the same time change the base colour of the waterfall.

The procedure is: After setting the [[#Calibrating the S meter | sound-card gain]] you should remove the antenna and roll the mouse-wheel to give a spectrum display line just above the bottom of the window. When you apply the antenna the spectrum will rise in the window and the waterfall base colour should be dark blue unless the band is particularly noisy.

== Calibrating the S meter ==
To calibrate the S Meter, a signal equal to S9 (-73 dBm) is injected into the sdr and the soundcard gain is adjusted using the pulse audio volume control until the S meter reads S9. It will then probably be necessary to adjust the spectrum [[#Setting the noise floor | noise floor]] level.

A subjective calibration may be performed by tuning into a signal considered S9 and performing the above procedure.

== VFO and Split selection ==

== Using RIT ==

== Changing bands ==

== Using Quick Memories ==
===Overview===
The quick memories are used in conjunction with the VFO memory to give quick access to storing and retrieving memories which will be used on a temporary basis. Each selected quick memory is transferred to the vfo memory and if any tune operation is made the operation shifts to the vfo and the displayed frequency of course is the operational frequency. Data held in memory or vfo is stored in the config file and is available through sessions with the last used frequency being the next start frequency. Long term memory storage should be made via the [[#Bookmarks | Bookmarks]] facility.

===VFO memory===
The vfo has a memory associated with it for each band and allows startup of QtRadio to retrieve last frequency, mode, filter and spectrum/waterfall settings used. Shifting to another band allows the last used frequency etc. for that band to be retrieved and of course a return to the original band will get back the original data.
===Storing===
Storing a quick memory is accomplished by right clicking over any of the band buttons. The software will work out the right button for the frequency and store it there. The storage button will light up yellow for 1/2 second and the status bar will show ... the current band, the current read memory position and current store memory position, Mode, Filter and "stored at" store memory number. If the current frequency, mode and filter is already stored in quick memory, the memory will become the current memory and no extra storage will take place. Storage is always made to overwrite the oldest stored memory position so if your memories are stored as 0,1,2 for 3 quick memories and memory 2 was the last stored location, then memory 0 would be would be the next storage location. The index to the current memory storage location is saved on shutdown.
===Reading from Band Buttons===
A left click on the band button will cycle through the stored memories without ever overwriting them. The data in the selected memory is copied to the vfo memory and any change to the vfo is not written to memory unless explicitly via a right click over the bandbutton area. Full current information is retrieved from the memory and consists of Frequency, Mode, Filter, Spectrum info and Waterfall info. The index to the current memory read location is saved on shutdown. The status bar is updated to reflect the memory read/write information and a message is displayed advising you the vfo is currently matching a retrieved memory.
===Reading from Band menu===
Please refer to main menu section [[#Band Selection | Band]]

== Using subRx ==
To be constructed

== The Menu choices ==

=== Receiver ===
''Connect/Disconnect''

You can connect to a server either by selecting the server in the Configure > Server list and then click Connect, or by selecting the server in the Quick Server List and click connect.

After you Disconnect from a server, you must wait at least 10 seconds for the disconnection to take full effect before connecting to another server. This is to allow the internet connection to really disconnect (remember there is network latency and the server will continue to send data till its buffers are emptied). Failure to do so will often result in error in QtRadio and may even hang QtRadio.

''Quick Server List''

If you see that a public server's status is "Busy", please '''do not''' connect to it. Doing so will disrupt the user already connected. If you see a server's status is "Idle" or "0 client(s)", you can connect to it. If you see "1 client(s)" or "2 client(s)" etc., you are sharing a connection to the same server. The first client is the master who has control over the vfo and Tx etc., and you will be connecting as a slave. You will only be able to listen to the audio and see the spectrum passively as an observer. When the clients before you disconnect, you will automatically become the master. This is a queuing mechanism.

''Configure > Audio''

If you are connecting to a public server on the Internet (ie not your own server on your LAN), '''please''' set Audio to 8000, aLaw, and 1 channel. If you use other settings, your QtRadio and/or the dspserver/server will hang.

=== Audio ===

=== Band ===
====Keypad====
Clicking on the keypad brings up a key entry window. The frequency must be entered by clicking on the number pads and should be in the form MHz dot KHz i.e. 14.293 Entering in KHz will cause an error which is not trapped yet.
====Band Selection====
The band menu allows selection of a band by clicking on the desired entry. Clicks on the already checked band stores the current vfo frequency and radio information to the current quick memory location then steps to the next memory position where it retrieves the stored frequency, mode, filter and spectrum/waterfall settings.
The status line on the bottom right hand side of the window will display ... Band, (Current memory, next store location), Mode, Filter and a memory information message.

====XVTR====
To Come

=== Mode ===
=== Filter ===
=== Noise Reduction ===
=== AGC ===
=== Spectrum ===
=== Hardware ===
=== Bookmarks ===
Bookmarks are for storing semi permanent frequencies like favourite radio station or weekly sked etc.
====Saving a bookmark====
Tune to the frequency to be stored and set up mode, filter and spectra.
From the main menu choose Bookmarks/Bookmark this frequency and an entry panel will appear
The Title may be edited from simply the frequency to say "3.61 Weekly fists net"
Choose "OK" to store.
====Retrieving a bookmark====
From the main menu choose Bookmarks/View Bookmarks.
Run the mouse cursor up and down the list of stored frequencies and click to choose
====Editing a bookmark====
This facility allows editing of the title or deletion of an entry.
<pre>
* From the main menu choose Bookmarks/Edit Bookmarks.
* From the left hand panel click on the item to be edited.
* Either edit the title and click on update,
or click on delete.
</pre>
'''Note:''' only the title is editable and if other data is needed to be changed it will be necessary to delete the entry and start again.

== Transmit commands ==

== Keyboard Shortcuts ==
* Arrow Left/Right Tune Down/Up the active VFO
* Arrow Up/Down Increase /Decrease Step Size above
* lowercase a = VFOA
* lowercase b = VFOB
* lowercase c = Connect
* lowercase d = Disconnect
* lowercase k= Bring up Keypad entry window
* lowercase l = Bring up Quick Connect Window
* lowercase s = toggle SubRX

== Using the Griffin Powermate USB Dial as VFO Knob ==
=== The Griffin Powermate USB DIal ===
[[File:powermate_.png|200px]]

The Griffin Powermate has a single wheel and a pushbutton, which is
able to do the following actions:

<pre>
1. Rotate Clockwise
2. Rotate Counterclockwise
3. Push Down and Rotate Clockwise
4. Push Down and Rotate Counterclockwise
5. Push Down
6. Long Push Down
7. Responisve Blue LED's
</pre>

So we have 6 possibilities to map to keystrokes, soundcard levels and so on.

In Windows you may refer to the following Document published by FlexRadio. Install the Powermate Software for Windows and map your wanted keys.

http://support.flexradio.com/Downloads.aspx?id=47

=== Download Gizmod ===

In Linux there is Gizmo Daemon - THE Linux Linux Input Device Utility.

'''You need at least Ubuntu 11.10 installed'''

Unfortunately Gizmo is no longer supported by Ubuntu and most other Linux Distributions. The last update on the Gizmo page was in 2009.

So the following Setup is experimental until we may have support for the Powermate in QtRadio or Hamlib directly.

1. Go to your preferred local git directory.
<pre>
$ git clone git://github.com/jtriley/gizmod.git
</pre>

<pre>
$ cd gizmod
</pre>

Make the following two patches:

<pre>
index 14b8d37..b61e2a1 100644
--- a/libH/Average.hpp
+++ b/libH/Average.hpp
@@ -35,6 +35,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

You may apply the above patch manually by:
<pre>
$ gedit libH/Average.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

Do the same with the following patch:

<pre>
index d794055..75f4c27 100644
--- a/libH/DynamicBuffer.hpp
+++ b/libH/DynamicBuffer.hpp
@@ -33,6 +33,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

<pre>
gedit libHDynamicBuffer.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

<pre>
$ gedit cpuusage.cpp
</pre>

add

<pre>
#include <cstring>
</pre>

<pre>
$ sudo apt-get install libboost-all-dev
$ sudo apt-get install libboost-filesystem1.46.1
$ sudo apt-get install libboost-filesystem1.46-dev
</pre>

<pre>
$ mkdir build
$ cd build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr -DSYSCONF_INSTALL_DIR=/etc ../
$ make
</pre>

If you still get an error do:

<pre>
$ gedit gizmod/CMakeFiles/gizmod.dir/link.txt
</pre>

and add:

<pre>
-lboost_system
</pre>

<pre>
$ make
$ sudo make install
</pre>

=== Setup Gizmod ===
<pre>
$ sudo groupadd input
$ sudo gpasswd -a your_user_name input
$ cd /etc/udev/rules.d/
</pre>

Create a file called 99-input.rules and put in it:

<pre>
$ sudo gedit 99-input.rules
</pre>
<pre>
KERNEL=="event*", NAME="input/%k", MODE="660", GROUP="input"<BR>
KERNEL=="js*", NAME="input/%k", MODE="664", GROUP="input"<BR>
</pre>

'''Reboot System'''

Go to your user directory and do:
<pre>
$ mkdir -p .gizmod
</pre>

<pre>
$ cp /usr/etc/gizmod/* .gizmod
</pre>

<pre>
$ mkdir .gizmod/modules.d
</pre>

<pre>
$ cp /usr/etc/gizmod/modules.d/000-CatchAllDebug.py .gizmod/modules.d/
$ cp /usr/etc/gizmod/modules.d/299-Powermate-Default.py .gizmod/modules.d/
</pre>

<pre>
$ cp -r /usr/etc/gizmod/modules.d/bases/ .gizmod/modules.d/
</pre>

<pre>
$ cp -r /usr/etc/gizmod/modules.d/visualizers/ .gizmod/modules.d/
</pre>

<pre>
$ cd .gizmod/modules.d
</pre>

<pre>
$ gedit 299-Powermate-Default.py
</pre>

Edit 299-Powermate-Default.py like this (Do not change the Filename and edit exactly)

<pre>
#***
#*********************************************************************
#*************************************************************************
#***
#*** GizmoDaemon Config Script
#*** Powermate Default config
#***
#*****************************************
#*****************************************
#***

"""

Copyright (c) 2007, Gizmo Daemon Team
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

"""

############################
# Imports
##########################

from GizmoDaemon import *
from GizmoScriptDefault import *
import time

ENABLED = True
VERSION_NEEDED = 3.2
INTERESTED_CLASSES = [GizmoEventClass.Powermate]

############################
# PowermateDefault Class definition
##########################

class PowermateDefault(GizmoScriptDefault):
"""
Default Powermate Event Mapping
"""

############################
# Public Functions
##########################

def onDeviceEvent(self, Event, Gizmo = None):
"""
Called from Base Class' onEvent method.
See GizmodDispatcher.onEvent documention for an explanation of this function
"""

# Check for rotations
if Event.Type == GizmoEventType.EV_REL:
if Gizmo.getKeyState(GizmoKey.BTN_0):
if Gizmod.DefaultMixerVolume:
Gizmod.DefaultMixerVolume.VolumePlayback = Gizmod.DefaultMixerVolume.VolumePlayback + Event.Value
else:
# scroll quickly (by pages using the page up / page down keys)
if Event.Value < 0:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_RIGHT)
else:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_LEFT)
return True
elif Event.Type == GizmoEventType.EV_KEY:
if Event.Value == 0 and not Gizmo.Rotated:
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_UP)
return True
return False

############################
# Private Functions
##########################

def __init__(self):
"""
Default Constructor
"""

GizmoScriptDefault.__init__(self, ENABLED, VERSION_NEEDED, INTERESTED_CLASSES)

############################
# PowermateDefault class end
##########################

# register the user script
PowermateDefault()
</pre>

<pre>
$ gizmod
</pre>

you should see the following output:(depends on your system)

<pre>
GizmoDaemon v3.4 -=- (c) 2007, Tim Burrell <tim.burrell@gmail.com>
=---------=

Registering Devices:

Standard - Directory [input]
Standard - Sleep Button [event0] vId: 0x0 pId: 0x3
Standard - Lid Switch [event1] vId: 0x0 pId: 0x5
Standard - HDA Intel Mic [event10] vId: 0x0 pId: 0x0
Standard - HDA Intel Mic [event11] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event12] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event13] vId: 0x0 pId: 0x0
Standard - Power Button [event2] vId: 0x0 pId: 0x1
Keyboard - AT Translated Set 2 keyboard [event3] vId: 0x1 pId: 0x1
Standard - Asus Laptop extra buttons [event4] vId: 0x0 pId: 0x0
Powermate - Griffin PowerMate [event5] vId: 0x77d pId: 0x410
Standard - CNF7237&CNF7238 [event6] vId: 0x17ef pId: 0x4808
Mouse - SynPS/2 Synaptics TouchPad [event7] vId: 0x2 pId: 0x7
Standard - Video Bus [event8] vId: 0x0 pId: 0x6
Standard - HDA Intel HDMI/DP,pcm=3 [event9] vId: 0x0 pId: 0x0

Loading User Scripts:

CatchAllDebug - CatchAll Event Mapping for Testing
PowermateDefault - Default Powermate Event Mapping
</pre>

You should have the following functions:

<pre>
turn left = KEY RIGHT
turn right = KEY LEFT
press and turn left = System Volume down
press and turn right = System Volume up
Buttonpress = cycle through Step Size
</pre>

QtRadio - Operation

2011-12-01T22:48:50Z

Zl2apv: /* Calibrating the S meter */

=== Connecting to a server ===

== Tuning the radio ==
=== Fixed frequency radio ===
For crystal locked radios such as the softrock lite II or YU1LM sdr's It is necessary to use [[#Using subRx | subRx]]. The procedure is to set vfoA to your centre frequency, usually the crystal frequency / 4 and leave it alone as changing it will affect your centre frequency. Using the button on the vfo panel or the 'Receiver' Menu / subRx choice switch on the subRx. You can now tune within the limits of the sample rate of your sound card (48, 96 or 192 KHz).

Note that you need to start dspserver with LO offset of zero:

$ dspserver --lo 0

=== si570 tunable radio ===

In the Softrock series of hardware using sound cards, there is frequently a noise band near DC (offset 0). As such most users will set an offset of 9000 Hz (or 12000Hz etc.) using programs such as PSDR-IQ. You do the same when starting dspserver:

$ dspserver --lo 9000

=== Direct Down Conversion (DDC) radio ===

Such radios (eg. Perseus, HPSDR, usrp) do not need the offset. So start dspserver with:

$ dspserver --lo 0

== Setting the noise floor ==
The height of the spectrum from the baseline is adjusted by rolling the mouse wheel with the pointer over the level calibration markings on the extreme left hand side of the spectrum window. This will at the same time change the base colour of the waterfall.

The procedure is: After setting the [[#Calibrating the S meter | sound-card gain]] you should remove the antenna and roll the mouse-wheel to give a spectrum display line just above the bottom of the window. When you apply the antenna the spectrum will rise in the window and the waterfall base colour should be dark blue unless the band is particularly noisy.

== Calibrating the S meter ==
To calibrate the S Meter, a signal equal to S9 (-73 dBm) is injected into the sdr and the soundcard gain is adjusted using the pulse audio volume control until the S meter reads S9. It will then probably be necessary to adjust the spectrum [[#Setting the noise floor | noise floor]] level.

A subjective calibration may be performed by tuning into a signal considered S9 and performing the above procedure.

== VFO and Split selection ==

== Using RIT ==

== Changing bands ==

== Using Quick Memories ==
===Overview===
The quick memories are used in conjunction with the VFO memory to give quick access to storing and retrieving memories which will be used on a temporary basis. Each selected quick memory is transferred to the vfo memory and if any tune operation is made the operation shifts to the vfo and the displayed frequency of course is the operational frequency. Data held in memory or vfo is stored in the config file and is available through sessions with the last used frequency being the next start frequency. Long term memory storage should be made via the [[#Bookmarks | Bookmarks]] facility.

===VFO memory===
The vfo has a memory associated with it for each band and allows startup of QtRadio to retrieve last frequency, mode, filter and spectrum/waterfall settings used. Shifting to another band allows the last used frequency etc. for that band to be retrieved and of course a return to the original band will get back the original data.
===Storing===
Storing a quick memory is accomplished by right clicking over any of the band buttons. The software will work out the right button for the frequency and store it there. The storage button will light up yellow for 1/2 second and the status bar will show ... the current band, the current read memory position and current store memory position, Mode, Filter and "stored at" store memory number. If the current frequency, mode and filter is already stored in quick memory, the memory will become the current memory and no extra storage will take place. Storage is always made to overwrite the oldest stored memory position so if your memories are stored as 0,1,2 for 3 quick memories and memory 2 was the last stored location, then memory 0 would be would be the next storage location. The index to the current memory storage location is saved on shutdown.
===Reading from Band Buttons===
A left click on the band button will cycle through the stored memories without ever overwriting them. The data in the selected memory is copied to the vfo memory and any change to the vfo is not written to memory unless explicitly via a right click over the bandbutton area. Full current information is retrieved from the memory and consists of Frequency, Mode, Filter, Spectrum info and Waterfall info. The index to the current memory read location is saved on shutdown. The status bar is updated to reflect the memory read/write information and a message is displayed advising you the vfo is currently matching a retrieved memory.
===Reading from Band menu===
Please refer to main menu section [[#Band Selection | Band]]

== Using subRx ==
To be constructed

== The Menu choices ==

=== Receiver ===
''Connect/Disconnect''

You can connect to a server either by selecting the server in the Configure > Server list and then click Connect, or by selecting the server in the Quick Server List and click connect.

After you Disconnect from a server, you must wait at least 10 seconds for the disconnection to take full effect before connecting to another server. This is to allow the internet connection to really disconnect (remember there is network latency and the server will continue to send data till its buffers are emptied). Failure to do so will often result in error in QtRadio and may even hang QtRadio.

''Quick Server List''

If you see that a public server's status is "Busy", please '''do not''' connect to it. Doing so will disrupt the user already connected. If you see a server's status is "Idle" or "0 client(s)", you can connect to it. If you see "1 client(s)" or "2 client(s)" etc., you are sharing a connection to the same server. The first client is the master who has control over the vfo and Tx etc., and you will be connecting as a slave. You will only be able to listen to the audio and see the spectrum passively as an observer. When the clients before you disconnect, you will automatically become the master. This is a queuing mechanism.

''Configure > Audio''

If you are connecting to a public server on the Internet (ie not your own server on your LAN), '''please''' set Audio to 8000, aLaw, and 1 channel. If you use other settings, your QtRadio and/or the dspserver/server will hang.

=== Audio ===

=== Band ===
====Keypad====
Clicking on the keypad brings up a key entry window. The frequency must be entered by clicking on the number pads and should be in the form MHz dot KHz i.e. 14.293 Entering in KHz will cause an error which is not trapped yet.
====Band Selection====
The band menu allows selection of a band by clicking on the desired entry. Clicks on an already selected entry steps to the next memory position and sets the stored frequency, mode, filter and spectrum/waterfall settings.
The status line on the bottom right hand side of the window will display ... Band, Memory position, Mode, Filter and whether using memory or vfo.
====XVTR====
To Come

=== Mode ===
=== Filter ===
=== Noise Reduction ===
=== AGC ===
=== Spectrum ===
=== Hardware ===
=== Bookmarks ===
Bookmarks are for storing semi permanent frequencies like favourite radio station or weekly sked etc.
====Saving a bookmark====
Tune to the frequency to be stored and set up mode, filter and spectra.
From the main menu choose Bookmarks/Bookmark this frequency and an entry panel will appear
The Title may be edited from simply the frequency to say "3.61 Weekly fists net"
Choose "OK" to store.
====Retrieving a bookmark====
From the main menu choose Bookmarks/View Bookmarks.
Run the mouse cursor up and down the list of stored frequencies and click to choose
====Editing a bookmark====
This facility allows editing of the title or deletion of an entry.
<pre>
* From the main menu choose Bookmarks/Edit Bookmarks.
* From the left hand panel click on the item to be edited.
* Either edit the title and click on update,
or click on delete.
</pre>
'''Note:''' only the title is editable and if other data is needed to be changed it will be necessary to delete the entry and start again.

== Transmit commands ==

== Keyboard Shortcuts ==
* Arrow Left/Right Tune Down/Up the active VFO
* Arrow Up/Down Increase /Decrease Step Size above
* lowercase a = VFOA
* lowercase b = VFOB
* lowercase c = Connect
* lowercase d = Disconnect
* lowercase k= Bring up Keypad entry window
* lowercase l = Bring up Quick Connect Window
* lowercase s = toggle SubRX

== Using the Griffin Powermate USB Dial as VFO Knob ==
=== The Griffin Powermate USB DIal ===
[[File:powermate_.png|200px]]

The Griffin Powermate has a single wheel and a pushbutton, which is
able to do the following actions:

<pre>
1. Rotate Clockwise
2. Rotate Counterclockwise
3. Push Down and Rotate Clockwise
4. Push Down and Rotate Counterclockwise
5. Push Down
6. Long Push Down
7. Responisve Blue LED's
</pre>

So we have 6 possibilities to map to keystrokes, soundcard levels and so on.

In Windows you may refer to the following Document published by FlexRadio. Install the Powermate Software for Windows and map your wanted keys.

http://support.flexradio.com/Downloads.aspx?id=47

=== Download Gizmod ===

In Linux there is Gizmo Daemon - THE Linux Linux Input Device Utility.

'''You need at least Ubuntu 11.10 installed'''

Unfortunately Gizmo is no longer supported by Ubuntu and most other Linux Distributions. The last update on the Gizmo page was in 2009.

So the following Setup is experimental until we may have support for the Powermate in QtRadio or Hamlib directly.

1. Go to your preferred local git directory.
<pre>
$ git clone git://github.com/jtriley/gizmod.git
</pre>

<pre>
$ cd gizmod
</pre>

Make the following two patches:

<pre>
index 14b8d37..b61e2a1 100644
--- a/libH/Average.hpp
+++ b/libH/Average.hpp
@@ -35,6 +35,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

You may apply the above patch manually by:
<pre>
$ gedit libH/Average.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

Do the same with the following patch:

<pre>
index d794055..75f4c27 100644
--- a/libH/DynamicBuffer.hpp
+++ b/libH/DynamicBuffer.hpp
@@ -33,6 +33,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

<pre>
gedit libHDynamicBuffer.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

<pre>
$ gedit cpuusage.cpp
</pre>

add

<pre>
#include <cstring>
</pre>

<pre>
$ sudo apt-get install libboost-all-dev
$ sudo apt-get install libboost-filesystem1.46.1
$ sudo apt-get install libboost-filesystem1.46-dev
</pre>

<pre>
$ mkdir build
$ cd build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr -DSYSCONF_INSTALL_DIR=/etc ../
$ make
</pre>

If you still get an error do:

<pre>
$ gedit gizmod/CMakeFiles/gizmod.dir/link.txt
</pre>

and add:

<pre>
-lboost_system
</pre>

<pre>
$ make
$ sudo make install
</pre>

=== Setup Gizmod ===

Go to your user directory and do:
<pre>
$ mkdir -p .gizmod
</pre>

<pre>
$ cp /usr/etc/gizmod * .gizmod
</pre>

<pre>
$ mkdir .gizmod/modules.d
</pre>

<pre>
$ cp /usr/etc/gizmod/modules.d/000-CatchAllDebug.py .gizmod/modules.d/
$ cp /usr/etc/gizmod/modules.d/299-Powermate-Default.py .gizmod/modules.d/
</pre>

<pre>
$ cd .gizmod/modules.d
</pre>

<pre>
$ gedit 299-Powermate-Default.py
</pre>

Edit 299-Powermate-Default.py like this (Do not change the Filename and edit exactly)

<pre>
#***
#*********************************************************************
#*************************************************************************
#***
#*** GizmoDaemon Config Script
#*** Powermate Default config
#***
#*****************************************
#*****************************************
#***

"""

Copyright (c) 2007, Gizmo Daemon Team
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

"""

############################
# Imports
##########################

from GizmoDaemon import *
from GizmoScriptDefault import *
import time

ENABLED = True
VERSION_NEEDED = 3.2
INTERESTED_CLASSES = [GizmoEventClass.Powermate]

############################
# PowermateDefault Class definition
##########################

class PowermateDefault(GizmoScriptDefault):
"""
Default Powermate Event Mapping
"""

############################
# Public Functions
##########################

def onDeviceEvent(self, Event, Gizmo = None):
"""
Called from Base Class' onEvent method.
See GizmodDispatcher.onEvent documention for an explanation of this function
"""

# Check for rotations
if Event.Type == GizmoEventType.EV_REL:
if Gizmo.getKeyState(GizmoKey.BTN_0):
if Gizmod.DefaultMixerVolume:
Gizmod.DefaultMixerVolume.VolumePlayback = Gizmod.DefaultMixerVolume.VolumePlayback + Event.Value
else:
# scroll quickly (by pages using the page up / page down keys)
if Event.Value < 0:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_RIGHT)
else:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_LEFT)
return True
elif Event.Type == GizmoEventType.EV_KEY:
if Event.Value == 0 and not Gizmo.Rotated:
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_PLUS)
return True
return False

############################
# Private Functions
##########################

def __init__(self):
"""
Default Constructor
"""

GizmoScriptDefault.__init__(self, ENABLED, VERSION_NEEDED, INTERESTED_CLASSES)

############################
# PowermateDefault class end
##########################

# register the user script
PowermateDefault()
</pre>

<pre>
$ gizmod
</pre>

you should see the following output:(depends on your system)

<pre>
GizmoDaemon v3.4 -=- (c) 2007, Tim Burrell <tim.burrell@gmail.com>
=---------=

Registering Devices:

Standard - Directory [input]
Standard - Sleep Button [event0] vId: 0x0 pId: 0x3
Standard - Lid Switch [event1] vId: 0x0 pId: 0x5
Standard - HDA Intel Mic [event10] vId: 0x0 pId: 0x0
Standard - HDA Intel Mic [event11] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event12] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event13] vId: 0x0 pId: 0x0
Standard - Power Button [event2] vId: 0x0 pId: 0x1
Keyboard - AT Translated Set 2 keyboard [event3] vId: 0x1 pId: 0x1
Standard - Asus Laptop extra buttons [event4] vId: 0x0 pId: 0x0
Powermate - Griffin PowerMate [event5] vId: 0x77d pId: 0x410
Standard - CNF7237&CNF7238 [event6] vId: 0x17ef pId: 0x4808
Mouse - SynPS/2 Synaptics TouchPad [event7] vId: 0x2 pId: 0x7
Standard - Video Bus [event8] vId: 0x0 pId: 0x6
Standard - HDA Intel HDMI/DP,pcm=3 [event9] vId: 0x0 pId: 0x0

Loading User Scripts:

CatchAllDebug - CatchAll Event Mapping for Testing
PowermateDefault - Default Powermate Event Mapping
</pre>

You should have the following functions:

<pre>
turn left = KEY RIGHT
turn right = KEY LEFT
press and turn left = System Volume down
press and turn right = System Volume up
Buttonpress = cycle through Step Size
</pre>

QtRadio - Operation

2011-12-01T22:45:02Z

Zl2apv: /* Editing a bookmark */

=== Connecting to a server ===

== Tuning the radio ==
=== Fixed frequency radio ===
For crystal locked radios such as the softrock lite II or YU1LM sdr's It is necessary to use [[#Using subRx | subRx]]. The procedure is to set vfoA to your centre frequency, usually the crystal frequency / 4 and leave it alone as changing it will affect your centre frequency. Using the button on the vfo panel or the 'Receiver' Menu / subRx choice switch on the subRx. You can now tune within the limits of the sample rate of your sound card (48, 96 or 192 KHz).

Note that you need to start dspserver with LO offset of zero:

$ dspserver --lo 0

=== si570 tunable radio ===

In the Softrock series of hardware using sound cards, there is frequently a noise band near DC (offset 0). As such most users will set an offset of 9000 Hz (or 12000Hz etc.) using programs such as PSDR-IQ. You do the same when starting dspserver:

$ dspserver --lo 9000

=== Direct Down Conversion (DDC) radio ===

Such radios (eg. Perseus, HPSDR, usrp) do not need the offset. So start dspserver with:

$ dspserver --lo 0

== Setting the noise floor ==
The height of the spectrum from the baseline is adjusted by rolling the mouse wheel with the pointer over the level calibration markings on the extreme left hand side of the spectrum window. This will at the same time change the base colour of the waterfall.

The procedure is: After setting the [[#Calibrating the S meter | sound-card gain]] you should remove the antenna and roll the mouse-wheel to give a spectrum display line just above the bottom of the window. When you apply the antenna the spectrum will rise in the window and the waterfall base colour should be dark blue unless the band is particularly noisy.

== Calibrating the S meter ==
To calibrate the S Meter, a signal equal to S9 (-73 dBm) is injected into the sdr and the soundcard gain is adjusted until the S meter reads S9. It will then probably be necessary to adjust the spectrum [[#Setting the noise floor | noise floor]] level.

A subjective calibration may be performed by tuning into a signal considered S9 and performing the above procedure.

== VFO and Split selection ==

== Using RIT ==

== Changing bands ==

== Using Quick Memories ==
===Overview===
The quick memories are used in conjunction with the VFO memory to give quick access to storing and retrieving memories which will be used on a temporary basis. Each selected quick memory is transferred to the vfo memory and if any tune operation is made the operation shifts to the vfo and the displayed frequency of course is the operational frequency. Data held in memory or vfo is stored in the config file and is available through sessions with the last used frequency being the next start frequency. Long term memory storage should be made via the [[#Bookmarks | Bookmarks]] facility.

===VFO memory===
The vfo has a memory associated with it for each band and allows startup of QtRadio to retrieve last frequency, mode, filter and spectrum/waterfall settings used. Shifting to another band allows the last used frequency etc. for that band to be retrieved and of course a return to the original band will get back the original data.
===Storing===
Storing a quick memory is accomplished by right clicking over any of the band buttons. The software will work out the right button for the frequency and store it there. The storage button will light up yellow for 1/2 second and the status bar will show ... the current band, the current read memory position and current store memory position, Mode, Filter and "stored at" store memory number. If the current frequency, mode and filter is already stored in quick memory, the memory will become the current memory and no extra storage will take place. Storage is always made to overwrite the oldest stored memory position so if your memories are stored as 0,1,2 for 3 quick memories and memory 2 was the last stored location, then memory 0 would be would be the next storage location. The index to the current memory storage location is saved on shutdown.
===Reading from Band Buttons===
A left click on the band button will cycle through the stored memories without ever overwriting them. The data in the selected memory is copied to the vfo memory and any change to the vfo is not written to memory unless explicitly via a right click over the bandbutton area. Full current information is retrieved from the memory and consists of Frequency, Mode, Filter, Spectrum info and Waterfall info. The index to the current memory read location is saved on shutdown. The status bar is updated to reflect the memory read/write information and a message is displayed advising you the vfo is currently matching a retrieved memory.
===Reading from Band menu===
Please refer to main menu section [[#Band Selection | Band]]

== Using subRx ==
To be constructed

== The Menu choices ==

=== Receiver ===
''Connect/Disconnect''

You can connect to a server either by selecting the server in the Configure > Server list and then click Connect, or by selecting the server in the Quick Server List and click connect.

After you Disconnect from a server, you must wait at least 10 seconds for the disconnection to take full effect before connecting to another server. This is to allow the internet connection to really disconnect (remember there is network latency and the server will continue to send data till its buffers are emptied). Failure to do so will often result in error in QtRadio and may even hang QtRadio.

''Quick Server List''

If you see that a public server's status is "Busy", please '''do not''' connect to it. Doing so will disrupt the user already connected. If you see a server's status is "Idle" or "0 client(s)", you can connect to it. If you see "1 client(s)" or "2 client(s)" etc., you are sharing a connection to the same server. The first client is the master who has control over the vfo and Tx etc., and you will be connecting as a slave. You will only be able to listen to the audio and see the spectrum passively as an observer. When the clients before you disconnect, you will automatically become the master. This is a queuing mechanism.

''Configure > Audio''

If you are connecting to a public server on the Internet (ie not your own server on your LAN), '''please''' set Audio to 8000, aLaw, and 1 channel. If you use other settings, your QtRadio and/or the dspserver/server will hang.

=== Audio ===

=== Band ===
====Keypad====
Clicking on the keypad brings up a key entry window. The frequency must be entered by clicking on the number pads and should be in the form MHz dot KHz i.e. 14.293 Entering in KHz will cause an error which is not trapped yet.
====Band Selection====
The band menu allows selection of a band by clicking on the desired entry. Clicks on an already selected entry steps to the next memory position and sets the stored frequency, mode, filter and spectrum/waterfall settings.
The status line on the bottom right hand side of the window will display ... Band, Memory position, Mode, Filter and whether using memory or vfo.
====XVTR====
To Come

=== Mode ===
=== Filter ===
=== Noise Reduction ===
=== AGC ===
=== Spectrum ===
=== Hardware ===
=== Bookmarks ===
Bookmarks are for storing semi permanent frequencies like favourite radio station or weekly sked etc.
====Saving a bookmark====
Tune to the frequency to be stored and set up mode, filter and spectra.
From the main menu choose Bookmarks/Bookmark this frequency and an entry panel will appear
The Title may be edited from simply the frequency to say "3.61 Weekly fists net"
Choose "OK" to store.
====Retrieving a bookmark====
From the main menu choose Bookmarks/View Bookmarks.
Run the mouse cursor up and down the list of stored frequencies and click to choose
====Editing a bookmark====
This facility allows editing of the title or deletion of an entry.
<pre>
* From the main menu choose Bookmarks/Edit Bookmarks.
* From the left hand panel click on the item to be edited.
* Either edit the title and click on update,
or click on delete.
</pre>
'''Note:''' only the title is editable and if other data is needed to be changed it will be necessary to delete the entry and start again.

== Transmit commands ==

== Keyboard Shortcuts ==
* Arrow Left/Right Tune Down/Up the active VFO
* Arrow Up/Down Increase /Decrease Step Size above
* lowercase a = VFOA
* lowercase b = VFOB
* lowercase c = Connect
* lowercase d = Disconnect
* lowercase k= Bring up Keypad entry window
* lowercase l = Bring up Quick Connect Window
* lowercase s = toggle SubRX

== Using the Griffin Powermate USB Dial as VFO Knob ==
=== The Griffin Powermate USB DIal ===
[[File:powermate_.png|200px]]

The Griffin Powermate has a single wheel and a pushbutton, which is
able to do the following actions:

<pre>
1. Rotate Clockwise
2. Rotate Counterclockwise
3. Push Down and Rotate Clockwise
4. Push Down and Rotate Counterclockwise
5. Push Down
6. Long Push Down
7. Responisve Blue LED's
</pre>

So we have 6 possibilities to map to keystrokes, soundcard levels and so on.

In Windows you may refer to the following Document published by FlexRadio. Install the Powermate Software for Windows and map your wanted keys.

http://support.flexradio.com/Downloads.aspx?id=47

=== Download Gizmod ===

In Linux there is Gizmo Daemon - THE Linux Linux Input Device Utility.

'''You need at least Ubuntu 11.10 installed'''

Unfortunately Gizmo is no longer supported by Ubuntu and most other Linux Distributions. The last update on the Gizmo page was in 2009.

So the following Setup is experimental until we may have support for the Powermate in QtRadio or Hamlib directly.

1. Go to your preferred local git directory.
<pre>
$ git clone git://github.com/jtriley/gizmod.git
</pre>

<pre>
$ cd gizmod
</pre>

Make the following two patches:

<pre>
index 14b8d37..b61e2a1 100644
--- a/libH/Average.hpp
+++ b/libH/Average.hpp
@@ -35,6 +35,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

You may apply the above patch manually by:
<pre>
$ gedit libH/Average.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

Do the same with the following patch:

<pre>
index d794055..75f4c27 100644
--- a/libH/DynamicBuffer.hpp
+++ b/libH/DynamicBuffer.hpp
@@ -33,6 +33,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

<pre>
gedit libHDynamicBuffer.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

<pre>
$ gedit cpuusage.cpp
</pre>

add

<pre>
#include <cstring>
</pre>

<pre>
$ sudo apt-get install libboost-all-dev
$ sudo apt-get install libboost-filesystem1.46.1
$ sudo apt-get install libboost-filesystem1.46-dev
</pre>

<pre>
$ mkdir build
$ cd build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr -DSYSCONF_INSTALL_DIR=/etc ../
$ make
</pre>

If you still get an error do:

<pre>
$ gedit gizmod/CMakeFiles/gizmod.dir/link.txt
</pre>

and add:

<pre>
-lboost_system
</pre>

<pre>
$ make
$ sudo make install
</pre>

=== Setup Gizmod ===

Go to your user directory and do:
<pre>
$ mkdir -p .gizmod
</pre>

<pre>
$ cp /usr/etc/gizmod * .gizmod
</pre>

<pre>
$ mkdir .gizmod/modules.d
</pre>

<pre>
$ cp /usr/etc/gizmod/modules.d/000-CatchAllDebug.py .gizmod/modules.d/
$ cp /usr/etc/gizmod/modules.d/299-Powermate-Default.py .gizmod/modules.d/
</pre>

<pre>
$ cd .gizmod/modules.d
</pre>

<pre>
$ gedit 299-Powermate-Default.py
</pre>

Edit 299-Powermate-Default.py like this (Do not change the Filename and edit exactly)

<pre>
#***
#*********************************************************************
#*************************************************************************
#***
#*** GizmoDaemon Config Script
#*** Powermate Default config
#***
#*****************************************
#*****************************************
#***

"""

Copyright (c) 2007, Gizmo Daemon Team
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

"""

############################
# Imports
##########################

from GizmoDaemon import *
from GizmoScriptDefault import *
import time

ENABLED = True
VERSION_NEEDED = 3.2
INTERESTED_CLASSES = [GizmoEventClass.Powermate]

############################
# PowermateDefault Class definition
##########################

class PowermateDefault(GizmoScriptDefault):
"""
Default Powermate Event Mapping
"""

############################
# Public Functions
##########################

def onDeviceEvent(self, Event, Gizmo = None):
"""
Called from Base Class' onEvent method.
See GizmodDispatcher.onEvent documention for an explanation of this function
"""

# Check for rotations
if Event.Type == GizmoEventType.EV_REL:
if Gizmo.getKeyState(GizmoKey.BTN_0):
if Gizmod.DefaultMixerVolume:
Gizmod.DefaultMixerVolume.VolumePlayback = Gizmod.DefaultMixerVolume.VolumePlayback + Event.Value
else:
# scroll quickly (by pages using the page up / page down keys)
if Event.Value < 0:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_RIGHT)
else:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_LEFT)
return True
elif Event.Type == GizmoEventType.EV_KEY:
if Event.Value == 0 and not Gizmo.Rotated:
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_PLUS)
return True
return False

############################
# Private Functions
##########################

def __init__(self):
"""
Default Constructor
"""

GizmoScriptDefault.__init__(self, ENABLED, VERSION_NEEDED, INTERESTED_CLASSES)

############################
# PowermateDefault class end
##########################

# register the user script
PowermateDefault()
</pre>

<pre>
$ gizmod
</pre>

you should see the following output:(depends on your system)

<pre>
GizmoDaemon v3.4 -=- (c) 2007, Tim Burrell <tim.burrell@gmail.com>
=---------=

Registering Devices:

Standard - Directory [input]
Standard - Sleep Button [event0] vId: 0x0 pId: 0x3
Standard - Lid Switch [event1] vId: 0x0 pId: 0x5
Standard - HDA Intel Mic [event10] vId: 0x0 pId: 0x0
Standard - HDA Intel Mic [event11] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event12] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event13] vId: 0x0 pId: 0x0
Standard - Power Button [event2] vId: 0x0 pId: 0x1
Keyboard - AT Translated Set 2 keyboard [event3] vId: 0x1 pId: 0x1
Standard - Asus Laptop extra buttons [event4] vId: 0x0 pId: 0x0
Powermate - Griffin PowerMate [event5] vId: 0x77d pId: 0x410
Standard - CNF7237&CNF7238 [event6] vId: 0x17ef pId: 0x4808
Mouse - SynPS/2 Synaptics TouchPad [event7] vId: 0x2 pId: 0x7
Standard - Video Bus [event8] vId: 0x0 pId: 0x6
Standard - HDA Intel HDMI/DP,pcm=3 [event9] vId: 0x0 pId: 0x0

Loading User Scripts:

CatchAllDebug - CatchAll Event Mapping for Testing
PowermateDefault - Default Powermate Event Mapping
</pre>

You should have the following functions:

<pre>
turn left = KEY RIGHT
turn right = KEY LEFT
press and turn left = System Volume down
press and turn right = System Volume up
Buttonpress = cycle through Step Size
</pre>

QtRadio - Operation

2011-12-01T22:42:32Z

Zl2apv: /* Editing a bookmark */

=== Connecting to a server ===

== Tuning the radio ==
=== Fixed frequency radio ===
For crystal locked radios such as the softrock lite II or YU1LM sdr's It is necessary to use [[#Using subRx | subRx]]. The procedure is to set vfoA to your centre frequency, usually the crystal frequency / 4 and leave it alone as changing it will affect your centre frequency. Using the button on the vfo panel or the 'Receiver' Menu / subRx choice switch on the subRx. You can now tune within the limits of the sample rate of your sound card (48, 96 or 192 KHz).

Note that you need to start dspserver with LO offset of zero:

$ dspserver --lo 0

=== si570 tunable radio ===

In the Softrock series of hardware using sound cards, there is frequently a noise band near DC (offset 0). As such most users will set an offset of 9000 Hz (or 12000Hz etc.) using programs such as PSDR-IQ. You do the same when starting dspserver:

$ dspserver --lo 9000

=== Direct Down Conversion (DDC) radio ===

Such radios (eg. Perseus, HPSDR, usrp) do not need the offset. So start dspserver with:

$ dspserver --lo 0

== Setting the noise floor ==
The height of the spectrum from the baseline is adjusted by rolling the mouse wheel with the pointer over the level calibration markings on the extreme left hand side of the spectrum window. This will at the same time change the base colour of the waterfall.

The procedure is: After setting the [[#Calibrating the S meter | sound-card gain]] you should remove the antenna and roll the mouse-wheel to give a spectrum display line just above the bottom of the window. When you apply the antenna the spectrum will rise in the window and the waterfall base colour should be dark blue unless the band is particularly noisy.

== Calibrating the S meter ==
To calibrate the S Meter, a signal equal to S9 (-73 dBm) is injected into the sdr and the soundcard gain is adjusted until the S meter reads S9. It will then probably be necessary to adjust the spectrum [[#Setting the noise floor | noise floor]] level.

A subjective calibration may be performed by tuning into a signal considered S9 and performing the above procedure.

== VFO and Split selection ==

== Using RIT ==

== Changing bands ==

== Using Quick Memories ==
===Overview===
The quick memories are used in conjunction with the VFO memory to give quick access to storing and retrieving memories which will be used on a temporary basis. Each selected quick memory is transferred to the vfo memory and if any tune operation is made the operation shifts to the vfo and the displayed frequency of course is the operational frequency. Data held in memory or vfo is stored in the config file and is available through sessions with the last used frequency being the next start frequency. Long term memory storage should be made via the [[#Bookmarks | Bookmarks]] facility.

===VFO memory===
The vfo has a memory associated with it for each band and allows startup of QtRadio to retrieve last frequency, mode, filter and spectrum/waterfall settings used. Shifting to another band allows the last used frequency etc. for that band to be retrieved and of course a return to the original band will get back the original data.
===Storing===
Storing a quick memory is accomplished by right clicking over any of the band buttons. The software will work out the right button for the frequency and store it there. The storage button will light up yellow for 1/2 second and the status bar will show ... the current band, the current read memory position and current store memory position, Mode, Filter and "stored at" store memory number. If the current frequency, mode and filter is already stored in quick memory, the memory will become the current memory and no extra storage will take place. Storage is always made to overwrite the oldest stored memory position so if your memories are stored as 0,1,2 for 3 quick memories and memory 2 was the last stored location, then memory 0 would be would be the next storage location. The index to the current memory storage location is saved on shutdown.
===Reading from Band Buttons===
A left click on the band button will cycle through the stored memories without ever overwriting them. The data in the selected memory is copied to the vfo memory and any change to the vfo is not written to memory unless explicitly via a right click over the bandbutton area. Full current information is retrieved from the memory and consists of Frequency, Mode, Filter, Spectrum info and Waterfall info. The index to the current memory read location is saved on shutdown. The status bar is updated to reflect the memory read/write information and a message is displayed advising you the vfo is currently matching a retrieved memory.
===Reading from Band menu===
Please refer to main menu section [[#Band Selection | Band]]

== Using subRx ==
To be constructed

== The Menu choices ==

=== Receiver ===
''Connect/Disconnect''

You can connect to a server either by selecting the server in the Configure > Server list and then click Connect, or by selecting the server in the Quick Server List and click connect.

After you Disconnect from a server, you must wait at least 10 seconds for the disconnection to take full effect before connecting to another server. This is to allow the internet connection to really disconnect (remember there is network latency and the server will continue to send data till its buffers are emptied). Failure to do so will often result in error in QtRadio and may even hang QtRadio.

''Quick Server List''

If you see that a public server's status is "Busy", please '''do not''' connect to it. Doing so will disrupt the user already connected. If you see a server's status is "Idle" or "0 client(s)", you can connect to it. If you see "1 client(s)" or "2 client(s)" etc., you are sharing a connection to the same server. The first client is the master who has control over the vfo and Tx etc., and you will be connecting as a slave. You will only be able to listen to the audio and see the spectrum passively as an observer. When the clients before you disconnect, you will automatically become the master. This is a queuing mechanism.

''Configure > Audio''

If you are connecting to a public server on the Internet (ie not your own server on your LAN), '''please''' set Audio to 8000, aLaw, and 1 channel. If you use other settings, your QtRadio and/or the dspserver/server will hang.

=== Audio ===

=== Band ===
====Keypad====
Clicking on the keypad brings up a key entry window. The frequency must be entered by clicking on the number pads and should be in the form MHz dot KHz i.e. 14.293 Entering in KHz will cause an error which is not trapped yet.
====Band Selection====
The band menu allows selection of a band by clicking on the desired entry. Clicks on an already selected entry steps to the next memory position and sets the stored frequency, mode, filter and spectrum/waterfall settings.
The status line on the bottom right hand side of the window will display ... Band, Memory position, Mode, Filter and whether using memory or vfo.
====XVTR====
To Come

=== Mode ===
=== Filter ===
=== Noise Reduction ===
=== AGC ===
=== Spectrum ===
=== Hardware ===
=== Bookmarks ===
Bookmarks are for storing semi permanent frequencies like favourite radio station or weekly sked etc.
====Saving a bookmark====
Tune to the frequency to be stored and set up mode, filter and spectra.
From the main menu choose Bookmarks/Bookmark this frequency and an entry panel will appear
The Title may be edited from simply the frequency to say "3.61 Weekly fists net"
Choose "OK" to store.
====Retrieving a bookmark====
From the main menu choose Bookmarks/View Bookmarks.
Run the mouse cursor up and down the list of stored frequencies and click to choose
====Editing a bookmark====
This facility allows editing of the title or deletion of an entry.
<pre>
1 From the main menu choose Bookmarks/Edit Bookmarks.

2 From the left hand panel click on the item to be edited.

3 Either edit the title and click on update,

or click on delete.
</pre>
'''Note:''' only the title is editable and if other data is needed to be changed it will be necessary to delete the entry and start again.

== Transmit commands ==

== Keyboard Shortcuts ==
* Arrow Left/Right Tune Down/Up the active VFO
* Arrow Up/Down Increase /Decrease Step Size above
* lowercase a = VFOA
* lowercase b = VFOB
* lowercase c = Connect
* lowercase d = Disconnect
* lowercase k= Bring up Keypad entry window
* lowercase l = Bring up Quick Connect Window
* lowercase s = toggle SubRX

== Using the Griffin Powermate USB Dial as VFO Knob ==
=== The Griffin Powermate USB DIal ===
[[File:powermate_.png|200px]]

The Griffin Powermate has a single wheel and a pushbutton, which is
able to do the following actions:

<pre>
1. Rotate Clockwise
2. Rotate Counterclockwise
3. Push Down and Rotate Clockwise
4. Push Down and Rotate Counterclockwise
5. Push Down
6. Long Push Down
7. Responisve Blue LED's
</pre>

So we have 6 possibilities to map to keystrokes, soundcard levels and so on.

In Windows you may refer to the following Document published by FlexRadio. Install the Powermate Software for Windows and map your wanted keys.

http://support.flexradio.com/Downloads.aspx?id=47

=== Download Gizmod ===

In Linux there is Gizmo Daemon - THE Linux Linux Input Device Utility.

'''You need at least Ubuntu 11.10 installed'''

Unfortunately Gizmo is no longer supported by Ubuntu and most other Linux Distributions. The last update on the Gizmo page was in 2009.

So the following Setup is experimental until we may have support for the Powermate in QtRadio or Hamlib directly.

1. Go to your preferred local git directory.
<pre>
$ git clone git://github.com/jtriley/gizmod.git
</pre>

<pre>
$ cd gizmod
</pre>

Make the following two patches:

<pre>
index 14b8d37..b61e2a1 100644
--- a/libH/Average.hpp
+++ b/libH/Average.hpp
@@ -35,6 +35,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

You may apply the above patch manually by:
<pre>
$ gedit libH/Average.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

Do the same with the following patch:

<pre>
index d794055..75f4c27 100644
--- a/libH/DynamicBuffer.hpp
+++ b/libH/DynamicBuffer.hpp
@@ -33,6 +33,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

<pre>
gedit libHDynamicBuffer.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

<pre>
$ gedit cpuusage.cpp
</pre>

add

<pre>
#include <cstring>
</pre>

<pre>
$ sudo apt-get install libboost-all-dev
$ sudo apt-get install libboost-filesystem1.46.1
$ sudo apt-get install libboost-filesystem1.46-dev
</pre>

<pre>
$ mkdir build
$ cd build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr -DSYSCONF_INSTALL_DIR=/etc ../
$ make
</pre>

If you still get an error do:

<pre>
$ gedit gizmod/CMakeFiles/gizmod.dir/link.txt
</pre>

and add:

<pre>
-lboost_system
</pre>

<pre>
$ make
$ sudo make install
</pre>

=== Setup Gizmod ===

Go to your user directory and do:
<pre>
$ mkdir -p .gizmod
</pre>

<pre>
$ cp /usr/etc/gizmod * .gizmod
</pre>

<pre>
$ mkdir .gizmod/modules.d
</pre>

<pre>
$ cp /usr/etc/gizmod/modules.d/000-CatchAllDebug.py .gizmod/modules.d/
$ cp /usr/etc/gizmod/modules.d/299-Powermate-Default.py .gizmod/modules.d/
</pre>

<pre>
$ cd .gizmod/modules.d
</pre>

<pre>
$ gedit 299-Powermate-Default.py
</pre>

Edit 299-Powermate-Default.py like this (Do not change the Filename and edit exactly)

<pre>
#***
#*********************************************************************
#*************************************************************************
#***
#*** GizmoDaemon Config Script
#*** Powermate Default config
#***
#*****************************************
#*****************************************
#***

"""

Copyright (c) 2007, Gizmo Daemon Team
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

"""

############################
# Imports
##########################

from GizmoDaemon import *
from GizmoScriptDefault import *
import time

ENABLED = True
VERSION_NEEDED = 3.2
INTERESTED_CLASSES = [GizmoEventClass.Powermate]

############################
# PowermateDefault Class definition
##########################

class PowermateDefault(GizmoScriptDefault):
"""
Default Powermate Event Mapping
"""

############################
# Public Functions
##########################

def onDeviceEvent(self, Event, Gizmo = None):
"""
Called from Base Class' onEvent method.
See GizmodDispatcher.onEvent documention for an explanation of this function
"""

# Check for rotations
if Event.Type == GizmoEventType.EV_REL:
if Gizmo.getKeyState(GizmoKey.BTN_0):
if Gizmod.DefaultMixerVolume:
Gizmod.DefaultMixerVolume.VolumePlayback = Gizmod.DefaultMixerVolume.VolumePlayback + Event.Value
else:
# scroll quickly (by pages using the page up / page down keys)
if Event.Value < 0:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_RIGHT)
else:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_LEFT)
return True
elif Event.Type == GizmoEventType.EV_KEY:
if Event.Value == 0 and not Gizmo.Rotated:
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_PLUS)
return True
return False

############################
# Private Functions
##########################

def __init__(self):
"""
Default Constructor
"""

GizmoScriptDefault.__init__(self, ENABLED, VERSION_NEEDED, INTERESTED_CLASSES)

############################
# PowermateDefault class end
##########################

# register the user script
PowermateDefault()
</pre>

<pre>
$ gizmod
</pre>

you should see the following output:(depends on your system)

<pre>
GizmoDaemon v3.4 -=- (c) 2007, Tim Burrell <tim.burrell@gmail.com>
=---------=

Registering Devices:

Standard - Directory [input]
Standard - Sleep Button [event0] vId: 0x0 pId: 0x3
Standard - Lid Switch [event1] vId: 0x0 pId: 0x5
Standard - HDA Intel Mic [event10] vId: 0x0 pId: 0x0
Standard - HDA Intel Mic [event11] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event12] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event13] vId: 0x0 pId: 0x0
Standard - Power Button [event2] vId: 0x0 pId: 0x1
Keyboard - AT Translated Set 2 keyboard [event3] vId: 0x1 pId: 0x1
Standard - Asus Laptop extra buttons [event4] vId: 0x0 pId: 0x0
Powermate - Griffin PowerMate [event5] vId: 0x77d pId: 0x410
Standard - CNF7237&CNF7238 [event6] vId: 0x17ef pId: 0x4808
Mouse - SynPS/2 Synaptics TouchPad [event7] vId: 0x2 pId: 0x7
Standard - Video Bus [event8] vId: 0x0 pId: 0x6
Standard - HDA Intel HDMI/DP,pcm=3 [event9] vId: 0x0 pId: 0x0

Loading User Scripts:

CatchAllDebug - CatchAll Event Mapping for Testing
PowermateDefault - Default Powermate Event Mapping
</pre>

You should have the following functions:

<pre>
turn left = KEY RIGHT
turn right = KEY LEFT
press and turn left = System Volume down
press and turn right = System Volume up
Buttonpress = cycle through Step Size
</pre>

QtRadio - Operation

2011-12-01T22:39:27Z

Zl2apv: /* Editing a bookmark */

=== Connecting to a server ===

== Tuning the radio ==
=== Fixed frequency radio ===
For crystal locked radios such as the softrock lite II or YU1LM sdr's It is necessary to use [[#Using subRx | subRx]]. The procedure is to set vfoA to your centre frequency, usually the crystal frequency / 4 and leave it alone as changing it will affect your centre frequency. Using the button on the vfo panel or the 'Receiver' Menu / subRx choice switch on the subRx. You can now tune within the limits of the sample rate of your sound card (48, 96 or 192 KHz).

Note that you need to start dspserver with LO offset of zero:

$ dspserver --lo 0

=== si570 tunable radio ===

In the Softrock series of hardware using sound cards, there is frequently a noise band near DC (offset 0). As such most users will set an offset of 9000 Hz (or 12000Hz etc.) using programs such as PSDR-IQ. You do the same when starting dspserver:

$ dspserver --lo 9000

=== Direct Down Conversion (DDC) radio ===

Such radios (eg. Perseus, HPSDR, usrp) do not need the offset. So start dspserver with:

$ dspserver --lo 0

== Setting the noise floor ==
The height of the spectrum from the baseline is adjusted by rolling the mouse wheel with the pointer over the level calibration markings on the extreme left hand side of the spectrum window. This will at the same time change the base colour of the waterfall.

The procedure is: After setting the [[#Calibrating the S meter | sound-card gain]] you should remove the antenna and roll the mouse-wheel to give a spectrum display line just above the bottom of the window. When you apply the antenna the spectrum will rise in the window and the waterfall base colour should be dark blue unless the band is particularly noisy.

== Calibrating the S meter ==
To calibrate the S Meter, a signal equal to S9 (-73 dBm) is injected into the sdr and the soundcard gain is adjusted until the S meter reads S9. It will then probably be necessary to adjust the spectrum [[#Setting the noise floor | noise floor]] level.

A subjective calibration may be performed by tuning into a signal considered S9 and performing the above procedure.

== VFO and Split selection ==

== Using RIT ==

== Changing bands ==

== Using Quick Memories ==
===Overview===
The quick memories are used in conjunction with the VFO memory to give quick access to storing and retrieving memories which will be used on a temporary basis. Each selected quick memory is transferred to the vfo memory and if any tune operation is made the operation shifts to the vfo and the displayed frequency of course is the operational frequency. Data held in memory or vfo is stored in the config file and is available through sessions with the last used frequency being the next start frequency. Long term memory storage should be made via the [[#Bookmarks | Bookmarks]] facility.

===VFO memory===
The vfo has a memory associated with it for each band and allows startup of QtRadio to retrieve last frequency, mode, filter and spectrum/waterfall settings used. Shifting to another band allows the last used frequency etc. for that band to be retrieved and of course a return to the original band will get back the original data.
===Storing===
Storing a quick memory is accomplished by right clicking over any of the band buttons. The software will work out the right button for the frequency and store it there. The storage button will light up yellow for 1/2 second and the status bar will show ... the current band, the current read memory position and current store memory position, Mode, Filter and "stored at" store memory number. If the current frequency, mode and filter is already stored in quick memory, the memory will become the current memory and no extra storage will take place. Storage is always made to overwrite the oldest stored memory position so if your memories are stored as 0,1,2 for 3 quick memories and memory 2 was the last stored location, then memory 0 would be would be the next storage location. The index to the current memory storage location is saved on shutdown.
===Reading from Band Buttons===
A left click on the band button will cycle through the stored memories without ever overwriting them. The data in the selected memory is copied to the vfo memory and any change to the vfo is not written to memory unless explicitly via a right click over the bandbutton area. Full current information is retrieved from the memory and consists of Frequency, Mode, Filter, Spectrum info and Waterfall info. The index to the current memory read location is saved on shutdown. The status bar is updated to reflect the memory read/write information and a message is displayed advising you the vfo is currently matching a retrieved memory.
===Reading from Band menu===
Please refer to main menu section [[#Band Selection | Band]]

== Using subRx ==
To be constructed

== The Menu choices ==

=== Receiver ===
''Connect/Disconnect''

You can connect to a server either by selecting the server in the Configure > Server list and then click Connect, or by selecting the server in the Quick Server List and click connect.

After you Disconnect from a server, you must wait at least 10 seconds for the disconnection to take full effect before connecting to another server. This is to allow the internet connection to really disconnect (remember there is network latency and the server will continue to send data till its buffers are emptied). Failure to do so will often result in error in QtRadio and may even hang QtRadio.

''Quick Server List''

If you see that a public server's status is "Busy", please '''do not''' connect to it. Doing so will disrupt the user already connected. If you see a server's status is "Idle" or "0 client(s)", you can connect to it. If you see "1 client(s)" or "2 client(s)" etc., you are sharing a connection to the same server. The first client is the master who has control over the vfo and Tx etc., and you will be connecting as a slave. You will only be able to listen to the audio and see the spectrum passively as an observer. When the clients before you disconnect, you will automatically become the master. This is a queuing mechanism.

''Configure > Audio''

If you are connecting to a public server on the Internet (ie not your own server on your LAN), '''please''' set Audio to 8000, aLaw, and 1 channel. If you use other settings, your QtRadio and/or the dspserver/server will hang.

=== Audio ===

=== Band ===
====Keypad====
Clicking on the keypad brings up a key entry window. The frequency must be entered by clicking on the number pads and should be in the form MHz dot KHz i.e. 14.293 Entering in KHz will cause an error which is not trapped yet.
====Band Selection====
The band menu allows selection of a band by clicking on the desired entry. Clicks on an already selected entry steps to the next memory position and sets the stored frequency, mode, filter and spectrum/waterfall settings.
The status line on the bottom right hand side of the window will display ... Band, Memory position, Mode, Filter and whether using memory or vfo.
====XVTR====
To Come

=== Mode ===
=== Filter ===
=== Noise Reduction ===
=== AGC ===
=== Spectrum ===
=== Hardware ===
=== Bookmarks ===
Bookmarks are for storing semi permanent frequencies like favourite radio station or weekly sked etc.
====Saving a bookmark====
Tune to the frequency to be stored and set up mode, filter and spectra.
From the main menu choose Bookmarks/Bookmark this frequency and an entry panel will appear
The Title may be edited from simply the frequency to say "3.61 Weekly fists net"
Choose "OK" to store.
====Retrieving a bookmark====
From the main menu choose Bookmarks/View Bookmarks.
Run the mouse cursor up and down the list of stored frequencies and click to choose
====Editing a bookmark====
This facility allows editing of the title or deletion of an entry.

From the main menu choose Bookmarks/Edit Bookmarks.

From the left hand panel click on the item to be edited.

either edit the title and click on update,

or click on delete.

'''Note:''' only the title is editable and if other data is needed to be changed it will be necessary to delete the entry and start again.

== Transmit commands ==

== Keyboard Shortcuts ==
* Arrow Left/Right Tune Down/Up the active VFO
* Arrow Up/Down Increase /Decrease Step Size above
* lowercase a = VFOA
* lowercase b = VFOB
* lowercase c = Connect
* lowercase d = Disconnect
* lowercase k= Bring up Keypad entry window
* lowercase l = Bring up Quick Connect Window
* lowercase s = toggle SubRX

== Using the Griffin Powermate USB Dial as VFO Knob ==
=== The Griffin Powermate USB DIal ===
[[File:powermate_.png|200px]]

The Griffin Powermate has a single wheel and a pushbutton, which is
able to do the following actions:

<pre>
1. Rotate Clockwise
2. Rotate Counterclockwise
3. Push Down and Rotate Clockwise
4. Push Down and Rotate Counterclockwise
5. Push Down
6. Long Push Down
7. Responisve Blue LED's
</pre>

So we have 6 possibilities to map to keystrokes, soundcard levels and so on.

In Windows you may refer to the following Document published by FlexRadio. Install the Powermate Software for Windows and map your wanted keys.

http://support.flexradio.com/Downloads.aspx?id=47

=== Download Gizmod ===

In Linux there is Gizmo Daemon - THE Linux Linux Input Device Utility.

'''You need at least Ubuntu 11.10 installed'''

Unfortunately Gizmo is no longer supported by Ubuntu and most other Linux Distributions. The last update on the Gizmo page was in 2009.

So the following Setup is experimental until we may have support for the Powermate in QtRadio or Hamlib directly.

1. Go to your preferred local git directory.
<pre>
$ git clone git://github.com/jtriley/gizmod.git
</pre>

<pre>
$ cd gizmod
</pre>

Make the following two patches:

<pre>
index 14b8d37..b61e2a1 100644
--- a/libH/Average.hpp
+++ b/libH/Average.hpp
@@ -35,6 +35,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

You may apply the above patch manually by:
<pre>
$ gedit libH/Average.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

Do the same with the following patch:

<pre>
index d794055..75f4c27 100644
--- a/libH/DynamicBuffer.hpp
+++ b/libH/DynamicBuffer.hpp
@@ -33,6 +33,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

<pre>
gedit libHDynamicBuffer.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

<pre>
$ gedit cpuusage.cpp
</pre>

add

<pre>
#include <cstring>
</pre>

<pre>
$ sudo apt-get install libboost-all-dev
$ sudo apt-get install libboost-filesystem1.46.1
$ sudo apt-get install libboost-filesystem1.46-dev
</pre>

<pre>
$ mkdir build
$ cd build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr -DSYSCONF_INSTALL_DIR=/etc ../
$ make
</pre>

If you still get an error do:

<pre>
$ gedit gizmod/CMakeFiles/gizmod.dir/link.txt
</pre>

and add:

<pre>
-lboost_system
</pre>

<pre>
$ make
$ sudo make install
</pre>

=== Setup Gizmod ===

Go to your user directory and do:
<pre>
$ mkdir -p .gizmod
</pre>

<pre>
$ cp /usr/etc/gizmod * .gizmod
</pre>

<pre>
$ mkdir .gizmod/modules.d
</pre>

<pre>
$ cp /usr/etc/gizmod/modules.d/000-CatchAllDebug.py .gizmod/modules.d/
$ cp /usr/etc/gizmod/modules.d/299-Powermate-Default.py .gizmod/modules.d/
</pre>

<pre>
$ cd .gizmod/modules.d
</pre>

<pre>
$ gedit 299-Powermate-Default.py
</pre>

Edit 299-Powermate-Default.py like this (Do not change the Filename and edit exactly)

<pre>
#***
#*********************************************************************
#*************************************************************************
#***
#*** GizmoDaemon Config Script
#*** Powermate Default config
#***
#*****************************************
#*****************************************
#***

"""

Copyright (c) 2007, Gizmo Daemon Team
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

"""

############################
# Imports
##########################

from GizmoDaemon import *
from GizmoScriptDefault import *
import time

ENABLED = True
VERSION_NEEDED = 3.2
INTERESTED_CLASSES = [GizmoEventClass.Powermate]

############################
# PowermateDefault Class definition
##########################

class PowermateDefault(GizmoScriptDefault):
"""
Default Powermate Event Mapping
"""

############################
# Public Functions
##########################

def onDeviceEvent(self, Event, Gizmo = None):
"""
Called from Base Class' onEvent method.
See GizmodDispatcher.onEvent documention for an explanation of this function
"""

# Check for rotations
if Event.Type == GizmoEventType.EV_REL:
if Gizmo.getKeyState(GizmoKey.BTN_0):
if Gizmod.DefaultMixerVolume:
Gizmod.DefaultMixerVolume.VolumePlayback = Gizmod.DefaultMixerVolume.VolumePlayback + Event.Value
else:
# scroll quickly (by pages using the page up / page down keys)
if Event.Value < 0:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_RIGHT)
else:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_LEFT)
return True
elif Event.Type == GizmoEventType.EV_KEY:
if Event.Value == 0 and not Gizmo.Rotated:
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_PLUS)
return True
return False

############################
# Private Functions
##########################

def __init__(self):
"""
Default Constructor
"""

GizmoScriptDefault.__init__(self, ENABLED, VERSION_NEEDED, INTERESTED_CLASSES)

############################
# PowermateDefault class end
##########################

# register the user script
PowermateDefault()
</pre>

<pre>
$ gizmod
</pre>

you should see the following output:(depends on your system)

<pre>
GizmoDaemon v3.4 -=- (c) 2007, Tim Burrell <tim.burrell@gmail.com>
=---------=

Registering Devices:

Standard - Directory [input]
Standard - Sleep Button [event0] vId: 0x0 pId: 0x3
Standard - Lid Switch [event1] vId: 0x0 pId: 0x5
Standard - HDA Intel Mic [event10] vId: 0x0 pId: 0x0
Standard - HDA Intel Mic [event11] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event12] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event13] vId: 0x0 pId: 0x0
Standard - Power Button [event2] vId: 0x0 pId: 0x1
Keyboard - AT Translated Set 2 keyboard [event3] vId: 0x1 pId: 0x1
Standard - Asus Laptop extra buttons [event4] vId: 0x0 pId: 0x0
Powermate - Griffin PowerMate [event5] vId: 0x77d pId: 0x410
Standard - CNF7237&CNF7238 [event6] vId: 0x17ef pId: 0x4808
Mouse - SynPS/2 Synaptics TouchPad [event7] vId: 0x2 pId: 0x7
Standard - Video Bus [event8] vId: 0x0 pId: 0x6
Standard - HDA Intel HDMI/DP,pcm=3 [event9] vId: 0x0 pId: 0x0

Loading User Scripts:

CatchAllDebug - CatchAll Event Mapping for Testing
PowermateDefault - Default Powermate Event Mapping
</pre>

You should have the following functions:

<pre>
turn left = KEY RIGHT
turn right = KEY LEFT
press and turn left = System Volume down
press and turn right = System Volume up
Buttonpress = cycle through Step Size
</pre>

QtRadio - Operation

2011-12-01T22:38:09Z

Zl2apv: /* Bookmarks */

=== Connecting to a server ===

== Tuning the radio ==
=== Fixed frequency radio ===
For crystal locked radios such as the softrock lite II or YU1LM sdr's It is necessary to use [[#Using subRx | subRx]]. The procedure is to set vfoA to your centre frequency, usually the crystal frequency / 4 and leave it alone as changing it will affect your centre frequency. Using the button on the vfo panel or the 'Receiver' Menu / subRx choice switch on the subRx. You can now tune within the limits of the sample rate of your sound card (48, 96 or 192 KHz).

Note that you need to start dspserver with LO offset of zero:

$ dspserver --lo 0

=== si570 tunable radio ===

In the Softrock series of hardware using sound cards, there is frequently a noise band near DC (offset 0). As such most users will set an offset of 9000 Hz (or 12000Hz etc.) using programs such as PSDR-IQ. You do the same when starting dspserver:

$ dspserver --lo 9000

=== Direct Down Conversion (DDC) radio ===

Such radios (eg. Perseus, HPSDR, usrp) do not need the offset. So start dspserver with:

$ dspserver --lo 0

== Setting the noise floor ==
The height of the spectrum from the baseline is adjusted by rolling the mouse wheel with the pointer over the level calibration markings on the extreme left hand side of the spectrum window. This will at the same time change the base colour of the waterfall.

The procedure is: After setting the [[#Calibrating the S meter | sound-card gain]] you should remove the antenna and roll the mouse-wheel to give a spectrum display line just above the bottom of the window. When you apply the antenna the spectrum will rise in the window and the waterfall base colour should be dark blue unless the band is particularly noisy.

== Calibrating the S meter ==
To calibrate the S Meter, a signal equal to S9 (-73 dBm) is injected into the sdr and the soundcard gain is adjusted until the S meter reads S9. It will then probably be necessary to adjust the spectrum [[#Setting the noise floor | noise floor]] level.

A subjective calibration may be performed by tuning into a signal considered S9 and performing the above procedure.

== VFO and Split selection ==

== Using RIT ==

== Changing bands ==

== Using Quick Memories ==
===Overview===
The quick memories are used in conjunction with the VFO memory to give quick access to storing and retrieving memories which will be used on a temporary basis. Each selected quick memory is transferred to the vfo memory and if any tune operation is made the operation shifts to the vfo and the displayed frequency of course is the operational frequency. Data held in memory or vfo is stored in the config file and is available through sessions with the last used frequency being the next start frequency. Long term memory storage should be made via the [[#Bookmarks | Bookmarks]] facility.

===VFO memory===
The vfo has a memory associated with it for each band and allows startup of QtRadio to retrieve last frequency, mode, filter and spectrum/waterfall settings used. Shifting to another band allows the last used frequency etc. for that band to be retrieved and of course a return to the original band will get back the original data.
===Storing===
Storing a quick memory is accomplished by right clicking over any of the band buttons. The software will work out the right button for the frequency and store it there. The storage button will light up yellow for 1/2 second and the status bar will show ... the current band, the current read memory position and current store memory position, Mode, Filter and "stored at" store memory number. If the current frequency, mode and filter is already stored in quick memory, the memory will become the current memory and no extra storage will take place. Storage is always made to overwrite the oldest stored memory position so if your memories are stored as 0,1,2 for 3 quick memories and memory 2 was the last stored location, then memory 0 would be would be the next storage location. The index to the current memory storage location is saved on shutdown.
===Reading from Band Buttons===
A left click on the band button will cycle through the stored memories without ever overwriting them. The data in the selected memory is copied to the vfo memory and any change to the vfo is not written to memory unless explicitly via a right click over the bandbutton area. Full current information is retrieved from the memory and consists of Frequency, Mode, Filter, Spectrum info and Waterfall info. The index to the current memory read location is saved on shutdown. The status bar is updated to reflect the memory read/write information and a message is displayed advising you the vfo is currently matching a retrieved memory.
===Reading from Band menu===
Please refer to main menu section [[#Band Selection | Band]]

== Using subRx ==
To be constructed

== The Menu choices ==

=== Receiver ===
''Connect/Disconnect''

You can connect to a server either by selecting the server in the Configure > Server list and then click Connect, or by selecting the server in the Quick Server List and click connect.

After you Disconnect from a server, you must wait at least 10 seconds for the disconnection to take full effect before connecting to another server. This is to allow the internet connection to really disconnect (remember there is network latency and the server will continue to send data till its buffers are emptied). Failure to do so will often result in error in QtRadio and may even hang QtRadio.

''Quick Server List''

If you see that a public server's status is "Busy", please '''do not''' connect to it. Doing so will disrupt the user already connected. If you see a server's status is "Idle" or "0 client(s)", you can connect to it. If you see "1 client(s)" or "2 client(s)" etc., you are sharing a connection to the same server. The first client is the master who has control over the vfo and Tx etc., and you will be connecting as a slave. You will only be able to listen to the audio and see the spectrum passively as an observer. When the clients before you disconnect, you will automatically become the master. This is a queuing mechanism.

''Configure > Audio''

If you are connecting to a public server on the Internet (ie not your own server on your LAN), '''please''' set Audio to 8000, aLaw, and 1 channel. If you use other settings, your QtRadio and/or the dspserver/server will hang.

=== Audio ===

=== Band ===
====Keypad====
Clicking on the keypad brings up a key entry window. The frequency must be entered by clicking on the number pads and should be in the form MHz dot KHz i.e. 14.293 Entering in KHz will cause an error which is not trapped yet.
====Band Selection====
The band menu allows selection of a band by clicking on the desired entry. Clicks on an already selected entry steps to the next memory position and sets the stored frequency, mode, filter and spectrum/waterfall settings.
The status line on the bottom right hand side of the window will display ... Band, Memory position, Mode, Filter and whether using memory or vfo.
====XVTR====
To Come

=== Mode ===
=== Filter ===
=== Noise Reduction ===
=== AGC ===
=== Spectrum ===
=== Hardware ===
=== Bookmarks ===
Bookmarks are for storing semi permanent frequencies like favourite radio station or weekly sked etc.
====Saving a bookmark====
Tune to the frequency to be stored and set up mode, filter and spectra.
From the main menu choose Bookmarks/Bookmark this frequency and an entry panel will appear
The Title may be edited from simply the frequency to say "3.61 Weekly fists net"
Choose "OK" to store.
====Retrieving a bookmark====
From the main menu choose Bookmarks/View Bookmarks.
Run the mouse cursor up and down the list of stored frequencies and click to choose
====Editing a bookmark====
This facility allows editing of the title or deletion of an entry
From the main menu choose Bookmarks/Edit Bookmarks.
From the left hand panel click on the item to be edited.
either edit the title and click on update,
or click on delete.
'''Note:''' only the title is editable and if other data is needed to be changed it will be necessary to delete the entry and start again.

== Transmit commands ==

== Keyboard Shortcuts ==
* Arrow Left/Right Tune Down/Up the active VFO
* Arrow Up/Down Increase /Decrease Step Size above
* lowercase a = VFOA
* lowercase b = VFOB
* lowercase c = Connect
* lowercase d = Disconnect
* lowercase k= Bring up Keypad entry window
* lowercase l = Bring up Quick Connect Window
* lowercase s = toggle SubRX

== Using the Griffin Powermate USB Dial as VFO Knob ==
=== The Griffin Powermate USB DIal ===
[[File:powermate_.png|200px]]

The Griffin Powermate has a single wheel and a pushbutton, which is
able to do the following actions:

<pre>
1. Rotate Clockwise
2. Rotate Counterclockwise
3. Push Down and Rotate Clockwise
4. Push Down and Rotate Counterclockwise
5. Push Down
6. Long Push Down
7. Responisve Blue LED's
</pre>

So we have 6 possibilities to map to keystrokes, soundcard levels and so on.

In Windows you may refer to the following Document published by FlexRadio. Install the Powermate Software for Windows and map your wanted keys.

http://support.flexradio.com/Downloads.aspx?id=47

=== Download Gizmod ===

In Linux there is Gizmo Daemon - THE Linux Linux Input Device Utility.

'''You need at least Ubuntu 11.10 installed'''

Unfortunately Gizmo is no longer supported by Ubuntu and most other Linux Distributions. The last update on the Gizmo page was in 2009.

So the following Setup is experimental until we may have support for the Powermate in QtRadio or Hamlib directly.

1. Go to your preferred local git directory.
<pre>
$ git clone git://github.com/jtriley/gizmod.git
</pre>

<pre>
$ cd gizmod
</pre>

Make the following two patches:

<pre>
index 14b8d37..b61e2a1 100644
--- a/libH/Average.hpp
+++ b/libH/Average.hpp
@@ -35,6 +35,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

You may apply the above patch manually by:
<pre>
$ gedit libH/Average.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

Do the same with the following patch:

<pre>
index d794055..75f4c27 100644
--- a/libH/DynamicBuffer.hpp
+++ b/libH/DynamicBuffer.hpp
@@ -33,6 +33,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

<pre>
gedit libHDynamicBuffer.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

<pre>
$ gedit cpuusage.cpp
</pre>

add

<pre>
#include <cstring>
</pre>

<pre>
$ sudo apt-get install libboost-all-dev
$ sudo apt-get install libboost-filesystem1.46.1
$ sudo apt-get install libboost-filesystem1.46-dev
</pre>

<pre>
$ mkdir build
$ cd build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr -DSYSCONF_INSTALL_DIR=/etc ../
$ make
</pre>

If you still get an error do:

<pre>
$ gedit gizmod/CMakeFiles/gizmod.dir/link.txt
</pre>

and add:

<pre>
-lboost_system
</pre>

<pre>
$ make
$ sudo make install
</pre>

=== Setup Gizmod ===

Go to your user directory and do:
<pre>
$ mkdir -p .gizmod
</pre>

<pre>
$ cp /usr/etc/gizmod * .gizmod
</pre>

<pre>
$ mkdir .gizmod/modules.d
</pre>

<pre>
$ cp /usr/etc/gizmod/modules.d/000-CatchAllDebug.py .gizmod/modules.d/
$ cp /usr/etc/gizmod/modules.d/299-Powermate-Default.py .gizmod/modules.d/
</pre>

<pre>
$ cd .gizmod/modules.d
</pre>

<pre>
$ gedit 299-Powermate-Default.py
</pre>

Edit 299-Powermate-Default.py like this (Do not change the Filename and edit exactly)

<pre>
#***
#*********************************************************************
#*************************************************************************
#***
#*** GizmoDaemon Config Script
#*** Powermate Default config
#***
#*****************************************
#*****************************************
#***

"""

Copyright (c) 2007, Gizmo Daemon Team
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

"""

############################
# Imports
##########################

from GizmoDaemon import *
from GizmoScriptDefault import *
import time

ENABLED = True
VERSION_NEEDED = 3.2
INTERESTED_CLASSES = [GizmoEventClass.Powermate]

############################
# PowermateDefault Class definition
##########################

class PowermateDefault(GizmoScriptDefault):
"""
Default Powermate Event Mapping
"""

############################
# Public Functions
##########################

def onDeviceEvent(self, Event, Gizmo = None):
"""
Called from Base Class' onEvent method.
See GizmodDispatcher.onEvent documention for an explanation of this function
"""

# Check for rotations
if Event.Type == GizmoEventType.EV_REL:
if Gizmo.getKeyState(GizmoKey.BTN_0):
if Gizmod.DefaultMixerVolume:
Gizmod.DefaultMixerVolume.VolumePlayback = Gizmod.DefaultMixerVolume.VolumePlayback + Event.Value
else:
# scroll quickly (by pages using the page up / page down keys)
if Event.Value < 0:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_RIGHT)
else:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_LEFT)
return True
elif Event.Type == GizmoEventType.EV_KEY:
if Event.Value == 0 and not Gizmo.Rotated:
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_PLUS)
return True
return False

############################
# Private Functions
##########################

def __init__(self):
"""
Default Constructor
"""

GizmoScriptDefault.__init__(self, ENABLED, VERSION_NEEDED, INTERESTED_CLASSES)

############################
# PowermateDefault class end
##########################

# register the user script
PowermateDefault()
</pre>

<pre>
$ gizmod
</pre>

you should see the following output:(depends on your system)

<pre>
GizmoDaemon v3.4 -=- (c) 2007, Tim Burrell <tim.burrell@gmail.com>
=---------=

Registering Devices:

Standard - Directory [input]
Standard - Sleep Button [event0] vId: 0x0 pId: 0x3
Standard - Lid Switch [event1] vId: 0x0 pId: 0x5
Standard - HDA Intel Mic [event10] vId: 0x0 pId: 0x0
Standard - HDA Intel Mic [event11] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event12] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event13] vId: 0x0 pId: 0x0
Standard - Power Button [event2] vId: 0x0 pId: 0x1
Keyboard - AT Translated Set 2 keyboard [event3] vId: 0x1 pId: 0x1
Standard - Asus Laptop extra buttons [event4] vId: 0x0 pId: 0x0
Powermate - Griffin PowerMate [event5] vId: 0x77d pId: 0x410
Standard - CNF7237&CNF7238 [event6] vId: 0x17ef pId: 0x4808
Mouse - SynPS/2 Synaptics TouchPad [event7] vId: 0x2 pId: 0x7
Standard - Video Bus [event8] vId: 0x0 pId: 0x6
Standard - HDA Intel HDMI/DP,pcm=3 [event9] vId: 0x0 pId: 0x0

Loading User Scripts:

CatchAllDebug - CatchAll Event Mapping for Testing
PowermateDefault - Default Powermate Event Mapping
</pre>

You should have the following functions:

<pre>
turn left = KEY RIGHT
turn right = KEY LEFT
press and turn left = System Volume down
press and turn right = System Volume up
Buttonpress = cycle through Step Size
</pre>

QtRadio - Operation

2011-12-01T22:21:12Z

Zl2apv: /* Overview */

=== Connecting to a server ===

== Tuning the radio ==
=== Fixed frequency radio ===
For crystal locked radios such as the softrock lite II or YU1LM sdr's It is necessary to use [[#Using subRx | subRx]]. The procedure is to set vfoA to your centre frequency, usually the crystal frequency / 4 and leave it alone as changing it will affect your centre frequency. Using the button on the vfo panel or the 'Receiver' Menu / subRx choice switch on the subRx. You can now tune within the limits of the sample rate of your sound card (48, 96 or 192 KHz).

Note that you need to start dspserver with LO offset of zero:

$ dspserver --lo 0

=== si570 tunable radio ===

In the Softrock series of hardware using sound cards, there is frequently a noise band near DC (offset 0). As such most users will set an offset of 9000 Hz (or 12000Hz etc.) using programs such as PSDR-IQ. You do the same when starting dspserver:

$ dspserver --lo 9000

=== Direct Down Conversion (DDC) radio ===

Such radios (eg. Perseus, HPSDR, usrp) do not need the offset. So start dspserver with:

$ dspserver --lo 0

== Setting the noise floor ==
The height of the spectrum from the baseline is adjusted by rolling the mouse wheel with the pointer over the level calibration markings on the extreme left hand side of the spectrum window. This will at the same time change the base colour of the waterfall.

The procedure is: After setting the [[#Calibrating the S meter | sound-card gain]] you should remove the antenna and roll the mouse-wheel to give a spectrum display line just above the bottom of the window. When you apply the antenna the spectrum will rise in the window and the waterfall base colour should be dark blue unless the band is particularly noisy.

== Calibrating the S meter ==
To calibrate the S Meter, a signal equal to S9 (-73 dBm) is injected into the sdr and the soundcard gain is adjusted until the S meter reads S9. It will then probably be necessary to adjust the spectrum [[#Setting the noise floor | noise floor]] level.

A subjective calibration may be performed by tuning into a signal considered S9 and performing the above procedure.

== VFO and Split selection ==

== Using RIT ==

== Changing bands ==

== Using Quick Memories ==
===Overview===
The quick memories are used in conjunction with the VFO memory to give quick access to storing and retrieving memories which will be used on a temporary basis. Each selected quick memory is transferred to the vfo memory and if any tune operation is made the operation shifts to the vfo and the displayed frequency of course is the operational frequency. Data held in memory or vfo is stored in the config file and is available through sessions with the last used frequency being the next start frequency. Long term memory storage should be made via the [[#Bookmarks | Bookmarks]] facility.

===VFO memory===
The vfo has a memory associated with it for each band and allows startup of QtRadio to retrieve last frequency, mode, filter and spectrum/waterfall settings used. Shifting to another band allows the last used frequency etc. for that band to be retrieved and of course a return to the original band will get back the original data.
===Storing===
Storing a quick memory is accomplished by right clicking over any of the band buttons. The software will work out the right button for the frequency and store it there. The storage button will light up yellow for 1/2 second and the status bar will show ... the current band, the current read memory position and current store memory position, Mode, Filter and "stored at" store memory number. If the current frequency, mode and filter is already stored in quick memory, the memory will become the current memory and no extra storage will take place. Storage is always made to overwrite the oldest stored memory position so if your memories are stored as 0,1,2 for 3 quick memories and memory 2 was the last stored location, then memory 0 would be would be the next storage location. The index to the current memory storage location is saved on shutdown.
===Reading from Band Buttons===
A left click on the band button will cycle through the stored memories without ever overwriting them. The data in the selected memory is copied to the vfo memory and any change to the vfo is not written to memory unless explicitly via a right click over the bandbutton area. Full current information is retrieved from the memory and consists of Frequency, Mode, Filter, Spectrum info and Waterfall info. The index to the current memory read location is saved on shutdown. The status bar is updated to reflect the memory read/write information and a message is displayed advising you the vfo is currently matching a retrieved memory.
===Reading from Band menu===
Please refer to main menu section [[#Band Selection | Band]]

== Using subRx ==
To be constructed

== The Menu choices ==

=== Receiver ===
''Connect/Disconnect''

You can connect to a server either by selecting the server in the Configure > Server list and then click Connect, or by selecting the server in the Quick Server List and click connect.

After you Disconnect from a server, you must wait at least 10 seconds for the disconnection to take full effect before connecting to another server. This is to allow the internet connection to really disconnect (remember there is network latency and the server will continue to send data till its buffers are emptied). Failure to do so will often result in error in QtRadio and may even hang QtRadio.

''Quick Server List''

If you see that a public server's status is "Busy", please '''do not''' connect to it. Doing so will disrupt the user already connected. If you see a server's status is "Idle" or "0 client(s)", you can connect to it. If you see "1 client(s)" or "2 client(s)" etc., you are sharing a connection to the same server. The first client is the master who has control over the vfo and Tx etc., and you will be connecting as a slave. You will only be able to listen to the audio and see the spectrum passively as an observer. When the clients before you disconnect, you will automatically become the master. This is a queuing mechanism.

''Configure > Audio''

If you are connecting to a public server on the Internet (ie not your own server on your LAN), '''please''' set Audio to 8000, aLaw, and 1 channel. If you use other settings, your QtRadio and/or the dspserver/server will hang.

=== Audio ===

=== Band ===
====Keypad====
Clicking on the keypad brings up a key entry window. The frequency must be entered by clicking on the number pads and should be in the form MHz dot KHz i.e. 14.293 Entering in KHz will cause an error which is not trapped yet.
====Band Selection====
The band menu allows selection of a band by clicking on the desired entry. Clicks on an already selected entry steps to the next memory position and sets the stored frequency, mode, filter and spectrum/waterfall settings.
The status line on the bottom right hand side of the window will display ... Band, Memory position, Mode, Filter and whether using memory or vfo.
====XVTR====
To Come

=== Mode ===
=== Filter ===
=== Noise Reduction ===
=== AGC ===
=== Spectrum ===
=== Hardware ===
=== Bookmarks ===

== Transmit commands ==

== Keyboard Shortcuts ==
* Arrow Left/Right Tune Down/Up the active VFO
* Arrow Up/Down Increase /Decrease Step Size above
* lowercase a = VFOA
* lowercase b = VFOB
* lowercase c = Connect
* lowercase d = Disconnect
* lowercase k= Bring up Keypad entry window
* lowercase l = Bring up Quick Connect Window
* lowercase s = toggle SubRX

== Using the Griffin Powermate USB Dial as VFO Knob ==
=== The Griffin Powermate USB DIal ===
[[File:powermate_.png|200px]]

The Griffin Powermate has a single wheel and a pushbutton, which is
able to do the following actions:

<pre>
1. Rotate Clockwise
2. Rotate Counterclockwise
3. Push Down and Rotate Clockwise
4. Push Down and Rotate Counterclockwise
5. Push Down
6. Long Push Down
7. Responisve Blue LED's
</pre>

So we have 6 possibilities to map to keystrokes, soundcard levels and so on.

In Windows you may refer to the following Document published by FlexRadio. Install the Powermate Software for Windows and map your wanted keys.

http://support.flexradio.com/Downloads.aspx?id=47

=== Download Gizmod ===

In Linux there is Gizmo Daemon - THE Linux Linux Input Device Utility.

'''You need at least Ubuntu 11.10 installed'''

Unfortunately Gizmo is no longer supported by Ubuntu and most other Linux Distributions. The last update on the Gizmo page was in 2009.

So the following Setup is experimental until we may have support for the Powermate in QtRadio or Hamlib directly.

1. Go to your preferred local git directory.
<pre>
$ git clone git://github.com/jtriley/gizmod.git
</pre>

<pre>
$ cd gizmod
</pre>

Make the following two patches:

<pre>
index 14b8d37..b61e2a1 100644
--- a/libH/Average.hpp
+++ b/libH/Average.hpp
@@ -35,6 +35,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

You may apply the above patch manually by:
<pre>
$ gedit libH/Average.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

Do the same with the following patch:

<pre>
index d794055..75f4c27 100644
--- a/libH/DynamicBuffer.hpp
+++ b/libH/DynamicBuffer.hpp
@@ -33,6 +33,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

<pre>
gedit libHDynamicBuffer.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

<pre>
$ gedit cpuusage.cpp
</pre>

add

<pre>
#include <cstring>
</pre>

<pre>
$ sudo apt-get install libboost-all-dev
$ sudo apt-get install libboost-filesystem1.46.1
$ sudo apt-get install libboost-filesystem1.46-dev
</pre>

<pre>
$ mkdir build
$ cd build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr -DSYSCONF_INSTALL_DIR=/etc ../
$ make
</pre>

If you still get an error do:

<pre>
$ gedit gizmod/CMakeFiles/gizmod.dir/link.txt
</pre>

and add:

<pre>
-lboost_system
</pre>

<pre>
$ make
$ sudo make install
</pre>

=== Setup Gizmod ===

Go to your user directory and do:
<pre>
$ mkdir -p .gizmod
</pre>

<pre>
$ cp /usr/etc/gizmod * .gizmod
</pre>

<pre>
$ mkdir .gizmod/modules.d
</pre>

<pre>
$ cp /usr/etc/gizmod/modules.d/000-CatchAllDebug.py .gizmod/modules.d/
$ cp /usr/etc/gizmod/modules.d/299-Powermate-Default.py .gizmod/modules.d/
</pre>

<pre>
$ cd .gizmod/modules.d
</pre>

<pre>
$ gedit 299-Powermate-Default.py
</pre>

Edit 299-Powermate-Default.py like this (Do not change the Filename and edit exactly)

<pre>
#***
#*********************************************************************
#*************************************************************************
#***
#*** GizmoDaemon Config Script
#*** Powermate Default config
#***
#*****************************************
#*****************************************
#***

"""

Copyright (c) 2007, Gizmo Daemon Team
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

"""

############################
# Imports
##########################

from GizmoDaemon import *
from GizmoScriptDefault import *
import time

ENABLED = True
VERSION_NEEDED = 3.2
INTERESTED_CLASSES = [GizmoEventClass.Powermate]

############################
# PowermateDefault Class definition
##########################

class PowermateDefault(GizmoScriptDefault):
"""
Default Powermate Event Mapping
"""

############################
# Public Functions
##########################

def onDeviceEvent(self, Event, Gizmo = None):
"""
Called from Base Class' onEvent method.
See GizmodDispatcher.onEvent documention for an explanation of this function
"""

# Check for rotations
if Event.Type == GizmoEventType.EV_REL:
if Gizmo.getKeyState(GizmoKey.BTN_0):
if Gizmod.DefaultMixerVolume:
Gizmod.DefaultMixerVolume.VolumePlayback = Gizmod.DefaultMixerVolume.VolumePlayback + Event.Value
else:
# scroll quickly (by pages using the page up / page down keys)
if Event.Value < 0:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_RIGHT)
else:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_LEFT)
return True
elif Event.Type == GizmoEventType.EV_KEY:
if Event.Value == 0 and not Gizmo.Rotated:
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_PLUS)
return True
return False

############################
# Private Functions
##########################

def __init__(self):
"""
Default Constructor
"""

GizmoScriptDefault.__init__(self, ENABLED, VERSION_NEEDED, INTERESTED_CLASSES)

############################
# PowermateDefault class end
##########################

# register the user script
PowermateDefault()
</pre>

<pre>
$ gizmod
</pre>

you should see the following output:(depends on your system)

<pre>
GizmoDaemon v3.4 -=- (c) 2007, Tim Burrell <tim.burrell@gmail.com>
=---------=

Registering Devices:

Standard - Directory [input]
Standard - Sleep Button [event0] vId: 0x0 pId: 0x3
Standard - Lid Switch [event1] vId: 0x0 pId: 0x5
Standard - HDA Intel Mic [event10] vId: 0x0 pId: 0x0
Standard - HDA Intel Mic [event11] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event12] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event13] vId: 0x0 pId: 0x0
Standard - Power Button [event2] vId: 0x0 pId: 0x1
Keyboard - AT Translated Set 2 keyboard [event3] vId: 0x1 pId: 0x1
Standard - Asus Laptop extra buttons [event4] vId: 0x0 pId: 0x0
Powermate - Griffin PowerMate [event5] vId: 0x77d pId: 0x410
Standard - CNF7237&CNF7238 [event6] vId: 0x17ef pId: 0x4808
Mouse - SynPS/2 Synaptics TouchPad [event7] vId: 0x2 pId: 0x7
Standard - Video Bus [event8] vId: 0x0 pId: 0x6
Standard - HDA Intel HDMI/DP,pcm=3 [event9] vId: 0x0 pId: 0x0

Loading User Scripts:

CatchAllDebug - CatchAll Event Mapping for Testing
PowermateDefault - Default Powermate Event Mapping
</pre>

You should have the following functions:

<pre>
turn left = KEY RIGHT
turn right = KEY LEFT
press and turn left = System Volume down
press and turn right = System Volume up
Buttonpress = cycle through Step Size
</pre>

QtRadio - Operation

2011-12-01T22:19:52Z

Zl2apv: /* Reading from Band menu */

=== Connecting to a server ===

== Tuning the radio ==
=== Fixed frequency radio ===
For crystal locked radios such as the softrock lite II or YU1LM sdr's It is necessary to use [[#Using subRx | subRx]]. The procedure is to set vfoA to your centre frequency, usually the crystal frequency / 4 and leave it alone as changing it will affect your centre frequency. Using the button on the vfo panel or the 'Receiver' Menu / subRx choice switch on the subRx. You can now tune within the limits of the sample rate of your sound card (48, 96 or 192 KHz).

Note that you need to start dspserver with LO offset of zero:

$ dspserver --lo 0

=== si570 tunable radio ===

In the Softrock series of hardware using sound cards, there is frequently a noise band near DC (offset 0). As such most users will set an offset of 9000 Hz (or 12000Hz etc.) using programs such as PSDR-IQ. You do the same when starting dspserver:

$ dspserver --lo 9000

=== Direct Down Conversion (DDC) radio ===

Such radios (eg. Perseus, HPSDR, usrp) do not need the offset. So start dspserver with:

$ dspserver --lo 0

== Setting the noise floor ==
The height of the spectrum from the baseline is adjusted by rolling the mouse wheel with the pointer over the level calibration markings on the extreme left hand side of the spectrum window. This will at the same time change the base colour of the waterfall.

The procedure is: After setting the [[#Calibrating the S meter | sound-card gain]] you should remove the antenna and roll the mouse-wheel to give a spectrum display line just above the bottom of the window. When you apply the antenna the spectrum will rise in the window and the waterfall base colour should be dark blue unless the band is particularly noisy.

== Calibrating the S meter ==
To calibrate the S Meter, a signal equal to S9 (-73 dBm) is injected into the sdr and the soundcard gain is adjusted until the S meter reads S9. It will then probably be necessary to adjust the spectrum [[#Setting the noise floor | noise floor]] level.

A subjective calibration may be performed by tuning into a signal considered S9 and performing the above procedure.

== VFO and Split selection ==

== Using RIT ==

== Changing bands ==

== Using Quick Memories ==
===Overview===
The quick memories are used in conjunction with the VFO memory to give quick access to storing and retrieving memories which will be used on a temporary basis. Each selected quick memory is transferred to the vfo memory and if any tune operation is made the operation shifts to the vfo and the displayed frequency of course is the operational frequency. Data held in memory or vfo is stored in the config file and is available through sessions with the last used frequency being the next start frequency. Long term memory storage should be made via the bookmarks facility.
===VFO memory===
The vfo has a memory associated with it for each band and allows startup of QtRadio to retrieve last frequency, mode, filter and spectrum/waterfall settings used. Shifting to another band allows the last used frequency etc. for that band to be retrieved and of course a return to the original band will get back the original data.
===Storing===
Storing a quick memory is accomplished by right clicking over any of the band buttons. The software will work out the right button for the frequency and store it there. The storage button will light up yellow for 1/2 second and the status bar will show ... the current band, the current read memory position and current store memory position, Mode, Filter and "stored at" store memory number. If the current frequency, mode and filter is already stored in quick memory, the memory will become the current memory and no extra storage will take place. Storage is always made to overwrite the oldest stored memory position so if your memories are stored as 0,1,2 for 3 quick memories and memory 2 was the last stored location, then memory 0 would be would be the next storage location. The index to the current memory storage location is saved on shutdown.
===Reading from Band Buttons===
A left click on the band button will cycle through the stored memories without ever overwriting them. The data in the selected memory is copied to the vfo memory and any change to the vfo is not written to memory unless explicitly via a right click over the bandbutton area. Full current information is retrieved from the memory and consists of Frequency, Mode, Filter, Spectrum info and Waterfall info. The index to the current memory read location is saved on shutdown. The status bar is updated to reflect the memory read/write information and a message is displayed advising you the vfo is currently matching a retrieved memory.
===Reading from Band menu===
Please refer to main menu section [[#Band Selection | Band]]

== Using subRx ==
To be constructed

== The Menu choices ==

=== Receiver ===
''Connect/Disconnect''

You can connect to a server either by selecting the server in the Configure > Server list and then click Connect, or by selecting the server in the Quick Server List and click connect.

After you Disconnect from a server, you must wait at least 10 seconds for the disconnection to take full effect before connecting to another server. This is to allow the internet connection to really disconnect (remember there is network latency and the server will continue to send data till its buffers are emptied). Failure to do so will often result in error in QtRadio and may even hang QtRadio.

''Quick Server List''

If you see that a public server's status is "Busy", please '''do not''' connect to it. Doing so will disrupt the user already connected. If you see a server's status is "Idle" or "0 client(s)", you can connect to it. If you see "1 client(s)" or "2 client(s)" etc., you are sharing a connection to the same server. The first client is the master who has control over the vfo and Tx etc., and you will be connecting as a slave. You will only be able to listen to the audio and see the spectrum passively as an observer. When the clients before you disconnect, you will automatically become the master. This is a queuing mechanism.

''Configure > Audio''

If you are connecting to a public server on the Internet (ie not your own server on your LAN), '''please''' set Audio to 8000, aLaw, and 1 channel. If you use other settings, your QtRadio and/or the dspserver/server will hang.

=== Audio ===

=== Band ===
====Keypad====
Clicking on the keypad brings up a key entry window. The frequency must be entered by clicking on the number pads and should be in the form MHz dot KHz i.e. 14.293 Entering in KHz will cause an error which is not trapped yet.
====Band Selection====
The band menu allows selection of a band by clicking on the desired entry. Clicks on an already selected entry steps to the next memory position and sets the stored frequency, mode, filter and spectrum/waterfall settings.
The status line on the bottom right hand side of the window will display ... Band, Memory position, Mode, Filter and whether using memory or vfo.
====XVTR====
To Come

=== Mode ===
=== Filter ===
=== Noise Reduction ===
=== AGC ===
=== Spectrum ===
=== Hardware ===
=== Bookmarks ===

== Transmit commands ==

== Keyboard Shortcuts ==
* Arrow Left/Right Tune Down/Up the active VFO
* Arrow Up/Down Increase /Decrease Step Size above
* lowercase a = VFOA
* lowercase b = VFOB
* lowercase c = Connect
* lowercase d = Disconnect
* lowercase k= Bring up Keypad entry window
* lowercase l = Bring up Quick Connect Window
* lowercase s = toggle SubRX

== Using the Griffin Powermate USB Dial as VFO Knob ==
=== The Griffin Powermate USB DIal ===
[[File:powermate_.png|200px]]

The Griffin Powermate has a single wheel and a pushbutton, which is
able to do the following actions:

<pre>
1. Rotate Clockwise
2. Rotate Counterclockwise
3. Push Down and Rotate Clockwise
4. Push Down and Rotate Counterclockwise
5. Push Down
6. Long Push Down
7. Responisve Blue LED's
</pre>

So we have 6 possibilities to map to keystrokes, soundcard levels and so on.

In Windows you may refer to the following Document published by FlexRadio. Install the Powermate Software for Windows and map your wanted keys.

http://support.flexradio.com/Downloads.aspx?id=47

=== Download Gizmod ===

In Linux there is Gizmo Daemon - THE Linux Linux Input Device Utility.

'''You need at least Ubuntu 11.10 installed'''

Unfortunately Gizmo is no longer supported by Ubuntu and most other Linux Distributions. The last update on the Gizmo page was in 2009.

So the following Setup is experimental until we may have support for the Powermate in QtRadio or Hamlib directly.

1. Go to your preferred local git directory.
<pre>
$ git clone git://github.com/jtriley/gizmod.git
</pre>

<pre>
$ cd gizmod
</pre>

Make the following two patches:

<pre>
index 14b8d37..b61e2a1 100644
--- a/libH/Average.hpp
+++ b/libH/Average.hpp
@@ -35,6 +35,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

You may apply the above patch manually by:
<pre>
$ gedit libH/Average.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

Do the same with the following patch:

<pre>
index d794055..75f4c27 100644
--- a/libH/DynamicBuffer.hpp
+++ b/libH/DynamicBuffer.hpp
@@ -33,6 +33,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

<pre>
gedit libHDynamicBuffer.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

<pre>
$ gedit cpuusage.cpp
</pre>

add

<pre>
#include <cstring>
</pre>

<pre>
$ sudo apt-get install libboost-all-dev
$ sudo apt-get install libboost-filesystem1.46.1
$ sudo apt-get install libboost-filesystem1.46-dev
</pre>

<pre>
$ mkdir build
$ cd build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr -DSYSCONF_INSTALL_DIR=/etc ../
$ make
</pre>

If you still get an error do:

<pre>
$ gedit gizmod/CMakeFiles/gizmod.dir/link.txt
</pre>

and add:

<pre>
-lboost_system
</pre>

<pre>
$ make
$ sudo make install
</pre>

=== Setup Gizmod ===

Go to your user directory and do:
<pre>
$ mkdir -p .gizmod
</pre>

<pre>
$ cp /usr/etc/gizmod * .gizmod
</pre>

<pre>
$ mkdir .gizmod/modules.d
</pre>

<pre>
$ cp /usr/etc/gizmod/modules.d/000-CatchAllDebug.py .gizmod/modules.d/
$ cp /usr/etc/gizmod/modules.d/299-Powermate-Default.py .gizmod/modules.d/
</pre>

<pre>
$ cd .gizmod/modules.d
</pre>

<pre>
$ gedit 299-Powermate-Default.py
</pre>

Edit 299-Powermate-Default.py like this (Do not change the Filename and edit exactly)

<pre>
#***
#*********************************************************************
#*************************************************************************
#***
#*** GizmoDaemon Config Script
#*** Powermate Default config
#***
#*****************************************
#*****************************************
#***

"""

Copyright (c) 2007, Gizmo Daemon Team
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

"""

############################
# Imports
##########################

from GizmoDaemon import *
from GizmoScriptDefault import *
import time

ENABLED = True
VERSION_NEEDED = 3.2
INTERESTED_CLASSES = [GizmoEventClass.Powermate]

############################
# PowermateDefault Class definition
##########################

class PowermateDefault(GizmoScriptDefault):
"""
Default Powermate Event Mapping
"""

############################
# Public Functions
##########################

def onDeviceEvent(self, Event, Gizmo = None):
"""
Called from Base Class' onEvent method.
See GizmodDispatcher.onEvent documention for an explanation of this function
"""

# Check for rotations
if Event.Type == GizmoEventType.EV_REL:
if Gizmo.getKeyState(GizmoKey.BTN_0):
if Gizmod.DefaultMixerVolume:
Gizmod.DefaultMixerVolume.VolumePlayback = Gizmod.DefaultMixerVolume.VolumePlayback + Event.Value
else:
# scroll quickly (by pages using the page up / page down keys)
if Event.Value < 0:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_RIGHT)
else:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_LEFT)
return True
elif Event.Type == GizmoEventType.EV_KEY:
if Event.Value == 0 and not Gizmo.Rotated:
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_PLUS)
return True
return False

############################
# Private Functions
##########################

def __init__(self):
"""
Default Constructor
"""

GizmoScriptDefault.__init__(self, ENABLED, VERSION_NEEDED, INTERESTED_CLASSES)

############################
# PowermateDefault class end
##########################

# register the user script
PowermateDefault()
</pre>

<pre>
$ gizmod
</pre>

you should see the following output:(depends on your system)

<pre>
GizmoDaemon v3.4 -=- (c) 2007, Tim Burrell <tim.burrell@gmail.com>
=---------=

Registering Devices:

Standard - Directory [input]
Standard - Sleep Button [event0] vId: 0x0 pId: 0x3
Standard - Lid Switch [event1] vId: 0x0 pId: 0x5
Standard - HDA Intel Mic [event10] vId: 0x0 pId: 0x0
Standard - HDA Intel Mic [event11] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event12] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event13] vId: 0x0 pId: 0x0
Standard - Power Button [event2] vId: 0x0 pId: 0x1
Keyboard - AT Translated Set 2 keyboard [event3] vId: 0x1 pId: 0x1
Standard - Asus Laptop extra buttons [event4] vId: 0x0 pId: 0x0
Powermate - Griffin PowerMate [event5] vId: 0x77d pId: 0x410
Standard - CNF7237&CNF7238 [event6] vId: 0x17ef pId: 0x4808
Mouse - SynPS/2 Synaptics TouchPad [event7] vId: 0x2 pId: 0x7
Standard - Video Bus [event8] vId: 0x0 pId: 0x6
Standard - HDA Intel HDMI/DP,pcm=3 [event9] vId: 0x0 pId: 0x0

Loading User Scripts:

CatchAllDebug - CatchAll Event Mapping for Testing
PowermateDefault - Default Powermate Event Mapping
</pre>

You should have the following functions:

<pre>
turn left = KEY RIGHT
turn right = KEY LEFT
press and turn left = System Volume down
press and turn right = System Volume up
Buttonpress = cycle through Step Size
</pre>

QtRadio - Operation

2011-12-01T22:18:37Z

Zl2apv: /* Reading from Band menu */

=== Connecting to a server ===

== Tuning the radio ==
=== Fixed frequency radio ===
For crystal locked radios such as the softrock lite II or YU1LM sdr's It is necessary to use [[#Using subRx | subRx]]. The procedure is to set vfoA to your centre frequency, usually the crystal frequency / 4 and leave it alone as changing it will affect your centre frequency. Using the button on the vfo panel or the 'Receiver' Menu / subRx choice switch on the subRx. You can now tune within the limits of the sample rate of your sound card (48, 96 or 192 KHz).

Note that you need to start dspserver with LO offset of zero:

$ dspserver --lo 0

=== si570 tunable radio ===

In the Softrock series of hardware using sound cards, there is frequently a noise band near DC (offset 0). As such most users will set an offset of 9000 Hz (or 12000Hz etc.) using programs such as PSDR-IQ. You do the same when starting dspserver:

$ dspserver --lo 9000

=== Direct Down Conversion (DDC) radio ===

Such radios (eg. Perseus, HPSDR, usrp) do not need the offset. So start dspserver with:

$ dspserver --lo 0

== Setting the noise floor ==
The height of the spectrum from the baseline is adjusted by rolling the mouse wheel with the pointer over the level calibration markings on the extreme left hand side of the spectrum window. This will at the same time change the base colour of the waterfall.

The procedure is: After setting the [[#Calibrating the S meter | sound-card gain]] you should remove the antenna and roll the mouse-wheel to give a spectrum display line just above the bottom of the window. When you apply the antenna the spectrum will rise in the window and the waterfall base colour should be dark blue unless the band is particularly noisy.

== Calibrating the S meter ==
To calibrate the S Meter, a signal equal to S9 (-73 dBm) is injected into the sdr and the soundcard gain is adjusted until the S meter reads S9. It will then probably be necessary to adjust the spectrum [[#Setting the noise floor | noise floor]] level.

A subjective calibration may be performed by tuning into a signal considered S9 and performing the above procedure.

== VFO and Split selection ==

== Using RIT ==

== Changing bands ==

== Using Quick Memories ==
===Overview===
The quick memories are used in conjunction with the VFO memory to give quick access to storing and retrieving memories which will be used on a temporary basis. Each selected quick memory is transferred to the vfo memory and if any tune operation is made the operation shifts to the vfo and the displayed frequency of course is the operational frequency. Data held in memory or vfo is stored in the config file and is available through sessions with the last used frequency being the next start frequency. Long term memory storage should be made via the bookmarks facility.
===VFO memory===
The vfo has a memory associated with it for each band and allows startup of QtRadio to retrieve last frequency, mode, filter and spectrum/waterfall settings used. Shifting to another band allows the last used frequency etc. for that band to be retrieved and of course a return to the original band will get back the original data.
===Storing===
Storing a quick memory is accomplished by right clicking over any of the band buttons. The software will work out the right button for the frequency and store it there. The storage button will light up yellow for 1/2 second and the status bar will show ... the current band, the current read memory position and current store memory position, Mode, Filter and "stored at" store memory number. If the current frequency, mode and filter is already stored in quick memory, the memory will become the current memory and no extra storage will take place. Storage is always made to overwrite the oldest stored memory position so if your memories are stored as 0,1,2 for 3 quick memories and memory 2 was the last stored location, then memory 0 would be would be the next storage location. The index to the current memory storage location is saved on shutdown.
===Reading from Band Buttons===
A left click on the band button will cycle through the stored memories without ever overwriting them. The data in the selected memory is copied to the vfo memory and any change to the vfo is not written to memory unless explicitly via a right click over the bandbutton area. Full current information is retrieved from the memory and consists of Frequency, Mode, Filter, Spectrum info and Waterfall info. The index to the current memory read location is saved on shutdown. The status bar is updated to reflect the memory read/write information and a message is displayed advising you the vfo is currently matching a retrieved memory.
===Reading from Band menu===
Please refer to main menu section "Band"[[#Band Selection | Band]] TODO make this a link

== Using subRx ==
To be constructed

== The Menu choices ==

=== Receiver ===
''Connect/Disconnect''

You can connect to a server either by selecting the server in the Configure > Server list and then click Connect, or by selecting the server in the Quick Server List and click connect.

After you Disconnect from a server, you must wait at least 10 seconds for the disconnection to take full effect before connecting to another server. This is to allow the internet connection to really disconnect (remember there is network latency and the server will continue to send data till its buffers are emptied). Failure to do so will often result in error in QtRadio and may even hang QtRadio.

''Quick Server List''

If you see that a public server's status is "Busy", please '''do not''' connect to it. Doing so will disrupt the user already connected. If you see a server's status is "Idle" or "0 client(s)", you can connect to it. If you see "1 client(s)" or "2 client(s)" etc., you are sharing a connection to the same server. The first client is the master who has control over the vfo and Tx etc., and you will be connecting as a slave. You will only be able to listen to the audio and see the spectrum passively as an observer. When the clients before you disconnect, you will automatically become the master. This is a queuing mechanism.

''Configure > Audio''

If you are connecting to a public server on the Internet (ie not your own server on your LAN), '''please''' set Audio to 8000, aLaw, and 1 channel. If you use other settings, your QtRadio and/or the dspserver/server will hang.

=== Audio ===

=== Band ===
====Keypad====
Clicking on the keypad brings up a key entry window. The frequency must be entered by clicking on the number pads and should be in the form MHz dot KHz i.e. 14.293 Entering in KHz will cause an error which is not trapped yet.
====Band Selection====
The band menu allows selection of a band by clicking on the desired entry. Clicks on an already selected entry steps to the next memory position and sets the stored frequency, mode, filter and spectrum/waterfall settings.
The status line on the bottom right hand side of the window will display ... Band, Memory position, Mode, Filter and whether using memory or vfo.
====XVTR====
To Come

=== Mode ===
=== Filter ===
=== Noise Reduction ===
=== AGC ===
=== Spectrum ===
=== Hardware ===
=== Bookmarks ===

== Transmit commands ==

== Keyboard Shortcuts ==
* Arrow Left/Right Tune Down/Up the active VFO
* Arrow Up/Down Increase /Decrease Step Size above
* lowercase a = VFOA
* lowercase b = VFOB
* lowercase c = Connect
* lowercase d = Disconnect
* lowercase k= Bring up Keypad entry window
* lowercase l = Bring up Quick Connect Window
* lowercase s = toggle SubRX

== Using the Griffin Powermate USB Dial as VFO Knob ==
=== The Griffin Powermate USB DIal ===
[[File:powermate_.png|200px]]

The Griffin Powermate has a single wheel and a pushbutton, which is
able to do the following actions:

<pre>
1. Rotate Clockwise
2. Rotate Counterclockwise
3. Push Down and Rotate Clockwise
4. Push Down and Rotate Counterclockwise
5. Push Down
6. Long Push Down
7. Responisve Blue LED's
</pre>

So we have 6 possibilities to map to keystrokes, soundcard levels and so on.

In Windows you may refer to the following Document published by FlexRadio. Install the Powermate Software for Windows and map your wanted keys.

http://support.flexradio.com/Downloads.aspx?id=47

=== Download Gizmod ===

In Linux there is Gizmo Daemon - THE Linux Linux Input Device Utility.

'''You need at least Ubuntu 11.10 installed'''

Unfortunately Gizmo is no longer supported by Ubuntu and most other Linux Distributions. The last update on the Gizmo page was in 2009.

So the following Setup is experimental until we may have support for the Powermate in QtRadio or Hamlib directly.

1. Go to your preferred local git directory.
<pre>
$ git clone git://github.com/jtriley/gizmod.git
</pre>

<pre>
$ cd gizmod
</pre>

Make the following two patches:

<pre>
index 14b8d37..b61e2a1 100644
--- a/libH/Average.hpp
+++ b/libH/Average.hpp
@@ -35,6 +35,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

You may apply the above patch manually by:
<pre>
$ gedit libH/Average.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

Do the same with the following patch:

<pre>
index d794055..75f4c27 100644
--- a/libH/DynamicBuffer.hpp
+++ b/libH/DynamicBuffer.hpp
@@ -33,6 +33,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

<pre>
gedit libHDynamicBuffer.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

<pre>
$ gedit cpuusage.cpp
</pre>

add

<pre>
#include <cstring>
</pre>

<pre>
$ sudo apt-get install libboost-all-dev
$ sudo apt-get install libboost-filesystem1.46.1
$ sudo apt-get install libboost-filesystem1.46-dev
</pre>

<pre>
$ mkdir build
$ cd build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr -DSYSCONF_INSTALL_DIR=/etc ../
$ make
</pre>

If you still get an error do:

<pre>
$ gedit gizmod/CMakeFiles/gizmod.dir/link.txt
</pre>

and add:

<pre>
-lboost_system
</pre>

<pre>
$ make
$ sudo make install
</pre>

=== Setup Gizmod ===

Go to your user directory and do:
<pre>
$ mkdir -p .gizmod
</pre>

<pre>
$ cp /usr/etc/gizmod * .gizmod
</pre>

<pre>
$ mkdir .gizmod/modules.d
</pre>

<pre>
$ cp /usr/etc/gizmod/modules.d/000-CatchAllDebug.py .gizmod/modules.d/
$ cp /usr/etc/gizmod/modules.d/299-Powermate-Default.py .gizmod/modules.d/
</pre>

<pre>
$ cd .gizmod/modules.d
</pre>

<pre>
$ gedit 299-Powermate-Default.py
</pre>

Edit 299-Powermate-Default.py like this (Do not change the Filename and edit exactly)

<pre>
#***
#*********************************************************************
#*************************************************************************
#***
#*** GizmoDaemon Config Script
#*** Powermate Default config
#***
#*****************************************
#*****************************************
#***

"""

Copyright (c) 2007, Gizmo Daemon Team
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

"""

############################
# Imports
##########################

from GizmoDaemon import *
from GizmoScriptDefault import *
import time

ENABLED = True
VERSION_NEEDED = 3.2
INTERESTED_CLASSES = [GizmoEventClass.Powermate]

############################
# PowermateDefault Class definition
##########################

class PowermateDefault(GizmoScriptDefault):
"""
Default Powermate Event Mapping
"""

############################
# Public Functions
##########################

def onDeviceEvent(self, Event, Gizmo = None):
"""
Called from Base Class' onEvent method.
See GizmodDispatcher.onEvent documention for an explanation of this function
"""

# Check for rotations
if Event.Type == GizmoEventType.EV_REL:
if Gizmo.getKeyState(GizmoKey.BTN_0):
if Gizmod.DefaultMixerVolume:
Gizmod.DefaultMixerVolume.VolumePlayback = Gizmod.DefaultMixerVolume.VolumePlayback + Event.Value
else:
# scroll quickly (by pages using the page up / page down keys)
if Event.Value < 0:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_RIGHT)
else:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_LEFT)
return True
elif Event.Type == GizmoEventType.EV_KEY:
if Event.Value == 0 and not Gizmo.Rotated:
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_PLUS)
return True
return False

############################
# Private Functions
##########################

def __init__(self):
"""
Default Constructor
"""

GizmoScriptDefault.__init__(self, ENABLED, VERSION_NEEDED, INTERESTED_CLASSES)

############################
# PowermateDefault class end
##########################

# register the user script
PowermateDefault()
</pre>

<pre>
$ gizmod
</pre>

you should see the following output:(depends on your system)

<pre>
GizmoDaemon v3.4 -=- (c) 2007, Tim Burrell <tim.burrell@gmail.com>
=---------=

Registering Devices:

Standard - Directory [input]
Standard - Sleep Button [event0] vId: 0x0 pId: 0x3
Standard - Lid Switch [event1] vId: 0x0 pId: 0x5
Standard - HDA Intel Mic [event10] vId: 0x0 pId: 0x0
Standard - HDA Intel Mic [event11] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event12] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event13] vId: 0x0 pId: 0x0
Standard - Power Button [event2] vId: 0x0 pId: 0x1
Keyboard - AT Translated Set 2 keyboard [event3] vId: 0x1 pId: 0x1
Standard - Asus Laptop extra buttons [event4] vId: 0x0 pId: 0x0
Powermate - Griffin PowerMate [event5] vId: 0x77d pId: 0x410
Standard - CNF7237&CNF7238 [event6] vId: 0x17ef pId: 0x4808
Mouse - SynPS/2 Synaptics TouchPad [event7] vId: 0x2 pId: 0x7
Standard - Video Bus [event8] vId: 0x0 pId: 0x6
Standard - HDA Intel HDMI/DP,pcm=3 [event9] vId: 0x0 pId: 0x0

Loading User Scripts:

CatchAllDebug - CatchAll Event Mapping for Testing
PowermateDefault - Default Powermate Event Mapping
</pre>

You should have the following functions:

<pre>
turn left = KEY RIGHT
turn right = KEY LEFT
press and turn left = System Volume down
press and turn right = System Volume up
Buttonpress = cycle through Step Size
</pre>

QtRadio - Operation

2011-12-01T22:17:44Z

Zl2apv: /* Reading from Band menu */

=== Connecting to a server ===

== Tuning the radio ==
=== Fixed frequency radio ===
For crystal locked radios such as the softrock lite II or YU1LM sdr's It is necessary to use [[#Using subRx | subRx]]. The procedure is to set vfoA to your centre frequency, usually the crystal frequency / 4 and leave it alone as changing it will affect your centre frequency. Using the button on the vfo panel or the 'Receiver' Menu / subRx choice switch on the subRx. You can now tune within the limits of the sample rate of your sound card (48, 96 or 192 KHz).

Note that you need to start dspserver with LO offset of zero:

$ dspserver --lo 0

=== si570 tunable radio ===

In the Softrock series of hardware using sound cards, there is frequently a noise band near DC (offset 0). As such most users will set an offset of 9000 Hz (or 12000Hz etc.) using programs such as PSDR-IQ. You do the same when starting dspserver:

$ dspserver --lo 9000

=== Direct Down Conversion (DDC) radio ===

Such radios (eg. Perseus, HPSDR, usrp) do not need the offset. So start dspserver with:

$ dspserver --lo 0

== Setting the noise floor ==
The height of the spectrum from the baseline is adjusted by rolling the mouse wheel with the pointer over the level calibration markings on the extreme left hand side of the spectrum window. This will at the same time change the base colour of the waterfall.

The procedure is: After setting the [[#Calibrating the S meter | sound-card gain]] you should remove the antenna and roll the mouse-wheel to give a spectrum display line just above the bottom of the window. When you apply the antenna the spectrum will rise in the window and the waterfall base colour should be dark blue unless the band is particularly noisy.

== Calibrating the S meter ==
To calibrate the S Meter, a signal equal to S9 (-73 dBm) is injected into the sdr and the soundcard gain is adjusted until the S meter reads S9. It will then probably be necessary to adjust the spectrum [[#Setting the noise floor | noise floor]] level.

A subjective calibration may be performed by tuning into a signal considered S9 and performing the above procedure.

== VFO and Split selection ==

== Using RIT ==

== Changing bands ==

== Using Quick Memories ==
===Overview===
The quick memories are used in conjunction with the VFO memory to give quick access to storing and retrieving memories which will be used on a temporary basis. Each selected quick memory is transferred to the vfo memory and if any tune operation is made the operation shifts to the vfo and the displayed frequency of course is the operational frequency. Data held in memory or vfo is stored in the config file and is available through sessions with the last used frequency being the next start frequency. Long term memory storage should be made via the bookmarks facility.
===VFO memory===
The vfo has a memory associated with it for each band and allows startup of QtRadio to retrieve last frequency, mode, filter and spectrum/waterfall settings used. Shifting to another band allows the last used frequency etc. for that band to be retrieved and of course a return to the original band will get back the original data.
===Storing===
Storing a quick memory is accomplished by right clicking over any of the band buttons. The software will work out the right button for the frequency and store it there. The storage button will light up yellow for 1/2 second and the status bar will show ... the current band, the current read memory position and current store memory position, Mode, Filter and "stored at" store memory number. If the current frequency, mode and filter is already stored in quick memory, the memory will become the current memory and no extra storage will take place. Storage is always made to overwrite the oldest stored memory position so if your memories are stored as 0,1,2 for 3 quick memories and memory 2 was the last stored location, then memory 0 would be would be the next storage location. The index to the current memory storage location is saved on shutdown.
===Reading from Band Buttons===
A left click on the band button will cycle through the stored memories without ever overwriting them. The data in the selected memory is copied to the vfo memory and any change to the vfo is not written to memory unless explicitly via a right click over the bandbutton area. Full current information is retrieved from the memory and consists of Frequency, Mode, Filter, Spectrum info and Waterfall info. The index to the current memory read location is saved on shutdown. The status bar is updated to reflect the memory read/write information and a message is displayed advising you the vfo is currently matching a retrieved memory.
===Reading from Band menu===
Please refer to main menu section "Band"[[#Band selection | Band]] TODO make this a link

== Using subRx ==
To be constructed

== The Menu choices ==

=== Receiver ===
''Connect/Disconnect''

You can connect to a server either by selecting the server in the Configure > Server list and then click Connect, or by selecting the server in the Quick Server List and click connect.

After you Disconnect from a server, you must wait at least 10 seconds for the disconnection to take full effect before connecting to another server. This is to allow the internet connection to really disconnect (remember there is network latency and the server will continue to send data till its buffers are emptied). Failure to do so will often result in error in QtRadio and may even hang QtRadio.

''Quick Server List''

If you see that a public server's status is "Busy", please '''do not''' connect to it. Doing so will disrupt the user already connected. If you see a server's status is "Idle" or "0 client(s)", you can connect to it. If you see "1 client(s)" or "2 client(s)" etc., you are sharing a connection to the same server. The first client is the master who has control over the vfo and Tx etc., and you will be connecting as a slave. You will only be able to listen to the audio and see the spectrum passively as an observer. When the clients before you disconnect, you will automatically become the master. This is a queuing mechanism.

''Configure > Audio''

If you are connecting to a public server on the Internet (ie not your own server on your LAN), '''please''' set Audio to 8000, aLaw, and 1 channel. If you use other settings, your QtRadio and/or the dspserver/server will hang.

=== Audio ===

=== Band ===
====Keypad====
Clicking on the keypad brings up a key entry window. The frequency must be entered by clicking on the number pads and should be in the form MHz dot KHz i.e. 14.293 Entering in KHz will cause an error which is not trapped yet.
====Band Selection====
The band menu allows selection of a band by clicking on the desired entry. Clicks on an already selected entry steps to the next memory position and sets the stored frequency, mode, filter and spectrum/waterfall settings.
The status line on the bottom right hand side of the window will display ... Band, Memory position, Mode, Filter and whether using memory or vfo.
====XVTR====
To Come

=== Mode ===
=== Filter ===
=== Noise Reduction ===
=== AGC ===
=== Spectrum ===
=== Hardware ===
=== Bookmarks ===

== Transmit commands ==

== Keyboard Shortcuts ==
* Arrow Left/Right Tune Down/Up the active VFO
* Arrow Up/Down Increase /Decrease Step Size above
* lowercase a = VFOA
* lowercase b = VFOB
* lowercase c = Connect
* lowercase d = Disconnect
* lowercase k= Bring up Keypad entry window
* lowercase l = Bring up Quick Connect Window
* lowercase s = toggle SubRX

== Using the Griffin Powermate USB Dial as VFO Knob ==
=== The Griffin Powermate USB DIal ===
[[File:powermate_.png|200px]]

The Griffin Powermate has a single wheel and a pushbutton, which is
able to do the following actions:

<pre>
1. Rotate Clockwise
2. Rotate Counterclockwise
3. Push Down and Rotate Clockwise
4. Push Down and Rotate Counterclockwise
5. Push Down
6. Long Push Down
7. Responisve Blue LED's
</pre>

So we have 6 possibilities to map to keystrokes, soundcard levels and so on.

In Windows you may refer to the following Document published by FlexRadio. Install the Powermate Software for Windows and map your wanted keys.

http://support.flexradio.com/Downloads.aspx?id=47

=== Download Gizmod ===

In Linux there is Gizmo Daemon - THE Linux Linux Input Device Utility.

'''You need at least Ubuntu 11.10 installed'''

Unfortunately Gizmo is no longer supported by Ubuntu and most other Linux Distributions. The last update on the Gizmo page was in 2009.

So the following Setup is experimental until we may have support for the Powermate in QtRadio or Hamlib directly.

1. Go to your preferred local git directory.
<pre>
$ git clone git://github.com/jtriley/gizmod.git
</pre>

<pre>
$ cd gizmod
</pre>

Make the following two patches:

<pre>
index 14b8d37..b61e2a1 100644
--- a/libH/Average.hpp
+++ b/libH/Average.hpp
@@ -35,6 +35,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

You may apply the above patch manually by:
<pre>
$ gedit libH/Average.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

Do the same with the following patch:

<pre>
index d794055..75f4c27 100644
--- a/libH/DynamicBuffer.hpp
+++ b/libH/DynamicBuffer.hpp
@@ -33,6 +33,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

<pre>
gedit libHDynamicBuffer.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

<pre>
$ gedit cpuusage.cpp
</pre>

add

<pre>
#include <cstring>
</pre>

<pre>
$ sudo apt-get install libboost-all-dev
$ sudo apt-get install libboost-filesystem1.46.1
$ sudo apt-get install libboost-filesystem1.46-dev
</pre>

<pre>
$ mkdir build
$ cd build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr -DSYSCONF_INSTALL_DIR=/etc ../
$ make
</pre>

If you still get an error do:

<pre>
$ gedit gizmod/CMakeFiles/gizmod.dir/link.txt
</pre>

and add:

<pre>
-lboost_system
</pre>

<pre>
$ make
$ sudo make install
</pre>

=== Setup Gizmod ===

Go to your user directory and do:
<pre>
$ mkdir -p .gizmod
</pre>

<pre>
$ cp /usr/etc/gizmod * .gizmod
</pre>

<pre>
$ mkdir .gizmod/modules.d
</pre>

<pre>
$ cp /usr/etc/gizmod/modules.d/000-CatchAllDebug.py .gizmod/modules.d/
$ cp /usr/etc/gizmod/modules.d/299-Powermate-Default.py .gizmod/modules.d/
</pre>

<pre>
$ cd .gizmod/modules.d
</pre>

<pre>
$ gedit 299-Powermate-Default.py
</pre>

Edit 299-Powermate-Default.py like this (Do not change the Filename and edit exactly)

<pre>
#***
#*********************************************************************
#*************************************************************************
#***
#*** GizmoDaemon Config Script
#*** Powermate Default config
#***
#*****************************************
#*****************************************
#***

"""

Copyright (c) 2007, Gizmo Daemon Team
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

"""

############################
# Imports
##########################

from GizmoDaemon import *
from GizmoScriptDefault import *
import time

ENABLED = True
VERSION_NEEDED = 3.2
INTERESTED_CLASSES = [GizmoEventClass.Powermate]

############################
# PowermateDefault Class definition
##########################

class PowermateDefault(GizmoScriptDefault):
"""
Default Powermate Event Mapping
"""

############################
# Public Functions
##########################

def onDeviceEvent(self, Event, Gizmo = None):
"""
Called from Base Class' onEvent method.
See GizmodDispatcher.onEvent documention for an explanation of this function
"""

# Check for rotations
if Event.Type == GizmoEventType.EV_REL:
if Gizmo.getKeyState(GizmoKey.BTN_0):
if Gizmod.DefaultMixerVolume:
Gizmod.DefaultMixerVolume.VolumePlayback = Gizmod.DefaultMixerVolume.VolumePlayback + Event.Value
else:
# scroll quickly (by pages using the page up / page down keys)
if Event.Value < 0:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_RIGHT)
else:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_LEFT)
return True
elif Event.Type == GizmoEventType.EV_KEY:
if Event.Value == 0 and not Gizmo.Rotated:
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_PLUS)
return True
return False

############################
# Private Functions
##########################

def __init__(self):
"""
Default Constructor
"""

GizmoScriptDefault.__init__(self, ENABLED, VERSION_NEEDED, INTERESTED_CLASSES)

############################
# PowermateDefault class end
##########################

# register the user script
PowermateDefault()
</pre>

<pre>
$ gizmod
</pre>

you should see the following output:(depends on your system)

<pre>
GizmoDaemon v3.4 -=- (c) 2007, Tim Burrell <tim.burrell@gmail.com>
=---------=

Registering Devices:

Standard - Directory [input]
Standard - Sleep Button [event0] vId: 0x0 pId: 0x3
Standard - Lid Switch [event1] vId: 0x0 pId: 0x5
Standard - HDA Intel Mic [event10] vId: 0x0 pId: 0x0
Standard - HDA Intel Mic [event11] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event12] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event13] vId: 0x0 pId: 0x0
Standard - Power Button [event2] vId: 0x0 pId: 0x1
Keyboard - AT Translated Set 2 keyboard [event3] vId: 0x1 pId: 0x1
Standard - Asus Laptop extra buttons [event4] vId: 0x0 pId: 0x0
Powermate - Griffin PowerMate [event5] vId: 0x77d pId: 0x410
Standard - CNF7237&CNF7238 [event6] vId: 0x17ef pId: 0x4808
Mouse - SynPS/2 Synaptics TouchPad [event7] vId: 0x2 pId: 0x7
Standard - Video Bus [event8] vId: 0x0 pId: 0x6
Standard - HDA Intel HDMI/DP,pcm=3 [event9] vId: 0x0 pId: 0x0

Loading User Scripts:

CatchAllDebug - CatchAll Event Mapping for Testing
PowermateDefault - Default Powermate Event Mapping
</pre>

You should have the following functions:

<pre>
turn left = KEY RIGHT
turn right = KEY LEFT
press and turn left = System Volume down
press and turn right = System Volume up
Buttonpress = cycle through Step Size
</pre>

QtRadio - Operation

2011-12-01T22:15:56Z

Zl2apv: /* Reading from Band menu */

=== Connecting to a server ===

== Tuning the radio ==
=== Fixed frequency radio ===
For crystal locked radios such as the softrock lite II or YU1LM sdr's It is necessary to use [[#Using subRx | subRx]]. The procedure is to set vfoA to your centre frequency, usually the crystal frequency / 4 and leave it alone as changing it will affect your centre frequency. Using the button on the vfo panel or the 'Receiver' Menu / subRx choice switch on the subRx. You can now tune within the limits of the sample rate of your sound card (48, 96 or 192 KHz).

Note that you need to start dspserver with LO offset of zero:

$ dspserver --lo 0

=== si570 tunable radio ===

In the Softrock series of hardware using sound cards, there is frequently a noise band near DC (offset 0). As such most users will set an offset of 9000 Hz (or 12000Hz etc.) using programs such as PSDR-IQ. You do the same when starting dspserver:

$ dspserver --lo 9000

=== Direct Down Conversion (DDC) radio ===

Such radios (eg. Perseus, HPSDR, usrp) do not need the offset. So start dspserver with:

$ dspserver --lo 0

== Setting the noise floor ==
The height of the spectrum from the baseline is adjusted by rolling the mouse wheel with the pointer over the level calibration markings on the extreme left hand side of the spectrum window. This will at the same time change the base colour of the waterfall.

The procedure is: After setting the [[#Calibrating the S meter | sound-card gain]] you should remove the antenna and roll the mouse-wheel to give a spectrum display line just above the bottom of the window. When you apply the antenna the spectrum will rise in the window and the waterfall base colour should be dark blue unless the band is particularly noisy.

== Calibrating the S meter ==
To calibrate the S Meter, a signal equal to S9 (-73 dBm) is injected into the sdr and the soundcard gain is adjusted until the S meter reads S9. It will then probably be necessary to adjust the spectrum [[#Setting the noise floor | noise floor]] level.

A subjective calibration may be performed by tuning into a signal considered S9 and performing the above procedure.

== VFO and Split selection ==

== Using RIT ==

== Changing bands ==

== Using Quick Memories ==
===Overview===
The quick memories are used in conjunction with the VFO memory to give quick access to storing and retrieving memories which will be used on a temporary basis. Each selected quick memory is transferred to the vfo memory and if any tune operation is made the operation shifts to the vfo and the displayed frequency of course is the operational frequency. Data held in memory or vfo is stored in the config file and is available through sessions with the last used frequency being the next start frequency. Long term memory storage should be made via the bookmarks facility.
===VFO memory===
The vfo has a memory associated with it for each band and allows startup of QtRadio to retrieve last frequency, mode, filter and spectrum/waterfall settings used. Shifting to another band allows the last used frequency etc. for that band to be retrieved and of course a return to the original band will get back the original data.
===Storing===
Storing a quick memory is accomplished by right clicking over any of the band buttons. The software will work out the right button for the frequency and store it there. The storage button will light up yellow for 1/2 second and the status bar will show ... the current band, the current read memory position and current store memory position, Mode, Filter and "stored at" store memory number. If the current frequency, mode and filter is already stored in quick memory, the memory will become the current memory and no extra storage will take place. Storage is always made to overwrite the oldest stored memory position so if your memories are stored as 0,1,2 for 3 quick memories and memory 2 was the last stored location, then memory 0 would be would be the next storage location. The index to the current memory storage location is saved on shutdown.
===Reading from Band Buttons===
A left click on the band button will cycle through the stored memories without ever overwriting them. The data in the selected memory is copied to the vfo memory and any change to the vfo is not written to memory unless explicitly via a right click over the bandbutton area. Full current information is retrieved from the memory and consists of Frequency, Mode, Filter, Spectrum info and Waterfall info. The index to the current memory read location is saved on shutdown. The status bar is updated to reflect the memory read/write information and a message is displayed advising you the vfo is currently matching a retrieved memory.
===Reading from Band menu===
Please refer to main menu section "Band"[[#Setting the noise floor | Band]] TODO make this a link

== Using subRx ==
To be constructed

== The Menu choices ==

=== Receiver ===
''Connect/Disconnect''

You can connect to a server either by selecting the server in the Configure > Server list and then click Connect, or by selecting the server in the Quick Server List and click connect.

After you Disconnect from a server, you must wait at least 10 seconds for the disconnection to take full effect before connecting to another server. This is to allow the internet connection to really disconnect (remember there is network latency and the server will continue to send data till its buffers are emptied). Failure to do so will often result in error in QtRadio and may even hang QtRadio.

''Quick Server List''

If you see that a public server's status is "Busy", please '''do not''' connect to it. Doing so will disrupt the user already connected. If you see a server's status is "Idle" or "0 client(s)", you can connect to it. If you see "1 client(s)" or "2 client(s)" etc., you are sharing a connection to the same server. The first client is the master who has control over the vfo and Tx etc., and you will be connecting as a slave. You will only be able to listen to the audio and see the spectrum passively as an observer. When the clients before you disconnect, you will automatically become the master. This is a queuing mechanism.

''Configure > Audio''

If you are connecting to a public server on the Internet (ie not your own server on your LAN), '''please''' set Audio to 8000, aLaw, and 1 channel. If you use other settings, your QtRadio and/or the dspserver/server will hang.

=== Audio ===

=== Band ===
====Keypad====
Clicking on the keypad brings up a key entry window. The frequency must be entered by clicking on the number pads and should be in the form MHz dot KHz i.e. 14.293 Entering in KHz will cause an error which is not trapped yet.
====Band Selection====
The band menu allows selection of a band by clicking on the desired entry. Clicks on an already selected entry steps to the next memory position and sets the stored frequency, mode, filter and spectrum/waterfall settings.
The status line on the bottom right hand side of the window will display ... Band, Memory position, Mode, Filter and whether using memory or vfo.
====XVTR====
To Come

=== Mode ===
=== Filter ===
=== Noise Reduction ===
=== AGC ===
=== Spectrum ===
=== Hardware ===
=== Bookmarks ===

== Transmit commands ==

== Keyboard Shortcuts ==
* Arrow Left/Right Tune Down/Up the active VFO
* Arrow Up/Down Increase /Decrease Step Size above
* lowercase a = VFOA
* lowercase b = VFOB
* lowercase c = Connect
* lowercase d = Disconnect
* lowercase k= Bring up Keypad entry window
* lowercase l = Bring up Quick Connect Window
* lowercase s = toggle SubRX

== Using the Griffin Powermate USB Dial as VFO Knob ==
=== The Griffin Powermate USB DIal ===
[[File:powermate_.png|200px]]

The Griffin Powermate has a single wheel and a pushbutton, which is
able to do the following actions:

<pre>
1. Rotate Clockwise
2. Rotate Counterclockwise
3. Push Down and Rotate Clockwise
4. Push Down and Rotate Counterclockwise
5. Push Down
6. Long Push Down
7. Responisve Blue LED's
</pre>

So we have 6 possibilities to map to keystrokes, soundcard levels and so on.

In Windows you may refer to the following Document published by FlexRadio. Install the Powermate Software for Windows and map your wanted keys.

http://support.flexradio.com/Downloads.aspx?id=47

=== Download Gizmod ===

In Linux there is Gizmo Daemon - THE Linux Linux Input Device Utility.

'''You need at least Ubuntu 11.10 installed'''

Unfortunately Gizmo is no longer supported by Ubuntu and most other Linux Distributions. The last update on the Gizmo page was in 2009.

So the following Setup is experimental until we may have support for the Powermate in QtRadio or Hamlib directly.

1. Go to your preferred local git directory.
<pre>
$ git clone git://github.com/jtriley/gizmod.git
</pre>

<pre>
$ cd gizmod
</pre>

Make the following two patches:

<pre>
index 14b8d37..b61e2a1 100644
--- a/libH/Average.hpp
+++ b/libH/Average.hpp
@@ -35,6 +35,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

You may apply the above patch manually by:
<pre>
$ gedit libH/Average.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

Do the same with the following patch:

<pre>
index d794055..75f4c27 100644
--- a/libH/DynamicBuffer.hpp
+++ b/libH/DynamicBuffer.hpp
@@ -33,6 +33,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

<pre>
gedit libHDynamicBuffer.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

<pre>
$ gedit cpuusage.cpp
</pre>

add

<pre>
#include <cstring>
</pre>

<pre>
$ sudo apt-get install libboost-all-dev
$ sudo apt-get install libboost-filesystem1.46.1
$ sudo apt-get install libboost-filesystem1.46-dev
</pre>

<pre>
$ mkdir build
$ cd build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr -DSYSCONF_INSTALL_DIR=/etc ../
$ make
</pre>

If you still get an error do:

<pre>
$ gedit gizmod/CMakeFiles/gizmod.dir/link.txt
</pre>

and add:

<pre>
-lboost_system
</pre>

<pre>
$ make
$ sudo make install
</pre>

=== Setup Gizmod ===

Go to your user directory and do:
<pre>
$ mkdir -p .gizmod
</pre>

<pre>
$ cp /usr/etc/gizmod * .gizmod
</pre>

<pre>
$ mkdir .gizmod/modules.d
</pre>

<pre>
$ cp /usr/etc/gizmod/modules.d/000-CatchAllDebug.py .gizmod/modules.d/
$ cp /usr/etc/gizmod/modules.d/299-Powermate-Default.py .gizmod/modules.d/
</pre>

<pre>
$ cd .gizmod/modules.d
</pre>

<pre>
$ gedit 299-Powermate-Default.py
</pre>

Edit 299-Powermate-Default.py like this (Do not change the Filename and edit exactly)

<pre>
#***
#*********************************************************************
#*************************************************************************
#***
#*** GizmoDaemon Config Script
#*** Powermate Default config
#***
#*****************************************
#*****************************************
#***

"""

Copyright (c) 2007, Gizmo Daemon Team
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

"""

############################
# Imports
##########################

from GizmoDaemon import *
from GizmoScriptDefault import *
import time

ENABLED = True
VERSION_NEEDED = 3.2
INTERESTED_CLASSES = [GizmoEventClass.Powermate]

############################
# PowermateDefault Class definition
##########################

class PowermateDefault(GizmoScriptDefault):
"""
Default Powermate Event Mapping
"""

############################
# Public Functions
##########################

def onDeviceEvent(self, Event, Gizmo = None):
"""
Called from Base Class' onEvent method.
See GizmodDispatcher.onEvent documention for an explanation of this function
"""

# Check for rotations
if Event.Type == GizmoEventType.EV_REL:
if Gizmo.getKeyState(GizmoKey.BTN_0):
if Gizmod.DefaultMixerVolume:
Gizmod.DefaultMixerVolume.VolumePlayback = Gizmod.DefaultMixerVolume.VolumePlayback + Event.Value
else:
# scroll quickly (by pages using the page up / page down keys)
if Event.Value < 0:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_RIGHT)
else:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_LEFT)
return True
elif Event.Type == GizmoEventType.EV_KEY:
if Event.Value == 0 and not Gizmo.Rotated:
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_PLUS)
return True
return False

############################
# Private Functions
##########################

def __init__(self):
"""
Default Constructor
"""

GizmoScriptDefault.__init__(self, ENABLED, VERSION_NEEDED, INTERESTED_CLASSES)

############################
# PowermateDefault class end
##########################

# register the user script
PowermateDefault()
</pre>

<pre>
$ gizmod
</pre>

you should see the following output:(depends on your system)

<pre>
GizmoDaemon v3.4 -=- (c) 2007, Tim Burrell <tim.burrell@gmail.com>
=---------=

Registering Devices:

Standard - Directory [input]
Standard - Sleep Button [event0] vId: 0x0 pId: 0x3
Standard - Lid Switch [event1] vId: 0x0 pId: 0x5
Standard - HDA Intel Mic [event10] vId: 0x0 pId: 0x0
Standard - HDA Intel Mic [event11] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event12] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event13] vId: 0x0 pId: 0x0
Standard - Power Button [event2] vId: 0x0 pId: 0x1
Keyboard - AT Translated Set 2 keyboard [event3] vId: 0x1 pId: 0x1
Standard - Asus Laptop extra buttons [event4] vId: 0x0 pId: 0x0
Powermate - Griffin PowerMate [event5] vId: 0x77d pId: 0x410
Standard - CNF7237&CNF7238 [event6] vId: 0x17ef pId: 0x4808
Mouse - SynPS/2 Synaptics TouchPad [event7] vId: 0x2 pId: 0x7
Standard - Video Bus [event8] vId: 0x0 pId: 0x6
Standard - HDA Intel HDMI/DP,pcm=3 [event9] vId: 0x0 pId: 0x0

Loading User Scripts:

CatchAllDebug - CatchAll Event Mapping for Testing
PowermateDefault - Default Powermate Event Mapping
</pre>

You should have the following functions:

<pre>
turn left = KEY RIGHT
turn right = KEY LEFT
press and turn left = System Volume down
press and turn right = System Volume up
Buttonpress = cycle through Step Size
</pre>

QtRadio - Operation

2011-12-01T22:12:12Z

Zl2apv: /* Using Quick Memories */

=== Connecting to a server ===

== Tuning the radio ==
=== Fixed frequency radio ===
For crystal locked radios such as the softrock lite II or YU1LM sdr's It is necessary to use [[#Using subRx | subRx]]. The procedure is to set vfoA to your centre frequency, usually the crystal frequency / 4 and leave it alone as changing it will affect your centre frequency. Using the button on the vfo panel or the 'Receiver' Menu / subRx choice switch on the subRx. You can now tune within the limits of the sample rate of your sound card (48, 96 or 192 KHz).

Note that you need to start dspserver with LO offset of zero:

$ dspserver --lo 0

=== si570 tunable radio ===

In the Softrock series of hardware using sound cards, there is frequently a noise band near DC (offset 0). As such most users will set an offset of 9000 Hz (or 12000Hz etc.) using programs such as PSDR-IQ. You do the same when starting dspserver:

$ dspserver --lo 9000

=== Direct Down Conversion (DDC) radio ===

Such radios (eg. Perseus, HPSDR, usrp) do not need the offset. So start dspserver with:

$ dspserver --lo 0

== Setting the noise floor ==
The height of the spectrum from the baseline is adjusted by rolling the mouse wheel with the pointer over the level calibration markings on the extreme left hand side of the spectrum window. This will at the same time change the base colour of the waterfall.

The procedure is: After setting the [[#Calibrating the S meter | sound-card gain]] you should remove the antenna and roll the mouse-wheel to give a spectrum display line just above the bottom of the window. When you apply the antenna the spectrum will rise in the window and the waterfall base colour should be dark blue unless the band is particularly noisy.

== Calibrating the S meter ==
To calibrate the S Meter, a signal equal to S9 (-73 dBm) is injected into the sdr and the soundcard gain is adjusted until the S meter reads S9. It will then probably be necessary to adjust the spectrum [[#Setting the noise floor | noise floor]] level.

A subjective calibration may be performed by tuning into a signal considered S9 and performing the above procedure.

== VFO and Split selection ==

== Using RIT ==

== Changing bands ==

== Using Quick Memories ==
===Overview===
The quick memories are used in conjunction with the VFO memory to give quick access to storing and retrieving memories which will be used on a temporary basis. Each selected quick memory is transferred to the vfo memory and if any tune operation is made the operation shifts to the vfo and the displayed frequency of course is the operational frequency. Data held in memory or vfo is stored in the config file and is available through sessions with the last used frequency being the next start frequency. Long term memory storage should be made via the bookmarks facility.
===VFO memory===
The vfo has a memory associated with it for each band and allows startup of QtRadio to retrieve last frequency, mode, filter and spectrum/waterfall settings used. Shifting to another band allows the last used frequency etc. for that band to be retrieved and of course a return to the original band will get back the original data.
===Storing===
Storing a quick memory is accomplished by right clicking over any of the band buttons. The software will work out the right button for the frequency and store it there. The storage button will light up yellow for 1/2 second and the status bar will show ... the current band, the current read memory position and current store memory position, Mode, Filter and "stored at" store memory number. If the current frequency, mode and filter is already stored in quick memory, the memory will become the current memory and no extra storage will take place. Storage is always made to overwrite the oldest stored memory position so if your memories are stored as 0,1,2 for 3 quick memories and memory 2 was the last stored location, then memory 0 would be would be the next storage location. The index to the current memory storage location is saved on shutdown.
===Reading from Band Buttons===
A left click on the band button will cycle through the stored memories without ever overwriting them. The data in the selected memory is copied to the vfo memory and any change to the vfo is not written to memory unless explicitly via a right click over the bandbutton area. Full current information is retrieved from the memory and consists of Frequency, Mode, Filter, Spectrum info and Waterfall info. The index to the current memory read location is saved on shutdown. The status bar is updated to reflect the memory read/write information and a message is displayed advising you the vfo is currently matching a retrieved memory.
===Reading from Band menu===
Please refer to main menu section "Band" TODO make this a link

== Using subRx ==
To be constructed

== The Menu choices ==

=== Receiver ===
''Connect/Disconnect''

You can connect to a server either by selecting the server in the Configure > Server list and then click Connect, or by selecting the server in the Quick Server List and click connect.

After you Disconnect from a server, you must wait at least 10 seconds for the disconnection to take full effect before connecting to another server. This is to allow the internet connection to really disconnect (remember there is network latency and the server will continue to send data till its buffers are emptied). Failure to do so will often result in error in QtRadio and may even hang QtRadio.

''Quick Server List''

If you see that a public server's status is "Busy", please '''do not''' connect to it. Doing so will disrupt the user already connected. If you see a server's status is "Idle" or "0 client(s)", you can connect to it. If you see "1 client(s)" or "2 client(s)" etc., you are sharing a connection to the same server. The first client is the master who has control over the vfo and Tx etc., and you will be connecting as a slave. You will only be able to listen to the audio and see the spectrum passively as an observer. When the clients before you disconnect, you will automatically become the master. This is a queuing mechanism.

''Configure > Audio''

If you are connecting to a public server on the Internet (ie not your own server on your LAN), '''please''' set Audio to 8000, aLaw, and 1 channel. If you use other settings, your QtRadio and/or the dspserver/server will hang.

=== Audio ===

=== Band ===
====Keypad====
Clicking on the keypad brings up a key entry window. The frequency must be entered by clicking on the number pads and should be in the form MHz dot KHz i.e. 14.293 Entering in KHz will cause an error which is not trapped yet.
====Band Selection====
The band menu allows selection of a band by clicking on the desired entry. Clicks on an already selected entry steps to the next memory position and sets the stored frequency, mode, filter and spectrum/waterfall settings.
The status line on the bottom right hand side of the window will display ... Band, Memory position, Mode, Filter and whether using memory or vfo.
====XVTR====
To Come

=== Mode ===
=== Filter ===
=== Noise Reduction ===
=== AGC ===
=== Spectrum ===
=== Hardware ===
=== Bookmarks ===

== Transmit commands ==

== Keyboard Shortcuts ==
* Arrow Left/Right Tune Down/Up the active VFO
* Arrow Up/Down Increase /Decrease Step Size above
* lowercase a = VFOA
* lowercase b = VFOB
* lowercase c = Connect
* lowercase d = Disconnect
* lowercase k= Bring up Keypad entry window
* lowercase l = Bring up Quick Connect Window
* lowercase s = toggle SubRX

== Using the Griffin Powermate USB Dial as VFO Knob ==
=== The Griffin Powermate USB DIal ===
[[File:powermate_.png|200px]]

The Griffin Powermate has a single wheel and a pushbutton, which is
able to do the following actions:

<pre>
1. Rotate Clockwise
2. Rotate Counterclockwise
3. Push Down and Rotate Clockwise
4. Push Down and Rotate Counterclockwise
5. Push Down
6. Long Push Down
7. Responisve Blue LED's
</pre>

So we have 6 possibilities to map to keystrokes, soundcard levels and so on.

In Windows you may refer to the following Document published by FlexRadio. Install the Powermate Software for Windows and map your wanted keys.

http://support.flexradio.com/Downloads.aspx?id=47

=== Download Gizmod ===

In Linux there is Gizmo Daemon - THE Linux Linux Input Device Utility.

'''You need at least Ubuntu 11.10 installed'''

Unfortunately Gizmo is no longer supported by Ubuntu and most other Linux Distributions. The last update on the Gizmo page was in 2009.

So the following Setup is experimental until we may have support for the Powermate in QtRadio or Hamlib directly.

1. Go to your preferred local git directory.
<pre>
$ git clone git://github.com/jtriley/gizmod.git
</pre>

<pre>
$ cd gizmod
</pre>

Make the following two patches:

<pre>
index 14b8d37..b61e2a1 100644
--- a/libH/Average.hpp
+++ b/libH/Average.hpp
@@ -35,6 +35,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

You may apply the above patch manually by:
<pre>
$ gedit libH/Average.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

Do the same with the following patch:

<pre>
index d794055..75f4c27 100644
--- a/libH/DynamicBuffer.hpp
+++ b/libH/DynamicBuffer.hpp
@@ -33,6 +33,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

<pre>
gedit libHDynamicBuffer.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

<pre>
$ gedit cpuusage.cpp
</pre>

add

<pre>
#include <cstring>
</pre>

<pre>
$ sudo apt-get install libboost-all-dev
$ sudo apt-get install libboost-filesystem1.46.1
$ sudo apt-get install libboost-filesystem1.46-dev
</pre>

<pre>
$ mkdir build
$ cd build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr -DSYSCONF_INSTALL_DIR=/etc ../
$ make
</pre>

If you still get an error do:

<pre>
$ gedit gizmod/CMakeFiles/gizmod.dir/link.txt
</pre>

and add:

<pre>
-lboost_system
</pre>

<pre>
$ make
$ sudo make install
</pre>

=== Setup Gizmod ===

Go to your user directory and do:
<pre>
$ mkdir -p .gizmod
</pre>

<pre>
$ cp /usr/etc/gizmod * .gizmod
</pre>

<pre>
$ mkdir .gizmod/modules.d
</pre>

<pre>
$ cp /usr/etc/gizmod/modules.d/000-CatchAllDebug.py .gizmod/modules.d/
$ cp /usr/etc/gizmod/modules.d/299-Powermate-Default.py .gizmod/modules.d/
</pre>

<pre>
$ cd .gizmod/modules.d
</pre>

<pre>
$ gedit 299-Powermate-Default.py
</pre>

Edit 299-Powermate-Default.py like this (Do not change the Filename and edit exactly)

<pre>
#***
#*********************************************************************
#*************************************************************************
#***
#*** GizmoDaemon Config Script
#*** Powermate Default config
#***
#*****************************************
#*****************************************
#***

"""

Copyright (c) 2007, Gizmo Daemon Team
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

"""

############################
# Imports
##########################

from GizmoDaemon import *
from GizmoScriptDefault import *
import time

ENABLED = True
VERSION_NEEDED = 3.2
INTERESTED_CLASSES = [GizmoEventClass.Powermate]

############################
# PowermateDefault Class definition
##########################

class PowermateDefault(GizmoScriptDefault):
"""
Default Powermate Event Mapping
"""

############################
# Public Functions
##########################

def onDeviceEvent(self, Event, Gizmo = None):
"""
Called from Base Class' onEvent method.
See GizmodDispatcher.onEvent documention for an explanation of this function
"""

# Check for rotations
if Event.Type == GizmoEventType.EV_REL:
if Gizmo.getKeyState(GizmoKey.BTN_0):
if Gizmod.DefaultMixerVolume:
Gizmod.DefaultMixerVolume.VolumePlayback = Gizmod.DefaultMixerVolume.VolumePlayback + Event.Value
else:
# scroll quickly (by pages using the page up / page down keys)
if Event.Value < 0:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_RIGHT)
else:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_LEFT)
return True
elif Event.Type == GizmoEventType.EV_KEY:
if Event.Value == 0 and not Gizmo.Rotated:
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_PLUS)
return True
return False

############################
# Private Functions
##########################

def __init__(self):
"""
Default Constructor
"""

GizmoScriptDefault.__init__(self, ENABLED, VERSION_NEEDED, INTERESTED_CLASSES)

############################
# PowermateDefault class end
##########################

# register the user script
PowermateDefault()
</pre>

<pre>
$ gizmod
</pre>

you should see the following output:(depends on your system)

<pre>
GizmoDaemon v3.4 -=- (c) 2007, Tim Burrell <tim.burrell@gmail.com>
=---------=

Registering Devices:

Standard - Directory [input]
Standard - Sleep Button [event0] vId: 0x0 pId: 0x3
Standard - Lid Switch [event1] vId: 0x0 pId: 0x5
Standard - HDA Intel Mic [event10] vId: 0x0 pId: 0x0
Standard - HDA Intel Mic [event11] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event12] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event13] vId: 0x0 pId: 0x0
Standard - Power Button [event2] vId: 0x0 pId: 0x1
Keyboard - AT Translated Set 2 keyboard [event3] vId: 0x1 pId: 0x1
Standard - Asus Laptop extra buttons [event4] vId: 0x0 pId: 0x0
Powermate - Griffin PowerMate [event5] vId: 0x77d pId: 0x410
Standard - CNF7237&CNF7238 [event6] vId: 0x17ef pId: 0x4808
Mouse - SynPS/2 Synaptics TouchPad [event7] vId: 0x2 pId: 0x7
Standard - Video Bus [event8] vId: 0x0 pId: 0x6
Standard - HDA Intel HDMI/DP,pcm=3 [event9] vId: 0x0 pId: 0x0

Loading User Scripts:

CatchAllDebug - CatchAll Event Mapping for Testing
PowermateDefault - Default Powermate Event Mapping
</pre>

You should have the following functions:

<pre>
turn left = KEY RIGHT
turn right = KEY LEFT
press and turn left = System Volume down
press and turn right = System Volume up
Buttonpress = cycle through Step Size
</pre>

QtRadio - Operation

2011-12-01T07:34:52Z

Zl2apv: /* =Reading from Band menu */

=== Connecting to a server ===

== Tuning the radio ==
=== Fixed frequency radio ===
For crystal locked radios such as the softrock lite II or YU1LM sdr's It is necessary to use [[#Using subRx | subRx]]. The procedure is to set vfoA to your centre frequency, usually the crystal frequency / 4 and leave it alone as changing it will affect your centre frequency. Using the button on the vfo panel or the 'Receiver' Menu / subRx choice switch on the subRx. You can now tune within the limits of the sample rate of your sound card (48, 96 or 192 KHz).

Note that you need to start dspserver with LO offset of zero:

$ dspserver --lo 0

=== si570 tunable radio ===

In the Softrock series of hardware using sound cards, there is frequently a noise band near DC (offset 0). As such most users will set an offset of 9000 Hz (or 12000Hz etc.) using programs such as PSDR-IQ. You do the same when starting dspserver:

$ dspserver --lo 9000

=== Direct Down Conversion (DDC) radio ===

Such radios (eg. Perseus, HPSDR, usrp) do not need the offset. So start dspserver with:

$ dspserver --lo 0

== Setting the noise floor ==
The height of the spectrum from the baseline is adjusted by rolling the mouse wheel with the pointer over the level calibration markings on the extreme left hand side of the spectrum window. This will at the same time change the base colour of the waterfall.

The procedure is: After setting the [[#Calibrating the S meter | sound-card gain]] you should remove the antenna and roll the mouse-wheel to give a spectrum display line just above the bottom of the window. When you apply the antenna the spectrum will rise in the window and the waterfall base colour should be dark blue unless the band is particularly noisy.

== Calibrating the S meter ==
To calibrate the S Meter, a signal equal to S9 (-73 dBm) is injected into the sdr and the soundcard gain is adjusted until the S meter reads S9. It will then probably be necessary to adjust the spectrum [[#Setting the noise floor | noise floor]] level.

A subjective calibration may be performed by tuning into a signal considered S9 and performing the above procedure.

== VFO and Split selection ==

== Using RIT ==

== Changing bands ==

== Using Quick Memories ==
===Overview===
The quick memories are used in conjunction with the VFO memory to give quick access to storing and retrieving memories which will be used on a temporary basis. Each selected quick memory is transferred to the vfo memory and if any tune operation is made the operation shifts to the vfo and the displayed frequency of course is the operational frequency. Data held in memory or vfo is stored in the config file and is available through sessions with the last used frequency being the next start frequency. Long term memory storage should be made via the bookmarks facility.
===VFO memory===
The vfo has a memory associated with it for each band and allows startup of QtRadio to retrieve last frequency, mode, filter and spectrum/waterfall settings. Shifting to another band allows the last used frequency etc. for that band to be retrieved and of course a return to the original band will get back the original data.
===Storing===
Storing a quick memory is accomplished by right clicking over any of the band buttons. The software will work out the right button for the frequency and store it there. The storage button will light up yellow for 1/2 second and the status bar will show ... the current band, the current memory position, Mode, Filter and "stored at" store memory number.If the current frequency, mode and filter is already stored in quick memory, the memory will become the current memory and no extra storage will take place. Storage is always made to overwrite the oldest stored memory position so if your memories are stored as 0,1,2 for 3 quick memories and memory 2 was the last stored then memory then it would be would be the next storage location. The index to the current memory storage location is saved on shutdown.
===Reading from Band Buttons===
A left click on the band button will cycle through the stored memories without ever overwriting them. The data in the selected memory is copied to the vfo memory and any change to the vfo is not written to memory unless explicitly via a right click over the bandbutton area. Full current information is retrieved from the memory and consists of Frequency, Mode, Filter, Spectrum info and Waterfall info. The index to the current memory read location is saved on shutdown.
===Reading from Band menu===
Please refer to main menu section "Band" TODO make this a link

== Using subRx ==
To be constructed

== The Menu choices ==

=== Receiver ===
''Connect/Disconnect''

You can connect to a server either by selecting the server in the Configure > Server list and then click Connect, or by selecting the server in the Quick Server List and click connect.

After you Disconnect from a server, you must wait at least 10 seconds for the disconnection to take full effect before connecting to another server. This is to allow the internet connection to really disconnect (remember there is network latency and the server will continue to send data till its buffers are emptied). Failure to do so will often result in error in QtRadio and may even hang QtRadio.

''Quick Server List''

If you see that a public server's status is "Busy", please '''do not''' connect to it. Doing so will disrupt the user already connected. If you see a server's status is "Idle" or "0 client(s)", you can connect to it. If you see "1 client(s)" or "2 client(s)" etc., you are sharing a connection to the same server. The first client is the master who has control over the vfo and Tx etc., and you will be connecting as a slave. You will only be able to listen to the audio and see the spectrum passively as an observer. When the clients before you disconnect, you will automatically become the master. This is a queuing mechanism.

''Configure > Audio''

If you are connecting to a public server on the Internet (ie not your own server on your LAN), '''please''' set Audio to 8000, aLaw, and 1 channel. If you use other settings, your QtRadio and/or the dspserver/server will hang.

=== Audio ===

=== Band ===
====Keypad====
Clicking on the keypad brings up a key entry window. The frequency must be entered by clicking on the number pads and should be in the form MHz dot KHz i.e. 14.293 Entering in KHz will cause an error which is not trapped yet.
====Band Selection====
The band menu allows selection of a band by clicking on the desired entry. Clicks on an already selected entry steps to the next memory position and sets the stored frequency, mode, filter and spectrum/waterfall settings.
The status line on the bottom right hand side of the window will display ... Band, Memory position, Mode, Filter and whether using memory or vfo.
====XVTR====
To Come

=== Mode ===
=== Filter ===
=== Noise Reduction ===
=== AGC ===
=== Spectrum ===
=== Hardware ===
=== Bookmarks ===

== Transmit commands ==

== Keyboard Shortcuts ==
* Arrow Left/Right Tune Down/Up the active VFO
* Arrow Up/Down Increase /Decrease Step Size above
* lowercase a = VFOA
* lowercase b = VFOB
* lowercase c = Connect
* lowercase d = Disconnect
* lowercase k= Bring up Keypad entry window
* lowercase l = Bring up Quick Connect Window
* lowercase s = toggle SubRX

== Using the Griffin Powermate USB Dial as VFO Knob ==
=== The Griffin Powermate USB DIal ===
[[File:powermate_.png|200px]]

The Griffin Powermate has a single wheel and a pushbutton, which is
able to do the following actions:

<pre>
1. Rotate Clockwise
2. Rotate Counterclockwise
3. Push Down and Rotate Clockwise
4. Push Down and Rotate Counterclockwise
5. Push Down
6. Long Push Down
7. Responisve Blue LED's
</pre>

So we have 6 possibilities to map to keystrokes, soundcard levels and so on.

In Windows you may refer to the following Document published by FlexRadio. Install the Powermate Software for Windows and map your wanted keys.

http://support.flexradio.com/Downloads.aspx?id=47

=== Download Gizmod ===

In Linux there is Gizmo Daemon - THE Linux Linux Input Device Utility.

Unfortunately Gizmo is no longer supported by Ubuntu and most other Linux Distributions. The last update on the Gizmo page was in 2009.

So the following Setup is experimental until we may have support for the Powermate in QtRadio or Hamlib directly.

1. Go to your preferred local git directory.
<pre>
$ git clone git://github.com/jtriley/gizmod.git
</pre>

<pre>
$ cd gizmod
</pre>

Make the following two patches:

<pre>
index 14b8d37..b61e2a1 100644
--- a/libH/Average.hpp
+++ b/libH/Average.hpp
@@ -35,6 +35,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

You may apply the above patch manually by:
<pre>
$ gedit libH/Average.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

Do the same with the following patch:

<pre>
index d794055..75f4c27 100644
--- a/libH/DynamicBuffer.hpp
+++ b/libH/DynamicBuffer.hpp
@@ -33,6 +33,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

<pre>
gedit libHDynamicBuffer.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

<pre>
$ gedit cpuusage.cpp
</pre>

add

<pre>
#include <cstring>
</pre>

<pre>
$ sudo apt-get install libboost-all-dev
</pre>

<pre>
$ mkdir build
$ cd build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr -DSYSCONF_INSTALL_DIR=/etc ..
$ make
</pre>

If you still get an error do:

<pre>
$ gedit gizmod/CMakeFiles/gizmod.dir/link.txt
</pre>

and add:

<pre>
-lboost_system
</pre>

<pre>
$ make
$ sudo make install
</pre>

=== Setup Gizmod ===

Go to your user directory and do:
<pre>
$ mkdir -p .gizmod
</pre>

<pre>
$ cp /usr/etc/gizmod * .gizmod
</pre>

<pre>
$ mkdir .gizmod/modules.d
</pre>

<pre>
$ cp /usr/etc/gizmod/modules.d/000-CatchAllDebug.py .gizmod/modules.d/
$ cp /usr/etc/gizmod/modules.d/299-Powermate-Default.py .gizmod/modules.d/
</pre>

<pre>
$ cd .gizmod/modules.d
</pre>

<pre>
$ gedit 299-Powermate-Default.py
</pre>

Edit 299-Powermate-Default.py like this (Do not change the Filename and edit exactly)

<pre>
#***
#*********************************************************************
#*************************************************************************
#***
#*** GizmoDaemon Config Script
#*** Powermate Default config
#***
#*****************************************
#*****************************************
#***

"""

Copyright (c) 2007, Gizmo Daemon Team
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

"""

############################
# Imports
##########################

from GizmoDaemon import *
from GizmoScriptDefault import *
import time

ENABLED = True
VERSION_NEEDED = 3.2
INTERESTED_CLASSES = [GizmoEventClass.Powermate]

############################
# PowermateDefault Class definition
##########################

class PowermateDefault(GizmoScriptDefault):
"""
Default Powermate Event Mapping
"""

############################
# Public Functions
##########################

def onDeviceEvent(self, Event, Gizmo = None):
"""
Called from Base Class' onEvent method.
See GizmodDispatcher.onEvent documention for an explanation of this function
"""

# Check for rotations
if Event.Type == GizmoEventType.EV_REL:
if Gizmo.getKeyState(GizmoKey.BTN_0):
if Gizmod.DefaultMixerVolume:
Gizmod.DefaultMixerVolume.VolumePlayback = Gizmod.DefaultMixerVolume.VolumePlayback + Event.Value
else:
# scroll quickly (by pages using the page up / page down keys)
if Event.Value < 0:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_RIGHT)
else:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_LEFT)
return True
elif Event.Type == GizmoEventType.EV_KEY:
if Event.Value == 0 and not Gizmo.Rotated:
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_PLUS)
return True
return False

############################
# Private Functions
##########################

def __init__(self):
"""
Default Constructor
"""

GizmoScriptDefault.__init__(self, ENABLED, VERSION_NEEDED, INTERESTED_CLASSES)

############################
# PowermateDefault class end
##########################

# register the user script
PowermateDefault()
</pre>

<pre>
$ gizmod
</pre>

you should see the following output:(depends on your system)

<pre>
GizmoDaemon v3.4 -=- (c) 2007, Tim Burrell <tim.burrell@gmail.com>
=---------=

Registering Devices:

Standard - Directory [input]
Standard - Sleep Button [event0] vId: 0x0 pId: 0x3
Standard - Lid Switch [event1] vId: 0x0 pId: 0x5
Standard - HDA Intel Mic [event10] vId: 0x0 pId: 0x0
Standard - HDA Intel Mic [event11] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event12] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event13] vId: 0x0 pId: 0x0
Standard - Power Button [event2] vId: 0x0 pId: 0x1
Keyboard - AT Translated Set 2 keyboard [event3] vId: 0x1 pId: 0x1
Standard - Asus Laptop extra buttons [event4] vId: 0x0 pId: 0x0
Powermate - Griffin PowerMate [event5] vId: 0x77d pId: 0x410
Standard - CNF7237&CNF7238 [event6] vId: 0x17ef pId: 0x4808
Mouse - SynPS/2 Synaptics TouchPad [event7] vId: 0x2 pId: 0x7
Standard - Video Bus [event8] vId: 0x0 pId: 0x6
Standard - HDA Intel HDMI/DP,pcm=3 [event9] vId: 0x0 pId: 0x0

Loading User Scripts:

CatchAllDebug - CatchAll Event Mapping for Testing
PowermateDefault - Default Powermate Event Mapping
</pre>

You should have the following functions:

<pre>
turn left = KEY RIGHT
turn right = KEY LEFT
press and turn left = System Volume down
press and turn right = System Volume up
Buttonpress = cycle through Step Size
</pre>

QtRadio - Operation

2011-12-01T07:33:43Z

Zl2apv: /* Using Quick Memories */

=== Connecting to a server ===

== Tuning the radio ==
=== Fixed frequency radio ===
For crystal locked radios such as the softrock lite II or YU1LM sdr's It is necessary to use [[#Using subRx | subRx]]. The procedure is to set vfoA to your centre frequency, usually the crystal frequency / 4 and leave it alone as changing it will affect your centre frequency. Using the button on the vfo panel or the 'Receiver' Menu / subRx choice switch on the subRx. You can now tune within the limits of the sample rate of your sound card (48, 96 or 192 KHz).

Note that you need to start dspserver with LO offset of zero:

$ dspserver --lo 0

=== si570 tunable radio ===

In the Softrock series of hardware using sound cards, there is frequently a noise band near DC (offset 0). As such most users will set an offset of 9000 Hz (or 12000Hz etc.) using programs such as PSDR-IQ. You do the same when starting dspserver:

$ dspserver --lo 9000

=== Direct Down Conversion (DDC) radio ===

Such radios (eg. Perseus, HPSDR, usrp) do not need the offset. So start dspserver with:

$ dspserver --lo 0

== Setting the noise floor ==
The height of the spectrum from the baseline is adjusted by rolling the mouse wheel with the pointer over the level calibration markings on the extreme left hand side of the spectrum window. This will at the same time change the base colour of the waterfall.

The procedure is: After setting the [[#Calibrating the S meter | sound-card gain]] you should remove the antenna and roll the mouse-wheel to give a spectrum display line just above the bottom of the window. When you apply the antenna the spectrum will rise in the window and the waterfall base colour should be dark blue unless the band is particularly noisy.

== Calibrating the S meter ==
To calibrate the S Meter, a signal equal to S9 (-73 dBm) is injected into the sdr and the soundcard gain is adjusted until the S meter reads S9. It will then probably be necessary to adjust the spectrum [[#Setting the noise floor | noise floor]] level.

A subjective calibration may be performed by tuning into a signal considered S9 and performing the above procedure.

== VFO and Split selection ==

== Using RIT ==

== Changing bands ==

== Using Quick Memories ==
===Overview===
The quick memories are used in conjunction with the VFO memory to give quick access to storing and retrieving memories which will be used on a temporary basis. Each selected quick memory is transferred to the vfo memory and if any tune operation is made the operation shifts to the vfo and the displayed frequency of course is the operational frequency. Data held in memory or vfo is stored in the config file and is available through sessions with the last used frequency being the next start frequency. Long term memory storage should be made via the bookmarks facility.
===VFO memory===
The vfo has a memory associated with it for each band and allows startup of QtRadio to retrieve last frequency, mode, filter and spectrum/waterfall settings. Shifting to another band allows the last used frequency etc. for that band to be retrieved and of course a return to the original band will get back the original data.
===Storing===
Storing a quick memory is accomplished by right clicking over any of the band buttons. The software will work out the right button for the frequency and store it there. The storage button will light up yellow for 1/2 second and the status bar will show ... the current band, the current memory position, Mode, Filter and "stored at" store memory number.If the current frequency, mode and filter is already stored in quick memory, the memory will become the current memory and no extra storage will take place. Storage is always made to overwrite the oldest stored memory position so if your memories are stored as 0,1,2 for 3 quick memories and memory 2 was the last stored then memory then it would be would be the next storage location. The index to the current memory storage location is saved on shutdown.
===Reading from Band Buttons===
A left click on the band button will cycle through the stored memories without ever overwriting them. The data in the selected memory is copied to the vfo memory and any change to the vfo is not written to memory unless explicitly via a right click over the bandbutton area. Full current information is retrieved from the memory and consists of Frequency, Mode, Filter, Spectrum info and Waterfall info. The index to the current memory read location is saved on shutdown.
===Reading from Band menu==
Please refer to main menu section "Band" TODO make this a link

== Using subRx ==
To be constructed

== The Menu choices ==

=== Receiver ===
''Connect/Disconnect''

You can connect to a server either by selecting the server in the Configure > Server list and then click Connect, or by selecting the server in the Quick Server List and click connect.

After you Disconnect from a server, you must wait at least 10 seconds for the disconnection to take full effect before connecting to another server. This is to allow the internet connection to really disconnect (remember there is network latency and the server will continue to send data till its buffers are emptied). Failure to do so will often result in error in QtRadio and may even hang QtRadio.

''Quick Server List''

If you see that a public server's status is "Busy", please '''do not''' connect to it. Doing so will disrupt the user already connected. If you see a server's status is "Idle" or "0 client(s)", you can connect to it. If you see "1 client(s)" or "2 client(s)" etc., you are sharing a connection to the same server. The first client is the master who has control over the vfo and Tx etc., and you will be connecting as a slave. You will only be able to listen to the audio and see the spectrum passively as an observer. When the clients before you disconnect, you will automatically become the master. This is a queuing mechanism.

''Configure > Audio''

If you are connecting to a public server on the Internet (ie not your own server on your LAN), '''please''' set Audio to 8000, aLaw, and 1 channel. If you use other settings, your QtRadio and/or the dspserver/server will hang.

=== Audio ===

=== Band ===
====Keypad====
Clicking on the keypad brings up a key entry window. The frequency must be entered by clicking on the number pads and should be in the form MHz dot KHz i.e. 14.293 Entering in KHz will cause an error which is not trapped yet.
====Band Selection====
The band menu allows selection of a band by clicking on the desired entry. Clicks on an already selected entry steps to the next memory position and sets the stored frequency, mode, filter and spectrum/waterfall settings.
The status line on the bottom right hand side of the window will display ... Band, Memory position, Mode, Filter and whether using memory or vfo.
====XVTR====
To Come

=== Mode ===
=== Filter ===
=== Noise Reduction ===
=== AGC ===
=== Spectrum ===
=== Hardware ===
=== Bookmarks ===

== Transmit commands ==

== Keyboard Shortcuts ==
* Arrow Left/Right Tune Down/Up the active VFO
* Arrow Up/Down Increase /Decrease Step Size above
* lowercase a = VFOA
* lowercase b = VFOB
* lowercase c = Connect
* lowercase d = Disconnect
* lowercase k= Bring up Keypad entry window
* lowercase l = Bring up Quick Connect Window
* lowercase s = toggle SubRX

== Using the Griffin Powermate USB Dial as VFO Knob ==
=== The Griffin Powermate USB DIal ===
[[File:powermate_.png|200px]]

The Griffin Powermate has a single wheel and a pushbutton, which is
able to do the following actions:

<pre>
1. Rotate Clockwise
2. Rotate Counterclockwise
3. Push Down and Rotate Clockwise
4. Push Down and Rotate Counterclockwise
5. Push Down
6. Long Push Down
7. Responisve Blue LED's
</pre>

So we have 6 possibilities to map to keystrokes, soundcard levels and so on.

In Windows you may refer to the following Document published by FlexRadio. Install the Powermate Software for Windows and map your wanted keys.

http://support.flexradio.com/Downloads.aspx?id=47

=== Download Gizmod ===

In Linux there is Gizmo Daemon - THE Linux Linux Input Device Utility.

Unfortunately Gizmo is no longer supported by Ubuntu and most other Linux Distributions. The last update on the Gizmo page was in 2009.

So the following Setup is experimental until we may have support for the Powermate in QtRadio or Hamlib directly.

1. Go to your preferred local git directory.
<pre>
$ git clone git://github.com/jtriley/gizmod.git
</pre>

<pre>
$ cd gizmod
</pre>

Make the following two patches:

<pre>
index 14b8d37..b61e2a1 100644
--- a/libH/Average.hpp
+++ b/libH/Average.hpp
@@ -35,6 +35,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

You may apply the above patch manually by:
<pre>
$ gedit libH/Average.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

Do the same with the following patch:

<pre>
index d794055..75f4c27 100644
--- a/libH/DynamicBuffer.hpp
+++ b/libH/DynamicBuffer.hpp
@@ -33,6 +33,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

<pre>
gedit libHDynamicBuffer.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

<pre>
$ gedit cpuusage.cpp
</pre>

add

<pre>
#include <cstring>
</pre>

<pre>
$ sudo apt-get install libboost-all-dev
</pre>

<pre>
$ mkdir build
$ cd build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr -DSYSCONF_INSTALL_DIR=/etc ..
$ make
</pre>

If you still get an error do:

<pre>
$ gedit gizmod/CMakeFiles/gizmod.dir/link.txt
</pre>

and add:

<pre>
-lboost_system
</pre>

<pre>
$ make
$ sudo make install
</pre>

=== Setup Gizmod ===

Go to your user directory and do:
<pre>
$ mkdir -p .gizmod
</pre>

<pre>
$ cp /usr/etc/gizmod * .gizmod
</pre>

<pre>
$ mkdir .gizmod/modules.d
</pre>

<pre>
$ cp /usr/etc/gizmod/modules.d/000-CatchAllDebug.py .gizmod/modules.d/
$ cp /usr/etc/gizmod/modules.d/299-Powermate-Default.py .gizmod/modules.d/
</pre>

<pre>
$ cd .gizmod/modules.d
</pre>

<pre>
$ gedit 299-Powermate-Default.py
</pre>

Edit 299-Powermate-Default.py like this (Do not change the Filename and edit exactly)

<pre>
#***
#*********************************************************************
#*************************************************************************
#***
#*** GizmoDaemon Config Script
#*** Powermate Default config
#***
#*****************************************
#*****************************************
#***

"""

Copyright (c) 2007, Gizmo Daemon Team
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

"""

############################
# Imports
##########################

from GizmoDaemon import *
from GizmoScriptDefault import *
import time

ENABLED = True
VERSION_NEEDED = 3.2
INTERESTED_CLASSES = [GizmoEventClass.Powermate]

############################
# PowermateDefault Class definition
##########################

class PowermateDefault(GizmoScriptDefault):
"""
Default Powermate Event Mapping
"""

############################
# Public Functions
##########################

def onDeviceEvent(self, Event, Gizmo = None):
"""
Called from Base Class' onEvent method.
See GizmodDispatcher.onEvent documention for an explanation of this function
"""

# Check for rotations
if Event.Type == GizmoEventType.EV_REL:
if Gizmo.getKeyState(GizmoKey.BTN_0):
if Gizmod.DefaultMixerVolume:
Gizmod.DefaultMixerVolume.VolumePlayback = Gizmod.DefaultMixerVolume.VolumePlayback + Event.Value
else:
# scroll quickly (by pages using the page up / page down keys)
if Event.Value < 0:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_RIGHT)
else:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_LEFT)
return True
elif Event.Type == GizmoEventType.EV_KEY:
if Event.Value == 0 and not Gizmo.Rotated:
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_PLUS)
return True
return False

############################
# Private Functions
##########################

def __init__(self):
"""
Default Constructor
"""

GizmoScriptDefault.__init__(self, ENABLED, VERSION_NEEDED, INTERESTED_CLASSES)

############################
# PowermateDefault class end
##########################

# register the user script
PowermateDefault()
</pre>

<pre>
$ gizmod
</pre>

you should see the following output:(depends on your system)

<pre>
GizmoDaemon v3.4 -=- (c) 2007, Tim Burrell <tim.burrell@gmail.com>
=---------=

Registering Devices:

Standard - Directory [input]
Standard - Sleep Button [event0] vId: 0x0 pId: 0x3
Standard - Lid Switch [event1] vId: 0x0 pId: 0x5
Standard - HDA Intel Mic [event10] vId: 0x0 pId: 0x0
Standard - HDA Intel Mic [event11] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event12] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event13] vId: 0x0 pId: 0x0
Standard - Power Button [event2] vId: 0x0 pId: 0x1
Keyboard - AT Translated Set 2 keyboard [event3] vId: 0x1 pId: 0x1
Standard - Asus Laptop extra buttons [event4] vId: 0x0 pId: 0x0
Powermate - Griffin PowerMate [event5] vId: 0x77d pId: 0x410
Standard - CNF7237&CNF7238 [event6] vId: 0x17ef pId: 0x4808
Mouse - SynPS/2 Synaptics TouchPad [event7] vId: 0x2 pId: 0x7
Standard - Video Bus [event8] vId: 0x0 pId: 0x6
Standard - HDA Intel HDMI/DP,pcm=3 [event9] vId: 0x0 pId: 0x0

Loading User Scripts:

CatchAllDebug - CatchAll Event Mapping for Testing
PowermateDefault - Default Powermate Event Mapping
</pre>

You should have the following functions:

<pre>
turn left = KEY RIGHT
turn right = KEY LEFT
press and turn left = System Volume down
press and turn right = System Volume up
Buttonpress = cycle through Step Size
</pre>

QtRadio - Operation

2011-12-01T06:57:25Z

Zl2apv: /* Band */

=== Connecting to a server ===

== Tuning the radio ==
=== Fixed frequency radio ===
For crystal locked radios such as the softrock lite II or YU1LM sdr's It is necessary to use [[#Using subRx | subRx]]. The procedure is to set vfoA to your centre frequency, usually the crystal frequency / 4 and leave it alone as changing it will affect your centre frequency. Using the button on the vfo panel or the 'Receiver' Menu / subRx choice switch on the subRx. You can now tune within the limits of the sample rate of your sound card (48, 96 or 192 KHz).

Note that you need to start dspserver with LO offset of zero:

$ dspserver --lo 0

=== si570 tunable radio ===

In the Softrock series of hardware using sound cards, there is frequently a noise band near DC (offset 0). As such most users will set an offset of 9000 Hz (or 12000Hz etc.) using programs such as PSDR-IQ. You do the same when starting dspserver:

$ dspserver --lo 9000

=== Direct Down Conversion (DDC) radio ===

Such radios (eg. Perseus, HPSDR, usrp) do not need the offset. So start dspserver with:

$ dspserver --lo 0

== Setting the noise floor ==
The height of the spectrum from the baseline is adjusted by rolling the mouse wheel with the pointer over the level calibration markings on the extreme left hand side of the spectrum window. This will at the same time change the base colour of the waterfall.

The procedure is: After setting the [[#Calibrating the S meter | sound-card gain]] you should remove the antenna and roll the mouse-wheel to give a spectrum display line just above the bottom of the window. When you apply the antenna the spectrum will rise in the window and the waterfall base colour should be dark blue unless the band is particularly noisy.

== Calibrating the S meter ==
To calibrate the S Meter, a signal equal to S9 (-73 dBm) is injected into the sdr and the soundcard gain is adjusted until the S meter reads S9. It will then probably be necessary to adjust the spectrum [[#Setting the noise floor | noise floor]] level.

A subjective calibration may be performed by tuning into a signal considered S9 and performing the above procedure.

== VFO and Split selection ==

== Using RIT ==

== Changing bands ==

== Using Quick Memories ==

== Using subRx ==
To be constructed

== The Menu choices ==

=== Receiver ===
''Connect/Disconnect''

You can connect to a server either by selecting the server in the Configure > Server list and then click Connect, or by selecting the server in the Quick Server List and click connect.

After you Disconnect from a server, you must wait at least 10 seconds for the disconnection to take full effect before connecting to another server. This is to allow the internet connection to really disconnect (remember there is network latency and the server will continue to send data till its buffers are emptied). Failure to do so will often result in error in QtRadio and may even hang QtRadio.

''Quick Server List''

If you see that a public server's status is "Busy", please '''do not''' connect to it. Doing so will disrupt the user already connected. If you see a server's status is "Idle" or "0 client(s)", you can connect to it. If you see "1 client(s)" or "2 client(s)" etc., you are sharing a connection to the same server. The first client is the master who has control over the vfo and Tx etc., and you will be connecting as a slave. You will only be able to listen to the audio and see the spectrum passively as an observer. When the clients before you disconnect, you will automatically become the master. This is a queuing mechanism.

''Configure > Audio''

If you are connecting to a public server on the Internet (ie not your own server on your LAN), '''please''' set Audio to 8000, aLaw, and 1 channel. If you use other settings, your QtRadio and/or the dspserver/server will hang.

=== Audio ===

=== Band ===
====Keypad====
Clicking on the keypad brings up a key entry window. The frequency must be entered by clicking on the number pads and should be in the form MHz dot KHz i.e. 14.293 Entering in KHz will cause an error which is not trapped yet.
====Band Selection====
The band menu allows selection of a band by clicking on the desired entry. Clicks on an already selected entry steps to the next memory position and sets the stored frequency, mode, filter and spectrum/waterfall settings.
The status line on the bottom right hand side of the window will display ... Band, Memory position, Mode, Filter and whether using memory or vfo.
====XVTR====
To Come

=== Mode ===
=== Filter ===
=== Noise Reduction ===
=== AGC ===
=== Spectrum ===
=== Hardware ===
=== Bookmarks ===

== Transmit commands ==

== Keyboard Shortcuts ==
* Arrow Left/Right Tune Down/Up the active VFO
* Arrow Up/Down Increase /Decrease Step Size above
* lowercase a = VFOA
* lowercase b = VFOB
* lowercase c = Connect
* lowercase d = Disconnect
* lowercase k= Bring up Keypad entry window
* lowercase l = Bring up Quick Connect Window
* lowercase s = toggle SubRX

== Using the Griffin Powermate USB Dial as VFO Knob ==
=== The Griffin Powermate USB DIal ===
[[File:powermate_.png|200px]]

The Griffin Powermate has a single wheel and a pushbutton, which is
able to do the following actions:

<pre>
1. Rotate Clockwise
2. Rotate Counterclockwise
3. Push Down and Rotate Clockwise
4. Push Down and Rotate Counterclockwise
5. Push Down
6. Long Push Down
7. Responisve Blue LED's
</pre>

So we have 6 possibilities to map to keystrokes, soundcard levels and so on.

In Windows you may refer to the following Document published by FlexRadio. Install the Powermate Software for Windows and map your wanted keys.

http://support.flexradio.com/Downloads.aspx?id=47

=== Download Gizmod ===

In Linux there is Gizmo Daemon - THE Linux Linux Input Device Utility.

Unfortunately Gizmo is no longer supported by Ubuntu and most other Linux Distributions. The last update on the Gizmo page was in 2009.

So the following Setup is experimental until we may have support for the Powermate in QtRadio or Hamlib directly.

1. Go to your preferred local git directory.
<pre>
$ git clone git://github.com/jtriley/gizmod.git
</pre>

<pre>
$ cd gizmod
</pre>

Make the following two patches:

<pre>
index 14b8d37..b61e2a1 100644
--- a/libH/Average.hpp
+++ b/libH/Average.hpp
@@ -35,6 +35,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

You may apply the above patch manually by:
<pre>
$ gedit libH/Average.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

Do the same with the following patch:

<pre>
index d794055..75f4c27 100644
--- a/libH/DynamicBuffer.hpp
+++ b/libH/DynamicBuffer.hpp
@@ -33,6 +33,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

<pre>
gedit libHDynamicBuffer.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

<pre>
$ gedit cpuusage.cpp
</pre>

add

<pre>
#include <cstring>
</pre>

<pre>
$ sudo apt-get install libboost-all-dev
</pre>

<pre>
$ mkdir build
$ cd build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr -DSYSCONF_INSTALL_DIR=/etc ..
$ make
</pre>

If you still get an error do:

<pre>
$ gedit gizmod/CMakeFiles/gizmod.dir/link.txt
</pre>

and add:

<pre>
-lboost_system
</pre>

<pre>
$ make
$ sudo make install
</pre>

=== Setup Gizmod ===

Go to your user directory and do:
<pre>
$ mkdir -p .gizmod
</pre>

<pre>
$ cp /usr/etc/gizmod * .gizmod
</pre>

<pre>
$ mkdir .gizmod/modules.d
</pre>

<pre>
$ cp /usr/etc/gizmod/modules.d/000-CatchAllDebug.py .gizmod/modules.d/
$ cp /usr/etc/gizmod/modules.d/299-Powermate-Default.py .gizmod/modules.d/
</pre>

<pre>
$ cd .gizmod/modules.d
</pre>

<pre>
$ gedit 299-Powermate-Default.py
</pre>

Edit 299-Powermate-Default.py like this (Do not change the Filename and edit exactly)

<pre>
#***
#*********************************************************************
#*************************************************************************
#***
#*** GizmoDaemon Config Script
#*** Powermate Default config
#***
#*****************************************
#*****************************************
#***

"""

Copyright (c) 2007, Gizmo Daemon Team
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

"""

############################
# Imports
##########################

from GizmoDaemon import *
from GizmoScriptDefault import *
import time

ENABLED = True
VERSION_NEEDED = 3.2
INTERESTED_CLASSES = [GizmoEventClass.Powermate]

############################
# PowermateDefault Class definition
##########################

class PowermateDefault(GizmoScriptDefault):
"""
Default Powermate Event Mapping
"""

############################
# Public Functions
##########################

def onDeviceEvent(self, Event, Gizmo = None):
"""
Called from Base Class' onEvent method.
See GizmodDispatcher.onEvent documention for an explanation of this function
"""

# Check for rotations
if Event.Type == GizmoEventType.EV_REL:
if Gizmo.getKeyState(GizmoKey.BTN_0):
if Gizmod.DefaultMixerVolume:
Gizmod.DefaultMixerVolume.VolumePlayback = Gizmod.DefaultMixerVolume.VolumePlayback + Event.Value
else:
# scroll quickly (by pages using the page up / page down keys)
if Event.Value < 0:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_RIGHT)
else:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_LEFT)
return True
elif Event.Type == GizmoEventType.EV_KEY:
if Event.Value == 0 and not Gizmo.Rotated:
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_PLUS)
return True
return False

############################
# Private Functions
##########################

def __init__(self):
"""
Default Constructor
"""

GizmoScriptDefault.__init__(self, ENABLED, VERSION_NEEDED, INTERESTED_CLASSES)

############################
# PowermateDefault class end
##########################

# register the user script
PowermateDefault()
</pre>

<pre>
$ gizmod
</pre>

you should see the following output:(depends on your system)

<pre>
GizmoDaemon v3.4 -=- (c) 2007, Tim Burrell <tim.burrell@gmail.com>
=---------=

Registering Devices:

Standard - Directory [input]
Standard - Sleep Button [event0] vId: 0x0 pId: 0x3
Standard - Lid Switch [event1] vId: 0x0 pId: 0x5
Standard - HDA Intel Mic [event10] vId: 0x0 pId: 0x0
Standard - HDA Intel Mic [event11] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event12] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event13] vId: 0x0 pId: 0x0
Standard - Power Button [event2] vId: 0x0 pId: 0x1
Keyboard - AT Translated Set 2 keyboard [event3] vId: 0x1 pId: 0x1
Standard - Asus Laptop extra buttons [event4] vId: 0x0 pId: 0x0
Powermate - Griffin PowerMate [event5] vId: 0x77d pId: 0x410
Standard - CNF7237&CNF7238 [event6] vId: 0x17ef pId: 0x4808
Mouse - SynPS/2 Synaptics TouchPad [event7] vId: 0x2 pId: 0x7
Standard - Video Bus [event8] vId: 0x0 pId: 0x6
Standard - HDA Intel HDMI/DP,pcm=3 [event9] vId: 0x0 pId: 0x0

Loading User Scripts:

CatchAllDebug - CatchAll Event Mapping for Testing
PowermateDefault - Default Powermate Event Mapping
</pre>

You should have the following functions:

<pre>
turn left = KEY RIGHT
turn right = KEY LEFT
press and turn left = System Volume down
press and turn right = System Volume up
Buttonpress = cycle through Step Size
</pre>

QtRadio - Operation

2011-12-01T06:55:44Z

Zl2apv: /* Band */

=== Connecting to a server ===

== Tuning the radio ==
=== Fixed frequency radio ===
For crystal locked radios such as the softrock lite II or YU1LM sdr's It is necessary to use [[#Using subRx | subRx]]. The procedure is to set vfoA to your centre frequency, usually the crystal frequency / 4 and leave it alone as changing it will affect your centre frequency. Using the button on the vfo panel or the 'Receiver' Menu / subRx choice switch on the subRx. You can now tune within the limits of the sample rate of your sound card (48, 96 or 192 KHz).

Note that you need to start dspserver with LO offset of zero:

$ dspserver --lo 0

=== si570 tunable radio ===

In the Softrock series of hardware using sound cards, there is frequently a noise band near DC (offset 0). As such most users will set an offset of 9000 Hz (or 12000Hz etc.) using programs such as PSDR-IQ. You do the same when starting dspserver:

$ dspserver --lo 9000

=== Direct Down Conversion (DDC) radio ===

Such radios (eg. Perseus, HPSDR, usrp) do not need the offset. So start dspserver with:

$ dspserver --lo 0

== Setting the noise floor ==
The height of the spectrum from the baseline is adjusted by rolling the mouse wheel with the pointer over the level calibration markings on the extreme left hand side of the spectrum window. This will at the same time change the base colour of the waterfall.

The procedure is: After setting the [[#Calibrating the S meter | sound-card gain]] you should remove the antenna and roll the mouse-wheel to give a spectrum display line just above the bottom of the window. When you apply the antenna the spectrum will rise in the window and the waterfall base colour should be dark blue unless the band is particularly noisy.

== Calibrating the S meter ==
To calibrate the S Meter, a signal equal to S9 (-73 dBm) is injected into the sdr and the soundcard gain is adjusted until the S meter reads S9. It will then probably be necessary to adjust the spectrum [[#Setting the noise floor | noise floor]] level.

A subjective calibration may be performed by tuning into a signal considered S9 and performing the above procedure.

== VFO and Split selection ==

== Using RIT ==

== Changing bands ==

== Using Quick Memories ==

== Using subRx ==
To be constructed

== The Menu choices ==

=== Receiver ===
''Connect/Disconnect''

You can connect to a server either by selecting the server in the Configure > Server list and then click Connect, or by selecting the server in the Quick Server List and click connect.

After you Disconnect from a server, you must wait at least 10 seconds for the disconnection to take full effect before connecting to another server. This is to allow the internet connection to really disconnect (remember there is network latency and the server will continue to send data till its buffers are emptied). Failure to do so will often result in error in QtRadio and may even hang QtRadio.

''Quick Server List''

If you see that a public server's status is "Busy", please '''do not''' connect to it. Doing so will disrupt the user already connected. If you see a server's status is "Idle" or "0 client(s)", you can connect to it. If you see "1 client(s)" or "2 client(s)" etc., you are sharing a connection to the same server. The first client is the master who has control over the vfo and Tx etc., and you will be connecting as a slave. You will only be able to listen to the audio and see the spectrum passively as an observer. When the clients before you disconnect, you will automatically become the master. This is a queuing mechanism.

''Configure > Audio''

If you are connecting to a public server on the Internet (ie not your own server on your LAN), '''please''' set Audio to 8000, aLaw, and 1 channel. If you use other settings, your QtRadio and/or the dspserver/server will hang.

=== Audio ===

=== Band ===
====Keypad====
Clicking on the keypad brings up a key entry window. The frequency must be entered by clicking on the number pads and should be in the form MHz dot KHz i.e. 14.293 Entering in KHz will cause an error which is not trapped yet.

''Band Selection''
The band menu allows selection of a band by clicking on the desired entry. Clicks on an already selected entry steps to the next memory position and sets the stored frequency, mode, filter and spectrum/waterfall settings.
The status line on the bottom right hand side of the window will display ... Band, Memory position, Mode, Filter and whether using memory or vfo.

''XVTR''
To Come

=== Mode ===
=== Filter ===
=== Noise Reduction ===
=== AGC ===
=== Spectrum ===
=== Hardware ===
=== Bookmarks ===

== Transmit commands ==

== Keyboard Shortcuts ==
* Arrow Left/Right Tune Down/Up the active VFO
* Arrow Up/Down Increase /Decrease Step Size above
* lowercase a = VFOA
* lowercase b = VFOB
* lowercase c = Connect
* lowercase d = Disconnect
* lowercase k= Bring up Keypad entry window
* lowercase l = Bring up Quick Connect Window
* lowercase s = toggle SubRX

== Using the Griffin Powermate USB Dial as VFO Knob ==
=== The Griffin Powermate USB DIal ===
[[File:powermate_.png|200px]]

The Griffin Powermate has a single wheel and a pushbutton, which is
able to do the following actions:

<pre>
1. Rotate Clockwise
2. Rotate Counterclockwise
3. Push Down and Rotate Clockwise
4. Push Down and Rotate Counterclockwise
5. Push Down
6. Long Push Down
7. Responisve Blue LED's
</pre>

So we have 6 possibilities to map to keystrokes, soundcard levels and so on.

In Windows you may refer to the following Document published by FlexRadio. Install the Powermate Software for Windows and map your wanted keys.

http://support.flexradio.com/Downloads.aspx?id=47

=== Download Gizmod ===

In Linux there is Gizmo Daemon - THE Linux Linux Input Device Utility.

Unfortunately Gizmo is no longer supported by Ubuntu and most other Linux Distributions. The last update on the Gizmo page was in 2009.

So the following Setup is experimental until we may have support for the Powermate in QtRadio or Hamlib directly.

1. Go to your preferred local git directory.
<pre>
$ git clone git://github.com/jtriley/gizmod.git
</pre>

<pre>
$ cd gizmod
</pre>

Make the following two patches:

<pre>
index 14b8d37..b61e2a1 100644
--- a/libH/Average.hpp
+++ b/libH/Average.hpp
@@ -35,6 +35,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

You may apply the above patch manually by:
<pre>
$ gedit libH/Average.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

Do the same with the following patch:

<pre>
index d794055..75f4c27 100644
--- a/libH/DynamicBuffer.hpp
+++ b/libH/DynamicBuffer.hpp
@@ -33,6 +33,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

<pre>
gedit libHDynamicBuffer.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

<pre>
$ gedit cpuusage.cpp
</pre>

add

<pre>
#include <cstring>
</pre>

<pre>
$ sudo apt-get install libboost-all-dev
</pre>

<pre>
$ mkdir build
$ cd build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr -DSYSCONF_INSTALL_DIR=/etc ..
$ make
</pre>

If you still get an error do:

<pre>
$ gedit gizmod/CMakeFiles/gizmod.dir/link.txt
</pre>

and add:

<pre>
-lboost_system
</pre>

<pre>
$ make
$ sudo make install
</pre>

=== Setup Gizmod ===

Go to your user directory and do:
<pre>
$ mkdir -p .gizmod
</pre>

<pre>
$ cp /usr/etc/gizmod * .gizmod
</pre>

<pre>
$ mkdir .gizmod/modules.d
</pre>

<pre>
$ cp /usr/etc/gizmod/modules.d/000-CatchAllDebug.py .gizmod/modules.d/
$ cp /usr/etc/gizmod/modules.d/299-Powermate-Default.py .gizmod/modules.d/
</pre>

<pre>
$ cd .gizmod/modules.d
</pre>

<pre>
$ gedit 299-Powermate-Default.py
</pre>

Edit 299-Powermate-Default.py like this (Do not change the Filename and edit exactly)

<pre>
#***
#*********************************************************************
#*************************************************************************
#***
#*** GizmoDaemon Config Script
#*** Powermate Default config
#***
#*****************************************
#*****************************************
#***

"""

Copyright (c) 2007, Gizmo Daemon Team
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

"""

############################
# Imports
##########################

from GizmoDaemon import *
from GizmoScriptDefault import *
import time

ENABLED = True
VERSION_NEEDED = 3.2
INTERESTED_CLASSES = [GizmoEventClass.Powermate]

############################
# PowermateDefault Class definition
##########################

class PowermateDefault(GizmoScriptDefault):
"""
Default Powermate Event Mapping
"""

############################
# Public Functions
##########################

def onDeviceEvent(self, Event, Gizmo = None):
"""
Called from Base Class' onEvent method.
See GizmodDispatcher.onEvent documention for an explanation of this function
"""

# Check for rotations
if Event.Type == GizmoEventType.EV_REL:
if Gizmo.getKeyState(GizmoKey.BTN_0):
if Gizmod.DefaultMixerVolume:
Gizmod.DefaultMixerVolume.VolumePlayback = Gizmod.DefaultMixerVolume.VolumePlayback + Event.Value
else:
# scroll quickly (by pages using the page up / page down keys)
if Event.Value < 0:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_RIGHT)
else:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_LEFT)
return True
elif Event.Type == GizmoEventType.EV_KEY:
if Event.Value == 0 and not Gizmo.Rotated:
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_PLUS)
return True
return False

############################
# Private Functions
##########################

def __init__(self):
"""
Default Constructor
"""

GizmoScriptDefault.__init__(self, ENABLED, VERSION_NEEDED, INTERESTED_CLASSES)

############################
# PowermateDefault class end
##########################

# register the user script
PowermateDefault()
</pre>

<pre>
$ gizmod
</pre>

you should see the following output:(depends on your system)

<pre>
GizmoDaemon v3.4 -=- (c) 2007, Tim Burrell <tim.burrell@gmail.com>
=---------=

Registering Devices:

Standard - Directory [input]
Standard - Sleep Button [event0] vId: 0x0 pId: 0x3
Standard - Lid Switch [event1] vId: 0x0 pId: 0x5
Standard - HDA Intel Mic [event10] vId: 0x0 pId: 0x0
Standard - HDA Intel Mic [event11] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event12] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event13] vId: 0x0 pId: 0x0
Standard - Power Button [event2] vId: 0x0 pId: 0x1
Keyboard - AT Translated Set 2 keyboard [event3] vId: 0x1 pId: 0x1
Standard - Asus Laptop extra buttons [event4] vId: 0x0 pId: 0x0
Powermate - Griffin PowerMate [event5] vId: 0x77d pId: 0x410
Standard - CNF7237&CNF7238 [event6] vId: 0x17ef pId: 0x4808
Mouse - SynPS/2 Synaptics TouchPad [event7] vId: 0x2 pId: 0x7
Standard - Video Bus [event8] vId: 0x0 pId: 0x6
Standard - HDA Intel HDMI/DP,pcm=3 [event9] vId: 0x0 pId: 0x0

Loading User Scripts:

CatchAllDebug - CatchAll Event Mapping for Testing
PowermateDefault - Default Powermate Event Mapping
</pre>

You should have the following functions:

<pre>
turn left = KEY RIGHT
turn right = KEY LEFT
press and turn left = System Volume down
press and turn right = System Volume up
Buttonpress = cycle through Step Size
</pre>

QtRadio - Operation

2011-12-01T06:53:48Z

Zl2apv: /* Band */

=== Connecting to a server ===

== Tuning the radio ==
=== Fixed frequency radio ===
For crystal locked radios such as the softrock lite II or YU1LM sdr's It is necessary to use [[#Using subRx | subRx]]. The procedure is to set vfoA to your centre frequency, usually the crystal frequency / 4 and leave it alone as changing it will affect your centre frequency. Using the button on the vfo panel or the 'Receiver' Menu / subRx choice switch on the subRx. You can now tune within the limits of the sample rate of your sound card (48, 96 or 192 KHz).

Note that you need to start dspserver with LO offset of zero:

$ dspserver --lo 0

=== si570 tunable radio ===

In the Softrock series of hardware using sound cards, there is frequently a noise band near DC (offset 0). As such most users will set an offset of 9000 Hz (or 12000Hz etc.) using programs such as PSDR-IQ. You do the same when starting dspserver:

$ dspserver --lo 9000

=== Direct Down Conversion (DDC) radio ===

Such radios (eg. Perseus, HPSDR, usrp) do not need the offset. So start dspserver with:

$ dspserver --lo 0

== Setting the noise floor ==
The height of the spectrum from the baseline is adjusted by rolling the mouse wheel with the pointer over the level calibration markings on the extreme left hand side of the spectrum window. This will at the same time change the base colour of the waterfall.

The procedure is: After setting the [[#Calibrating the S meter | sound-card gain]] you should remove the antenna and roll the mouse-wheel to give a spectrum display line just above the bottom of the window. When you apply the antenna the spectrum will rise in the window and the waterfall base colour should be dark blue unless the band is particularly noisy.

== Calibrating the S meter ==
To calibrate the S Meter, a signal equal to S9 (-73 dBm) is injected into the sdr and the soundcard gain is adjusted until the S meter reads S9. It will then probably be necessary to adjust the spectrum [[#Setting the noise floor | noise floor]] level.

A subjective calibration may be performed by tuning into a signal considered S9 and performing the above procedure.

== VFO and Split selection ==

== Using RIT ==

== Changing bands ==

== Using Quick Memories ==

== Using subRx ==
To be constructed

== The Menu choices ==

=== Receiver ===
''Connect/Disconnect''

You can connect to a server either by selecting the server in the Configure > Server list and then click Connect, or by selecting the server in the Quick Server List and click connect.

After you Disconnect from a server, you must wait at least 10 seconds for the disconnection to take full effect before connecting to another server. This is to allow the internet connection to really disconnect (remember there is network latency and the server will continue to send data till its buffers are emptied). Failure to do so will often result in error in QtRadio and may even hang QtRadio.

''Quick Server List''

If you see that a public server's status is "Busy", please '''do not''' connect to it. Doing so will disrupt the user already connected. If you see a server's status is "Idle" or "0 client(s)", you can connect to it. If you see "1 client(s)" or "2 client(s)" etc., you are sharing a connection to the same server. The first client is the master who has control over the vfo and Tx etc., and you will be connecting as a slave. You will only be able to listen to the audio and see the spectrum passively as an observer. When the clients before you disconnect, you will automatically become the master. This is a queuing mechanism.

''Configure > Audio''

If you are connecting to a public server on the Internet (ie not your own server on your LAN), '''please''' set Audio to 8000, aLaw, and 1 channel. If you use other settings, your QtRadio and/or the dspserver/server will hang.

=== Audio ===

=== Band ===
''Keypad''
Clicking on the keypad brings up a key entry window. The frequency must be entered by clicking on the number pads and should be in the form MHz dot KHz i.e. 14.293 Entering in KHz will cause an error which is not trapped yet.

''Band Selection''
The band menu allows selection of a band by clicking on the desired entry. Clicks on an already selected entry steps to the next memory position and sets the stored frequency, mode, filter and spectrum/waterfall settings.
The status line on the bottom right hand side of the window will display ... Band, Memory position, Mode, Filter and whether using memory or vfo.

''XVTR''
To Come

=== Mode ===
=== Filter ===
=== Noise Reduction ===
=== AGC ===
=== Spectrum ===
=== Hardware ===
=== Bookmarks ===

== Transmit commands ==

== Keyboard Shortcuts ==
* Arrow Left/Right Tune Down/Up the active VFO
* Arrow Up/Down Increase /Decrease Step Size above
* lowercase a = VFOA
* lowercase b = VFOB
* lowercase c = Connect
* lowercase d = Disconnect
* lowercase k= Bring up Keypad entry window
* lowercase l = Bring up Quick Connect Window
* lowercase s = toggle SubRX

== Using the Griffin Powermate USB Dial as VFO Knob ==
=== The Griffin Powermate USB DIal ===
[[File:powermate_.png|200px]]

The Griffin Powermate has a single wheel and a pushbutton, which is
able to do the following actions:

<pre>
1. Rotate Clockwise
2. Rotate Counterclockwise
3. Push Down and Rotate Clockwise
4. Push Down and Rotate Counterclockwise
5. Push Down
6. Long Push Down
7. Responisve Blue LED's
</pre>

So we have 6 possibilities to map to keystrokes, soundcard levels and so on.

In Windows you may refer to the following Document published by FlexRadio. Install the Powermate Software for Windows and map your wanted keys.

http://support.flexradio.com/Downloads.aspx?id=47

=== Download Gizmod ===

In Linux there is Gizmo Daemon - THE Linux Linux Input Device Utility.

Unfortunately Gizmo is no longer supported by Ubuntu and most other Linux Distributions. The last update on the Gizmo page was in 2009.

So the following Setup is experimental until we may have support for the Powermate in QtRadio or Hamlib directly.

1. Go to your preferred local git directory.
<pre>
$ git clone git://github.com/jtriley/gizmod.git
</pre>

<pre>
$ cd gizmod
</pre>

Make the following two patches:

<pre>
index 14b8d37..b61e2a1 100644
--- a/libH/Average.hpp
+++ b/libH/Average.hpp
@@ -35,6 +35,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

You may apply the above patch manually by:
<pre>
$ gedit libH/Average.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

Do the same with the following patch:

<pre>
index d794055..75f4c27 100644
--- a/libH/DynamicBuffer.hpp
+++ b/libH/DynamicBuffer.hpp
@@ -33,6 +33,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

<pre>
gedit libHDynamicBuffer.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

<pre>
$ gedit cpuusage.cpp
</pre>

add

<pre>
#include <cstring>
</pre>

<pre>
$ sudo apt-get install libboost-all-dev
</pre>

<pre>
$ mkdir build
$ cd build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr -DSYSCONF_INSTALL_DIR=/etc ..
$ make
</pre>

If you still get an error do:

<pre>
$ gedit gizmod/CMakeFiles/gizmod.dir/link.txt
</pre>

and add:

<pre>
-lboost_system
</pre>

<pre>
$ make
$ sudo make install
</pre>

=== Setup Gizmod ===

Go to your user directory and do:
<pre>
$ mkdir -p .gizmod
</pre>

<pre>
$ cp /usr/etc/gizmod * .gizmod
</pre>

<pre>
$ mkdir .gizmod/modules.d
</pre>

<pre>
$ cp /usr/etc/gizmod/modules.d/000-CatchAllDebug.py .gizmod/modules.d/
$ cp /usr/etc/gizmod/modules.d/299-Powermate-Default.py .gizmod/modules.d/
</pre>

<pre>
$ cd .gizmod/modules.d
</pre>

<pre>
$ gedit 299-Powermate-Default.py
</pre>

Edit 299-Powermate-Default.py like this (Do not change the Filename and edit exactly)

<pre>
#***
#*********************************************************************
#*************************************************************************
#***
#*** GizmoDaemon Config Script
#*** Powermate Default config
#***
#*****************************************
#*****************************************
#***

"""

Copyright (c) 2007, Gizmo Daemon Team
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

"""

############################
# Imports
##########################

from GizmoDaemon import *
from GizmoScriptDefault import *
import time

ENABLED = True
VERSION_NEEDED = 3.2
INTERESTED_CLASSES = [GizmoEventClass.Powermate]

############################
# PowermateDefault Class definition
##########################

class PowermateDefault(GizmoScriptDefault):
"""
Default Powermate Event Mapping
"""

############################
# Public Functions
##########################

def onDeviceEvent(self, Event, Gizmo = None):
"""
Called from Base Class' onEvent method.
See GizmodDispatcher.onEvent documention for an explanation of this function
"""

# Check for rotations
if Event.Type == GizmoEventType.EV_REL:
if Gizmo.getKeyState(GizmoKey.BTN_0):
if Gizmod.DefaultMixerVolume:
Gizmod.DefaultMixerVolume.VolumePlayback = Gizmod.DefaultMixerVolume.VolumePlayback + Event.Value
else:
# scroll quickly (by pages using the page up / page down keys)
if Event.Value < 0:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_RIGHT)
else:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_LEFT)
return True
elif Event.Type == GizmoEventType.EV_KEY:
if Event.Value == 0 and not Gizmo.Rotated:
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_PLUS)
return True
return False

############################
# Private Functions
##########################

def __init__(self):
"""
Default Constructor
"""

GizmoScriptDefault.__init__(self, ENABLED, VERSION_NEEDED, INTERESTED_CLASSES)

############################
# PowermateDefault class end
##########################

# register the user script
PowermateDefault()
</pre>

<pre>
$ gizmod
</pre>

you should see the following output:(depends on your system)

<pre>
GizmoDaemon v3.4 -=- (c) 2007, Tim Burrell <tim.burrell@gmail.com>
=---------=

Registering Devices:

Standard - Directory [input]
Standard - Sleep Button [event0] vId: 0x0 pId: 0x3
Standard - Lid Switch [event1] vId: 0x0 pId: 0x5
Standard - HDA Intel Mic [event10] vId: 0x0 pId: 0x0
Standard - HDA Intel Mic [event11] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event12] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event13] vId: 0x0 pId: 0x0
Standard - Power Button [event2] vId: 0x0 pId: 0x1
Keyboard - AT Translated Set 2 keyboard [event3] vId: 0x1 pId: 0x1
Standard - Asus Laptop extra buttons [event4] vId: 0x0 pId: 0x0
Powermate - Griffin PowerMate [event5] vId: 0x77d pId: 0x410
Standard - CNF7237&CNF7238 [event6] vId: 0x17ef pId: 0x4808
Mouse - SynPS/2 Synaptics TouchPad [event7] vId: 0x2 pId: 0x7
Standard - Video Bus [event8] vId: 0x0 pId: 0x6
Standard - HDA Intel HDMI/DP,pcm=3 [event9] vId: 0x0 pId: 0x0

Loading User Scripts:

CatchAllDebug - CatchAll Event Mapping for Testing
PowermateDefault - Default Powermate Event Mapping
</pre>

You should have the following functions:

<pre>
turn left = KEY RIGHT
turn right = KEY LEFT
press and turn left = System Volume down
press and turn right = System Volume up
Buttonpress = cycle through Step Size
</pre>

QtRadio - Operation

2011-12-01T06:53:09Z

Zl2apv: /* Band */

=== Connecting to a server ===

== Tuning the radio ==
=== Fixed frequency radio ===
For crystal locked radios such as the softrock lite II or YU1LM sdr's It is necessary to use [[#Using subRx | subRx]]. The procedure is to set vfoA to your centre frequency, usually the crystal frequency / 4 and leave it alone as changing it will affect your centre frequency. Using the button on the vfo panel or the 'Receiver' Menu / subRx choice switch on the subRx. You can now tune within the limits of the sample rate of your sound card (48, 96 or 192 KHz).

Note that you need to start dspserver with LO offset of zero:

$ dspserver --lo 0

=== si570 tunable radio ===

In the Softrock series of hardware using sound cards, there is frequently a noise band near DC (offset 0). As such most users will set an offset of 9000 Hz (or 12000Hz etc.) using programs such as PSDR-IQ. You do the same when starting dspserver:

$ dspserver --lo 9000

=== Direct Down Conversion (DDC) radio ===

Such radios (eg. Perseus, HPSDR, usrp) do not need the offset. So start dspserver with:

$ dspserver --lo 0

== Setting the noise floor ==
The height of the spectrum from the baseline is adjusted by rolling the mouse wheel with the pointer over the level calibration markings on the extreme left hand side of the spectrum window. This will at the same time change the base colour of the waterfall.

The procedure is: After setting the [[#Calibrating the S meter | sound-card gain]] you should remove the antenna and roll the mouse-wheel to give a spectrum display line just above the bottom of the window. When you apply the antenna the spectrum will rise in the window and the waterfall base colour should be dark blue unless the band is particularly noisy.

== Calibrating the S meter ==
To calibrate the S Meter, a signal equal to S9 (-73 dBm) is injected into the sdr and the soundcard gain is adjusted until the S meter reads S9. It will then probably be necessary to adjust the spectrum [[#Setting the noise floor | noise floor]] level.

A subjective calibration may be performed by tuning into a signal considered S9 and performing the above procedure.

== VFO and Split selection ==

== Using RIT ==

== Changing bands ==

== Using Quick Memories ==

== Using subRx ==
To be constructed

== The Menu choices ==

=== Receiver ===
''Connect/Disconnect''

You can connect to a server either by selecting the server in the Configure > Server list and then click Connect, or by selecting the server in the Quick Server List and click connect.

After you Disconnect from a server, you must wait at least 10 seconds for the disconnection to take full effect before connecting to another server. This is to allow the internet connection to really disconnect (remember there is network latency and the server will continue to send data till its buffers are emptied). Failure to do so will often result in error in QtRadio and may even hang QtRadio.

''Quick Server List''

If you see that a public server's status is "Busy", please '''do not''' connect to it. Doing so will disrupt the user already connected. If you see a server's status is "Idle" or "0 client(s)", you can connect to it. If you see "1 client(s)" or "2 client(s)" etc., you are sharing a connection to the same server. The first client is the master who has control over the vfo and Tx etc., and you will be connecting as a slave. You will only be able to listen to the audio and see the spectrum passively as an observer. When the clients before you disconnect, you will automatically become the master. This is a queuing mechanism.

''Configure > Audio''

If you are connecting to a public server on the Internet (ie not your own server on your LAN), '''please''' set Audio to 8000, aLaw, and 1 channel. If you use other settings, your QtRadio and/or the dspserver/server will hang.

=== Audio ===

=== Band ===
''Keypad''
Clicking on the keypad brings up a key entry window. The frequency must be entered by clicking on the number pads and should be in the form MHz dot KHz i.e. 14.293 Entering in KHz will cause an error which is not trapped yet
''Band Selection''
The band menu allows selection of a band by clicking on the desired entry. Clicks on an already selected entry steps to the next memory position and sets the stored frequency, mode, filter and spectrum/waterfall settings.
The status line on the bottom right hand side of the window will display ... Band, Memory position, Mode, Filter and whether using memory or vfo.
''XVTR''
To Come

=== Mode ===
=== Filter ===
=== Noise Reduction ===
=== AGC ===
=== Spectrum ===
=== Hardware ===
=== Bookmarks ===

== Transmit commands ==

== Keyboard Shortcuts ==
* Arrow Left/Right Tune Down/Up the active VFO
* Arrow Up/Down Increase /Decrease Step Size above
* lowercase a = VFOA
* lowercase b = VFOB
* lowercase c = Connect
* lowercase d = Disconnect
* lowercase k= Bring up Keypad entry window
* lowercase l = Bring up Quick Connect Window
* lowercase s = toggle SubRX

== Using the Griffin Powermate USB Dial as VFO Knob ==
=== The Griffin Powermate USB DIal ===
[[File:powermate_.png|200px]]

The Griffin Powermate has a single wheel and a pushbutton, which is
able to do the following actions:

<pre>
1. Rotate Clockwise
2. Rotate Counterclockwise
3. Push Down and Rotate Clockwise
4. Push Down and Rotate Counterclockwise
5. Push Down
6. Long Push Down
7. Responisve Blue LED's
</pre>

So we have 6 possibilities to map to keystrokes, soundcard levels and so on.

In Windows you may refer to the following Document published by FlexRadio. Install the Powermate Software for Windows and map your wanted keys.

http://support.flexradio.com/Downloads.aspx?id=47

=== Download Gizmod ===

In Linux there is Gizmo Daemon - THE Linux Linux Input Device Utility.

Unfortunately Gizmo is no longer supported by Ubuntu and most other Linux Distributions. The last update on the Gizmo page was in 2009.

So the following Setup is experimental until we may have support for the Powermate in QtRadio or Hamlib directly.

1. Go to your preferred local git directory.
<pre>
$ git clone git://github.com/jtriley/gizmod.git
</pre>

<pre>
$ cd gizmod
</pre>

Make the following two patches:

<pre>
index 14b8d37..b61e2a1 100644
--- a/libH/Average.hpp
+++ b/libH/Average.hpp
@@ -35,6 +35,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

You may apply the above patch manually by:
<pre>
$ gedit libH/Average.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

Do the same with the following patch:

<pre>
index d794055..75f4c27 100644
--- a/libH/DynamicBuffer.hpp
+++ b/libH/DynamicBuffer.hpp
@@ -33,6 +33,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

<pre>
gedit libHDynamicBuffer.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

<pre>
$ gedit cpuusage.cpp
</pre>

add

<pre>
#include <cstring>
</pre>

<pre>
$ sudo apt-get install libboost-all-dev
</pre>

<pre>
$ mkdir build
$ cd build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr -DSYSCONF_INSTALL_DIR=/etc ..
$ make
</pre>

If you still get an error do:

<pre>
$ gedit gizmod/CMakeFiles/gizmod.dir/link.txt
</pre>

and add:

<pre>
-lboost_system
</pre>

<pre>
$ make
$ sudo make install
</pre>

=== Setup Gizmod ===

Go to your user directory and do:
<pre>
$ mkdir -p .gizmod
</pre>

<pre>
$ cp /usr/etc/gizmod * .gizmod
</pre>

<pre>
$ mkdir .gizmod/modules.d
</pre>

<pre>
$ cp /usr/etc/gizmod/modules.d/000-CatchAllDebug.py .gizmod/modules.d/
$ cp /usr/etc/gizmod/modules.d/299-Powermate-Default.py .gizmod/modules.d/
</pre>

<pre>
$ cd .gizmod/modules.d
</pre>

<pre>
$ gedit 299-Powermate-Default.py
</pre>

Edit 299-Powermate-Default.py like this (Do not change the Filename and edit exactly)

<pre>
#***
#*********************************************************************
#*************************************************************************
#***
#*** GizmoDaemon Config Script
#*** Powermate Default config
#***
#*****************************************
#*****************************************
#***

"""

Copyright (c) 2007, Gizmo Daemon Team
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

"""

############################
# Imports
##########################

from GizmoDaemon import *
from GizmoScriptDefault import *
import time

ENABLED = True
VERSION_NEEDED = 3.2
INTERESTED_CLASSES = [GizmoEventClass.Powermate]

############################
# PowermateDefault Class definition
##########################

class PowermateDefault(GizmoScriptDefault):
"""
Default Powermate Event Mapping
"""

############################
# Public Functions
##########################

def onDeviceEvent(self, Event, Gizmo = None):
"""
Called from Base Class' onEvent method.
See GizmodDispatcher.onEvent documention for an explanation of this function
"""

# Check for rotations
if Event.Type == GizmoEventType.EV_REL:
if Gizmo.getKeyState(GizmoKey.BTN_0):
if Gizmod.DefaultMixerVolume:
Gizmod.DefaultMixerVolume.VolumePlayback = Gizmod.DefaultMixerVolume.VolumePlayback + Event.Value
else:
# scroll quickly (by pages using the page up / page down keys)
if Event.Value < 0:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_RIGHT)
else:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_LEFT)
return True
elif Event.Type == GizmoEventType.EV_KEY:
if Event.Value == 0 and not Gizmo.Rotated:
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_PLUS)
return True
return False

############################
# Private Functions
##########################

def __init__(self):
"""
Default Constructor
"""

GizmoScriptDefault.__init__(self, ENABLED, VERSION_NEEDED, INTERESTED_CLASSES)

############################
# PowermateDefault class end
##########################

# register the user script
PowermateDefault()
</pre>

<pre>
$ gizmod
</pre>

you should see the following output:(depends on your system)

<pre>
GizmoDaemon v3.4 -=- (c) 2007, Tim Burrell <tim.burrell@gmail.com>
=---------=

Registering Devices:

Standard - Directory [input]
Standard - Sleep Button [event0] vId: 0x0 pId: 0x3
Standard - Lid Switch [event1] vId: 0x0 pId: 0x5
Standard - HDA Intel Mic [event10] vId: 0x0 pId: 0x0
Standard - HDA Intel Mic [event11] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event12] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event13] vId: 0x0 pId: 0x0
Standard - Power Button [event2] vId: 0x0 pId: 0x1
Keyboard - AT Translated Set 2 keyboard [event3] vId: 0x1 pId: 0x1
Standard - Asus Laptop extra buttons [event4] vId: 0x0 pId: 0x0
Powermate - Griffin PowerMate [event5] vId: 0x77d pId: 0x410
Standard - CNF7237&CNF7238 [event6] vId: 0x17ef pId: 0x4808
Mouse - SynPS/2 Synaptics TouchPad [event7] vId: 0x2 pId: 0x7
Standard - Video Bus [event8] vId: 0x0 pId: 0x6
Standard - HDA Intel HDMI/DP,pcm=3 [event9] vId: 0x0 pId: 0x0

Loading User Scripts:

CatchAllDebug - CatchAll Event Mapping for Testing
PowermateDefault - Default Powermate Event Mapping
</pre>

You should have the following functions:

<pre>
turn left = KEY RIGHT
turn right = KEY LEFT
press and turn left = System Volume down
press and turn right = System Volume up
Buttonpress = cycle through Step Size
</pre>

QtRadio - Operation

2011-12-01T06:46:38Z

Zl2apv: /* Band */

=== Connecting to a server ===

== Tuning the radio ==
=== Fixed frequency radio ===
For crystal locked radios such as the softrock lite II or YU1LM sdr's It is necessary to use [[#Using subRx | subRx]]. The procedure is to set vfoA to your centre frequency, usually the crystal frequency / 4 and leave it alone as changing it will affect your centre frequency. Using the button on the vfo panel or the 'Receiver' Menu / subRx choice switch on the subRx. You can now tune within the limits of the sample rate of your sound card (48, 96 or 192 KHz).

Note that you need to start dspserver with LO offset of zero:

$ dspserver --lo 0

=== si570 tunable radio ===

In the Softrock series of hardware using sound cards, there is frequently a noise band near DC (offset 0). As such most users will set an offset of 9000 Hz (or 12000Hz etc.) using programs such as PSDR-IQ. You do the same when starting dspserver:

$ dspserver --lo 9000

=== Direct Down Conversion (DDC) radio ===

Such radios (eg. Perseus, HPSDR, usrp) do not need the offset. So start dspserver with:

$ dspserver --lo 0

== Setting the noise floor ==
The height of the spectrum from the baseline is adjusted by rolling the mouse wheel with the pointer over the level calibration markings on the extreme left hand side of the spectrum window. This will at the same time change the base colour of the waterfall.

The procedure is: After setting the [[#Calibrating the S meter | sound-card gain]] you should remove the antenna and roll the mouse-wheel to give a spectrum display line just above the bottom of the window. When you apply the antenna the spectrum will rise in the window and the waterfall base colour should be dark blue unless the band is particularly noisy.

== Calibrating the S meter ==
To calibrate the S Meter, a signal equal to S9 (-73 dBm) is injected into the sdr and the soundcard gain is adjusted until the S meter reads S9. It will then probably be necessary to adjust the spectrum [[#Setting the noise floor | noise floor]] level.

A subjective calibration may be performed by tuning into a signal considered S9 and performing the above procedure.

== VFO and Split selection ==

== Using RIT ==

== Changing bands ==

== Using Quick Memories ==

== Using subRx ==
To be constructed

== The Menu choices ==

=== Receiver ===
''Connect/Disconnect''

You can connect to a server either by selecting the server in the Configure > Server list and then click Connect, or by selecting the server in the Quick Server List and click connect.

After you Disconnect from a server, you must wait at least 10 seconds for the disconnection to take full effect before connecting to another server. This is to allow the internet connection to really disconnect (remember there is network latency and the server will continue to send data till its buffers are emptied). Failure to do so will often result in error in QtRadio and may even hang QtRadio.

''Quick Server List''

If you see that a public server's status is "Busy", please '''do not''' connect to it. Doing so will disrupt the user already connected. If you see a server's status is "Idle" or "0 client(s)", you can connect to it. If you see "1 client(s)" or "2 client(s)" etc., you are sharing a connection to the same server. The first client is the master who has control over the vfo and Tx etc., and you will be connecting as a slave. You will only be able to listen to the audio and see the spectrum passively as an observer. When the clients before you disconnect, you will automatically become the master. This is a queuing mechanism.

''Configure > Audio''

If you are connecting to a public server on the Internet (ie not your own server on your LAN), '''please''' set Audio to 8000, aLaw, and 1 channel. If you use other settings, your QtRadio and/or the dspserver/server will hang.

=== Audio ===

=== Band ===
The band menu allows selection of a band by clicking on the desired entry. Clicks on an already selected entry steps to the next memory position and sets the stored frequency, mode, filter and spectrum/waterfall settings.
The status line on the bottom right hand side of the window will display ... Band, Memory position, Mode, Filter and whether using memory or vfo.

=== Mode ===
=== Filter ===
=== Noise Reduction ===
=== AGC ===
=== Spectrum ===
=== Hardware ===
=== Bookmarks ===

== Transmit commands ==

== Keyboard Shortcuts ==
* Arrow Left/Right Tune Down/Up the active VFO
* Arrow Up/Down Increase /Decrease Step Size above
* lowercase a = VFOA
* lowercase b = VFOB
* lowercase c = Connect
* lowercase d = Disconnect
* lowercase k= Bring up Keypad entry window
* lowercase l = Bring up Quick Connect Window
* lowercase s = toggle SubRX

== Using the Griffin Powermate USB Dial as VFO Knob ==
=== The Griffin Powermate USB DIal ===
[[File:powermate_.png|200px]]

The Griffin Powermate has a single wheel and a pushbutton, which is
able to do the following actions:

<pre>
1. Rotate Clockwise
2. Rotate Counterclockwise
3. Push Down and Rotate Clockwise
4. Push Down and Rotate Counterclockwise
5. Push Down
6. Long Push Down
7. Responisve Blue LED's
</pre>

So we have 6 possibilities to map to keystrokes, soundcard levels and so on.

In Windows you may refer to the following Document published by FlexRadio. Install the Powermate Software for Windows and map your wanted keys.

http://support.flexradio.com/Downloads.aspx?id=47

=== Download Gizmod ===

In Linux there is Gizmo Daemon - THE Linux Linux Input Device Utility.

Unfortunately Gizmo is no longer supported by Ubuntu and most other Linux Distributions. The last update on the Gizmo page was in 2009.

So the following Setup is experimental until we may have support for the Powermate in QtRadio or Hamlib directly.

1. Go to your preferred local git directory.
<pre>
$ git clone git://github.com/jtriley/gizmod.git
</pre>

<pre>
$ cd gizmod
</pre>

Make the following two patches:

<pre>
index 14b8d37..b61e2a1 100644
--- a/libH/Average.hpp
+++ b/libH/Average.hpp
@@ -35,6 +35,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

You may apply the above patch manually by:
<pre>
$ gedit libH/Average.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

Do the same with the following patch:

<pre>
index d794055..75f4c27 100644
--- a/libH/DynamicBuffer.hpp
+++ b/libH/DynamicBuffer.hpp
@@ -33,6 +33,7 @@
#include "config.h"
#endif

+#include <stddef.h>
#include <vector>
</pre>

<pre>
gedit libHDynamicBuffer.hpp
</pre>

make sure that you have the following #include's in that file:
<pre>
#include "config.h"
#include <stddef.h>
#include <vector>
</pre>

<pre>
$ gedit cpuusage.cpp
</pre>

add

<pre>
#include <cstring>
</pre>

<pre>
$ sudo apt-get install libboost-all-dev
</pre>

<pre>
$ mkdir build
$ cd build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr -DSYSCONF_INSTALL_DIR=/etc ..
$ make
</pre>

If you still get an error do:

<pre>
$ gedit gizmod/CMakeFiles/gizmod.dir/link.txt
</pre>

and add:

<pre>
-lboost_system
</pre>

<pre>
$ make
$ sudo make install
</pre>

=== Setup Gizmod ===

Go to your user directory and do:
<pre>
$ mkdir -p .gizmod
</pre>

<pre>
$ cp /usr/etc/gizmod * .gizmod
</pre>

<pre>
$ mkdir .gizmod/modules.d
</pre>

<pre>
$ cp /usr/etc/gizmod/modules.d/000-CatchAllDebug.py .gizmod/modules.d/
$ cp /usr/etc/gizmod/modules.d/299-Powermate-Default.py .gizmod/modules.d/
</pre>

<pre>
$ cd .gizmod/modules.d
</pre>

<pre>
$ gedit 299-Powermate-Default.py
</pre>

Edit 299-Powermate-Default.py like this (Do not change the Filename and edit exactly)

<pre>
#***
#*********************************************************************
#*************************************************************************
#***
#*** GizmoDaemon Config Script
#*** Powermate Default config
#***
#*****************************************
#*****************************************
#***

"""

Copyright (c) 2007, Gizmo Daemon Team
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

"""

############################
# Imports
##########################

from GizmoDaemon import *
from GizmoScriptDefault import *
import time

ENABLED = True
VERSION_NEEDED = 3.2
INTERESTED_CLASSES = [GizmoEventClass.Powermate]

############################
# PowermateDefault Class definition
##########################

class PowermateDefault(GizmoScriptDefault):
"""
Default Powermate Event Mapping
"""

############################
# Public Functions
##########################

def onDeviceEvent(self, Event, Gizmo = None):
"""
Called from Base Class' onEvent method.
See GizmodDispatcher.onEvent documention for an explanation of this function
"""

# Check for rotations
if Event.Type == GizmoEventType.EV_REL:
if Gizmo.getKeyState(GizmoKey.BTN_0):
if Gizmod.DefaultMixerVolume:
Gizmod.DefaultMixerVolume.VolumePlayback = Gizmod.DefaultMixerVolume.VolumePlayback + Event.Value
else:
# scroll quickly (by pages using the page up / page down keys)
if Event.Value < 0:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_RIGHT)
else:
for repeat in range(abs(Event.Value)):
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_LEFT)
return True
elif Event.Type == GizmoEventType.EV_KEY:
if Event.Value == 0 and not Gizmo.Rotated:
Gizmod.Keyboards[0].createEvent(GizmoEventType.EV_KEY, GizmoKey.KEY_PLUS)
return True
return False

############################
# Private Functions
##########################

def __init__(self):
"""
Default Constructor
"""

GizmoScriptDefault.__init__(self, ENABLED, VERSION_NEEDED, INTERESTED_CLASSES)

############################
# PowermateDefault class end
##########################

# register the user script
PowermateDefault()
</pre>

<pre>
$ gizmod
</pre>

you should see the following output:(depends on your system)

<pre>
GizmoDaemon v3.4 -=- (c) 2007, Tim Burrell <tim.burrell@gmail.com>
=---------=

Registering Devices:

Standard - Directory [input]
Standard - Sleep Button [event0] vId: 0x0 pId: 0x3
Standard - Lid Switch [event1] vId: 0x0 pId: 0x5
Standard - HDA Intel Mic [event10] vId: 0x0 pId: 0x0
Standard - HDA Intel Mic [event11] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event12] vId: 0x0 pId: 0x0
Standard - HDA Intel Headphone [event13] vId: 0x0 pId: 0x0
Standard - Power Button [event2] vId: 0x0 pId: 0x1
Keyboard - AT Translated Set 2 keyboard [event3] vId: 0x1 pId: 0x1
Standard - Asus Laptop extra buttons [event4] vId: 0x0 pId: 0x0
Powermate - Griffin PowerMate [event5] vId: 0x77d pId: 0x410
Standard - CNF7237&CNF7238 [event6] vId: 0x17ef pId: 0x4808
Mouse - SynPS/2 Synaptics TouchPad [event7] vId: 0x2 pId: 0x7
Standard - Video Bus [event8] vId: 0x0 pId: 0x6
Standard - HDA Intel HDMI/DP,pcm=3 [event9] vId: 0x0 pId: 0x0

Loading User Scripts:

CatchAllDebug - CatchAll Event Mapping for Testing
PowermateDefault - Default Powermate Event Mapping
</pre>

You should have the following functions:

<pre>
turn left = KEY RIGHT
turn right = KEY LEFT
press and turn left = System Volume down
press and turn right = System Volume up
Buttonpress = cycle through Step Size
</pre>

QtRadio - Operation

2011-11-13T11:22:55Z

Zl2apv: /* Setting the noise floor */

QtRadio - Operation

2011-11-13T11:20:36Z

Zl2apv: /* Calibrating the S meter */

QtRadio - Operation

2011-11-13T11:19:12Z

Zl2apv: /* Calibrating the S meter */

QtRadio - Operation

2011-11-13T11:16:23Z

Zl2apv: /* Calibrating the S meter */

QtRadio - Operation

2011-11-13T11:10:50Z

Zl2apv: /* Setting the noise floor */

QtRadio - Operation

2011-11-13T11:08:44Z

Zl2apv: /* Setting the noise floor */

QtRadio - Operation

2011-11-13T10:54:43Z

Zl2apv: /* Fixed frequency radio */

QtRadio - Operation

2011-11-13T10:53:37Z

Zl2apv: /* Fixed frequency radio */

QtRadio - Operation

2011-11-13T09:20:41Z

Zl2apv: /* Fixed frequency radio */

=== Connecting to a server ===

== Tuning the radio ==
=== Fixed frequency radio ===
For crystal locked radios such as the softrock lite II or YU1LM sdr's It is necessary to use [[Using subRx | subrx]]. The procedure is to set vfoA to your centre frequency, usually the crystal frequency / 4 and leave it alone as changing it will affect your centre frequency. Using the button on the vfo panel or the 'Receiver' Menu / subRx choice switch on the subRx. You can now tune within the limits of the sample rate of your sound card (48, 96 or 192 KHz) with your centre frequency offset from centre by 9 KHz.

Note there is still a bug in the display where the lower 9 KHz wraps to the upper 9 KHz but the audio doesn't track the spectrum so you lose 9 KHz of possible bandwidth.

=== si570 tunable radio ===

== Setting the noise floor ==

== Calibrating the S meter ==

== VFO and Split selection ==

== Using RIT ==

== Changing bands ==

== Using Quick Memories ==

== Using subRx ==
To be constructed

== The Menu choices ==

=== Receiver ===
=== Audio ===
=== Band ===
=== Mode ===
=== Filter ===
=== Noise Reduction ===
=== AGC ===
=== Spectrum ===
=== Hardware ===
=== Bookmarks ===

== Transmit commands ==