8.50 Mobile originated location request +CMOLR

27.0073GPPAT command set for User Equipment (UE)Release 18TS

Tools: ARFCN - Frequency Conversion for 5G NR/LTE/UMTS/GSM

Table 8.50-1: +CMOLR parameter command syntax

Command	Possible response(s)
+CMOLR=[<enable>[,<method>[,<hor-acc-set>[,<hor-acc>[,<ver-req>[,<ver-acc-set>[,<ver-acc>[,<vel-req>[,<rep-mode>[,<timeout>[,<interval>[,<shape-rep>[,<plane>[,<NMEA-rep>[,<third-party-address>]]]]]]]]]]]]]]]]	+CME ERROR: <err>
+CMOLR?	+CMOLR: <enable>,<method>,<hor-acc-set>,[<hor-acc>],<ver-req>,[<ver-acc-set>],[<ver-acc>],<vel-req>,<rep-mode>,<timeout>,[<interval>],<shape-rep>,[<plane>],[<NMEA-rep>],[<third-party-address>] +CME ERROR: <err>
+CMOLR=?	+CMOLR: (list of supported <enable>s),(list of supported <method>s),(list of supported <hor-acc-set>s),(list of supported <hor-acc>s),(list of supported <ver-req>s),(list of supported <ver-acc-set>s),(list of supported <ver-acc>s),(list of supported <vel-req>s),(list of supported <rep-mode>s),(list of supported <timeout>s),(list of supported <interval>s),(list of supported <shape-rep>s),(list of supported <plane>s),(list of supported <NMEA-rep>s),(list of supported <third-party-address>s)

Description

Set command initiates a mobile originated location request (MO-LR). The parameter <enable> enables or disables positioning and reporting by unsolicited result codes. Reporting can be performed in the format of GAD shapes <location_parameters> or in the format of NMEA strings <NMEA-string> or both. The unsolicited result codes that can be provided are +CMOLRG: <location_parameters> and/or +CMOLRN: <NMEA-string>.

The method to use for positioning is decided by the parameter <method>. The parameters <hor-acc-set>, <hor-acc>, <ver-req>, <ver-acc-set>, <ver-acc> and <vel-req> indicate accuracy for the MO-LR. The parameter <timeout> indicates how long the MS will wait for a report before an unsolicited result code is provided. A single report or periodic reports can be requested by the parameter <rep-mode>. If periodic reports are requested, the time interval between the reports is specified by the parameter <interval>. If GAD shapes are requested, the GAD shapes that will be accepted in the unsolicited result code +CMOLRG: <location_parameters> are defined by the parameter <shape-rep>. The parameter <plane> specifies the signalling to use for MO-LR. The parameter <NMEA-rep> indicates possible restrictions in supported NMEA strings that will be accepted in the unsolicited result code +CMOLRN: <NMEA-string>. The parameter <third-party-address> is used to specify the address when reporting to a third party is specified. Additional information about positioning can be found in 3GPP TS 25.305 [77]. If positioning-data cannot be provided at a timeout, the unsolicited result +CMOLRE is provided. Refer clause 9.2 and clause 9.3 for possible <err> values.

Read command returns the current settings of the parameters <enable>, <method>, <hor-acc-set>, <hor-acc>, <ver-req>, <ver-acc-set>, <ver-acc>, <vel-req>, <rep-mode>, <timeout>, <interval> <shape-rep>, <plane>, <NMEA-rep> and <third-party-address>. The parameters <hor-acc>, <ver-acc-set>, <ver-acc> and <plane> are only applicable in certain configurations. The parameter <interval> is only applicable if periodic reporting is specified. The parameter <NMEA-rep> is only applicable if reporting is specified by NMEA strings. The parameter <third-party-address> is only applicable if reporting to third party is specified.

Test command returns the supported values and ranges.

Defined values

<enable>: integer type. Enables and disables reporting location as a result of a MO-LR. Only one <method> can be enabled at any given time.

0 Disables reporting and positioning.

1 Enables reporting of NMEA strings by unsolicited result code +CMOLRN: <NMEA-string>.
Lack of data at each timeout is indicated by an unsolicited result code +CMOLRE.

2 Enables reporting of GAD shapes by unsolicited result code +CMOLRG: <location_parameters>.
Lack of data at each timeout is indicated by an unsolicited result code +CMOLRE.

3 Enables reporting of NMEA strings and GAD shapes by unsolicited result codes
+CMOLRG: <location_parameters> and +CMOLRN: <NMEA-string>.
Lack of data at each timeout is indicated by an unsolicited result code +CMOLRE.

NOTE 1: The string of <location_parameters> intended for +CMOLR can be split into multiple unsolicited result codes e.g. in order to prevent that the string in the unsolicited result code becomes too long. How to split the string is implementation specific.

<method>: integer type. Method for MO-LR. The default value is implementation specific.

0 Unassisted GPS. Autonomous GPS only, no use of assistance data.

1 Assisted GPS (see NOTE 2).

2 Assisted GANSS (see NOTE 2).

3 Assisted GPS and GANSS (see NOTE 2).

4 Basic self location (the network determines the position technology).

5 Transfer to third party. This method makes the parameters <shape-rep> and <NMEA-rep> irrelevant (any values are accepted and disregarded). The third party address is given in the parameter <third-party-address> (see NOTE 3).

6 Retrieval from third party. This method is to get the position estimate of the third party. The third party address is given in the parameter <third-party-address>.

NOTE 2: For the methods that require assistance data, the assistance data obtained from the network is used for a UE-based GPS location procedure.

NOTE 3: Lack of data at each timeout is not indicated by an unsolicited result code +CMOLRE if reporting to third party is specified.

<hor-acc-set>: integer type.

0 Horisontal accuracy not set/specified.

1 Horizontal accuracy set in parameter <hor-acc>.

<hor-acc>: integer type. Requested accuracy as horizontal uncertainty exponent (refer to 3GPP TS 23.032 [76] clause 6.2). The value range is 0-127. The default value is implementation specific.

<ver-req>: integer type.

0 Vertical coordinate (altitude) is not requested, 2D location fix is acceptable. The parameters <ver-acc-set> and <ver-acc> do not apply.

1 Vertical coordinate (altitude) is requested, 3D location fix is required.

<ver-acc-set>: integer type.

0 Vertical accuracy not set/specified.

1 Vertical accuracy set/specified in parameter <ver-acc>.

<ver-acc>: integer type. Requested accuracy as vertical uncertainty exponent (refer to 3GPP TS 23.032 [76] clause 6.4). The value range is 0-127. The default value is implementation specific.

<vel-req>: integer type. Requested velocity type (refer to 3GPP TS 23.032 [76] clause 8.6).

0 Velocity not requested.

1 Horizontal velocity requested.

2 Horizontal velocity and vertical velocity requested.

3 Horizontal velocity with uncertainty requested.

4 Horizontal velocity with uncertainty and vertical velocity with uncertainty requested.

<rep-mode>: integer type. Reporting mode. The default value is implementation specific.

0 Single report, the timeout for the MO-LR response request is specified by <timeout>.

1 Periodic reporting, the timeout for each MO-LR response request is specified by <timeout> and the interval between each MO-LR is specified by <interval>.

<timeout>: integer type. Indicates how long the MS will wait for a response after a MO-LR. The value range is in seconds from 1 to 65535. The default value is implementation specific.

<interval>: integer type. The parameter is applicable to periodic reporting only. Determine the interval between periodic MO-LRs. The value range is in seconds from 1 to 65535, and must be greater than or equal to <timeout>. The default value is implementation specific.

<shape-rep>: integer type. This parameter is a sum of integers each representing a certain GAD shape that will be accepted in the unsolicited result code +CMOLRG: <location_parameters>. Note that only one GAD shape is present per unsolicited result code. The default value is implementation specific.

1 Ellipsoid point.

2 Ellipsoid point with uncertainty circle.

4 Ellipsoid point with uncertainty ellipse.

8 Polygon.

16 Ellipsoid point with altitude.

32 Ellipsoid point with altitude and uncertainty ellipsoid.

64 Ellipsoid arc.

<plane>: integer type. The parameter specifies whether the control plane or SUPL will be used for MO-LR.

0 Control plane.

1 Secure user plane (SUPL).

<NMEA-rep>: string type. The supported NMEA strings that will be accepted in the unsolicited result code +CMOLRN: <NMEA-string> are specified as a comma separated values inside one string. If the parameter is omitted or an empty string is given, no restrictions apply and all NMEA strings are supported. The default value is that all strings are supported.

Example of NMEA strings: "$GPRMC,$GPGSA,$GPGSV"

<third-party-address>: string type. The parameter is applicable to reporting to third party only, and specifies the address to the third party. This parameter has to be specified when <method> value is set to 5 or 6.

<location_parameters>: string type in UTF-8. This parameter provides XML-formatted strings of GAD-shape positioning data as defined in table 8.50-2. This parameter shall not be subject to conventional character conversion as per +CSCS. The XML according to the DTD in table 8.50-2 may be provided in one or multiple unsolicited result codes.

Table 8.50-2: XML DTD for <location_parameters>

<?xml version="1.0" ?>

<!DOCTYPE location_parameters [

<!ELEMENT location_parameters (time?,direction?,shape_data,velocity_data?)>

<!ELEMENT time (#PCDATA)>

<!ELEMENT direction (#PCDATA)>

<!ELEMENT ellipsoid_point (coordinate)>

<!ELEMENT coordinate (latitude,longitude)>

<!ELEMENT latitude (north,degrees)>

<!ELEMENT north (#PCDATA)>

<!ELEMENT degrees (#PCDATA)>

<!ELEMENT longitude (#PCDATA)>

<!ELEMENT ellipsoid_point_uncert_circle (coordinate,uncert_circle)>

<!ELEMENT uncert_circle (#PCDATA)>

<!ELEMENT ellipsoid_point_uncert_ellipse (coordinate,uncert_ellipse)>

<!ELEMENT uncert_ellipse (uncert_semi_major,uncert_semi_minor,orient_major,confidence)>

<!ELEMENT uncert_semi_major (#PCDATA)>

<!ELEMENT uncert_semi_minor (#PCDATA)>

<!ELEMENT orient_major (#PCDATA)>

<!ELEMENT confidence (#PCDATA)>

<!ELEMENT polygon (coordinate+)>

<!ELEMENT ellipsoid_point_alt (coordinate,altitude)>

<!ELEMENT altitude (height_above_surface,height)>

<!ELEMENT height_above_surface (#PCDATA)>

<!ELEMENT height (#PCDATA)>

<!ELEMENT ellipsoid_point_alt_uncertellipse (coordinate,altitude,uncert_semi_major,uncert_semi_minor,orient_major,confidence,uncert_alt)>

<!ELEMENT uncert_alt (#PCDATA)>

<!ELEMENT ellips_arc (coordinate,inner_rad,uncert_rad,offset_angle,included_angle,confidence)>

<!ELEMENT inner_rad (#PCDATA)>

<!ELEMENT uncert_rad (#PCDATA)>

<!ELEMENT offset_angle (#PCDATA)>

<!ELEMENT included_angle (#PCDATA)>

<!ELEMENT velocity_data

(hor_velocity?,vert_velocity?,vert_velocity_direction?,hor_uncert?,vert_uncert?)>

<!ELEMENT hor_velocity (#PCDATA)>

<!ELEMENT vert_velocity (#PCDATA)>

<!ELEMENT vert_velocity_direction (#PCDATA)>

<!ELEMENT hor_uncert (#PCDATA)>

<!ELEMENT vert_uncert (#PCDATA)>

<NMEA-string>: string type in UTF-8. This parameter provides an NMEA-string as defined in IEC 61162 [78]. This parameter shall not be subject to conventional character conversion as per +CSCS.

Example:+CMOLRN: "$GPRMC,235947.000,V,0000.0000,N,00000.0000,E,,,041299,,*1D<CR><LF>&"

Implementation

Optional.