readme

软件无线电的平台

ldpc_2fold_general
==================


 LDPC codes are Low Density Parity Check codes used in favor of
convolutional codes. Usually they are calculated on a SISO channel.
This module tries to enhance the case for a 4x4 MIMO channel. The
theory has been written down by Nicolae Chiurtu.


ldpc_decode_2fold_general
-------------------------

LDPC-decoder using the 2fold-techinque to decode a stream coming from a
MIMO environment.

Inputs:
	SYMBOL_COMPLEX[4]

outputs:
	U8

Config:
	chest [MAX_NO_RX]<int>: [-1 -1 -1 -1]
		Block-id of the ChEst  blocks. They will provide H

	iterations<int>: 30
		The total iteration-number. For each iteration, iterations_left
		followed by iterations_right are done.

	iterations_left<int>: 1
		How many iterations to the left are done per total iteration

	iterations_right<int>: 1
		How many iterations to the right are done per total iteration

	ldpc_code_id<int>: 1
		The ID of the LDPC code

	no_rx<int>: 4
		How many output channels

	no_tx<int>: 4
		How many input channels


Stats:
	snr<double>:
		The calculated SNR in case of a AWGN channel


ldpc_decode_2fold_general_ics
-----------------------------

LDPC-decoder using the 2fold-techinque to decode a stream coming from a
MIMO environment.

Inputs:
	SYMBOL_COMPLEX[4]

outputs:
	U8

Config:
	channel_param<double>: 0.07
		'a/variance' for AWGN

	chest [MAX_NO_RX]<int>: [-1 -1 -1 -1]
		Block-id of the ChEst  blocks. They will provide H

	drop_blocks<int>: 0
		How many blocks to drop

	iterations<int>: undef
		The total iteration-number. For each iteration, iterations_left
		followed by iterations_right are done.

	iterations_left<int>: undef
		How many iterations to the left are done per total iteration

	iterations_right<int>: undef
		How many iterations to the right are done per total iteration

	ldpc_code_id<int>: 1
		The ID of the LDPC code

	no_rx<int>: 4
		How many output channels

	no_tx<int>: 4
		How many input channels


Stats:
	snr<double>:
		The calculated SNR in case of a AWGN channel


ldpc_encode_2fold
-----------------

 Encodes a slot. Needs to have a modulator-module with a QPSK
modulation.

Inputs:
	U8

outputs:
	U8

Config:
	bplcn<int>: 0
		Bits per left check node, for a QPSK transmission, this is
		the number of TX-antennas * 2

	ldpc_code_id<int>: 1
		The index of the ldpc-code. For the moment, three codes
		are implemented:
		1 - rate .25, size 4000
		2 - rate .5, size 3992
		3 - rate .75, size 3992