Skip to content

Commit

Permalink
Quisk version 4.2.29
Browse files Browse the repository at this point in the history
  • Loading branch information
@jimahlstrom
jimahlstrom committed Jan 11, 2024
1 parent 15375aa commit 26773d5
Show file tree
Hide file tree
Showing 20 changed files with 353 additions and 308 deletions.
9 changes: 9 additions & 0 deletions CHANGELOG.txt
View file
Original file line number Diff line number Diff line change
@@ -1,3 +1,12 @@
Quisk Version 4.2.29 January 2024
==================================
This version updates the FreeDV library files and program logic. I added a "Monitor"
item to the FreeDV menu. It routes the sound to the speakers instead of to the demodulator.
Turn on both the monitor and FDX to listen to your transmitted FreeDV signals. Please test.

Modes 700x and 1600 are finished. The other modes will be added shortly. If you use any of them
post here and I will move them to the top of the list.

Quisk Version 4.2.28 December 2023
===================================
This version includes a patch from Jon, AB8WU, to build Quisk on FreeBSD. Thanks Jon!
Expand Down
230 changes: 77 additions & 153 deletions docs.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -131,7 +131,7 @@ <h1>
<h2>News</h2>
<p>
The newest versions of Linux and Raspberry Pi OS do not allow installing Quisk in the system Python package directory.
I am working on a solution for this.
Use the Linux Source Installation below instead.
</p>
<br>
<p>
Expand Down Expand Up @@ -189,23 +189,22 @@ <h2 id="Credits">Credits </h2>
<h2 id="Installation">Installation</h2>
<p>
Quisk is free open source software written in Python and C. It is hosted on the PyPi repository
<a href="https://pypi.org">https://pypi.org</a>.
It can be installed using the standard Python setup tools. See specific directions below.
<a href="https://pypi.org">https://pypi.org</a> and it is available on github.
</p>
<br>
<p>
If you have Python 3 installed on your computer, just continue to use that version.
<b>Quisk requires Python 3.8 or 3.9 or 3.10 or 3.11.</b>
If you want to install a more recent version, uninstall the old version first.
<b>On Windows Quisk requires Python 3.8 or 3.9 or 3.10 or 3.11.</b>
If you want to install a more recent version of Python, uninstall the old version first.
Running multiple versions of Python is possible but can be confusing and is not necessary.
A Quisk installation is needed for each version of Python you have.
</p>
<br>
<h3 id="g0.2.2">Windows Initial Installation</h3>
<p>
Windows does not include Python, so you must first install the most recent version of 64-bit Python 3.
Windows does not include Python, so you must first install a recent version of 64-bit Python 3.
If you already have 64-bit Python 3 installed, just keep using it.
<b>Quisk requires Python 3.8 or 3.9 or 3.10 or 3.11.</b>
<b>On Windows Quisk requires Python 3.8 or 3.9 or 3.10 or 3.11.</b>
There may be newer versions of Python, but until support is added, use the versions listed above.
Python is available from <a href="http://www.python.org/">http://www.python.org</a>.
There is an option to <b>Add Python to PATH</b>. You MUST select
Expand Down Expand Up @@ -280,186 +279,111 @@ <h3>Windows Uninstall Quisk</h3>
</p>
<h3 id="g0.2.1">Linux Initial Installation</h3>
<p>
<br>
The libsoundio-dev module is NO LONGER required!
<br>
<br>
Linux runs on a wide variety of computers with different processors and versions of Linux.
Therefore Quisk is compiled for each one. To do this, Python and a number of other packages are required.
Most likely both Python2 and Python3 are already installed on your computer. Either the 32-bit or 64-bit
version will work. On my Ubuntu machine, "python2" starts Python2 and "python3" starts Python3.
Most likely both Python2 and Python3 are already installed on your computer.
On my Ubuntu machine, "python2" starts Python2 and "python3" starts Python3.
Just "python" starts Python2, but this will change as Python2 is phased out.
Python2 is obsolete, so you should only install Quisk to Python3, and use "python3" to start it.
Install these packages. Some of these can be installed from Python using "pip",
but it is better to use your package manager because pip and the package manager do not coordinate.
<b>Python2 is obsolete</b>, so you should only install Quisk to Python3, and use "python3" to start it.
Install these packages by using your package manager, not Python pip.
If newer versions of these packages become available, Linux will notify you.
Use the most recent version of python3-wxgtk available.
Use the most recent version of python3-wxgtk available for your Python version.
<br><br>
</p>
<table>
<tr>
<th>Package Description</th>
<th>Python3 Package</th>
</tr>
<tr>
<td>Discrete fourier transform</td>
<td>sudo apt-get install libfftw3-dev</td>
</tr>
<tr>
<td>Alsa sound library</td>
<td>sudo apt-get install libasound2-dev</td>
</tr>
<tr>
<td>Portaudio sound library</td>
<td>sudo apt-get install portaudio19-dev</td>
</tr>
<tr>
<td>Pulseaudio sound library</td>
<td>sudo apt-get install libpulse-dev</td>
</tr>
<tr>
<td>Python development</td>
<td>sudo apt-get install python3-dev</td>
</tr>
<tr>
<td>Python library development</td>
<td>sudo apt-get install libpython3-dev</td>
</tr>
<tr>
<td>wxPython GUI library</td>
<td>sudo apt-get install python3-wxgtk4.0</td>
</tr>
<tr>
<td>Python USB</td>
<td>sudo apt-get install python3-usb</td>
</tr>
<tr>
<td>Python serial port</td>
<td>sudo apt-get install python3-serial</td>
</tr>
<tr>
<td>Python installation tools</td>
<td>sudo apt-get install python3-setuptools</td>
</tr>
<tr>
<td>Pip package installer</td>
<td>sudo apt-get install python3-pip</td>
</tr>
</table>
<p>
<br><br>
If you want to use the SoapySDR module make sure that SoapySDR is installed from its Pothosware site before you build Quisk.
Otherwise Quisk will not have the files it needs. You can install SoapySDR later, but then you
will need to reinstall Quisk. This is also true of any other external packages that have their own C source.
<br>
<br>
These are part of your operating system. You only install them once unless it changes.
</p>
<h3>Linux Pip Installation</h3>
<p>
You can use the Python program "pip" to install Quisk into the Python package directory. This is the easiest
method, but it will not install the source files. If you want the source files see below.
<br>
<br>
sudo -H python3 -m pip install --upgrade quisk
<br>
<br>
This will install the Python files and all other files except for the C source. This is the easiest method
if you do not want to work in C.
To run Quisk, use this command from a terminal:
<br>
<br>
python3 -m quisk
<br>
<br>
You can create a panel launcher on your desktop with the command to run Quisk.
<br>
<br>
If the installation of Quisk fails, you can force re-installation:
<br>
<br>
</p>
<pre>
sudo -H python3 -m pip uninstall quisk
sudo -H python3 -m pip install --no-cache-dir --force-reinstall quisk
sudo apt-get install libfftw3-dev
sudo apt-get install libasound2-dev
sudo apt-get install portaudio19-dev
sudo apt-get install libpulse-dev
sudo apt-get install python3-dev
sudo apt-get install libpython3-dev
</pre>
<p>
<br>
You can also install an older version of Quisk. You may need to do that if the most recent version fails for some reason. Use:
<br>
<br>
sudo -H python3 -m pip install quisk==4.1.51
<p>
These are part of Python. You only install them once unless the Python started by "python3" changes.
</p>
<br>
<pre>
sudo apt-get install python3-wxgtk4.0
sudo apt-get install python3-usb
sudo apt-get install python3-serial
sudo apt-get install python3-setuptools
</pre>
<br>
To get started you must tell Quisk what kind of radio hardware you have. Press the Config button and select Radios.
Then set your sound devices for that radio; the device for the radio speakers, the microphone and so forth. All configuration
is (mostly) from the Config button. Ignore old directions and don't bother with a config file.
<p>
If you want to use the SoapySDR module make sure that SoapySDR is installed from its Pothosware site before you build Quisk.
Otherwise Quisk will not have the files it needs. You can install SoapySDR later, but then you
will need to run "make" again. This is also true of any other external packages that have their own C source.
<br>
<br>
To edit the Quisk Python files you need to know where they are. To find out, import quisk and print it:
</p>
<h3>Linux Pip Installation</h3>
<br>
<p>
<b> Installation of Quisk using Python tools like pip is deprecated</b>.
</p>
<br>
<p>
Installation to the system Python is no longer allowed, and you may get the message "error: externally-managed-environment".
If you used pip to install Quisk you can continue to upgrade with "sudo python3 -m pip install --upgrade quisk"
until you get this error message. But it is best to uninstall the pip Quisk. If you installed with pipx, uninstall that too.
</p>
<br>
<pre>
jim@IntelNUC:~$ python3
Python 3.6.9 (default, Oct 8 2020, 12:12:24)
[GCC 8.4.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
--- import quisk
--- quisk
module 'quisk' from '/usr/local/lib/python3.6/dist-packages/quisk/__init__.py'
---

sudo python3 -m pip uninstall quisk
pipx uninstall quisk
</pre>
<br>
<h3>Linux Pip Upgrade</h3>
<p>
To upgrade to a newer version of Quisk, use pip:
<br>
<br>
sudo python3 -m pip install --upgrade quisk
Then use the Linux Source Installation.
</p>
<br>
<br>
<h3 id="LSI">Linux Source Installation</h3>
<p>
On Linux, Quisk is installed from github, and it is contained in a "quisk" directory. First you need to decide where to put the
quisk directory. Anywhere will do, but it is best to use a directory where you have write permission so
you don't need to use "sudo". The examples below assume you used your home directory indicated by "~". Just replace "~"
by your desired location.
</p>
<h3>Linux Uninstall Quisk</h3>
<br>
<p>
sudo python3 -m pip uninstall quisk
To install a fresh copy of Quisk, change to your desired directory, clone the github site, change to the quisk directory and run "make".
Then run the python program quisk.py.
</p>
<br>
<pre>
cd ~
git clone https://github.com/jimahlstrom/quisk
cd quisk
make
python3 quisk.py
</pre>
<br>
<h3>Linux Source Installation</h3>
<p>
The previous method using pip is simple, but will not install the C source files. If you want those proceed as follows.
Go to <a href="https://pypi.org/project/quisk/">https://pypi.org/project/quisk</a> and under "Navigation"
select "Download files". Download the quisk-x-x-xx.tar.gz file. This is the source file. The ".whl" files are for Windows.
Change directory to where the file was downloaded, probably "Downloads", and uncompress and untar it.
<br><br>
cd ~/Downloads
<br>
tar zxf quisk-x.x.xx.tar.gz
<br><br>
Change directories to the Quisk directory:
<br><br>
cd quisk-x.x.xx
<br><br>
Now compile Quisk with the "make" command:
<br><br>
make quisk3
<br><br>
If "make" fails, you probably have missing packages or missing "-dev" packages. Try to figure out what is missing from the error messages.
Now you can run quisk with the command:
<br><br>
python3 quisk.py
<br><br>
At this point you have a choice of where to install Quisk. You could just rename the quisk-x.x.xx directory
to a more convenient name, like "quisk" in your home directory, and run Quisk from there.
This is convenient if you want to
alter the Quisk code. Or you could install Quisk into the Python system.
<br><br>
python2 setup.py build
You only clone github for the initial installation. To update Quisk, use pull:
</p>
<br>
sudo python2 setup.py install
<br><br>
<pre>
cd ~/quisk
git pull
</pre>
<br>
<p>
You run Quisk by running the file quisk.py with python3. For example, "python3 /home/jim/quisk/quisk.py".
You can create a desktop icon to do that, but the method depends on your version of Linux.
<b>Never run Quisk with root privelege by using sudo. Fix the permission problem instead.</b>
To get started you must tell Quisk what kind of radio hardware you have. Press the Config button and select Radios.
Then set your sound devices for that radio; the device for the radio speakers, the microphone and so forth. All configuration
is (mostly) from the Config button. Ignore old directions and don't bother with a config file.
To uninstall Quisk, just delete the quisk directory.
</p>
<br>
<h3 id="g0.2.4">Quisk Files</h3>
<p>
<br>
Expand Down
2 changes: 1 addition & 1 deletion filters.h
View file
Original file line number Diff line number Diff line change
Expand Up @@ -586,7 +586,7 @@ double quiskAudio24p6Coefs[36] = { 0.001199140008010727, 0.005953815908571521, 0
-0.008973143363910490, 0.011839435384729619, 0.003122601697996235, -0.008665733839154772, -0.000319602525571569, 0.008621055763448699,
0.005953815908571521, 0.001199140008010727} ;

// Sample 48 kHz, pass 6, stop 8, ripple 0.5 dB, atten 80 dB. Stop 0.16667.
// Sample 48 kHz, pass 6, stop 8, ripple 0.5 dB, atten 80 dB. Pass 0.125. Stop 0.16667.
double quiskAudio48p6Coefs[71] = { 0.000324677779792651, 0.001038192405843851, 0.002082337464742640, 0.002938055116822665,
0.002811674671240099, 0.001132278163758895, -0.001835394694865431, -0.004766409947196539, -0.005833007003128954, -0.003914015660218843,
0.000296099005521212, 0.004239593489554206, 0.004918390640978499, 0.001100872619673516, -0.005241634309386784,
Expand Down
Loading

0 comments on commit 26773d5

Please sign in to comment.