ESP8266 Arduino开发之路（3）— 作为TCP客户端连接到服务器

ESP8266 Arduino开发之路（3）— 作为TCP客户端连接到服务器

一、前言

在上一篇我们已经成功连接到网络了，接下来就可以尝试建立TCP连接了。
接下来我们将ESP8266作为TCP客户端来连接到服务器。

二、建立连接

编写代码如下所示

/*
  ESP8266-NodeMCU作为TcpClient连接到服务器
*/
 
#include <ESP8266WiFi.h>                        // 本程序使用ESP8266WiFi库

const char* ssid     = "SixLab";                // 需要连接到的WiFi名
const char* password = "sixlab123";             // 连接的WiFi密码
                                            
void setup() {
  Serial.begin(115200);                         // 初始化串口通讯波特率为115200

  WiFi.mode(WIFI_STA);                          // 设置Wifi工作模式为STA,默认为AP+STA模式
  WiFi.begin(ssid, password);                   // 通过wifi名和密码连接到Wifi
  Serial.print("\r\nConnecting to ");           // 串口监视器输出网络连接信息
  Serial.print(ssid); Serial.println(" ...");   // 显示NodeMCU正在尝试WiFi连接
  
  int i = 0;                                    // 检查WiFi是否连接成功
  while (WiFi.status() != WL_CONNECTED)         // WiFi.status()函数的返回值是由NodeMCU的WiFi连接状态所决定的。 
  {                                             // 如果WiFi连接成功则返回值为WL_CONNECTED
    delay(1000);                                // 此处通过While循环让NodeMCU每隔一秒钟检查一次WiFi.status()函数返回值
    Serial.print("waiting for ");                          
    Serial.print(i++); Serial.println("s...");       
  }                                             
                                               
  Serial.println("");                           // WiFi连接成功后
  Serial.println("WiFi connected!");            // NodeMCU将通过串口监视器输出"连接成功"信息。
  Serial.print("IP address: ");                 // 同时还将输出NodeMCU的IP地址。这一功能是通过调用
  Serial.println(WiFi.localIP());               // WiFi.localIP()函数来实现的。该函数的返回值即NodeMCU的IP地址。
}

const char* host = "192.168.3.2";
const uint16_t port = 8266;

void loop() {
  /* 新建一个WiFiClient类对象，作为TCP客户端对象 */
  WiFiClient tcpclient;

  /* 建立TCP连接 */
  Serial.print("connecting to "); Serial.print(host); Serial.print(':'); Serial.println(port);
  if (!tcpclient.connect(host, port)) {
    Serial.println("connection failed");        // 如果连接失败，则打印连接失败信息，并返回
    delay(5000);
    return;
  }
  
  /* LED闪烁 */
  pinMode(2, OUTPUT);
  while(1){
    digitalWrite(2, LOW);
    delay(300);
    digitalWrite(2, HIGH);
    delay(300);  
  }
}

使用网络调试助手创建一个TCP服务器，端口号设置为8266
编译烧录运行，可以看到可以连接到tcp服务器

三、收发数据

修改代码如下所示

/*
  ESP8266-NodeMCU作为TcpClient连接到服务器
*/
 
#include <ESP8266WiFi.h>                        // 本程序使用ESP8266WiFi库

const char* ssid     = "SixLab";                // 需要连接到的WiFi名
const char* password = "sixlab123";             // 连接的WiFi密码
                                            
void setup() {
  Serial.begin(115200);                         // 初始化串口通讯波特率为115200

  WiFi.mode(WIFI_STA);                          // 设置Wifi工作模式为STA,默认为AP+STA模式
  WiFi.begin(ssid, password);                   // 通过wifi名和密码连接到Wifi
  Serial.print("\r\nConnecting to ");           // 串口监视器输出网络连接信息
  Serial.print(ssid); Serial.println(" ...");   // 显示NodeMCU正在尝试WiFi连接
  
  int i = 0;                                    // 检查WiFi是否连接成功
  while (WiFi.status() != WL_CONNECTED)         // WiFi.status()函数的返回值是由NodeMCU的WiFi连接状态所决定的。 
  {                                             // 如果WiFi连接成功则返回值为WL_CONNECTED
    delay(1000);                                // 此处通过While循环让NodeMCU每隔一秒钟检查一次WiFi.status()函数返回值
    Serial.print("waiting for ");                          
    Serial.print(i++); Serial.println("s...");       
  }                                             
                                               
  Serial.println("");                           // WiFi连接成功后
  Serial.println("WiFi connected!");            // NodeMCU将通过串口监视器输出"连接成功"信息。
  Serial.print("IP address: ");                 // 同时还将输出NodeMCU的IP地址。这一功能是通过调用
  Serial.println(WiFi.localIP());               // WiFi.localIP()函数来实现的。该函数的返回值即NodeMCU的IP地址。
}

const char* host = "192.168.3.2";
const uint16_t port = 8266;

void loop() {
  /* 新建一个WiFiClient类对象，作为TCP客户端对象 */
  WiFiClient tcpclient;

  /* 建立TCP连接 */
  Serial.print("connecting to "); Serial.print(host); Serial.print(':'); Serial.println(port);
  if (!tcpclient.connect(host, port)) {
    Serial.println("connection failed");        // 如果连接失败，则打印连接失败信息，并返回
    delay(5000);
    return;
  }

  /* 如果连接成功，则发送一个字符串到TCP服务器 */
  Serial.println("Connected to TCPServer, sending data to server");
  if (tcpclient.connected()) {
    tcpclient.println("hello, I am ESP8266.");
  }

  /* 等待TCP服务器返回消息 */
  Serial.println("waiting for receive from remote Tcpserver...");
  while (tcpclient.available() == 0) {}
  Serial.println("received data:");
  while (tcpclient.available()) {
    char ch = static_cast<char>(tcpclient.read());
    Serial.print(ch);
  }
  Serial.println();

  /* 接受到服务器返回的消息后关闭TCP连接 */
  Serial.println("closing connection");
  tcpclient.stop();

  /* LED闪烁 */
  pinMode(2, OUTPUT);
  while(1){
    digitalWrite(2, LOW);
    delay(300);
    digitalWrite(2, HIGH);
    delay(300);  
  }
}

编译烧录运行后可以看到运行结果如下所示，成功发送和接受到数据

四、附录

上一篇：ESP8266 Arduino开发之路（2）— 连接到无线WiFi路由器
下一篇：ESP8266 Arduino开发之路（4）— 通过HTTP进行网络通信