失眠网 > 掌控版教程 | 用 ESP32 和 Arduino DIY 制作一个“疫情数据实时显示器”

掌控版教程 | 用 ESP32 和 Arduino DIY 制作一个“疫情数据实时显示器”

时间：2019-11-11 13:14:12

国际惯例，先来看一下演示效果：

前两天在群里聊天看到一个全国新型肺炎疫情的实时数据接口：/nCoV/

nCoV数据接口网站

正好这几天被隔离在家闲着没事做，而且对新型肺炎的数据也是一直很关注，所以就用手里的掌控版（ESP32 开发板）做了一个“新型肺炎晴雨表”，放在电脑边上，实时查看最新的肺炎数据。

注：手里没有掌控版的朋友，可以用其他 ESP32 或者 ESP8266 开发板来实现。

# nCoV API 解读

打开网站：/nCoV/，上面列举了好几种请求接口：

1：/nCoV/api/overall：返回病毒研究情况以及全国疫情概览。

2：/nCoV/api/provinceName：返回数据库内有数据条目的省份、地区、直辖市列表。

3：/nCoV/api/area：返回中国所有省份、地区或直辖市及世界其他国家的所有疫情信息变化的时间序列数据（精确到市），能够追溯确诊/疑似感染/治愈/死亡人数的时间序列。

4：/nCoV/api/news：返回所有与疫情有关的新闻信息，包含数据来源以及数据来源链接。

5：/nCoV/api/rumors：返回与疫情有关的谣言以及丁香园的辟谣。

可以看到，疫情精确数据主要在第 3 条接口中，我们进一步查看一下第 3 条接口的细节

API接口细节

根据示例，如果我们要获取“浙江省”的疫情最新数据的话，接口网址应该是：/nCoV/api/area?latest=1&province=浙江省

我们将这个网址输入浏览器地址栏查看一下相应的数据，果然有数据返回。

浙江省新型肺炎数据

但是返回的数据，格式太乱了，不方便查看。所以我将这些数据复制到 VS Code 软件中，然后在右下角将数据格式设置为 JSON。然后在文件中右键，选择Format Document（格式化文件）命令。

VS Code整理数据格式

经过格式化之后，我们就可以看到排列有序、层次清晰的数据了。这是一堆 JSON 格式的数据，我们可以看到浙江省确诊人数是 1006 人、治愈人数是 99 人、杭州确诊人数是 156 人等信息。

整理后的数据

既然是 JSON 格式的数据，我们就可以很轻松的用代码来读取了。

至于实时更新数据，那就更简单了，我们只要定时去访问这个接口，就可以随时获取最新数据了。什么？还要人为去访问这个网址？当然不是，掌控版（ESP32 开发板）可是有联网功能的，虽然我也闲着没事做，但是这种可以自动化的工作，还是交给程序去做吧。

接下来我们就来看一下具体的代码该怎么写。

# 软件选择

这里我们选用 Arduino 软件来进行代码的编写，为了减少 Arduino 中配置掌控版（ESP32）开发环境的麻烦，我们直接使用 Mixly 软件内置的 Arduino 软件，已经帮我们配置好相应的 ESP32 开发环境了。

如果你想自己在 Arduino 中配置 ESP32 开发环境，也可以查看官方教程：/espressif/arduino-esp32

Mixly 软件下载地址：https://mixly.readthedocs.io/zh_CN/latest/basic/02Installation-update.html

配置好相应的开发环境之后，就是选择开发板、编写程序、最后下载程序。如果你用的和我一样，是 Mixly 内置的 Arduino 的话，可以选择 Arduino ESP32（通用 ESP32 开发板）或 Arduino HandBit（掌控版）。如果你是自己配置 ESP32 开发环境的话，只要选择对应的开发板即可。

开发板选择

# 代码编写

## 连接网络

首先连接网络，并且初始化串口，方便后面调试。联网调试代码如下，使用 ESP32 自带的WiFi库即可，如果网络连接成功，则在串口打印出开发板的 IP 地址。

#include<WiFi.h>#include<Wire.h>constchar*ssid="wifi-name";constchar*password="wifi-password";voidsetup(){Serial.begin(115200);//连接网络WiFi.begin(ssid,password);while(WiFi.status()!=WL_CONNECTED){delay(500);Serial.print(".");}Serial.print("LocalIP:");Serial.println(WiFi.localIP());}voidloop(){}

上传程序，打开串口监视器，看到打印出来的串口，则表示联网成功。

显示IP

## 设置定时器

接下来我们再来设置一个定时器。为什么要设置定时器呢？一来是降低访问数据接口的频次，减少服务器的压力；二来可以不用delay()函数，可以让程序更加高效。这里我们使用了SimpleTimer.h库，它使用起来比较简单。程序如下：

篇幅原因，这里省略了联网功能相关的代码，我们只要把定时器相关的代码添加到相应位置即可。

#include<SimpleTimer.h>//othercodes...SimpleTimertimer;voidsetup(){//setupcodes...//设置定时器timer.setInterval(10000L,timerCallback);//10000ms=10s}voidloop(){timer.run();}//定时器回调函数voidtimerCallback(){//timercodehere...}

在程序最开头，我们引入SimpleTimer.h库函数，然后初始化一个定时器对象timer，在setup()中初始化定时器，并设置定时器回调函数timerCallback()，这里设置每隔 10 秒（10000ms）调用一次定时器，你也可以该修改为其他时间。

然后在定时器回调函数内，获取新型肺炎的实时数据。这里我们需要用到两个库：HTTPClient.h和ArduinoJson.h。HTTPClient.h库是用来联网获取上述 API 接口的数据的，ArduinoJson.h库可以解析返回的 JSON 数据，获得我们关心的数据。

然后设置 API 接口地址apiUrl，这里你可以修改为你想要的数据地址。再设置几个变量，用于存储我们关心的数据，其中xx_confirmedCount表示确诊人数，xx_suspectedCount表示疑似人数，xx_curedCount表示治愈人数，xx_deadCount表示死亡人数，前面的xx是前缀，分别可以修改成zj（浙江）、hangzhou（杭州）、ningbo（宁波）等。

#include<HTTPClient.h>#include<ArduinoJson.h>//othercodes...StringapiUrl="/nCoV/api/area?latest=1&province=浙江省";//浙江疫情数据变量intzj_confirmedCount;intzj_suspectedCount;intzj_curedCount;intzj_deadCount;//杭州疫情数据变量inthangzhou_confirmedCount;inthangzhou_suspectedCount;inthangzhou_curedCount;inthangzhou_deadCount;//宁波疫情数据变量intningbo_confirmedCount;intningbo_suspectedCount;intningbo_curedCount;intningbo_deadCount;voidsetup(){//setupcodes...}voidloop(){//loopcodes...}//定时器回调函数voidtimerCallback(){HTTPClienthttp;http.begin(apiUrl);inthttpCode=http.GET();if(httpCode==HTTP_CODE_OK){Stringresults=http.getString();//Serial.println(results);//网页内容DynamicJsonBufferjsonBuffer(512);JsonObject&resultsJson=jsonBuffer.parseObject(results);if(!resultsJson.success()){Serial.println("parseObject()failed");return;}//--------浙江省数据-----------JsonObject&provinces=resultsJson["results"][0];constchar*country=provinces["country"];//"中国"constchar*provinceName=provinces["provinceName"];//"浙江省"constchar*provinceShortName=provinces["provinceShortName"];//"浙江"zj_confirmedCount=provinces["confirmedCount"];zj_suspectedCount=provinces["suspectedCount"];zj_curedCount=provinces["curedCount"];zj_deadCount=provinces["deadCount"];//--------cities-----------JsonArray&cities=provinces["cities"];//--------杭州数据-----------JsonObject&hangzhou=cities[1];constchar*hangzhou_cityName=hangzhou["cityName"];//"杭州"hangzhou_confirmedCount=hangzhou["confirmedCount"];hangzhou_suspectedCount=hangzhou["suspectedCount"];hangzhou_curedCount=hangzhou["curedCount"];hangzhou_deadCount=hangzhou["deadCount"];//longhangzhou_locationId=hangzhou["locationId"];//330100//--------宁波数据-----------JsonObject&ningbo=cities[2];constchar*ningbo_cityName=ningbo["cityName"];//"宁波"ningbo_confirmedCount=ningbo["confirmedCount"];ningbo_suspectedCount=ningbo["suspectedCount"];ningbo_curedCount=ningbo["curedCount"];ningbo_deadCount=ningbo["deadCount"];//longningbo_locationId=ningbo["locationId"];//330200//--------串口打印实时疫情信息-----------Serial.println("浙江省新型肺炎疫情实时数据");Serial.println("-----------------------------------------");Serial.print("浙江：\t确诊：");Serial.print(zj_confirmedCount);Serial.print("\t治愈：");Serial.print(zj_curedCount);Serial.print("\t\t死亡：");Serial.println(zj_deadCount);Serial.print("杭州：\t确诊：");Serial.print(hangzhou_confirmedCount);Serial.print("\t治愈：");Serial.print(hangzhou_curedCount);Serial.print("\t\t死亡：");Serial.println(hangzhou_deadCount);Serial.print("宁波：\t确诊：");Serial.print(ningbo_confirmedCount);Serial.print("\t治愈：");Serial.print(ningbo_curedCount);Serial.print("\t\t死亡：");Serial.println(ningbo_deadCount);Serial.println();}else{Serial.println("GETError.");}http.end();}

在timerCallback()回调函数中，初始化一个HTTPClient对象http，并用http.begin(apiUrl)去访问 API 地址，然后用http.GET()方法去下载相应的数据，并用http.getString()函数，将数据保存为一个 String 数组。

然后用下面的代码将结果解析为 JSON 格式，然后按照 JSON 递归顺序层层解析数据即可。

DynamicJsonBufferjsonBuffer(512);JsonObject&resultsJson=jsonBuffer.parseObject(results);

上传程序，这时我们就可以在串口中查看相应的数据了。

串口查看数据

## OLED 屏数据显示

但是我们总不能一直在串口监视器中查看数据吧，所以为了查看方便，我们可以将数据显示到 OLED 屏幕上，这里我们选用 OLED 12864 显示屏来显示数据，这也是掌控版自带的显示屏。

首先在程序开头引入U8g2lib.h库，它是用来控制 OLED 屏幕显示内容的，然后初始化显示屏对象u8g2，常用的 OLED 12864 有两种尺寸，分别为 1.3 寸和 0.96 寸，你可以根据你的屏幕尺寸和和相应的显示屏控制芯片来选择对应的初始化程序，掌控版对应的屏幕尺寸是 1.3 寸。

接着就是在setup()中初始化 u8g2 对象了，然后设置字体为u8g2_font_wqy12_t_gb2312a，这是一个宋体字集，包含了 4000 多个常用字，字体大小可以设置为 12、13、14、15、16。这里要显示的内容比较多，我们设置为最小的 12 号字体。

#include<U8g2lib.h>//othercodes...//根据选用的显示屏，注释相应的程序//1.3寸OLED12864显示屏U8G2_SH1106_128X64_NONAME_F_HW_I2Cu8g2(U8G2_R0,U8X8_PIN_NONE);//0.96寸OLED12864显示屏//U8G2_SSD1306_128X64_NONAME_F_HW_I2Cu8g2(U8G2_R0,U8X8_PIN_NONE);voidsetup(){//初始化OLED显示屏u8g2.begin();u8g2.enableUTF8Print();u8g2.setFont(u8g2_font_wqy12_t_gb2312a);u8g2.setFontPosTop();u8g2.clearDisplay();//setupcodes...}voidloop(){//loopcodes...}//定时器回调函数voidtimerCallback(){//othercodes...u8g2.firstPage();do{displayData();}while(u8g2.nextPage());}//在OLED上显示实时疫情数据voiddisplayData(){u8g2.clearDisplay();//绘制表格u8g2.drawFrame(0,16,128,48);u8g2.drawLine(0,32,127,32);u8g2.drawLine(0,48,127,48);u8g2.drawLine(32,16,32,63);u8g2.drawLine(64,16,64,63);u8g2.drawLine(96,16,96,63);//标题u8g2.setCursor(18,2);u8g2.print("浙江疫情实时信息");//表格类目u8g2.setCursor(36,20);u8g2.print("确诊");u8g2.setCursor(68,20);u8g2.print("治愈");u8g2.setCursor(100,20);u8g2.print("死亡");//浙江情况u8g2.setCursor(4,36);u8g2.print("浙江");u8g2.setCursor(38,36);u8g2.print(zj_confirmedCount);u8g2.setCursor(72,36);u8g2.print(zj_curedCount);u8g2.setCursor(104,36);u8g2.print(zj_deadCount);//杭州情况u8g2.setCursor(4,52);u8g2.print("杭州");u8g2.setCursor(40,52);u8g2.print(hangzhou_confirmedCount);u8g2.setCursor(72,52);u8g2.print(hangzhou_curedCount);u8g2.setCursor(104,52);u8g2.print(hangzhou_deadCount);}

最后在timerCallback()回调函数中调用 OLED 屏的显示函数displayData()即可。

最后上传程序，就可以在掌控版（自带 OLED 屏幕的 ESP32 开发板）或 NodeMCU-32S （ESP32 开发板，须外接 OLED 屏幕）等开发板上查看实时新型肺炎疫情的数据了。

在掌控板查看数据

在NodeMCU-32S开发板上查看数据

至此，“疫情数据实时显示器”就做完了。