NAME

       quisk - a Software Defined Radio (SDR)

DESCRIPTION

       QUISK  is  the  software  that  controls  a  receiver  and transmitter.  QUISK rhymes with
       "brisk", and is QSK plus a few letters to make it easier to pronounce. QSK is a  Q  signal
       meaning  full  breakin  CW,  and QUISK has been designed for low latency CW operation.  It
       works fine for SSB and AM too.

       It currently runs under Linux using ALSA sound drivers or PortAudio
              and offers these capabilities:

              Quisk can control the HiQSDR.

              As a receiver it can use the SDR-IQ by RfSpace  as  a  sample  source.   There  are
              several  decimation  rates  available.  The screen shots below were taken using the
              SDR-IQ.  The QUISK receiver  will  read  the  sample  data,  tune  it,  filter  it,
              demodulate  it,  and  send  the  audio  to  the  sound  card for output to external
              headphones or speakers.

              As a receiver it can use your soundcard as a sample source.  You supply  a  complex
              (I/Q) mixer to convert radio spectrum to a low IF, and send that IF to the left and
              right inputs of the sound card in your computer.  The demodulated audio goes to the
              same soundcard for output.

              Quisk can control SoftRock hardware for both receive and transmit.

              As  a  transmitter  it  can  control  my   SSB/CW exciter  and my transceiver using
              Ethernet.

              As a transmitter it can accept microphone input and send that to  your  transmitter
              for  SSB  operation.   For CW, QUISK can mute the audio and substitute a side tone.
              Quisk can send transmit data to your sound card for use with SoftRock  or  similar.
              If  you are not using SoftRock hardware and not using Ethernet, then you can modify
              the C code in microphone.c to connect to your hardware.

              If you have the SDR-IQ or the Softrock hardware, then QUISK is ready for you to use
              as  a  receiver.   If you have other receive hardware, then you will need to change
              the file quisk_hardware.py to connect your receiver to QUISK.  For example, if  you
              change   your   VFO  frequency  with  a  serial  port,  then  you  need  to  change
              quisk_hardware.py  to   send   characters   to   the   serial   port.    The   file
              quisk_hardware.py  is  written  in  the  Python  programming  language, a very easy
              language to learn and use.

SETUP

       Some deployments of quisk will only need to use sound hardware with  ALSA.   Other  setups
       will use serial ports (or USB serial ports) and may need permissions set up (perhaps using
       udev) to allow the quisk program's user  access  to  those  ports.  See  documentation  in
       /usr/share/doc/quisk for more information, as well as configuration file examples.

       The default configuration file is ~/.quisk_conf.py

       The configuration file must be customized for the user (see the commented examples) before
       running quisk.

SYNOPSIS

       quisk [options]

OPTIONS

       -h, --help
              show this help message and exit

       -c CONFIG_FILE_PATH, --config=CONFIG_FILE_PATH
              Specify the configuration file path

       --config2=CONFIG_FILE_PATH2
              Specify a second configuration file to read after the first

SEE ALSO

       http://james.ahlstrom.name/quisk/

       Sample config files are in /usr/share/doc/quisk/quisk_conf*
              copy one, edit and save as ~/.quisk_conf.py

       For use with a Funcube Dongle see the program
              qthid in package qthid-fcd-controller.