-
Notifications
You must be signed in to change notification settings - Fork 147
/
WHATSNEW
3575 lines (2660 loc) · 155 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
What's New
==========
This file summarizes OMNeT++ changes in each release. For changes related to
simulation model compatibility, see doc/API-Changes. For more detailed info
about all changes, see include/ChangeLog, src/*/ChangeLog, and ide/ChangeLog.
OMNeT++ 4.4.2 (August 2023)
---------------------------
This is a modernized version of omnetpp-4.4.1 that makes it possible to build
and use the now 9-year-old package in today's software environments. The
primary objective of this release is to facilitate the execution of old
simulation models, e.g. for reproducing simulation results or as a basis of
porting them to more recent versions of OMNeT++.
Changes:
- Source code updated to eliminate warnings issued by modern C++ compilers.
Backported several smaller fixes.
- Adjusted to make the code compatible with more recent versions of Tcl/Tk
libraries. In addition to the original Tcl/Tk-8.4 and BLT-2.4z, Tkenv now
works with Tcl/Tk-8.6 and BLT-2.5.3, too.
- Updated the 'setenv' and 'configure' scripts, to make them more consistent
with those in more recent or modernized releases. This includes:
1. 'configure' now mandates having 'setenv' sourced before it runs.
2. 'setenv' now sets OMNETPP_IMAGE_PATH, in order to prevent model
frameworks from accidentally making omnetpp's bundled icons unaccessible
from Tkenv by simply appending to OMNETPP_IMAGE_PATH.
3. 'configure' now creates 'configure.user' from 'configure.user.dist'
if it does not already exist.
- Allow running tests in other than "debug" mode.
OMNeT++ 4.4.1 (Feb 2014)
------------------------
Bugs fixed: http://tinyurl.com/omnetpp441-fixes
OMNeT++ 4.4 (Dec 2013)
----------------------
Sim:
- Support for optional signal checking. When signal checking is turned on,
signals emitted by modules/channels must be declared with a @signal property
in the module's or channel's NED description; undeclared signals will result
in a runtime error. Signal declarations are of the form
@signal[<signalName>](type=<dataType>).
<signalName> may contain wildcards (?,*). Type is optional; if present,
data type can be long, unsigned long, double, simtime_t, string, or a
registered class name. To allow NULL pointers, append a question mark to
the class name. Example:
@signal[receivedPk](type=cPacket?);
This feature is controlled by the check-signals=<bool> configuration
option, and it is turned off by default for now.
- Support for @statistic-style declarative result recording on dynamically
registered signals (e.g. "conn-<n>" where n is an integer). Instead of
@statistic, add a @statisticTemplate property in the NED file, and for
each new signal call ev.addResultRecorders(...).
- Support for programmatically adding result filters and recorders on
signals: cResultRecorder has been revised to allow result recorders
to be used without a corresponding @statistic attribute, e.g. they
can now be added to signals programmatically.
- Further signals-related changes:
- added emit(simsignal_t, const cObject*) to cComponent
- added receiveSignal() overload for bool to cIListener
- introduced SimsignalType which replaces the older cITimestampedValue::Type
- added cObjectFactory::isInstance() method that effectively wraps a
dynamic_cast
- added Register_Abstract_Class() macro that allows abstract classes to be
used in signal declarations as type.
- Added cNEDValue::parseQuantity()
- New result filter: removeRepeats
- Feature: Just-in-Time debugging support. It adds the following new
configuration options: debugger-attach-on-startup=<bool>,
debugger-attach-on-error=<bool>, debugger-attach-command=<string>,
debugger-attach-wait-time=<time>. When any of the first two options are
set to true, the simulation kernel will launch an external debugger
attached to the simulation process at the appropriate time. The default
debugger on Linux is Nemiver.
NED:
- More freedom in NED property syntax: (1) Hyphens, dots and colons are now
allowed in property names and indices; and (2) values no longer need
to be enclosed in quotes if they contain parens, provided that parens are
balanced.
Tkenv:
- Feature: Animation filters (right-click on any message, and select
"Exclude messages like '...' from animation" from the context menu.)
- Feature: "Debug Next Event" (Ctrl+F9). It causes the simulation program
to stop in the debugger just before entering the handleMessage() call.
- Fixes and workarounds for various issues on Mac OS X (poor animation speed,
missing icons on OS X Mavericks, hang on the F5 key, etc.)
- Fix: the "Filter Window Contents" dialog could lose state
- Source cleanup (consistent naming style for Tcl procedures)
IDE:
- Use Eclipse 4.3 as base platform
- Support for project-specific images: icons from the "images/" folder of the
project and its dependencies are automatically used by the NED editor, and
added to the Tkenv image path when the simulation is launched. (The folder
name is currently hardcoded; it will become configurable in future versions.)
- Sequence Chart: Fixed bug that caused including the same reuses multiple times.
Fixed error handling when the error occurs in paint during startup.
Improved support for C++11, Mac OS X:
- The source now compiles without any warning with both gcc and clang, using
the "-std=c++11 -Wall" flags (clang is the default compiler on OS X since
version 10.9 Mavericks).
- Added proper support for cross-compilation using ./configure --host=i686-w64-mingw32
- Updated install instructions for OS X 10.9 Mavericks. Specifically, gdb is
no longer distributed with OS X; users are expected to install it themselves
from MacPorts, and digitally sign it.
- IDE: fixed the launcher not to throw error if the toolchain is clang.
- Updated the source to compile with both Bison 2.3 and 3.0
Bugs fixed: http://tinyurl.com/omnetpp44-fixes
OMNeT++ 4.3.2 (August 2023)
---------------------------
This is a modernized version of omnetpp-4.3.1 that makes it possible to build
and use the now 10-year-old package in today's software environments. The
primary objective of this release is to facilitate the execution of old
simulation models, e.g. for reproducing simulation results or as a basis of
porting them to more recent versions of OMNeT++.
Changes:
- Source code updated for C++11 compatibility, and to eliminate warnings
issued by modern C++ compilers. Backported several smaller fixes.
- Adjusted to make the code compatible with more recent versions of Tcl/Tk
libraries. In addition to the original Tcl/Tk-8.4 and BLT-2.4z, Tkenv now
works with Tcl/Tk-8.6 and BLT-2.5.3, too.
- Updated to compile with both Bison 2.3 and 3.0.
- Updated the 'setenv' and 'configure' scripts, to make them more consistent
with those in more recent or modernized releases. This includes:
1. 'configure' now mandates having 'setenv' sourced before it runs.
2. 'setenv' now sets OMNETPP_IMAGE_PATH, in order to prevent model
frameworks from accidentally making omnetpp's bundled icons unaccessible
from Tkenv by simply appending to OMNETPP_IMAGE_PATH.
3. 'configure' now creates 'configure.user' from 'configure.user.dist'
if it does not already exist.
- Allow running tests in other than "debug" mode.
OMNeT++ 4.3.1 (Sept 2013)
-------------------------
The IDE was made more friendly to first-time users:
- When the IDE is started with an empty workspace (e.g. on first-time
launch), it offers the user the following options: (1) Import the OMNeT++
sample simulations into the workspace; and (2) Download and install the
INET Framework.
- The latter function is also available via the Help > Install Simulation
Models... menu item. The menu item brings up a dialog with the list of
simulation models available for automated installation, and lets the user
choose. Currently only the INET Framework is listed there, but it is
planned to add further models.
- When the IDE is started for the first time, it now displays some helpful
introductory pages in the editor area: "Getting Started" (practical
advice for getting past the first 10 minutes spent in the IDE);
"At a Glance" (explains the common file types like NED, msg and ini, and
their purposes); "OMNeT++ Samples" (describes each example simulation in
two sentences, then provides links for opening the project, viewing the
README, launching the simulation, etc.) These pages are also available
from the Help system (except the last one, which has a dedicated menu item
under the Help menu.)
Further IDE improvements:
- IDE launcher script: fixed #670 (vmargs conflict between omnetpp.ini and
the launcher script). This bug could cause IDE crashes by PermGenSpace
exhaustion.
- Analysis Tool, Output Vector View: show "Go to" actions in the context
menu (instead of the view's pulldown menu)
- Analysis Tool: fixed #389 (Useless items in the Statistic Name filter):
The filter hints of combos is now computed from the result items filtered
by the other 2 combos.
- Analysis Tool: fixed #388 (add '*.host[*].*' variant to module filter hints)
- Ability to import sample projects even if workspace is different from
omnetpp/samples
- Trying to launch a closed project will now offer opening it
- NED documentation generator: fixed #672 (Illegal group reference error)
- Changed default appearance of the main welcome page to be more user
friendly
- Some other bug fixes
OMNeT++ 4.3 (March 2013)
------------------------
IDE:
- Updated to Eclipse 3.8.2.
- The CDT debugger no longer stops at the main() function by default.
- The bundled GDB has been downgraded to 7.4, due to problems with the one
in the 4.3rc1 version
Tools:
- The configure script now correctly detects the X headers on Mac OS X 10.8.
OMNeT++ 4.3rc1 (Jan 2013)
-------------------------
IDE:
- Analysis tool: added support for computed scalars. Read the updated the
User Guide for further details.
- Analysis tool: added 'Logarithmic X axis' option to scatter chart.
- Added NED editor support for named channels.
- Added support for opening files from the command line, i.e. use:
$ omnetpp Aloha.ned
- Added full screen mode (Ctrl-Shift-F11).
- Usability improvements in the Analysis Tool.
- Better error reporting in the Sequence Chart and Event Log views.
- The CDT C++ code analyzer has been turned off as it was reporting
too many false positives.
- The IDE has been switched over to use CDT's DSF debugger instead of
the older CDI.
- The IDE no longer runs the C/C++ Indexer before build (the code now
collects the information for makefile dependency generation by other
means)
- Added pretty printing of STL containers (std::map, etc), simtime_t
and other objects to the debugger; see the updated User Guide for
details.
- Updated the bundled MinGW (GCC, linker and GDB).
- Updated to Eclipse 3.8.1; the IDE now requires Java 1.6+.
NED:
- Added named channels support, e.g. "...<--> eth1: EthernetChannel <-->...",
with the purpose of making it easier to address channel objects when
assigning parameters from ini files. Channel definitions can now specify
a default name (via the @defaultname property), too.
Sim:
- Added the cPatternMatcher and cMatchExpression utility classes to the API.
cPatternMatcher is a glob-style pattern matching class. cMatchExpression
builds on top of cPatternMatcher and lets you combine patterns with AND,
OR, NOT for matching fields of arbitrary objects.
- Added hasEncapsulatedPacket() to cPacket.
- Implemented calculateWeightedSingleShortestPathsTo() in cTopology.
- Signals implementation now allows static initialization of simsignal_t
variables.
- Fixed a bug in Expression where '-2m' was evaluated to '2' (meter was lost)
Tools:
- The simulator now supports Mac OS X 10.8 (you need to install XQuartz; see
the Install Guide)
- Simplified makefile output: Makefiles now output only the filenames to the
console instead of whole commands. This makes the build output less noisy.
If you need the old behavior, use the 'V=1' (verbose on) option on
the make command line.
OMNeT++ 4.2.3 (August 2023)
---------------------------
This is a modernized version of omnetpp-4.2.2 that makes it possible to build
and use the now 11-year-old package in today's software environments. The
primary objective of this release is to facilitate the execution of old
simulation models, e.g. for reproducing simulation results or as a basis of
porting them to more recent versions of OMNeT++.
Changes:
- Source code updated for C++11 compatibility, and to eliminate warnings
issued by modern C++ compilers. Backported several smaller fixes.
- Adjusted to make the code compatible with more recent versions of Tcl/Tk
libraries. In addition to the original Tcl/Tk-8.4 and BLT-2.4z, Tkenv now
works with Tcl/Tk-8.6 and BLT-2.5.3, too.
- Updated to compile with both Bison 2.3 and 3.0.
- Updated the 'setenv' and 'configure' scripts, to make them more consistent
with those in more recent or modernized releases. This includes:
1. 'configure' now mandates having 'setenv' sourced before it runs.
2. 'setenv' now sets OMNETPP_IMAGE_PATH, in order to prevent model
frameworks from accidentally making omnetpp's bundled icons unaccessible
from Tkenv by simply appending to OMNETPP_IMAGE_PATH.
3. 'configure' now creates 'configure.user' from 'configure.user.dist'
if it does not already exist.
- Allow running tests in other than "debug" mode.
OMNeT++ 4.2.2 (March 2012)
--------------------------
Bugs fixed: http://tinyurl.com/omnetpp422-fixes
OMNeT++ 4.2.1 (Jan 2012)
------------------------
Bugs fixed: http://tinyurl.com/omnetpp421-fixes
OMNeT++ 4.2 (Nov 2011)
----------------------
Several bug fixes.
OMNeT++ 4.2rc2 (Nov 2011)
-------------------------
Documentation:
- Revised and significantly expanded the "C++ Development" chapter in the
User Guide to better assist model developers; smaller improvements in
other chapters
Tools:
- Updated MSYS and MinGW binaries in the Windows distribution.
- The build system now creates 64-bit binaries on Mac OS X 10.6 and 10.7
(if your processor supports it). Previously the -m32 flag was added to
the GCC command line to force the creation of 32-bit binaries. (This
was necessary because earlier versions of CDT did not support 64-bit
debugging).
- Enabled pretty-printing of variables in gdb (see below)
IDE:
- Better C++ debugging experience: std::string, std::vector, std::map and
other standard classes as well as simtime_t are now displayed in a
meaningful way; simulation objects (cObject) display their full paths.
This functionality is enabled by gdb pretty printer extensions written
in Python, and is thus available for command-line gdb debugging too.
For activating the pretty printers, see misc/gdb/README.
- NED documentation generator improvements: better-looking tables in the
generated documentation; running Doxygen is now cancellable; etc.
- Dropped PowerPC support for the IDE because Mac OS X 10.7 no longer
supports this architecture.
Sim:
- Refactored operator= and copy constructor in all classes. Now they
delegate to the same function in the super class, and the common
part of the two is factored out to private copy() functions.
- Fixed all warnings to make it compile using -Wall -Werror.
- Coroutines used for 'activities' are now implemented using the
swapcontext() POSIX call (if it is available on the system).
Sample simulations:
- Database example revived. It demonstrates using database as configuration
source, as storage for output scalars and vectors, and as source of
network topology. Currently it works with MySQL.
Countless bug fixes and smaller improvements.
OMNeT++ 4.2rc1 (Aug 2011)
-------------------------
Ini files:
- Ini files: iterations (${...}) can now refer to other iteration variables,
using the dollar or the dollar-brace syntax ($var or ${var}). This
improvement makes it possible to have loops where the inner iteration range
depends on the outer one. When needed, the default top-down nesting order
of iteration loops is modified (loops are reordered) to ensure that
expressions only refer to more outer loop variables, but not to inner ones.
When this is not possible, an error is generated with the "circular
dependency" message. Variables are substituted textually, and the text
resulting from substitution is NOT evaluated except in the '<from>..<to>
step <step>' syntax, and in the 'constraint=' ini file option. CAUTION:
textual substitution means that variables in arithmetic expressions should
be protected with parentheses. The text substitution model was chosen for
greater flexibility as well as the ability to produce a more consistent
semantics. See src/envir/ChangeLog for more details.
- Incompatible change: In the constraint= configuration option, variables now
MUST be referenced with the dollar sign ($foo or ${foo} syntax), and also
be surrounded with parens (to ensure precedence after the textual variable
substitution). For example, the expression x+y<10 must be changed to
$x+$y<10, or for greater safety, to ($x)+($y)<10.
- Parallel iteration: it is now supported to use named iteration
variables and parallel iteration together (${foo=...!bar} syntax.)
This was not supported previously.
- Some iteration-related error messages have been improved to provide
more context.
Sim:
- Result filter/recorder interfaces and registration macros made public
(moved to src/sim), so that users can contribute their own result filters
and recorders. Files: cresultlistener.h, cresultfilter.h cresultrecorder.h.
Result filters have to be subclassed from cResultFilter or the more specific
cNumericResultFilter or cObjectResultFilter base classes and registered with
the Register_ResultFilter() macro; result recorders have to be subclassed
from cResultRecorder or the more specific cNumericResultRecorder, and
registered with the Register_ResultRecorder() macro. After that, the new
filter or recorder can be used in the source= and record= attributes of
@statistic, and with the **.result-recording-modes configuration option.
- The Define_Function() macros have been renamed to Define_NED_Math_Function().
For backwards compatibility, the old macro definitions remain, but issue
a deprecation warning. Note that the preferred way of defining new NED
functions is now the Define_NED_Function() macro.
- The API for custom NED functions defined via Define_NED_Function() has been
changed. cDynamicExpression::Value (the old value class) has been factored
out to a new cNEDValue class. Data members are no longer public, they can
be manipulated via various methods. NOTE: This change is NOT backwards
compatible: user-supplied NED functions will need to be revised.
Look at src/sim/nedfunctions.cc for code examples.
- Measurement unit support: added "mps" (m/s) and "kmph" (km/h) as recognized
units; changed "Kbps" to the more standard "kbps"; changed byte multiples
notation to use the now-standard IEC binary prefixes: KB -> KiB,
MB -> MiB, GB -> GiB, TB -> TiB. The latter changes affect backwards
compatibility, i.e. you may need to update existing models.
Tools:
- opp_run: bugfix: release-mode simulation models compiled as shared libraries
could not be run using a debug-mode opp_run program (they either crashed
or reported that a module was not registered with the Register_Module()
macro.) As part of the fix, a new opp_run_release program has been
introduced, and opp_run (which is now always compiled as debug) delegates
to it when necessary.
Due to makefile changes related to the fix, you may need to re-create the
makefiles of your simulation when upgrading to OMNeT++ 4.2. (You only need
to do that when working on the command line. The IDE automatically recreates
the makefiles, so no action is needed on your part if you are using only the
IDE.) See src/envir/ChangeLog for details of this change.
- Implemented number filter expressions using multiple inputs for statistics source
expressions. For example:
@statistic[dropRate](source="count(packetDropped)/count(packetSent)");
- opp_msgc: improvement: announcements and type definitions now observe
whether they are above the namespace declaration (=outside the namespace)
or below it (=inside the namespace). This change makes it consistent with
cplusplus blocks that had this behavior for quite some time. A related
improvement is that type lookup in namespaces has been modified to make it
possible to use unqualified names when declaring fields. See
src/nedxml/ChangeLog for details.
- Akaroa support improved; samples/aloha/akaroa.ini was added as example
Documentation:
- Several chapters in the User Manual have been updated; especially, the
Message Definitions section was turned into a separate chapter, and
was completely revised.
IDE:
- Upgraded to Eclipse 3.7
- Added Eclipse Marketplace to the Help menu. You can now install
additional features from the market.
- Before running the simulations, the IDE will show the command line in
the console view to help you execute the same simulation from the
command line.
- Ctrl-Tab now works on freshly opened NED files even if you do not explicitly
select a simple module. In that case, the IDE opens the .h and .cc files
associated with the first simple module in the NED file.
- Improvement on the Manage Build Configurations dialog: newly created build
configurations are now configured, by copying the source entries from one
of the existing build configurations.
- Project Makemake Options property page: overhaul for better usability.
- Documentation generator: turn on JAVADOC_AUTOBRIEF in newly generated
doxy.cfg files. (When this option is on, there is no need for @brief
in C++ doxy comments; instead the first sentence of the comment is taken
automatically as brief description.)
- Bug fixes on: IDE makefile generator; the Project Features feature;
the Inifile Editor (hover info, content assist, etc); the NED editor
(display string proposals for connections and channels, etc.); Organize
Imports feature; NED documentation generator; Simulation Launcher (e.g.
launching folders with simulations in them works again);
- SVN support removed from the IDE. It had very few users, and can be
installed from the Market if needed.
- Removed Animation Player as it was only a "technology preview" bundled
with the beta releases to gather feedback from the user community. The
animator is scheduled to appear in the next major OMNeT++ release.
OMNeT++ 4.2b2 (May 2011)
------------------------
Most important feature: "Project Features" (see below).
NED:
- Added support for conditional submodules. Syntax:
udp: UDP if needsUDP {...}
tcp: <tcpType> like ITCP if needsTCP {...}
- Added the xml() NED function, which accepts a string argument and parses
it as XML. Its most notable use is eliminating "empty.xml" files from INET:
one can use xml("<root/>") in NED files instead.
- Implemented default value for parametric submodule and channel types.
NED now supports the following syntax:
mobility: <default("NullMobility")> like IMobility;
The effect is that the NullMobility NED type will be used for the mobility
submodule if the type name is not specified otherwise, e.g. in the config-
uration with something like
**.mobility.type-name = "ConstSpeedMobility"
- Added the firstAvailable() NED function, which is helpful with the Project
Features feature (see below). It accepts any number of strings (see new
varargs support for NED functions), interprets them as NED type names
(either short names or fully qualified names), and returns the first one
that exists and is also "available" (its C++ implementation class exists).
Example usage:
tcp: <default(firstAvailable("TCP_lwIP", "TCP_NSC", "TCP"))> {..}
It chooses the TCP_lwIP, TCP_NSC or TCP module type for the tcp submodule,
in this order, unless the type is explicitly defined to be something else
in the configuration.
- Parametric submodule type can now also be specified in NED files, using
patterns that end in the new "typename" keyword. An example:
network Net {
parameters:
host[*].tcp.typename = "TCP_lwIP";
...
}
Ini files:
- The "type-name" per-object configuration option (**.typename=) has been
renamed in to "typename", for consistency with the similar new NED feature.
Sim:
- Implemented varargs support for NED functions. If the signature (see
Define_NED_Function() and Define_NED_Function2() macros) ends in ", ...",
then the function will accept any number of additional arguments of any type.
At runtime, the implementation has access to both the actual number and
types of args. When passing extra args, optional arguments (those marked
with '?' in the signature) must all be present, i.e. varargs can only come
when all typed args are there.
IDE:
- Upgraded to Eclipse 3.6.2
- Implemented the "Project Features" feature, which makes it possible to
disable unused parts ("features") of a project to reduce compilation time
and complexity. It has been invented to help INET Framework users and
developers deal with the growing size of the framework. Features are
described in the project's .oppfeatures file, authored by INET developers.
Users can activate/deactivate features in the Project Features page of
the Project Properties dialog (this page is directly accessible from the
Project menu and from the Build Configurations submenu of the project's
context menu in Project Explorer). Features map to NED packages and C++
source folders; disabling a feature maps to NED package exclusion, and
folder exclusion in CDT (C++ Development) configuration. Features can also
define C/C++ symbols (for #ifdefs), and extra libraries to link with.
At build time, the IDE checks the project's configuration (NED, CDT) and
if it is inconsistent with the selected features, it offers fixing it.
Features can also be used from the command line by exporting Makefiles
(or opp_makemake commands) that reflect a particular enablement of features.
- Support for excluding (disabling) NED packages. This feature is needed for
the Project Features feature. Exclusions can be edited on the NED Source
Folders project property page, and are saved into the project's .nedfolders
file.
IDE/Animation Player:
- Implemented lazy loading of the eventlog file: the tool can now animate
large eventlog files with acceptable performance.
- Animation effects refined, e.g. packet transmission on a datarate channel.
- Heavy bugfixing. Note that the tool is still being actively developed, and
it is generally not yet ready for everyday use.
IDE/Inifile Editor:
- Usability: the editor now comes up with the page (text or form) that was
used last time, and not always with the form editor. (When you flip the
editor to the other page, the page type is stored in the preferences.
When an editor is opened, the setting is read from the preferences and
the corresponding page is activated.)
- Improved text hover (F2) and hyperlink (Ctrl+click) support: the editor
can now show information and go to the definition of modules that occur
in the inifile key. For example, for a **.host[*].tcp.sackSupport = true
line, the user can hover over (or Ctrl+click) the host[*] part, and the
editor will show relevant information and go to the definition of the
host[] submodule vector in the NED network description.
- Improved content assist: per-object configuration options are now filtered
by the type of object that the key refers to; for example, if you type
**.ppp[*].txPkBytes.<Ctrl+Space>, the editor will know from the NED files
that txPkBytes is a statistic, and offer completions accordingly.
- Content assist: different types of completions (modules, parameters,
statistics, configuration options, etc) are now marked with icons.
- Markers on included inifiles are now removed when the main inifile is
closed. (Fix for #176)
- Added the Copy action to the Module Parameters view context menu: you can
now select the key for an unassigned parameter in the view, and copy/paste
it into the editor area.
IDE/Wizards:
- New Tictoc Example and New Source-Sink Example wizards: fix: the root
Makefile executed opp_makemake in the src/ folder at each build,
overwriting the IDE-generated Makefile.
- New OMNeT++ Project wizard template: now it is possible to set "custom make"
for a folder: specify <foldername>:CUSTOM in the makemakeOptions= template
variable in template.properties. Use "." to name the project root folder.
Example: makemakeOptions = .: CUSTOM, src: --deep -meta:recurse...
- New option for template.properties: preRunTemplate=<fti-file-name>. Example:
preRunTemplate = main.fti. The option causes the given template file to be
evaluated for its side effects, just after the user hits Finish but before
any file is copied or template is evaluated. It is not allowed to produce
text output, but the variables it sets will be substituted into other
template.properties variables, and will also be available in other template
files. (Note: all other templates are run in isolation, and cannot change
variables for other templates!) The preRunTemplate option is the only way
to programmatically set the value of makemakeOptions and similar
template.properties options.
IDE/Graphical Editor:
- Switched back double-click behavior to Open NED Type action. The Properties
dialog can now opened with Ctrl+Enter (Alt+Enter was unavailable.)
IDE/Sequence Chart and Event Log:
- Added show/hide options for arrows that represent mixed dependencies.
(Such arrows are drawn when the sequence chart is filtered, and represent
e.g. a sequence of message sendings and self-messages)
- Eventlog: enhanced performance of event tracing filter
- Simulations now record the termination message and result code into the
eventlog file
- Note: eventlog file format has changed (in order to better serve the
Animation Tool) -- .elog files recorded with any prior version of OMNeT++
have to be re-recorded.
Many bug fixes, mostly in the IDE; you can see the detailed list at:
http://tinyurl.com/omnetpp42b2-fixes
OMNeT++ 4.2b1 (Feb 2011)
------------------------
Partial list of changes since 4.1 (see ChangeLog files in individual folders
for a more complete list):
Simulation runtime:
- Removed #include <winsock.h> from <platdep/timeutil.h>; the reason
is that it conflicted with lwIP code recently integrated into INET.
<platdep/sockets.h> still includes <winsock.h>, but now
<platdep/sockets.h> (and <platdep/timeutil.h>) MUST precede <omnetpp.h>
in all source files.
- Ini files: implemented multiple inheritance for sections. Syntax:
[Config Foobar]
extends = Foo, Bar
When the runtime looks for a config option or param assignment, sections
are examined in a "fallback order" until the first match is found. In the
above example the order would be: Foobar, Foo, Bar, General.
OMNeT++ uses C3 linearization to compute the section fallback order,
see e.g. http://en.wikipedia.org/wiki/C3_linearization
- Ini files: better parsing for iteration variables, e.g. the value in
${x=uniform(1,2)} is now parsed as one item, not as "uniform(1" and "2)".
Nested parens/brackets/braces and string literals are recognized;
escaping commas and close-braces is now possible using backslash.
- NED: fixed deep parameter assignments: parameter references were
interpreted in the wrong context. Deep parameter assignments are when
an inifile-like pattern is used to name the parameter(s) to be set, as in:
network Inet {
parameters:
host[*].tcp.nagleEnabled = true;
...
}
- Resolved spurious errors: 'Class "..." not found -- perhaps its code
was not linked in, or the class wasn't registered with Register_Class()'
Added a check to ensure that the debug and the release versions of
the simulation library are not loaded at the same time. This problem
occurred when a model was built as 'release' and the debug version of
'opp_run' was used to start it. As a result, the simulation seemingly
started but complained about missing classes.
- Fix: Some classes were thrown out by the linker if OMNeT++ was statically
built, and the simulation was complaining at runtime about the missing
cCompoundModule class.
- Eventlog recording: .elog file format change: message creations and
duplications (cloning) are now recorded; MC (ModuleCreated) entries now
precede GC (GateCreated) entries. IMPORTANT: The sequence chart in the
IDE will only work on .elog files in the new format, existing event logs
need to be re-recorded!
IDE/Animation Player:
- This is a new component in the IDE, you can access it by right-clicking
an .elog file and selecting "Open With / OMNeT++ Animation Player" from
the context menu. This is a preliminary implementation (Technology
Preview) not yet optimized for large files, the practical maximum file
size it can handle is about 10MB.
IDE/C++ Development:
- Added a new "Clean Local" item to the project's context menu that does
not clean referenced projects. This resolves the problem that CDT's
"Clean Project" command also cleans the referenced projects, e.g. if
you have a Foo project that depends on INET, cleaning Foo also cleans
INET which takes a long time to recompile. Now you can use the
"Clean Local" command to clean Foo only.
- Added new "OMNeT++ Code Formatter" profile. This coding convention follows
the rules used in the OMNeT++ kernel and the INET Framework. (No tabs, etc.)
- Added MachO64 binary parsers and error parsers. This makes it possible to
debug a 64-bit executable on Mac OS X 10.6
- Linux only: Added support for profiling with Valgrind. To activate this
feature, select "Profile as... / OMNeT++ Simulation" from the Project
Explorer context menu. This feature requires Valgrind to be installed
on your system. (Note: the main IDE toolbar does not show a Profile button
next to the Run and Debug buttons at this time, but profiling is still
available via the Project Explorer context menu.)
- The Makemake page in Project Properties can now fix the "Source Folders
differ across configurations" problem in the project setup, which usually
occurs when you add a build configuration to an existing project later.
The dialog now displays a "Fix it" link.
IDE/Graphical Editor:
- Several performance optimizations for the NED Editor. It can open much larger
files than before. NED validation is done now in a background thread and
does not block the UI.
- Select 'NED Type Selection' dialog now works correctly on first open. It
shows the defining projects for the types.
- Enhanced drag and drop capabilities in NED Graphical Editor. You can
drop NED types into a compound module either to create submodules
(if you drop it into the submodule area), or to turn it into
an inner type (if you drop on the title of the compound module).
- The Graphical Editor now displays the file's package name at the top.
- Graphical Editor displays self-connections as arcs in the module's upper
right corner.
- The resize/move feedback figures have been changed from a simple outline
to translucent blue.
- Added a 'Properties' dialog that can edit one or several objects
at a time, and allows you to change graphical and type information.
It also has a preview panel.
- Enhanced editing of type fields in the 'Property View'. The editor correctly
enumerates the possible choices and adds an import statement if necessary.
- 'Open Type' and 'Open Supertype' have been reassigned to the F3 function key.
Double-click now opens the 'Properties' dialog.
- The IDE now uses the use native (C++) layouter code for placing unpinned
submodules, which means better performance and consistency with the
simulation runtime (Tkenv).
IDE/Inifile Editor:
- Support for inifile improvements in this release, namely multiple section
inheritance and better parsing for iteration variables
- Performance improvements: inifile is now analyzed in the background so that
it does not block the UI, and features that need its results (hover text,
content assist, etc) have a timeout how long they are willing to wait for it
(see bug #132 for details). It is now also possible to disable inifile
analysis. Further performance and UI responsiveness improvements are planned.
IDE/Sequence Chart:
- Added 'Go to Simulation Time' and 'Go to Event Number' in the context menu.
- 'Go to Simulation Time' in the 'Event Log' view now supports relative values.
- The Sequence Chart tool now knows about message creations and duplications
(cloning), and as a result, in certain situations it is now able to better
identify relationships between events and draw a better sequence chart.
NOTE: Due to changes in the .elog file format, the tool will only work with
newly recorded files. Existing event logs need to be re-recorded!
IDE/Launcher:
- The command-line for launching the simulation now uses relative paths instead
of absolute ones. This makes the starting command-line easier to understand.
IDE/Documentation Generator:
- Added tilde notation as an alternative to automatic hyperlinking of module
names in comments. The latter was often too aggressive (e.g. linking to the
IP module in the phrase "IP address" is wrong). Automatic hyperlinking can
now be turned off in the generator, and then the user is expected to mark
words to be hyperlinked with a tilde: "the ~IP module". The INET Framework
has already been converted to use the tilde notation.
- Added Javascript to autoload frameset page if a content page is opened by
itself. This is useful when URLs to specific content pages are posted on
the mailing list or sent over email.
- Implemented @include in NED comments. Lines in the included file don't have
to start with "//", but otherwise they are processed exactly as NED comment
text.
- Fix: External pages (@externalpage) now appear under the "Selected Topics"
node of the navigation tree in the generated documentation.
- Several minor fixes: recognize the <u> (underline) HTML tag; sanitize the
file names for @page; added/refined test cases
Tkenv:
- Parallel simulation: Placeholder modules are now displayed with a semi-
transparent icon (or if it's a rectangle or oval, with dotted border).
- Fix (bug #248): compute coordinates (and sizes) in double and not int;
necessary if background scaling (bgs display string tag) is set up.
- Better choice of default user interface font, especially on Linux.
- The generic UI font and the font used in graphics are now configurable
in the Simulation Options dialog.
- The default font for log text is now proportional (same as the generic UI
font), for better readability and space efficiency. It can be customized
(switched back to a monospace font, etc) in the Simulation Options dialog.
- Minor: menu items have been changed to title case
- Tcl errors are now logged into .tkenvlog instead of dumping them on stdout.
Misc:
- Added -g option to 'scavetool scalar' command. You can specify how the
scalars are grouped into columns/variables.
- The build system can now build large projects on windows. The 32K command-line
limitation has been resolved.
- Updated base system to Eclipse 3.6.1
- Added a detailed IDE change log file doc/IDE-Changes
Several bugs have been fixed; you can see the detailed list at:
http://tinyurl.com/omnetpp42b1-fixes
OMNeT++ 4.1.1 (August 2023)
---------------------------
This is a modernized version of omnetpp-4.1 that makes it possible to build
and use the now 13-year-old package in today's software environments. The
primary objective of this release is to facilitate the execution of old
simulation models, e.g. for reproducing simulation results or as a basis of
porting them to more recent versions of OMNeT++.
Changes:
- Source code updated for C++11 compatibility, and to eliminate warnings
issued by modern C++ compilers. Backported several smaller fixes.
- Adjusted to make the code compatible with more recent versions of Tcl/Tk
libraries. In addition to the original Tcl/Tk-8.4 and BLT-2.4z, Tkenv now
works with Tcl/Tk-8.6 and BLT-2.5.3, too.
- Updated to compile with both Bison 2.3 and 3.0.
- Backported the setcontext()/switchcontext() based coroutine library from
omnetpp-4.2, to make activity() modules work again. (The original "portable
coroutines" library which used setjmp()/longjmp() to switch stacks no longer
works with recent glibc versions.)
- Updated the 'setenv' and 'configure' scripts, to make them more consistent
with those in more recent or modernized releases. This includes:
1. 'configure' now mandates having 'setenv' sourced before it runs.
2. 'setenv' now sets OMNETPP_IMAGE_PATH, in order to prevent model
frameworks from accidentally making omnetpp's bundled icons unaccessible
from Tkenv by simply appending to OMNETPP_IMAGE_PATH.
3. 'configure' now creates 'configure.user' from 'configure.user.dist'