blob: f195c0e665013cea1ebd3636d4b0b618995201f9 [file] [log] [blame]
Jayachandran C262b6062020-07-22 15:53:58 -07001/*
2 * Copyright (C) 2020 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.6;
18
Jayachandran C9bc276b2020-07-24 00:46:58 -070019import @1.0::RadioIndicationType;
Jayachandran C262b6062020-07-22 15:53:58 -070020import @1.5::IRadioIndication;
Sooraj Sasindran43e52202020-10-22 15:24:14 -070021import @1.6::SetupDataCallResult;
22import @1.6::LinkCapacityEstimate;
Jayachandran C262b6062020-07-22 15:53:58 -070023
24/**
25 * Interface declaring unsolicited radio indications.
26 */
27interface IRadioIndication extends @1.5::IRadioIndication {
Jayachandran C9bc276b2020-07-24 00:46:58 -070028
29 /**
30 * Indicates data call contexts have changed.
31 *
32 * This indication is updated from IRadioIndication@1.5 to report the @1.6 version of
33 * SetupDataCallResult.
34 *
35 * @param type Type of radio indication
36 * @param dcList Array of SetupDataCallResult identical to that returned by
37 * IRadio.getDataCallList(). It is the complete list of current data contexts including
38 * new contexts that have been activated. A data call is only removed from this list
39 * when any of the below conditions is matched.
40 * 1. The framework sends a IRadio.deactivateDataCall().
41 * 2. The radio is powered off/on.
42 * 3. Unsolicited disconnect from either modem or network side.
43 */
44 oneway dataCallListChanged_1_6(RadioIndicationType type, vec<SetupDataCallResult> dcList);
Daniel Bright95db21d2020-10-28 15:24:20 -070045
46 /**
47 * The modem can explicitly set SetupDataCallResult::suggestedRetryTime after a failure in
48 * IRadio@1.6::SetupDataCall. During that time, no new calls are allowed to
49 * IRadio@1.6::SetupDataCall that use the same APN.
50 *
51 * When IRadioIndication@1.6::unthrottleApn is sent, AOSP will no longer throttle calls
52 * to IRadio@1.6::SetupDataCall for the given APN.
53 *
54 * @param type Type of radio indication
55 * @param apn Apn to unthrottle
56 */
57 oneway unthrottleApn(RadioIndicationType type, string apn);
Sooraj Sasindran43e52202020-10-22 15:24:14 -070058
59 /**
60 * Indicates current link capacity estimate.
61 * This replaces @1.2::IRadioIndication.currentLinkCapacityEstimate().
62 * This indication is sent whenever the reporting criteria, as set by
63 * @1.2::IRadio.setLinkCapacityReportingCriteria, are met and the indication is not
64 * suppressed by @1.2::IRadio.setIndicationFilter_1_2().
65 *
66 * @param type Type of radio indication
67 * @param lce LinkCapacityEstimate
68 */
69 oneway currentLinkCapacityEstimate_1_6(RadioIndicationType type, LinkCapacityEstimate lce);
Jayachandran C262b6062020-07-22 15:53:58 -070070};