# 使用无线网例程讲解

## 概述

本教程将指导您如何在 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 的连接。

#### 完整例程

```python
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 的当前状态。

#### 完整例程

```python
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](../../api/extmod/K230_CanMV_network模块API手册.md)