参考链接
目的
使用ESP32一般是为了它的WiFi功能,使用这块功能最基本的就是建立/连接网络这些基本操作,其它面向用户的网络应用都是建立在这基础上的。
建立网络(AP)
基础使用
建立网络只需两步:
- 引用WiFi库
#include <WiFi.h>
; - 启动AP网络
WiFi.softAP(ssid)
;
将下面代码上传到模块中:
#include <WiFi.h> void setup() { WiFi.softAP("ESP32_AP_TEST"); } void loop() { }
代码运行后可以搜索到一个名称为ESP32_AP_TEST
的无密码的网络;
默认情况下ESP32建立AP时,模块自身地址为192.168.4.1
,可以连接到该网络后进行测试;
常用方法说明
-
bool softAP(const char* ssid, const char* passphrase = NULL, int channel = 1, int ssid_hidden = 0, int max_connection = 4)
该方法用来启动AP,在成功启动后返回true,各项参数如下: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)
设置本地地址、网关地址和子网掩码,默认分别为192.168.4.1
192.168.4.1
255.255.255.0
; -
bool softAPdisconnect(bool wifioff = false)
关闭当前AP,若wifioff
为true则还将还原网络设置; -
uint8_t softAPgetStationNum()
返回连接到AP的客户端数量; -
IPAddress softAPIP()
返回当前模块IP -
const char * softAPgetHostname()
返回主机名字 -
bool softAPsetHostname(const char * hostname)
设置主机名字 -
uint8_t* softAPmacAddress(uint8_t* mac)
String softAPmacAddress(void)
返回mac地址
softAPConfig和softAP位置的顺序:
如果softAPConfig在后面的话,并且softAP是无密码的,那么两句之间最好有一定的时间间隔。
WiFi.softAP("ESP32_test_1T"); delay(1000); WiFi.softAPConfig(apIP,apIP,subnet);