目的
使用 ESP32 一般是用它的 WIFI 功能,使用 WIFI 功能大概就是建立网络、连接网络、搜索网络等基础操作。
建立网络(AP)
基础使用
下面是 wifi 连接最基础的代码。将代码烧入模块中,便能在 wifi 列表中搜索到名为 “ESP32_WIFI_AP” 的无密码 WIFI。
#include <WiFi.h>
void setup()
{
WiFi.softAP("ESP32_WIFI_AP");
}
void loop()
{
}
主要函数
bool WiFi.softAP(const char* ssid, const char* passphrase, int channel, int ssid_hidden, int max_connection)
使用此方法开启 AP 模式,在成功开启后会返回 ture
参数 | 介绍 |
---|---|
ssid |
AP 网络的名称,至少需一个字节,最大一般不超过32字节 |
passphrase |
所建立AP网络的密码,可以为 NULL(无密码)或不小于8字节且不大于63字节的密码 |
channel |
WiFi网络信道,可选值1~13 |
ssid_hidden |
是否对外隐藏SSID,0-不隐藏,1-隐藏 |
max_connection |
最大可接入数,可选值1~4 |
bool softAPConfig(IPAddress local_ip, IPAddress gateway, IPAddress subnet)
设置 AP 地址
参数 | 介绍 |
---|---|
local_ip | 本地地址,默认为 192.168.4.1 |
gateway | 网关地址,默认为 192.168.4.1 |
subnet | 子网掩码,默认为 255.255.255.0 |
-
bool softAPdisconnect(bool wifioff = false)
关闭当前AP,若wifioff为true则还将还原网络设置 -
uint8_t softAPgetStationNum()
返回连接到 AP 的客户端数量 -
IPAddress softAPIP()
返回当前模块IP -
bool softAPsetHostname(const char * hostname)
设置主机名字 -
const char * softAPgetHostname()
返回主机名字 -
uint8_t* softAPmacAddress(uint8_t* mac) String softAPmacAddress(void)
返回 mac 地址