Google Git
Sign in
android / platform / hardware / interfaces / refs/heads/main / . / radio / 1.4 / IRadioIndication.hal
blob: f4d3ba946e2bb477f813072bcb37e3c93aa72c8a [file] [log] [blame]
sqian8ffbfa52018-08-29 20:26:03 -0700[diff] [blame]1/*
2 * Copyright (C) 2018 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
Malcolm Chen638f0052018-11-26 13:11:03 -0800[diff] [blame]17package android.hardware.radio@1.4;
sqian8ffbfa52018-08-29 20:26:03 -0700[diff] [blame]18
19import @1.0::RadioIndicationType;
Malcolm Chen638f0052018-11-26 13:11:03 -0800[diff] [blame]20import @1.3::IRadioIndication;
sqian8ffbfa52018-08-29 20:26:03 -0700[diff] [blame]21
22/**
23 * Interface declaring unsolicited radio indications.
24 */
Malcolm Chen638f0052018-11-26 13:11:03 -0800[diff] [blame]25interface IRadioIndication extends @1.3::IRadioIndication {
sqian8ffbfa52018-08-29 20:26:03 -0700[diff] [blame]26 /**
sqian968f5312018-09-19 14:10:42 -0700[diff] [blame]27 * Report the current list of emergency numbers
sqian8ffbfa52018-08-29 20:26:03 -0700[diff] [blame]28 *
Malcolm Chen638f0052018-11-26 13:11:03 -0800[diff] [blame]29 * Each emergency number (@1.4::EmergencyNumber) in the emergency number list contains a
sqian99004cd2019-01-09 18:19:37 -0800[diff] [blame]30 * dialing number, zero or more service category(s), zero or more emergency uniform resource
31 * names, mobile country code, mobile network code, and source(s) that indicate where it comes
32 * from.
sqian8ffbfa52018-08-29 20:26:03 -0700[diff] [blame]33 *
sqian61424082018-12-18 21:34:32 -0800[diff] [blame]34 * Radio must report all the valid emergency numbers with known mobile country code, mobile
sqian99004cd2019-01-09 18:19:37 -0800[diff] [blame]35 * network code, emergency service categories, and emergency uniform resource names from all
36 * available sources including network signaling, sim, modem/oem configuration, and default
37 * configuration (112 and 911 must be always available; additionally, 000, 08, 110, 999, 118
38 * and 119 must be available when sim is not present). Radio shall not report emergency numbers
39 * that are invalid in the current locale. The reported emergency number list must not have
40 * duplicate @1.4::EmergencyNumber entries. Please refer the documentation of
41 * @1.4::EmergencyNumber to construct each emergency number to report.
sqian8ffbfa52018-08-29 20:26:03 -0700[diff] [blame]42 *
sqian968f5312018-09-19 14:10:42 -0700[diff] [blame]43 * Radio must report the complete list of emergency numbers whenever the emergency numbers in
44 * the list are changed or whenever the client and the radio server are connected.
sqian8ffbfa52018-08-29 20:26:03 -0700[diff] [blame]45 *
sqian99004cd2019-01-09 18:19:37 -0800[diff] [blame]46 * Reference: 3gpp 22.101, Section 10 - Emergency Calls;
47 * 3gpp 24.008, Section 9.2.13.4 - Emergency Number List
sqian8ffbfa52018-08-29 20:26:03 -0700[diff] [blame]48 *
49 * @param type Type of radio indication
sqian968f5312018-09-19 14:10:42 -0700[diff] [blame]50 * @param emergencyNumberList Current list of emergency numbers known to radio.
sqian8ffbfa52018-08-29 20:26:03 -0700[diff] [blame]51 */
52 oneway currentEmergencyNumberList(RadioIndicationType type,
53 vec<EmergencyNumber> emergencyNumberList);
Pengquan Meng1d4e8ae2018-11-07 16:22:32 -0800[diff] [blame]54
55 /**
Pengquan Meng16ad3c22019-02-05 17:37:54 -0800[diff] [blame]56 * Report all of the current cell information known to the radio.
Pengquan Meng1d4e8ae2018-11-07 16:22:32 -0800[diff] [blame]57 *
58 * @param type Type of radio indication
59 * @param records Current cell information
60 */
Malcolm Chen638f0052018-11-26 13:11:03 -0800[diff] [blame]61 oneway cellInfoList_1_4(RadioIndicationType type, vec<CellInfo> records);
Pengquan Meng1d4e8ae2018-11-07 16:22:32 -0800[diff] [blame]62
63 /**
64 * Incremental network scan results
65 */
Malcolm Chen638f0052018-11-26 13:11:03 -0800[diff] [blame]66 oneway networkScanResult_1_4(RadioIndicationType type, NetworkScanResult result);
Pengquan Meng76876502018-11-14 19:33:25 -0800[diff] [blame]67
68 /**
69 * Indicates physical channel configurations.
70 *
71 * An empty configs list indicates that the radio is in idle mode.
72 *
73 * @param type Type of radio indication
74 * @param configs Vector of PhysicalChannelConfigs
75 */
Malcolm Chen638f0052018-11-26 13:11:03 -0800[diff] [blame]76 oneway currentPhysicalChannelConfigs_1_4(RadioIndicationType type,
Pengquan Meng76876502018-11-14 19:33:25 -0800[diff] [blame]77 vec<PhysicalChannelConfig> configs);
paulhu31aed672018-12-18 19:30:16 +0800[diff] [blame]78
79 /**
80 * Indicates data call contexts have changed.
81 *
82 * @param type Type of radio indication
83 * @param dcList Array of SetupDataCallResult identical to that returned by
84 * IRadio.getDataCallList(). It is the complete list of current data contexts including
85 * new contexts that have been activated. A data call is only removed from this list
86 * when below conditions matched.
87 * 1. The framework sends a IRadio.deactivateDataCall().
88 * 2. The radio is powered off/on.
89 * 3. Unsolicited disconnect from either modem or network side.
90 */
91 oneway dataCallListChanged_1_4(RadioIndicationType type, vec<SetupDataCallResult> dcList);
Pengquan Menge32a7552019-01-28 16:38:10 -0800[diff] [blame]92
93 /**
94 * Indicates current signal strength of the radio.
95 *
96 * @param type Type of radio indication
97 * @param signalStrength SignalStrength information
98 */
99 oneway currentSignalStrength_1_4(RadioIndicationType type, SignalStrength signalStrength);
paulhu31aed672018-12-18 19:30:16 +0800[diff] [blame]100};