类

class network.WLAN(interface_id)

    interface_id：
        network.STA_IF — 客户端，连接到上游WiFi接入点
        network.AP_IF — 接入点，允许其他WiFi客户端连接

定义WLAN

import network

wlan = network.WLAN(network.STA_IF)    #创建WLAN对象

函数

1. wlan.active(is_active)

函数说明：带有参数时，为是否激活界面，不带参数为查询当前状态。

    is_active：是否激活
        True — 激活（“up”）网络接口
        False — 停用（“down”）网络接口

2. wlan.scan()

函数说明：扫描可用的无线网络（仅在STA接口上进行扫描），返回有关WiFi接入点信息的元组列表。

    (ssid，bssid，channel，RSSI，authmode，hidden)
        bssid：接入点的硬件地址，以二进制形式返回为字节对象。您可以使用ubinascii.hexlify()将其转换为ASCII格式
       authmode：
            AUTH_OPEN = 0
            AUTH_WEP = 1
            AUTH_WPA_PSK = 2
            AUTH_WPA2_PSK = 3
            AUTH_WPA_WPA2_PSK = 4
            AUTH_MAX = 6 
        hidden：
            False — 可见
            True — 隐藏

3. wlan.isconnected()

函数说明：检查站点是否连接到AP。在STA模式下，如果连接到WiFi接入点并具有有效的IP地址则返回True，否则返回False。在AP模式下，当站点连接时返回True，否则返回False。

4. wlan.connect(ssid, password)

函数说明：连接到无线网络。

    ssid：WiFi名称
    password：WiFi密码

5. wlan.config(essid, channel)

函数说明：获取接口的MAC adddress或者设置WiFi接入点名称和WiFi通道。

    ssid：WiFi账户名
    channel：WiFi通道

6. wlan.ifconfig([(ip, subnet, gateway, dns)])

函数说明：不带参数时，返回一个4元组(ip, subnet_mask, gateeway, DNS_server)。

ip：IP地址
subnet_mask：子网掩码
gateway：网关
DNS_server：DNS服务器

带参数时，配置静态IP。例如

wlan.ifconfig(config = ('192.168.0.4', '255.255.255.0', '192.168.0.1', '8.8.8.8')

7. wlan.disconnect()

函数说明：断开与当前连接的无线网络的连接。

8. wlan.status()

函数说明：返回无线连接的当前状态。

示例

1. 作为客户端连接WiFi

import network

SSID = "yourSSID"                  #WiFi名称
PASSWORD = "yourPASSWD"            #WiFi密码

wlan = network.WLAN(network.STA_IF)  #创建WLAN对象
wlan.active(True)                  #激活界面
wlan.scan()                        #扫描接入点
wlan.isconnected()                 #检查站点是否连接到AP
wlan.connect(SSID, PASSWORD)       #连接到AP
wlan.config('mac')                 #获取接口的MAC adddress
wlan.ifconfig()                    #获取接口的IP/netmask/gw/DNS地址

2. 作为接入开启WiFi

import network

ap = network.WLAN(network.AP_IF)     #创建接入点界面
ap.active(True)                      #激活界面
ap.config(essid='ESP-AP',channel=1)  #设置接入点的ESSID，和WiFi 通道

3. 连接到本地WiFi网络

import network

wlan = network.WLAN(network.STA_IF)
wlan.active(True)
if not wlan.isconnected():
  print('connecting to network...')
  wlan.connect('SSID', 'PASSWORD')   #连接到AP
     #'SSID'： WiFi账号名
     #'PASSWORD'：WiFi密码
  while not wlan.isconnected():
    pass
print('network config:', wlan.ifconfig())

3.3.1 WLAN

类