Compound Module APSKLayeredTransmitter

Package: inet.physicallayer.apskradio.bitlevel
File: src/inet/physicallayer/apskradio/bitlevel/APSKLayeredTransmitter.ned

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.

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");
        }
}