Merge pull request #150 from brchiu/add_rrc_lte_example

Add LTE-RRC example

.gitignore

@@ -55,6 +55,8 @@ doc/docsrc/*.xdv
 /examples/*/*.h
 /examples/*/*dump
 /examples/*/.tmp.*
+!/examples/*/Makefile
+!/examples/*/config.h
 
 # /libasn1compiler/
 /libasn1compiler/check_compiler

examples/Makefile.am

@@ -33,6 +33,7 @@ EXTRA_DIST = \
 	sample.source.RRC				\
 	sample.source.TAP3				\
 	sample.source.PKIX1				\
+	sample.source.LTE-RRC				\
 	sample.makefile.regen
 
 CLEANFILES = $(ASN1_FILES_1) $(ASN1_FILES_2) $(ASN1_FILES_3)

examples/README

@@ -25,6 +25,9 @@ This directory contains a few examples.
    UserPlane Location Protocol decoder. Before trying to compile, read the
    README file in that directory.
 
+7. The ./sample.source.LTE-RRC directory contains the 3GPP Radio Resource Control
+   decoder for LTE RRC version 14.2.1. Read the README file in that directory.
+
 The crfc2asn1.pl script can be used to extract ASN.1 data from RFC texts.
 For instance, it is used to extract X.509, MEGACO, and LDAPv3 ASN.1 modules
 from the corresponding RFC texts (rfc3280.txt, rfc3525.txt, rfc4211.txt).

examples/sample.source.LTE-RRC/README

+
+GENERAL INFORMATION
+===================
+
+The 3GPP TS 36.331 version 14.2.1 Radio Resource Control (RRC) Unaligned PER decoder.
+Invoking `make` will compile the ASN.1 specifications from the
+../lte-rrc-14.2.1.asn1 file. 
+
+Currently only Makefile and binary sample in this directory.
+
+OBTAINING THE LTE-RRC SPECIFICATION
+===================================
+
+To obtain this LTE-RRC ASN.1 specification or other version, you should go to
+	http://www.3gpp.org/ftp/Specs/html-info/36331.htm
+and download any version of LTE-RRC specification you like.
+
+A .ZIP file with a Microsoft Word .DOC files will download shortly.
+
+You should extract the ASN.1 modules from that .DOC file.
+Be careful not to copy any preambles, chapter titles and other non-ASN.1 text.
+
+lte-rrc-dump USAGE
+==================
+
+The lte-rrc-dump utility may be used to dump the contents of a Unaligned PER-encoded
+LTE-RRC protocol data unit. Since LTE-RRC specification contains multiple PDUs,
+a PDU must be selected manually using -p <PDU> command line option:
+
+	./lte-rrc-dump -iper -p DL-DCCH-Message message.per
+	./lte-rrc-dump -iper -p PCCH-Message message.per
+
+The list of recognized PDUs may be obtained using `-p list`.
+
+The full list of recognized command line options may be obtained with
+
+	> ./lte-rrc-dump -h
+

examples/sample.source.LTE-RRC/config.h

+
+extern int opt_debug;
+
+#define	ASN_DEBUG(fmt, args...)	do {		\
+		if(opt_debug < 2) break;	\
+		fprintf(stderr, fmt, ##args);	\
+		fprintf(stderr, " (%s:%d)\n",	\
+			__FILE__, __LINE__);	\
+	} while(0)
+