ApskLayeredReceiver

Package: inet.physicallayer.wireless.apsk.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, ApskLayeredTransmitter.

decoder : like IDecoder

ApskDecoder: This module is part of a simple hypothetical layered receiver.

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

ApskDemodulator: This module is part of a simple hypothetical layered receiver.

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

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

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

ApskLayeredErrorModel: This error model computes the erroneous bits, symbols, or simply whether the packet is error free...

Source:
errorModel: <default("ApskLayeredErrorModel")> like ILayeredErrorModel if typename != "" {
    @display("p=100,500");
}

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.

Extends

Name Type Description
SnirReceiverBase compound module

This module servces as a base module for SNIR receiver models.

Parameters

Name Type Default value Description
snirThreshold double

reception is not successful if the SNIR is below this threshold (unsuccessful reception)

snirThresholdMode string "min"
levelOfDetail string "symbol"
energyDetection double

TODO @unit(W) + dBm/dBW <--> W

sensitivity double

TODO @unit(W) + dBm/dBW <--> W

centerFrequency double
bandwidth 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 ~ApskDemodulator, ~ApskDecoder, ~ApskLayeredTransmitter.
//
module ApskLayeredReceiver extends SnirReceiverBase like IReceiver
{
    parameters:
        string levelOfDetail @enum("packet","bit","symbol","sample") = default("symbol");
        double energyDetection @unit(dBm); // TODO @unit(W) + dBm/dBW <--> W
        double sensitivity @unit(dBm); // TODO @unit(W) + dBm/dBW <--> W
        double centerFrequency @unit(Hz);
        double bandwidth @unit(Hz);
        @display("i=block/wrx");
        @class(ApskLayeredReceiver);

    submodules:
        decoder: <default("ApskDecoder")> like IDecoder if typename != "" {
            @display("p=100,100");
        }
        demodulator: <default("ApskDemodulator")> like IDemodulator {
            @display("p=100,200");
        }
        pulseFilter: <default("")> like IPulseFilter if typename != "" {
            @display("p=100,300");
        }
        analogDigitalConverter: <default("")> like IAnalogDigitalConverter if typename != "" {
            @display("p=100,400");
        }
        errorModel: <default("ApskLayeredErrorModel")> like ILayeredErrorModel if typename != "" {
            @display("p=100,500");
        }
}

File: src/inet/physicallayer/wireless/apsk/bitlevel/ApskLayeredReceiver.ned