= FlexWaves Project =

This project maintains waveforms and components for the [wiki:ALOE ALOE Project]. 

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 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 ALOE release in the QuickStartGuide page. This page just describes the applications and some important notes about them. 

== ALOE Signal Processing Components ==

The following table summarizes the available components. 

|| '''Module Name''' || '''Description''' ||
|| gen_cconv/gen_viterbi || Generic convolutional coder and decoder, customizable polynomial and constraint length||
|| gen_decimator ||Customizable decimator or interpolator||
|| gen_interleaver || Generic interleaver with row and column permutation support ||
|| gen_source/gen_binsource || Generic bitstream or signal source ||
|| gen_chmux || Generic N:M signal multiplexer ||
|| gen_timemux || Generic time serial multiplexer ||
|| gen_channel_gauss || AWGN generator ||
|| 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 ||


== ALOE Waveforms ==

The following waveforms are available:
  * Digital Modem
  * UTRAN transmitter/receiver
  * UTRAN Turbo encoder/decoder only
  * WiMAX transmitter/receiver (with convolutional code)
  * WiMAX LDPC encoder/decoder only

=== 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:
{{{
runph$: phload modem
}}}

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:

binsource(*) -> crc(*) -> coder(*) -> ratematching(*) -> interleaving(*) -> timemux(*) -> trchmux -> interleaving -> channel

Where (*) indicates that two transport channels transmit in parallel. The receiver chain implements the same modules in the opposite direction.

- The coder is a UMTS Turbo Coder for the data channel and a Convolutional Coder for control . 
- The ratematching component is specifically designed for the UMTS chain and can not be configured to operate in another context.

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). All components of each transport channel can operate at higher periods (20, 40, 80 ms). The component 'timemux' performs a time (de)-multiplexing of data frames and delivers 1 packet every 10ms to the channel. 

The application can be loaded launching the following command on the runph command prompt:
{{{
runph$: phload utran
}}}

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:

{{{
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

=== UTRAN Turbo encoder/decoder ===

This simple waveform just consists on a data binary generator, Turbo encoder and decoder and a gaussian channel simulator.   

The application can be loaded launching the following command on the runph command prompt:
{{{
runph$: phload utrantdec
}}}

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:
      * 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: 
      * ''!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:

{{{
runph$: statset utrantdec 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
}}}

[[BR]]

[.. Back to Main Page]