ESP8266WiFi库引入

转载

mob6454cc613c41 2024-09-15 20:49:01

文章标签 ESP8266WiFi库引入服务器引脚客户端 文章分类 架构后端开发

SerialESP8266wifi

一个简单的ESP8266 Arduino库，内置重新连接功能。

ESP8266是一个便宜的wifi模块。我得到了我的约2.50美元，包括在Aliexpress送货。请阅读此处：https：//nurdspace.nl/ESP8266

AT命令参考可以在这里找到：https://github.com/espressif/esp8266_at/wiki/AT_Description

联系我，如果你有想法改变或新功能，发现错误或只想购买jonas [AT] inspirativ [DOT] se

内存占用等等

使用Arduino Nano v3 ATMega 328，Arduino IDE 1.60，固件版本为0.9.2.4的ESP8266模块进行测试
大约3.5kB的程序存储
大约285字节或RAM

安装

从https://github.com/ekstrand/SerialESP8266wifi/archive/master.zip下载该库作为zip文件
以SerialESP8266wifi解压并放置在ARDUINO_HOME / libraries /目录中
重新启动Arduino IDE
在编辑器中添加#include <SerialESP8266wifi.h>
为了建立一个简单的服务器进行测试，我喜欢使用SocketTest http://sourceforge.net/projects/sockettest/

构造函数

SerialESP8266wifi（Stream serialIn，Stream serialOut，byte resetPin）

serialIn此对象用于从ESP8266读取，可以使用硬件或软件串行
serialOut此对象用于写入ESP8266，您可以使用硬件或软件串行
resetPin此引脚将被拉低然后高电平来重置ESP8266。假定CH_PD引脚连接到该引脚。查看引脚和更多：http://www.electrodragon.com/w/ESP8266#Module_Pin_Description
例子SerialESP8266wifi wifi(swSerial, swSerial, 10);

SerialESP8266wifi(Stream serialIn, Stream serialOut, byte resetPin, Stream debugSerial)

serialIn此对象用于从ESP8266读取，可以使用硬件或软件串行
serialOut此对象用于写入ESP8266，您可以使用硬件或软件串行
resetPin此引脚将被拉低然后高电平来重置ESP8266。假定CH_PD引脚连接到该引脚。请参阅pin和更多：http://www.electrodragon.com/w/ESP8266#Module_Pin_Description
debugSerial启用wifi调试和本地回声串行（可能是硬件或软件）
例子SerialESP8266wifi wifi(swSerial, swSerial, 10, Serial);

启动模块

boolean begin()调用这个方法将在ESP8266上做一个hw重置并设置基本参数 - 取决于模块是否正确启动，返回将返回true或false - 例子：boolean esp8266started = wifi.begin();

连接到接入点

boolean connectToAP(char * ssid, char password)*告诉ESP8266连接到接入点 - ssid要使用的ssid（工作站名称）。请注意，此方法使用char数组作为输入。有关如何将arduino字符串对象转换为char数组（最多15个字符），请参见 http://arduino.cc/en/Reference/StringToCharArray。 - password 假定接入点密码wpa / wpa2（最多15个字符） - return 如果在时限内（15秒）收到有效的IP，返回将返回true - 例子boolean apConnected = wifi.connectToAP("myaccesspoint", "password123"); boolean isConnectedToAP() 检查模块是否连接了有效的IP - return 如果模块具有有效的IP地址，将返回true - 例子boolean apConnected = wifi.isConnectedToAP();

连接到服务器

boolean connectToServer(char ip, char port)告诉ESP8266打开到服务器的连接 - ip 要连接的服务器的IP地址 - port 要使用的端口号 - return 如果连接在5秒内建立，则为true - 例子boolean serverConnected = wifi.connectToServer("192.168.5.123", "2121"); boolean isConnectedToServer() 检查服务器是否连接 - return 如果我们连接到服务器将返回true - 例子boolean serverConnected = wifi.isConnectedToServer(); setTransportToTCP() AND setTransportToUDP()告诉ESP8266连接到服务器时使用哪个传输。默认是TCP。

断开与服务器的连接

disconnectFromServer() 告诉ESP8266关闭服务器连接 - 例子wifi.disconnectFromServer();

发送消息

boolean send(char channel, char * message)发送消息 - 发送别名send(char channel, char * message, true) - channel 如果要发送到服务器，请设置为SERVER。如果我们是服务器，值可以在’1’ - ‘3’之间 - message 一个字符数组，最长25个字符。 - return 如果消息已发送，则为true - 例子boolean sendOk = wifi.send(SERVER, "Hello World!"); boolean send(char channel, char * message, boolean sendNow)发送队列消息以供稍后发送 - channel 如果要发送到服务器，请设置为SERVER。如果我们是服务器，值可以在’1’ - ‘3’之间 - message 一个字符数组，最长25个字符。 - sendNow 如果为false，则将消息附加到缓冲区，如果为true，则会立即发送消息 - return 如果消息已发送，则为true - Example

wifi.send(SERVER, "You", false);
wifi.send(SERVER, " are ", false);
wifi.send(SERVER, "fantastic!", true); // ie wifi.send(SERVER, "fantastic!");

endSendWithNewline(bool endSendWithNewline)默认情况下，所有消息都使用换行符和回车符（println）发送，您可以禁用它 - endSendWithNewline 发送消息而不是println - Example wifi.endSendWithNewline(false);

检查客户端连接

boolean checkConnections(&connections)更新预先初始化指向Wifi连接 - return - 更新的指针是3个连接的数组： boolean connected 如果连接则为true。 char channel 频道号码，可以通过发送。 - 例子

WifiConnection *connections;

wifi.checkConnections(&connections);
for (int i = 0; i < MAX_CONNECTIONS; i++) {
  if (connections[i].connected) {
    // See if there is a message
    WifiMessage msg = wifi.getIncomingMessage();
    // Check message is there
    if (msg.hasData) {
      processCommand(msg);
    }
  }
}

检查连接

boolean isConnection(void) 如果客户端连接，则返回true，否则返回false。如果不打扰多客户端的话，不用WifiConnection指针就可以使用上面的指针。

从连接的客户端获取传入消息

WifiMessage getIncomingMessage(void) 检查消息的串行缓冲区。返回是WifiMessage类型，如下所示。请参阅示例检查客户端连接示例以了解用法

接收消息

WifiMessage listenForIncomingMessage(int timeoutMillis) 将听取最多timeoutMillis毫秒的新消息。尽可能多地调用此方法，并尽可能使用尽可能大的timeoutMillis来捕获尽可能多的消息。

timeoutMillis 查找新传入消息的最大毫秒数
return WifiMessage包含
boolean hasData 如果收到消息，则为true
char channel 告诉你是否从服务器（通道=服务器）或其他来源收到消息
char * message该消息作为字符数组（最多25个字符）
例子

void loop(){
    WifiMessage in = wifi.listenForIncomingMessage(6000);
    if (in.hasData) {
        Serial.print("Incoming message:");
        Serial.println(in.message);
        if(in.channel == SERVER)
            Serial.println("From server");
        else{
            Serial.print("From channel:");
            Serial.println(in.channel);
        }
    }
    // Do other stuff
 }

本地接入点和本地服务器

boolean startLocalAPAndServer(char ssid, char password, char* channel, char* port)将创建一个本地访问点并启动一个本地服务器 - ssid - password - channel - port - return - 例子 boolean localAPAndServerStarted = wifi.startLocalAPAndServer("my_ap", "secret_pwd", "5", "2121"); boolean stopLocalAPAndServer()禁用访问点（服务器不会停止，因为需要重启） boolean isLocalAPAndServerRunning()检查本地访问点和服务器是否正在运行

重新连接功能

每次发送（…）和listenForIncomingMessage（..）被称为监视程序检查配置的访问点，服务器和本地访问点和服务器是否仍在运行，如果不是，它们将重新启动或重新连接。如果ESP8266应该重置，也会发生同样的事情。注意：实际上只有发送方法可以检测与服务器的连接丢失。为了确保你已经连接起来，偶尔发送一次。

高级配置

在串行ESP8266wifi.h中，您可以更改一些内容： - HW_RESET_RETRIES 3 是begin（）尝试启动ESP8266模块的最大次数 - SERVER_CONNECT_RETRIES_BEFORE_HW_RESET 30 是在执行ESP8266的硬件复位之前，看门狗将尝试与服务器建立连接的时间 - 传入和传出邮件的最大字符数可通过编辑进行更改：char msgOut[26]; char msgIn[26]; - 如果ssid和密码长度的限制不适合您，请更改： char _ssid[16];char _password[16];char _localAPSSID[16];char _localAPPassword[16]; 参考文献： https://github.com/ekstrand/ESP8266wifi

本文章为转载内容，我们尊重原作者对文章享有的著作权。如有内容错误或侵权问题，欢迎原作者联系我们进行内容更正或删除文章。