Wln Object

object_wln

The wln. object represents the Wi-Fi interface of your device. It is through this object that you find available Wi-Fi networks and select the one to associate with. You can also create a network of your own and have other Wi-Fi stations connect to it.

Supported hardware

The wln. object works with Tibbo's GA1000 and WA2000 devices:

• The GA1000 is our original Wi-Fi add-on module supporting 802.11b/g (2.4GHz) communications.

• The WA2000 is a our new Wi-Fi/BLE add-on module implementing 802.11a/b/g/n (2.4/5.0GHz), as well as BLE4.2 communications. The BLE (Bluetooth low-energy) part of the WA2000 is controlled through a separate bt. (Bluetooth) object .

Since the GA1000 has been around for a long time, and the WA2000 is a newer device that many of our users may be unfamiliar with, we have prepared a quick-reference page that lists all the differences between the WA2000 and the GA1000.  

The GA1000 and WA2000 are documented in our Programmable Hardware Manual.

What does the wln. object do?

The wln. object is not responsible for data communications over the Wi-Fi interface — this is the job of the sock. object.

On platforms with Wi-Fi support, you will find the Wi-Fi interface listed or available on the following sock. object's properties:

Sock.availableinterfaces

Sock.allowedinterfaces

Sock.currentinterface

Sock.targetinterface

In the job it performs, the wln. object is similar to the net object, which controls the Ethernet interface of your device. In comparison, the wln. object is quite a bit more complex.

note_tip-wt

You can avoid dealing with the complexity of Wi-Fi by using our WLN library. The library handles the tasks of bringing up the Wi-Fi unterface, finding the specified access point (AP), and associating with it using selected security protocol. The library also offers other convenient "services".

The wln. object allows you to...

• Scan for available networks and obtain their parameters such as name, channel, mode, etc. "Hidden networks" (those that do not broadcast their SSID) can also be discovered.

• Set WEP, WPA-PSK, or WPA2-PSK security modes and related keys* .

• Associate with a wireless network (access point).

• Detect disassociation from a wireless network (access point).

• Start your device's own network.

• Monitor received signal strength.

• Detect power-downs and malfunctions of the Wi-Fi module.

  • For the GA1000 module, a part of the required WPA/WPA2 functionality (pre-shared key calculation) is implemented in the WLN library . The WA2000 device calculates the key internally and does not require any outside help.