This work is based on work by NTT.

To use the code, do:
./build_oai --oaisim --ue-nas-use-tun -t ETHERNET -c

This commit only handles oaisim in S1 mode.

We won't handle noS1 mode.

Only ulsim and dlsim compile. The others (dlsim_tm4 pucchsim prachsim
pdcchsim pbchsim mbmssim) have been disabled.

Command line to compile: ./build_oai --phy_simulators

It has been chosen to not include the full history of commits
from David. He included a binary version of wireshark, probably
a modified one that understands NFAPI. Wireshark is released under
the GPL license, we cannot include it in the repository. We could
have done a next commit to remove this binary. But then it would
still be present in the history of commits, which may not be allowed.
And it would take space on disk. We could edit the history to remove
wireshark entirely. But this operation is too complicated.

There was also a pcap capture file, which has nothing to do in
the history of commits and would take space on disk. There again,
it's too difficult to edit the history to remove it.

There was a file .gitignore that was also removed.

The original history can be found on David's repository:
https://gitlab.eurecom.fr/daveprice/openairinterface5g/
The branch is: nfapi-ru-rau-split.

A copy of that branch has been included in the internal OAI
repository, for those who have access to it.
The branch is the same. The last commit ID is
9106438239e0bc626ff1fa1d97d911caadd0fbb9.

You can compare the current commit with the commit 9106...
to see what differs.

The current commit has to be considered non-working.
The commit following the current commit will fix problems with
the work in the current commit.

If you use git bisect, don't spend time analyzing the current
commit.

Compilation will fail if UHD is not installed, there is no need
to check. Plus the test is wrong when you install UHD somewhere
else.

protobuf-c does not compile anymore.

Let's handle this a bit better.

We now install protobuf and protobuf-c only for the
flexran agent. That is, if you want to use the flexran
agent, you need to install protobuf/protobuf-c and
you do it this way:

  ./build_oai -I -a

(you add -a)

Other targets don't need protobuf nor protobuf-c, so
it's not installed by the -I command of build_oai,
unless you pass -a with -I.

Also, we now use protobuf 3.3.0, not 2.6.1. The code
has been adapted, a quick test seems to indicate that
the system works, but it has not been intensively tested.

Signed-off-by: Frank A. Zdarsky <fzdarsky@redhat.com>

- rename UE_NO_LOG to DISABLE_LOG_X
  because the name is misleading. The full software
  is impacted, not only the UE part
- same for compilation option ---ue-no-log
  that becomes --disable-log
- keep LOG_X for the standard case, that is the
  case without DISABLE_LOG_X where printf has been
  put. Two reasons:
  * printf is not realtime friendly
  * keep behavior similar for other users who may
    be troubled by different logs that don't add
    any benefit to previous logs

Signed-off-by: Frank A. Zdarsky <fzdarsky@redhat.com>

--ue-trace : Enabling UE trace for debug
--ue-timing : Enabling UE timing trace
--ue-no-log : Disabling all LOG_X traces

- import RRC ASN.1 defintions from the specifications
  (file openair2/RRC/LITE/MESSAGES/asn1c/ASN1_files/RRC-e10.asn)
  contrary to rel8/10, all modules have been imported, maybe it's too much
  to refine in case of problems
- deal with rel14 in fix_asn1
- all code that was for Rel10 is now for Rel10/Rel14
- some incompatible changes (mostly in naming) were resolved in favor
  of rel14, see in openair2/RRC/LITE/defs.h
- unsure about the rlc layer, some arrays have changed (values appended),
  I only changed the definition and in tests in the code, I changed
  the index limit, maybe it's not enough

Rel14 is the default compilation mode.

When rebuilding oaisim, I had a failure because the target
link already exists. The -f flag forces the link to be done.

- build script has ability to indicate location for downloading uhd images
- one simple wrapper to set environment variables and initiate another program (supposed to be lte-softmodem)

- the option --UE was abused! Let's introduce --UE-conf-nvram and
  --UE-gen-nvram
- the option name --UE-OUTPUT was not clear and is now replaced by
  --UE-gen-nvram
- the new options are described when running ./build_oai -h
- print_help has been modified (' replaced by ") to print
  $conf_nvram_path and $gen_nvram_path

All the test pass.

This commit reverts behaviour of data generation as before
commit 7207c65b05fd812a18371827f2bfb1431fc58696:

    fix .ue* filenames in scripts and documentation

    TODO add option to conf2uedata and adapt script

This patch adds the conf2uedata tool for generating .ue.nvram* .ue.emm.nvram*
and .usim.nvram* files from a textual configuration file.

The configuration file define most usefull values like plmns, mnc, mcc, msin, K,
OPc for several users.
The files generated will always ends with a number corresponding to the user
entry in the configuration file.

This breaks oai5g because other script have not be updated for using
conf2uedata.
This breaks also the at_nas_ue command.

Examples of configuration files are in openair3/NAS/TOOLS/

The compilation of this module does not seem to be necessary,
as far as I have checked. Plus it fails when you run
"build_oai --oaisim --noS1", so let's not compile it.

- add progess bar report
- reduce ssh max_tries to 10
- cleanOldPrograms -> change kill cmd line to be able to run autotest on same machine than lte-softmodem (thanks Rohit & Gabriel)
- Cleanning output prints
- add --skip-machine-preparation on cmd line
- add --skip-sanity-check on cmd line
- add HTML REPORT (no-S1 only)
- add XML detailled report (no-S1 only)

The text has been updated in all those files.

	modified:   README.txt
	modified:   cmake_targets/CMakeLists.txt
	modified:   cmake_targets/at_commands/CMakeLists.txt
	modified:   cmake_targets/autotests/core.py
	modified:   cmake_targets/autotests/log.py
	modified:   cmake_targets/autotests/openair.py
	modified:   cmake_targets/autotests/run_exec_autotests.bash
	modified:   cmake_targets/autotests/run_exec_lte-softmodem_tests.py
	modified:   cmake_targets/autotests/tools/configure_cots_bandrich_ue.py
	modified:   cmake_targets/autotests/tools/configure_cots_huaweiE398_ue.py
	modified:   cmake_targets/autotests/tools/configure_usrpb210.py
	modified:   cmake_targets/autotests/tools/find_usb_path.bash
	modified:   cmake_targets/autotests/tools/free_mem.bash
	modified:   cmake_targets/autotests/tools/iperf3_script
	modified:   cmake_targets/autotests/tools/iperf3_script_phone
	modified:   cmake_targets/autotests/tools/iperf_script
	modified:   cmake_targets/autotests/tools/iperf_script_phone
	modified:   cmake_targets/autotests/tools/lib_autotest.py
	modified:   cmake_targets/autotests/tools/search_repl.py
	modified:   cmake_targets/build_oai
	modified:   cmake_targets/tools/asn1tostruct.py
	modified:   cmake_targets/tools/build_helper
	modified:   cmake_targets/tools/build_test_epc_tools
	modified:   cmake_targets/tools/example_enb_exmimo_mme_hss.txt
	modified:   cmake_targets/tools/example_oaisim_enb_ue_mme_virtual.txt
	modified:   cmake_targets/tools/indent_source_code
	modified:   cmake_targets/tools/init_exmimo2
	modified:   cmake_targets/tools/init_nas_nos1
	modified:   cmake_targets/tools/perf_oai.bash
	modified:   cmake_targets/tools/run_enb_s1_exmimo
	modified:   cmake_targets/tools/run_enb_s1_usrp
	modified:   cmake_targets/tools/run_enb_ue_virt_noS1
	modified:   cmake_targets/tools/run_enb_ue_virt_s1
	modified:   openair2/DOCS/TEMPLATES/README/Readme.doxy
	modified:   openair2/DOCS/TEMPLATES/README/readme.txt
	modified:   openair2/Makefile
	modified:   openair2/UTIL/OCG/Readme.doxy
	modified:   openair2/UTIL/OCG/readme.txt
	modified:   openair2/UTIL/OSD/recep.php
	modified:   openair2/X2AP/MESSAGES/ASN1/asn1tostruct.py
	modified:   openair3/DOCS/DOXYGEN/Makefile.am
	modified:   openair3/DOCS/Latex/EPC/Makefile
	modified:   openair3/DOCS/Makefile.am
	modified:   openair3/GTPV1-U/Makefile.am
	modified:   openair3/GTPV1-U/Makefile.eNB
	modified:   openair3/NAS/TEST/AS_SIMULATOR/Makefile
	modified:   openair3/NAS/TEST/NETWORK/Makefile
	modified:   openair3/NAS/TEST/USER/Makefile
	modified:   openair3/NAS/TOOLS/Makefile
	modified:   openair3/NAS/UE/API/USER/Makefile
	modified:   openair3/NAS/UE/API/USER/tst/Makefile
	modified:   openair3/NAS/UE/API/USIM/Makefile
	modified:   openair3/S1AP/MESSAGES/ASN1/asn1tostruct.py
	modified:   openair3/TEST/Makefile.am
	modified:   targets/ARCH/EXMIMO/USERSPACE/OCTAVE/gpib_send.cc
	modified:   targets/ARCH/EXMIMO/USERSPACE/OCTAVE/oarf_config_exmimo.cc
	modified:   targets/ARCH/EXMIMO/USERSPACE/OCTAVE/oarf_get_frame.cc
	modified:   targets/ARCH/EXMIMO/USERSPACE/OCTAVE/oarf_get_num_detected_cards.cc
	modified:   targets/ARCH/EXMIMO/USERSPACE/OCTAVE/oarf_send_frame.cc
	modified:   targets/ARCH/EXMIMO/USERSPACE/OCTAVE/oarf_stop.cc
	modified:   targets/ARCH/EXMIMO/USERSPACE/OCTAVE/oarf_stop_without_reset.cc
	modified:   targets/PROJECTS/E-MBMS/build_all.bash
	modified:   targets/PROJECTS/E-MBMS/start_enb.bash
	modified:   targets/PROJECTS/E-MBMS/start_ue.bash
	modified:   targets/PROJECTS/E-MBMS/utils.bash
	modified:   targets/PROJECTS/GENERIC-LTE-EPC/interfaces.bash
	modified:   targets/PROJECTS/GENERIC-LTE-EPC/networks.bash
	modified:   targets/PROJECTS/GENERIC-LTE-EPC/start_enb_and_ue_virt.bash
	modified:   targets/PROJECTS/GENERIC-LTE-EPC/start_ue.bash
	modified:   targets/PROJECTS/GENERIC-LTE-EPC/utils.bash
	modified:   targets/PROJECTS/GENERIC-LTE-EPC/virtual_box.bash
	modified:   targets/SCRIPTS/install_asn1c_0.9.24.modified.bash
	modified:   targets/TEST/OAI/case01.py
	modified:   targets/TEST/OAI/case02.py
	modified:   targets/TEST/OAI/case03.py
	modified:   targets/TEST/OAI/case04.py
	modified:   targets/TEST/OAI/case05.py
	modified:   targets/TEST/OAI/case11.py
	modified:   targets/TEST/OAI/case12.py
	modified:   targets/TEST/OAI/case13.py
	modified:   targets/TEST/OAI/core.py
	modified:   targets/TEST/OAI/log.py
	modified:   targets/TEST/OAI/openair.py
	modified:   targets/TEST/OAI/test01.py
	modified:   targets/TEST/OAI/test02.py
	modified:   targets/TEST/PDCP/readme.txt
	modified:   targets/build_helper.bash
	modified:   targets/build_oai.bash
	modified:   targets/perf_oai.bash