1/*
2 * Copyright (C) 2008 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 _WIFI_H
18#define _WIFI_H
19
20#if __cplusplus
21extern "C" {
22#endif
23
24/**
25 * Load the Wi-Fi driver.
26 *
27 * @return 0 on success, < 0 on failure.
28 */
29int wifi_load_driver();
30
31/**
32 * Unload the Wi-Fi driver.
33 *
34 * @return 0 on success, < 0 on failure.
35 */
36int wifi_unload_driver();
37
38/**
39 * Check if the Wi-Fi driver is loaded.
40 *
41 * @return 0 on success, < 0 on failure.
42 */
43int is_wifi_driver_loaded();
44
45
46/**
47 * Start supplicant.
48 *
49 * @return 0 on success, < 0 on failure.
50 */
51int wifi_start_supplicant(int p2pSupported);
52
53/**
54 * Stop supplicant.
55 *
56 * @return 0 on success, < 0 on failure.
57 */
58int wifi_stop_supplicant(int p2pSupported);
59
60/**
61 * Open a connection to supplicant
62 *
63 * @return 0 on success, < 0 on failure.
64 */
65int wifi_connect_to_supplicant();
66
67/**
68 * Close connection to supplicant
69 *
70 * @return 0 on success, < 0 on failure.
71 */
72void wifi_close_supplicant_connection();
73
74/**
75 * wifi_wait_for_event() performs a blocking call to
76 * get a Wi-Fi event and returns a string representing
77 * a Wi-Fi event when it occurs.
78 *
79 * @param buf is the buffer that receives the event
80 * @param len is the maximum length of the buffer
81 *
82 * @returns number of bytes in buffer, 0 if no
83 * event (for instance, no connection), and less than 0
84 * if there is an error.
85 */
86int wifi_wait_for_event(char *buf, size_t len);
87
88/**
89 * wifi_command() issues a command to the Wi-Fi driver.
90 *
91 * Android extends the standard commands listed at
92 * /link http://hostap.epitest.fi/wpa_supplicant/devel/ctrl_iface_page.html
93 * to include support for sending commands to the driver:
94 *
95 * See wifi/java/android/net/wifi/WifiNative.java for the details of
96 * driver commands that are supported
97 *
98 * @param command is the string command (preallocated with 32 bytes)
99 * @param commandlen is command buffer length
100 * @param reply is a buffer to receive a reply string
101 * @param reply_len on entry, this is the maximum length of
102 *        the reply buffer. On exit, the number of
103 *        bytes in the reply buffer.
104 *
105 * @return 0 if successful, < 0 if an error.
106 */
107int wifi_command(const char *command, char *reply, size_t *reply_len);
108
109/**
110 * do_dhcp_request() issues a dhcp request and returns the acquired
111 * information.
112 *
113 * All IPV4 addresses/mask are in network byte order.
114 *
115 * @param ipaddr return the assigned IPV4 address
116 * @param gateway return the gateway being used
117 * @param mask return the IPV4 mask
118 * @param dns1 return the IPV4 address of a DNS server
119 * @param dns2 return the IPV4 address of a DNS server
120 * @param server return the IPV4 address of DHCP server
121 * @param lease return the length of lease in seconds.
122 *
123 * @return 0 if successful, < 0 if error.
124 */
125int do_dhcp_request(int *ipaddr, int *gateway, int *mask,
126                   int *dns1, int *dns2, int *server, int *lease);
127
128/**
129 * Return the error string of the last do_dhcp_request().
130 */
131const char *get_dhcp_error_string();
132
133/**
134 * Return the path to requested firmware
135 */
136#define WIFI_GET_FW_PATH_STA	0
137#define WIFI_GET_FW_PATH_AP	1
138#define WIFI_GET_FW_PATH_P2P	2
139const char *wifi_get_fw_path(int fw_type);
140
141/**
142 * Change the path to firmware for the wlan driver
143 */
144int wifi_change_fw_path(const char *fwpath);
145
146/**
147 * Check and create if necessary initial entropy file
148 */
149#define WIFI_ENTROPY_FILE	"/data/misc/wifi/entropy.bin"
150int ensure_entropy_file_exists();
151
152#if __cplusplus
153};  // extern "C"
154#endif
155
156#endif  // _WIFI_H
157