Wio Terminal 从网络获取天气数据

Posted 2022-01-05 阿基米东

本文主要介绍如何使用 Wio Terminal 的 WiFi 网络获取天气数据。

WiFi 配置

Wio Terminal 配备的无线网卡是 Realtek RTL8720，在开始本次学习之前，请确保你已经阅读 Wio Terminal 网卡固件更新，并完成固件更新和 Arduino 依赖库的安装。

我们知道，WiFi 有两种工作模式：AP 模式和 STA 模式。

• AP（Access Point）也就是无线接入点，是一个无线网络的创建者，是网络的中心节点。一般家庭或办公室使用的无线路由器就一个 AP。
• STA（Station）也就是站点，每一个连接到无线网络中的终端（如笔记本电脑、PDA 及其它可以联网的用户设备）都可称为一个站点。

在本示例中，Wio Terminal 工作在 STA 模式。下面代码使用 rpcWiFi 库将 Wio Terminal 连接到指定的 WiFi 网络。

提示：需要将 ssid 和 password 修改为你的 WiFi 网络。

#include "rpcWiFi.h"

const char* ssid = "yourNetworkName";
const char* password =  "yourNetworkPassword";

void setup() 
    Serial.begin(115200);
    while(!Serial); // Wait for Serial to be ready
 
    // Set WiFi to station mode and disconnect from an AP if it was previously connected
    WiFi.mode(WIFI_STA);
    WiFi.disconnect();
 
    Serial.println("Connecting to WiFi..");
    WiFi.begin(ssid, password);
 
    while (WiFi.status() != WL_CONNECTED) 
        delay(500);
        Serial.println("Connecting to WiFi..");
        WiFi.begin(ssid, password);
    
    Serial.println("Connected to the WiFi network");
    Serial.print("IP Address: ");
    Serial.println (WiFi.localIP()); // prints out the device's IP address
    
 
void loop() 
 

天气 API

有很多提供天气信息的 Web API，可以参考《一些好用的天气 API》，本文使用高德地图 API 获取实时天气及天气预测。GET 请求的 URL 如下：

实时天气（当天）

https://restapi.amap.com/v3/weather/weatherInfo?city=441802&key=yourkey

天气预测（未来三天）

https://restapi.amap.com/v3/weather/weatherInfo?city=441802&key=yourkey&extensions=all

参数说明：

• city 是城市编码，比如 441802 代表广州；
• key 是应用对应的代码，需要在平台申请（提示：将 yourkey 替换为你申请的 Key 代码）；
• extensions 表示获取类型，缺省值是 base，表示获取实况天气，all 表示获取预报天气；
• output 表示返回格式，可选 JSON 或 XML，默认返回 JSON 格式数据。

以实时天气 API 为例，返回的 JSON 数据如下：

    "status":"1",
    "count":"1",
    "info":"OK",
    "infocode":"10000",
    "lives":[
        "province":"广东",
         "city":"广州市",
         "adcode":"440100",
         "weather":"晴",
         "temperature":"17",
         "winddirection":"北",
         "windpower":"≤3",
         "humidity":"64",
         "reporttime":"2021-12-12 19:00:44"
        
    ]

HTTP 客户端

下面代码使用 HTTPClient 创建 HTTP 连接，通过高德地图 API 请求实况天气信息，并输出到串口。

提示：将下面代码中的 ssid 和 password 替换成你的 WiFi 网络；将 URL 中的 cityCode 替换成需要查询的城市，将 yourKey 替换成你的 Key。

#include <rpcWiFi.h>
#include <HTTPClient.h>
#include <WiFiClientSecure.h>

const char* ssid = "yourNetworkName";
const char* password =  "yourNetworkPassword";

const char* URL = "https://restapi.amap.com/v3/weather/weatherInfo?city=cityCode&key=yourKey";

WiFiClientSecure client;

void setup()

    Serial.begin(115200);
    
    WiFi.begin(ssid, password);

    while (WiFi.status() != WL_CONNECTED)  //Check for the connection
        delay(500);
        Serial.println("Connecting WiFi...");
    
    Serial.print("Connected to the WiFi network with IP: ");
    Serial.println(WiFi.localIP());
    //client.setCACert(test_root_ca);


void loop() 

    if(&client)    
        getWeather();
    
    delay(30000);


void getWeather()

    // Add a scoping block for HTTPClient https to make sure it is destroyed before WiFiClientSecure *client is
    HTTPClient https;
    
    Serial.print("[HTTPS] begin...\\n");
    
    if (https.begin(client, URL))
    
        Serial.print("[HTTPS] GET...\\n");
        
        int httpCode = https.GET();
        
        if (httpCode > 0)
        
            Serial.printf("[HTTPS] GET... code: %d\\n", httpCode);
            
            if (httpCode == HTTP_CODE_OK || httpCode == HTTP_CODE_MOVED_PERMANENTLY) 
            
                String payload = https.getString();
                Serial.println(payload);
            
         else 
          Serial.printf("[HTTPS] GET... failed, error: %s\\n", https.errorToString(httpCode).c_str());
        
        
        https.end();
        
     else 
        Serial.printf("[HTTPS] Unable to connect\\n");
    
    // End extra scoping block

编译上传到 Wio Terminal，打开 Arduino IDE 的串口监视器，输出内容如下：

Connected to the WiFi network with IP: 192.168.3.189
[HTTPS] begin... weather lives
[HTTPS] GET...
[HTTPS] GET... code: 200
"status":"1","count":"1","info":"OK","infocode":"10000","lives":["province":"广东","city":"清城区","adcode":"441802","weather":"晴","temperature":"19","winddirection":"东北","windpower":"≤3","humidity":"54","reporttime":"2021-12-12 12:30:59"]