summaryrefslogtreecommitdiff
path: root/doc/assisted-satellite-navigation-api.txt
blob: 296fde866ec48851313b99a1028c02a41011995d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
Assisted Satellite Navigation hierarchy [experimental]
==========================================================

Service		org.ofono
Interface	org.ofono.AssistedSatelliteNavigation
Object path	[variable prefix]/{modem0,modem1,...}

Methods		void SendPositioningElement(string xml_element)

			Send an XML element conforming to the XML DTD for <pos>
			as defined in 3GPP 27.007 Table 8.55-2. This xml is
			used for transferring data associated with positioning
			requests received via control plane from the network.
			This includes assistance data requests and the results
			of positioning procedures. This method maps directly to
			the 3GPP 27.007 AT+CPOS command.

		void RegisterPositioningRequestAgent(object path)

			Registers an agent which will be called whenever a
			CPOSR AT response is received. The Agent must respond
			to requests using SendPositioningElement.

		void UnregisterPositioningRequestAgent(object path)

			Un-registers the agent.

PositioningRequestAgent hierarchy
==================================

Service		unique name
Interface	org.ofono.PositioningRequestAgent
Object path	freely definable

Methods		void Request(string xml_element)

			Receive an XML element conforming to the XML DTD for
			<pos> in 3GPP 27.007. This xml is used for transferring
			data associated with positioning requests received, via
			control plane, from the network. This includes
			measurement requests and assistance data. This method
			maps directly to the 3GPP defined +CPOSR unsolicited
			result code.

		void ResetAssistanceData()

			A request has been received from the network that all
			assistance data should be reset.  This is used for 3gpp
			performance tests.

		void Release()

			Agent is being released, possibly because of oFono
			terminating, AssistedSatelliteNavigation interface
			is being torn down or modem off.
			No UnregisterPositioningRequestAgent call is needed.