| Lev Walkin | 5aef2c5 | 2007-06-29 12:46:06 +0000 | [diff] [blame] | 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 tap3.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 | |