readme.txt

3G UTRAN Iub NodeB 接口 NBAP协议解析库

NBAP Version 5 API

This distribution contains the software for the UTRAN Iub 
interface Node B Application Part (NBAP) Protocol Specification 
as defined by the Third Generation Partnership Project (3GPP).  
This specification is defined in technical document 3GPP TS 
25.433 V6.15.0.

INSTALLATION

The extended sample program is saved as a .zip archive which 
is to be installed within an existing ASN1C installation (either 
evaluation or licensed).

The package should be unzipped in the cpp subdirectory of the 
ASN1C installation.  The following directory tree will be 
created: 

nbapv6fw
  +- lib
  +- lib_opt
  +- sample
     +- initMsg
  +- src
  +- src_opt
  +- specs

BUILD PROCEDURE

To build the NBAP library, change directory to the src subdirectory 
and execute the Visual Studio nmake command.  This will cause the 
ASN1C compiler to be invoked to compile the NBAP ASN.1 specification
file(s) in the specs subdirectory.  The C++ compiler will then be 
invoked to compile the C++ source files.  The result will be a static 
archive library file (nbap_a.lib) created in the lib subdirectory.

To build and run the sample programs, go to the sample subdirectory. 
You can then go to each of the sample subdirectoreis within and invoke 
nmake to compile and link the writer and reader programs.  The writer 
and reader programs can then be invoked from a command-line prompt 
to demonstrate the encoding and decoding of PER messages.

Note that the size of the compiled library is very large due to the 
inclusion of trace diagnostics to allow the composition of the PER 
messages to be examined.  The library size can be reduced by editing 
the makefile in the src subdirectory and removing '-trace' from the 
ASN1C command-line and then rebuilding everything.

INCLUDED FILES

The following is a listing and description of important files 
included in this package:

platform.mk - This is a make include file containing definitions 
for a specific platform.  This particular version contains 
definitions for the Microsoft Visual C++ compiler version 6.0 on 
Windows.

src/makefile - This is the makefile for building the standard 
version of the NBAP library.  The standard version contains trace 
diagnostic messages and print function built-in so that you can 
view traces and dumps of encoded PER messages.

src_opt/makefile - This is the makefile for building 
the optimized version of the NBAP library.  The compact version has 
all tracing and dynamic messages removed.  The -tables option is also 
not used which suppresses the generation of table checking code.  This 
code forms a large part of the non-optimized library.  Finally, the 
code was also generated with the asn1c compiler -compact switch on to 
do further optimizations.

lib/nbap_a.lib - Object library containing compiled NBAP C++ source 
file objects.  The default compiled configured configuration is a 
static library.  This should be linked with the lib/asn1per_a.lib and 
lib/asn1rt_a.lib libraries to produce an executable (see the sample 
programs).  The compiler parameters in the build makefile can be 
adjusted to produce a libary that can be linked with the DLL's.

lib_opt/nbap_a.lib - Optimized version of the NBAP library. 

src/* - This directory contains the standard generated NBAP source code.

src_opt/* - This directory contains the optimized source code generated 
with the -compact option.  There is an approximately 20% to 30% decrease 
in the size of the code base.

sample/initMsg - This directory contains a sample program 
showing how an NBAP message is populated, encoded, and decoded.  The 
writer program encodes a test message and writes it to a file 
(message.dat).  The reader will read this file and decode and display 
the message contents.

GETTING STARTED

The best way to begin using the software is by executing the sample 
program.  Go to the sample/initMsg directory and execute the 
makefile using nmake from an MS-DOS or other command shell:

  nmake

This will build the writer and reader programs.  You can then 
execute the writer as follows:

  writer

It will encode an aligned PER message and write it to the 
message.dat file.  A trace dump of the message will be done do that 
you can observe the bit-pattern of what was encoded.

You can then issue the reader program to read the message:

  reader

This will read and decode the message.  The contents of the decoded 
structure will be displayed.  You can verify these contents with the 
code in the writer program to ensure you got back what originally was 
encoded.


REPORTING PROBLEMS

Report problems you encounter by sending E-mail to [e-mail].  
The preferred format of example programs is the same as the sample 
programs.  Please provide a writer and reader and indicate where in 
the code the problem occurs.

If you have any further questions or comments on what you would like to 
see in the product or what is difficult to use or understand, please 
communicate them to us.  Your feedback is important to us.  Please let 
us know how it works out for you - either good or bad.