forked from inet-framework/inet
-
Notifications
You must be signed in to change notification settings - Fork 0
/
WHATSNEW
2073 lines (1579 loc) · 91.4 KB
/
WHATSNEW
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
Recent changes in the INET Framework
====================================
INET-3.0.0 (Jun, 2015) - Stable
-------------------------------
This release requires OMNeT++ 4.6 or later. There are numerous breaking changes
since the latest stable version (2.6). Please read this file carefully and
see the ChangeLog files in the source for more details.
Nodes:
- Modules that represent a "node" at network level should be tagged with
@networkNode property instead of @node. (The @node property name was
too generic.) The INode module interface was renamed to INetworkNode, too.
Applications:
- The functionality of PingTestApp was merged into PingApp and PingTestApp
was removed.
Network Layer:
- Refactored IPv4/IPv6 options to use TLVOptions structure.
INET-2.99.1 (May, 2015) - Development
-------------------------------------
This release is the last development snapshot of the upcoming INET-3.0 version.
The highlights of this release are:
1. Includes a new packet/bit/symbol level physical layer model for the 802.11
OFDM PHY according to the IEEE 802.11-2012 standard, and a hypothetical
generic packet/bit/symbol level APSK physical layer model for further
experimentation. The new implementations include forward error correction
encoding/decoding, scrambling/descrambling, interleaving/deinterleaving, and
modulation/demodulation.
2. Contains fixes for more than 300 defects found by Coverity, an online C++
static code analysis tool. The reported Defect Density is decreased to
0.5/kLoC which is considered a result. You can find the detailed results at
https://scan.coverity.com/projects/3472
3. Contains several other memory leak and memory management fixes reported by
valgrind memcheck.
4. Modernizes C++ source code using new C++11 features such as nullptr, auto
types, range loop, override, etc.
Read on for further details.
All components:
- Replaced all variants of findModuleWherever calls with module parameters,
because their behavior is non-predictable and less composable.
- Replaced most getParentModule calls with module parameters to make modules
less dependent on their context, and thus more reusable.
- Replaced UnimplementedModule and all related *_None modules with calls to
firstAvailableOrEmpty NED function, and changed affected submodules to be
present conditionally.
- Moved interface classes under contract subdirectories. Moved base classes
under base subdirectories.
- Introduced a new script called 'inet_featuretool' in the root folder of the
project that allows listing/enabling/disabling specific features from the
command line. Use 'inet_featuretool -h' for further info.
The 'make makefiles' command now uses this tool to extract the required
command line options to generate the makefile. This means that after
enabling/disabling a feature you always have to invoke 'make makefiles'
to regenerate the makefile based on the new feature enablement state.
Nodes:
- All "node type" modules implement the INode module interface so it is now
possible to create networks (using the <"actualNodeType"> like INode construct)
where the actual node type can be configured from an ini file.
Emulation:
- Network Emulation feature no longer depends on OMNeT++ to detect the presence
of PCAP. Instead the feature can be turned on/off by the user.
Common:
- Added create-module and delete-module commands to ScenarioManager.
- New macros in INETDefs.h to test INET version: INET_VERSION (format: 0xAABB
where AA is the major while BB is the minor version in hex) and
INET_PATCH_LEVEL (format: 0xCC is the patch level in hex).
- On Linux, specifying --valgrind as the first argument for the opp_run script
(or a run script in the examples folder) will start the simulation using the
'valgrind' memory profiler.
- Added a reusable HeatMapFigure and a GaugeFigure.
- Added a reusable DelayedInitializer to support static member initialization
without having to worry about the initialization order.
- Renamed ByteArrayMessage to RawPacket.
Environment:
- Added isometric view angles to physical environment visualization.
- Added class and module interfaces to physical environment.
Mobility:
- Added a new StaticConcentricMobility similar to StaticGridMobility that places
nodes on concentric circles.
- Removed TracCI and TraCIScenarioManager because these modules are maintained
in the Veins framework.
Serializer:
- Refactored packet serializer classes to use a safe buffer class to read and
write binary data. This allows parsing incorrect binary representations without
runtime errors required by bit precise physical layer models.
- Refactored recursion in serializers to be extensible with new packet formats
without modifying existing code.
- Fixed a number of packet length bugs and inconsistencies between serialized
and non-serialized forms.
Application:
- Merged NetPerfMeter application from the master branch added by Thomas Dreibholz.
PCAP:
- Allow flushing the pcapFile after each write to ensure that all packets are
captured in case of a crash.
Transport Layer:
- Added ITransportPacket interface to TCPSegment, UDPPacket, and SCTPMessage.
It allows generic handling of transport packets.
SCTP:
- Added fragPoint parameter to limit the size of fragments.
- After the handshake only send heartbeats on unconfirmed paths.
- Fixed close command handling, i.e. stop reading when the command is sent.
- Handle SACK and NR_SACK separately and use getByteLength instead of getBitLength.
- Fixed several bugs.
TCP:
- Refactored and cleaned up TCP header options.
- Fixed scaling window bug (Martin Becke).
Network Layer:
- Factored out the network topology extraction algorithm from IPv4NetworkConfigurator
into a base class.
- Added support to IPv4NetworkConfigurator for computing wireless shortest path
based on a simple packet error rate estimation.
- Added netmaskRoutes parameter to IPv4RoutingTable to control whether netmask
routes are maintained or not.
- Added useAdminDist parameter to IPv4RoutingTable to enable/disable the use
of Cisco specific routing entry extension (disabled by default).
- Added IGMPv3 implementation (the orinal code came from the ANSA project).
It has been almost fully rewritten and extended by Tamas Borbely.
Routing:
- Added PIM-DM and PIM-SM implementation. The original codebase (from the ANSA project
http://nes.fit.vutbr.cz/ansa) has been extensively reviewed, refactored and
extended by Tamas Borbely.
Configurator:
- Refactored supported metrics (hopCount, delay, dataRate, errorRate) and related
parameters in IPv4NetworkConfigurator.
- Added autoroute XML configuration element to IPv4NetworkConfigurator. It provides
parameters for the automatic route discovery. The autoroute element determines
the set of routing tables that will be modified, the set of destinations for
which the shortest path will be computed, the used metric and the cost for nodes
and links.
Link layer:
- Added TUN/TAP virtual network interfaces thanks to Irene Ruengeler. This kind
of interfaces send/receive packets to/from TUN applications.
- Updated the 802.11 MAC implementation to use the new 802.11 mode descriptors.
- Replaced the old 802.11 operational mode and modulation descriptor classes.
This change modifies the fingerprint of a few simulations, because the header
length was computed incorrectly.
- Changed the 802.11 MAC to use asynchronous commands to set the radio mode.
- Updated the 802.11 MAC state machine diagram (graphviz) to reflect the current
state of the implementation.
- Added safety guard to the 802.11 MAC against recursively calling handleWithFSM.
- Fixed packet order in transmissionQueue.
- Renamed getNetworkInterfaceModule to getInterfaceModule in InterfaceEntry.
- Improved response time on external interfaces. On Linux cSocketScheduler is now
using immediate mode to reduce the CPU usage while still maintaining a fast
sub millisec response time (Artur Scussel). On Windows and MAC OS X the polling
interval was reduced to improve the response time.
- Added support for sending NF_LINK_BREAK signal from BMAC and CSMA. This is
required for certain routing protocols (i.e. AODV) to function properly.
- Extended Ethernet macs accept raw packet
Physical layer:
- Extended the physical layer contract interfaces for layered implementations.
- Added signal representations for packet domain, bit domain, symbol domain,
sample domain and analog domain, and also added contracts for the processing
components in all of these domains.
- Added a detailed 802.11 OFDM physical layer implementation that supports
packet-level, bit-level, and symbol-level simulations in compliant, and also
in freely configurable non-compliant operational modes.
- Replaced the old 802.11 operational mode and modulation descriptor classes.
The new classes are more detailed and more complete implementations. They
supports both the flat and the layered physical layer models and provide PHY
characteristics. The implemented 802.11 modes are: DSSS, HR-DSSS, FHSS, IR,
OFDM, ERP-OFDM.
- Added IEEE 802.11 High Throughput mode descriptor. This mode is defined in
Clause 20. High Throughput (HT) PHY specification in the IEEE 802.11-2012
specification. The new HT mode makes available the Wifi n modes in the
Ieee80211ModeSet.
- Added a simple hypothetical APSK physical layer implementation that supports
packet-level, bit-level, and symbol-level simulations with widely configurable
bit-domain and symbol-domain parameters.
- Consistently moved packet level and bit level implementations into separate
subdirectories throughout the physical layer.
- Added a generic convolutional encoder/decoder, a generic additive
scrambler/descrambler, and a 802.11 specific interleaver/deinterleaver.
- Added a separate modulations folder that contains descriptor classes for
various keying techniques such as BPSK, QPSK, QAM16, QAM64, QAM256, MQAM,
DBPSK, DQPSK, MASK, MFSK, MPSK, DSSS-OQPSK-16, etc.
- Reimplemented the computation of BER and SER based on the SNIR for the QAM-like
modulations according to wikipedia.
- Added a special IntervalTree cache for efficiently computing arrival intervals
for transmissions. This change drastically increases the physical layer
performance for large networks with lots of ongoing transmissions.
- Refactored the radio medium model to support the optional representation of
PHY frames for the layered physical layer models.
- Refactored the medium analog model to simultaneously support the new layered
and the already existing flat radio signal models.
- Refactored the existing 802.11 statistical error models to use the new
operation mode descriptors.
- Extracted the BER table based 802.11 statistical error model into a separate
class. This change modifies the fingerprint of simulations that use this
error model.
- Added a new detailed 802.11 error model that computes erroneous packet
domain, bit domain or symbol domain signal representations.
- Added 802.11 OFDM PHY frame serializer.
- Extracted separate CommunicationCache classes from RadioMedium.
- Extracted separate CommunicationLog class from RadioMedium.
- Extracted a separate MediumLimitCache module from RadioMedium.
- Extracted a separate MediumVisualizer module from RadioMedium.
- Added optional recent communication heat map to MediumVisualizer.
- Renamed radio control info classes to TransmissionRequest and ReceptionIndication.
- Added Ieee80211TransmissionRequest with an optional IIeee80211Mode parameter
to allow the mac module to determine the exact physical layer operational mode.
- Added CosineAntenna and ParabolicAntenna.
- Added basic antenna array support to be used with 802.11 HT modes.
- Added arrival parameter to computeReceptionPower. Added snir parameter to
computeIsReceptionSuccessful. Added snir parameter to computeReceptionDecision.
- Added level parameter to printToStream function to better support logging.
- Fixed the indefinite heap growth bug in the RadioMedium.
Tests:
- Added separate automated tests for convolutional encoding/decoding,
interleaving/deinterleaving, scrambling/descrambling, modulation/demodulation
and various combinations.
Examples:
- Added a new detailed 802.11 OFDM radio example that supports configurable
packet-level, bit-level, and symbol-level simulations for model verification.
- Also added a simple hypothetical APSK radio example that supports configurable
packet-level, bit-level, and symbol-level simulations for model verification.
- Added a work in progress Wireless tutorial in the tutorials/wireless folder.
INET-2.99.0 (November 2014) - Development
-----------------------------------------
This release is a snapshot of the development that has begun in early 2013, and
will culminate in the release of INET-3.0. The code is work in progress, which
means all details may still change until 3.0 is reached.
This release requires OMNeT++ 4.6 or later.
The highlights of this release are:
1. Network layer refactoring that allows higher layer protocols (including
routing protocols) to be written in a network protocol agnostic manner.
2. A new physical layer model that builds upon the INET and MiXiM physical
layers, and brings them to new heights. Design goals were extreme modularity,
extensibility, the ability to support (and easily switch between) various
levels of detail, and the ability to add support for exploiting various
pieces of parallel hardware.
3. Extensive refactoring aimed at improving code quality. It includes
directory restructuring, code formatting, refactoring of init stages and
publish-subscribe communication, and more.
Read on for further details.
Geometry model:
- Added new orientation related classes: EulerAngles, Rotation, and Quaternion.
- Added new basic 3D geometry classes: LineSegment, Box, Plane, and Polygon.
- Added new 3D convex shapes: Cuboid, Sphere, Prism, and Polyhedron.
- Added new geometry cache data structures: SpatialGrid, QuadTree, and BVHTree.
Physical environment model:
- Removed obsolete classes: Obstacle, ObstacleControl, and AnnotationManager.
- Implemented a completely new physical environment model as follows.
- Added a new global PhysicalEnvironment module that provides some trivial
global properties: temperature, space limits, and a list of physical objects.
- Added a new PhysicalObject class that has shape, position, orientation,
material, and various graphics properties.
- Added a new Material class along with some default materials: vacuum, air,
copper, aluminium, wood, brick, concrete, and glass.
- Added a new IObjectCache interface for efficient physical object queries
along a line segment.
- Added IObjectCache implementations: GridObjectCache and BVHObjectCache.
- Added an XML file format to initialize the physical environment with shapes,
materials, and physical objects.
- Added support for drawing the physical objects on a compound module canvas
(Tkenv) in 2D as seen from a configured view angle.
- Added examples that demonstrate the initialization and usage of the physical
environment, the physical objects, and the configuration of the object cache.
Power model:
- Removed obsolete classes: IBattery, BasicBattery, InetSimpleBattery and Energy.
- Implemented a completely new power model.
- Added new interfaces: IEnergyConsumer, IEnergyStorage, and IEnergyGenerator.
- Added implementations: IdealEnergyStorage, and SimpleEnergyStorage.
- Added a new power consumer implementation for radios based on the radio mode,
the reception state, and the transmission state: StateBasedEnergyConsumer.
Physical layer:
- Refactored and unified the existing INET and MiXiM physical layer models into
a new extended and scalable model as follows.
- Designed new interfaces and classes to support optimistic parallel computation
of reception results utilizing multicore CPUs and/or GPUs.
- Designed new model that supports different level of details with respect to
transmitters, receivers, radio signals, antennas, propagation models, etc.
- Added new radio signal power representations: scalar and dimensional over
time, frequency, space, etc.
- Added various performance vs. accuracy tradeoff configuration options (e.g.
range filter, radio mode filter, listening mode filter, MAC address filter)
- Added concurrent transmitter and receiver radio mode (transceiver mode).
- Added separate controllable radio mode and automatic signaling of reception
state and transmission state.
- Added configurable non-zero time radio mode switching.
- Added separate power consumption model based on the radio mode, the reception
state and the transmission state.
- Added support for burst mode (back to back) transmissions.
- Introduced compile time checked physical units in C++ code to avoid conversion
errors and to enhance self documentation.
Physical layer radio model:
- Removed obsolete classes: Radio, IdealRadio, GenericRadio, GenericRadioModel,
IRadio, IRadioModel, INoiseGenerator, and some others.
- Added new interfaces: IRadio, IAntenna, ITransmitter, IReceiver, and IErrorModel.
- Added new implementation classes: Radio, IdealRadio, ScalarRadio,
DimensionalRadio, Ieee80211Radio, and Ieee802154UWBIRRadio.
- Added a number of implementation base classes and subcomponents unlisted here.
- Added and updated error model implementations: FlatErrorModel,
Ieee80211NistErrorModel, Ieee80211YansErrorModel
- Introduced controllable radio mode: off, sleep, receiver, transmitter,
transceiver, and switching.
- Introduced automatically signaled reception state: undefined, idle, busy,
synchronizing and receiving.
- Introduced automatically signaled transmission state: undefined, transmitting.
- Added new antenna classes: IsotropicAntenna, ConstantGainAntenna,
DipoleAntenna, and InterpolatingAntenna.
Physical layer radio medium model:
- Removed obsolete classes: ChannelAccess ChannelControl, IdealChannelModel,
IdealChannelModelAccess and some others.
- Added new interfaces to model the radio medium: IRadioMedium, IPropagation,
IBackgroundNoise, IPathLoss, IObstacleLoss, IAttenuation, and INeighborCache.
- Added new implementation classes: RadioMedium, IdealRadioMedium,
ScalarRadioMedium, DimensionalRadioMedium, Ieee80211RadioMedium, and
Ieee802154UWBIRRadioMedium.
- Added propagation models: ConstantTimePropagation and ConstantSpeedPropagation.
- Added background noise source models: ScalarIsotropicBackgroundNoise and
DimensionalIsotropicBackgroundNoise.
- Refactored existing path loss models: FreeSpacePathLoss, LogNormalShadowing,
TwoRayGroundReflection, NakagamiFading, RayleighFading, RicianFading, and
SUIPathLoss.
- Added new path loss models: BreakpointPathLoss and UWBIRStochasticPathLoss
from MiXiM.
- Added a new obstacle loss model: TracingObstacleLoss.
- Added INeighborCache implementations: ListNeighborCache, GridNeighborCache,
and QuadTreeNeighborCache.
Physical layer communication model:
- Removed obsolete classes: AirFrame, IdealAirFrame and SnrList.
- Added new interfaces: IRadioFrame, ITransmission, IArrival, IReception,
INoise, ISNIR, IListening, and IReceptionDecision.
- Added new implementation classes: RadioFrame, Arrival, Interference,
ScalarSNIR, DimensionalSNIR.
- Added a number of implementation base classes unlisted here.
- Added range based, narrow band scalar and dimensional signal power
representations for transmissions, receptions, and noise.
Link layer:
- Added a simple MAC protocol for testing purposes: IdealMac.
- Ported MAC protocols from MiXiM: CSMA, BMACLayer, and LMacLayer.
Network layer:
- IPv4/IPv6: dynamic registration of upper layer protocols.
TCP, UDP, SCTP, RSVP, OSPF, MANET are all merged into transport gates.
Network user modules must register their protocol number by sending
an IPRegisterProtocolCommand from initialize().
Introduced an IPSocket class that wraps the registration process.
- Refactoring: routing tables and routes now implement a common IRoutingTable
and IRoute C++ interface (details below)
Motivation: allow uniform access to the IPv4, IPv6 and possibly other routing tables;
e.g. some wireless networks may use MAC address as network address. Also, in
simulation it sometimes makes sense to work with simple abstract addresses like
module names, indices or IDs.
Being able to uniformly access routing tables containing different types of
addresses makes it possible to implement routing protocols in generic way.
I.e. the same DYMO module can work with IPv4, IPv6, MAC and other addresses
without change and recompiling.
Ingredients of this patch:
- generic L3Address class that can hold all kinds of addresses (=union)
- interfaces for generic access: IRoutingTable, IRoute, INetworkDatagram, etc.
- Ping refactoring (use generic addressing instead of hardcoded IPv4, IPv6)
- merged routing table change notification constants for IPv4 and IPv6
- NetworkLayer was renamed to IPv4NetworkLayer and moved into src/networklayer/ipv4;
same for IPv6 (NetworkLayer6 -> IPv6NetworkLayer).
- IPvXAddress ha been extended and renamed to L3Address. Similarly,
IPvXAddressResolver became L3AddressResolver. In addition to IPv4 and IPv6
addresses, L3Address also allows using other kinds of addresses and identifiers
(e.g. MACAddress, module IDs, module paths) for network-layer addressing.
- Added GenericNetworkProtocol, which is a simplified network protocol with
table-based forwarding. It uses L3Address, so it is agnostic to the network-layer
address type.
- Added MultiNetworkLayer, which is a wrapper for multiple network layers; in
practice it can be used for simulating IPv4/IPv6 dual-stack hosts.
- Ported network protocols from MiXiM: Flood, ProbabilisticBroadcast, and WiseRoute.
C++ source cleanup:
- Changed include directives to specify the full path of the header file. This
resolves ambiguities caused by different projects having similar header files,
and by case-insensitive file systems (Windows).
- Changed header guards to use a uniform syntax.
- Applied code formatting (whitespace, braces, etc.) Formatter script (based on
uncrustify) is under _scripts/reformat, for future formatting needs.
- Introduced C++ namespaces: inet, inet::utils, inet::ospf, inet::bgp, inet::sctp, etc.
- Init stages have been refactored: initialization is now done bottom-up,
by layers, and hardcoded init stage numbers have been replaced by symbolic
constants.
- Removed NotificationBoard and INotifiable: all modules now use OMNeT++ signals
for publish/subscribe communication.
- Improved logging: log messages have been classified by importance, and logging
to EV has been replaced by EV_ERROR, EV_WARN, EV (for EV_INFO), EV_DETAIL,
EV_DEBUG and EV_TRACE accordingly. Proper support for these log categories
will be available from OMNeT++ 5.0, for 4.x they are simply mapped to EV.
- Several modules have been adapted to the coding conventions, e.g. the RTP models.
Directory reorganization:
- Moved src/ under src/inet/ to avoid header conflicts with 3rd party software.
- base/ and util/ have been consolidated into common/ and its several subdirectories
(e.g. common/misc/, common/geometry/, common/queue/, common/lifecycle/)
- queue/ has become common/queue/.
- Routing protocols have been moved into the new routing/ toplevel directory
from networklayer/routing/, networklayer/bgpv4 and networklayer/ospfv2/.
- Protocols in networklayer/manetrouting/ have been moved into routing/extras/.
- transport/ has been renamed to transportlayer/.
- battery/ has been replaced by power/, intended to hold models for power management
related components.
- The physicallayer/ toplevel directory has been created to hold the new physical
layer model.
- The environment/ toplevel directory has been created for models that represent
the global physical environment.
- world/ no longer exists, its contents has been distributed to other directories.
- status/ lives on as common/lifecycle/.
- networklayer/autorouting/ has become networklayer/configurator/.
- applications/httptools/ has been split up to several subdirectories: browser/,
server/, configurator/, common/.
INET 2.6 (March 05, 2015) - Stable
----------------------------------
This release requires OMNeT++ 4.4 or later. It contains the following changes:
- made compatible with OMNeT++ 5.0b1
- added OLIA for CMT-SCTP (by Martin Becke)
- added a trace player feature to NetPerfMeter
- fixed compile errors when using OMNeT++ 5.0b1
- fixed an issue with too small initial value of 'ssthreshold' in TCP
- fixed window scaling in TCP
- added INET_VERSION macro (in hexadecimal form e.g.: 0x0206)
INET 2.5.1 (Nov 7, 2014)
------------------------
This release requires OMNeT++ 4.4.
Changes:
- fixed a crash in SCTP
- now builds with all features turned off
INET 2.5.0 (Oct 29, 2014)
-------------------------
This release requires OMNeT++ 4.4.
Changes:
- made the codebase compile in C++11 mode. (required by OMNeT++ 4.6)
- added netperfmeter application by Thomas Dreibholz
INET-2.4.0 (June 12, 2014)
--------------------------
New AODV protocol implementation:
- From-scratch AODV implementation backported from the integration
branch; see src/network/routing/
Changes:
- Added support for link break detection in IdealWireless
(using the NF_LINK_BREAK signal)
- VoIPStream updated to match the latest version of ffmpeg library.
- Added packet printers that can dump packet data in OMNeT++ 4.5/Tkenv
in the packet trace window.
- Fixed non-conformant 802.11 WAITACK timeout computation
INET-2.3.0 (March 17, 2014)
---------------------------
This release contains several new protocols, and a lot of changes that were
backported from the current integration branch (destined to be INET 3.0).
This release requires OMNeT++ 4.3.
Application startTime/stopTime fixes:
- apps start sending at startTime, and send their last packet
before stopTime
- negative stopTime means sending forever
- if startTime and stopTime are the same, the app sends a single
packet only (except TCP apps)
DHCPServer and Client:
- The whole implementation has been reviewed to bring it closer to
the standards defined in RFC 2131 and 2132.
- Major changes were made both in client's and server's state machines.
It is now extended with new states (INIT-REBOOT, REBOOTING) and
with new message types (DHCPNAK, DHCPDECLINE). The new states allow
the user to model scenarios with lifecycle events.
- The server's performance model has been removed.
- The internal representation of the DHCP options were moved to the
DHCPOptions INET message definition file.
- Limitation: The client module currently does not support multiple
DHCP servers and BOOTP relay agents.
SCTP improvements submitted by Irene Rungeler and Thomas Dreibholz:
- added CMT support (Concurrent Multipath Transfer)
- added SCTP NAT support
- added support for using SCTP over IPv6
STP / RSTP support (802.1d) added to the EthernetSwitch:
- STP: added IEEE 802.1D-1998 implementation of Spanning Tree Protocol.
The source code is based on the ANSA (https://github.com/kvetak/ANSA)
implementation.
- RSTP: added IEEE 802.1D-2004 implementation of Spanning Tree Protocol.
The source code is based on Juan Luis Garrote Molinero's implementation
from INETMANET.
- Interfaces can be configured using the new L2NetworkConfigurator module.
This module allows one to configure network scenarios at Layer 2.
- Replaced the EtherSwitch relay unit with a new, STP/RSTP capable one.
The CPU and memory modelling are no longer supported in this relay unit.
Nodes automatically pick-up the network configuration on restart:
- An IPv4NodeConfigurator module has been added to hosts, which is responsible
for configuring the host on restart based on information stored in the
IPv4NetworkConfigurator module.
INetFilter::IHook API:
Modules can now hook into the IP module with the new 'NetFilter' API.
Routing protocols can be implemented now without modifying the IP
module's code. ManetRoutingBase, InternetCloud and ARP have been updated
to use the new 'NetFilter' API.
Added new routing protocols:
- RIP (networklayer/routing/rip)
- GPSR (networklayer/routing/gpsr)
- DYMO (networklayer/routing/dymo)
These protocols use INetFilter::IHook, too.
Revised Mobility code:
Split the 'models' directory into multiple directories:
- contract - specifies the interface of mobility models
- common - shared files among mobility models that are not complete
mobility models
- static - mobility models that actually don't move
- single - mobility models controlling only one moving object
- group - mobility models controlling multiple interlinked moving objects
Radio:
Added the Stanford University Interim radio propagation model contributed
by Konrad Polys and Krzysztof Grochla.
Other, smaller changes:
- Added ILifecycle support to most applications
- Renamed AppBase to ApplicationBase and moved to 'common'.
- UDP: added option to specify the source address of the sent datagram
- UDPBasicBurst: added bool parameter: excludeLocalDestAddresses
- UDPVideoStreamCli: use stages in initialize
- UDPApp*: Added AppBase and subclassed UDP apps from it.
Binds sockets at startTime and closes them at stopTime.
- EtherApp* bugfixes
- Added a command to set TCP queue length threshold. TCP will notify the
application if it is ready to transmit more bytes.
- registerSignal() calls were moved from initialize() to static
variable declarations.
- Added/fixed @signal declarations, fixed the type of emitted values.
- httptools: removed the fileExists() function.
- New logging mechanism + EV handling in preparation for the new OMNeT++ 5.0
logging mechanism.
- IPv4Route/IPv6Route: added administrative distance field
- Added IPv6 header serializer (so ext interfaces can be used with IPv6, too)
- Invalid access of message pointers fixed in: OSPF, SCTP, DHCP, PingApp
- Battery: code review, small fixes.
- Revised init stages in all modules
- Many smaller fixes and improvements (see the ChangeLog files for further detail.)
INET-2.2.0 (August 22, 2013)
----------------------------
The main highlight of this release is the long-sought support for
simulating node shutdown/restart events for network nodes.
This release requires OMNeT++ 4.2 or later.
New features:
1. Lifecycle infrastructure.
For node shutdown/crash/startup/etc, a LifecycleOperation (e.g.
NodeShutdownOperation) is applied to the submodule tree of the node
(host or router) by LifecycleController. Each module can decide how
to handle the operation and how to store the resulting state (up/down,etc).
Operations can be multi-stage, and don't need to complete immediately
(i.e. they can take nonzero simulation time and multiple events to complete).
Network nodes now also have a status submodule (type NodeStatus) with the sole
purpose of storing the whole node's status (up/down) and displaying it
via icons.
- classes: ILifecycle, LifecycleOperation (NodeOperation, InterfaceOperation),
LifecycleController, NodeStatus
- NodeStatus module to store the network node's status (up or down)
- added optional NodeStatus submodule to NodeBase
- added a test for the basic Lifecycle infrastructure
We also removed obsolete ways of shutdown/restart: FailureManager, PowerControl,
LDP_FAILED/RSVP_FAILED, etc.
2. Static IP4 configuration:
A new module, IPv4NodeConfigurator was added to IPv4NetworkLayer. This module
is necessary because IPv4NetworkConfigurator cannot configure the node after
a restart (see newly introduced node lifecycle operations above), since
being a global module, it doesn't know about node lifecycle events. The new
module listens to node lifecycle events, and configures the node's routing
table and interfaces according to configuration computed by the network's
global IPv4NetworkConfigurator module. Initialization-time node configuration
is also carried out by the new module.
3. Added TCP Vegas and Westwood algorithms.
The implementation is a slightly improved version of a 2013 workshop submission:
"INET framework extensions for TCP Vegas and TCP Westwood", Maria Fernandez,
Carlos Calafate, Juan-Carlos Cano and Pietro Manzoni. OMNeT++ Workshop, 2013.
http://www.omnet-workshop.org/2013/uploads/slides/OMNeT-Workshop2013-SP-4.pdf
4. Added IdealWirelessNic (IdealRadio + IdealWirelessMac) and IdealWirelessFrame msg.
This is a highly abstracted wireless NIC that consists of a unit disk radio
and a trivial MAC protocol. It offers simplicity for scenarios where Layer 1
and Layer 2 effects can be completely ignored, for example testing the basic
functionality of a wireless ad-hoc routing protocol.
The most important parameter this model accepts is the transmission range.
When a radio transmits a frame, all other radios within transmission range
will receive the frame correctly, and radios out of range will not be
affected at all. There are no collisions -- a radio can simultaneously
receive any number of frames, and also transmit a single frame at the same time.
5. STCP received several new features (patches submitted by Irene Ruengeler):
- 8 new strategies for SCTP stream scheduling
- SCTP Stream Reset (RFC 6525)
- SCTP Authentication (RFC 4895)
- Add-IP feature for SCTP (RFC 5061)
- NR_SACK feature to SCTP
- Partial Reliability SCTP (RFC 3758)
- SCTP packet drop feature (draft-stewart-sctp-pktdrprep-15.txt)
- SCTP "sack immediately" feature (draft-ietf-tsvwg-sctp-sack-immediately)
- several alternatives to send fast retransmissions on SCTP
6. Loopback interface added
Loopback used to be a special case inside the IPv4/IPv6 modules, now it
is handled completely like any other interface, with a separate Loopback
module.
7. EtherSwitch, AccessPoint:
Bare EtherMAC modules have been replaced with EthernetInterface, so that
external queues can be used (useful for e.g. QoS).
8. InterfaceTable, NIC, NetworkLayer:
Revert to earlier behavior of determining networkLayerGateIndex.
Now the module connected to a NIC *must* have gate vectors called ifIn and ifOut.
If it doesn't, the code decides that the NIC is *not* directly connected to
a network layer, and leaves networkLayerGateIndex unfilled.
Other, smaller changes:
- MANET protocols have been synchronized with the INETMANET project
- NodeBase: added optional battery (off by default)
- UDP: implemented ReuseAddress option (it's like SO_REUSEADDR socket
option in Linux). If ReuseAddress is set to true on two sockets,
then they can bind to the same local address/port.
- PingApp and other apps: for the stopTime parameter, 'none' is now represented
by -1, not 0. As this is the default setting, likely very few simulations
(ini files) are affected.
- IPv4NetworkConfigurator: added @groups to <interface> (ie. multicast groups
can now be also specified in the <interface> element, not only in a separate
<multicast-group> element)
- in many simulation examples, .irt files were replaced by IPv4NetworkConfigurator XML.
- EtherMACFullDuplex: wait IFG *after* frames, not before.
- Ieee80211Mac: added signals declarations and statistics in the NED file
- EthernetInterface: the encap submodule was made replaceable ("like IEtherEncap")
- NED: Added InterfaceTable unconditionally to bridge devices, as it is currently
required by IPv4NetworkConfigurator. Also added NotificationBoard required by
InterfaceTable.
- IPv4NetworkConfigurator: Changed to support mixed wired and wireless LANs
for autoconfiguration.
- Fixed IPv4NetworkConfigurator bug sometimes not being able to assign addresses.
Changed to assign most constrained addresses first.
- RTPHost was moved from src/transport to src/nodes/, and changed to be based
on StandardHost
- TurtleMobility: Fixed getting the position from a mobility signal listener
during initialization. The script was resumed before initialize() finished,
resulting in incorrect positioning.
- StaticGridMobility: Added new parameters to specify the number of rows/columns
and the horizontal/verical separation between the nodes. Note that the way
the node positions are calculated has changed. You may need to update your
INI files (see the NED file for more info.)
- Many smaller fixes and improvements
INET-2.1.0 (Jan 31, 2013)
-------------------------
NEW:
- Added a new module to model an "internet cloud". The component can
be configured to model packet delay, datarate and drop probability
between each input-output interface pair. The parameter matrix
is provided as an XML configuration file. See the README file
in src/nodes/internetcloud for further details.
- New SimpleVoIPReceiver/Sender applications that gather MOS (Mean
Opinion Score) for measuring voice quality.
- Added HNA support to the Batman protocol (MANET)
CHANGED:
Applications:
- PingApp: Shows the configured destination address at the end of the
simulation.
- TCPBasicClientApp: bugfix #611: simulation generated an ASSERT if
numRequestsPerSession parameter value larger than 1.
- TcpApp: socket state is now shown on the GUI (in Echo, Sink and Session apps.)
- VoipTool: was renamed to VoIPStream (The actual module names are
VoIPStreamSender/Receiver.)
Ethernet:
- Transmission channel's 'disabled' parameter is now correctly handled in
EtherMacBase.
Ieee80211Mac:
- Better parameter processing in MAC: error is thrown if an undefined value
is specified for the opmode or autoBitrate parameters.
- Added the Ieee80211Descriptor class to assign modulation speed
and type for the different opModes.
- Bugfix: Default bitrate for opMode 'p' was incorrectly set.
BGP:
- Minor optimizations
- Bugfix: The text in specification "sets the ConnectRetryTimer to zero" means:
restart this timer. The _connectRetryTime member now stores the timeout value.
Manetrouting:
- updated documentation
- replaced Uint128 with ManetNetworkAddress
- removed:
- unused ManetTimer and BatmanTimer class
- unused static variables
- isIpLocalAddress(), uses isLocalAddress()
- convertAddressToString()
- getXPos(), getYPos() functions, you should use getPosition()
instead.
- redesigned coordinate and speed storage and access.
replaced double x,y with a Coord. getDirection() now returns the
speed vector (as a Coord)
- getters returns UNSPECIFIED_ADDRESS if addrType==UNDEFINED
- merged sendToIp() code into a common base function sendToIpOnIface()
AODV:
- AODV's hand-written descriptors were replaced with generated ones
[with A.Varga]
- aodv_msg_struct.h: added getter methods expected by the generated
descriptors removed hand-written aodv_msg_struct_descriptor.cc
Batman:
- Updated and expanded documentation
- Updated the code to match the latest available "batmand" version.
- Numerous optimizations
- Fixed several memory leaks
- Fixed routing table corruption and possible crash when multiple
radios were used in a single host
- Fixed decapsulation of incoming packets. Now it checks for the
type of decapsulated packet.
- Fix for a problem when aggregated batman packets were
dropped erronously.
- Added HNA support. Nodes can advertise external networks,
so traffic towards those networks can be routed correctly.
Use the announcedNetworks parameter to specify multiple connected
external networks.
- Added SourceModifier script to help the conversion from the original
batmand code.
- fixes spaces, tabs and empty lines
- replaces some c-style structs to c++-style classes
- replaces some batmand specified list manipulators with c++ code
- replaces malloc/free with new/delete
- removes prof_start()/prof_stop() calls
Examples:
- Added a new simulation with wired and wireless hosts exchanging UDP
data via an AccessPoint. It shows how to use the IPv4NetworkConfigurator
to mix wired and wireless networks.
- Fixes for BGP examples.
- New example to demonstrate HNA support in Batman.
- Hostautoconf examample moved to the adhoc folder.
Other changes:
- Uint128 class was removed. Use ManetNetworkAddress class instead.
- Visual changes in StandardHost/NodeBase: utility module icons are
now smaller and wlan[]/PingApp[] modules are displayed in a row.
- NodeBase: it is possible to use mobility module even if numRadios = 0
- Added check for detecting too small netmask parameter value in
HostAutoConfigurator
- PacketDump: TCP header option fix (dumped only in verbose mode.)
- Bugfix #620. The module pointer returned by a ModuleAccess class is
now cached only if get() was used. For get(module) no caching is done.
- MACAddress: made the constructor explicit so we will not see
unexpected implicit conversions in future
- IPv6Address: removed Uint128 related functions and added an
additional constructMask() method
- headerserializers: compile fix for Visual C++ 10.0 and later
- Pcap now records on ALL interfaces by default (including external IFs).
Added Enter_Method for better error reporting if a packet cannot be
serialized. Also added an icon for PcapRecorder.
- Several TCP related fixes.
INET-2.0.0 (Aug 7, 2012)
------------------------
If you are upgrading from an earlier INET version (i.e. INET 20111118),
expect to have to revise your existing omnetpp.ini files and possibly
NED/C++ files as well.
Changes since 1.99.5:
The DHCP protocol received several fixes. It is now possible to use DHCP
with both wired and wireless interfaces.
MANET routing protocols updated from INETMANET-2.0 @ 9a3dc7a
OLSR protocol received several patches allowing it to work with multiple
radios. It can work now on both wired and wireless interfaces.
Ieee80211:
- bugfix: The latest version of INET (1.99.5) contained a bug where
speed values for 11MBps and 12MBps were swapped.
- A new "bitrate" parameter was added to the Ieee80211Nic module.
The Radio and MAC module uses this bitrate to set thir own bitrate
value. Its default value is 11Mbps for 802.11b, 27Mbps for 802.11p
and 54Mbps for 802.11g and 802.11a. (i.e. the default bitrate depends
on the opMode parameter) This can avoid potential configuration
inconsitencies. UPDATE all your INI files accordingly.
The Ethernet module now throws an error message if two ethernet ports are
connected using an IdealChannel. Previously it just silently ignored the
connection that was definitely against the "least surprise" principle.
A new "Delayer" module has been added and DropsGenerator and DuplicatesGenerator
has been renamed to OrdinalBasedDropper and OrdinalBasedDuplicator respectively.
These modules implement the IHook module interface and can be installed inside
hosts to induce different packet errors. IHook modules can be inserted
between the network and link layer protocols.
The Ext-interface, TraCI, Mobility and Ping modules received some minor fixes.
See ChangeLogs in individual source folders for more information.
INET-1.99.5 (June 22, 2012)
---------------------------
This is the final testing version of the 1.99.x series leading to the 2.0
release. Requires OMNeT++ 4.2 (version 4.2.2 suggested).
Several OSPF fixes and changes in configuration (see the ChangeLog file
in the OSPF folder for details):
- improved error detection in xml config files
- replaced the ospfConfigFile string-type ned parameter with ospfConfig parameter (xml type)
- uses IPvXAddressResolver for reading IP address and IP netmask values from xml
- uses @name instead @id to identify the routers in the xml config
- most attributes in xml config became optional, and default values
come from ned the parameters of OSPFRouting (with same name)
- modified xml schema: converted most subnodes to attributes
- Added etc/OSPFold_to_OSPFnew.xsl for converting the old xml format to new, and
converted all the ospf config files to the new format in the examples folder
(after using the converter you must convert router@id to router@name by hand).
- added @toward attribute to XML for easier interface specification
old: interfaces were specified by their name (e.g. ifName="eth0").
new: interfaces can be specified either by their name (e.g. ifName="eth0"),
or by the name of a module the interface is connected to (e.g. toward="Area3.N9")
- fixed OSPF.xsd schema
Queueing components:
The networklayer/queue folder has moved to linklayer/queue folder as
queues are mostly used in linklayer. This is a new framework that can be
used to create more complex systems.
Old queuing components has been removed:
- DropTailQosQueue, REDQueue, WeightedFairQueue
- IQoSClassifier (moved to linklayer/ieee80211/mac)
- BasicDSCPClassifier
Some of them can be substituted by compound modules composed of these newly
added components:
- FIFOQueue
- REDDropper
- ThresholdDropper
- PriorityScheduler
- WRRScheduler
For example REDQueue is a combination of a REDDropper and a FIFOQueue,
and DropTailQosQueue is a combination of some classifier, DropTailQueues,
and a PriorityScheduler. Read the INET Manual (in doc folder) for more
information about the usage of these modules.
Brand new Differentiated Services component (using the Queueing framework)
that is implementing the following standards:
- RFC 2474: Definition of the Differentiated Services Field (DS Field) in
the IPv4 and IPv6 Headers
- RFC 2475: An Architecture for Differentiated Services
- RFC 2597: Assured Forwarding PHB Group
- RFC 2697: A Single Rate Three Color Marker
- RFC 2698: A Two Rate Three Color Marker
- RFC 3246: An Expedited Forwarding PHB (Per-Hop Behavior)
- RFC 3290: An Informal Management Model for Diffserv Routers