aboutsummaryrefslogtreecommitdiffstats
path: root/examples/sample.source.ULP/README
diff options
context:
space:
mode:
Diffstat (limited to 'examples/sample.source.ULP/README')
-rw-r--r--examples/sample.source.ULP/README53
1 files changed, 53 insertions, 0 deletions
diff --git a/examples/sample.source.ULP/README b/examples/sample.source.ULP/README
new file mode 100644
index 00000000..88f71587
--- /dev/null
+++ b/examples/sample.source.ULP/README
@@ -0,0 +1,53 @@
+
+GENERAL INFORMATION
+===================
+
+The OMA ULP (UserPlane Location Protocol) decoder.
+Invoking `make` will compile the ASN.1 specifications from the
+../ulp.asn1 file.
+
+THERE IS NO ulp.asn1 FILE THERE YET!
+
+OBTAINING THE ULP SPECIFICATION
+===============================
+
+Due to unclear stanza of Open Mobile Alliance regarding the extraction of
+ASN.1 modules from their documents, and also due to some OMA membership
+concerns, asn1c can not include the ULP ASN.1 module in its distribution.
+
+To obtain the ULP ASN.1 specification, you should go to
+ http://www.openmobilealliance.org/UseAgreement.html
+and agree with their licensing terms by clicking the "I ACCEPT" button.
+
+Then, go to http://member.openmobilealliance.org/ftp/Public_documents/LOC/Permanent_documents/
+and download the necessary specification file. For example, one of these:
+ Version 1.0 specifications (Candidate versions):
+ OMA-TS-ULP-V1_0-20070122-C.zip (V1.0, 2007 January 22)
+ OMA-TS-ULP-V1_0-20070613-C.zip (V1.0, 2007 June 13)
+ Version 2.0 specification (Draft version):
+ OMA-TS-ULP-V2_0-20070625-D.zip (V2.0, 2007 April 25)
+
+A .ZIP file with several Microsoft Word .DOC files will download shortly.
+
+You should extract the ASN.1 module from the section 8 of these .DOC files
+and save it as the ../ulp.asn1 file. The ../ulp.asn1 file should start with
+the following line
+ "ULP DEFINITIONS IMPLICIT TAGS ::="
+and end with the "END" token.
+Be careful not to copy any non-ASN.1 preambles from that .DOC file.
+
+After obtaining the tap3.asn1, type `make` in the directory containing
+this README file.
+
+ulp-dump USAGE
+==============
+
+The ulp-dump utility may be used to dump the contents of the PER-encoded
+ULP message record file:
+
+ ./ulp-dump ulpfile.per # Print as XML (BASIC-XER)
+
+The full list of recognized command line options may be obtained with
+
+ > ./ulp-dump -h
+