Changes between Version 14 and Version 15 of FlexWaves

Timestamp:

07/29/10 13:28:32 (14 years ago)

Author:

ismael (IP: 62.83.147.103)

Comment:

--

FlexWaves

@@ -1 +1 @@
 = FlexWaves Project =
 
-This folder contains a repository of waveforms currently available for public download and use with ALOE.
+This project maintains waveforms and components for the [wiki:ALOE ALOE Project]. 
 
-The license of this folder may change from one object to another, even from one file to another thus, we encourage the reader to read in each source file the specific license before using and distributing it.
+The license of the components source code may change from one to another, even from one file to another thus, we encourage the reader to read in each source file the specific license before using and distributing it.
 
-Some of the waveforms and/or objects under this folder have been developed by graduate and under-graduate students. This means that the level of optimisation and compliance with the standards is not guaranteed. However, they may be useful for testing purposes or evaluating the performance of the algorithms under different situations or platforms.   
+Some of the waveforms and/or objects under this folder have been developed by graduate and under-graduate students. This means that the level of optimization and compliance with the standards is not guaranteed. However, they may be useful for testing purposes or evaluating the performance of the algorithms under different situations or platforms.   
 
-'''NOTE:''' Waveforms are now being distributed with the ALOE packages. They are already preconfigured and ready to be used. You will find the latest versions in the QuickStartGuide page. This page describes the applications and some important notes about them. 
+'''NOTE:''' Waveforms are now being distributed with the ALOE packages. They are already preconfigured and ready to be used. You will find the latest ALOE release in the QuickStartGuide page. This page just describes the applications and some important notes about them. 
 
-The source for all components can be found at:
-{{{
-http://flexnets.upc.edu/svn/phal/trunk/modules
-}}}
+== ALOE Signal Processing Components ==
 
-And the waveform's description files at:
-{{{
-http://flexnets.upc.edu/svn/phal/trunk/example-repository/swman_apps/
-}}}
-
-== General purpose waveform components ==
-
-The following table summarises the available components. 
+The following table summarizes the available components. 
 
 || '''Module Name''' || '''Description''' ||
@@ -33 +23 @@
 || gen_crc || 8, 12, 16, 24 bit cyclic redundancy check, supporting a generic polynomial ||
 || gen_digitalmodem || BPSK, QPSK, 4-QAM, 8-PSK, 16-QAM digital modulator and demodulator
+|| gen_punct/gen_depunc || Generic Puncturing and de-Puncturing module ||
 || utran_turbocoder || UMTS turbocoder ||
 || utran_turbodecoder || UMTS turbodecoder ||
 || utran_ratem || UMTS Rate Matching ||
+|| wimax_channel || WiMAX SUI channel ||
+|| wimax_ldpc || WiMAX LDPC encoder/decoder ||
+|| wimax_interleaver || WiMAX interleaver/deinterleaver ||
+|| wimax_rsalomon || WiMAX Red-Salomon encoder/decoder ||
+|| wimax_symbolmap || WiMAX Symbol mapper/demapper ||
+|| wimax_rando || WiMAX Randomizer/deRandomizer ||
 
-And the following waveforms are shipped with the ALOE package:
 
-== Digital Modem ==
+== ALOE Waveforms ==
 
-This waveform is a simple digital modem. It can be configured to perform BPSK, QPSK, QAM4, QAM64 and so on. The modulator/demodulator is a single program which can be instantiated as a modulator or demodulator. A binary source and a sink generate and reads random data.
+The following waveforms are available:
+  * Digital Modem
+  * UTRAN transmitter/receiver
+  * WiMAX transmitter/receiver (with convolutional code)
+  * WiMAX LDPC (just the encoder/decoder) 
+
+=== Digital Modem ===
+
+This waveform is a simple digital modem (without channel). It can be configured to perform BPSK, QPSK, QAM4 and QAM16. The modulator/demodulator is a single program which can be instantiated as a modulator or demodulator. A binary source and a sink generate and reads random binary data.
 
 The application can be loaded launching the following command on the runph command prompt:
@@ -48 +52 @@
 }}}
 
-== UTRAN == 
+The waveform can be configured using initialization parameters (at load) or using statistics (at runtime). 
+  * Initialization configuration: In the $ALOE/example-repository/statsman/modem directory, you can edit the following parameters:
+      * source.params: ''numbits'' variable selects the number of bits to generate each time slot.
+      * modulator.params: ''modulation'' variable configures the modulation: 0=BPSK, 1=QPSK, 2=QAM4, 3=PSK8, 4=QAM16
+      * demodulator.params: ''modulation'' variable must match the same variable in the modulator.params file
+      '''Note''': The rest of parameters should not be changed.
+  * Run-time Statistics configuration: 
+      * ''numbits'' variable at the source component. For instance, to generate 4096 bits, issue the following command at the runph command prompt:
+
+{{{
+runph$: statset modem source numbits 4096
+}}}
+
+And the following variables can be captured from the GUI (or reported to a file from the command prompt):
+  * Object: ''modulator'' variables: ''out_signal_i'' and ''out_signal_q'' captures the I/Q output signals 
+
+
+[[BR]]
+
+=== UTRAN ===
 
 This waveform partially implements the bit-level processing of a UTRAN transmitter and receiver. The transmitter part consist on the following modules:
@@ -66 +89 @@
 }}}
 
-== WiMAX ==
+The waveform can be configured using initialization parameters (at load) or using statistics (at runtime). 
+  * Initialization configuration: In the $ALOE/example-repository/statsman/utran directory, you can edit the following parameters:
+      * uectrl_tx.params: ''reference_mode'' Set the UTRAN reference transmission mode: 0=64kbps, 1=144kbps, 2=384kbps  
+      * channelGauss.params: ''EbNo'' Set the channel generated noise level. If 100 dB is selected, no noise computations are performed. 
+      * turbodecoder.params: ''max_iterations'' Set the turbo decoder maximum number of iterations
+      * turbodecoder.params: ''dynHalt'' Set the turbo decoder dynamic halt threshold (stopping criteria)
+      '''Note''': The rest of parameters should not be changed.
+  * Run-time Statistics configuration: 
+      * ''reference_mode'' variable at the uectrl_tx component. 
+      * ''EbNo'' variable at the channelGauss component. 
+      * ''dynHalt'' variable at the turbodecoder component.
+      * ''max_iterations'' variable at the turbodecoder component. For instance, change the maximum number of decoder iterations with the following command:
 
-'''Coming soon'''
+{{{
+runph$: statset utran turbodecoder max_iterations 8 
+}}}
+
+And the following variables can be captured from the GUI (or reported to a file from the command prompt):
+  * Object: ''channelGauss'' variable: ''Signal_Amplitude'' captures 128 samples of the BPSK signal with added noise
+  * Object: ''turbodecoder'' variable: ''realHalt'' minimum log-likelihood value of the last iteration
+  * Object: ''turbodecoder'' variable: ''iterations'' number of performed iterations
 
 
+=== WiMAX ===
+
+
+This waveform partially implements the bit-level processing of a WiMAX transmitter and receiver using the convolutional code (LDPC will be integrated soon). The transmitter part consist on the following modules:
+
+datasource -> Randomizer -> Redsalomon -> Convcoder -> Puncturing -> Interleaver -> Symbolmapper -> channelSUI
+
+- The transmitter reads a file ($ALOE/example-repository/data/rfc793.txt), sends it and stops. The receiver computes bit error rate and prints it.
+
+The waveform must operate at a period of 10ms, so this is the time-slot that should be fixed (see /usr/local/etc/platforms.conf). 
+
+The application can be loaded launching the following command on the runph command prompt:
+{{{
+runph$: phload wimaxbitlevel
+}}}
+
+=== WiMAX LDPC ===
+
+This simple waveform just consists on a data binary generator, LDPC encoder and decoder and bit error rate computation sink component.   
+
+The application can be loaded launching the following command on the runph command prompt:
+{{{
+runph$: phload wimaxldpc
+}}}
+