B4A Library Simple WIFI library

HotShoe · Mar 8, 2014

NOTICE :

I am looking for someone to take over development and maintenance on this and other libraries. I am just no longer interested in programming and don't know how long I will feel that way. Anyone interested in taking over this library or any of my others, let me know a bit about yourself by email to jem@mlsoft.org

Thanks,

--- Jem Miller

The Eclipse project and all source code has been attached below.

This is a very simple library that uses only 16 methods:

This is version 2.17. Don't panic, this version does not break anything!

I re-wrote the MACAddress method to handle Android M (API 23) and above. I also added the INTERNET and ACCESS_FINE_LOCATION permissions which seems to be required in API 23, and added a new method getAPI() that returns the version of Android running on the device as an integer.

SEE THE NEW WIFITEST EXAMPLE included in the zip file for examples of how to use this library.

MLwifi
Author: Jem Miller - Missing Link Software
Version: 2.17

MLScan
Events:
- ScanDone (Results() As String, Count As Int)
Fields:
- wifis As String[]
  A string array containing all scanned access points in the area of the device.
  These are comma separated entries consisting of the following:
  SSID, Security type, signal strength, and "Saved" if this network was previously saved for use on this device.
Methods:
- Disconnect As Boolean
  Disconnects the current wifi AP connection
  Returns True on success
- WifiCap (EntryNumber As Int) As String
  Returns a String containing info about the entry. A startScan must have already been done. The string contains the SSID, the BSSID, and the capabilities of the network access point.
  Each item is separated by a comma (SSID,BSSID,CapabilityString). The capabilities part can be quite long.
  EntryNumber - If you display the string array wifis or the array returned in the getWifiList method UNSORTED, you can pass the Position variable from your ListView_Click event.
  Otherwise, you must pass the entry number from the string array since that is what is used as a reference.
  Returns a string of comma separated entries of SSID,BSSID, and capability string. Returns an empty string on error.
- addAP (EntryNumber As Int, securityType As String, Password As String) As Boolean
  Adds an entry to the wifi manager and connects to it. This method saves the configuration of the new entry onto the device. Use the forgetAP method to delete them. Updated to handle quoted or unquoted SSID strings.
  EntryNumber - If you display the string array wifis or the array returned in the getWifiList method UNSORTED, you can pass the Position variable from your ListView_Click event.
  Otherwise, you must pass the entry number from the string array since that is what is used as a reference.
  securityType - The Access Point security type (returned in the scan result string array)
  Password - The password/phrase for the wifi access point. Pass "" for an open network. Handles WEP HEX or text phrases
  It is up to you to supply all information. The security type is found in the scan results array.
  
  Returns True if the connection is successful
- connectToAP (EntryNumber As Int) As Boolean
  Connects to a network already configured on the device. The device will use saved values to connect. Updated to handle quoted or unquoted SSID strings.
  EntryNumber - If you display the string array wifis or the array returned in the getWifiList method UNSORTED, you can pass the Position variable from your ListView_Click event.
  Otherwise, you must pass the entry number from the string array since that is what is used as a reference.
  Returns true if successful
- forgetAP (NetId As Int) As Boolean
  Forgets (erases) a stored access point on the device.
  NetId - The network ID number to forget (returned in the listSavedNetworks method)
  Returns True if successful
- getBSSID (EntryNumber As Int) As String
  Returns the BSSID for the selected entry.
  EntryNumber - If you display the string array wifis or the array returned in the getWifiList method UNSORTED, you can pass the Position variable from your ListView_Click event.
  Otherwise, you must pass the entry number from the string array since that is what is used as a reference.
- isStored (EntryNumber As Int) As Boolean
  Checks the stored networks on the device to see if this entry is a previously saved access point
  EntryNumber - The entry number in the wifis array to check. If you display the string array wifis or the array returned in the getWifiList method UNSORTED, you can pass the Position variable from your ListView_Click event.
  Otherwise, you must pass the entry number from the string array since that is what is used as a reference.
  Returns True if this is a stored network
- listSavedNetworks As List
  Builds a list of all saved networks on the device.
  Returns a comma separated list of SSID's and their BSSID and network ID number.
- startScan (EventName As String)
  Initializes all objects and scans for wifi networks. Builds a string array of results (wifis) that can be accessed directly or with a call to updateWifiList.
  THIS METHOD SHOULD ONLY BE CALLED ONCE!
- updateWifiList
  Call only after startScan has already been called and a string array of Access Points has been built. This method returns a string array containing the access points from the most recent scan, including background scans done automatically by the Android WifiManager. *
  Calls the ScanDone event when a new list is ready.
  Returns the string array of comma separated wifi access points by SSID. Each entry may contain the following:
  SSID, Security type, Signal level (in DB's), and the word "Saved" if the network was previously saved for use on this device.
Properties:
- LinkSpeed As Int [read only]
  Returns the LinkSpeed of the connected wifi access point
MLwifi
Methods:
- EnableWifi (Enabled As Boolean)
  Turns wifi on or off
  Pass True to enable wifi or False to disable.
  Example
  dim wifi as MLwifi
  wifi.EnableWifi(true)
- IpAddress As String
  Get IP address from the wifi interface)
  Returns address or empty string
- MACAddress As String
  Returns MAC address of the current interface
  
  Returns MAC address or empty string
- SSID As String
  Returns the current SSID
- WifiSignal As Int
  Returns the raw signal strength in decibels as an integer
  Returns 0 on error
- WifiStrength As Int
  Returns an integer between 0 and 100 as a percentage of signal strength
  Returns 0 on error.
- isOnLine As Boolean
  Checks for internet connection
  This method does not check or care what type of network is used.
  It can be wifi, 2g, 3g, 4g, wimax, etc. It just tests for internet connectivity.
  Returns True if internet is available.
- isWifiConnected As Boolean
  Checks if wifi is connected. This only checks for wifi connection to a router.
  It does NOT test for internet availability. Use isOnLine() for that.
  Returns True if wifi is connected or False if 2g, 3g, 4g, wimax or no connection.
Permissions:
- android.permission.ACCESS_FINE_LOCATION
- android.permission.ACCESS_NETWORK_STATE
- android.permission.ACCESS_WIFI_STATE
- android.permission.CHANGE_WIFI_STATE
- android.permission.INTERNET
Properties:
- API As Int [read only]
  Returns the current devices Android API (the version of Android running on the device.) as an integer such as 19, 21, 23, etc.

There is a small test app included and a readme file as well. The whole mess is tiny and requires no other libs.

--- Jem

Version 1.00 - Initial release.

Version 1.01 - Added EnableWifi that I forgot in the initial release.

Version 1.02 - Using a different method to find IP address.

Version 1.03 - Adds getSSID

Version 1.04 - Removed "'s from getSSID. Renamed IsWifiConnected to isWifiConnected.

Version 1.05 - Adding AP scanning.

Version 1.06 - Adds getWifiSignal and getWifiStrength

Version 1.07 - Fixed an error in the test project and forced getSSID to return an empty string instead of Null if no SSID is found.

Version 2.00 - New connection manager methods in the MLScan class. Also changed the string array returned on a scan to include more information in a comma separated list of: SSID, security type, signal strength, and the word "Saved" if this network is saved on the device.

Version 2.01 - Added a new method WifiCap(SSID). This returns a string with comma separated fields of SSID, BSSID, and network capabilities. The capabilities refers to its security protocols. I also included a new version of the wifitest app. I forgot to add it to the version 2.00 library zip file. Tapping on a listed SSID will allow you to connect to that network.

Version 2.10 - Added Disconnect, isStored, and LinkSpeed and changed the way you must call several methods.

Version 2.11 - Removed WifiList and added updateWifiList. Fixed the connectToAP and isStored methods. Added a ScanDone event to automate scan results (no more timers needed). Added error correction and more speed.

Version 2.1.2 - Updated ScanDone event to allow real time scan results.

Version 2.13 - Updated the connect methods to handle either quoted or unquoted SSID values so in theory any version of the API should now work correctly for connecting to an AP.

Version 2.14 - Fixed the ConnectToAP method (Hopefully). Also updated the wifitest app to fix a few minor bugs.

Version 2.15 - Corrected a null pointer error if wifi is turned off during operation.

Version 2.16 - Added some error checking an changed the connecttoAP method slightly. It now checks both the SSID and BSSID to ensure that correct AP is connect to.

Version 2.17 - Added permissions for API 23, Re-wrote the MACAddress method so it returns a valid MAC address on Android M OR any lower version of Android. Added the getAPI method to get the current version of Android on the device.

.

HotShoe · May 11, 2016

WiFi will normally be wlan0, so that looks correct.

Thanks.

---

NJDude said:
It seems to work.

Thanks NJ, good to see ya man.

--- Jem

MikleS · May 11, 2016

Hi HotShoe.
Great library
Please сheck connectToAP(cursel) method.
In versions 2.14 and 2.15 works perfectly.
In versions 2.16 and 2.17 is not working.

HotShoe · May 11, 2016

What android version, and does it not work on all devices? I haven't made any changes to that method in the last few updates.

MikleS · May 12, 2016

I tested on version 4.4.2 (tablet) and 5.0.2 (phone)

HotShoe · May 14, 2016

MikleS said:
I tested on version 4.4.2 (tablet) and 5.0.2 (phone)

I'll have a look over the weekend.

HotShoe · May 17, 2016

MikleS said:
Hi HotShoe.
Great library
Please сheck connectToAP(cursel) method.
In versions 2.14 and 2.15 works perfectly.
In versions 2.16 and 2.17 is not working.

Can you tell me what kind of connection you are trying? is it wep, wpa, open, etc? I am having trouble finding a problem.

--- jem

MikleS · May 18, 2016

HotShoe said:
Can you tell me what kind of connection you are trying? is it wep, wpa, open, etc? I am having trouble finding a problem.

I use wpa.

rtek1000 · Jun 5, 2016

Hello,

How find 2.15 version?

Because I did update to 2.17 and now don't work anymore!

Using Android 4.4.2

Thank you!

rtek1000 · Jun 5, 2016

Hello again,

I found 2:15 version saved here, earlier, but do not work well too.

Only 'disconnect' and 'connectToAP' works if AP is stored,

The function 'addAP' does not work if AP is not saved.

The native manager and this app below work fine:
https://play.google.com/store/apps/details?id=org.kman.WifiManager&hl=en_US

Thank you.

Alisson · Jul 4, 2016

Hello HotShoe.
I read the documentation.
How can do "forget" using function forget:

scan.forgetAP(int)

I need pass to Int, but what is the value?
I try zero, one and others. Not function.
You can help?

HotShoe · Jul 6, 2016

Alisson said:
Hello HotShoe.
I read the documentation.
How can do "forget" using function forget:

scan.forgetAP(int)

I need pass to Int, but what is the value?
I try zero, one and others. Not function.
You can help?

The Forget method uses the network ID number as described in the command help in the IDE. You can use the ListSavedNetworks method to get the netID numbers or get it from the scanned networks list.

HotShoe · Jul 6, 2016

rtek1000 said:
Hello again,

I found 2:15 version saved here, earlier, but do not work well too.

Only 'disconnect' and 'connectToAP' works if AP is stored,

The function 'addAP' does not work if AP is not saved.

The native manager and this app below work fine:
https://play.google.com/store/apps/details?id=org.kman.WifiManager&hl=en_US

Thank you.

I'll have a look at the AddAP method.

Thanks,

--- Jem

Alisson · Jul 12, 2016

Cool is use a feature to add protocol, ssid and password.
The user can pass the protocol, ssid, password and connect. Example:

AddAP(ssid,password,protocol)

I tested here your lib, good!

Thanks very much!!!

Alisson · Jul 12, 2016

HotShoe, I did a test:

B4X:

Sub scanlist_ItemClick (Position As Int, Value As Object)
    Dim tmp As String
    Dim cap As String
    Dim parts() As String
   
    cursel = Position
    cap = scan.WifiCap(cursel)
   
    parts = Regex.Split(",",cap)
   
    ssid = parts(0)
    bssid = parts(1)
   
    cap = parts(2)
   
    connectpnl.BringToFront
   
    conssidlbl.Text = "SSID = " & ssid
    conbssidlbl.Text = "BSSID = " & bssid
   
    concaplbl.Text = "Capabilities = " & cap
   
    Dim ok As Boolean
   
    ok = scan.addAP("0","WPA2","pass123")
    If ok Then
    Msgbox("Connecting to " & ssid,"Information")
   
    Else
    Msgbox("Could not connect to " & ssid,"Information")
   
   
    End If
   
End Sub

The function to click and get the Position, put:

ok = scan.addAP("0","WPA2","pass123")

After forget the network1 and connect to network2.
I use the network2 to conect in network1, but not connect to network1.

HotShoe, what can I do?

I wait your feedback!

Thanks!

JohnC · Jul 27, 2016

When it does a scan, is there any way it can include any wifi "adapters" it sees, not just "Access Points"?

Meaning, I would like to see "client" devices, like other Android phones nearby in a given area - I believe these devices are related to as "Ad-Hoc" devices.

I do NOT need to connect to them, I just want to be able to read the signal strength of them.

Declan · Aug 16, 2016

Hi, I am running mlwifi-2.7 example on an tablet with Android V5.1
When I select the wifi device from the scan list, the "Connect / Close" screen is displayed.
But, it is unloaded before I have a chance to select the "Connect" Button.

HotShoe · Aug 30, 2016

I am no longer interested in programming and woul like to find someone that knows Java and B4A to take over this and other libraries. It isn't fair to the B4A community to abandon popular libs just because I am fighting programmers burn out. If you are interested, please tell me a bit about yourself via email to me at jem@mlsoft.org. I won't release the source to just anyone.

--- Jem

techknight · Sep 23, 2016

Why does this lib need Fine location access??

Davin · Nov 4, 2016

MikleS said:
Hi HotShoe.
Great library
Please сheck connectToAP(cursel) method.
In versions 2.14 and 2.15 works perfectly.
In versions 2.16 and 2.17 is not working.

do you stil have ver 2.14 or 2.15 ?

anyone ?

thanks

rtek1000 · Dec 8, 2016

Hello,

I'm sorry to hear that you can not continue in this library any more.

I would like to suggest that the source code be sent to @Erel.

We all know that the android app can be easily reversed.

And also the library, myself without knowing much I've been changing something even without having the source code.

You have done a great job, thank you very much.

HotShoe said:
I am no longer interested in programming and woul like to find someone that knows Java and B4A to take over this and other libraries. It isn't fair to the B4A community to abandon popular libs just because I am fighting programmers burn out. If you are interested, please tell me a bit about yourself via email to me at jem@mlsoft.org. I won't release the source to just anyone.

--- Jem

B4A Library Simple WIFI library

Attachments

Well-Known Member

Member

Well-Known Member

Member

Well-Known Member

Well-Known Member

Member

Active Member

Active Member

Active Member

Well-Known Member

Well-Known Member

Active Member

Active Member

Expert

Well-Known Member

Well-Known Member

Well-Known Member

Member

Active Member

Similar Threads

Privacy & Transparency

Privacy & Transparency