DESERT 3.5.1
Loading...
Searching...
No Matches
uwem-channel.cpp
Go to the documentation of this file.
1//
2// Copyright (c) 2023 Regents of the SIGNET lab, University of Padova.
3// All rights reserved.
4//
5// Redistribution and use in source and binary forms, with or without
6// modification, are permitted provided that the following conditions
7// are met:
8// 1. Redistributions of source code must retain the above copyright
9// notice, this list of conditions and the following disclaimer.
10// 2. Redistributions in binary form must reproduce the above copyright
11// notice, this list of conditions and the following disclaimer in the
12// documentation and/or other materials provided with the distribution.
13// 3. Neither the name of the University of Padova (SIGNET lab) nor the
14// names of its contributors may be used to endorse or promote products
15// derived from this software without specific prior written permission.
16//
17// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
18// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
19// TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
20// PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
21// CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
22// EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
23// PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
24// OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
25// WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
26// OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
27// ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28//
29
39#include <iostream>
40#include <cassert>
41
42#include "uwem-channel.h"
43
44#define SPEED_OF_LIGHT_VACUUM (3e8)
45#define REFRACTIVE_INDEX_MIN (1)
46#define REFRACTIVE_INDEX_WATER (1.33)
47
51static class UwElectroMagneticChannelClass : public TclClass
52{
53public:
55 : TclClass("Module/UW/ElectroMagnetic/Channel")
56 {
57 }
58 TclObject *
59 create(int, const char *const *)
60 {
61 return (new UwElectroMagneticChannel());
62 }
64
66 : ChannelModule()
67 , refractive_index(REFRACTIVE_INDEX_WATER)
68 , speed_of_light(SPEED_OF_LIGHT_VACUUM)
69{
70 bind("RefractiveIndex_", (double *) &refractive_index);
71
74 }
75
77}
78
79int
80UwElectroMagneticChannel::command(int argc, const char *const *argv)
81{
82 // Tcl& tcl = Tcl::instance();
83 return ChannelModule::command(argc, argv);
84}
85
86void
88{
89 Scheduler &s = Scheduler::instance();
90 struct hdr_cmn *hdr = HDR_CMN(p);
91
92 hdr->direction() = hdr_cmn::UP;
93
94 Position *sourcePos = chsap->getPosition();
95 ChSAP *dest;
96
97 if (debug_)
98 cout << "UwElectroMagneticChannel::sendUpPhy() sending packet" << endl;
99
100 for (int i = 0; i < getChSAPnum(); i++) {
101 dest = (ChSAP *) getChSAP(i);
102
103 if (chsap == dest) // it's the source node -> skip it
104 continue;
105
106 s.schedule(
107 dest, p->copy(), getPropDelay(sourcePos, dest->getPosition()));
108 }
109
110 Packet::free(p);
111}
112
113void
114UwElectroMagneticChannel::recv(Packet *p, ChSAP *chsap)
115{
116 sendUpPhy(p, chsap);
117}
118
119double
120UwElectroMagneticChannel::getPropDelay(Position *src, Position *dst)
121{
122 double distance = src->getDist(dst);
123
124 assert(distance >= 0.0);
125
126 double delay = distance / speed_of_light;
127
128 if (debug_)
129 cout << "UwElectroMagneticChannel::getPropDelay() distance = " << distance
130 << "; speed = " << speed_of_light << "; delay = " << delay << endl;
131
132 return delay;
133}
Adds the module for UwElectroMagneticChannel in ns2.
TclObject * create(int, const char *const *)
UwElectroMagneticChannel extends Miracle channel class and implements the underwater optical channel.
virtual void recv(Packet *p, ChSAP *chsap)
Performs the reception of packets from upper and lower layers.
void sendUpPhy(Packet *p, ChSAP *chsap)
Sends the given Packet* to the upper PHY layer.
double refractive_index
refractive index of the underwater medium.
UwElectroMagneticChannel()
Constructor of UwElectroMagneticChannel class.
virtual int command(int argc, const char *const *argv)
TCL command interpreter.
virtual double getPropDelay(Position *s, Position *d)
Returns the underwater optical propagation delay between the two given Position pointers.
double speed_of_light
Speed of light in the underwater medium.
#define REFRACTIVE_INDEX_MIN
UwElectroMagneticChannelClass class_UwElectroMagneticChannel
#define SPEED_OF_LIGHT_VACUUM
#define REFRACTIVE_INDEX_WATER
Provides class and APIs of the underwater elctromagnetic channel.