闲言碎语
上一篇水文中简单的介绍了wifi模块中的几个配置相关的函数。这篇文章准备介绍station模式下相关的函数。station模式下，nodemcu可以连接入wifi网络，成为一个局域网设备。
模块函数
station部分的函数，数量也超过了10个。虽然看起来很多，但是关键也就那么几个函数。
| 序号 | 函数名 | 参数 | 返回值 |
|---|---|---|---|
| 1 | wifi.sta.autoconnect() | 0 / 1 | nil |
| 2 | wifi.sta.config() | ssid, password[, auto[, bssid] | nil |
| 3 | wifi.sta.connect() | 空 | nil |
| 4 | wifi.sta.disconnect() | 空 | nil |
| 5 | wifi.sta.eventMonReg() | wifi_status[, function([previous_state])] | nil |
| 6 | wifi.sta.eventMonStart() | [ms] | nil |
| 7 | wifi.sta.eventMonStop() | [unregister_all] | nil |
| 8 | wifi.sta.getap() | [[cfg], format,] callback(table) | nil |
| 9 | wifi.sta.getbroadcast() | nil | 字符串 |
| 10 | wifi.sta.getconfig() | nil | ssid, password, bssid_set, bssid |
| 11 | wifi.sta.gethostname() | nil | 字符串 |
| 12 | wifi.sta.getip() | nil | 字符串 |
| 13 | wifi.sta.getmac() | nil | 字符串 |
| 13 | wifi.sta.getrssi() | nil | 字符串 |
| 14 | wifi.sta.sethostname() | 字符串 | true / false |
| 15 | wifi.sta.setip() | table | true / false |
| 16 | wifi.sta.setmac() | 字符串 | true / false |
| 17 | wifi.sta.status() | nil | 0~5 |
- .sta.autoconnect用于设置是否自动连接；
- .sta.config用来设置接入路由的信息，该信息只有被修改才会变动，掉电信息依然在。auto参数默认为1，即自动连接。当周围有其他同名ssid时，可以通过bssid参数指定接入某mac地址路由。
wifi.sta.config("ssid", "password")
- .sta.connect和.sta.disconnect用于接入或者断开连接。当在.sta.config设置了手动连接时，才需要使用.sta.connect；
- .sta.eventMonReg用于注册状态监听。总共有[6] API函数已经无效了(http://nodemcu.readthedocs.io/en/master/en/modules/wifi/#parameters_13)种状态；
wifi.sta.eventMonReg(wifi.STA_IDLE, function()
end)
wifi.sta.eventMonReg(wifi.STA_IDLE) --注销回调
- .sta.eventMonStart用于启动状态监听，可选参数是回调时间间隔，默认150ms；
- .sta.eventMonStop用于暂停状态监听，如果可选参数传入1，则暂停并注销回调；
- .sta.getap用于扫描ap列表。参数cfg是lua的table数据类型，参数format用于选择table的格式，callback(table)是回调函数。
- .sta.getbroadcast用于获取广播地址；
- .sta.getconfig用于获取配置信息；
- .sta.gethostname用于获取主机名
- .sta.getip用于获取ip地址、掩码、网关；
- .sta.getmac用于获取mac地址；
- .sta.getrssi用于获取连接点的rssi。如果未接入网络则返回nil；
- .sta.sethostname用于设置主机名，只能包含数字、字母、-，且不能超过32字符，第一个和最后一个不能是下划线；
- .sta.setip用于设置ip地址、掩码、网关；
- .sta.setmac用于设置mac地址；
- .sta.status用于获取状态。
综合小例子
nodeMCU提供的API还是蛮简洁的，几句话就可以实现wifi上网。这里先使用.sta.sethostname设置nodeMCU模块的名字，方便与其他设备区分（比如，手机）。注册一个状态（wifi.STA_GOTIP）监听，当连入wifi的时候会触发回调。最后使用.sta.config接入网络，相当于平时用手机输入ssid和密码。为了方便，我用笔记本共享wifi来给nodeMCU接入。
wifi.sta.sethostname("Node-MCU")
print(wifi.sta.gethostname())
function printap(ap)
for k, v in pairs(ap) do
print(k.." : "..v)
end
end
wifi.sta.eventMonReg(wifi.STA_GOTIP, function()
print(wifi.sta.getip())
wifi.sta.getrssi()
wifi.sta.getap(printap)
end)
wifi.sta.eventMonStart()
wifi.sta.config("wifitest", "kwmb566687")
走,冲浪去
简书评论不能贴图, 如有需要可以到我的GitHub上提issues
