Compound Module APSKLayeredReceiver

Package: inet.physicallayer.apskradio.bitlevel
File: src/inet/physicallayer/apskradio/bitlevel/APSKLayeredReceiver.ned

This receiver model is part of a simple hypothetical layered radio. It receives detailed transmissions that have separate representation for all simulated domains. The levelOfDetail parameter controls which domains are actually simulated, but all parameters relevant to the error model are expected to be set on the reception.

With the highest level of detail, the reception contains the following:

a separate packet to represent the PHY frame
precise bit representation of the whole packet
precise bit representation before descrambling, fec decoding, and deinterleaving
precise symbol representation of the whole packet including physical header
narrowband analog representation using scalar transmission power

NOTE: the current implementation doesn't support pulse filtering and analog digital conversion.

This receiver model supports descrambling, convolutional decoding, deinterleaving, and demodulating various amplitude and phase-shift modulations. The main purpose of this model is to provide a basic infrastructure for further development and experimentation.

Usage diagram:

The following diagram shows usage relationships between types. Unresolved types are missing from the diagram.

Inheritance diagram:

The following diagram shows inheritance relationships for this type. Unresolved types are missing from the diagram.

Parameters:

Name	Type	Default value	Description
levelOfDetail	string	"symbol"
errorModelType	string	"APSKLayeredErrorModel"
decoderType	string	"APSKDecoder"
demodulatorType	string	"APSKDemodulator"
pulseFilterType	string	""
analogDigitalConverterType	string	""
energyDetection	double		TODO: @unit(W) + dBm/dBW <--> W
sensitivity	double		TODO: @unit(W) + dBm/dBW <--> W
carrierFrequency	double
bandwidth	double
snirThreshold	double

Properties:

Name	Value	Description
display	i=block/wrx
class	APSKLayeredReceiver

Source code:

//
// This receiver model is part of a simple hypothetical layered radio. It
// receives detailed transmissions that have separate representation for
// all simulated domains. The levelOfDetail parameter controls which domains
// are actually simulated, but all parameters relevant to the error model are
// expected to be set on the reception.
//
// With the highest level of detail, the reception contains the following:
//  - a separate packet to represent the PHY frame
//  - precise bit representation of the whole packet
//  - precise bit representation before descrambling, fec decoding, and deinterleaving
//  - precise symbol representation of the whole packet including physical header
//  - narrowband analog representation using scalar transmission power
//
// NOTE: the current implementation doesn't support pulse filtering and analog
// digital conversion.
//
// This receiver model supports descrambling, convolutional decoding, deinterleaving,
// and demodulating various amplitude and phase-shift modulations. The main
// purpose of this model is to provide a basic infrastructure for further
// development and experimentation.
//
// See also ~APSKDemodulator, ~APSKDecoder, and ~APSKLayeredTransmitter.
//
module APSKLayeredReceiver like IReceiver
{
    parameters:
        string levelOfDetail @enum("packet","bit","symbol","sample") = default("symbol");
        string errorModelType = default("APSKLayeredErrorModel");
        string decoderType = default("APSKDecoder");
        string demodulatorType = default("APSKDemodulator");
        string pulseFilterType = default("");
        string analogDigitalConverterType = default("");
        double energyDetection @unit(dBm); // TODO: @unit(W) + dBm/dBW <--> W
        double sensitivity @unit(dBm); // TODO: @unit(W) + dBm/dBW <--> W
        double carrierFrequency @unit(Hz);
        double bandwidth @unit(Hz);
        double snirThreshold @unit(dB);
        @display("i=block/wrx");
        @class(APSKLayeredReceiver);

    submodules:
        decoder: <decoderType> like IDecoder if decoderType != "" {
            @display("p=100,50");
        }
        demodulator: <demodulatorType> like IDemodulator {
            @display("p=100,150");
        }
        pulseFilter: <pulseFilterType> like IPulseFilter if pulseFilterType != "" {
            @display("p=100,250");
        }
        analogDigitalConverter: <analogDigitalConverterType> like IAnalogDigitalConverter if analogDigitalConverterType != "" {
            @display("p=100,350");
        }
        errorModel: <errorModelType> like ILayeredErrorModel if errorModelType != "" {
            @display("p=100,450");
        }
}