PlatformIO+ESP32S3学习：通过WIFI与和风天气API获取指定地点的天气情况并显示

于 2024-07-27 22:12:44 发布
阅读量586 收藏 6
点赞数 28
分类专栏： ESP32S3像素时钟 文章标签： 学习 vscode 驱动开发 单片机 物联网
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_51930953/article/details/140740292
版权

1. 硬件准备

你只需要有一个ESP32S3开发板。我目前使用的是：

购买地址：立创·ESP32S3R8N8 开发板

在这里插入图片描述

2. 和风天气API

2.1. 和风天气介绍

和⻛天气是中国领先的气象科技服务商、国家高新技术 企业，致力于运用先进气象模型结合大数据、人工智能 技术发展智慧型气象服务。
他们的业务包括气象数据分发、地理信息、气象可视 化、个人气象服务等，在全球10个国家建有数据中心， 为300余家中国及全球企业、50万开发者提供优质的数 据服务。

另外的话

和风天气支持用户免费使用订阅，只是一个用户只能创建一个项目API，但是对我们来说已经足够了，感谢和风天气！

2.2. 创建自己的天气API

请前往 和风天气API 官网，注册账号并进入控制台。

在这里插入图片描述

关于和风天气的API介绍和开发文档，参考控制台处的介绍：

在这里插入图片描述

开始创建属于我们的API !

在这里插入图片描述

和风天气项目创建参数填写：

在这里插入图片描述

完成创建！

在这里插入图片描述

2.3. API介绍

和风天气的 API介绍网页 如下：

在这里插入图片描述

本文将用的API是城市天气 -> 每日天气预报 -> 3天预报API 。【API的详细介绍页点我】

在这里插入图片描述

需要注意的是，如果是免费订阅，要将API Host更改为 devapi.qweather.com。

这里以获取深圳3天的天气预报为例，关键的API参数说明如下：

https://devapi.qweather.com/v7/weather/3d?location=101280601&key=YOUR_KEY

请求参数包括必选和可选参数，参数之间使用&进行分隔。这里只给大家介绍必填项。
1. key(必选) ： 用户认证key，请参考如何获取你的KEY。
2. location(必选) ： 需要查询地区的LocationID或以英文逗号分隔的经度,纬度坐标（十进制，最多支持小数点后两位），LocationID可通过GeoAPI获取。例如 location=101010100 或 location=116.41,39.92

关于这个LocationID需要各位自行根据和风天气官方的github地址查询，这里我找到深圳的LocationID为：101280601

在这里插入图片描述

2.4. 手动验证API是否正确

首先回到你的和风天气管理台。你会看到你新建的项目。

在这里插入图片描述
复制你的密钥KEY。
在这里插入图片描述

然后将你的KEY填充到下方API的YOUR_KEY中

下方这个是获取深圳3天的天气预报API，只剩KEY没有填写

https://devapi.qweather.com/v7/weather/3d?location=101280601&key=YOUR_KEY

例如我的KEY是 ABCasdsdgsdfgdsgdfgdf，则我的API是

https://devapi.qweather.com/v7/weather/3d?location=101280601&key=ABCasdsdgsdfgdsgdfgdf

填写你的KEY后，直接复制该API，将它作为网址跳转到对应页面，你就会看的返回的天气数据。

在这里插入图片描述
关于API返回的数据具体的意思是什么，参考该API的介绍页。

在这里插入图片描述
根据返回的参数说明，这里我关注的是4个数据：
在这里插入图片描述

图标代码的说明：返回的数据中关于天气的说明只有空落落的数字，这些数字在API说明中代表着各个天气情况。数字对应的天气情况链接。

在这里插入图片描述

到这里我们就已经是准备好了，接下来可以上工程代码了。请准备好你的完整API和KEY。

3. 工程创建

在VSCode中打开PlatformIO扩展创建工程。

在这里插入图片描述
设置工程向导

在这里插入图片描述
在这里插入图片描述
等待创建完成。

在这里插入图片描述

4. 安装驱动库

创建完成之后，我们在VSCode中打开我们刚才创建的工程文件夹。

在这里插入图片描述
在VSCode中回到PlatformIO的主页，准备给工程安装JSON的驱动库。

在这里插入图片描述
在这里插入图片描述

搜索ArduinoJson，安装来自Benoit Blanchon 的 ArduinoJson库。

在这里插入图片描述

将库添加到我们的工程之中。

在这里插入图片描述

在这里插入图片描述

安装完成之后，打开platformio.ini文件，可以看到已经安装上了驱动库。

在这里插入图片描述

这里还有一个问题，和风天气API返回的JSON格式是带了Gzip压缩的。

为了能够在ESP32S3中进行Gzip的解压操作，引用了github上的一个开源项目，来自pfalcon的uzlib。感谢伟大的开源贡献者！

在这里插入图片描述

在我们的工程中，去lib文件夹下新建一个文件夹uzlib，将仓库中的 src 文件夹下的文件全部拉下来保存在我们在工程中新建的uzlib文件夹下。

在这里插入图片描述

5. 编辑代码

在工程中的src文件夹下的新建 weather.cpp 文件。

在这里插入图片描述
往 weather.cpp 中写入如下代码：

#include "weather.h"

Weather::Weather(String apiKey, String location)
{
    this->apiKey = apiKey;
    this->location = location;
}

bool Weather::update()
{
    HTTPClient http;   //用于访问网络
    WiFiClient *stream;
    int size;
    
    http.begin("https://devapi.qweather.com/v7/weather/3d?location="+ this->location + "&key=" + this->apiKey); //获取近三天天气信息
    int httpcode = http.GET();   //发送GET请求
    if(httpcode > 0)
    {
        if(httpcode == HTTP_CODE_OK)
        {
            stream = http.getStreamPtr();   //读取服务器返回的数据
            size = http.getSize();
        }
    }
    else
    {
        Serial.printf("[HTTP] GET... failed, error: %s\n", http.errorToString(httpcode).c_str());
    }
    http.end();   //结束当前连接
    
    uint8_t inbuff[size];
    stream->readBytes(inbuff, size);
    uint8_t *outbuf = NULL;
    uint32_t out_size = 0;
    int result = ArduinoUZlib::decompress(inbuff,size, outbuf, out_size);
    deserializeJson(doc, outbuf);
    today = doc["daily"][0].as<JsonObject>();
    tomorrow = doc["daily"][1].as<JsonObject>();
    return true;
}

//获取天气数据中的当天最高气温数据
int Weather::getTempMax(bool is_today)
{
    if(is_today)
    {
        return today["tempMax"].as<int>();
    }
    else
    {
        return tomorrow["tempMax"].as<int>();
    }
}

//获取天气数据中的当天最低气温数据
int Weather::getTempMin(bool is_today)
{
    if(is_today)
    {
        return today["tempMin"].as<int>();
    }
    else
    {
        return tomorrow["tempMin"].as<int>();
    }
}

//获取天气数据中的天气标识代码
int Weather::getWeather(bool is_today, bool is_day)
{
    if(is_today)
    {
        if(is_day)
            return today["iconDay"].as<int>();
        else
            return today["iconNight"].as<int>();
    }
    else
    {
        if(is_day)
            return tomorrow["iconDay"].as<int>();
        else
            return tomorrow["iconNight"].as<int>();
    }
}

在工程中的include文件夹下的新建 weather.h 文件。

在这里插入图片描述
往 weather.h 中写入如下代码：

#ifndef _WEATHER_H
#define _WEATHER_H

#include "Arduino.h"
#include "ArduinoJson.h"
#include "ArduinoUZlib.h"
#include "HTTPClient.h"

//定义天气类
class Weather
{
    public:
        Weather(String apiKey, String location);
        bool update();  //发送一次请求信息，获取天气数据

        //只需要今明日的天气与温度，故仅设置了以下若干函数
        int getTempMax(bool is_today);
        int getTempMin(bool is_today);
        int getWeather(bool is_today, bool is_day);
    private:
        String apiKey;                  //天气API密钥
        String location;                //地点
        StaticJsonDocument<2048> doc;   //Json容器
        JsonObject today, tomorrow;     //可根据返回的json信息自行定义其他天气数据
};

#endif

打开工程下的src文件夹下的main.cpp，并且写入如下代码：

#include <Arduino.h>
#include <WiFi.h>
#include "weather.h"  //定义Weather类，用于解析Json数据并返回天气数据

//WIFI
#define WIFI_SSID "lckfb"         //要连接的WIFI名称
#define WIFI_PASSWORD "12345678"  //要连接的WIFI密码
#define WIFI_RETRY_COUNT  20      //WIFI连接重试数

//和风天气预报
#define USER_KEY      "d89d4706adcc4fb89d6f166cb420ee39" //密钥
#define LOCATION_ID   "101280601"  //地点标识：深圳

int weatherid;      //根据和风天气API返回的天气ID显示对应天气
bool is_day = 1;    //白天为1，夜晚为0
bool is_today = 1;  //今天为1，明天为0

//创建天气对象
Weather weather(USER_KEY, LOCATION_ID);

//根据和风天气API返回天气标识
void WeatherIcon(int weatherid)
{
    switch(weatherid)
    {
        case 100://白天晴
            Serial.println("白天晴\r\n");
            break;
        case 101://多云
        case 102://少云
        case 151://夜间多云
        case 152://夜间少云
        case 103://晴间多云
            Serial.println("多云\r\n");
            break;
        case 104://阴天
            Serial.println("阴天\r\n");
            break;
        case 150://夜间晴朗
            Serial.println("夜间晴朗\r\n");
            break;
        case 153://夜间晴间多云
            Serial.println("夜间多云\r\n");
            break;
        case 305://小雨
        case 309://毛毛雨/细雨
            Serial.println("小雨\r\n");
            break;
        case 300://阵雨
        case 350://夜间阵雨
        case 306://中雨
        case 399://雨
        case 313://冻雨
        case 314://小到中雨
            Serial.println("阵雨\r\n");
            break;
        case 301://强阵雨
        case 351://夜间强阵雨
        case 307://大雨
        case 308://极端降雨
        case 310://暴雨
        case 311://大暴雨
        case 312://特大暴雨
        case 315://中到大雨
        case 316://大到暴雨
        case 317://暴雨到大暴雨
        case 318://大暴雨到特大暴雨
            Serial.println("大雨\r\n");
            break;
        case 302://雷阵雨
            Serial.println("雷阵雨\r\n");
            break;
        case 303://强雷阵雨
            Serial.println("强雷阵雨\r\n");
            break;

        //雪天
        case 400://小雪
        case 401://中雪
        case 402://大雪
        case 403://暴雪
        case 404://雨夹雪
        case 405://雨雪天气
        case 406://阵雨夹雪
        case 407://阵雨夹雪
        case 408://小到中雪
        case 409://中到大雪
        case 410://雪
        case 456://阵雨夹雪
        case 457://阵雪
        case 499://雪
            Serial.println("雪天\r\n");
            break;

        //雾霾
        case 500://薄雾
        case 501://雾
        case 509://浓雾
        case 510://强浓雾
        case 514://大雾
        case 515://特强浓雾
            Serial.println("雾天\r\n");
            break;
        case 502://霾
        case 511://中度霾
        case 512://重度霾
        case 513://严重霾
            Serial.println("雾霾\r\n");
            break;
    }
}

void setup() 
{
  int count = 0;
  char disp_buf[50]={0};

  //串口初始化
  Serial.begin(9600);

  //尝试连接WIFI网络
  WiFi.begin(WIFI_SSID, WIFI_PASSWORD); 
  //尝试连接直至超时
  while (WiFi.status() != WL_CONNECTED) 
  {
    count++;
    if (count > WIFI_RETRY_COUNT)
    {
      Serial.println("\r\nconnection failed.\r\n");
      break;
    }
    delay(500);
    Serial.print(".");
  }

  //获取天气数据
  weather.update();

  //WIFI断开连接
  WiFi.disconnect();

  //显示最低与最高温度
  sprintf(disp_buf, "TempMin = %d", weather.getTempMin(is_today));
  Serial.println(disp_buf);
  sprintf(disp_buf, "TempMax = %d", weather.getTempMax(is_today));
  Serial.println(disp_buf);

  //显示天气标识代码
  sprintf(disp_buf, "WeatherCode = %d", weather.getWeather(is_today, is_day));
  Serial.println(disp_buf);

  //根据天气标识代码确定天气
  WeatherIcon(weather.getWeather(is_today, is_day));
}

void loop() 
{
  delay(1000);
}

6. 代码验证

代码编写完成之后，将ESP32S3开发板接入电脑。我当前的开发板上是CH340K的驱动，故我这里选择COM3端口。

在这里插入图片描述
编译并下载到开发板中。

在这里插入图片描述

打开串口监视器。

在这里插入图片描述

实际获取天气数据的效果如下：
最低温度26，最高温度31，天气代码为307，对应的就是大雨。
在这里插入图片描述

查看和风天气的API中天气代码说明，确认数据是正确的。

在这里插入图片描述

老怪.
关注
  • 28
    点赞
  • 踩
  • 6
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
专栏目录
ESP32S3 PlatformIO开发环境搭建
m0_73253860的博客
10-29 1849
ESP32S3 PlatformIO开发环境搭建
【ESP32】立创ESP32S3N8R8开发板+2.8寸TFT电容触摸屏+Squareline Studio+PlatformIO
Hi1L的博客
04-27 656
移植Squareline Studio工程
【XIAO ESP32S3 sense 通过 ESPHome 与 Home Assistant 连接】
vor234的博客
03-03 1732
ESPHome 是一个工具，旨在使管理您的 ESP 板尽可能简单。它读取 YAML 配置文件并创建安装在 ESP 设备上的自定义固件。在 ESPHome 配置中添加的设备或传感器将自动显示在 Home Assistant 的 UI 中。ESPHome 可以帮助您连接数据并将其发送到家庭助理设备。硬件准备如果要按照本教程完成所有操作，则需要准备以下内容。Grove 传感器Grove -温湿度传感器 （BME680）Grove -智能空气质量传感器 （SGP41）
ESP32S3入手体验测试
perseverance51博客
11-05 8449
ESP32S3入手体验测试
VSCode PlatformIO ESP32S3 SPIFFS报错SPIFFS: mount failed, -10025
weixin_44950113的博客
10-24 2178
编译通过，但是spiffs文件系统不能正常工作，串口打印报错 SPIFFS: mount failed, -10025。
【ESP32】立创ESP32S3R8N8开发板+2.8寸TFT电容触摸屏[ST7789+GT911]+PlatformIO+LVGL测试
Hi1L的博客
04-10 1888
立创ESP32S3R8N8开发板+2.8寸TFT电容触摸屏[ST7789+GT911]测试lvgl官方案例
【ESP32S3 Sense接入语音识别+MiniMax模型+TTS模块语音播报】
vor234的博客
04-03 4340
🥳🥳🥳现在，我们在本教程中，您学习了如何使用ESP32S3 Sense接入语音识别+MiniMax模型+TTS模块实现语音播报功能。🛹🛹🛹从而实现对外部世界进行感知，充分认识这个有机与无机的环境，后期会持续分享esp32跑freertos实用案列🥳🥳🥳科学地合理地进行创作和发挥效益，然后为人类社会发展贡献一点微薄之力。🤣🤣🤣
【Seeed Studio XIAO ESP32S3 Sense 开箱Arduino教程】
vor234的博客
01-25 3329
Seeed Studio XIAO系列是一款小型开发板，尺寸仅为拇指大小，具备类似的硬件结构。该系列的代号“小”表示它的小巧尺寸。其中，Seeed Studio XIAO ESP32S3 Sense集成了摄像头传感器、数字麦克风和SD卡支持。借助其嵌入式ML计算和摄影能力，该开发板成为了您探索智能语音和视觉AI的入门工具。在一切开始之前，有一些产品的基本参数是非常重要的。下表提供了有关Seeed Studio XIAO ESP32S3特性的信息。
LVGL+ESP32S3+Platformio+Arduino+SquareLine_Studio+TFT_eSPI（显示）
fb15966595193的专栏
07-14 2977
使用 ESP32-S3，基于platformio，开发lvgl。
ESP32S3学习Vol2：SPI协议与使用
qq_46025708的博客
10-08 1458
CPHA的不同参数则规定了数据采样是在SCK时钟的奇数边沿还是偶数边沿，CPHA = 0，数据采样是在SCK时钟的奇数边沿，CPHA = 1，数据采样是在SCK时钟的偶数边沿，这里不使用上升沿或下降沿表示，是因为不同模式下，奇数边沿或偶数边沿与上升沿或下降沿的对应不是固定的。数据更新在SCK时钟的偶数边沿，本模式中，偶数边沿为上升沿。CPOL：就是表示设备未被选中的空闲状态时，串行时钟SCK的电平状态，CPOL = 0，空闲状态时SCK为低电平，CPOL = 1，空闲状态时SCK为高电平；
esp32s3+GC9A01基于vs code+PlatformIO+ardunio框架+Squareline UI 移植
07-02
esp32-s3+GC9A01基于vs code+PlatformIO+ardunio框架+Squareline UI 简单的移植例程文件，供Squareline初学者学习以上软硬件组合基于Squareline的移植
esp32s3 u盘 usb_device_msc
08-16
在本文中，我们将深入探讨如何利用ESP32S3实现USB设备功能，特别是将其配置为一个U盘，通过USB MSC（Mass Storage Class）协议与主机进行数据交换。 USB MSC协议是USB设备类规范的一部分，用于连接存储设备，如U盘...
esp32s3驱动max30102显示心率血氧
05-10
1. 初始化I2C通信：ESP32S3通过其内置的I2C接口与MAX30102进行通信。需要配置I2C总线的时钟频率、SDA和SCL引脚，并确保正确设置设备地址（MAX30102的默认地址是0x57）。 2. 设置传感器模式：MAX30102可以工作在多种...
Arduino ESP32S3 SPIFFS插件
08-30
git上那个只能给ESP32用，不能给ESP32S3用，自己稍微修改了一下，改成支持S3。 注意，这个不再支持ESP32，而且不能和ESP32插件共存。 使用方式， MAC：拷贝到 $HOME/Documents/Arduino/tools/ESP32FS/tool WIN不熟悉...
ESP32S3BOXlite+http+csjon解析+adc按键采样
09-23
在这个项目中，我们将探讨如何利用该开发板结合HTTP协议和CJSON库来实现天气数据的获取与解析，并通过乐鑫的esp-skainet语音框架进行语音播报。此外，我们还将讨论如何设置ADC（模拟数字转换器）按键采样功能，以...
AvaloniaUI的学习
最新发布
lishuangquan1987的博客
07-25 610
官方中文文档：https://docs.avaloniaui.net/zh-Hans/docs/welcome。
编程学习之路：从零到一的成长指南
KsuferNotes
07-22 464
在当今数字化时代，编程技能已经成为许多人职业发展的重要组成部分。不论你是已经在IT业从业多年的老手，还是刚刚起步的编程新手，这篇博客将带你走过编程学习的每一个重要阶段，从而顺利完成从零到一的华丽转变。
FastAPI（七十一）实战开发《在线课程学习系统》接口开发-- 查看留言
mr~li的博客
07-24 264
梳理后发现，之前在接口设计的时候，有些欠缺，查看留言，是查看单个的留言，查看留言后，对应的留言变成已读状态。那么我们这个都需要传递一个参数，这个参数应该是留言的id。之前FastAPI（七十）实战开发《在线课程学习系统》接口开发--留言功能开发分享了留言开发，这次我们分享查看留言。在之前设计返回状态码的时候，发现状态码有缺失，我们增加下缺失的。3.判断是否是当前用户的留言，或者接受的方是自己。梳理这里的逻辑，这个接口要依赖登录。5.如果已读且回复了，要带回复的内容。以上则是实现查看留言的接口逻辑。
学习华为IPD流程黑话2.0
产品线负责人
07-23 536
管道管理是指根据资源需求（管道需求）尽早地对可获得性资源（管道供给）进行平衡，任何企业做研发、做产品，它的可用资源都是有限的，可以把企业的资源比喻成管道。既是对产品包进行验证，也是内部技能传递的重要环节，同时能为客户带来价值。这个时候就只需要对切片的概念做一下了解就应该可以直接应用了。而且主要做的是 C 语言，Python 也确实没具体用过。并保证在任意时刻产出的研发价值（即出口流量）的最大化，好了，这个话题就不展开来讲了，后续可以单独展开聊聊。评审的对象是新产品的业务计划，而不是产品的开发计划。
PLATFORMIO创建ESP32S3文件慢
07-27
根据引用\[1\]中的描述，PlatformIO是一个开发环境，可以与VS Code结合使用，提供了强大的编辑和构建能力。它支持ESP32 S3开发，并可以替代Arduino IDE，提供自动补全、函数跳转、函数提示等功能。从Arduino IDE切换到PlatformIO相对简单，只需要稍作修改文件结构即可。然而，引用中也提到了PlatformIO切换例程稍显麻烦。 根据引用\[2\]中的描述，安装完成PlatformIO后，可以通过点击左下角的蚂蚁头logo图标打开PlatformIO IDE主页。然后可以选择+New Project创建工程，填写项目名称、选择开发板和框架，并选择保存路径。完成后，可以打开工程文件夹，编辑src目录下的main.cpp文件。 根据引用\[3\]中的描述，如果创建ESP32S3文件的过程比较慢，可能是由于网络原因导致的。在创建工程时，需要从网络上下载一些文件，如果网络不稳定或速度较慢，就会导致创建过程变慢。在这种情况下，建议耐心等待，或者尝试使用更稳定和快速的网络环境。 综上所述，如果PLATFORMIO创建ESP32S3文件慢，可能是由于网络原因导致的。建议耐心等待或尝试使用更稳定和快速的网络环境。 #### 引用[.reference_title] - *1* *2* [ESP32 S3 的VS Code + PlatformIO 开发环境搭建](https://blog.csdn.net/CNCTECHENT/article/details/125335358)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v91^control,239^v3^insert_chatgpt"}} ] [.reference_item] - *3* [[ESP32][esp-idf] esp32s3 快速搭建LVGL V7.9](https://blog.csdn.net/qq_29246181/article/details/125931457)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v91^control,239^v3^insert_chatgpt"}} ] [.reference_item] [ .reference_list ]
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

老怪.

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值