EURANE logo; Enhanced UMTS Radio Access Network Extentions for ns-2

Description of EURANE

EURANE for ns-2, developed within the European Commission 5th framework project SEACORN, comprises of an additional three nodes, namely the Radio Network Controller (RNC), Basestation (BS) and the User Equipment (UE), whose functionality allow for the support of the following transport channels:

The main functionality additions to ns-2 come in the form of the RLC Acknowledged Mode (AM), Unacknowledged Mode (UM), MAC-d/-c/sh support for RACH/FACH and DCH, and MAC-hs support for HS-DSCH, i.e. HSDPA.

Note: EURANE was developed as a single cell environment, thus handover functionality is not included. A multiple cell extension, and upgrade, to EURANE has however been made available by Abdulmohsen M. Mutairi, and can be downloaded here. This extension provides for multiple cells with handover, additional flow control algorithms, and an integration of the physical layer aspects into the simulation, rather than in pre-processing. Please note that this extension is offered 'as is' and WMC is in no way responsible for any outcome resulting from its use. As such, WMC also offers no support for the extension, and questions should be addressed to the creator, whose address is contained within the zipped archive.

License for EURANE

All these files for EURANE are licensed under this license. Ericsson Telecommunicatie B.V. has copyrights to this source-code.

Contributors to EURANE

EURANE tips

If you have problems installing or running EURANE, please look at our EURANE Tips page.

Download EURANE files:

file description

Patch for clean ns-2.30:
ns-2.30_eurane-1.12.diff.gz

 EURANE Patchfile for ns-2.30. Apply this file to the clean distribution of ns-2.30.
  • 10-oct-2006: Abdulmohsen Mutairi provided an updated patch for ns-2 version ns-2.30.

Patch for clean ns-2.28:
ns-eurane-111.diff.gz
ns-2.28-gcc4-fix.diff

 EURANE Patchfile for ns-2.28. Apply this file to the clean distribution of ns-2.28.
  • 13-mar-2006: supplied a fix to be able to compile ns-2.28 using gcc 4.0.x. (as found in Mandriva 2006.0) This is independent of eurane, so it should not interface with the eurane patch. to apply, go to ns-allinone-2.28 and run:
    patch -p1 < ns-2.28-gcc4-fix.diff
  • 28-oct-2005: (1.11) Fixed bugs in UM support for DCH and HS-DSCH, and bug in the reordering algorithm for HS-DSCH.
  • 22-sep-2005: (1.10) Fixed quite a few bugs, moved to version ns-2.28
    Bugfixes:
    - Fixes RLC Win/Credit allocation bug (function remove_credit_allocation in hsdpalink.cc)
    - Fixed two timer scheduling errors in am-hs.cc (sched->resched)
    - Changed default setting of maxRBSize_ in nsdefault.tcl to set it to bytes, not bits

Upgrade Patch for eurane 1.10 to 1.11 (ns-2.28):
upgr110-111

 Apply this file to the correct version of eurane on ns-2.28.

Patch for clean ns-2.26:
ns-eurane-109.diff.gz

Patch to upgrade previous version of eurane:
upgrade from 1.08 to 1.09

 EURANE Patchfile for ns-2.26. Apply this file to the clean distribution of ns-2.26.
  • 22-sep-2005: As of now, Eurane for ns-2.26 will not be updated anymore, if you need it, try fixing the bugs using the patch for ns-2.28
  • 3-dec-2004: (1.09) Fixed a bug in hsdpalink.cc (found by Christian Glomb)
  • 3-dec-2004: added some extensions to the contributors page
  • 11-oct-2004: de-confused the links on the left...
  • 3-august-2004: (1.08) Neill fixed another bug
  • 2-july-2004: (1.07) fixed a bug with calculation of throughput
  • 11-may-2004: (1.06b) fixed version file mismatch
  • 4-may-2004: (1.06) improved readability of out.tr, some changes in scheduling based on CQI in version 1.06
  • 18-mar-2004: (1.05) quite a few bugfixes and more sane defaults in 1.05. Removed previous versions and sub-patches. (lack of time)
  • 27-feb-2004: fixed some bugs in the reordering (transmittor behaviour). A HARQ-process is now actually re-used when it should be.
  • 6-feb-2004: some major bugs were found, version 1.02b fixes those
  • 3-feb-2004: fixed puts comments in ns-lib.tcl
  • 1-feb-2004: fixed problem in ns-default.tcl
test_tcp.tcl
test_udp_dch.tcl
test_udp_hsdsch.tcl
idealtrace		 Testscripts to test if the installation works correctly. Also a sample idealtrace to use with the testscripts. In the FAQ is a hint on how to make your own idealtrace files...

MatLab/Octave scripts for generating input trace files
OctavePreprocess.tar.gz MatlabPreprocess-jan05.tar.gz
MatlabPreprocess-feb04.tar.gz

Oct 9, 2006: added Octave scripts to generate the input trace files, so the requirement for an expensive Matlab license is now gone!

Matlab scripts to generate input trace files. Changed in January 2005.

Changed the SNR restransmission formula using maximum ratio combining. (suggested by Remco Litjens)

Datafiles for the Eurane Simulator
SNRBLERMatrix.gz (120kB) Updated: 3 May 2004

The values in the file, correspond to the BLER values 0.0005:0.001:0.9995 and 30 columns, corresponding to CQI values 1 to 30.
The values are the SNR values as a function of BLER and CQI. This matrix is based on Joao Carlos Silva's simulations performed for CQI values 1, 8, 15, 22 and 30.
These data have been reduced to the following formula:
(SQRT(3)-LOG10(CQI))/2*LOG10((BLER^-0.7)-1)+1.03*CQI-17.3

Note the following trends:

  • the higher the CQI, the higher the SNR value (given a certain BLER)
  • the higher the BLER, the lower the SNR value (for the same CQI)
  • the curves get steeper for higher CQI values

The UE type that is assumed in the simulator is 3GPP UE category 1 to 6. And requires the highest CQI values to be treated as CQI==22. Therefore the last columns are all the same value.
Rayleigh 3kmh 300m 200s (1.7 MB) Input tracefile (UE 300 metres from the Node B, Rayleigh fading environment)
Rayleigh 3kmh 500m 200s (1.7 MB) Input tracefile (UE 500 metres from the Node B, Rayleigh fading environment)
Rayleigh 3kmh 700m 200s (1.7 MB) Input tracefile (UE 700 metres from the Node B, Rayleigh fading environment)

Documentation for Eurane
eurane_user_guide_1_6.pdf

Seacorn Deliverable D32v2Seacorn.pdf.gz

 User Manual for Eurane. (updated 22 September 2005)
This version describes the 1.10 version of EURANE for ns-2.28.

September 2005: Update to 2.28 and version 1.10 of EURANE
February 2005: Editorial changes to the formulas in appendix B
January 2005: Added Seacorn deliverable D3.2v2

See also the paper:
F.Brouwer, Usage of Link-Level Performance Indicators for HSDPA Network-Level Simulations in E-UMTS, ISSSTA 2004, Sydney 2004.
This paper is available upon request. eurane_NOSP@M_ti-wmc.nl. (Remove the _NOSP and M_ bits).

Contact for EURANE

There's now a mailinglist for EURANE. You can subscribe and unsubscribe Using this web interface.

NB: EURANE is not officially supported, nor is any functionality guaranteed (see the License). Commercial support can be negotiated for commercial rates.

WMC has performed most of the work in creating these extensions to ns-2 for Ericsson Telecommunicatie B.V. WMC logo
Last modified: 10 October 2006