Loading...
Searching...
No Matches
sat-lora-constellation-example.cc
Go to the documentation of this file.
1/* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2/*
3 * Copyright (c) 2014 Magister Solutions
4 *
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License version 2 as
7 * published by the Free Software Foundation;
8 *
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
13 *
14 * You should have received a copy of the GNU General Public License
15 * along with this program; if not, write to the Free Software
16 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17 *
18 * Author: Bastien Tauran <bastien.tauran@viveris.fr>
19 *
20 */
21
22#include "ns3/applications-module.h"
23#include "ns3/config-store-module.h"
24#include "ns3/core-module.h"
25#include "ns3/internet-module.h"
26#include "ns3/network-module.h"
27#include "ns3/satellite-module.h"
28#include "ns3/traffic-module.h"
29
30using namespace ns3;
31
38
39NS_LOG_COMPONENT_DEFINE("sat-lora-constellation-example");
40
41int
42main(int argc, char* argv[])
43{
44 // Variables
45 std::string beams = "30 43";
46 uint32_t nbGwUser = 1;
47 uint32_t nbUtsPerBeam = 5;
48 uint32_t nbEndUsersPerUt = 1;
49
50 Time appStartTime = Seconds(0.001);
51 Time simLength = Seconds(15.0);
52
53 uint32_t packetSize = 24;
54 Time loraInterval = Seconds(10);
55 std::string interval = "10s";
56
57 double frameAllocatedBandwidthHz = 15000;
58 double frameCarrierAllocatedBandwidthHz = 15000;
59 double frameCarrierRollOff = 0.22;
60 double frameCarrierSpacing = 0;
61 uint32_t frameSpreadingFactor = 256;
62
63 bool interferenceModePerPacket = true;
64 bool displayTraces = true;
65
66 Time firstWindowDelay = MilliSeconds(1500);
67 Time secondWindowDelay = Seconds(2);
68 Time firstWindowDuration = MilliSeconds(400);
69 Time secondWindowDuration = MilliSeconds(500);
70 Time firstWindowAnswerDelay = Seconds(1);
71 Time secondWindowAnswerDelay = Seconds(2);
72
73 Ptr<SimulationHelper> simulationHelper =
74 CreateObject<SimulationHelper>("example-lora-constellation");
75
76 // read command line parameters given by user
77 CommandLine cmd;
78 cmd.AddValue("modelPP", "interferenceModePerPacket", interferenceModePerPacket);
79 cmd.AddValue("traces", "displayTraces", displayTraces);
80 cmd.AddValue("utsPerBeam", "Number of UTs per spot-beam", nbUtsPerBeam);
81 cmd.AddValue("simLength", "Simulation duration in seconds", simLength);
82 cmd.AddValue("packetSize", "Constant packet size in bytes", packetSize);
83 cmd.AddValue("loraInterval",
84 "Interval between two transmissions for each UT in seconds",
85 loraInterval);
86 cmd.AddValue("frameAllocatedBandwidthHz",
87 "Allocated bandwidth in Hz",
88 frameAllocatedBandwidthHz);
89 cmd.AddValue("frameCarrierAllocatedBandwidthHz",
90 "Allocated carrier bandwidth in Hz",
91 frameCarrierAllocatedBandwidthHz);
92 cmd.AddValue("frameCarrierRollOff", "Roll-off factor", frameCarrierRollOff);
93 cmd.AddValue("frameCarrierSpacing", "Carrier spacing factor", frameCarrierSpacing);
94 cmd.AddValue("frameSpreadingFactor", "Carrier spreading factor", frameSpreadingFactor);
95
96 cmd.AddValue("firstWindowDelay",
97 "Delay between end of transmission and opening of first window on End Device",
98 firstWindowDelay);
99 cmd.AddValue("secondWindowDelay",
100 "Delay between end of transmission and opening of second window on End Device",
101 secondWindowDelay);
102 cmd.AddValue("firstWindowDuration", "First window duration on End Device", firstWindowDuration);
103 cmd.AddValue("secondWindowDuration",
104 "Second window duration on End Device",
105 secondWindowDuration);
106 cmd.AddValue("firstWindowAnswerDelay",
107 "Delay between end of reception and start of ack on first window on Gateway",
108 firstWindowAnswerDelay);
109 cmd.AddValue("secondWindowAnswerDelay",
110 "Delay between end of reception and start of ack on second window on Gateway",
111 secondWindowAnswerDelay);
112 simulationHelper->AddDefaultUiArguments(cmd);
113 cmd.Parse(argc, argv);
114
116 Config::SetDefault("ns3::SatConf::ForwardLinkRegenerationMode",
117 EnumValue(SatEnums::REGENERATION_NETWORK));
118 Config::SetDefault("ns3::SatConf::ReturnLinkRegenerationMode",
119 EnumValue(SatEnums::REGENERATION_NETWORK));
120
121 // Enable Lora
122 Config::SetDefault("ns3::LorawanMacEndDevice::DataRate", UintegerValue(5));
123 Config::SetDefault("ns3::LorawanMacEndDevice::MType",
124 EnumValue(LorawanMacHeader::CONFIRMED_DATA_UP));
125
126 // Config::SetDefault ("ns3::SatLoraConf::Standard", EnumValue (SatLoraConf::EU863_870));
127 Config::SetDefault("ns3::SatLoraConf::Standard", EnumValue(SatLoraConf::SATELLITE));
128
129 Config::SetDefault("ns3::LorawanMacEndDeviceClassA::FirstWindowDelay",
130 TimeValue(firstWindowDelay));
131 Config::SetDefault("ns3::LorawanMacEndDeviceClassA::SecondWindowDelay",
132 TimeValue(secondWindowDelay));
133 Config::SetDefault("ns3::LorawanMacEndDeviceClassA::FirstWindowDuration",
134 TimeValue(firstWindowDuration));
135 Config::SetDefault("ns3::LorawanMacEndDeviceClassA::SecondWindowDuration",
136 TimeValue(secondWindowDuration));
137 Config::SetDefault("ns3::LoraNetworkScheduler::FirstWindowAnswerDelay",
138 TimeValue(firstWindowAnswerDelay));
139 Config::SetDefault("ns3::LoraNetworkScheduler::SecondWindowAnswerDelay",
140 TimeValue(secondWindowAnswerDelay));
141
142 // Defaults
143 Config::SetDefault("ns3::SatEnvVariables::EnableSimulationOutputOverwrite", BooleanValue(true));
144 Config::SetDefault("ns3::SatHelper::PacketTraceEnabled", BooleanValue(true));
145
146 // Superframe configuration
147 Config::SetDefault("ns3::SatConf::SuperFrameConfForSeq0",
148 EnumValue(SatSuperframeConf::SUPER_FRAME_CONFIG_4));
149 Config::SetDefault("ns3::SatSuperframeConf4::FrameConfigType",
150 EnumValue(SatSuperframeConf::CONFIG_TYPE_4));
151 Config::SetDefault("ns3::SatSuperframeConf4::Frame0_AllocatedBandwidthHz",
152 DoubleValue(frameAllocatedBandwidthHz));
153 Config::SetDefault("ns3::SatSuperframeConf4::Frame0_CarrierAllocatedBandwidthHz",
154 DoubleValue(frameCarrierAllocatedBandwidthHz));
155 Config::SetDefault("ns3::SatSuperframeConf4::Frame0_CarrierRollOff",
156 DoubleValue(frameCarrierRollOff));
157 Config::SetDefault("ns3::SatSuperframeConf4::Frame0_CarrierSpacing",
158 DoubleValue(frameCarrierSpacing));
159 Config::SetDefault("ns3::SatSuperframeConf4::Frame0_SpreadingFactor",
160 UintegerValue(frameSpreadingFactor));
161
162 // CRDSA only
163 Config::SetDefault("ns3::SatLowerLayerServiceConf::DaServiceCount", UintegerValue(4));
164 Config::SetDefault("ns3::SatLowerLayerServiceConf::DaService0_ConstantAssignmentProvided",
165 BooleanValue(false));
166 Config::SetDefault("ns3::SatLowerLayerServiceConf::DaService0_RbdcAllowed",
167 BooleanValue(false));
168 Config::SetDefault("ns3::SatLowerLayerServiceConf::DaService0_VolumeAllowed",
169 BooleanValue(false));
170 Config::SetDefault("ns3::SatLowerLayerServiceConf::DaService1_ConstantAssignmentProvided",
171 BooleanValue(false));
172 Config::SetDefault("ns3::SatLowerLayerServiceConf::DaService1_RbdcAllowed",
173 BooleanValue(false));
174 Config::SetDefault("ns3::SatLowerLayerServiceConf::DaService1_VolumeAllowed",
175 BooleanValue(false));
176 Config::SetDefault("ns3::SatLowerLayerServiceConf::DaService2_ConstantAssignmentProvided",
177 BooleanValue(false));
178 Config::SetDefault("ns3::SatLowerLayerServiceConf::DaService2_RbdcAllowed",
179 BooleanValue(false));
180 Config::SetDefault("ns3::SatLowerLayerServiceConf::DaService2_VolumeAllowed",
181 BooleanValue(false));
182 Config::SetDefault("ns3::SatLowerLayerServiceConf::DaService3_ConstantAssignmentProvided",
183 BooleanValue(false));
184 Config::SetDefault("ns3::SatLowerLayerServiceConf::DaService3_RbdcAllowed",
185 BooleanValue(false));
186 Config::SetDefault("ns3::SatLowerLayerServiceConf::DaService3_VolumeAllowed",
187 BooleanValue(false));
188
189 // Configure RA
190 Config::SetDefault("ns3::SatOrbiterHelper::FwdLinkErrorModel",
191 EnumValue(SatPhyRxCarrierConf::EM_AVI));
192 Config::SetDefault("ns3::SatOrbiterHelper::RtnLinkErrorModel",
193 EnumValue(SatPhyRxCarrierConf::EM_AVI));
194 Config::SetDefault("ns3::SatBeamHelper::RandomAccessModel", EnumValue(SatEnums::RA_MODEL_ESSA));
195 if (interferenceModePerPacket)
196 {
197 Config::SetDefault("ns3::SatBeamHelper::RaInterferenceModel",
198 EnumValue(SatPhyRxCarrierConf::IF_PER_PACKET));
199 }
200 else
201 {
202 Config::SetDefault("ns3::SatBeamHelper::RaInterferenceModel",
203 EnumValue(SatPhyRxCarrierConf::IF_PER_FRAGMENT));
204 }
205 Config::SetDefault("ns3::SatBeamHelper::RaInterferenceEliminationModel",
206 EnumValue(SatPhyRxCarrierConf::SIC_RESIDUAL));
207 Config::SetDefault("ns3::SatBeamHelper::RaCollisionModel",
208 EnumValue(SatPhyRxCarrierConf::RA_COLLISION_CHECK_AGAINST_SINR));
209 Config::SetDefault("ns3::SatBeamHelper::ReturnLinkLinkResults", EnumValue(SatEnums::LR_LORA));
210
211 Config::SetDefault("ns3::SatPhyRxCarrierPerWindow::WindowDuration", StringValue("600ms"));
212 Config::SetDefault("ns3::SatPhyRxCarrierPerWindow::WindowStep", StringValue("200ms"));
213 Config::SetDefault("ns3::SatPhyRxCarrierPerWindow::WindowDelay", StringValue("0s"));
214 Config::SetDefault("ns3::SatPhyRxCarrierPerWindow::FirstWindow", StringValue("0s"));
215 Config::SetDefault("ns3::SatPhyRxCarrierPerWindow::WindowSICIterations", UintegerValue(5));
216 Config::SetDefault("ns3::SatPhyRxCarrierPerWindow::SpreadingFactor", UintegerValue(1));
217 Config::SetDefault("ns3::SatPhyRxCarrierPerWindow::DetectionThreshold", DoubleValue(0));
218 Config::SetDefault("ns3::SatPhyRxCarrierPerWindow::EnableSIC", BooleanValue(false));
219
220 // Set random access parameters
221 Config::SetDefault("ns3::SatLowerLayerServiceConf::RaService0_MaximumUniquePayloadPerBlock",
222 UintegerValue(3));
223 Config::SetDefault("ns3::SatLowerLayerServiceConf::RaService0_MaximumConsecutiveBlockAccessed",
224 UintegerValue(6));
225 Config::SetDefault("ns3::SatLowerLayerServiceConf::RaService0_MinimumIdleBlock",
226 UintegerValue(2));
227 Config::SetDefault("ns3::SatLowerLayerServiceConf::RaService0_BackOffTimeInMilliSeconds",
228 UintegerValue(50));
229 Config::SetDefault("ns3::SatLowerLayerServiceConf::RaService0_BackOffProbability",
230 UintegerValue(1));
231 Config::SetDefault("ns3::SatLowerLayerServiceConf::RaService0_HighLoadBackOffProbability",
232 UintegerValue(1));
233 Config::SetDefault(
234 "ns3::SatLowerLayerServiceConf::RaService0_AverageNormalizedOfferedLoadThreshold",
235 DoubleValue(0.99));
236 Config::SetDefault("ns3::SatLowerLayerServiceConf::RaService0_NumberOfInstances",
237 UintegerValue(3));
238 Config::SetDefault("ns3::SatLowerLayerServiceConf::RaService0_SlottedAlohaAllowed",
239 BooleanValue(false));
240 Config::SetDefault("ns3::SatLowerLayerServiceConf::RaService0_CrdsaAllowed",
241 BooleanValue(false));
242 Config::SetDefault("ns3::SatLowerLayerServiceConf::RaService0_EssaAllowed", BooleanValue(true));
243
244 // Traffics
245 simulationHelper->SetSimulationTime(simLength);
246
247 simulationHelper->SetGwUserCount(nbGwUser);
248 simulationHelper->SetUtCountPerBeam(nbUtsPerBeam);
249 simulationHelper->SetUserCountPerUt(nbEndUsersPerUt);
250 simulationHelper->SetBeams(beams);
251
252 simulationHelper->LoadScenario("constellation-eutelsat-geo-2-sats-isls-lora");
253
254 simulationHelper->CreateSatScenario();
255
256 /*simulationHelper->GetTrafficHelper()->AddLoraCbrTraffic(
257 loraInterval,
258 packetSize,
259 Singleton<SatTopology>::Get()->GetGwUserNodes(),
260 Singleton<SatTopology>::Get()->GetUtUserNodes(),
261 appStartTime,
262 simLength,
263 Seconds(1));*/
264
265 simulationHelper->GetTrafficHelper()->AddLoraPeriodicTraffic(
266 loraInterval,
267 packetSize,
268 Singleton<SatTopology>::Get()->GetUtNodes(),
269 appStartTime,
270 simLength,
271 Seconds(1));
272
273 // Outputs
274 simulationHelper->EnableProgressLogs();
275
276 std::string outputPath = SatEnvVariables::GetInstance()->LocateDirectory(
277 "contrib/satellite/data/sims/example-lora-constellation");
278 Config::SetDefault("ns3::ConfigStore::Filename",
279 StringValue(outputPath + "/output-attributes.xml"));
280 Config::SetDefault("ns3::ConfigStore::FileFormat", StringValue("Xml"));
281 Config::SetDefault("ns3::ConfigStore::Mode", StringValue("Save"));
282 ConfigStore outputConfig;
283 outputConfig.ConfigureDefaults();
284
285 if (displayTraces)
286 {
287 Ptr<SatStatsHelperContainer> s = simulationHelper->GetStatisticsContainer();
288
289 s->AddGlobalFeederEssaPacketError(SatStatsHelper::OUTPUT_SCALAR_FILE);
290 s->AddGlobalFeederEssaPacketError(SatStatsHelper::OUTPUT_SCATTER_FILE);
291 s->AddPerUtFeederEssaPacketError(SatStatsHelper::OUTPUT_SCALAR_FILE);
292 s->AddPerUtFeederEssaPacketError(SatStatsHelper::OUTPUT_SCATTER_FILE);
293
294 s->AddGlobalFeederEssaPacketCollision(SatStatsHelper::OUTPUT_SCALAR_FILE);
295 s->AddGlobalFeederEssaPacketCollision(SatStatsHelper::OUTPUT_SCATTER_FILE);
296 s->AddPerUtFeederEssaPacketCollision(SatStatsHelper::OUTPUT_SCALAR_FILE);
297 s->AddPerUtFeederEssaPacketCollision(SatStatsHelper::OUTPUT_SCATTER_FILE);
298
299 s->AddGlobalRtnFeederWindowLoad(SatStatsHelper::OUTPUT_SCALAR_FILE);
300 s->AddGlobalRtnFeederWindowLoad(SatStatsHelper::OUTPUT_SCATTER_FILE);
301 s->AddPerBeamRtnFeederWindowLoad(SatStatsHelper::OUTPUT_SCALAR_FILE);
302 s->AddPerBeamRtnFeederWindowLoad(SatStatsHelper::OUTPUT_SCATTER_FILE);
303
304 s->AddPerSatFwdFeederMacThroughput(SatStatsHelper::OUTPUT_SCALAR_FILE);
305 s->AddPerSatFwdFeederMacThroughput(SatStatsHelper::OUTPUT_SCATTER_FILE);
306 s->AddPerSatRtnFeederMacThroughput(SatStatsHelper::OUTPUT_SCALAR_FILE);
307 s->AddPerSatRtnFeederMacThroughput(SatStatsHelper::OUTPUT_SCATTER_FILE);
308
309 s->AddPerSatFwdUserMacThroughput(SatStatsHelper::OUTPUT_SCALAR_FILE);
310 s->AddPerSatFwdUserMacThroughput(SatStatsHelper::OUTPUT_SCATTER_FILE);
311 s->AddPerSatRtnUserMacThroughput(SatStatsHelper::OUTPUT_SCALAR_FILE);
312 s->AddPerSatRtnUserMacThroughput(SatStatsHelper::OUTPUT_SCATTER_FILE);
313
314 s->AddGlobalRtnAppThroughput(SatStatsHelper::OUTPUT_SCALAR_FILE);
315 s->AddGlobalRtnFeederMacThroughput(SatStatsHelper::OUTPUT_SCALAR_FILE);
316 s->AddGlobalRtnAppThroughput(SatStatsHelper::OUTPUT_SCATTER_FILE);
317 s->AddGlobalRtnFeederMacThroughput(SatStatsHelper::OUTPUT_SCATTER_FILE);
318
319 s->AddPerUtRtnAppThroughput(SatStatsHelper::OUTPUT_SCALAR_FILE);
320 s->AddPerUtRtnFeederMacThroughput(SatStatsHelper::OUTPUT_SCALAR_FILE);
321 s->AddPerUtRtnAppThroughput(SatStatsHelper::OUTPUT_SCATTER_FILE);
322 s->AddPerUtRtnFeederMacThroughput(SatStatsHelper::OUTPUT_SCATTER_FILE);
323
324 s->AddPerUtRtnAppDelay(SatStatsHelper::OUTPUT_SCALAR_FILE);
325 s->AddPerUtRtnMacDelay(SatStatsHelper::OUTPUT_SCALAR_FILE);
326 s->AddPerUtRtnAppDelay(SatStatsHelper::OUTPUT_SCATTER_FILE);
327 s->AddPerUtRtnMacDelay(SatStatsHelper::OUTPUT_SCATTER_FILE);
328
329 s->AddGlobalRtnCompositeSinr(SatStatsHelper::OUTPUT_SCALAR_FILE);
330 s->AddGlobalRtnCompositeSinr(SatStatsHelper::OUTPUT_SCATTER_FILE);
331 s->AddPerUtRtnCompositeSinr(SatStatsHelper::OUTPUT_SCALAR_FILE);
332 s->AddPerUtRtnCompositeSinr(SatStatsHelper::OUTPUT_SCATTER_FILE);
333
334 s->AddGlobalRtnFeederLinkSinr(SatStatsHelper::OUTPUT_SCALAR_FILE);
335 s->AddGlobalRtnFeederLinkSinr(SatStatsHelper::OUTPUT_SCATTER_FILE);
336 s->AddGlobalRtnUserLinkSinr(SatStatsHelper::OUTPUT_SCALAR_FILE);
337 s->AddGlobalRtnUserLinkSinr(SatStatsHelper::OUTPUT_SCATTER_FILE);
338
339 s->AddGlobalRtnFeederLinkRxPower(SatStatsHelper::OUTPUT_SCALAR_FILE);
340 s->AddGlobalRtnFeederLinkRxPower(SatStatsHelper::OUTPUT_SCATTER_FILE);
341 s->AddGlobalRtnUserLinkRxPower(SatStatsHelper::OUTPUT_SCALAR_FILE);
342 s->AddGlobalRtnUserLinkRxPower(SatStatsHelper::OUTPUT_SCATTER_FILE);
343
344 s->AddPerUtFwdAppThroughput(SatStatsHelper::OUTPUT_SCALAR_FILE);
345 s->AddPerUtFwdUserMacThroughput(SatStatsHelper::OUTPUT_SCALAR_FILE);
346 s->AddPerUtFwdAppThroughput(SatStatsHelper::OUTPUT_SCATTER_FILE);
347 s->AddPerUtFwdUserMacThroughput(SatStatsHelper::OUTPUT_SCATTER_FILE);
348
349 s->AddGlobalFwdAppThroughput(SatStatsHelper::OUTPUT_SCALAR_FILE);
350 s->AddGlobalFwdUserMacThroughput(SatStatsHelper::OUTPUT_SCALAR_FILE);
351 s->AddGlobalFwdAppThroughput(SatStatsHelper::OUTPUT_SCATTER_FILE);
352 s->AddGlobalFwdUserMacThroughput(SatStatsHelper::OUTPUT_SCATTER_FILE);
353 s->AddPerUtFwdAppDelay(SatStatsHelper::OUTPUT_SCALAR_FILE);
354 s->AddPerUtFwdMacDelay(SatStatsHelper::OUTPUT_SCALAR_FILE);
355 s->AddPerUtFwdAppDelay(SatStatsHelper::OUTPUT_SCATTER_FILE);
356 s->AddPerUtFwdMacDelay(SatStatsHelper::OUTPUT_SCATTER_FILE);
357 }
358
359 simulationHelper->RunSimulation();
360
361 return 0;
362
363} // end of `int main (int argc, char *argv[])`
ns3::SatEnvVariables::GetInstance
static Ptr< SatEnvVariables > GetInstance()
Definition satellite-env-variables.cc:135
ns3::SatLoraConf::SATELLITE
@ SATELLITE
For Satellite.
Definition satellite-lora-conf.h:41
ns3::SatSuperframeConf::SUPER_FRAME_CONFIG_4
@ SUPER_FRAME_CONFIG_4
SUPER_FRAME_CONFIG_4.
Definition satellite-frame-conf.h:531
ns3::SatSuperframeConf::CONFIG_TYPE_4
@ CONFIG_TYPE_4
Configuration type 4 (ESSA).
Definition satellite-frame-conf.h:548
ns3
SatArqSequenceNumber is handling the sequence numbers for the ARQ process.
Definition sat-link-results-plot.cc:41