【NodeMCU实时天气时钟温湿度项目 2】WIFI模式设置及连接

        第一专题内容，请参考
        【NodeMCU实时天气时钟温湿度项目 1】连接点亮SPI-TFT屏幕和UI布局设计-CSDN博客
        第三专题内容，请参考
【NodeMCU实时天气时钟温湿度项目 3】连接SHT30传感器，获取并显示当前环境温湿度数据（I2C）-CSDN博客

        今天是第二专题。
        NodeMCU是一个基于乐鑫ESP8266的开源IoT物联网硬件开发平台，支持WIFI功能，使用方法简单，受到越来越多来自全世界的创客朋友们的青睐。
        ESP8266是一款低成本、高性能的Wi-Fi模块，由Espressif Systems开发。它集成了Wi-Fi功能和TCP/IP协议栈，并可通过串口与主控制器进行通信。它采用先进的WIFI技术，提供高速、稳定的网络连接。其强大的处理能力使得设备能够快速响应指令，实现流畅的数据传输和通信。无论是智能家居、工业自动化还是远程监控等领域，都获得了广泛应用。

一、NodeMCU模块的WiFi工作模式

        1、无线终端（STA）模式
        在此模式下，模块可连接到由其他设备提供的无线网络，例如通过 WIFI 连接至路由器访问互联网，实现手机或电脑通过互联网实现对设备的远程控制。
        简单来说，此模式下，该模块相当于一个用户，需要链接外部的WIFI（或自己的热点），通过链接的WIFI与其他在线设备进行通信。

        2、接入点（soft-AP）模式
        在此模式下，模块将作为热点供其他设备连接，从而让手机或电脑直接与模块进行通讯，实现局域网的无线控制。同时支持0~8个无线终端连接到此soft-AP，默认为4个。
        简单来说，此模式下，该模块相当于提供一个热点，创建一个小范围的局域网，凡是连接上的设备就能与其进行通信。
        需要提醒的是：设置为soft-AP工作模式的模块，没有提供访问其他网络的接口。

3、混杂（STA+AP）模式
该模式为 STA 模式与 AP 模式共存的一种模式，模块既能连接到由其他设备提供的无线网络，又能作为热点供其他设备连接，以实现广域网与局域网的无缝切换，方便操作使用。

二、NodeMCU模块的WiFi连接代码实现

将NodeMCU连接到Wi-Fi，就如同把移动手机连接到网络接点一样简单方便，只需要几行代码就可以实现。以下是官方示例代码。
（摘自：ESP8266WiFi library — ESP8266 Arduino Core 3.1.2-21-ga348833 documentation）

#include <ESP8266WiFi.h>     //连接WiFi必须的头文件void setup()
{Serial.begin(115200);Serial.println();//此处需要将"network-name" 和 "pass-to-network"，修改为您自己所在环境下的接入点名称和密码WiFi.begin("network-name", "pass-to-network");Serial.print("Connecting");while (WiFi.status() != WL_CONNECTED){delay(500);Serial.print(".");}Serial.println();Serial.print("Connected, IP address: ");Serial.println(WiFi.localIP());
}void loop() {}

三、在项目中添加WiFi功能的有关代码

1. 添加ESP8266WiFi library支持WiFi功能的头文件

#include <ESP8266WiFi.h>

2. 增加设置WiFi模块将要连接的路由器的名称和密码

/**配置您所在环境的wifi 账号和密码注意：切勿连接 5G的频率、不要使用双频融合（路由器）注意：账号密码必须完全正确，包括字母大小写、空格、中划线、下划线******请务必修改成您所在环境的路由器名称和密码******
*/
const char* ssid     = "xcb940";
const char* password = "87589940abc";

3. 增加实现WiFi连接功能函数的声明

//WiFi 连接函数声明
void connectWiFi();

4、在setup()函数中调用 connectWiFi()，进行WiFi实际连接过程

  联网,建立WiFi连接    tft.println("Wi-Fi >> " + String(ssid));connectWiFi();

5. 增加WiFi连接功能函数 connectWiFi() 的定义

//连接wifi
void connectWiFi() {Serial.print("Connecting to ");Serial.println(ssid);//设置WiFi工作在终端模式，参数可选填WIFI_AP、WIFI_STA、WIFI_AP_STA、WIFI_OFFWiFi.mode(WIFI_STA);//开始连接WiFi.begin(ssid, password);//检查连接是否成功while (WiFi.status() != WL_CONNECTED) {delay(500);Serial.print(".");tft.print(".");}tft.println("");tft.println("");tft.setTextColor(TFT_GREEN, TFT_BLACK, true);tft.println(WiFi.localIP());//设置：当路由器断开连接时，是否启动自动重新连接功能。true: 启用自动重新连接；false：不启用此功能WiFi.setAutoReconnect(true);//设置：是否将WiFi参数保存于Flash中，默认为true，即在每次调用WiFi.begin()、WiFi.softAP()、WiFi.disconnect、WiFi.softAPdisconnect方法时都会将相关数据写入到Flash中；//      当设置为false时，以上动作将不会把数据写入Flash中，仅仅改变内存中的WiFi设置WiFi.persistent(true);
}

说明：除以上5点增加内容外，main.cpp其他内容未发生变化。

四、实现STA模式连接功能函数说明

        1. wl_status_t WiFi.begin(const char* ssid, const char *passphrase, int32_t channel, const uint8_t* bssid, bool connect）
        功能：启动无线连接
        参数：可设置5个参数，后4个为可选参数
        ssid – 要连接的wifi接入点的名称，最多可以包含32个字符。
        password – 可选。wifi接入点密码，长度至少应为8个字符且不超过64个字符。
        channel – 可选。要连接的wifi接入点信道。
        bssid – 可选。要连接的wifi接入点的mac地址。
        connect – 可选。连接状态参数。如果connect参数为true，NodeMCU开发板会使用闪存中储存的信息尝试连接WiFi。如果connect参数为false，ESP8266开发板不会尝试连接WiFi，而只会将WiFi连接信息保存在闪存中。
        返回值：返回值数据类型为表示连接状态的 wl_status_t 类型。

        2. wl_status_t WiFi.status()
        功能：返回STA模式下WiFi状态
        返回值：
        0 : WL_IDLE_STATUS，表示WiFi模块处于空闲状态，没有与任何网络连接
        1 : WL_NO_SSID_AVAILin，表示找不到指定的 WiFi 网络（SSID）
        2 : WL_SCAN_COMPLETED，表示WiFi模块网络扫描已结束
        3 : WL_CONNECTED ，表示连接成功
        4 : WL_CONNECT_FAILED，表示连接失败
        5：WL_CONNECTION_LOST，表示连接已失去
        6 : WL_WRONG_PASSWORD，表示连接密码错误
        7：WL_DISCONNECTED，表示已断开连接。

        3. bool WiFi.mode(WiFiMode_t m)
        功能：用于设置 Wi-Fi 工作模式。
        参数：
        WIFI_OFF： = 0，关闭 Wi-Fi。
        WIFI_STA： = 1，设置为 Wi-Fi 无线终端模式，用于连接到 Wi-Fi 热点。
        WIFI_AP： = 2，设置为 Wi-Fi 接入点模式，其他在线Wi-Fi 设备可以连接到它。
        WIFI_AP_STA： = 3，设置为同时作为 Wi-Fi 接入点和客户端，可以连接到其他 Wi-Fi 热点并接受其他 Wi-Fi 设备的连接。
        返回值：布尔型。

        4. IPAddress WiFi.localIP()
        功能：获取NodeMCU开发板本地接口的IP地址
        返回值：本地接口的IP地址

        5. bool WiFi.setAutoReconnect(bool autoReconnect)
        功能：当路由器（AP）断开连接时，是否启动自动重新连接功能。
        参数：布尔类型。true，启用自动重新连接；false，不启用此功能。
        返回值：布尔类型。设置成功返回true，失败则返回false。

        6. void WiFi.persistent(bool persistent)
        功能：设置是否将WiFi参数保存于Flash中，默认为true。即在每次调用WiFi.begin()、WiFi.softAP()、WiFi.disconnect、WiFi.softAPdisconnect方法时都会将相关数据写入到Flash中；
        参数：布尔类型。true表示保存到FLASH中；false表示将不会把数据写入Flash中，仅仅改变内存中的WiFi设置。
        返回值：无。

五、项目第2阶段 main.cpp 的主要内容

#include <Arduino.h>
#include <TFT_eSPI.h>#include <ESP8266WiFi.h>/**配置您所在环境的wifi 账号和密码注意：切勿连接 5G的频率、不要使用双频融合（路由器）注意：账号密码必须完全正确，包括字母大小写、空格、中划线、下划线
*/
const char* ssid     = "LGCWZS";
const char* password = "87129168";//构造函数，实例化 TFT 屏幕对象
TFT_eSPI tft = TFT_eSPI();//WiFi 连接函数声明
void connectWiFi();//程序用到的字库文件，后面会详细说明
#include "hefeng-min-40px.h"
#include "weather_font20.h"
#include "weather_font16.h"void setup()
{//设置串口波特率Serial.begin(115200);//等待串口稳定Serial.println("");Serial.println("");Serial.println("");//TFT初始化设置tft.init();tft.setSwapBytes(true);tft.setRotation(0);  tft.fillScreen(TFT_BLACK);tft.setTextColor(TFT_WHITE, TFT_BLACK, true);//设置显示字号tft.setTextSize(2);联网,建立WiFi连接    tft.println("Wi-Fi >> " + String(ssid));connectWiFi();delay(10000);tft.fillScreen(TFT_BLACK);  // 显示当前日期，星期几，农历tft.loadFont(weather_font16);tft.setTextColor(TFT_WHITE, TFT_BLACK, true);tft.drawString("2024-05-03  星期五  三月二五", 0, 0);tft.unloadFont();tft.setTextSize(5);tft.setTextColor(TFT_GREEN, TFT_BLACK, true);tft.drawString("17:16:26", 0, 30);// 今日天气// 擦除指定区域tft.fillRect(55, 90, 240, 40, TFT_BLACK);tft.setTextColor(TFT_YELLOW, TFT_BLACK, true);tft.loadFont(hefeng40);tft.drawString("\uf101", 10, 90);tft.unloadFont();tft.loadFont(weather_font20);tft.setTextColor(TFT_WHITE, TFT_BLACK, true);tft.drawString("25°C  晴", 55, 90);tft.drawString("东南风3级 3KM/H", 55, 110);tft.drawLine(0, 140, 240, 140, TFT_WHITE);// 明日天气// 擦除指定区域tft.fillRect(55, 150, 240, 40, TFT_BLACK);tft.loadFont(hefeng40);tft.setTextColor(TFT_YELLOW, TFT_BLACK, true);tft.drawString("\uf103", 10, 150);tft.unloadFont();tft.loadFont(weather_font20);tft.setTextColor(TFT_WHITE, TFT_BLACK, true);tft.drawString("明天 15° - 28°", 55, 150);tft.drawString("多云", 55, 170);tft.drawLine(0, 200, 240, 200, TFT_WHITE);// 温湿度传感器的数据tft.loadFont(weather_font20);tft.setTextColor(TFT_WHITE, TFT_BLACK, true);tft.drawString("室温：", 20, 210);tft.setTextColor(TFT_GREEN, TFT_BLACK, true);tft.setTextColor(TFT_WHITE, TFT_BLACK, true);tft.drawString("湿度：", 120, 210);tft.setTextColor(TFT_GREEN, TFT_BLACK, true);
}void loop()
{}//连接wifi
void connectWiFi() {Serial.print("Connecting to ");Serial.println(ssid);//设置WiFi工作在终端模式，参数可选填WIFI_AP、WIFI_STA、WIFI_AP_STA、WIFI_OFFWiFi.mode(WIFI_STA);//开始连接WiFi.begin(ssid, password);//检查连接是否成功while (WiFi.status() != WL_CONNECTED) {delay(500);Serial.print(".");tft.print(".");}tft.println("");tft.println("");tft.setTextColor(TFT_GREEN, TFT_BLACK, true);tft.println(WiFi.localIP());//设置：当路由器断开连接时，是否启动自动重新连接功能。true: 启用自动重新连接；false：不启用此功能WiFi.setAutoReconnect(true);//设置：是否将WiFi参数保存于Flash中，默认为true，即在每次调用WiFi.begin()、WiFi.softAP()、WiFi.disconnect、WiFi.softAPdisconnect方法时都会将相关数据写入到Flash中；//      当设置为false时，以上动作将不会把数据写入Flash中，仅仅改变内存中的WiFi设置WiFi.persistent(true);
}