注意

这是最新开发分支配套的文档,可能包含已发布版本中尚未提供的功能。如果您要查看特定版本的文档,请使用左侧的下拉菜单并选择所需要的版本。

使用无线网例程讲解#

概述#

本教程将指导您如何在 CanMV 使用 MicroPython 的 network 模块进行无线网络( WiFi)的基本操作,包括作为站点( STA)连接到无线访问点( AP)和创建自己的访问点( AP)。

  • sta_test(): 演示了如何作为站点( STA)连接到无线网络,包括查看当前连接状态、扫描可用网络、连接特定 AP、查看 IP 配置以及断开连接。

  • ap_test(): 展示了如何配置并启动一个无线访问点( AP),包括设置 SSID、信道和密码,并检查 AP 的配置和状态。

接口调用与功能说明#

sta_test#

  • network.WLAN(id): 初始化一个 WLAN 对象,id 为 0 时表示 STA 模式。

  • sta.active(bool): 激活或关闭 STA 模式。当传入 True 时激活,传入 False 时关闭。如果不带参数调用,则返回当前激活状态。

  • sta.status(): 返回 STA 的当前状态,如是否已连接到 AP。

  • sta.connect(ssid, password): 尝试连接到指定的 SSID 和密码的 AP。此方法不返回是否连接成功的直接结果,但可以通过检查 sta.status()sta.isconnected() 来获取连接状态。

  • sta.ifconfig(): 返回 STA 的 IP 配置信息,如 IP 地址、子网掩码、网关和 DNS 服务器等。

  • sta.isconnected(): 返回 True 如果 STA 已连接到 AP,否则返回 False

  • sta.disconnect(): 断开 STA 与当前 AP 的连接。

完整例程#

import network
import time

SSID = "TEST"
PASSWORD = "12345678"

sta = network.WLAN(network.STA_IF)

sta.connect(SSID, PASSWORD)

timeout = 10  # 单位:秒
start_time = time.time()

while not sta.isconnected():
    if time.time() - start_time > timeout:
        print("连接超时")
        break
    time.sleep(1)  # 请稍等片刻再连接

print(sta.ifconfig())

print(sta.status())

# 这里的断开网络,只是一个测试。实际应用可不断开
sta.disconnect()
print("断开连接")
print(sta.status())

ap_test#

  • network.WLAN(network.AP_IF): 初始化一个 WLAN 对象,并设置为 AP 模式。

  • ap.active(bool): 激活或关闭 AP 模式。当传入 True 时激活,传入 False 时关闭。如果不带参数调用,则返回当前激活状态。

  • ap.config(ssid=None, password=None, channel=None, ...): 配置 AP 的参数,如 SSID、密码、频道等。如果不带任何参数调用,则返回当前配置。

  • ap.config(key): 如果 key'ssid''channel' 等配置项的字符串表示,则返回该配置项的值。

  • ap.status(): 返回 AP 的当前状态。

完整例程#

import network

def ap_test():
    ap=network.WLAN(network.AP_IF)
    #配置并创建ap
    ap.config(ssid='k230_ap_wjx', key='12345678')
    #查看ap信息
    print(ap.info())
    #查看ap的状态
    print(ap.status())

ap_test()

具体接口定义请参考 network

评论列表
条评论
登录