ApskLayeredTransmitter

Package: inet.physicallayer.wireless.apsk.bitlevel

ApskLayeredTransmitter

compound module

This transmitter model is part of a simple hypothetical layered radio. It produces 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 always set on the transmission.

With the highest level of detail, the produced transmission contains the following:

  • a separate packet to represent the PHY frame
  • precise bit representation of the entire packet
  • precise bit representation after scrambling, FEC encoding, and interleaving
  • precise symbol representation of the entire packet including the physical header
  • narrowband analog representation using scalar transmission power

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

This transmitter model supports scrambling, convolutional coding, interleaving, and modulating 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> ~ApskEncoder, ~ApskModulator, ~ApskLayeredReceiver.

encoder : like IEncoder

ApskEncoder: Part of a simple hypothetical layered transmitter.

IEncoder: Module interface for bit-level encoders used in wireless communication systems.

Source:
encoder: <default("ApskEncoder")> like IEncoder if typename != "" {
    @display("p=100,100");
} modulator : like IModulator

ApskModulator: Part of a simple hypothetical layered transmitter.

IModulator: Interface for digital modulator modules that convert sequences of bits into sequences of symbols.

Source:
modulator: <default("ApskModulator")> like IModulator {
    @display("p=100,200");
} pulseShaper : like IPulseShaper

IPulseShaper: Interface for pulse shaping components in wireless communications.

Source:
pulseShaper: <default("")> like IPulseShaper if typename != "" {
    @display("p=100,300");
} digitalAnalogConverter : like IDigitalAnalogConverter

IDigitalAnalogConverter: Interface for digital-to-analog converter modules that transform discrete-time signal samples into...

Source:
digitalAnalogConverter: <default("")> like IDigitalAnalogConverter if typename != "" {
    @display("p=100,400");
}

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
Module compound module

Base module for all INET compound modules.

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

levelOfDetail string "symbol"
bitrate double

Net bitrate of the transmitter

power double

Scalar transmission power for the entire signal duration

centerFrequency double

Center frequency of the narrowband carrier signal

bandwidth double

Bandwidth

preambleDuration double 0s

Properties

Name Value Description
class ApskLayeredTransmitter
display i=block/wtx

Source code

//
// This transmitter model is part of a simple hypothetical layered radio. It
// produces 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
// always set on the transmission.
//
// With the highest level of detail, the produced transmission contains the
// following:
//  - a separate packet to represent the PHY frame
//  - precise bit representation of the entire packet
//  - precise bit representation after scrambling, FEC encoding, and interleaving
//  - precise symbol representation of the entire packet including the physical header
//  - narrowband analog representation using scalar transmission power
//
// NOTE: the current implementation doesn't support pulse shaping and digital
// analog conversion.
//
// This transmitter model supports scrambling, convolutional coding, interleaving,
// and modulating various amplitude and phase-shift modulations. The main purpose
// of this model is to provide a basic infrastructure for further development and
// experimentation.
//
// @see ~ApskEncoder, ~ApskModulator, ~ApskLayeredReceiver.
//
module ApskLayeredTransmitter extends Module like ITransmitter
{
    parameters:
        string levelOfDetail @enum("packet","bit","symbol","sample") = default("symbol");
        double bitrate @unit(bps); // Net bitrate of the transmitter
        double power @unit(W); // Scalar transmission power for the entire signal duration
        double centerFrequency @unit(Hz); // Center frequency of the narrowband carrier signal
        double bandwidth @unit(Hz); // Bandwidth
        double preambleDuration @unit(s) = default(0s);
        @display("i=block/wtx");
        @class(ApskLayeredTransmitter);

    submodules:
        encoder: <default("ApskEncoder")> like IEncoder if typename != "" {
            @display("p=100,100");
        }
        modulator: <default("ApskModulator")> like IModulator {
            @display("p=100,200");
        }
        pulseShaper: <default("")> like IPulseShaper if typename != "" {
            @display("p=100,300");
        }
        digitalAnalogConverter: <default("")> like IDigitalAnalogConverter if typename != "" {
            @display("p=100,400");
        }
}

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