readme

软件无线电的平台

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.


 In a real radio-case, you usually have something like this:
 
     transmission side:
 random_1 -> test_data_send -> coding -> stfa -> air
 
     reception side:
 air -> decoding -\
                   test_data_rcv
        random_2 -/

by setting the following config-variables at the random-modules:
  config->seed = 0x1234 (or any other value)
  config->mode = 1
you can make sure that both test_data_* modules have the same random-
data to compare with. Furthermore, you can set at the test_data_rcv
the following config-variable:
  config->wait = 1
and call once the random_2 module. Like this, the test_data_rcv has
always the random-data available, and each time it receives some
data from the decoding part, it will perform the bit-comparison and
output the results.


test_data_rcv
-------------

Get a description-part from SPM
Give the following parameters:
Input-ports, output-ports, config-params, stat-params

Inputs:
	U8[2]

Config:
	clear<int>: 0
		Set to one to clear the counter

	mode<int>: 0
		0 - add up total and error
		1 - write a new total and error on each call

	size<int>: 0
		If the chain doesn't have a size-giving module, this config-param
		can be used

	wait<int>: 0
		0 - wait for both inputs
		1 - react already if input 0 is active
		2 - react already if input 1 is active


Stats:
	ber<double>:
		The calculated bit error rate, that is, error / total

	error<int>:
		Number of bits that are different between in0 and in1

	total<int>:
		Number of received bits


test_data_send
--------------

 Usually you'll want to connect a random_u8 with this module, so that
it outputs two streams of random data. But you can also put your own
test-data in front of this module.
 One of the outputs has to be connected to the chain to be tested, while
the other output can be connected directly to the test_data_rcv, at least
in a SRadio/Test-case where you have access to this module.

Inputs:
	U8

outputs:
	U8[2]

Stats:
	total<int>:
		Total number of bytes received. The amount of sent bytes is twice
		as much.