This generates pulse-level representation of an IEEE 802.15.4A UWB PHY frame using the mandatory mode (high PRF). More...

#include <Ieee802154UWBIRTransmitter.h>

Inheritance diagram for inet::physicallayer::Ieee802154UWBIRTransmitter:

Public Member Functions
	Ieee802154UWBIRTransmitter ()

virtual const ITransmission *	createTransmission (const IRadio transmitter, const cPacket macFrame, const simtime_t startTime) const override
	Returns a transmission which describes the radio signal corresponding to the provided mac frame. More...

virtual std::ostream &	printToStream (std::ostream &stream, int level) const override
	Prints this object to the provided output stream. More...

Public Member Functions inherited from inet::physicallayer::TransmitterBase
virtual W	getMaxPower () const override
	Returns the maximum transmission power above which no transmission is ever transmitted. More...

virtual m	getMaxCommunicationRange () const override
	Returns the maximum transmission range. More...

virtual m	getMaxInterferenceRange () const override
	Returns the maximum interference range. More...

Public Member Functions inherited from inet::physicallayer::IPrintableObject
virtual	~IPrintableObject ()

virtual std::string	getInfoStringRepresentation () const

virtual std::string	getDetailStringRepresentation () const

virtual std::string	getDebugStringRepresentation () const

virtual std::string	getTraceStringRepresentation () const

virtual std::string	getCompleteStringRepresentation () const

Protected Member Functions
virtual void	initialize (int stage) override

simtime_t	getFrameDuration (int psduLength) const

simtime_t	getMaxFrameDuration () const

simtime_t	getPhyMaxFrameDuration () const

simtime_t	getThdr () const

virtual void	generateSyncPreamble (Mapping mapping, Argument arg, const simtime_t startTime) const

virtual void	generateSFD (Mapping mapping, Argument arg, const simtime_t startTime) const

virtual void	generatePhyHeader (Mapping mapping, Argument arg, const simtime_t startTime) const

virtual void	generateBurst (Mapping mapping, Argument arg, const simtime_t startTime, const simtime_t burstStart, short polarity) const

virtual void	generatePulse (Mapping mapping, Argument arg, const simtime_t startTime, short polarity, double peak, const simtime_t chip) const

virtual ConstMapping *	generateIEEE802154AUWBSignal (const simtime_t startTime, std::vector< bool > *bits) const

Protected Member Functions inherited from inet::physicallayer::TransmitterBase
virtual int	numInitStages () const override

Protected Attributes
Ieee802154UWBIRMode	cfg

Additional Inherited Members
Public Types inherited from inet::physicallayer::IPrintableObject
enum	PrintLevel { PRINT_LEVEL_TRACE, PRINT_LEVEL_DEBUG, PRINT_LEVEL_DETAIL, PRINT_LEVEL_INFO, PRINT_LEVEL_COMPLETE = INT_MIN }

Detailed Description

This generates pulse-level representation of an IEEE 802.15.4A UWB PHY frame using the mandatory mode (high PRF).

Constructor & Destructor Documentation

inet::physicallayer::Ieee802154UWBIRTransmitter::Ieee802154UWBIRTransmitter ( )

34 {

35 }

Member Function Documentation

const ITransmission * inet::physicallayer::Ieee802154UWBIRTransmitter::createTransmission	(	const IRadio *	transmitter,
		const cPacket *	macFrame,
		const simtime_t	startTime
	)		const

overridevirtual

Returns a transmission which describes the radio signal corresponding to the provided mac frame.

This function never returns nullptr.

Implements inet::physicallayer::ITransmitter.

 {
     int bitLength = macFrame->getBitLength();
     // KLUDGE: generate random bits until serializer is implemented
     std::vector<bool> *bits = new std::vector<bool>();
     for (int i = 0; i < bitLength; i++) {
         bool bitValue = intuniform(0, 1, 0);
         EV_INFO << "Transmitted bit at " << i << " is " << (int)bitValue << endl;
         bits->push_back(bitValue);
     }
     // KLUDGE: add a fake CRC
     for (int i = 0; i < 8; i++) {
         bits->push_back(0);
         for (int j = 0; j + i < bitLength; j += 8)
             bits->at(bitLength + i) = bits->at(bitLength + i) ^ bits->at(j + i);
     }
     const simtime_t duration = getFrameDuration(bits->size() / 8);
     const simtime_t endTime = startTime + duration;
     IMobility *mobility = transmitter->getAntenna()->getMobility();
     const Coord startPosition = mobility->getCurrentPosition();
     const Coord endPosition = mobility->getCurrentPosition();
     const EulerAngles startOrientation = mobility->getCurrentAngularPosition();
     const EulerAngles endOrientation = mobility->getCurrentAngularPosition();
     const ConstMapping *powerMapping = generateIEEE802154AUWBSignal(startTime, bits);
     return new DimensionalTransmission(transmitter, macFrame, startTime, endTime, -1, -1, -1, startPosition, endPosition, startOrientation, endOrientation, -1, bitLength, cfg.bitrate, nullptr, cfg.centerFrequency, cfg.bandwidth, powerMapping);
 }

void inet::physicallayer::Ieee802154UWBIRTransmitter::generateBurst	(	Mapping *	mapping,
		Argument *	arg,
		const simtime_t	startTime,
		const simtime_t	burstStart,
		short	polarity
	)		const

protectedvirtual

Referenced by generateIEEE802154AUWBSignal().

 {
     // ASSERT(burstStart < cfg.preambleLength + (psduLength * 8 + 48 + 2) * cfg.data_symbol_duration);
     // 1. Start point = zeros
     simtime_t offset = burstStart;
     for (int pulse = 0; pulse < cfg.nbPulsesPerBurst; pulse++) {
         arg->setTime(offset);
         generatePulse(mapping, arg, startTime, 1, Ieee802154UWBIRMode::maxPulse, cfg.pulse_duration);
         offset = offset + cfg.pulse_duration;
     }
 }

ConstMapping * inet::physicallayer::Ieee802154UWBIRTransmitter::generateIEEE802154AUWBSignal	(	const simtime_t	startTime,
		std::vector< bool > *	bits
	)		const

protectedvirtual

Referenced by createTransmission().

 {
     // 48 R-S parity bits, the 2 symbols phy header is not modeled as it includes its own parity bits
     // and is thus very robust
     unsigned int bitLength = bits->size() + 48;
     // data start time relative to signal->getReceptionStart();
     simtime_t dataStart = cfg.preambleLength; // = Tsync + Tsfd
     TimeMapping<Linear>* mapping = new TimeMapping<Linear> ();
     Argument arg;
 
     generateSyncPreamble(mapping, &arg, startTime);
     generateSFD(mapping, &arg, startTime);
     //generatePhyHeader(mapping, &arg, startTime);
 
     // generate bit values and modulates them according to
     // the IEEE 802.15.4A specification
     simtime_t symbolStart = dataStart;
     simtime_t burstPos;
     for (unsigned int burst = 0; burst < bitLength; burst++) {
         int bit = burst < bits->size() ? bits->at(burst) : intuniform(0, 1, 0);
         burstPos = symbolStart + bit * cfg.shift_duration + cfg.getHoppingPos(burst) * cfg.burst_duration;
         generateBurst(mapping, &arg, startTime, burstPos, +1);
         symbolStart = symbolStart + cfg.data_symbol_duration;
     }
     return mapping;
 }

void inet::physicallayer::Ieee802154UWBIRTransmitter::generatePhyHeader	(	Mapping *	mapping,
		Argument *	arg,
		const simtime_t	startTime
	)		const

protectedvirtual

 {
     // not implemented
 }

void inet::physicallayer::Ieee802154UWBIRTransmitter::generatePulse	(	Mapping *	mapping,
		Argument *	arg,
		const simtime_t	startTime,
		short	polarity,
		double	peak,
		const simtime_t	chip
	)		const

protectedvirtual

Referenced by generateBurst(), generateSFD(), and generateSyncPreamble().

 {
     ASSERT(polarity == -1 || polarity == +1);
     arg->setTime(arg->getTime() + startTime);  // adjust argument so that we use absolute time values in Mapping
     mapping->setValue(*arg, 0);
     arg->setTime(arg->getTime() + chip / 2);
     // Maximum point at symbol half (triangular pulse)
     mapping->setValue(*arg, peak * polarity);
     arg->setTime(arg->getTime() + chip / 2);
     mapping->setValue(*arg, 0);
 }

void inet::physicallayer::Ieee802154UWBIRTransmitter::generateSFD	(	Mapping *	mapping,
		Argument *	arg,
		const simtime_t	startTime
	)		const

protectedvirtual

Referenced by generateIEEE802154AUWBSignal().

 {
     const simtime_t sfdStart = cfg.NSync * cfg.sync_symbol_duration;
     for (short n = 0; n < 8; n = n + 1) {
         if (Ieee802154UWBIRMode::shortSFD[n] != 0) {
             for (short pos = 0; pos < cfg.CLength; pos = pos + 1) {
                 if (Ieee802154UWBIRMode::C31[Ieee802154UWBIRMode::Ci - 1][pos] != 0) {
                     arg->setTime(sfdStart + n * cfg.sync_symbol_duration + pos * cfg.spreadingdL*cfg.pulse_duration);
                     //generatePulse(mapping, arg, startTime, C31[Ci - 1][pos] * shortSFD[n]); // change pulse polarity
                     generatePulse(mapping, arg, startTime, 1, Ieee802154UWBIRMode::maxPulse, cfg.pulse_duration); // always positive polarity
                 }
             }
         }
     }
 }

void inet::physicallayer::Ieee802154UWBIRTransmitter::generateSyncPreamble	(	Mapping *	mapping,
		Argument *	arg,
		const simtime_t	startTime
	)		const

protectedvirtual

Referenced by generateIEEE802154AUWBSignal().

 {
     // NSync repetitions of the Si symbol
     for (short n = 0; n < cfg.NSync; n = n + 1) {
         for (short pos = 0; pos < cfg.CLength; pos = pos + 1) {
             if (Ieee802154UWBIRMode::C31[Ieee802154UWBIRMode::Ci - 1][pos] != 0) {
                 if(n==0 && pos==0) {
                     // we slide the first pulse slightly in time to get the first point "inside" the signal
                   arg->setTime(1E-12 + n * cfg.sync_symbol_duration + pos * cfg.spreadingdL * cfg.pulse_duration);
                 } else {
                   arg->setTime(n * cfg.sync_symbol_duration + pos * cfg.spreadingdL * cfg.pulse_duration);
                 }
                 //generatePulse(mapping, arg, startTime, C31[Ci - 1][pos], IEEE802154A::maxPulse, IEEE802154A::mandatory_pulse);
                 generatePulse(mapping, arg, startTime, 1, Ieee802154UWBIRMode::maxPulse, cfg.pulse_duration); // always positive polarity
             }
         }
     }
 }

simtime_t inet::physicallayer::Ieee802154UWBIRTransmitter::getFrameDuration ( int psduLength ) const

protected

Referenced by createTransmission().

 {
     return cfg.preambleLength + (psduLength * 8 + 48) * cfg.data_symbol_duration;
 }

simtime_t inet::physicallayer::Ieee802154UWBIRTransmitter::getMaxFrameDuration ( ) const

protected

 {
         return cfg.preambleLength + Ieee802154UWBIRMode::MaxPSDULength * cfg.data_symbol_duration;
 }

simtime_t inet::physicallayer::Ieee802154UWBIRTransmitter::getPhyMaxFrameDuration ( ) const

protected

 {
     simtime_t phyMaxFrameDuration = 0;
     simtime_t TSHR, TPHR, TPSDU, TCCApreamble;
     TSHR = getThdr();
     TPHR = getThdr();
     phyMaxFrameDuration = phyMaxFrameDuration + TSHR;
     return phyMaxFrameDuration;
 }

simtime_t inet::physicallayer::Ieee802154UWBIRTransmitter::getThdr ( ) const

protected

Referenced by getPhyMaxFrameDuration().

 {
         switch (cfg.channel) {
         default:
             switch (cfg.prf) {
                 case Ieee802154UWBIRMode::NOMINAL_4_M:
                     //throw cRuntimeError("This optional mode is not implemented.");
                     return 0;
                     break;
                 case Ieee802154UWBIRMode::NOMINAL_16_M:
                     return 16.4E-6;
                 case Ieee802154UWBIRMode::NOMINAL_64_M:
                     return 16.8E-6;
                 case Ieee802154UWBIRMode::PRF_OFF:
                     return 0;
             }
             break;
         }
         return 0;
 }

void inet::physicallayer::Ieee802154UWBIRTransmitter::initialize ( int stage )

overrideprotectedvirtual

 {
     if (stage == INITSTAGE_LOCAL)
     {
         cfg = Ieee802154UWBIRMode::cfg_mandatory_16M;
     }
 }

std::ostream & inet::physicallayer::Ieee802154UWBIRTransmitter::printToStream	(	std::ostream &	stream,
		int	level
	)		const

overridevirtual

Prints this object to the provided output stream.

Function calls to operator<< with pointers or references either const or not are all forwarded to this function.

Reimplemented from inet::physicallayer::IPrintableObject.

 {
     return stream << "Ieee802154UWBIRTransmitter";
 }

Member Data Documentation

Ieee802154UWBIRMode inet::physicallayer::Ieee802154UWBIRTransmitter::cfg

protected

Referenced by createTransmission(), generateBurst(), generateIEEE802154AUWBSignal(), generateSFD(), generateSyncPreamble(), getFrameDuration(), getMaxFrameDuration(), getThdr(), and initialize().

The documentation for this class was generated from the following files:

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation