examples/sample.source.ULP/README

   1
   2 GENERAL INFORMATION
   3 ===================
   4
   5 The OMA ULP (UserPlane Location Protocol) decoder.
   6 Invoking `make` will compile the ASN.1 specifications from the
   7 ../ulp.asn1 file.
   8
   9 THERE IS NO ulp.asn1 FILE THERE YET!
  10
  11 OBTAINING THE ULP SPECIFICATION
  12 ===============================
  13
  14 Due to unclear stanza of Open Mobile Alliance regarding the extraction of
  15 ASN.1 modules from their documents, and also due to some OMA membership
  16 concerns, asn1c can not include the ULP ASN.1 module in its distribution.
  17
  18 To obtain the ULP ASN.1 specification, you should go to
  19         http://www.openmobilealliance.org/UseAgreement.html
  20 and agree with their licensing terms by clicking the "I ACCEPT" button.
  21
  22 Then, go to http://member.openmobilealliance.org/ftp/Public_documents/LOC/Permanent_documents/
  23 and download the necessary specification file. For example, one of these:
  24     Version 1.0 specifications (Candidate versions):
  25         OMA-TS-ULP-V1_0-20070122-C.zip  (V1.0, 2007 January 22)
  26         OMA-TS-ULP-V1_0-20070613-C.zip  (V1.0, 2007 June 13)
  27     Version 2.0 specification (Draft version):
  28         OMA-TS-ULP-V2_0-20070625-D.zip  (V2.0, 2007 April 25)
  29
  30 A .ZIP file with several Microsoft Word .DOC files will download shortly.
  31
  32 You should extract the ASN.1 module from the section 8 of these .DOC files
  33 and save it as the ../ulp.asn1 file. The ../ulp.asn1 file should start with
  34 the following line
  35         "ULP DEFINITIONS IMPLICIT TAGS ::="
  36 and end with the "END" token.
  37 Be careful not to copy any non-ASN.1 preambles from that .DOC file.
  38
  39 After obtaining the ulp.asn1, type `make` in the directory containing
  40 this README file.
  41
  42 ulp-dump USAGE
  43 ==============
  44
  45 The ulp-dump utility may be used to dump the contents of the PER-encoded
  46 ULP message record file:
  47
  48         ./ulp-dump ulpfile.per  # Print as XML (BASIC-XER)
  49
  50 The full list of recognized command line options may be obtained with
  51
  52         > ./ulp-dump -h
  53