1 /*
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 
17 #ifndef CHPP_WWAN_CLIENT_H_
18 #define CHPP_WWAN_CLIENT_H_
19 
20 #include <stddef.h>
21 #include <stdint.h>
22 
23 #include "chpp/app.h"
24 #include "chpp/clients.h"
25 
26 #ifdef __cplusplus
27 extern "C" {
28 #endif
29 
30 /************************************************
31  *  Public Definitions
32  ***********************************************/
33 
34 /************************************************
35  *  Public functions
36  ***********************************************/
37 
38 /**
39  * Called by the App layer to register the WWAN (cellular) common client.
40  *
41  * @param appContext Maintains status for each app layer instance.
42  */
43 void chppRegisterWwanClient(struct ChppAppState *appContext);
44 
45 /**
46  * Called by the App layer to deregister the WWAN (cellular) common client.
47  *
48  * @param appContext Maintains status for each app layer instance.
49  */
50 void chppDeregisterWwanClient(struct ChppAppState *appContext);
51 
52 /**
53  * @return The ChppClientState pointer to the WWAN client.
54  */
55 struct ChppClientState *getChppWwanClientState(void);
56 
57 #ifndef CHPP_CLIENT_ENABLED_CHRE_WWAN
58 /**
59  * Alternative to chrePalWwanGetApi() to avoid conflicting with CHPP service.
60  */
61 const struct chrePalWwanApi *chppPalWwanGetApi(uint32_t requestedApiVersion);
62 #endif
63 
64 #ifdef __cplusplus
65 }
66 #endif
67 
68 #endif  // CHPP_WWAN_CLIENT_H_
69