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 a 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 the 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.

<b>See also:</b> ~ApskDemodulator, ~ApskDecoder, ~ApskLayeredTransmitter.

analogModel : like IReceiverAnalogModel

IReceiverAnalogModel: The receiver analog model describes the connecting piece between the technology-dependent part of...

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

ApskDecoder: Part of a simple hypothetical layered receiver.

IDecoder: Interface for decoders in wireless communications.

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

ApskDemodulator: Part of a simple hypothetical layered receiver.

IDemodulator: Module interface for demodulators in wireless communication systems.

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

IPulseFilter: Module interface for pulse filters in wireless communication systems.

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

IAnalogDigitalConverter: Converts analog signal representations to digital sample representations in wireless communication...

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

Serves as a base module for SNIR receiver models.

Parameters

Name Type Default value Description
displayStringTextFormat string ""

Determines the text that is written on top of the submodule, supports displaying pars, watches, and module-specific information

ignoreInterference bool false

True means interfering transmissions are ignored when determining whether a reception is successful or not

signalAnalogRepresentation string "scalar"
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
class ApskLayeredReceiver
display i=block/wrx

Source code

//
// This receiver model is part of a simple hypothetical layered radio. It
// receives detailed transmissions that have a 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 the 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