## 调用方法:
`require("Wifi").connect(ssid,options,callback)`
## 参数
`ssid`\- 接入点网络 ID。
`options`\- \[可选\] 连接选项。
`callback`\- 完成时要回调`callback(err)`的函数。`err`在成功时为 null,或在失败时包含错误字符串。
## 描述
作为工作站连接到接入点。如果存在与 AP 的现有连接,则如果 SSID 或密码与作为参数传递的 SSID 或密码不同,则首先断开连接。换句话说,如果传递的SSID和密码与当前连接的AP相同,则不会更改任何内容。连接尝试完成后,将使用一个`err`参数调用回调函数,如果没有错误,则为 NULL,如果有错误,则为字符串消息。如果启用了 DHCP,则在获取 IP 地址后进行回调,如果设置了静态 IP,则在加入 AP 网络后进行回调。如果连接已存在且不需要更改,则也会调用回调。
选项属性(options)可能包含:
* `password`\- 用于访问网络的密码字符串。
* `dnsServers`(array of String) - 最多包含两个 DNS 服务器的数组,采用带点的十进制格式字符串。
* `channel`\- 接入点的 Wifi 信道(整数,典型值 0..14,0 表示任何信道),仅在ESP8266上。
* `bssid`\- 接入点的 Mac 地址(字符串,类似于 "00:00:00:00:00:00"),仅在 ESP8266 上。
笔记:
* 这些选项应包括设置静态 IP 以及关联的网络掩码和网关的能力,这是未来的增强功能。
* 回调中报告的唯一错误是“密码错误”,所有其他错误(例如找不到接入点或DHCP超时)都会导致连接重试。如果需要报告此类临时错误,调用方必须使用自己的超时和`getDetails().status`字段。
* `connect` 会自动开启 `station` 模式,可以通过调用 `disconnect` 再次禁用。
- Espruino简介
- API
- 全局Globals
- acceleration()
- analogRead(pin)
- analogWrite(pin, value, options)
- atob(base64Data)
- btoa(binaryData)
- changeInterval(id, time)
- clearInterval(id)
- clearTimeout(id)
- clearWatch(id)
- compass()
- decodeURIComponent(str)
- digitalPulse(pin, value, time)
- digitalRead(pin)
- digitalWrite(pin, value)
- dump()
- echo(echoOn)
- edit(funcName)
- encodeURIComponent(str)
- eval(code)
- getPinMode(pin)
- getSerial()
- getTime()
- isFinite(x)
- isNaN(x)
- load(filename)
- parseFloat(string)
- parseInt(string, radix)
- peek16(addr, count)
- peek32(addr, count)
- peek8(addr, count)
- pinMode(pin, mode, automatic)
- poke16(addr, value)
- poke32(addr, value)
- poke8(addr,value)
- print(text, ...)
- require(moduleName)
- reset(clearFlash)
- save()
- setBusyIndicator(pin)
- setDeepSleep(sleep)
- setInterval(function, timeout, args, ...)
- setSleepIndicator(pin)
- setTime(time)
- setTimeout(function, timeout, args, ...)
- setWatch(function, pin, options)
- shiftOut(pins, options, data)
- show(image)
- trace()
- ESP8266
- ESP8266.crc32
- ESP8266.deepSleep
- ESP8266.dumpSocketInfo
- ESP8266.getFreeFlash
- ESP8266.getResetInfo
- ESP8266.getState
- ESP8266.logDebug
- ESP8266.neopixelWrite
- ESP8266.ping
- ESP8266.printLog
- ESP8266.readLog
- ESP8266.reboot
- ESP8266.setCPUFreq
- ESP8266.setLog
- ESP32
- ESP32.deepSleep(us)
- ESP32.deepSleepExt0(pin, level)
- ESP32.deepSleepExt1(pinVar, mode)
- ESP32.enableBLE(enable)
- ESP32.enableWifi(enable)
- ESP32.getState()
- ESP32.getWakeupCause()
- ESP32.reboot()
- ESP32.setAtten(pin, atten)
- ESP32.setBLE_Debug(level)
- ESP32.setOTAValid(isValid)
- Wifi
- event associated
- event auth_change
- Wifi.connect(ssid, options, callback)
- event connected
- event dhcp_timeout
- Wifi.disconnect(callback)
- event disconnected
- Wifi.getAPDetails(callback)
- Wifi.getAPIP(callback)
- Wifi.getDetails(callback)
- Wifi.getHostByName(hostname, callback)
- Wifi.getIP(callback)
- Wifi.getStatus(callback)
- Wifi.ping(hostname, callback)
- event probe_recv
- Wifi.restore()
- Wifi.save(what)
- Wifi.scan(callback)
- Wifi.setAPIP(settings, callback)
- Wifi.setConfig(settings)
- Wifi.setHostname(hostname, callback)
- Wifi.setIP(settings, callback)
- Wifi.setSNTP(server, tz_offset)
- event sta_joined
- event sta_left
- Wifi.startAP(ssid, options, callback)
- Wifi.stopAP(callback)
- Wifi.turbo(enable, callback)
- Modules
- Modules.addCached(id, sourcecode)
- Modules.getCached()
- Modules.removeAllCached()
- Modules.removeCached(id)
- Flash
- Flash.erasePage(addr)
- Flash.getFree()
- Flash.getPage(addr)
- Flash.read(length, addr)
- Flash.write(data, addr)
- Storage
- Storage.compact(showMessage)
- Storage.debug()
- Storage.erase(name)
- Storage.eraseAll()
- Storage.getFree(checkInternalFlash)
- Storage.getStats(checkInternalFlash)
- Storage.hash(regex)
- Storage.list(regex, filter)
- Storage.open(name, mode)
- Storage.optimise()
- Storage.read(name, offset, length)
- Storage.readArrayBuffer(name)
- Storage.readJSON(name, noExceptions)
- Storage.write(name, data, offset, size)
- Storage.writeJSON(name, data)
- StorageFile
- StorageFile.erase()
- StorageFile.getLength()
- StorageFile.pipe(destination, options)
- StorageFile.read(len)
- StorageFile.readLine()
- StorageFile.write(data)
- 模块 Modules
- 使用模块进行工作
- 内置模块
- Espruino 模块
- 来自 Github(或互联网上的任何地方)
- 从 Storage 加载模块
- 从 NPM 加载模块
- 从一个本地文件夹
- 从 SD 卡 加载模块
- 从互联网加载模块
- 已有模块
- 常见问题
- 编写和提交模块(或更改)