WiFi

API 文檔

Constructors

WLAN(mode[required])
创建一个WLAN对象,然后设定对应的模式,之后可以对WiFi进行控制和查看状态。
  • mode: WLAN.STA 是 station 模式

方法

WLAN.scan()
搜索和列出周围所有的WiFi网络
WLAN.connect(ssid[required], pswd[optional], security[optional])
建立连接至WiFi网络
  • ssid: WiFi 网络的名称

  • pswd: WiFi网络的密码

  • security: WiFi网络的安全协议

備註

如果没有填写选填的参数,会使用下面的预设数值。

参数

默认值

pswd

NULL

security

WPA2_AES_PSK

備註

如果连接 OPEN 的网络,可以忽视参数 pswd
然后在ssid后面输入 security = WLAN.OPEN
WLAN.get_ip()
成功连接至AP后返还当前WLAN接口的IP地址。
WLAN.disconnect()
从当前连接的网络断开连接,但是WiFi模块还在运行
WLAN.on()
This method turns on the WiFi device.
WLAN.off()
关闭WiFi并且断开所有连接
WLAN.wifi_is_running()
返还WiFi的状态,WiFi启动后返还True,WiFi关闭返还False
WLAN.is_connect_to_ap()
返还连接状态,连接到AP后返还True,如果没有任何连接返还False