Read Me

General
=======

The software in this distribution is developed to work with
the 'CU AAU SiGe SE4110L-EK3' L1 band GNSS data acquisition module 
as a tool for both teaching and learning software GNSS receiver
techniques. The software is licensed under GNU GPL version 2.
License agreement is enclosed in file COPYING_GPL.txt

The software has been designed to work under WinXP and tested 
only under that platform.

Please note that the module and software have been developed
to keep costs as low as possible.  Thus it will not be possible
to support the device/software beyond this simple readme and 
files bundled here.

We have tested the module and software on a number of different
platforms with about a 95% success rate (some USB chipsets (Intel-
based) seem to work better than others.  If having issues on one 
platform, a different platform should work.  In order to allow 
users to try and resolve issues and simplify development, the 
code associated with project has been built on the open source
philosophy and all source code has been included.

Note: the module has been designed for an active antenna.  The
module is powered by the host USB port and provide the USB voltage
(~5V for this purpose).  It is unlikely to power "hungry" amplifiers
or do well in the event of a short.

More details may be found here: http://ccar.colorado.edu/gnss  

THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY
KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR
PURPOSE.


Installation
============

Run the shell script "install.sh" i.e.

sh install.sh

you will need to be a sudoer and enter your password when prompted.


Usage
=====

This command line application requires only one parameter to
run, that is the name of the file where to save data. By
running the application at any time without any parameters
will view the usage options as below:


 ----
 GN3S - GNSS IF Streamer
 ----

        Usage:

        GN3S [drive:\][path\]filename [options]

        Options:

        -s filesize : Number of MB to collect (1-625), default: 32 MB
        -m          : Buffer data in memory, default: no buffering
                      <can be useful for slow hard drives, but requires
                      a significant amount of available physical memory>



No default suffix will be appended to the filename and the use
of '.bin' is encouraged, as well as having a separate directory
designated to saving GNSS data. The user will NOT be prompted
when saving data to an existing file. The old data WILL be
overwritten.


Data processing
===============

This toolkit provides the user with up to 40 seconds of data
with the following parameters:

Fsa = 16.3676 MHz
IF = 4.1304 MHz
BW = ~2 MHz

Data is saved as 8 bit signed values, corresponding to 'int8'
in Matlab.

With "A Software-Defined GPS and Galileo Receiver: A Single-
Frequency Approach", K. Borre, D. Akos, et.al. (ISBN: 0817643907)
comes a DVD containing Matlab based processing algorithms well
suited for processing this kind of data.

Enjoy!