APSKLayeredReceiver

Package: inet.physicallayer.apskradio.bitlevel

APSKLayeredReceiver

compound module

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.

decoder : like IDecoder

Source:
decoder: <decoderType> like IDecoder if decoderType != "" {
    @display("p=100,50");
} demodulator : like IDemodulator

Source:
demodulator: <demodulatorType> like IDemodulator {
    @display("p=100,150");
} pulseFilter : like IPulseFilter

Source:
pulseFilter: <pulseFilterType> like IPulseFilter if pulseFilterType != "" {
    @display("p=100,250");
} analogDigitalConverter : like IAnalogDigitalConverter

Source:
analogDigitalConverter: <analogDigitalConverterType> like IAnalogDigitalConverter if analogDigitalConverterType != "" {
    @display("p=100,350");
} errorModel : like ILayeredErrorModel

Source:
errorModel: <errorModelType> like ILayeredErrorModel if errorModelType != "" {
    @display("p=100,450");
}

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");
        }
}
File: src/inet/physicallayer/apskradio/bitlevel/APSKLayeredReceiver.ned