summaryrefslogtreecommitdiffstats
path: root/doc/emergency-call-handling.txt
blob: 69b217db22fdac103df7cebcc5274538eaef138e (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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
This document explains what is expected from applications and what oFono
will do for an emergency call request in different states.

Case 1: Call in offline and SIM present state

Expected from UI/applications:

	- Online property of org.ofono.Modem interface should be set to TRUE.
	- Dial method should be called with the dialled number.

What oFono will do:

	- Modem will be set to online.
	- Post online atoms will be created.
	- Upon reception of Dial request, Emergency mode is activated.
	- Once the call is ended, Emergency mode is deactivated.
	- Modem remains in online mode with full funcationality.

Case 2: Call in SIM Present and PIN required state

Expected from UI/applications:

	- If the user enters emergency number in the PIN entry dialog, then
	  Online property on org.ofono.Modem interface should be set to TRUE.
		- List of Emergency numbers can be known from the
		  EmergencyNumbers property on the org.ofono.VoiceCallManager
		  interface.
	- Dial method should be called with the dialled number

What oFono will do:

	- Modem will be set to online.
	- Upon reception of Dial request, Emergency mode is activated.
	- Once the call is ended, Emergency mode is deactivated.
	- Modem remains in online mode but the functionalities will be
	  limited.

Case 3: Call in SIM Present and PIN required state - Dial cancelled by user

Expected from UI/applications:

	- If the user enters emergency number in the PIN entry dialog, then
	  Online property on org.ofono.Modem interface should be set to TRUE.
		- List of Emergency numbers can be known from the
		  EmergencyNumbers property on the org.ofono.VoiceCallManager
		  interface.
	- Dial method should be called with the dialled number
	- Upon dial cancellation by user, HangupAll should be called.

What oFono will do:

	- Modem will be set to online.
	- Post SIM and Post online atoms are not created.
	- Upon reception of Dial request, Emergency mode is activated.
	- Upon dial cancellation(HangupAll request), Emergency mode is
	  deactivated.
	- Modem remains in online mode but the functionalities will be
	  limited.

Case 4: Call in No SIM state

Expected from UI/applications:

	- Online property on org.ofono.Modem interface should be set to TRUE.
	- Dial method should be called with the dialled number

What oFono will do:

	- Modem will be set to online.
	- Post SIM and Post online atoms not created.
	- If the dialed number is an Emergeny number, Emergency mode is
	  activated.
	- Once the call is ended, Emergency mode is deactivated.
	- Modem remains in online mode but the functionalities will be
	  limited.

Case 5: Call in No SIM state - PIN disabled SIM inserted during emergency call

Expected from UI/applications:

	- Online property on org.ofono.Modem interface should be set to TRUE.
	- Dial method should be called with the dialled number

What oFono will do:

	- Modem will be set to online.
	- Post SIM and Post online atoms are not created.
	- If the dialed number is an Emergeny number, Emergency mode is
	  activated.
	- Upon PIN disabled SIM detection, Post SIM and Post online
	  atoms are created.
	- Once the call is ended, Emergency mode is deactivated.
	- Modem remains in online mode with full functionality.

Case 6: Call in No SIM state - PIN enabled SIM inserted during emergency call

Expected from UI/applications:

	- Online property on org.ofono.Modem interface should be set to TRUE.
	- Dial method should be called with the dialled number

What oFono will do:

	- Modem will be set to online.
	- Post SIM and Post online atoms are not created.
	- If the dialed number is an Emergeny number, Emergency mode is
	  activated.
	- Upon PIN enabled SIM detection, applications will be informed
	  of the pin status via PinRequired property on the
	  org.ofono.SimManager interface.
	- Once the call is ended, Emergency mode is deactivated.
	- Modem remains in online mode but the functionalities will be
	  limited.