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
17package android.hardware.radio@1.4;
18
19import @1.0::RadioIndicationType;
20import @1.3::IRadioIndication;
21
22/**
23 * Interface declaring unsolicited radio indications.
24 */
25interface IRadioIndication extends @1.3::IRadioIndication {
26    /**
27     * Report the current list of emergency numbers
28     *
29     * Each emergency number (@1.4::EmergencyNumber) in the emergency number list contains a
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.
33     *
34     * Radio must report all the valid emergency numbers with known mobile country code, mobile
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.
42     *
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.
45     *
46     * Reference: 3gpp 22.101, Section 10 - Emergency Calls;
47     *            3gpp 24.008, Section 9.2.13.4 - Emergency Number List
48     *
49     * @param type Type of radio indication
50     * @param emergencyNumberList Current list of emergency numbers known to radio.
51     */
52    oneway currentEmergencyNumberList(RadioIndicationType type,
53            vec<EmergencyNumber> emergencyNumberList);
54
55    /**
56     * Report all of the current cell information known to the radio.
57     *
58     * @param type Type of radio indication
59     * @param records Current cell information
60     */
61    oneway cellInfoList_1_4(RadioIndicationType type, vec<CellInfo> records);
62
63    /**
64     * Incremental network scan results
65     */
66    oneway networkScanResult_1_4(RadioIndicationType type, NetworkScanResult result);
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     */
76    oneway currentPhysicalChannelConfigs_1_4(RadioIndicationType type,
77            vec<PhysicalChannelConfig> configs);
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);
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);
100};
101