APSKLayeredTransmitter

Package: inet.physicallayer.apskradio.bitlevel

APSKLayeredTransmitter

compound module

This transmitter model is part of a simple hypothetical layered radio. It produces 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 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 whole packet
  • precise bit representation after scrambling, fec encoding, and interleaving
  • 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 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 also APSKEncoder, APSKModulator, and APSKLayeredReceiver.

encoder : like IEncoder

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

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

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

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

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"
encoderType string "APSKEncoder"
modulatorType string "APSKModulator"
pulseShaperType string ""
digitalAnalogConverterType string ""
bitrate double

net bitrate of the transmitter

power double

scalar transmission power for the whole signal duration

carrierFrequency double

center frequency of the narrowband carrier signal

bandwidth double

bandwidth

Properties

Name Value Description
display i=block/wtx
class APSKLayeredTransmitter

Source code

//
// This transmitter model is part of a simple hypothetical layered radio. It
// produces 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
// 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 whole packet
//  - precise bit representation after scrambling, fec encoding, and interleaving
//  - 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 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 also ~APSKEncoder, ~APSKModulator, and ~APSKLayeredReceiver.
//
module APSKLayeredTransmitter like ITransmitter
{
    parameters:
        string levelOfDetail @enum("packet","bit","symbol","sample") = default("symbol");
        string encoderType = default("APSKEncoder");
        string modulatorType = default("APSKModulator");
        string pulseShaperType = default("");
        string digitalAnalogConverterType = default("");
        double bitrate @unit(bps); // net bitrate of the transmitter
        double power @unit(W); // scalar transmission power for the whole signal duration
        double carrierFrequency @unit(Hz); // center frequency of the narrowband carrier signal
        double bandwidth @unit(Hz); // bandwidth
        @display("i=block/wtx");
        @class(APSKLayeredTransmitter);

    submodules:
        encoder: <encoderType> like IEncoder if encoderType != "" {
            @display("p=100,50");
        }
        modulator: <modulatorType> like IModulator {
            @display("p=100,150");
        }
        pulseShaper: <pulseShaperType> like IPulseShaper if pulseShaperType != "" {
            @display("p=100,250");
        }
        digitalAnalogConverter: <digitalAnalogConverterType> like IDigitalAnalogConverter if digitalAnalogConverterType != "" {
            @display("p=100,350");
        }
}
File: src/inet/physicallayer/apskradio/bitlevel/APSKLayeredTransmitter.ned