readme

This a framework to test new ideas in transmission technology. Actual development is a LDPC-coder in

cch
===

 This module allows to encapsulate an arbitrary data-structure, that is
protected by a CRC and then handled further on.



copy
====

As the software-radio doesn't accept one output that is connected
to multiple inputs, you have to put this copy-module in between.



image
=====

Allows to send a fixed image over a channel. It is used as a demonstration
to compare different transmission schemes.



join
====

This block joins two complex sub-streams into a single stream:
                          figure:
in1: 1 3 5 7 ------
                   |----- 1 2 3 4 5 6 7 8 : out
in2: 2 4 6 8 ------



random
======

 Produces uniform random-numbers in the range 0-255. The random-number
generator is based on a simple polynomial, so it's not really high-class.
 The seed may be set to a positive number, so that subsequent tests yield
the same random numbers. This is useful in testing environments.



rnddouble
=========

Generates random numbers with double-precision. The resolution of the
random-numbers should be in the range of 2^-32 * range. Two outputs exist:
one for real numbers and one for complex numbers. Chose the appropriate
one, and the numbers will be calculated for this output.



rndstr
======

This module outputs 4 strings sequentially, each time it is called. The
4 outputted strings are configurable.



macro_sch
=========

The System CHannel controls things like slot-allocation and power-control.



sink
====

 Works as a display of what has been received. There are different inputs
to deserve different sources:
input 0: U8
input 1: SYMBOL_COMPLEX
input 2: DOUBLE
input 3: DOUBLE_COMPLEX
 Just by connecting to the appropriate port, you will activate the display
of this given port.
 Additionaly one can set the 'size' in small chains where no module has
given any size yet.



source
======

This module has two outputs: one for sending a pre-defined string (that
can be adjusted), the other for sending SYMBOL_COMPLEX signals. Depending
on config->complex_type, it outputs either a stream of zeroes, a given
data, or config->complex_type * ( 1 + I ).



split
=====

This module takes a complex input-stream and creates two output-streams,
one for the odd symbols, the other for the even symbols:



tcpip
=====

Give a general description of the module in here



test_data
=========

 The goal of this module is to test a given coding-algorithm with
respect to it's performances.
 This module offers two parts: one sending part, "test_data_send", 
where random chars are sent through two output-ports and a receiving part, 
"test_data_rcv", that takes two streams of random chars. In the sending 
 part, both streams are identical.
One stream shall go through the module that needs to be tested, 
the other goes through a mostly error-free path. The receiving module
then compares the two and prints out the BER.