asn1c/examples/sample.source.ULP
Jon Ringle 3016fd59fe Rename Makefile.am.example => converter-example.mk
The generated Makefile.am.example is not really in the automake style.
Renaming it to converter-example.mk to reflect that it is a plain makefile
snippet and that it is for creating the converter-example
2017-11-17 20:54:02 -08:00
..
Makefile Rename Makefile.am.example => converter-example.mk 2017-11-17 20:54:02 -08:00
README typo fix 2017-08-04 01:45:03 -07:00
config.h Open Mobile Alliance UserPlane Location Protocol 2007-06-29 12:46:06 +00:00
sample-ULP-PDU-1.per testing data 2007-06-29 12:59:12 +00:00
sample-ULP-PDU-1.xer another testcase 2007-06-29 13:22:29 +00:00
sample-ULP-PDU-2.per short probe 2007-07-23 11:40:42 +00:00

README

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 ulp.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