Default constructor

Prohibit copy constructor

Destructor

second stage constructor

Second stage constructor

Outgoing messages: constructs the data encapsulation and control objects. Incoming message: no action

EncodeAltitude()

Converts an value for altiutude to an 15 bit binary coded number N

Encode a populated outgoing message

EncodeToL()

Encode a populated outgoing message to the specified buffer.

Populates aSessionId with the SUPL Session ID (for received messages)

GetSessionId()

Populates aSessionId with the SUPL Session ID

Populates aVersion with the SUPL version (for received messages)

GetVersion()

Populates aVersion with the SUPL version

checks for memory allocation failure and leaves

LeaveIfAllocErrorL()

Calls User::Leave(<error code>) if a memory allocation has failed.

Prints the content of the data structure to the logger

Methods for accessing content of decoded received messages Returns the message type

MessageType()

Returns the message type

PopulateLocationId()

Populates the data container specifying the content of the LOCATION ID componenet according to the passed LBS location details.

PopulatePosition()

Populates the outgoing position element, used in POS INIT and END messages.

Timestamp is encoded in UTC format YYMMDDhhmmssZ

Latitude is encoded as an integer N (0..2^23-1) from the actual latitude X in degrees, where N <= 2^23 * X/90 < N+1

Longitude is encoded as an integer N (-2^23..2^23-1) from the actual longitude X in degrees, where N <= 2^24 * X/360 < N+1

Horizontal Uncertainty is encoded as per 3GPP GAD, ie describing an ellipse with semi-major and semi-minor axis measurements and orientation. With only one value for horizontal accuracy available, the circle described is encoded as an ellipse with semi-major = semi-minor axis and 0 degree orientation. The uncertainty is encoded to 7 bits, thus: r = C( (1+x)^k - 1 ) where r = distance in meters, C = 10, x = 0.1 and K is the encoded constant.

Confidence information is not available in this implementation and is omitted

Altitude, if data is available, is encoded as a 15 bit binary encoded number.

Altitude uncertainty is encoded as a distance above or below the WGS84 ellipsoid, using the same formula as for horizontal uncertainty, but where C = 45, x = 0.025. Encoded value K is limited to 7 bits.

If the passed TPositionInfoBase object is a TPositionCourseInfo, then the optional velocity element is populated with data from the course info object. Velocity information is encoded as per 3GPP TS 23.032, and the "horizontal velocity with uncertainty" format is used.

methods for outgoing SUPL parameters common to multiple messages

PopulateSetCapabilities()

Populates the data container specifying the content of the SET CAPABILITIES componenet according to the passed LBS capabilities.

Note that the Preferred Method parameter is set to the method identified LAST in the array of capable methods. It is acceptable if this method is repeated elsewhere in the passed array.

translates ASN1 run-time errors

Translates error codes returned by the ASN1 runtime library to distinguish from Symbian global error codes.

Errors are simply translated to positive error codes. They maintain their meaning as described in rtxErrCodes.h and asn1ErrCodes.h.

Exceptions: RTERR_NOMEM is translated to global error code KErrNoMemory

rtxErrCodes.h asn1ErrCodes.h

Assign decoded ASN1 data. (for received messages) Not intended for DLL export

SetDecodedData()

Assign decoded ASN1 data, for received messages. Takes ownership of passed objects.

Set the SUPL Session ID (for outgoing messages)

SetSessionId()

Set the SUPL Session ID

Methods for populating common parameters for outgoing messages Set the SUPL version used (for outgoing messages)

SetVersion()

Set the SUPL version used

common calculation methods

Uncertainty()

Converts a minumum accuracy value in meters to an uncertainty value K as described in 3GPP 23.032 (Universal Geographical Area Description) section 6.2.

r = C((1+x)^K - 1)

where r = distance in meters C = 10 x = 0.1 K = uncertainty value

hence K = ln(r/C + 1) / ln(1.1)

UncertaintyAltitude()

Converts a minumum accuracy value in meters to an uncertainty altitude value K as described in 3GPP 23.032 (Universal Geographical Area Description) section 6.4.

r = C((1+x)^K - 1)

where r = distance in meters C = 45 x = 0.1 K = uncertainty value

hence K = ln(r/C + 1) / ln(1.1)

Prohibit assigment operator

TSuplMessageType typedef