1/*
2 * Copyright 2019 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.wifi@1.4;
18
19import @1.0::WifiStatus;
20import @1.0::IWifiIface;
21import @1.3::IWifiChip;
22import IWifiChipEventCallback;
23import IWifiRttController;
24
25/**
26 * Interface that represents a chip that must be configured as a single unit.
27 */
28interface IWifiChip extends @1.3::IWifiChip {
29    /**
30     * Requests notifications of significant events on this chip. Multiple calls
31     * to this must register multiple callbacks each of which must receive all
32     * events.
33     *
34     * @param callback An instance of the |IWifiChipEventCallback| HIDL interface
35     *        object.
36     * @return status WifiStatus of the operation.
37     *         Possible status codes:
38     *         |WifiStatusCode.SUCCESS|,
39     *         |WifiStatusCode.ERROR_NOT_SUPPORTED|,
40     *         |WifiStatusCode.ERROR_WIFI_CHIP_INVALID|
41     */
42    registerEventCallback_1_4(IWifiChipEventCallback callback) generates (WifiStatus status);
43
44    /**
45     * Create a RTTController instance.
46     *
47     * RTT controller can be either:
48     * a) Bound to a specific iface by passing in the corresponding |IWifiIface|
49     * object in |iface| param, OR
50     * b) Let the implementation decide the iface to use for RTT operations by
51     * passing null in |iface| param.
52     *
53     * @param boundIface HIDL interface object representing the iface if
54     *        the responder must be bound to a specific iface, null otherwise.
55     * @return status WifiStatus of the operation.
56     *         Possible status codes:
57     *         |WifiStatusCode.SUCCESS|,
58     *         |WifiStatusCode.ERROR_WIFI_CHIP_INVALID|
59     */
60    createRttController_1_4(IWifiIface boundIface)
61        generates (WifiStatus status, IWifiRttController rtt);
62};
63