esp8266学习笔记⑥：通过网页配置连接WiFi（enduser setup Module模块）

enduser setup Module模块

模块源码enduser_setup.c
这是nodumcu在官网上公布的能够通过网页配置WiFi的API模块，这个模块只用3个函数，就能够实现wifi的连接。
具体连接页面如下：

函数名	功能
enduser_setup.manual()	控制是否使用手动配置AP
enduser_setup.start()	启动网页连接WiFi
enduser_setup.stop()	停止网页连接WiFi

使用说明

1.默认情况下，为自动配置，只需要使用enduser_setup.start()函数就行，esp8266会开启AP+Station模式，并建立一个默认的热点，名称“SetupGadget_XXXXXX”。
2.手机或电脑连接此热点后，在浏览器上会自动打开http://example.com/网页，没有打开的话就手动打开网页，就会进入上图所示的页面，填写WiFi账号和密码，点击保存。
3.esp8266模块会自动连接WiFi，连接成功后，自动关闭热点，不需要再使用enduser_setup.stop()函数。
注：如果是使用enduser_setup.manual()进行的手动配合，可以修改连接的热点名称，但连接成功后不会自动关闭。

函数的使用

enduser_setup.manual()
功能：控制是否手动配置
语法：enduser_setup.manual(off_on)
参数：off_on:指示是否使用手动模式的布尔值true或false；如果未给出，则该函数只返回当前设置
返回值：true或false,true:是,false:否

enduser_setup.start()
功能：启动网页配置
语法：enduser_setup.start(onConnected(), onError(err_num, string))
参数：
onConnected()：在它终止之前，获取ip地址时触发回调函数。
onError()：如果遇到错误，将触发onError（）回调。 err_num是描述错误的数字,string包含错误的描述。
返回值：nil

enduser_setup.stop()
功能：停止网页配置
语法：enduser_setup.stop()
参数：无
返回值：nil

手动网页配置WiFi连接示例：

wifi.setmode(wifi.STATIONAP)	--设置wifi模式
wifi.ap.config({ssid="账号", auth=wifi.OPEN})		--AP模式的账号
enduser_setup.manual(true)	--手动配置
enduser_setup.start(
  function()
    print("Connected	to	wifi ip is:" .. wifi.sta.getip())	--在关闭之前打印连接WiFi的ip地址
  end,
  function(err, str)
    print("enduser_setup: Err #" .. err .. ": " .. str)	--连接失败的原因
  end
)