Wi-Fi 是一种让设备通过无线电波接入局域网/互联网的技术。Ai-M6x（BL616/BL618）内置 2.4GHz Wi-Fi 6 收发器，开发板通电后就是一台“无线网卡 + 小电脑”，可以自己连路由器，也可以自己开一个热点让别人连。
用大白话讲：手机连你家路由器叫 STA（Station，站点）模式；路由器给手机发网络信号叫 AP（Access Point，接入点）模式。开发板两种都能当：连路由器是 STA，开热点是 Soft-AP。
关键名词
SSID：Wi-Fi 的名字，比如
Ai-Thinker。密码/加密：WPA2/WPA3 是常见加密方式，密码错了就连不上。
IP 地址：网络中每台设备的“门牌号”，IPv4 形如
192.168.1.100，路由器通过 DHCP 自动分配。频段/信道：2.4GHz 频段分为 1~13 信道；Ai-M6x 只支持 2.4GHz，不支持 5GHz。
MAC 地址：网卡的“身份证号”，出厂固定，路由器用它识别设备。
事件驱动模型
SDK 的 Wi-Fi 例程都采用事件回调模型：初始化后固件不主动干等，而是注册一个 wifi_event_handler，Wi-Fi 固件发生状态变化时通过事件通知应用。例程中常见的几个事件：
CODE_WIFI_ON_INIT_DONE：Wi-Fi 固件初始化完成，随后启动 Wi-Fi 管理任务（wifi_mgmr_task_start）。CODE_WIFI_ON_CONNECTED：已连上路由器（还没拿到 IP）。CODE_WIFI_ON_GOT_IP：DHCP 分配到了 IP 地址——此时才能做 TCP/UDP/HTTP/MQTT 等网络通信。CODE_WIFI_ON_DISCONNECT：断开连接。CODE_WIFI_ON_AP_STARTED/CODE_WIFI_ON_AP_STA_ADD：AP 模式相关事件。
本栏目页面导航
第一次接触建议按顺序看：连接 Wi-Fi → TCP/IP 通讯 → TCP 客户端 → HTTP GET → MQTT 连接。其余页面按需查阅：
| 页面 | 作用 | 对应 SDK 例程 |
|---|---|---|
| 连接 Wi-Fi | STA 模式连接路由器并观察事件 | examples/wifi/sta/wifi_tcp（启动骨架） |
| 路由模式（Soft-AP） | 开发板开热点 + Web 配网 | examples/wifi/sta/smartconfig_softap |
| 网络授时（SNTP） | 联网自动校准时间 | 自编示例（lwIP SNTP） |
| TCP/IP 通讯 | TCP/UDP 协议概念 | — |
| TCP 客户端 / TCP 服务器 | TCP 连接通信 | examples/wifi/sta/wifi_tcp |
| UDP 客户端 / UDP 服务器 / 广播 / 组播 | UDP 通信 | examples/wifi/sta/wifi_udp（服务器）/ 自编示例 |
| HTTP GET/POST/PUT/DELETE 与 HTTPS | HTTP/HTTPS 请求 | examples/wifi/sta/wifi_http / wifi_https |
| MQTT 连接 / MQTTS 连接 | 物联网消息收发（含 TLS） | examples/wifi/sta/wifi_mqtt |
| WebSocket | 全双工长连接通信 | examples/wifi/sta/websocket |
FAQ
Q：为什么搜不到开发板的热点？ 只有运行 Soft-AP 例程（或自己调 AP API）时开发板才会开热点；STA 例程默认只连路由器。
Q：连不上路由器怎么办？ 依次检查：路由器是否 2.4GHz、SSID/密码是否正确（中文 SSID 建议改英文）、距离是否太远、路由器是否开启了 MAC 过滤。
Q：
GOT_IP事件一直不出现？ 检查路由器 DHCP 是否开启；也可以拔电重试或更换信道。
遇到问题？
如有其他问题，请到统一的提问与讨论区：Ai-Thinker Discussions