wifi.h revision 745e7fd4e09db2b47371338ee54c54255e286473
1cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project/* 2cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * Copyright (C) 2008 The Android Open Source Project 3cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * 4cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 5cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * you may not use this file except in compliance with the License. 6cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * You may obtain a copy of the License at 7cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * 8cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 9cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * 10cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 11cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 12cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * See the License for the specific language governing permissions and 14cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * limitations under the License. 15cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project */ 16cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project 17cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project#ifndef _WIFI_H 18cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project#define _WIFI_H 19cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project 20cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project#if __cplusplus 21cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Projectextern "C" { 22cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project#endif 23cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project 24cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project/** 25cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * Load the Wi-Fi driver. 26cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * 27cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * @return 0 on success, < 0 on failure. 28cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project */ 29cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Projectint wifi_load_driver(); 30cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project 31cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project/** 32cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * Unload the Wi-Fi driver. 33cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * 34cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * @return 0 on success, < 0 on failure. 35cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project */ 36cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Projectint wifi_unload_driver(); 37cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project 38cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project/** 392bb990bfd2580f9be93a413e3a5325057977a828Irfan Sheriff * Check if the Wi-Fi driver is loaded. 402bb990bfd2580f9be93a413e3a5325057977a828Irfan Sheriff * 412bb990bfd2580f9be93a413e3a5325057977a828Irfan Sheriff * @return 0 on success, < 0 on failure. 422bb990bfd2580f9be93a413e3a5325057977a828Irfan Sheriff */ 432bb990bfd2580f9be93a413e3a5325057977a828Irfan Sheriffint is_wifi_driver_loaded(); 442bb990bfd2580f9be93a413e3a5325057977a828Irfan Sheriff 452bb990bfd2580f9be93a413e3a5325057977a828Irfan Sheriff 462bb990bfd2580f9be93a413e3a5325057977a828Irfan Sheriff/** 47cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * Start supplicant. 48cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * 49cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * @return 0 on success, < 0 on failure. 50cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project */ 51096e49c869cdb297f1ea99289ae44c2a0e487fcfIrfan Sheriffint wifi_start_supplicant(int p2pSupported); 5267ba2276b9a5232685e14d416fea0b1250515594Irfan Sheriff 5367ba2276b9a5232685e14d416fea0b1250515594Irfan Sheriff/** 54cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * Stop supplicant. 55cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * 56cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * @return 0 on success, < 0 on failure. 57cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project */ 58745e7fd4e09db2b47371338ee54c54255e286473Irfan Sheriffint wifi_stop_supplicant(int p2pSupported); 59cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project 60cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project/** 61da52930b89bb0e03948f3981e75f8727ea023587Irfan Sheriff * Open a connection to supplicant on interface 62cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * 63cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * @return 0 on success, < 0 on failure. 64cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project */ 65da52930b89bb0e03948f3981e75f8727ea023587Irfan Sheriffint wifi_connect_to_supplicant(const char *ifname); 66cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project 67cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project/** 68da52930b89bb0e03948f3981e75f8727ea023587Irfan Sheriff * Close connection to supplicant on interface 69cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * 70cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * @return 0 on success, < 0 on failure. 71cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project */ 72da52930b89bb0e03948f3981e75f8727ea023587Irfan Sheriffvoid wifi_close_supplicant_connection(const char *ifname); 73cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project 74cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project/** 75cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * wifi_wait_for_event() performs a blocking call to 76cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * get a Wi-Fi event and returns a string representing 77cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * a Wi-Fi event when it occurs. 78cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * 79da52930b89bb0e03948f3981e75f8727ea023587Irfan Sheriff * @param iface is the interface on which event is received 80cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * @param buf is the buffer that receives the event 81cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * @param len is the maximum length of the buffer 82cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * 83cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * @returns number of bytes in buffer, 0 if no 84cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * event (for instance, no connection), and less than 0 85cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * if there is an error. 86cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project */ 87da52930b89bb0e03948f3981e75f8727ea023587Irfan Sheriffint wifi_wait_for_event(const char *iface, char *buf, size_t len); 88cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project 89cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project/** 90cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * wifi_command() issues a command to the Wi-Fi driver. 91cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * 92da52930b89bb0e03948f3981e75f8727ea023587Irfan Sheriff * Android extends the standard commands listed at 93da52930b89bb0e03948f3981e75f8727ea023587Irfan Sheriff * /link http://hostap.epitest.fi/wpa_supplicant/devel/ctrl_iface_page.html 94cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * to include support for sending commands to the driver: 95cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * 96da52930b89bb0e03948f3981e75f8727ea023587Irfan Sheriff * See wifi/java/android/net/wifi/WifiNative.java for the details of 97da52930b89bb0e03948f3981e75f8727ea023587Irfan Sheriff * driver commands that are supported 98cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * 99da52930b89bb0e03948f3981e75f8727ea023587Irfan Sheriff * @param iface is the interface on which command is sent 100cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * @param command is the string command 101cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * @param reply is a buffer to receive a reply string 102cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * @param reply_len on entry, this is the maximum length of 103cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * the reply buffer. On exit, the number of 104cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * bytes in the reply buffer. 105cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * 106cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * @return 0 if successful, < 0 if an error. 107cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project */ 108da52930b89bb0e03948f3981e75f8727ea023587Irfan Sheriffint wifi_command(const char *iface, const char *command, char *reply, size_t *reply_len); 109cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project 110cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project/** 111cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * do_dhcp_request() issues a dhcp request and returns the acquired 112cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * information. 113cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * 114cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * All IPV4 addresses/mask are in network byte order. 115cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * 116cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * @param ipaddr return the assigned IPV4 address 117cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * @param gateway return the gateway being used 118cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * @param mask return the IPV4 mask 119cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * @param dns1 return the IPV4 address of a DNS server 120cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * @param dns2 return the IPV4 address of a DNS server 121cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * @param server return the IPV4 address of DHCP server 122cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * @param lease return the length of lease in seconds. 123cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * 124cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * @return 0 if successful, < 0 if error. 125cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project */ 126cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Projectint do_dhcp_request(int *ipaddr, int *gateway, int *mask, 127cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project int *dns1, int *dns2, int *server, int *lease); 128cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project 129cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project/** 130cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project * Return the error string of the last do_dhcp_request(). 131cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project */ 132cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Projectconst char *get_dhcp_error_string(); 133cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project 1344b7ffa08be8d58932841c52ce253ae6ca886a4f2Dmitry Shmidt/** 1354b7ffa08be8d58932841c52ce253ae6ca886a4f2Dmitry Shmidt * Return the path to requested firmware 1364b7ffa08be8d58932841c52ce253ae6ca886a4f2Dmitry Shmidt */ 1374b7ffa08be8d58932841c52ce253ae6ca886a4f2Dmitry Shmidt#define WIFI_GET_FW_PATH_STA 0 1384b7ffa08be8d58932841c52ce253ae6ca886a4f2Dmitry Shmidt#define WIFI_GET_FW_PATH_AP 1 1394b7ffa08be8d58932841c52ce253ae6ca886a4f2Dmitry Shmidt#define WIFI_GET_FW_PATH_P2P 2 1404b7ffa08be8d58932841c52ce253ae6ca886a4f2Dmitry Shmidtconst char *wifi_get_fw_path(int fw_type); 1414b7ffa08be8d58932841c52ce253ae6ca886a4f2Dmitry Shmidt 14229a4d4d74b512e450a7d2ae97d4222c24a13b87eDmitry Shmidt/** 14329a4d4d74b512e450a7d2ae97d4222c24a13b87eDmitry Shmidt * Change the path to firmware for the wlan driver 14429a4d4d74b512e450a7d2ae97d4222c24a13b87eDmitry Shmidt */ 14529a4d4d74b512e450a7d2ae97d4222c24a13b87eDmitry Shmidtint wifi_change_fw_path(const char *fwpath); 14629a4d4d74b512e450a7d2ae97d4222c24a13b87eDmitry Shmidt 1473ab3e6696757541c098a251981c074fc980f4dc7Dmitry Shmidt/** 1483ab3e6696757541c098a251981c074fc980f4dc7Dmitry Shmidt * Check and create if necessary initial entropy file 1493ab3e6696757541c098a251981c074fc980f4dc7Dmitry Shmidt */ 1503ab3e6696757541c098a251981c074fc980f4dc7Dmitry Shmidt#define WIFI_ENTROPY_FILE "/data/misc/wifi/entropy.bin" 1513ab3e6696757541c098a251981c074fc980f4dc7Dmitry Shmidtint ensure_entropy_file_exists(); 1523ab3e6696757541c098a251981c074fc980f4dc7Dmitry Shmidt 153cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project#if __cplusplus 154cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project}; // extern "C" 155cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project#endif 156cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project 157cc490161f6af9e4a6842ee827e4bfc43bc4509d5The Android Open Source Project#endif // _WIFI_H 158