ESP8266WiFiAP库用于ESP8266的接入点工作模式启动和设置,既esp8266建立wifi网络,并由其他设备进行连接(AP模式)
管理类型
softAP-设置接入点WiFi信息
说明
softAP函数可用于启动校验式wifi网络或开放式wifi网络。校验式网络就是需要我们输入密码的网络,开放网络也就是不需要密码,只需要知道网络的名字就可以链接的无密码网络。
语法
WiFi.softAP(ssid,passphrase,channel,hidden,max_connection);
参数
ssid: char型,WiFi网络名称
passphrase: int型,WiFi密码(对于WPA2加密类型最少8个字符,对于开放网络设置为NULL)
channel: int型,wifi信道。可选通道有1-13,不设置的情况下默认是1。
hidden: bool型,控制 WiFI是否隐藏的标志变量。设置为0不隐藏,设置为1隐藏。
max_connection: int型,最大的允许连接的无线终端数量。可选数值范围是1 – 4(ESP8266模块最多允许同时连接的无线终端设备数量是4个)。
返回值
softAPConfig-配置接入点网络信息(如ip地址等)
说明
softAPConfig函数可用于配置ESP8266开发板所建立的接入点网络信息,如开发板IP地址,[[网关]],[[子网掩码]]。
语法
WiFi.softAPConfig(ip,gateway,subnet);
参数
ip: 接入点的ip地址。(IPAddress型)
gateway: 网关IP地址。 (IPAddress型)
subnet: 子网掩码。(IPAddress型)
返回值
返回设置结果,设置成功返回true,否则返回false。数据类型为bool。
softAPDisconnect-关闭接入点模式
说明
softAPdisconnect函数可用于关闭ESP8266开发板的接入点模式,即关闭ESP8266所建立的WiFi网络。
语法
WiFi.softAPdisconnect(val);
参数
val:如果将该参数设置为true,设备将直接关闭接入点模式。在不输入参数的情况下调用该函数,设备会将当前配置的网络名和密码设置为空值。
返回值
返回设置是否成功的结果。设置成功返回true。数据类型为bool型。
信息类型
softAPIP-获得接入点ip地址
说明
ESP8266开发板建立WiFi接入点后, 我们可以使用本函数获取ESP8266开发板的IP地址。
语法
WiFiAP.softAPIP();
参数
无
返回值
此函数的返回值是ESP8266的ip地址
softAPmacAddress-获得接入点mac
说明
ESP8266开发板建立WiFi接入点后, 我们可以使用本函数获取ESP8266开发板的mac地址
语法
WiFi.softAPmacAddress(macAddr);
参数/返回值
如果不输入参数,函数的返回值为ESP8266的mac地址(String类型)
如果输入参数macAddr,那么ESP8266的mac地址将会储存在macAddr中,macAddr必须是一个uint8_t的数组,且该数组含有6个元素。
softAPSSID-获得接入点WiFi名称
说明
ESP8266建立WiFi接入点后,我们可以使用本函数获取WiFi名称
语法
WiFi.softAPSSID();
参数
无
返回值
返回接入点WiFi名称,数据类型为字符串型。
softAPPSK-获得接入点连接密码
说明
ESP8266建立WiFi接入点后,我们可以使用本函数获取WiFi密码。
语法
WiFi.softAPPSK();
参数
无
返回值
返回接入点WiFi密码,数据类型为字符串型。
softAPGetStationNum-获得连接上的终端数量
说明
softAPgetStationNum函数可用于获取通过WiFi连接到ESP8266接入点的无线终端数量。
语法
WiFi.softAPgetStationNum();
参数
无
返回值
连接到ESP8266开发板接入点的无线终端数量,数据类型为int型。