Ameba MicroPython: [RTL8722CSM] [RTL8722DM] WiFi

class WLAN – 无线网络WLAN

示例

WiFi 扫描:

• 准备材料: Ameba x 1

• 步骤: WiFi Scan 能帮助我们更快的发现周围的WiFi网路。这个示例没有额外的硬件要求。复制下面的代码至REPL来观察结果。

from wireless import WLAN
wifi = WLAN(mode = WLAN.STA)
wifi.scan()

WiFi 连接:

• 准备材料: Ameba x 1

• 步骤: Ameba 可以连接到WPA2和open配置的无线路由器，大多数的路由器都有支援这些安全协议。复制下面的代码至REPL，修改ssid和pswd成你的wifi的名称和密码，并观察其结果。

from wireless import WLAN
wifi = WLAN(mode = WLAN.STA)
wifi.connect(ssid = "YourWiFiName", pswd = "YourWiFiPassword")

API 文件

构造函数

WLAN(mode [必填])

创建一个WLAN对象，然后设定对应的模式，之后可以对WiFi进行控制和查看状态。

• mode: WLAN.STA 是station 模式

方法

WLAN.scan()

搜索和列出周围所有的WiFi网路

WLAN.connect(ssid [必填], pswd [选填], security [选填])

建立连接至WiFi网路

• ssid: WiFi 网路的名称

• pswd: WiFi网路的密码

• security: WiFi网路的安全协议

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

Parameter	Default value
pswd	NULL
security	WPA2_AES_PSK

Note: 如果连接OPEN的网路，可以忽视参数’pswd’，然后在ssid后面输入”security = WLAN.OPEN”。

WLAN.get_ip()

成功连接至AP后返还当前WLAN介面的IP地址。

WLAN.disconnect()

从当前连接的网路断开连接，但是WiFi模组还在运行

WLAN.on()

启动WiFi

WLAN.off()

关闭WiFi并且断开所有连接

WLAN.wifi_is_running()

返还WiFi的状态，WiFi启动后返还True，WiFi关闭返还False

WLAN.is_connect_to_ap()

返还连接状态，连接到AP后返还True，如果没有任何连接返还False