From 58346a2082422113d81c727c04802f11f248dff7 Mon Sep 17 00:00:00 2001 From: Tom Henderson Date: Wed, 5 Mar 2025 21:00:31 -0800 Subject: [PATCH] doc: Update AUTHORS, CHANGES.md, and RELEASE_NOTES for ns-3.44 --- AUTHORS | 7 +++++++ CHANGES.md | 18 +++++++++++++----- RELEASE_NOTES.md | 22 ++++++++++++++++------ 3 files changed, 36 insertions(+), 11 deletions(-) diff --git a/AUTHORS b/AUTHORS index 9174cbda9..98a8dc796 100644 --- a/AUTHORS +++ b/AUTHORS @@ -25,6 +25,7 @@ Nicola Baldo (nbaldo@cttc.es) Mirko Banchi (mk.banchi@gmail.com) Peter D. Barnes, Jr. (barnes26@llnl.gov) Ramon Bauza (monbauza@gmail.com) +Martin Belanger (martin.belanger@dell.com) Pedro Bellotti (pedro177@gmail.com) Mehdi Benamor (mehdi.benamor@telecom-bretagne.eu) Apoorva Bhargava (apoorvabhargava13@gmail.com) @@ -48,6 +49,7 @@ Jonathan Brugge (j.d.brugge@student.utwente.nl) Junling Bu (linlinjavaer@gmail.com) Elena Buchatskaia (borovkovaes@iitp.ru) Alessio Bugetti (alessiobugetti98@gmail.com) +Anna-Birgitta Burmeister (anna-birgitta.burmeister@student.hpi.de) Nuno Cardoso (nunopcardoso@gmail.com) Gustavo Carneiro (gjc@inescporto.pt, gjcarneiro@gmail.com) Scott Carpenter (scarpen@ncsu.edu) @@ -71,6 +73,7 @@ Salva Climent (jocliba@gmail.com) Luis Cortes (cortes@gatech.edu) Luca Costantino (luca.costantino@gmail.com) Matthieu Coudron (matthieu.coudron@lip6.fr) +Michael R. Davis (mrdvt92@yahoo.com) Alexander D'souza (moijes12@gmail.com) Ankit Deepak (adadeepak8@gmail.com) Christophe Delahaye (christophe.delahaye@orange.com) @@ -152,6 +155,7 @@ Kakadus1 (j.dittrich2303@gmail.com) Evgeny Kalishenko (ydginster@gmail.com) Raghuram Kannan (raghuramkannan40@gmail.com) Vignesh Kannan (vignesh2496@gmail.com) +Nihar Kapasi (niharkkapasi@gmail.com) Ouassim Karrakchou (okarr102@uottawa.ca) Tanmay Kathpalia (tanmay.kathpalia@landisgyr.com) Konstantinos Katsaros (dinos.katsaros@gmail.com) @@ -161,10 +165,12 @@ Nakayama Kenjiro (nakayamakenjiro@gmail.com) Morteza Kheirkhah (m.kheirkhah@sussex.ac.uk) Jörg Christian Kirchhof (christian.kirchhof@rwth-aachen.de) Ohad Klausner +Yohei Kojima (yk@y-koj.net) Wojtek Kosior (koszko@koszko.org) Katarina Koutlia (katerina.koutlia@cttc.es) Shravya Ks (shravya.ks0@gmail.com) Flavio Kubota (flaviokubota@gmail.com) +Puneet Kumar (puneet23067@iiitd.ac.in) Manish Kumar B.(bmanish15597@gmail.com) Joe Kopena (tjkopena@cs.drexel.edu) Christopher Kosecki (christopher.l.kosecki.ctr@mail.mil) @@ -300,6 +306,7 @@ Michael Scoggin (mpscogg@sandia.gov) Surya Seetharaman (suryaseetharaman.9@gmail.com) Guillaume Seguin (guillaume.seguin@inria.fr) Ioannis Selinis (selinis.g@gmail.com) +Yifan Fan Seu (yifan.fan.seu@gmail.com) Tomasz Seweryn (tomasz.seweryn7@gmail.com) Dmitrii Shakshin (d.shakshin@gmail.com) Kulin Shah (m.kulin@gmail.com) diff --git a/CHANGES.md b/CHANGES.md index 6c04e650e..4c2f63978 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -12,16 +12,16 @@ Note that users who upgrade the simulator across versions, or who work directly This file is a best-effort approach to solving this issue; we will do our best but can guarantee that there will be things that fall through the cracks, unfortunately. If you, as a user, can suggest improvements to this file based on your experience, please contribute a patch or drop us a note on ns-developers mailing list. -## Changes from ns-3.43 to ns-3-dev +## Changes from ns-3.43 to ns-3.44 ### New API +* (antenna) Add `SymmetricAdjacencyMatrix` utility class, used to track the necessity of channel update between every `PhasedArrayModel` pair. * (applications) Added two new base classes for source and sink applications, `SourceApplication` and `SinkApplication`, respectively. -* (wifi) Changes have been made to the `WifiRemoteStationManager` interface for what concerns the update of the frame retry count of the MPDUs and the decision of dropping MPDUs (possibly based on the max retry limit). The `NeedRetransmission` method has been replaced by the `GetMpdusToDropOnTxFailure` method and the `DoNeedRetransmission` method has been replaced by the `DoGetMpdusToDropOnTxFailure` method. Also, the `DoIncrementRetryCountOnTxFailure` method has been added to implement custom policies for the update of the frame retry count of MPDUs upon transmission failure. * (applications) Added an `OnOffState` trace source to `OnOffApplication`, to track whether the application is transmitting or not. -* (zigbee) Added Zigbee module support. The module includes a NWK layer with joining and routing capabilities. No APS layer included. -* (antenna) Add `SymmetricAdjacencyMatrix` utility class, used to track the necessity of channel state between every `PhasedArrayModel` pair. * (wifi) Added a new **RobustAVStreamingSupported** attribute to `WifiMac` to enable 802.11aa features (GCR). +* (wifi) Changes have been made to the `WifiRemoteStationManager` interface for what concerns the update of the frame retry count of the MPDUs and the decision of dropping MPDUs (possibly based on the max retry limit). The `NeedRetransmission` method has been replaced by the `GetMpdusToDropOnTxFailure` method and the `DoNeedRetransmission` method has been replaced by the `DoGetMpdusToDropOnTxFailure` method. Also, the `DoIncrementRetryCountOnTxFailure` method has been added to implement custom policies for the update of the frame retry count of MPDUs upon transmission failure. +* (zigbee) Added Zigbee module support. The module includes a NWK layer with joining and routing capabilities. No APS layer included. ### Changes to existing API @@ -38,9 +38,17 @@ This file is a best-effort approach to solving this issue; we will do our best b ### Changes to build system +* !2319 Add support for clang-tidy-19 +* !2251 Add msbuild and Visual Studio generator support to the ns3 script +* !2251 Use ccache with ClangCL/MSVC +* !2251 Provide option to generate export header from build_lib +* !2260 Scan for modules in the external contrib directory ../ns-3-external-contrib +* !2255 Exclude external imported targets from missing libraries check +* !2238 Prevent Python bindings from being enabled along with MPI + ### Changed behavior -* (lr-wpan) Association: Fix the handling of situations where the association response commands arrives before the data request command acknowledgment that is supposed to precede it. +* (lr-wpan) !2334 Association: Fix the handling of situations where the association response commands arrives before the data request command acknowledgment that is supposed to precede it. ## Changes from ns-3.42 to ns-3.43 diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md index e249ba0f9..8dbdec3f1 100644 --- a/RELEASE_NOTES.md +++ b/RELEASE_NOTES.md @@ -12,7 +12,7 @@ a [GitLab.com issue tracker](https://gitlab.com/nsnam/ns-3-dev/-/issues) number, and references prefixed by '!' refer to a [GitLab.com merge request](https://gitlab.com/nsnam/ns-3-dev/-/merge_requests) number. -## Release 3-dev +## Release 3.44 ### Supported platforms @@ -28,7 +28,11 @@ requirements (Note: not all ns-3 features are available on all systems): Python API requires [Cppyy](https://cppyy.readthedocs.io/en/latest/installation.html) and has only been tested on Linux. As of this release, the latest known version to work with ns-3 is cppyy==3.1.2. -The required Doxygen version for documentation generation is version 1.11. +The required Doxygen version for documentation generation is now version 1.11. + +Doxygen tags are now required to use the '@' rather than the '\' character. + +The minimum clang-format version is version 15. ### New user-visible features @@ -36,33 +40,39 @@ The required Doxygen version for documentation generation is version 1.11. - (applications) - The `ThreeGppHttpServer::LocalAddress` and `ThreeGppHttpServer::LocalPort` attributes have been renamed to `ThreeGppHttpServer::Remote` and `ThreeGppHttpServer::Port`, respectively. - (applications) - It is now possible to specify the address on which to bind the listening socket for UdpServer via the `Local` attribute. - (applications) - It is now possible to specify a port only for PacketSink to listen to any address (both IPv4 and IPv6). +- (build) Scan for contrib modules in `ns-3-external-contrib` directory, at the same level of the ns-3 directory (e.g. `./ns-3-dev/../ns-3-external-contrib/`). +- (energy) Added new information and reformatted energy module documentation. - (wifi) - Added a `WifiDefaultProtectionManager::SkipMuRtsBeforeBsrp` attribute to avoid using MU-RTS to protect the transmission of a BSRP Trigger Frame. If this attribute is set to true (which is the default value), BSRP Trigger Frames can be used as Initial Control Frames for EMLSR clients - (wifi) Each MSDU, A-MSDU or management MPDU now has its individual frame retry count and each Txop/QosTxop has its own SRC (Station Retry Count) to match the standard specifications. - (wifi) The `MaxSsrc` and `MaxSlrc` attributes of the `WifiRemoteStationManager` have been obsoleted and replaced by the `FrameRetryLimit` attribute of the `WifiMac`. - (wifi) Added the `IncrementRetryCountUnderBa` attribute to the `WifiRemoteStationManager` to choose whether or not to increase the retry count of frames that are part of a block ack agreement; this attribute defaults to false to match the standard specifications. - (wifi) Added a new `BaEstablished` trace source to `QosTxop` to notify that a block ack agreement has been established with a given recipient for a given TID. -- (zigbee) Added Zigbee module support. -- (energy) Added new information and reformatted energy module documentation. - (wifi) Added a new `MainPhySwitch` trace source to EmlsrManager, which is fired when the main PHY switches channel to operate on another link and provides information about the reason for starting the switch. -- (build) Scan for contrib modules in `ns-3-external-contrib` directory, at the same level of the ns-3 directory (e.g. `./ns-3-dev/../ns-3-external-contrib/`). - (wifi) Add support for exchanging 802.11be Multi-Link Probe Request frames. Currently, the default association manager does not instruct the MAC to transmit a Multi-Link Probe Request frame, though. - (wifi) 2004! - Add Wi-Fi channel occupancy statistics helper - (wifi) 2009! - Added WifiTxStatsHelper for Wi-Fi MAC-level tracing. - (wifi) - Added support for 802.11aa groupcast with retries (GCR). Both unsolicited retries (GCR-UR) and Block Ack (GCR-BA) mechanisms are implemented. +- (zigbee) Added a new Zigbee module. ### Bugs fixed +- (core) - Fix the command-line handling of default values containing a space +- (examples) - Fix incorrect energy calculation in wifi power adaptation examples +- (internet) #1109 - Add support for multiple hardware types in ArpHeader +- (internet) #1177 - check for 0-TTL before trying to decrement - (lr-wpan) !2334 - Fix the MAC reaction to an association issue in which association response commands might be received before data request command acks. - (propagation) Scale the NTN LOS probabilities from percentages [0, 100] to probabilities [0, 1] +- (propagation) !2352 - Fix Okumura Hata propagation loss model for open areas environment - (spectrum) Calculate PSD by combining received power on ports, even when no precoding matrix is set - (spectrum) Scale the CDS parameter of V2V models to nanoseconds - (spectrum) Add missing K-factor fields (uk, sigK) for NTN NLOS 3GPP channel model +- (spectrum) Trigger 3GPP channel updates after changes to antenna attributes - (wifi) Retransmit procedures have been aligned with the standard specifications. - (wifi) Clear PSDU map if no immediate response expected with BAR-BA ack sequence - (wifi) Fix S-MPDU TX duration computation with BlockAck ack policy - (wifi) Fix missing DSSS Param Set in Probe Request sent over 2.4 GHz links -- (spectrum) Trigger 3GPP channel updates after changes to antenna attributes - (wifi) #1104 - Fix wrong calculation of start sequence number +- (wifi) Ensure AckedMpdu trace is fired before the MPDU is dequeued ## Release 3.43